The QPictureIO class contains parameters for loading and saving pictures. More...

Public Methods
	QPictureIO ()

	QPictureIO (const QString &fileName, const QString &format)

	QPictureIO (QIODevice *ioDevice, const QString &format)

	~QPictureIO ()

QString	description () const

QString	fileName () const

QString	format () const

float	gamma () const

QIODevice *	ioDevice () const

const char *	parameters () const

const QPicture &	picture () const

int	quality () const

bool	read ()

void	setDescription (const QString &description)

void	setFileName (const QString &fileName)

void	setFormat (const QString &format)

void	setGamma (float gamma)

void	setIODevice (QIODevice *ioDevice)

void	setParameters (const char *parameters)

void	setPicture (const QPicture &picture)

void	setQuality (int q)

void	setStatus (int status)

int	status () const

bool	write ()

Static Public Methods
static void	defineIOHandler (const QString &format, const QString &header, const char *flags, picture_io_handler readPicture, picture_io_handler writePicture)

static QStringList	inputFormats ()

static QStringList	outputFormats ()

static QString	pictureFormat (const QString &fileName)

static QString	pictureFormat (QIODevice *ioDevice)

Detailed Description

The QPictureIO class contains parameters for loading and saving pictures. QPictureIO contains a QIODevice object used for picture data I/O. New picture file formats can be added as a plugin, in addition to those which CopperSpice provides.

You do not normally need to use this class, use QPicture::load() and QPicture::save().

See also: QPicture, QPixmap, QFile

Constructor & Destructor Documentation

QPictureIO::QPictureIO ( )

Constructs a QPictureIO object with all parameters set to zero.

QPictureIO::QPictureIO	(	QIODevice *	ioDevice,
		const QString &	format
	)

Constructs a QPictureIO object with the I/O device ioDevice and a format tag.

QPictureIO::QPictureIO	(	const QString &	fileName,
		const QString &	format
	)

Constructs a QPictureIO object with the file name fileName and a format tag.

QPictureIO::~QPictureIO ( )

Destroys the object and all related data.

Method Documentation

void QPictureIO::defineIOHandler	(	const QString &	format,
		const QString &	header,
		const char *	flags,
		picture_io_handler	readPicture,
		picture_io_handler	writePicture
	)

static

Defines a picture I/O handler for the picture format called format, which is recognized using the regular expression defined in header, read using readPicture and written using writePicture.

Flags is a string of single-character flags for this format. The only flag defined currently is T (upper case), so the only legal value for flags are "T" and the empty string. The "T" flag means that the picture file is a text file, and CopperSpice should treat all newline conventions as equivalent. (XPM files and some PPM files are text files for example.)

The format is used to select a handler to write a QPicture. The header is used to select a handler to read a picture file.

If readPicture is a null pointer, the QPictureIO will not be able to read pictures in format. If writePicture is a null pointer, the QPictureIO will not be able to write pictures in format. If both are null, the QPictureIO object is valid but useless.

 void readSVG(QPictureIO *picture) {
     // read the picture using the picture->ioDevice()
 }
 
 void writeSVG(QPictureIO *picture) {
     // write the picture using the picture->ioDevice()
 }
 
// add the SVG picture handler

Before the regular expression test all the null bytes in the file header are converted to a value of 1. The regular expression is only applied on the first 14 bytes of the file.

If one handlerIO supports writing a format and another supports reading it, CopperSpice supports both reading and writing. If two handlers support the same operation, CopperSpice chooses one arbitrarily.

QString QPictureIO::description ( ) const

Returns the picture description string.

See also: setDescription()

QString QPictureIO::fileName ( ) const

Returns the file name currently set.

See also: setFileName()

QString QPictureIO::format ( ) const

Returns the picture format string or an empty string if no format has been explicitly set.

See also: setFormat()

float QPictureIO::gamma ( ) const

Returns the gamma value at which the picture will be viewed.

See also: setGamma()

QStringList QPictureIO::inputFormats ( )

static

Returns a sorted list of picture formats that are supported for picture input.

QIODevice * QPictureIO::ioDevice ( ) const

Returns the IO device currently set.

See also: setIODevice()

QStringList QPictureIO::outputFormats ( )

static

Returns a sorted list of picture formats that are supported for picture output.

const char * QPictureIO::parameters ( ) const

Returns the picture's parameters string.

See also: setParameters()

const QPicture & QPictureIO::picture ( ) const

Returns the picture currently set.

