diff options
Diffstat (limited to 'doc/man/man3/qcanvaspixmap.3qt')
-rw-r--r-- | doc/man/man3/qcanvaspixmap.3qt | 100 |
1 files changed, 100 insertions, 0 deletions
diff --git a/doc/man/man3/qcanvaspixmap.3qt b/doc/man/man3/qcanvaspixmap.3qt new file mode 100644 index 000000000..6bb557b1f --- /dev/null +++ b/doc/man/man3/qcanvaspixmap.3qt @@ -0,0 +1,100 @@ +'\" t +.TH QCanvasPixmap 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the +.\" license file included in the distribution for a complete license +.\" statement. +.\" +.ad l +.nh +.SH NAME +QCanvasPixmap \- Pixmaps for QCanvasSprites +.SH SYNOPSIS +\fC#include <qcanvas.h>\fR +.PP +Inherits QPixmap. +.PP +.SS "Public Members" +.in +1c +.ti -1c +.BI "\fBQCanvasPixmap\fR ( const QString & datafilename )" +.br +.ti -1c +.BI "\fBQCanvasPixmap\fR ( const QImage & image )" +.br +.ti -1c +.BI "\fBQCanvasPixmap\fR ( const QPixmap & pm, const QPoint & offset )" +.br +.ti -1c +.BI "\fB~QCanvasPixmap\fR ()" +.br +.ti -1c +.BI "int \fBoffsetX\fR () const" +.br +.ti -1c +.BI "int \fBoffsetY\fR () const" +.br +.ti -1c +.BI "void \fBsetOffset\fR ( int x, int y )" +.br +.in -1c +.SH DESCRIPTION +The QCanvasPixmap class provides pixmaps for QCanvasSprites. +.PP +If you want to show a single pixmap on a QCanvas use a QCanvasSprite with just one pixmap. +.PP +When pixmaps are inserted into a QCanvasPixmapArray they are held as QCanvasPixmaps. QCanvasSprites are used to show pixmaps on QCanvases and hold their pixmaps in a QCanvasPixmapArray. If you retrieve a frame (pixmap) from a QCanvasSprite it will be returned as a QCanvasPixmap. +.PP +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). +.PP +QCanvasPixmap can have a hotspot which is defined in terms of an (x, y) offset. When you create a 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. +.PP +Note that for QCanvasPixmap objects created by a QCanvasSprite, the position of each QCanvasPixmap object is set so that the hotspot stays in the same position. +.PP +See also QCanvasPixmapArray, QCanvasItem, QCanvasSprite, Graphics Classes, and Image Processing Classes. +.SH MEMBER FUNCTION DOCUMENTATION +.SH "QCanvasPixmap::QCanvasPixmap ( const QString & datafilename )" +Constructs a QCanvasPixmap that uses the image stored in \fIdatafilename\fR. +.SH "QCanvasPixmap::QCanvasPixmap ( const QImage & image )" +Constructs a QCanvasPixmap from the image \fIimage\fR. +.SH "QCanvasPixmap::QCanvasPixmap ( const QPixmap & pm, const QPoint & offset )" +Constructs a QCanvasPixmap from the pixmap \fIpm\fR using the offset \fIoffset\fR. +.SH "QCanvasPixmap::~QCanvasPixmap ()" +Destroys the pixmap. +.SH "int QCanvasPixmap::offsetX () const" +Returns the x-offset of the pixmap's hotspot. +.PP +See also setOffset(). +.SH "int QCanvasPixmap::offsetY () const" +Returns the y-offset of the pixmap's hotspot. +.PP +See also setOffset(). +.SH "void QCanvasPixmap::setOffset ( int x, int y )" +Sets the offset of the pixmap's hotspot to (\fIx\fR, \fIy\fR). +.PP +\fBWarning:\fR Do not call this function if any QCanvasSprites are +currently showing this pixmap. + +.SH "SEE ALSO" +.BR http://doc.trolltech.com/qcanvaspixmap.html +.BR http://www.trolltech.com/faq/tech.html +.SH COPYRIGHT +Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the +license file included in the distribution for a complete license +statement. +.SH AUTHOR +Generated automatically from the source code. +.SH BUGS +If you find a bug in Qt, please report it as described in +.BR http://doc.trolltech.com/bughowto.html . +Good bug reports help us to help you. Thank you. +.P +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. +.P +If you find errors in this manual page, please report them to +.BR qt-bugs@trolltech.com . +Please include the name of the manual page (qcanvaspixmap.3qt) and the Qt +version (3.3.8). |