QMoviePrivate Class Reference

Inheritance diagram for QMoviePrivate:

Public Functions
void	_q_loadNextFrame ()
void	_q_loadNextFrame (bool starting)
void	enterState (QMovie::MovieState newState)
int	frameCount () const
QFrameInfo	infoForFrame (int frameNumber)
	Returns the QFrameInfo for the given frameNumber. More...
bool	isDone ()
bool	isValid () const
bool	jumpToFrame (int frameNumber)
bool	jumpToNextFrame ()
bool	next ()
	Attempts to advance the animation to the next frame. More...
	QMoviePrivate (QMovie *qq)
void	reset ()
int	speedAdjustedDelay (int delay) const
	Given the original delay, this function returns the actual number of milliseconds to delay according to the current speed. More...
Public Functions inherited from QObjectPrivate
void	_q_reregisterTimers (void *pointer)
void	addConnection (int signal, Connection *c)
void	cleanConnectionLists ()
void	connectNotify (const char *signal)
void	deleteChildren ()
void	disconnectNotify (const char *signal)
bool	isSender (const QObject *receiver, const char *signal) const
bool	isSignalConnected (uint signalIdx) const
	Returns true if the signal with index signal_index from object sender is connected. More...
void	moveToThread_helper ()
	QObjectPrivate (int version=QObjectPrivateVersion)
QObjectList	receiverList (const char *signal) const
QObjectList	senderList () const
void	setParent_helper (QObject *)
void	setThreadData_helper (QThreadData *currentData, QThreadData *targetData)
int	signalIndex (const char *signalName) const
	Returns the signal index used in the internal connectionLists vector. More...
virtual	~QObjectPrivate ()
Public Functions inherited from QObjectData
virtual	~QObjectData ()=0

Public Variables
QString	absoluteFilePath
QMovie::CacheMode	cacheMode
int	currentFrameNumber
QPixmap	currentPixmap
QMap< int, QFrameInfo >	frameMap
QRect	frameRect
int	greatestFrameNumber
bool	haveReadAll
qint64	initialDevicePos
bool	isFirstIteration
QMovie::MovieState	movieState
int	nextDelay
int	nextFrameNumber
QTimer	nextImageTimer
int	playCounter
QImageReader *	reader
int	speed
Public Variables inherited from QObjectPrivate
union {
QObject *   currentChildBeingDeleted
QAbstractDeclarativeData *   declarativeData
};
quint32	connectedSignals [2]
QObjectConnectionListVector *	connectionLists
Sender *	currentSender
QList< QPointer< QObject > >	eventFilters
ExtraData *	extraData
QString	objectName
Connection *	senders
QAtomicPointer< QtSharedPointer::ExternalRefCountData >	sharedRefcount
QThreadData *	threadData
void *	unused
Public Variables inherited from QObjectData
uint	blockSig: 1
QObjectList	children
uint	hasGuards: 1
uint	inEventHandler: 1
uint	inThreadChangeEvent: 1
uint	isWidget: 1
QMetaObject *	metaObject
uint	ownObjectName: 1
QObject *	parent
uint	pendTimer: 1
int	postedEvents
QObject *	q_ptr
uint	receiveChildEvents: 1
uint	sendChildEvents: 1
uint	unused: 22
uint	wasDeleted: 1

Additional Inherited Members
Public Types inherited from QObjectPrivate
typedef void(*	StaticMetaCallFunction) (QObject *, QMetaObject::Call, int, void **)
Static Public Functions inherited from QObjectPrivate
static void	clearGuards (QObject *)
static QObjectPrivate *	get (QObject *o)
static void	resetCurrentSender (QObject *receiver, Sender *currentSender, Sender *previousSender)
static Sender *	setCurrentSender (QObject *receiver, Sender *sender)
static void	signalSignature (const QMetaMethod &signal, QVarLengthArray< char > *result)

Detailed Description

Definition at line 257 of file qmovie.cpp.

Constructors and Destructors

QMoviePrivate()

QMoviePrivate::QMoviePrivate

(

QMovie *

qq

)

Warning

This function is not part of the public interface.

Definition at line 304 of file qmovie.cpp.

    : reader(0), speed(100), movieState(QMovie::NotRunning),
      currentFrameNumber(-1), nextFrameNumber(0), greatestFrameNumber(-1),
      nextDelay(0), playCounter(-1),
      cacheMode(QMovie::CacheNone), haveReadAll(false), isFirstIteration(true)
{
    q_ptr = qq;
    nextImageTimer.setSingleShot(true);
}

