QAhiScreen Class Reference

#include <qscreenahi_qws.h>

Inheritance diagram for QAhiScreen:

Public Functions
void	blit (const QImage &image, const QPoint &topLeft, const QRegion &region)
	Copies the given region in the given image to the point specified by topLeft using device coordinates. More...
bool	connect (const QString &displaySpec)
	This function is called by every Qt for Embedded Linux application on startup, and must be implemented to map in the framebuffer and the accelerated drivers that the graphics card control registers. More...
void	disconnect ()
	This function is called by every Qt for Embedded Linux application before exiting, and must be implemented to unmap the framebuffer. More...
bool	initDevice ()
	This function is called by the Qt for Embedded Linux server to initialize the framebuffer. More...
	QAhiScreen (int displayId)
void	setMode (int width, int height, int depth)
	Implement this function to reset the framebuffer's resolution (width and height) and bit depth. More...
void	shutdownDevice ()
	This function is called by the Qt for Embedded Linux server before it calls the disconnect() function when exiting. More...
void	solidFill (const QColor &color, const QRegion &region)
	Fills the given region of the screen with the specified color. More...
	~QAhiScreen ()
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	blank (bool on)
	Prevents the screen driver form displaying any content on the screen. 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...
virtual void	exposeRegion (QRegion r, int changing)
	This function is called by the Qt for Embedded Linux server whenever a screen update is required. 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)
virtual void	setDirty (const QRect &)
	Marks the given rectangle as dirty. More...
void	setOffset (const QPoint &p)
virtual int	sharedRamSize (void *)
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
virtual bool	supportsDepth (int) const
	Returns true if the screen supports the specified color depth; otherwise returns false. More...
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...

Private Functions
bool	configure ()

Properties
QAhiScreenPrivate *	d_ptr

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

Definition at line 57 of file qscreenahi_qws.h.

Constructors and Destructors

QAhiScreen()

QAhiScreen::QAhiScreen

(

int

displayId

)

Definition at line 266 of file qscreenahi_qws.cpp.

    : QScreen(displayId), d_ptr(new QAhiScreenPrivate)
{
}

~QAhiScreen()

QAhiScreen::~QAhiScreen

(

)

Definition at line 271 of file qscreenahi_qws.cpp.

{
    delete d_ptr;
}

Functions

blit()

void QAhiScreen::blit ( const QImage &  image, const QPoint &  topLeft, const QRegion &  region  )

virtual

Copies the given region in the given image to the point specified by topLeft using device coordinates.

This function is called from the exposeRegion() function; it is not intended to be called explicitly.

Reimplement this function to make use of Adding an Accelerated Graphics Driver to Qt for Embedded Linux{accelerated hardware}. Note that this function must be reimplemented if the framebuffer format is not supported by Qt for Embedded Linux (See the Qt for Embedded Linux Display Management{Display Management} documentation for more details).

See also

exposeRegion(), solidFill(), blank()

Reimplemented from QScreen.

Definition at line 477 of file qscreenahi_qws.cpp.

{
    AhiPixelFormat_t pixFmt = pixelFormatForImageFormat(image.format());

    if (pixFmt >= AhiPixelFormatMax) { // generic fallback
        QImage::Format toFormat = pixelFormat();
        if (toFormat == QImage::Format_Invalid)
            toFormat = QImage::Format_ARGB32;
        blit(image.convertToFormat(toFormat), topLeft, reg);
        return;
    }

    AhiSts_t status;

    status = AhiDrawSurfDstSet(d_ptr->context, d_ptr->surface, 0);
    if (status != AhiStsOk) {
        qWarning("QAhiScreen::blit(): AhiDrawSurfDstSet failed: %x", status);
        return;
    }

    const QVector<QRect> rects = (reg & region()).rects();
    const int numRects = rects.size();
    QVarLengthArray<AhiPoint_t, 8> src(numRects);
    QVarLengthArray<AhiRect_t, 8> dest(numRects);

    for (int i = 0; i < numRects; ++i) {
        const QRect rect = rects.at(i);

        src[i].x = rect.x() - topLeft.x();
        src[i].y = rect.y() - topLeft.y();
        dest[i].left = rect.left();
        dest[i].top = rect.top();
        dest[i].right = rect.x() + rect.width();
        dest[i].bottom = rect.y() + rect.height();
    }

    AhiSize_t bitmapSize = { image.width(), image.height() };
    AhiBitmap_t bitmap = { bitmapSize, (void*)(image.bits()),
                           image.bytesPerLine(), pixFmt };

    status = AhiDrawRopSet(d_ptr->context, AHIMAKEROP3(AHIROPSRCCOPY));
    if (status != AhiStsOk) {
        qWarning("QAhiScreen::blit(): AhiDrawRopSet failed: %x", status);
        return;
    }

    for (int i = 0; i < numRects; ++i) {
        status = AhiDrawBitmapBlt(d_ptr->context, &dest[i], &src[i],
                                  &bitmap, 0, 0);
        if (status != AhiStsOk) {
            qWarning("QAhiScreen::blit(): AhiDrawBitmapBlt failed: %x",
                     status);
            break;
        }
    }
}

