QMovie Class

QLabel label;
QMovie *movie = new QMovie("animations/fire.gif");

label.setMovie(movie);
movie->start();

QMovie movie("racecar.gif");
movie.setSpeed(200); // 2x speed

Documentation des fonctions membres

[explicit] QMovie::QMovie(QObject *parent = nullptr)

Construit un objet QMovie, en passant l'objet parent au constructeur de QObject.

Voir aussi setFileName(), setDevice() et setFormat().

[explicit] QMovie::QMovie(QIODevice *device, const QByteArray &format = QByteArray(), QObject *parent = nullptr)

Construit un objet QMovie. QMovie utilisera les données d'image lues sur device, dont il suppose qu'elles sont ouvertes et lisibles. Si format n'est pas vide, QMovie utilisera le format d'image format pour décoder les données d'image. Sinon, QMovie tentera de deviner le format.

L'objet parent est transmis au constructeur de QObject.

[explicit] QMovie::QMovie(const QString &fileName, const QByteArray &format = QByteArray(), QObject *parent = nullptr)

Construit un objet QMovie. QMovie utilisera les données d'image lues sur fileName. Si format n'est pas vide, QMovie utilisera le format d'image format pour décoder les données d'image. Sinon, QMovie tentera de deviner le format.

L'objet parent est transmis au constructeur de QObject.

[virtual noexcept] QMovie::~QMovie()

Détruit l'objet QMovie.

QColor QMovie::backgroundColor() const

Renvoie la couleur d'arrière-plan du film. Si aucune couleur d'arrière-plan n'a été attribuée, une adresse QColor invalide est renvoyée.

Voir également setBackgroundColor().

int QMovie::currentFrameNumber() const

Renvoie le numéro de séquence de l'image en cours. Le numéro de la première image du film est 0.

QImage QMovie::currentImage() const

Renvoie le cadre actuel sous forme de QImage.

Voir aussi currentPixmap() et updated().

QPixmap QMovie::currentPixmap() const

Renvoie le cadre actuel sous forme de QPixmap.

Voir aussi currentImage() et updated().

QIODevice *QMovie::device() const

Renvoie le périphérique à partir duquel QMovie lit les données d'image. Si aucun périphérique n'a été attribué, nullptr est renvoyé.

Voir aussi setDevice() et fileName().

[signal] void QMovie::error(QImageReader::ImageReaderError error)

Ce signal est émis par QMovie lorsque l'erreur error s'est produite pendant la lecture. QMovie arrête le film et entre dans l'état QMovie::NotRunning.

Voir également lastError() et lastErrorString().

QString QMovie::fileName() const

Renvoie le nom du fichier à partir duquel QMovie lit les données d'image. Si aucun nom de fichier n'a été attribué, ou si le périphérique attribué n'est pas un fichier, un QString vide est renvoyé.

Voir aussi setFileName() et device().

[signal] void QMovie::finished()

Ce signal est émis lorsque le film est terminé.

Voir également QMovie::stop().

QByteArray QMovie::format() const

Renvoie le format utilisé par QMovie lors du décodage des données d'image. Si aucun format n'a été assigné, un QByteArray() vide est retourné.

Voir aussi setFormat().

[signal] void QMovie::frameChanged(int frameNumber)

Ce signal est émis lorsque le numéro de la trame est passé à frameNumber. Vous pouvez appeler currentImage() ou currentPixmap() pour obtenir une copie de la trame.

int QMovie::frameCount() const

Renvoie le nombre d'images dans le film.

Certains formats d'animation ne prennent pas en charge cette fonctionnalité, auquel cas 0 est renvoyé.

QRect QMovie::frameRect() const

Renvoie le rectangle de la dernière image. Si aucune image n'a encore été mise à jour, une adresse QRect invalide est renvoyée.

Voir aussi currentImage() et currentPixmap().

bool QMovie::isValid() const

Renvoie true si le film est valide (par exemple, les données de l'image sont lisibles et le format de l'image est pris en charge) ; sinon, renvoie false.

Pour savoir pourquoi le film n'est pas valide, voir lastError().

bool QMovie::jumpToFrame(int frameNumber)

Passe à l'image numérotée frameNumber. Renvoie true en cas de succès ; sinon, renvoie false.

[slot] bool QMovie::jumpToNextFrame()

Passe à l'image suivante. Renvoie true en cas de succès, sinon false.

QImageReader::ImageReaderError QMovie::lastError() const