Functions

_q_loadNextFrame() [1/2]

void QMoviePrivate::_q_loadNextFrame

(

)

Warning

This function is not part of the public interface.

Definition at line 523 of file qmovie.cpp.

Referenced by jumpToFrame().

{
    _q_loadNextFrame(false);
}

_q_loadNextFrame() [2/2]

void QMoviePrivate::_q_loadNextFrame

(

bool

starting

)

Definition at line 528 of file qmovie.cpp.

{
    Q_Q(QMovie);
    if (next()) {
        if (starting && movieState == QMovie::NotRunning) {
            enterState(QMovie::Running);
            emit q->started();
        }

        if (frameRect.size() != currentPixmap.rect().size()) {
            frameRect = currentPixmap.rect();
            emit q->resized(frameRect.size());
        }

        emit q->updated(frameRect);
        emit q->frameChanged(currentFrameNumber);

        if (movieState == QMovie::Running)
            nextImageTimer.start(nextDelay);
    } else {
        // Could not read another frame
        if (!isDone()) {
            emit q->error(reader->error());
        }

        // Graceful finish
        if (movieState != QMovie::Paused) {
            nextFrameNumber = 0;
            isFirstIteration = true;
            playCounter = -1;
            enterState(QMovie::NotRunning);
            emit q->finished();
        }
    }
}

enterState()

void QMoviePrivate::enterState ( QMovie::MovieState  newState )

inline

Definition at line 273 of file qmovie.cpp.

Referenced by _q_loadNextFrame().

                                                      {
        movieState = newState;
        emit q_func()->stateChanged(newState);
    }

frameCount()

int QMoviePrivate::frameCount

(

)

const

Warning

This function is not part of the public interface.

Definition at line 592 of file qmovie.cpp.

{
    int result;
    if ((result = reader->imageCount()) != 0)
        return result;
    if (haveReadAll)
        return greatestFrameNumber+1;
    return 0; // Don't know
}

infoForFrame()

QFrameInfo QMoviePrivate::infoForFrame

(

int

frameNumber

)

Returns the QFrameInfo for the given frameNumber.

Warning

This function is not part of the public interface.

If the frame number is invalid, an invalid QFrameInfo is returned.

If the end of the animation has been reached, a special end marker QFrameInfo is returned.

Definition at line 369 of file qmovie.cpp.

Referenced by next().

{
    if (frameNumber < 0)
        return QFrameInfo(); // Invalid

    if (haveReadAll && (frameNumber > greatestFrameNumber)) {
        if (frameNumber == greatestFrameNumber+1)
            return QFrameInfo::endMarker();
        return QFrameInfo(); // Invalid
    }

    if (cacheMode == QMovie::CacheNone) {
        if (frameNumber != currentFrameNumber+1) {
            // Non-sequential frame access
            if (!reader->jumpToImage(frameNumber)) {
                if (frameNumber == 0) {
                    // Special case: Attempt to "rewind" so we can loop
                    // ### This could be implemented as QImageReader::rewind()
                    if (reader->device()->isSequential())
                        return QFrameInfo(); // Invalid
                    QString fileName = reader->fileName();
                    QByteArray format = reader->format();
                    QIODevice *device = reader->device();
                    QColor bgColor = reader->backgroundColor();
                    QSize scaledSize = reader->scaledSize();
                    delete reader;
                    if (fileName.isEmpty())
                        reader = new QImageReader(device, format);
                    else
                        reader = new QImageReader(absoluteFilePath, format);
                    (void)reader->canRead(); // Provoke a device->open() call
                    reader->device()->seek(initialDevicePos);
                    reader->setBackgroundColor(bgColor);
                    reader->setScaledSize(scaledSize);
                } else {
                    return QFrameInfo(); // Invalid
                }
            }
        }
        if (reader->canRead()) {
            // reader says we can read. Attempt to actually read image
            QImage anImage = reader->read();
            if (anImage.isNull()) {
                // Reading image failed.
                return QFrameInfo(); // Invalid
            }
            if (frameNumber > greatestFrameNumber)
                greatestFrameNumber = frameNumber;
            QPixmap aPixmap = QPixmap::fromImage(anImage);
            int aDelay = reader->nextImageDelay();
            return QFrameInfo(aPixmap, aDelay);
        } else if (frameNumber != 0) {
            // We've read all frames now. Return an end marker
            haveReadAll = true;
            return QFrameInfo::endMarker();
        } else {
            // No readable frames
            haveReadAll = true;
            return QFrameInfo();
        }
    }

    // CacheMode == CacheAll
    if (frameNumber > greatestFrameNumber) {
        // Frame hasn't been read from file yet. Try to do it
        for (int i = greatestFrameNumber + 1; i <= frameNumber; ++i) {
            if (reader->canRead()) {
                // reader says we can read. Attempt to actually read image
                QImage anImage = reader->read();
                if (anImage.isNull()) {
                    // Reading image failed.
                    return QFrameInfo(); // Invalid
                }
                greatestFrameNumber = i;
                QPixmap aPixmap = QPixmap::fromImage(anImage);
                int aDelay = reader->nextImageDelay();
                QFrameInfo info(aPixmap, aDelay);
                // Cache it!
                frameMap.insert(i, info);
                if (i == frameNumber) {
                    return info;
                }
            } else {
                // We've read all frames now. Return an end marker
                haveReadAll = true;
                return QFrameInfo::endMarker();
            }
        }
    }
    // Return info for requested (cached) frame
    return frameMap.value(frameNumber);
}