configure()

bool QAhiScreen::configure ( )

private

Definition at line 276 of file qscreenahi_qws.cpp.

Referenced by connect(), and setMode().

{
    AhiSurfInfo_t surfaceInfo;
    AhiSts_t status;

    status = AhiSurfInfo(d_ptr->context, d_ptr->surface, &surfaceInfo);
    if (status != AhiStsOk) {
        qCritical("QAhiScreen::configure(): AhiSurfInfo failed: %x", status);
        return false;
    }

    QScreen::data = 0;
    QScreen::w = QScreen::dw = surfaceInfo.size.cx;
    QScreen::h = QScreen::dh = surfaceInfo.size.cy;
    QScreen::lstep = surfaceInfo.stride;
    QScreen::size = surfaceInfo.sizeInBytes;

    switch (surfaceInfo.pixFmt) {
    case AhiPix1bpp:
        setPixelFormat(QImage::Format_Mono);
        QScreen::d = 1;
        break;
    case AhiPix4bpp:
        QScreen::d = 4;
        break;
    case AhiPix8bpp_332RGB:
    case AhiPix8bpp:
        QScreen::d = 8;
        break;
    case AhiPix16bpp_444RGB:
        setPixelFormat(QImage::Format_RGB444);
        QScreen::d = 12;
        break;
    case AhiPix16bpp_555RGB:
        setPixelFormat(QImage::Format_RGB555);
        QScreen::d = 15;
        break;
    case AhiPix16bpp_565RGB:
        setPixelFormat(QImage::Format_RGB16);
        QScreen::d = 16;
        break;
    case AhiPix2bpp:
        QScreen::d = 2;
        break;
    case AhiPix32bpp_8888ARGB:
        setPixelFormat(QImage::Format_ARGB32);
        // fallthrough
    case AhiPix32bpp_8888BGRA:
        QScreen::d = 32;
        break;
    default:
        qCritical("QAhiScreen::configure(): Unknown pixel format: %x",
                  surfaceInfo.pixFmt);
        return false;
    }

    const int dpi = 72;
    QScreen::physWidth = qRound(QScreen::dw * 25.4 / dpi);
    QScreen::physHeight = qRound(QScreen::dh * 25.4 / dpi);

    return true;
}

connect()

bool QAhiScreen::connect ( const QString &  displaySpec )

virtual

This function is called by every Qt for Embedded Linux application on startup, and must be implemented to map in the framebuffer and the accelerated drivers that the graphics card control registers.

Note that connect must be called before the initDevice() function.

Ensure that true is returned if a connection to the screen device is made. Otherwise, return false. Upon making the connection, the function should read out the parameters of the framebuffer and use them as required to set this class's protected variables.

The displaySpec argument is passed by the QWS_DISPLAY environment variable or the -display command line parameter, and has the following syntax:

[screen driver][:driver specific options][:display number]

For example, to use the mach64 driver on fb1 as display 2:

Mach64:/dev/fb1:2

See Qt for Embedded Linux Display Management for more details.

See also

disconnect(), initDevice(), {Running Qt for Embedded Linux Applications}

Implements QScreen.

Definition at line 339 of file qscreenahi_qws.cpp.

