QCanvasPixmap(3qt)

NAME
QCanvasPixmap - Pixmap in a QCanvas

#include <qcanvas.h>

Inherits QPixmap.

  Public Members
QCanvasPixmap ( const QString & datafilename )
QCanvasPixmap ( const QImage & image )
QCanvasPixmap ( const QPixmap & pm, const QPoint & offset )
~QCanvasPixmap ()
int offsetX () const
int offsetY () const
void setOffset ( int x, int y )

DESCRIPTION
The QCanvasPixmap class provides a pixmap in a QCanvas.

The pixmap is a QPixmap and can only be set in the constructor. There are three different constructors, one taking a QPixmap, one a QImage and one a file name that refers to a file in any supported file format (see QImageIO).

Since QCanvasSprite needs (and other uses of pixmaps often need) a hot spot, QCanvasPixmap provides one. When you create the QCanvasPixmap from a PNG file or from a QImage that has a QImage::offset(), the offset() is initialized appropriately, otherwise the constructor leaves it at (0,0). You can set it later using setOffset(). When the QCanvasPixmap is used in a QCanvasSprite, the offset position is the point at QCanvasItem::x() and QCanvasItem::y(), not the top-left corner of the pixmap.

Note that for QCanvasPixmap objects created by a QCanvasSprite, the position of each QCanvasPixmap object is set so that the hot spot stays in the same position.

Like any other canvas item canvas pixmaps can be moved with QCanvasItem::move() and QCanvasItem::moveBy(), or by setting coordinates with QCanvasItem::setX(), QCanvasItem::setY() and QCanvasItem::setZ().

See also QCanvasPixmapArray, QCanvasItem, QCanvasSprite, Graphics Classes and Image Processing Classes.

MEMBER FUNCTION DOCUMENTATION

QCanvasPixmap::QCanvasPixmap ( const QString & datafilename )
Constructs a QCanvasPixmap from an image file at the location specified in datafilename by loading it.

QCanvasPixmap::QCanvasPixmap ( const QImage & image )
Constructs a QCanvasPixmap from the image image.

QCanvasPixmap::QCanvasPixmap ( const QPixmap & pm, const QPoint & offset )
Constructs a QCanvasPixmap from the pixmap pm using the offset offset.

QCanvasPixmap::~QCanvasPixmap ()
Destroys the pixmap.

int QCanvasPixmap::offsetX () const
Returns the X-offset of the pixmap's hot spot.

See also setOffset().

int QCanvasPixmap::offsetY () const
Returns the Y-offset of the pixmap's hot spot.

See also setOffset().

void QCanvasPixmap::setOffset ( int x, int y )
Sets the offset of the pixmap's hot spot to (x, y).

Note that you must not call this function if any QCanvasSprites are currently showing this pixmap.

SEE ALSO
http://doc.trolltech.com/qcanvaspixmap.html http://www.trolltech.com/faq/tech.html

COPYRIGHT
Copyright 1992-2001 Trolltech AS, http://www.trolltech.com. See the license file included in the distribution for a complete license statement.

AUTHOR
Generated automatically from the source code.

BUGS
If you find a bug in Qt, please report it as described in http://doc.trolltech.com/bughowto.html. Good bug reports help us to help you. Thank you.

The definitive Qt documentation is provided in HTML format; it is located at $QTDIR/doc/html and can be read using Qt Assistant or with a web browser. This man page is provided as a convenience for those users who prefer man pages, although this format is not officially supported by Trolltech.

If you find errors in this manual page, please report them to qt-bugs@trolltech.com. Please include the name of the manual page (qcanvaspixmap.3qt) and the Qt version (3.0.0-beta6).