Q3CanvasPixmap Class

The Q3CanvasPixmap class provides pixmaps for Q3CanvasSprites. 更多...

头: #include <Q3CanvasPixmap>
继承: QPixmap

公共函数

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

额外继承成员

详细描述

The Q3CanvasPixmap class provides pixmaps for Q3CanvasSprites.

If you want to show a single pixmap on a Q3Canvas use a Q3CanvasSprite with just one pixmap.

When pixmaps are inserted into a Q3CanvasPixmapArray they are held as Q3CanvasPixmaps. Q3CanvasSprite s are used to show pixmaps on Q3Canvas es and hold their pixmaps in a Q3CanvasPixmapArray . If you retrieve a frame (pixmap) from a Q3CanvasSprite it will be returned as a Q3CanvasPixmap .

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 QImageReader ).

Q3CanvasPixmap can have a hotspot which is defined in terms of an (x, y) offset. When you create a Q3CanvasPixmap 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 Q3CanvasPixmap is used in a Q3CanvasSprite , the offset position is the point at Q3CanvasItem::x () 和 Q3CanvasItem::y (), not the top-left corner of the pixmap.

Note that for Q3CanvasPixmap objects created by a Q3CanvasSprite , the position of each Q3CanvasPixmap object is set so that the hotspot stays in the same position.

另请参阅 Q3CanvasPixmapArray , Q3CanvasItem , Q3CanvasSprite , QtCanvas ,和 Porting to Graphics View .

成员函数文档编制

Q3CanvasPixmap:: Q3CanvasPixmap (const QString & datafilename )

构造 Q3CanvasPixmap that uses the image stored in datafilename .

Q3CanvasPixmap:: Q3CanvasPixmap (const QImage & image )

构造 Q3CanvasPixmap from the image image .

Q3CanvasPixmap:: Q3CanvasPixmap (const QPixmap & pm , const QPoint & offset )

构造 Q3CanvasPixmap from the pixmap pm using the offset offset .

Q3CanvasPixmap:: ~Q3CanvasPixmap ()

销毁像素图。

int Q3CanvasPixmap:: offsetX () const

Returns the x-offset of the pixmap's hotspot.

另请参阅 setOffset ().

int Q3CanvasPixmap:: offsetY () const

Returns the y-offset of the pixmap's hotspot.

另请参阅 setOffset ().

void Q3CanvasPixmap:: setOffset ( int x , int y )

Sets the offset of the pixmap's hotspot to ( x , y ).

警告: Do not call this function if any Q3CanvasSprites are currently showing this pixmap.