{
    Q_UNUSED(displaySpec);

    AhiSts_t status;

    status = AhiInit(0);
    if (status != AhiStsOk) {
        qCritical("QAhiScreen::connect(): AhiInit failed: %x", status);
        return false;
    }

    AhiDev_t device;
    AhiDevInfo_t info;

    status = AhiDevEnum(&device, &info, 0);
    if (status != AhiStsOk) {
        qCritical("QAhiScreen::connect(): AhiDevEnum failed: %x", status);
        return false;
    }
#ifdef QAHISCREEN_DEBUG
    {
        int displayNo = 0;
        AhiDevInfo_t dispInfo = info;
        qDebug("AHI supported devices:");
        do {
            qDebug("  %2i: %s, sw version: %s (rev %u)\n"
                   "       chip: 0x%x (rev %u), mem: %i (%i/%i), bus: 0x%x",
                   displayNo, dispInfo.name,
                   dispInfo.swVersion, uint(dispInfo.swRevision),
                   uint(dispInfo.chipId), uint(dispInfo.revisionId),
                   uint(dispInfo.totalMemory),
                   uint(dispInfo.internalMemSize),
                   uint(dispInfo.externalMemSize),
                   uint(dispInfo.cpuBusInterfaceMode));
            status = AhiDevEnum(&device, &info, ++displayNo);
        } while (status == AhiStsOk);
    }
#endif

    status = AhiDevOpen(&d_ptr->context, device, "qscreenahi",
                        AHIFLAG_USERLEVEL);
    if (status != AhiStsOk) {
        qCritical("QAhiScreen::connect(): AhiDevOpen failed: %x", status);
        return false;
    }

    AhiDispMode_t mode;

    status = AhiDispModeEnum(d_ptr->context, &mode, 0);
    if (status != AhiStsOk) {
        qCritical("QAhiScreen::connect(): AhiDispModeEnum failed: %x", status);
        return false;
    }

#ifdef QAHISCREEN_DEBUG
    {
        int modeNo = 0;
        AhiDispMode_t modeInfo = mode;
        qDebug("AHI supported modes:");
        do {
            qDebug("  %2i: %ux%u, fmt: %i, %u Hz, rot: %i, mirror: %i",
                   modeNo, uint(modeInfo.size.cx), uint(modeInfo.size.cy),
                   modeInfo.pixFmt, uint(modeInfo.frequency),
                   modeInfo.rotation, modeInfo.mirror);
            status = AhiDispModeEnum(d_ptr->context, &modeInfo, ++modeNo);
        } while (status == AhiStsOk);
    }
#endif

    if (QApplication::type() == QApplication::GuiServer) {
        if (!d_ptr->setMode(mode))
            return false;
    } else {
        status = AhiDispSurfGet(d_ptr->context, &d_ptr->surface);
        if (status != AhiStsOk) {
            qCritical("QAhiScreen::connect(): AhiDispSurfGet failed: %x",
                      status);
            return false;
        }

        status = AhiDispModeGet(d_ptr->context, &mode);
        if (status != AhiStsOk) {
            qCritical("QAhiScreen::context(): AhiDispModeGet failed: %x",
                      status);
            return false;
        }
    }

    return configure();
}

disconnect()

void QAhiScreen::disconnect ( )

virtual

This function is called by every Qt for Embedded Linux application before exiting, and must be implemented to unmap the framebuffer.

Note that a server application will call the shutdownDevice() function prior to this function.

See also

connect(), shutdownDevice(), {Running Qt for Embedded Linux Applications}

Implements QScreen.

Definition at line 431 of file qscreenahi_qws.cpp.

{
    AhiSurfFree(d_ptr->context, d_ptr->surface);
    d_ptr->surface = 0;
    AhiDevClose(d_ptr->context);
    d_ptr->context = 0;
    AhiTerm();
}

initDevice()

bool QAhiScreen::initDevice ( )

virtual

This function is called by the Qt for Embedded Linux server to initialize the framebuffer.

Note that a server application will call the connect() function prior to this function.

Implement this function to make accelerated drivers set up the graphics card. Return true to indicate success and false to indicate failure.

See also

shutdownDevice(), connect()

Implements QScreen.

Definition at line 440 of file qscreenahi_qws.cpp.

{
    QScreenCursor::initSoftwareCursor();

    AhiSts_t status = AhiDispState(d_ptr->context, AhiDispStateOn, 0);
    if (status != AhiStsOk) {
        qCritical("QAhiScreen::connect(): AhiDispState failed: %x", status);
        return false;
    }

    return true;
}

setMode()

void QAhiScreen::setMode ( int  width, int  height, int  depth  )

virtual

Implement this function to reset the framebuffer's resolution (width and height) and bit depth.

After the resolution has been set, existing paint engines will be invalid and the framebuffer should be completely redrawn. In a multiple-process situation, all other applications must be notified to reset their mode and update themselves accordingly.

Implements QScreen.

Definition at line 458 of file qscreenahi_qws.cpp.

