当前位置：首页 > news >正文

qt QMovie详解

news 2025/7/22 18:35:40

1、概述

QMovie 是 Qt 框架中用于处理动画文件的类。它支持多种动画格式，包括 GIF 和一些常见的视频格式（尽管对视频格式的支持依赖于底层平台）。QMovie 类主要用于在 QLabel 或 QGraphicsView 等控件中显示动画。通过加载动画文件，QMovie 可以控制动画的播放、暂停、停止以及获取当前帧图像等操作。

2、重要方法

QMovie(const QString &fileName, QObject parent = nullptr)：构造函数，通过文件名加载动画。
bool isValid() const：检查动画文件是否有效。
void start()：开始播放动画。
void stop()：停止播放动画。
void setPaused(bool paused)：暂停或恢复动画播放。
bool isPaused() const：检查动画是否处于暂停状态。
QImage currentFrame() const：获取当前帧的 QImage 对象。
int frameCount() const：获取动画的总帧数。
int nextFrameDelay() const：获取下一帧的延迟时间（毫秒）。
void setCacheMode(CacheMode mode)：设置动画帧的缓存模式，以优化性能。
void jumpToFrame(int frameNumber):跳转到指定帧。
void setSpeed(int percent):设置动画播放的速度，单位为百分比(默认100%)
void setLoopCount(int count):设置动画的循环播放次数。

3、常用信号

以下是QMovie类中一些常用的信号及其简要介绍：

void started():当动画开始播放时发出信号,
void finished():当动画播放完成时发出信号
void frameChanged(int frameNumber):当动画帧发生变化时发出信号
void stateChanged(QMovie::MovieState state):当动画状态发生变化时发出信号。
void error(QImageReader::ImageReaderError error):当动画播放发生错误时发出信号。

4、缓存模式

QMovie::CacheMode 枚举定义了动画的缓存模式:

QMovie::CacheNone:不缓存帧，实时解码。
QMovie::CacheAll:缓存所有帧。

5、动画状态

QMovie::Moviestate枚举定义了动画的状态：

QMovie::NotRunning：动画未在运行。
QMovie::Paused:动画暂停。
QMovie::Running:动画正在运行。

#include <QApplication>
#include <QLabel>
#include <QMovie>
#include <QVBoxLayout>
#include <QWidget>int main(int argc, char *argv[]) {QApplication app(argc, argv);// 创建一个主窗口QWidget window;window.setWindowTitle("QMovie Example");// 创建一个 QVBoxLayoutQVBoxLayout *layout = new QVBoxLayout;// 创建一个 QLabelQLabel *label = new QLabel;// 创建一个 QMovie 对象并加载 GIF 文件QMovie *movie = new QMovie(":/path/to/your/animation.gif");// 将 QMovie 对象设置给 QLabellabel->setMovie(movie);// 将 QLabel 添加到布局中layout->addWidget(label);// 将布局设置给窗口window.setLayout(layout);// 开始播放动画movie->start();// 显示窗口window.show();return app.exec();
}