See also: setPicture()

QString QPictureIO::pictureFormat ( const QString & fileName )

static

Returns a string that specifies the picture format of the file fileName, or null if the file can not be read or if the format is not recognized.

QString QPictureIO::pictureFormat ( QIODevice * ioDevice )

static

Returns a string that specifies the picture format of the picture read from IO device ioDevice or an empty string if the device can not be read or if the format is not recognized.

Make sure the value for ioDevice is at the right position in the device, for example, at the beginning of the file.

See also: QIODevice::pos()

int QPictureIO::quality ( ) const

Returns the quality of the written picture, related to the compression ratio.

See also: setQuality(), QPicture::save()

bool QPictureIO::read ( )

Reads a picture into memory and returns true if the picture was successfully read, otherwise returns false. Before reading a picture you must set an IO device or a file name. If both an IO device and a file name have been set, the IO device will be used.

Setting the picture file format string is optional.

This method does not set the format used to read the picture. If you need this information, use the pictureFormat() static methods.

QPictureIO data;
 
QPixmap pixmap;
data.setFileName("veggieburger.pic");
 
if (data.read()) {
   QPicture picture = data.picture();
 
   QPainter painter(&pixmap);
   painter.drawPicture(0, 0, picture);
}

See also: setIODevice(), setFileName(), setFormat(), write(), QPixmap::load()

void QPictureIO::setDescription ( const QString & description )

Sets the picture description string for picture handlers that support picture descriptions to description. Currently, no picture format supported by CopperSpice uses the description string.

See also: description()

void QPictureIO::setFileName ( const QString & fileName )

Sets the name of the file to read or write a picture from to fileName.

See also: fileName(), setIODevice()

void QPictureIO::setFormat ( const QString & format )

Sets the picture format to format for the picture to be read or written.

It is necessary to specify a format before writing a picture, but it is not necessary to specify a format before reading a picture.

If no format has been set, CopperSpice guesses the picture format before reading it. If a format is set the picture will only be read if it has that format.

See also: read(), write(), format()

void QPictureIO::setGamma ( float gamma )

Sets the gamma value at which the picture will be viewed to gamma. If the picture format stores a gamma value for which the picture is intended to be used, then this setting will be used to modify the picture. Setting to 0.0 will disable gamma correction (i.e. any specification in the file will be ignored).

The default value is 0.0.

See also: gamma()

void QPictureIO::setIODevice ( QIODevice * ioDevice )

Sets the IO device to be used for reading or writing a picture to ioDevice. Setting the IO device allows pictures to be read/written to any block-oriented QIODevice.

If ioDevice is not a nullptr then this IO device will override file name settings.

See also: setFileName()

void QPictureIO::setParameters ( const char * parameters )

Sets the picture's parameter string to parameters. This is for picture handlers that require special parameters.

Although the current picture formats supported by CopperSpice ignore the parameters string, it may be used in future extensions or by contributions (for example, JPEG).

See also: parameters()

void QPictureIO::setPicture ( const QPicture & picture )

Sets the picture to picture.

See also: picture()

void QPictureIO::setQuality ( int q )

Sets the quality of the written picture to q, related to the compression ratio. The value for q must be in the range -1..100. Specify 0 to obtain small compressed files, 100 for large uncompressed files. (-1 signifies the default compression.)

See also: quality(), QPicture::save()

void QPictureIO::setStatus ( int status )

Sets the picture IO status to status. A non-zero value indicates an error, whereas 0 means that the IO operation was successful.

See also: status()

int QPictureIO::status ( ) const

Returns the picture's IO status. A non-zero value indicates an error, whereas 0 means that the IO operation was successful.

See also: setStatus()

bool QPictureIO::write ( )

Writes a picture to an IO device and returns true if the picture was successfully written, otherwise returns false. Before writing a picture you must set an IO device or a file name. If both an IO device and a file name have been set, the IO device will be used.

The picture will be written using the specified picture format.

QPictureIO data;
QPicture   picture;
 
QPainter painter(&picture);
painter.drawPixmap(0, 0, pixmap);
 
data.setPicture(picture);
data.setFileName("veggieburger.pic");
data.setFormat("PIC");
 
if (data.write()) {
   return true;                            // returns true if written successfully
}

See also: setIODevice(), setFileName(), setFormat(), read(), QPixmap::save()

Public Methods

Static Public Methods

Detailed Description

Constructor & Destructor Documentation

Method Documentation