{
    int modeNo = 0;
    AhiDispMode_t mode;
    AhiSts_t status = AhiStsOk;

    while (status == AhiStsOk) {
        status = AhiDispModeEnum(d_ptr->context, &mode, modeNo);
        if (mode.size.cx == uint(width) &&
            mode.size.cy == uint(height) &&
            depthForPixelFormat(mode.pixFmt) == depth)
        {
            d_ptr->setMode(mode);
            configure();
            return;
        }
    }
}

shutdownDevice()

void QAhiScreen::shutdownDevice ( )

virtual

This function is called by the Qt for Embedded Linux server before it calls the disconnect() function when exiting.

Note that the default implementation only hides the mouse cursor; reimplement this function to do the necessary graphics card specific cleanup.

See also

initDevice(), disconnect()

Reimplemented from QScreen.

Definition at line 453 of file qscreenahi_qws.cpp.

{
    AhiDispState(d_ptr->context, AhiDispStateOff, 0);
}

solidFill()

void QAhiScreen::solidFill ( const QColor &  color, const QRegion &  region  )

virtual

Fills the given region of the screen with the specified color.

This function is called from the exposeRegion() function; it is not intended to be called explicitly.

Reimplement this function to make use of Adding an Accelerated Graphics Driver to Qt for Embedded Linux{accelerated hardware}. Note that this function must be reimplemented if the framebuffer format is not supported by Qt for Embedded Linux (See the Qt for Embedded Linux Display Management{Display Management} documentation for more details).

See also

exposeRegion(), blit(), blank()

Reimplemented from QScreen.

Definition at line 535 of file qscreenahi_qws.cpp.

{
    AhiSts_t status = AhiStsOk;

    switch (pixelFormat()) {
    case QImage::Format_ARGB32_Premultiplied:
    case QImage::Format_ARGB32:
    case QImage::Format_RGB32:
        status = AhiDrawBrushFgColorSet(d_ptr->context, color.rgba());
        break;
    case QImage::Format_RGB16:
        status = AhiDrawBrushFgColorSet(d_ptr->context, qt_convRgbTo16(color.rgb()));
        break;
    default:
        qFatal("QAhiScreen::solidFill(): Not implemented for pixel format %d",
               int(pixelFormat()));
        break;
    }

    if (status != AhiStsOk) {
        qWarning("QAhiScreen::solidFill(): AhiDrawBrushFgColorSet failed: %x",
                 status);
        return;
    }

    status = AhiDrawBrushSet(d_ptr->context, 0, 0, 0, AHIFLAG_BRUSHSOLID);
    if (status != AhiStsOk) {
        qWarning("QAhiScreen::solidFill(): AhiDrawBrushSet failed: %x",
                 status);
        return;
    }

    status = AhiDrawRopSet(d_ptr->context, AHIMAKEROP3(AHIROPPATCOPY));
    if (status != AhiStsOk) {
        qWarning("QAhiScreen::solidFill(): AhiDrawRopSet failed: %x", status);
        return;
    }

    status = AhiDrawSurfDstSet(d_ptr->context, d_ptr->surface, 0);
    if (status != AhiStsOk) {
        qWarning("QAhiScreen::solidFill(): AhiDrawSurfDst failed: %x", status);
        return;
    }

    const QVector<QRect> rects = (reg & region()).rects();
    QVarLengthArray<AhiRect_t> ahiRects(rects.size());

    for (int i = 0; i < rects.size(); ++i) {
        const QRect rect = rects.at(i);
        ahiRects[i].left = rect.left();
        ahiRects[i].top = rect.top();
        ahiRects[i].right = rect.x() + rect.width();
        ahiRects[i].bottom = rect.y() + rect.height();
    }

    status = AhiDrawBitBltMulti(d_ptr->context, ahiRects.data(),
                                0, ahiRects.size());
    if (status != AhiStsOk)
        qWarning("QAhiScreen::solidFill(): AhiDrawBitBlt failed: %x", status);
}

Properties

d_ptr

QAhiScreenPrivate* QAhiScreen::d_ptr

private

Definition at line 76 of file qscreenahi_qws.h.

Referenced by blit(), configure(), connect(), disconnect(), initDevice(), setMode(), shutdownDevice(), solidFill(), and ~QAhiScreen().

---

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

• /src/plugins/gfxdrivers/ahi/qscreenahi_qws.h
• /src/plugins/gfxdrivers/ahi/qscreenahi_qws.cpp