QMoive 理论总结
- 一、概述
- 二、使用
-
- [1. 使用](#1. 使用)
- [2. 信号发出时机](#2. 信号发出时机)
- 三、控制的相关槽函数
- 四、信号
一、概述
QMovie类是一个使用QImageReader播放 动画 的方便类。这个类用于显示没有声音的简单动画,一般即是 gif 动画。如果要显示视频和媒体内容,请使用Qt Multimedia多媒体框架。
二、使用
1. 使用
首先,通过向QMovie的构造函数传递文件名称或指向包含动画图像格式的QIODevice的指针来创建QMovie对象。我们可以在开始播放 Movie 之前调用isValid()来检查图像数据是否有效。
要开始播放 Movie ,请调用start()。QMovie将进入Running状态,并发出started()和stateChanged()。要获取 Movie 的当前状态,请调用state()。
要在应用程序中显示 Movie ,可以将QMovie对象传递给QLabel::setMovie()。例子:
cpp
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 播放的速度,该方法将原始速度的百分比作为参数。
cpp
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)