QQnxScreen Class Reference

The QQnxScreen class implements a screen driver for QNX io-display based devices. More...

#include <qscreenqnx_qws.h>

Inheritance diagram for QQnxScreen:

Public Functions
void	blank (bool on)
	Reimplemented Function More...
bool	connect (const QString &displaySpec)
	Connects to QNX's io-display based device based on the displaySpec parameters from the QWS_DISPLAY environment variable. More...
void	disconnect ()
	Reimplemented Function More...
void	exposeRegion (QRegion r, int changing)
	Reimplemented Function More...
bool	initDevice ()
	Reimplemented Function More...
	QQnxScreen (int display_id)
	Constructs a QQnxScreen object. More...
void	setDirty (const QRect &)
	Marks the given rectangle as dirty. More...
void	setMode (int, int, int)
	QQnxScreen doesn't support setting the mode, use io-display instead. More...
void	shutdownDevice ()
	Reimplemented Function More...
bool	supportsDepth (int) const
	Reimplemented Function More...
	~QQnxScreen ()
	Destroys this QQnxScreen object. More...
Public Functions inherited from QScreen
virtual int	alloc (unsigned int, unsigned int, unsigned int)
	Returns the index in the screen's palette which is the closest match to the given RGB value (red, green, blue). More...
uchar *	base () const
	Returns a pointer to the beginning of the framebuffer. More...
virtual void	blit (const QImage &img, const QPoint &topLeft, const QRegion &region)
	Copies the given region in the given image to the point specified by topLeft using device coordinates. More...
void	blit (QWSWindow *bs, const QRegion &clip)
virtual uchar *	cache (int)
ClassId	classId () const
	Returns the class identifier for the screen object. More...
QRgb *	clut ()
	Returns a pointer to the screen's color lookup table (i. More...
int	colorCount ()
	Returns the number of entries in the screen's color lookup table (i. More...
virtual QWSWindowSurface *	createSurface (QWidget *widget) const
	Creates and returns a new window surface for the given widget. More...
virtual QWSWindowSurface *	createSurface (const QString &key) const
	Creates and returns a new window surface matching the given key. More...
int	depth () const
	Returns the depth of the framebuffer, in bits per pixel. More...
int	deviceHeight () const
	Returns the full height of the framebuffer device in pixels. More...
int	deviceWidth () const
	Returns the physical width of the framebuffer device in pixels. More...
QGraphicsSystem *	graphicsSystem () const
virtual void	haltUpdates ()
int	height () const
	Returns the logical height of the framebuffer in pixels. More...