Renvoie l'erreur la plus récente survenue lors de la tentative de lecture des données de l'image.

Voir aussi lastErrorString().

QString QMovie::lastErrorString() const

Renvoie une représentation lisible par l'homme de la dernière erreur survenue lors d'une tentative de lecture de données d'image.

Voir aussi lastError().

int QMovie::loopCount() const

Renvoie le nombre de fois que le film va tourner en boucle avant de se terminer. Si le film n'est joué qu'une seule fois (pas de boucle), loopCount renvoie 0. Si le film boucle indéfiniment, loopCount renvoie -1.

Notez que, si les données d'image proviennent d'un périphérique séquentiel (par exemple, une prise), QMovie ne peut boucler le film que si cacheMode est défini sur QMovie::CacheAll.

int QMovie::nextFrameDelay() const

Renvoie le nombre de millisecondes que QMovie attendra avant de mettre à jour l'image suivante de l'animation.

[signal] void QMovie::resized(const QSize &size)

Ce signal est émis lorsque le cadre actuel a été redimensionné à size. Cet effet est parfois utilisé dans les animations comme alternative au remplacement du cadre. Vous pouvez appeler currentImage() ou currentPixmap() pour obtenir une copie de l'image mise à jour.

QSize QMovie::scaledSize()

Renvoie la taille des images à l'échelle.

Voir aussi setScaledSize() et QImageReader::scaledSize().

void QMovie::setBackgroundColor(const QColor &color)

Pour les formats d'image qui le supportent, cette fonction définit la couleur d'arrière-plan à color.

Voir aussi backgroundColor().

void QMovie::setDevice(QIODevice *device)

Définit le périphérique actuel à device. QMovie lira les données d'image à partir de ce périphérique lorsque le film sera en cours d'exécution.

Voir aussi device() et setFormat().

void QMovie::setFileName(const QString &fileName)

Définit le nom du fichier à partir duquel QMovie lit les données d'image, à fileName.

Voir aussi fileName(), setDevice() et setFormat().

void QMovie::setFormat(const QByteArray &format)

Définit le format que QMovie utilisera lors du décodage des données d'image, à format. Par défaut, QMovie tentera de deviner le format des données d'image.

Vous pouvez appeler supportedFormats() pour obtenir la liste complète des formats pris en charge par QMovie.

Voir aussi format() et QImageReader::supportedImageFormats().

[slot] void QMovie::setPaused(bool paused)

Si paused est vrai, QMovie entrera dans l'état Paused et émettra stateChanged(Paused) ; sinon, il entrera dans l'état Running et émettra stateChanged(Running).

Voir aussi state().

void QMovie::setScaledSize(const QSize &size)

Définit la taille de l'image mise à l'échelle à size.

Voir également scaledSize() et QImageReader::setScaledSize().

[slot] void QMovie::start()

Lance le film. QMovie entrera dans l'état Running et commencera à émettre updated() et resized() au fur et à mesure que le film progresse.

Si QMovie est dans l'état Paused, cette fonction équivaut à appeler setPaused(false). Si QMovie est déjà dans l'état Running, cette fonction ne fait rien.

Voir également stop() et setPaused().

[signal] void QMovie::started()

Ce signal est émis après que QMovie::start() a été appelé et que QMovie est entré dans l'état QMovie::Running.

QMovie::MovieState QMovie::state() const

Renvoie l'état actuel de QMovie.

Voir aussi MovieState et stateChanged().

[signal] void QMovie::stateChanged(QMovie::MovieState state)

Ce signal est émis chaque fois que l'état du film change. Le nouvel état est spécifié par state.

Voir aussi QMovie::state().

[slot] void QMovie::stop()

Arrête le film. QMovie entre dans l'état NotRunning et arrête d'émettre updated() et resized(). Si start() est appelé à nouveau, le film reprendra depuis le début.

Si QMovie est déjà dans l'état NotRunning, cette fonction ne fait rien.

Voir aussi start() et setPaused().

[static] QList<QByteArray> QMovie::supportedFormats()

Renvoie la liste des formats d'image pris en charge par QMovie.

Voir aussi QImageReader::supportedImageFormats().

[signal] void QMovie::updated(const QRect &rect)

Ce signal est émis lorsque le rect rect dans le cadre actuel a été mis à jour. Vous pouvez appeler currentImage() ou currentPixmap() pour obtenir une copie du cadre mis à jour.