isDone()

bool QMoviePrivate::isDone

(

)

Warning

This function is not part of the public interface.

Definition at line 333 of file qmovie.cpp.

Referenced by _q_loadNextFrame().

{
    return (playCounter == 0);
}

isValid()

bool QMoviePrivate::isValid

(

)

const

Warning

This function is not part of the public interface.

Definition at line 567 of file qmovie.cpp.

{
    return (greatestFrameNumber >= 0) // have we seen valid data
        || reader->canRead(); // or does the reader see valid data
}

jumpToFrame()

bool QMoviePrivate::jumpToFrame

(

int

frameNumber

)

Warning

This function is not part of the public interface.

Definition at line 576 of file qmovie.cpp.

Referenced by jumpToNextFrame().

{
    if (frameNumber < 0)
        return false;
    if (currentFrameNumber == frameNumber)
        return true;
    nextFrameNumber = frameNumber;
    if (movieState == QMovie::Running)
        nextImageTimer.stop();
    _q_loadNextFrame();
    return (nextFrameNumber == currentFrameNumber+1);
}

jumpToNextFrame()

bool QMoviePrivate::jumpToNextFrame

(

)

Warning

This function is not part of the public interface.

Definition at line 605 of file qmovie.cpp.

{
    return jumpToFrame(currentFrameNumber+1);
}

next()

bool QMoviePrivate::next

(

)

Attempts to advance the animation to the next frame.

Warning

This function is not part of the public interface.

If successful, currentFrameNumber, currentPixmap and nextDelay are updated accordingly, and true is returned. Otherwise, false is returned. When false is returned, isDone() can be called to determine whether the animation ended gracefully or an error occurred when reading the frame.

Definition at line 476 of file qmovie.cpp.

Referenced by _q_loadNextFrame().

{
    QTime time;
    time.start();
    QFrameInfo info = infoForFrame(nextFrameNumber);
    if (!info.isValid())
        return false;
    if (info.isEndMarker()) {
        // We reached the end of the animation.
        if (isFirstIteration) {
            if (nextFrameNumber == 0) {
                // No frames could be read at all (error).
                return false;
            }
            // End of first iteration. Initialize play counter
            playCounter = reader->loopCount();
            isFirstIteration = false;
        }
        // Loop as appropriate
        if (playCounter != 0) {
            if (playCounter != -1) // Infinite?
                playCounter--;     // Nope
            nextFrameNumber = 0;
            return next();
        }
        // Loop no more. Done
        return false;
    }
    // Image and delay OK, update internal state
    currentFrameNumber = nextFrameNumber++;
    QSize scaledSize = reader->scaledSize();
    if (scaledSize.isValid() && (scaledSize != info.pixmap.size()))
        currentPixmap = QPixmap::fromImage( info.pixmap.toImage().scaled(scaledSize) );
    else
        currentPixmap = info.pixmap;
    nextDelay = speedAdjustedDelay(info.delay);
    // Adjust delay according to the time it took to read the frame
    int processingTime = time.elapsed();
    if (processingTime > nextDelay)
        nextDelay = 0;
    else
        nextDelay = nextDelay - processingTime;
    return true;
}

