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


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

It was generated from the following files:


Generated at 04:27, 1995/05/20 by the webmaster at Troll Tech