QScreen Class Reference
^{[QtGui module]}

Screen Properties

QScreen provides information about several screen properties: The size of the screen can be retrieved using the screenSize() function. Alternatively, its width and height can be retrieved using the width() and height() functions respectively. QScreen also provides the deviceWidth() and deviceHeight() functions which returns the full size of the device. Note that these metrics can differ from the ones used if the display is centered within the framebuffer.

The setMode() function allows subclasses of QScreen to set the framebuffer to a new resolution (width and height) and bit depth. The current depth of the framebuffer can be retrieved using the depth() function.

Use the pixmapDepth() function to obtain the preferred depth for pixmaps. In addition, QScreen provides the pixmapOffsetAlignment() function returning the value to which the start address of pixmaps held in the graphics card's memory, should be aligned. The pixmapLinestepAlignment() returns the value to which the individual scanlines of pixmaps should be aligned.

The isInterlaced() function tells whether the screen is displaying images progressively, and the isTransformed() function whether it is rotated. The transformOrientation() function can be reimplemented to return the current rotation.

The linestep() function returns the length of each scanline of the framebuffer.

The pixelType() returns the screen's pixel storage format as described by the PixelType enum, the opType() function returns the screen's operation type, and the lastOp() function returns the screens last operation.

See also Running Applications and Qtopia Core.

Member Type Documentation

enum QScreen::PixelType

This enum describes the pixel storage format of the screen, i.e. the order of the red (R), green (G) and blue (B) components of a pixel.

See also pixelType().

Member Function Documentation

QScreen::QScreen ( int displayId )

Constructs a QScreen object. The displayId identifies the the Qtopia Core server to connect to.

QScreen::~QScreen ()   [virtual]

Destroys this QScreen object.

int QScreen::alloc ( unsigned int red, unsigned int green, unsigned int blue )   [virtual]

Returns the index in the screen's palette which is the closest match to the given RGB value (red, green, blue).

Note that this function only apply in paletted modes, i.e. in modes where only palette indexes (and not actual color values) are stored in memory (e.g. 8-bit mode).

See also clut().

uchar * QScreen::base () const

Returns a pointer to the beginning of the framebuffer.

See also onCard().

void QScreen::blank ( bool on )   [virtual]

Avoids displaying any contents on the screen if on is true; otherwise the contents is shown.

The default implementation does nothing.

void QScreen::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.

Reimplement this function to use accelerated hardware. Note that reimplementing this function requires that the solidFill() function is reimplemented as well.

See also exposeRegion() and Adding an Accelerated Graphics Driver.

QRgb * QScreen::clut ()

Returns the screen's color lookup table (i.e. its color palette).

Note that this function only apply in paletted modes, i.e. in modes where only palette indexes (and not actual color values) are stored in memory (e.g. 8-bit mode).

See also alloc(), depth(), and numCols().

bool QScreen::connect ( const QString & displaySpec )   [pure virtual]

This function is called by every Qtopia Core application on startup, and must be reimplemented to map in the framebuffer and the accelerated drivers that the graphics card control registers.

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 also disconnect() and Running Applications.

int QScreen::depth () const

Returns the depth of the framebuffer, in bits per pixel.

Note that the returned depth is the number of bits each pixel takes up rather than the number of significant bits, so 24bpp and 32bpp express the same range of colors (8 bits of red, green and blue).

See also clut() and pixmapDepth().

int QScreen::deviceHeight () const

Returns the full height of the framebuffer device.

Note that the returned height can differ from the height which Qtopia Core will actually use, that is if the display is centered within the framebuffer.

See also deviceWidth() and height().

int QScreen::deviceWidth () const

Returns the full width of the framebuffer device.

Note that the returned width can differ from the width which Qtopia Core will actually use, that is if the display is centered within the framebuffer.

See also deviceHeight() and width().

void QScreen::disconnect ()   [pure virtual]

This function is called by every Qtopia Core application just before exiting, and should be reimplemented to unmap the framebuffer.

See also connect().

void QScreen::exposeRegion ( QRegion region, int windowIndex )   [virtual]

Paints the given region on screen. The windowIndex parameter refer to the affected windows.

