Qtopia Home - Classes - Hierachy - Annotated - Functions - Licenses - Reference

QPicture Class Reference

The QPicture class is a paint device that records and replays QPainter commands. More...

#include <qpicture.h>

Inherits QPaintDevice.

List of all member functions.

Public Members

• QPicture ( int formatVer = 0 )
• ~QPicture ()
• bool isNull () const
• uint size () const
• const char * data () const
• virtual void setData ( const char * data, uint size )
• bool play ( QPainter * painter )
• bool load ( const QString & fileName )
• bool save ( const QString & fileName )
• QPicture & operator= ( const QPicture & p )

Protected Members

• virtual int metric ( int m ) const

Related Functions

• QDataStream & operator<< ( QDataStream & s, const QPicture & r )
• QDataStream & operator>> ( QDataStream & s, QPicture & r )

Detailed Description

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
    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
  

See also

Member Function Documentation

QPicture::QPicture ( int formatVer = 0 )

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 ()

const char * QPicture::data () const

See also size() and isNull().

bool QPicture::isNull () const

bool QPicture::load ( const QString & fileName )

See also save().

int QPicture::metric ( int m ) const [virtual protected]

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 )

bool QPicture::play ( QPainter * painter )

This function does exactly the same as QPainter::drawPicture().

bool QPicture::save ( const QString & fileName )

See also load().

void QPicture::setData ( const char * data, uint size ) [virtual]

See also data() and size().

uint QPicture::size () const

See also data().

Related Functions

QDataStream & operator<< ( QDataStream & s, const QPicture & r )

Writes a QPicture to the stream and returns a reference to the stream.

QDataStream & operator>> ( QDataStream & s, QPicture & r )

Reads a QPicture from the stream and returns a reference to the stream.

This file is part of the Qtopia platform, copyright © 1995-2005 Trolltech, all rights reserved.