QImageConsumer(3qt)

NAME
QImageConsumer - An abstraction used by

#include <qasyncimageio.h>

  Public Members
virtual void end ()
virtual void changed ( const QRect & )
virtual void frameDone ()
virtual void frameDone ( const QPoint &, const QRect & )
virtual void setLooping ( int )
virtual void setFramePeriod ( int )
virtual void setSize ( int, int )

DESCRIPTION
An abstraction used by QImageDecoder.

A QImageConsumer consumes information about changes to the QImage maintained by a QImageDecoder. It represents the a view of the image which the decoder produces.

See also QImageDecoder.

MEMBER FUNCTION DOCUMENTATION

void QImageConsumer::changed ( const QRect & ) [virtual]
Called when the given area of the image has changed.

void QImageConsumer::end () [virtual]
Called when all data of all frames has been decoded and revealed as changed().

void QImageConsumer::frameDone () [virtual]
One of the two frameDone() functions will be called when a frame of an animated image has ended and been revealed as changed().

When this function is called, the current image should be displayed.

The decoder will not make any further changes to the image until the next call to QImageFormat::decode().

void QImageConsumer::frameDone ( const QPoint & offset, const QRect & rect ) [virtual]
One of the two frameDone() functions will be called when a frame of an animated image has ended and been revealed as changed().

When this function is called, the area rect in the current image should be moved by offset and displayed.

The decoder will not make any further changes to the image until the next call to QImageFormat::decode().

void QImageConsumer::setFramePeriod ( int milliseconds ) [virtual]
Notes that the frame about to be decoded should not be displayed until the given number of milliseconds after the time that this function is called. Of course, the image may not have been decoded by then, in which case the frame should not be displayed until it is complete. A value of -1 (the assumed default) indicates that the image should be displayed even while it is only partially loaded.

void QImageConsumer::setLooping ( int n ) [virtual]
Called to indicate that the sequence of frames in the image should be repeated n times, including the sequence during decoding.

0 = Forever

1 = Only display frames the first time through

2 = Repeat once after first pass through images

etc.

To make the QImageDecoder do this just delete it and pass the information to it again for decoding (setLooping() will be called again of course, but that can be ignored), or keep copies of the changed areas at the ends of frames.

void QImageConsumer::setSize ( int, int ) [virtual]
This function is called as soon as the size of the image has been determined.

SEE ALSO
http://doc.trolltech.com/qimageconsumer.html 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 (qimageconsumer.3) and the Qt version (2.3.0).