Note that there is no need to call this function explicitly, but it must be reimplemented in derived classes. It can also be reimplemented to make use of accelerated hardware, but this is typically done by reimplementing the blit() function instead.

See also blit().

int QScreen::height () const

Returns the height of the framebuffer, in pixels.

See also deviceHeight() and width().

bool QScreen::initDevice ()   [pure virtual]

This function is called by the Qtopia Core server when initializing the framebuffer.

Reimplement this function to make accelerated drivers set up the graphics card. The default implementation does nothing.

See also Adding an Accelerated Graphics Driver.

bool QScreen::isInterlaced () const   [virtual]

Returns true if the display is interlaced (for instance a television screen); otherwise returns false.

If true, drawing is altered to look better on such displays.

bool QScreen::isTransformed () const   [virtual]

Returns true if the screen is transformed (for instance, rotated 90 degrees); otherwise returns false.

See also QTransformedScreen::transformation().

int * QScreen::lastOp ()

Returns the screens last operation.

See also opType().

int QScreen::linestep () const

Returns the length of each scanline of the framebuffer, in bytes.

See also QDirectPainter::linestep().

QSize QScreen::mapFromDevice ( const QSize & size ) const   [virtual]

This virtual function allows subclasses of QScreen to map the given object from the framebuffer coordinate system to the coordinate space used by the application.

In the case of a size object, this means switching its height and width. Note that the default implementation simply returns the given size as it is.

See also mapToDevice().

QPoint QScreen::mapFromDevice ( const QPoint & point, const QSize & screenSize ) const   [virtual]

This is an overloaded member function, provided for convenience.

This virtual function allows subclasses of QScreen to map the given object from the framebuffer coordinate system to the coordinate space used by the application, passing the device's screenSize as argument.

Note that the default implementation returns the given point as it is.

QRect QScreen::mapFromDevice ( const QRect & rectangle, const QSize & screenSize ) const   [virtual]

This is an overloaded member function, provided for convenience.

This virtual function allows subclasses of QScreen to map the given object from the framebuffer coordinate system to the coordinate space used by the application, passing the device's screenSize as argument.

The default implementation returns the given rectangle as it is.

QImage QScreen::mapFromDevice ( const QImage & image ) const   [virtual]

This is an overloaded member function, provided for convenience.

This virtual function allows subclasses of QScreen to map the given object from the framebuffer coordinate system to the coordinate space used by the application.

The default implementation returns the given image as it is.

QRegion QScreen::mapFromDevice ( const QRegion & region, const QSize & screenSize ) const   [virtual]

This is an overloaded member function, provided for convenience.

This virtual function allows subclasses of QScreen to map the given object from the framebuffer coordinate system to the coordinate space used by the application, passing the device's screenSize as argument .

The default implementation returns the given region as it is.

QSize QScreen::mapToDevice ( const QSize & size ) const   [virtual]

This virtual function allows subclasses of QScreen to map the given object from the coordinate space used by the application to the framebuffer coordinate system.

In the case of a size object, this means switching its height and width. Note that the default implementation simply returns the given size as it is.

See also mapFromDevice().

QPoint QScreen::mapToDevice ( const QPoint & point, const QSize & screenSize ) const   [virtual]

This is an overloaded member function, provided for convenience.

This virtual function allows subclasses of QScreen to map the given object from the coordinate space used by the application to the framebuffer coordinate system, passing the device's screenSize as argument.

Note that the default implementation returns the given point as it is.

QRect QScreen::mapToDevice ( const QRect & rectangle, const QSize & screenSize ) const   [virtual]

This is an overloaded member function, provided for convenience.

This virtual function allows subclasses of QScreen to map the given object from the coordinate space used by the application to the framebuffer coordinate system, passing the device's screenSize as argument.

Note that the default implementation returns the given rectangle as it is.

QImage QScreen::mapToDevice ( const QImage & image ) const   [virtual]

This is an overloaded member function, provided for convenience.

This virtual function allows subclasses of QScreen to map the given object from the coordinate space used by the application to the framebuffer coordinate system.

The default implementation returns the given image as it is.

QRegion QScreen::mapToDevice ( const QRegion & region, const QSize & screenSize ) const   [virtual]

This is an overloaded member function, provided for convenience.