virtual bool	isInterlaced () const
	Returns true if the display is interlaced (i. More...
virtual bool	isTransformed () const
	Returns true if the screen is transformed (for instance, rotated 90 degrees); otherwise returns false. More...
int	linestep () const
	Returns the length of each scanline of the framebuffer in bytes. More...
virtual QSize	mapFromDevice (const QSize &) const
	Maps the given size from the framebuffer coordinate system to the coordinate space used by the application. More...
virtual QPoint	mapFromDevice (const QPoint &, const QSize &) const
	Maps the given point from the framebuffer coordinate system to the coordinate space used by the application, passing the device's screenSize as argument. More...
virtual QRect	mapFromDevice (const QRect &, const QSize &) const
	Maps the given rectangle from the framebuffer coordinate system to the coordinate space used by the application, passing the device's screenSize as argument. More...
virtual QImage	mapFromDevice (const QImage &) const
	Maps the given image from the framebuffer coordinate system to the coordinate space used by the application. More...
virtual QRegion	mapFromDevice (const QRegion &, const QSize &) const
	Maps the given region from the framebuffer coordinate system to the coordinate space used by the application, passing the device's screenSize as argument. More...
virtual QSize	mapToDevice (const QSize &) const
	Maps the given size from the coordinate space used by the application to the framebuffer coordinate system. More...
virtual QPoint	mapToDevice (const QPoint &, const QSize &) const
	Maps the given point from the coordinate space used by the application to the framebuffer coordinate system, passing the device's screenSize as argument. More...
virtual QRect	mapToDevice (const QRect &, const QSize &) const
	Maps the given rectangle from the coordinate space used by the application to the framebuffer coordinate system, passing the device's screenSize as argument. More...
virtual QImage	mapToDevice (const QImage &) const
	Maps the given image from the coordinate space used by the application to the framebuffer coordinate system. More...
virtual QRegion	mapToDevice (const QRegion &, const QSize &) const
	Maps the given region from the coordinate space used by the application to the framebuffer coordinate system, passing the device's screenSize as argument. More...
virtual int	memoryNeeded (const QString &)
QT_DEPRECATED int	numCols ()
QPoint	offset () const
	Returns the logical offset of the screen, i. More...
virtual bool	onCard (const unsigned char *) const
	Returns true if the specified buffer is within the graphics card's memory; otherwise returns false (i.e. More...
virtual bool	onCard (const unsigned char *, ulong &out_offset) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.If the specified buffer is within the graphics card's memory, this function stores the offset from the start of graphics card memory (in bytes), in the location specified by the offset parameter. More...
int	physicalHeight () const
	Returns the physical height of the screen in millimeters. More...
int	physicalWidth () const
	Returns the physical width of the screen in millimeters. More...
QImage::Format	pixelFormat () const
	Returns the pixel format of the screen, or QImage::Format_Invalid if the pixel format is not a supported image format. More...
PixelType	pixelType () const
	Returns the pixel storage format of the screen. More...
QPixmapDataFactory *	pixmapDataFactory () const
virtual int	pixmapDepth () const
	Returns the preferred depth for pixmaps, in bits per pixel. More...
virtual int	pixmapLinestepAlignment ()
	Returns the value (in bits) to which individual scanlines of pixmaps held in the graphics card's memory, should be aligned. More...
virtual int	pixmapOffsetAlignment ()
	Returns the value (in bits) to which the start address of pixmaps held in the graphics card's memory, should be aligned. More...
	QScreen (int display_id, ClassId classId)
	Constructs a new screen driver. More...
	QScreen (int display_id)
	Constructs a new screen driver. More...
virtual QRegion	region () const
	Returns the region covered by this screen driver. More...
virtual void	restore ()
	Restores the previously saved state of the graphics card. More...
virtual void	resumeUpdates ()
virtual void	save ()
	Saves the current state of the graphics card. More...
int	screenSize () const
	Returns the size of the screen in bytes. More...
virtual void	set (unsigned int, unsigned int, unsigned int, unsigned int)
void	setOffset (const QPoint &p)
virtual int	sharedRamSize (void *)
virtual void	solidFill (const QColor &color, const QRegion &region)
	Fills the given region of the screen with the specified color. More...
int	subScreenIndexAt (const QPoint &p) const
	Returns the index of the subscreen at the given position; returns -1 if no screen is found. More...
virtual QList< QScreen * >	subScreens () const
int	totalSize () const
	Returns the size of the available graphics card memory (including the screen) in bytes. More...
virtual int	transformOrientation () const
	Returns the current rotation as an integer value. More...
virtual void	uncache (uchar *)
int	width () const
	Returns the logical width of the framebuffer in pixels. More...
virtual	~QScreen ()
	Destroys this screen driver. More...

Properties
QQnxScreenContext *const	d

Additional Inherited Members
Public Types inherited from QScreen
enum	ClassId {   LinuxFBClass, TransformedClass, VNCClass, MultiClass,   VFbClass, DirectFBClass, SvgalibClass, ProxyClass,   GLClass, IntfbClass, CustomClass = 1024 }
	This enum defines the class identifiers for the known screen subclasses. More...
enum	PixelType { NormalPixel, BGRPixel }
	This enum describes the pixel storage format of the screen, i. More...
Static Public Functions inherited from QScreen
static QScreen *	instance ()
	Returns a pointer to the application's QScreen instance. More...
Protected Functions inherited from QScreen
void	setGraphicsSystem (QGraphicsSystem *system)
void	setPixelFormat (QImage::Format format)
	Sets the screen's pixel format to format. More...
void	setPixmapDataFactory (QPixmapDataFactory *factory)
Protected Variables inherited from QScreen
int	d
	the pixel depth More...
uchar *	data
	points to the first visible pixel in the frame buffer. More...
int	dh
	the device height More...
int	displayId
int	dw
	the device width More...
QPoolEntry *	entries
int *	entryp
bool	grayscale
	the gray scale screen mode flag More...
int	h
	the logical height of the screen. More...
unsigned int *	lowest
int	lstep
	the number of bytes representing a line in the frame buffer. More...
int	mapsize
	the total number of bytes in the frame buffer More...
int	physHeight
	the physical height of the screen in millimeters. More...
int	physWidth
	the physical width of the screen in millimeters. More...
PixelType	pixeltype
	set to BGRPixel More...
QRgb	screenclut [256]
	the color table More...
int	screencols
	the number of entries in the color table More...
int	size
	the number of bytes in the visible region of the frame buffer More...
int	w
	the logical width of the screen. More...
Static Protected Variables inherited from QScreen
static ClearCacheFunc	clearCacheFunc = 0
Related Functions inherited from QScreen
void	setTransformation (int transformation, int screenNo)
	Here it is. More...

Detailed Description

The QQnxScreen class implements a screen driver for QNX io-display based devices.

This function is under development and subject to change.

Since

4.6

Warning

This function is not part of the public interface.

Note - you never have to instanciate this class, the QScreenDriverFactory does that for us based on the QWS_DISPLAY environment variable.

To activate this driver, set QWS_DISPLAY to qnx.

Example: QWS_DISPLAY=qnx; export QWS_DISPLAY

By default, the main layer of the first display of the first device is used. If you have multiple graphic cards, multiple displays or multiple layers and don't want to connect to the default, you can override that with setting the corresponding options device, display or layer in the QWS_DISPLAY variable:

QWS_DISPLAY=qnx:device=3:display=4:layer=5

In addition, it is suggested to set the physical width and height of the display. QQnxScreen will use that information to compute the dots per inch (DPI) in order to render fonts correctly. If this informaiton is omitted, QQnxScreen defaults to 72 dpi.

QWS_DISPLAY=qnx:mmWidth=120:mmHeight=80

mmWidth and mmHeight are the physical width/height of the screen in millimeters.

See also

QScreen, QScreenDriverPlugin, {Running Qt for Embedded Linux Applications}{Running Applications}

Definition at line 57 of file qscreenqnx_qws.h.

Constructors and Destructors

QQnxScreen()

QQnxScreen::QQnxScreen ( int  display_id )

explicit

Constructs a QQnxScreen object.

The display_id argument identifies the Qt for Embedded Linux server to connect to.

Definition at line 145 of file qscreenqnx_qws.cpp.

    : QScreen(display_id), d(new QQnxScreenContext)
{
}

~QQnxScreen()

QQnxScreen::~QQnxScreen

(

)

Destroys this QQnxScreen object.

Definition at line 153 of file qscreenqnx_qws.cpp.

{
    delete d;
}

Functions

blank()

void QQnxScreen::blank ( bool  on )

virtual

Reimplemented Function

Reimplemented from QScreen.

Definition at line 504 of file qscreenqnx_qws.cpp.

{
    int ret = gf_display_set_dpms(d->display, on ? GF_DPMS_OFF : GF_DPMS_ON);
    if (ret != GF_ERR_OK)
        qWarning("QQnxScreen: gf_display_set_dpms() failed with error code %d", ret);
}

connect()

bool QQnxScreen::connect ( const QString &  displaySpec )

virtual

Connects to QNX's io-display based device based on the displaySpec parameters from the QWS_DISPLAY environment variable.

Reimplemented Function See the QQnxScreen class documentation for possible parameters.

See also

QQnxScreen

Implements QScreen.

Definition at line 320 of file qscreenqnx_qws.cpp.

{
    const QStringList params = displaySpec.split(QLatin1Char(':'), QString::SkipEmptyParts);

    // default to device 0
    int deviceIndex = 0;
    if (!params.isEmpty()) {
        QRegExp deviceRegExp(QLatin1String("^device=(.+)$"));
        if (params.indexOf(deviceRegExp) != -1)
            deviceIndex = deviceRegExp.cap(1).toInt();
    }

    if (!attachDevice(d, GF_DEVICE_INDEX(deviceIndex)))
        return false;

    qDebug("QQnxScreen: Attached to Device, number of displays: %d", d->deviceInfo.ndisplays);

    // default to display id passed to constructor
    int displayIndex = displayId;
    if (!params.isEmpty()) {
        QRegExp displayRegexp(QLatin1String("^display=(\\d+)$"));
        if (params.indexOf(displayRegexp) != -1)
            displayIndex = displayRegexp.cap(1).toInt();
    }

    if (!attachDisplay(d, displayIndex))
        return false;

    qDebug("QQnxScreen: Attached to Display %d, resolution %dx%d, refresh %d Hz",
            displayIndex, d->displayInfo.xres, d->displayInfo.yres, d->displayInfo.refresh);

    // default to main_layer_index from the displayInfo struct
    int layerIndex = d->displayInfo.main_layer_index;
    if (!params.isEmpty()) {
        QRegExp layerRegexp(QLatin1String("^layer=(\\d+)$"));
        if (params.indexOf(layerRegexp) != -1)
            layerIndex = layerRegexp.cap(1).toInt();
    }

    if (!attachLayer(d, layerIndex))
        return false;

    // determine the pixel format and the pixel type
    switch (d->displayInfo.format) {
#if defined(QT_QWS_DEPTH_32) || defined(QT_QWS_DEPTH_GENERIC)
        case GF_FORMAT_ARGB8888:
            pixeltype = QScreen::BGRPixel;
        // fall through
        case GF_FORMAT_BGRA8888:
            setPixelFormat(QImage::Format_ARGB32);
            break;
#endif
#if defined(QT_QWS_DEPTH_24)
        case GF_FORMAT_BGR888:
            pixeltype = QScreen::BGRPixel;
            setPixelFormat(QImage::Format_RGB888);
            break;
#endif
#if defined(QT_QWS_DEPTH_16) || defined(QT_QWS_DEPTH_GENERIC)
        case GF_FORMAT_PACK_RGB565:
        case GF_FORMAT_PKLE_RGB565:
        case GF_FORMAT_PKBE_RGB565:
#if Q_BYTE_ORDER == Q_BIG_ENDIAN
            setFrameBufferLittleEndian((d->displayInfo.format & GF_FORMAT_PKLE) == GF_FORMAT_PKLE);
#endif
            setPixelFormat(QImage::Format_RGB16);
            break;
#endif
        default:
            return false;
    }

    // tell QWSDisplay the width and height of the display
    w = dw = d->displayInfo.xres;
    h = dh = d->displayInfo.yres;
    QScreen::d = (d->displayInfo.format & GF_FORMAT_BPP);  // colour depth

    // assume 72 dpi as default, to calculate the physical dimensions if not specified
    const int defaultDpi = 72;
    // Handle display physical size
    physWidth = qRound(dw * 25.4 / defaultDpi);
    physHeight = qRound(dh * 25.4 / defaultDpi);
    if (!params.isEmpty()) {
        QRegExp mmWidthRegexp(QLatin1String("^mmWidth=(\\d+)$"));
        if (params.indexOf(mmWidthRegexp) != -1)
            physWidth = mmWidthRegexp.cap(1).toInt();

        QRegExp mmHeightRegexp(QLatin1String("^mmHeight=(\\d+)$"));
        if (params.indexOf(mmHeightRegexp) != -1)
            physHeight = mmHeightRegexp.cap(1).toInt();
    }

    if (QApplication::type() == QApplication::GuiServer) {
        // create a hardware surface with our dimensions. In the old days, it was possible
        // to get a pointer directly to the hw surface, so we could blit directly. Now, we
        // have to use one indirection more, because it's not guaranteed that the hw surface
        // is mappable into our process.
        if (!createHwSurface(d, w, h))
            return false;
    }

    // create an in-memory linear surface that is used by QWS. QWS will blit directly in here.
    if (!createMemSurface(d, w, h))
        return false;

    // set the address of the in-memory buffer that QWS is blitting to
    data = d->memSurfaceInfo.vaddr;
    // set the line stepping
    lstep = d->memSurfaceInfo.stride;

    // the overall size of the in-memory buffer is linestep * height
    size = mapsize = lstep * h;

    // done, the driver should be connected to the display now.
    return true;
}

disconnect()

void QQnxScreen::disconnect ( )

virtual

Reimplemented Function

Implements QScreen.

Definition at line 440 of file qscreenqnx_qws.cpp.

{
    d->cleanup();
}

exposeRegion()

void QQnxScreen::exposeRegion ( QRegion  r, int  changing  )

virtual

Reimplemented Function

Reimplemented from QScreen.

Definition at line 514 of file qscreenqnx_qws.cpp.

{
    // here is where the actual magic happens. QWS will call exposeRegion whenever
    // a region on the screen is dirty and needs to be updated on the actual screen.

    // first, call the parent implementation. The parent implementation will update
    // the region on our in-memory surface
    QScreen::exposeRegion(r, changing);

#ifndef QT_NO_QWS_TRANSFORMED
    if (qt_screen->isTransformed())
        return;
#endif
    // now our in-memory surface should be up to date with the latest changes.

    if (!d->hwSurface)
        return;

    // the code below copies the region from the in-memory surface to the hardware.

    // start drawing.
    int ret = gf_draw_begin(d->context);
    if (ret != GF_ERR_OK) {
        qWarning("QQnxScreen: gf_draw_begin() failed with error code %d", ret);
        return;
    }
    QVector<QRect> rects = r.rects();
    Q_FOREACH (QRect rect, rects) {
        if (!rect.isEmpty()) {
            // blit the changed region from the memory surface to the hardware surface
            ret = gf_draw_blit2(d->context, d->memSurface, d->hwSurface,
                                rect.x(), rect.y(), rect.right(), rect.bottom(), rect.x(), rect.y());
            if (ret != GF_ERR_OK)
                qWarning("QQnxScreen: gf_draw_blit2() failed with error code %d", ret);
        }
    }
    // flush all drawing commands (in our case, a single blit)
    ret = gf_draw_flush(d->context);
    if (ret != GF_ERR_OK)
        qWarning("QQnxScreen: gf_draw_flush() failed with error code %d", ret);

    // tell QNX that we're done drawing.
    gf_draw_end(d->context);
}

initDevice()

bool QQnxScreen::initDevice ( )

virtual

Reimplemented Function

Implements QScreen.

Definition at line 161 of file qscreenqnx_qws.cpp.

{
#ifndef QT_NO_QWS_CURSOR
    QScreenCursor::initSoftwareCursor();
#endif

    return true;
}

setDirty()

void QQnxScreen::setDirty ( const QRect &  rectangle )

virtual

Marks the given rectangle as dirty.

Note that the default implementation does nothing; reimplement this function to indicate that the given rectangle has been altered.

Reimplemented from QScreen.

Definition at line 560 of file qscreenqnx_qws.cpp.

{
    //This function is called only when the screen is transformed
    if (!qt_screen->isTransformed())
        return;

    if (!d->hwSurface)
        return;

    int ret = gf_draw_begin(d->context);

    if (ret != GF_ERR_OK) {
        qWarning("QQnxScreen: gf_draw_begin() failed with error code %d in setDirty", ret);
        return;
    }

    // blit the changed region from the memory surface to the hardware surface
    ret = gf_draw_blit2(d->context, d->memSurface, d->hwSurface,
                        r.x(), r.y(), r.x()+ r.width(), r.y()+r.height(), r.x(), r.y());
    if (ret != GF_ERR_OK)
        qWarning("QQnxScreen: gf_draw_blit2() failed with error code %d in setDirty", ret);

    ret = gf_draw_flush(d->context);
    if (ret != GF_ERR_OK)
        qWarning("QQnxScreen: gf_draw_flush() failed with error code %d in setDirty", ret);

    // tell QNX that we're done drawing.
    gf_draw_end(d->context);
}

setMode()

void QQnxScreen::setMode ( int  , int  , int    )

virtual

QQnxScreen doesn't support setting the mode, use io-display instead.

Reimplemented Function

Implements QScreen.

Definition at line 459 of file qscreenqnx_qws.cpp.

{
    qWarning("QQnxScreen: Unable to change mode, use io-display instead.");
}

shutdownDevice()

void QQnxScreen::shutdownDevice ( )

virtual

Reimplemented Function

Reimplemented from QScreen.

Definition at line 448 of file qscreenqnx_qws.cpp.

{
}

supportsDepth()

bool QQnxScreen::supportsDepth ( int  depth ) const

virtual

Reimplemented Function

Reimplemented from QScreen.

Definition at line 467 of file qscreenqnx_qws.cpp.

{
    gf_modeinfo_t displayMode;
    for (int i = 0; gf_display_query_mode(d->display, i, &displayMode) == GF_ERR_OK; ++i) {
        switch (displayMode.primary_format) {
#if defined(QT_QWS_DEPTH_32) || defined(QT_QWS_DEPTH_GENERIC)
            case GF_FORMAT_ARGB8888:
            case GF_FORMAT_BGRA8888:
                if (depth == 32)
                    return true;
                break;
#endif
#if defined(QT_QWS_DEPTH_24)
            case GF_FORMAT_BGR888:
                if (depth == 24)
                    return true;
                break;
#endif
#if defined(QT_QWS_DEPTH_16) || defined(QT_QWS_DEPTH_GENERIC)
            case GF_FORMAT_PACK_RGB565:
            case GF_FORMAT_PKLE_RGB565:
            case GF_FORMAT_PKBE_RGB565:
                if (depth == 16)
                    return true;
                break;
#endif
            default:
                break;
        }
    }

    return false;
}

Properties

d

QQnxScreenContext* const QQnxScreen::d

private

Definition at line 76 of file qscreenqnx_qws.h.

Referenced by blank(), connect(), disconnect(), exposeRegion(), setDirty(), supportsDepth(), and ~QQnxScreen().

---

The documentation for this class was generated from the following files:

• /src/gui/embedded/qscreenqnx_qws.h
• /src/gui/embedded/qscreenqnx_qws.cpp