QPicture(3qt)QPicture(3qt)NAMEQPicture - Paint device that records and replays
#include <qpicture.h>
Inherits QPaintDevice.
Public Members
QPicture ( int formatVersion = 0 )
~QPicture ()
bool isNull () const
uint size () const
const char* data () const
virtual void setData ( const char * data, uint size )
bool play ( QPainter * )
bool load ( const QString & fileName )
bool save ( const QString & fileName )
QPicture& operator= ( const QPicture & )
Protected Members
virtual bool cmd ( int, QPainter *, QPDevCmdParam * )
(internal)
virtual int metric ( int ) const
RELATED FUNCTION DOCUMENTATION
(Note that these are not member functions.)
QDataStream & operator>> (QDataStream & s, QPicture & r)
QDataStream & operator<< (QDataStream & s, const QPicture
& r)
DESCRIPTION
The QPicture class is a paint device that records and
replays QPainter commands.
A picture serializes painter commands to an IO device in a
platform-independent format. A picture created under
Windows can be read on a Sun SPARC.
Pictures are called meta-files on some platforms.
Qt pictures use a proprietary binary format. Unlike native
picture (meta-file) formats on many window systems, Qt
pictures have no limitations regarding the contents.
Everything that can be painted can also be stored in a
picture (fonts, pixmaps, regions, transformed graphics
etc.)
Example of how to record a picture:
QPicture pic;
QPainter p;
p.begin( &pic ); // paint in picture
p.drawEllipse( 10,20, 80,70 ); // draw an ellipse
Trolltech AS 13 June 2001 1
QPicture(3qt)QPicture(3qt)p.end(); // painting done
pic.save( "drawing.pic" ); // save picture
Example of how to replay a picture:
QPicture pic;
pic.load( "drawing.pic" ); // load picture
QPainter p;
p.begin( &myWidget ); // paint in myWidget
p.drawPicture( pic ); // draw the picture
p.end(); // painting done
Examples: xform/xform.cpp picture/picture.cpp
MEMBER FUNCTION DOCUMENTATIONQPicture::QPicture ( int formatVer = 0 )
Constructs an empty picture.
The formatVersion parameter may be used to create a
QPicture that can be read by applications that are
compiled with earlier versions of Qt. Currently supported
is formatVersion == 1, which will make a QPicture which is
stored in a format that is binary compatible with Qt 1.x
programs, and formatVersion == 2, for a format compatible
with Qt 2.0.x programs.
Reading of pictures generated by earlier versions of Qt is
supported and needs no special coding; the format is
automatically detected.
QPicture::~QPicture ()
Destructs the picture.
const char* QPicture::data () const
Returns a pointer to the picture data. The returned
pointer is null if the picture contains no data.
See also size() and isNull().
bool QPicture::isNull () const
Returns TRUE if the picture contains no data, otherwise
FALSE.
bool QPicture::load ( const QString & fileName )
Loads a picture from the file specified by fileName and
returns TRUE if successful, otherwise FALSE.
See also save().
Examples: xform/xform.cpp picture/picture.cpp
int QPicture::metric ( int m ) const [virtual protected]
Internal implementation of the virtual
QPaintDevice::metric() function.
Trolltech AS 13 June 2001 2
QPicture(3qt)QPicture(3qt)
Use the QPaintDeviceMetrics class instead.
A picture has the following hard coded values: width=640,
height=480, dpi = 72, numcolors=16777216 and depth=24.
Reimplemented from QPaintDevice.
QPicture& QPicture::operator= ( const QPicture & p )
Makes this picture be a deep copy of p.
bool QPicture::play ( QPainter * painter )
Replays the picture using painter and returns TRUE if
successful, or FALSE if the internal picture data is
inconsistent.
This function does exactly the same as
QPainter::drawPicture().
bool QPicture::save ( const QString & fileName )
Saves a picture to the file specified by fileName and
returns TRUE if successful, otherwise FALSE.
See also load().
Examples: picture/picture.cpp
void QPicture::setData ( const char * data, uint size ) [virtual]
Sets the picture data directly from data and size. This
function copies the input data.
See also data() and size().
uint QPicture::size () const
Returns the size of the picture data.
See also data().
bool QPicture::cmd ( int c, QPainter *, QPDevCmdParam * p )
[virtual protected]
For internal use only.
Reimplemented from QPaintDevice.
RELATED FUNCTION DOCUMENTATIONQDataStream & operator>> (QDataStream & s, QPicture & r)
Reads a QPicture from the stream and returns a reference
to the stream.
QDataStream & operator<;< (QDataStream & s, const QPicture & r)
Writes a QPicture to the stream and returns a reference to
the stream.
SEE ALSO
http://doc.trolltech.com/qpicture.html
Trolltech AS 13 June 2001 3
QPicture(3qt)QPicture(3qt)
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
make our job much simpler. Thank you.
In case of content or formattting problems with this
manual page, please report them to qt-bugs@trolltech.com.
Please include the name of the manual page (qpicture.3qt)
and the Qt version (2.3.1).
Trolltech AS 13 June 2001 4
