一、概述

QMovie类是一个使用QImageReader播放 动画 的方便类。这个类用于显示没有声音的简单动画，一般即是 gif 动画。如果要显示视频和媒体内容，请使用Qt Multimedia多媒体框架。

二、使用

1. 使用

首先，通过向QMovie的构造函数传递文件名称或指向包含动画图像格式的QIODevice的指针来创建QMovie对象。我们可以在开始播放 Movie 之前调用isValid()来检查图像数据是否有效。

要开始播放 Movie ，请调用start()。QMovie将进入Running状态，并发出started()和stateChanged()。要获取 Movie 的当前状态，请调用state()。

要在应用程序中显示 Movie ，可以将QMovie对象传递给QLabel::setMovie()。例子:

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

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

2. 信号发出时机

每当 Movie 中有新帧可用时，QMovie将发出 updated()。如果帧的大小发生变化，则触发 resized()。你可以调用currentImage()或currentPixmap()来获取当前帧的副本。当 Movie 完成时，QMovie发出finished()。如果在播放过程中出现任何错误(即，图像文件损坏)，QMovie将发出error()。

我们可以通过调用setSpeed()来控制 Movie 播放的速度，该方法将原始速度的百分比作为参数。

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

通过调用setPaused(true)暂停 Movie 。QMovie将进入暂停状态并触发statechange()。如果调用setPaused(false)， QMovie将重新进入Running状态并重新开始 Movie 。要停止 Movie ，调用stop()。

某些动画格式允许我们设置背景颜色。我们可以调用setBackgroundColor()来设置颜色，或者调用backgroundColor()来检索当前的背景颜色。

currentFrameNumber()返回当前帧的序列号。动画中的第一帧的序列号为0。frameCount()返回动画中的帧总数，如果图像格式支持的话。我们可以调用loopCount()来获得 Movie 在结束之前应该循环的次数。nextFrameDelay()返回当前帧应该显示的毫秒数。

QMovie可以通过调用 setCacheMode() 来指示缓存动画的帧。

三、控制的相关槽函数

就是一些开始、暂停、结束、跳过帧的函数

• jumpToNextFrame()
• setPaused(bool paused)
• setSpeed(int percentSpeed)
• start()
• stop()

四、信号

• error(QImageReader::ImageReaderError error)
• finished()
• frameChanged(int frameNumber)
• resized(const QSize &size)
• started()
• stateChanged(QMovie::MovieState state)
• updated(const QRect &rect)