QPicture Class Reference


The QPicture class is a paint device that records and replays QPainter commands. (details) (complete member list)

#include <qpicture.h>

Inherits QPaintDevice.

Public Members


Detailed 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 OS/2 Presentation Manager can easily 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

  QWidget   w;
  QPainter  p;  
  p.begin( &w );                        // paint in widget
  p.drawPicture( pic );                 // draw the picture
  p.end();                              // painting done

Member Function Documentation

QPicture::QPicture ()

Constructs an empty picture.

QPicture::~QPicture ()

Destroys the picture.

bool QPicture::cmd (int c, QPDevCmdParam *p)

Internal function that records painter commands.

bool QPicture::load (const char *fileName)

Loads a picture from the file specified by fileName and returns TRUE if successful.

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 char *fileName)

Saves a picture to the file specified by fileName and returns TRUE if successful.


This file is part of the Qt toolkit, copyright 1995 Troll Tech, all rights reserved.

It was generated from the following files:


Generated at 16:17, 1995/06/30 by the webmaster at Troll Tech