reset()

void QMoviePrivate::reset

(

)

Warning

This function is not part of the public interface.

Definition at line 316 of file qmovie.cpp.

{
    nextImageTimer.stop();
    if (reader->device())
        initialDevicePos = reader->device()->pos();
    currentFrameNumber = -1;
    nextFrameNumber = 0;
    greatestFrameNumber = -1;
    nextDelay = 0;
    playCounter = -1;
    haveReadAll = false;
    isFirstIteration = true;
    frameMap.clear();
}

speedAdjustedDelay()

int QMoviePrivate::speedAdjustedDelay

(

int

delay

)

const

Given the original delay, this function returns the actual number of milliseconds to delay according to the current speed.

Warning

This function is not part of the public interface.

E.g. if the speed is 200%, the result will be half of the original delay.

Definition at line 349 of file qmovie.cpp.

Referenced by next().

{
    return int( (qint64(delay) * qint64(100) ) / qint64(speed) );
}

Properties

absoluteFilePath

QString QMoviePrivate::absoluteFilePath

Definition at line 297 of file qmovie.cpp.

Referenced by infoForFrame().

cacheMode

QMovie::CacheMode QMoviePrivate::cacheMode

Definition at line 293 of file qmovie.cpp.

Referenced by infoForFrame().

currentFrameNumber

int QMoviePrivate::currentFrameNumber

Definition at line 287 of file qmovie.cpp.

Referenced by _q_loadNextFrame(), infoForFrame(), jumpToFrame(), jumpToNextFrame(), next(), and reset().

currentPixmap

QPixmap QMoviePrivate::currentPixmap

Definition at line 286 of file qmovie.cpp.

Referenced by _q_loadNextFrame(), and next().

frameMap

QMap<int, QFrameInfo> QMoviePrivate::frameMap

Definition at line 296 of file qmovie.cpp.

Referenced by reset().

frameRect

QRect QMoviePrivate::frameRect

Definition at line 285 of file qmovie.cpp.

Referenced by _q_loadNextFrame().

greatestFrameNumber

int QMoviePrivate::greatestFrameNumber

Definition at line 289 of file qmovie.cpp.

Referenced by frameCount(), infoForFrame(), isValid(), and reset().

haveReadAll

bool QMoviePrivate::haveReadAll

Definition at line 294 of file qmovie.cpp.

Referenced by frameCount(), infoForFrame(), and reset().

initialDevicePos

qint64 QMoviePrivate::initialDevicePos

Definition at line 292 of file qmovie.cpp.

Referenced by reset().

isFirstIteration

bool QMoviePrivate::isFirstIteration

Definition at line 295 of file qmovie.cpp.

Referenced by _q_loadNextFrame(), next(), and reset().

movieState

QMovie::MovieState QMoviePrivate::movieState

Definition at line 284 of file qmovie.cpp.

Referenced by _q_loadNextFrame(), and jumpToFrame().

nextDelay

int QMoviePrivate::nextDelay

Definition at line 290 of file qmovie.cpp.

Referenced by _q_loadNextFrame(), next(), and reset().

nextFrameNumber

int QMoviePrivate::nextFrameNumber

Definition at line 288 of file qmovie.cpp.

Referenced by _q_loadNextFrame(), jumpToFrame(), next(), and reset().

nextImageTimer

QTimer QMoviePrivate::nextImageTimer

Definition at line 299 of file qmovie.cpp.

Referenced by _q_loadNextFrame(), jumpToFrame(), QMoviePrivate(), and reset().

playCounter

int QMoviePrivate::playCounter

Definition at line 291 of file qmovie.cpp.

Referenced by _q_loadNextFrame(), isDone(), next(), and reset().

reader

QImageReader* QMoviePrivate::reader

Definition at line 282 of file qmovie.cpp.

Referenced by _q_loadNextFrame(), frameCount(), infoForFrame(), isValid(), next(), and reset().

speed

int QMoviePrivate::speed

Definition at line 283 of file qmovie.cpp.

Referenced by speedAdjustedDelay().

---

The documentation for this class was generated from the following file:

• /src/gui/image/qmovie.cpp