This virtual function allows subclasses of QScreen to map the given object from the coordinate space used by the application to the framebuffer coordinate system, passing the device's screenSize as argument.

The default implementation returns the given region as it is.

int QScreen::numCols ()

Returns the number of entries in the screen's color lookup table (i.e. its color palette). The color table can be retrieved using the clut() function.

See also clut().

bool QScreen::onCard ( const unsigned char * buffer ) const   [virtual]

Returns true if the specified buffer is within the graphics card's memory; otherwise returns false (i.e. if it's in main RAM).

See also base() and totalSize().

bool QScreen::onCard ( const unsigned char * buffer, ulong & offset ) const   [virtual]

This is an overloaded member function, provided for convenience.

If the specified buffer is within the graphics card's memory, this function stores the offset (in bytes) from the start of graphics card memory, in the location specified by the offset parameter.

int * QScreen::opType ()

Returns the screen's operation type.

See also lastOp().

PixelType QScreen::pixelType () const

Returns the pixel storage format of the screen.

See also PixelType.

int QScreen::pixmapDepth () const   [virtual]

Returns the preferred depth for pixmaps, in bits per pixel.

See also depth().

int QScreen::pixmapLinestepAlignment ()   [virtual]

Returns the value (in bits) to which individual scanlines of pixmaps held in the graphics card's memory, should be aligned.

The default implementation returns 64. Reimplement this function to override the return value when implementing an accelerated driver.

See also pixmapOffsetAlignment() and Adding an Accelerated Graphics Driver.

int QScreen::pixmapOffsetAlignment ()   [virtual]

Returns the value (in bits) to which the start address of pixmaps held in the graphics card's memory, should be aligned.

The default implementation returns 64. Reimplement this function to override the return value when implementing an accelerated driver.

See also pixmapLinestepAlignment() and Adding an Accelerated Graphics Driver.

void QScreen::restore ()   [virtual]

This virtual function allows subclasses of QScreen to restore a previously saved state of the graphics card.

Note that the default implementation does nothing.

See also save().

void QScreen::save ()   [virtual]

This virtual function allows subclasses of QScreen to save the state of the graphics card, and be able to restored it later.

Hardware QScreen descendants should save the state of the registers here, if necessary, to enable switching between virtual consoles (for example to and from X).

Note that the default implementation does nothing.

See also restore().

int QScreen::screenSize () const

Returns the size of the screen, in bytes.

The screen size is always located at the beginning of framebuffer memory, i.e. it can also be retrieved using the base() function.

See also base().

void QScreen::setDirty ( const QRect & rectangle )   [virtual]

This virtual function allows subclasses of QScreen to indicate that the given rectangle of the screen has been altered.

Note that the default implementation does nothing.

void QScreen::setMode ( int width, int height, int depth )   [pure virtual]

This virtual function allows subclasses of QScreen to set the framebuffer to a new resolution (width and height) and bit depth.

After doing this any currently-existing paint engines will be invalid and the screen should be completely redrawn. In a multiple-process situation, all other applications must be notified to set the same mode and redraw.

Note that the default implementation does nothing.

void QScreen::shutdownDevice ()   [virtual]

This virtual function is called by the Qtopia Core server on shutdown, and allows subclasses of QScreen to support graphics card specific cleanup.

The default implementation simply hides the mouse cursor.

void QScreen::solidFill ( const QColor & color, const QRegion & region )   [virtual]

This virtual function allows subclasses of QScreen to fill the given region of the screen with the specified color. Note that this function is not intended to be called explicitly.

See also blit().

bool QScreen::supportsDepth ( int depth ) const   [virtual]

Returns true if the screen supports the specified color depth; otherwise returns false.

Possible values are 1,4,8,16 and 32.

See also clut().

int QScreen::totalSize () const

Returns the size of the available graphics card memory, including the screen, in bytes.

Offscreen memory is only used by the accelerated drivers.

See also onCard().

int QScreen::transformOrientation () const   [virtual]

This virtual function allows subclasses of QScreen to return the current rotation of the screeen as an integer value.

The default implementation returns 0.

See also isTransformed().

int QScreen::width () const

Returns the width of the framebuffer, in pixels.

See also deviceWidth() and height().