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

【Qt控件之QMovie】详解

news 2025/11/8 21:05:25

Qt控件之QMovies

- - 概述
  - 公共类型
  - 属性
  - 公共函数
  - 公共槽函数
  - 信号
  - 静态公共成员
  - 示例
  - 使用场景

概述

QMovie类是一个方便的类，用于播放具有QImageReader的动画。此类用于显示没有声音的简单动画。如果您想显示视频和媒体内容，请改用Qt多媒体框架Qt Multimedia multimedia framework。
首先，通过将文件的名称或包含动画图像格式的QIODevice的指针传递给QMovie的构造函数，创建一个QMovie对象。您可以在开始播放动画之前调用isValid()函数来检查图像数据是否有效。要开始播放动画，请调用start()函数。QMovie将进入Running状态，并发出started()和stateChanged()信号。要获取动画的当前状态，请调用state()函数。
要在应用程序中显示动画，您可以将QMovie对象传递给QLabel::setMovie()函数。示例如下：

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

每当动画中有新帧可用时，QMovie将发出updated()信号。如果帧的大小发生更改，则发出resized()信号。您可以调用currentImage()或currentPixmap()函数来获取当前帧的副本。当动画完成时，QMovie发出finished()信号。如果在播放过程中发生任何错误（即，图像文件损坏），QMovie将发出error()信号。
调用setSpeed()函数可以控制动画的播放速度，该函数将原始速度的百分比作为参数。通过调用setPaused(true)函数可以暂停动画。然后，QMovie将进入Paused状态，并发出stateChanged()信号。如果调用setPaused(false)函数，则QMovie将重新进入Running状态并重新开始动画。要停止动画，请调用stop()函数。
某些动画格式允许您设置背景颜色。您可以调用setBackgroundColor()函数来设置颜色，或者调用backgroundColor()函数来获取当前的背景颜色。
currentFrameNumber()函数返回当前帧的序列号。动画中的第一帧序列号为0。如果图像格式支持，frameCount()函数返回动画中的总帧数。可以调用loopCount()函数获取动画在完成之前应循环播放的次数。nextFrameDelay()函数返回当前帧应该显示的毫秒数。
可以通过调用setCacheMode()函数，指示QMovie缓存动画的帧。
调用supportedFormats()函数可以获取QMovie支持的格式列表。

公共类型

enum CacheMode { CacheNone, CacheAll } // 缓存模式
enum MovieState { NotRunning, Paused, Running } // 动画状态

属性

cacheMode : CacheMode // 缓存模式
speed : int // 速度

公共函数

QMovie(QObject *parent = Q_NULLPTR) // 构造函数
QMovie(QIODevice *device, const QByteArray &format = QByteArray(), QObject *parent = Q_NULLPTR)
QMovie(const QString &fileName, const QByteArray &format = QByteArray(), QObject *parent = Q_NULLPTR)
~QMovie() // 析构函数
QColor backgroundColor() const // 获取背景颜色
CacheMode cacheMode() const // 获取缓存模式
int currentFrameNumber() const // 获取当前帧的序号
QImage currentImage() const // 获取当前帧的QImage对象
QPixmap currentPixmap() const // 获取当前帧的QPixmap对象
QIODevice *device() const // 获取当前设备
QString fileName() const // 获取文件名
QByteArray format() const // 获取格式
int frameCount() const // 获取动画的总帧数
QRect frameRect() const // 获取动画帧的矩形区域
bool isValid() const // 检查动画数据是否有效
bool jumpToFrame(int frameNumber) // 跳转到指定帧
int loopCount() const // 获取动画应循环播放的次数
int nextFrameDelay() const // 获取下一帧的延迟时间
QSize scaledSize() // 获取缩放尺寸
void setBackgroundColor(const QColor &color) // 设置背景颜色
void setCacheMode(CacheMode mode) // 设置缓存模式
void setDevice(QIODevice *device) // 设置设备
void setFileName(const QString &fileName) // 设置文件名
void setFormat(const QByteArray &format) // 设置格式
void setScaledSize(const QSize &size) // 设置缩放尺寸
int speed() const // 获取速度
MovieState state() const // 获取动画状态

公共槽函数

bool jumpToNextFrame() // 跳转到下一帧
void setPaused(bool paused) // 设置暂停状态
void setSpeed(int percentSpeed) // 设置速度
void start() // 开始播放动画
void stop() // 停止动画

信号

void error(QImageReader::ImageReaderError error) // 错误信号
void finished() // 动画完成信号
void frameChanged(int frameNumber) // 帧变化信号
void resized(const QSize &size) // 重新调整大小信号
void started() // 动画开始信号
void stateChanged(QMovie::MovieState state) // 状态变化信号
void updated(const QRect &rect) // 更新信号

静态公共成员

QList supportedFormats() // 支持的格式列表

示例

先上UI：
在这里插入图片描述
实现步骤在代码中有注释。
MoviePlayer.h

#ifndef MOVIEPLAYER_H
#define MOVIEPLAYER_H#include <QWidget>QT_BEGIN_NAMESPACE
class QCheckBox;
class QGridLayout;
class QHBoxLayout;
class QLabel;
class QMovie;
class QSlider;
class QSpinBox;
class QToolButton;
class QVBoxLayout;
QT_END_NAMESPACEclass MoviePlayer : public QWidget
{Q_OBJECTpublic:MoviePlayer(QWidget *parent = 0);// 打开文件void openFile(const QString &fileName);private slots:// 打开槽函数void open();// 跳转到某帧void goToFrame(int frame);// 适应窗口void fitToWindow();// 更新按钮状态void updateButtons();// 更新帧滑动条void updateFrameSlider();// 当微调框数据改变时，触发此槽void slot_valueChanged(int nPercentSpeed);private:// 创建控件void createControls();// 创建按钮:开始、暂停、停止void createButtons();// 目录QString currentMovieDirectory;QLabel *movieLabel;	// 防止QMoive的控件QMovie *movie;	// QMoive对象QToolButton *openButton;QToolButton *playButton;QToolButton *pauseButton;QToolButton *stopButton;QToolButton *quitButton;QCheckBox *fitCheckBox;QSlider *frameSlider;QSpinBox *speedSpinBox;QLabel *frameLabel;QLabel *speedLabel;QGridLayout *controlsLayout;QHBoxLayout *buttonsLayout;QVBoxLayout *mainLayout;
};#endif

MoviePlayer.cpp

#include <QtWidgets>#include "movieplayer.h"MoviePlayer::MoviePlayer(QWidget *parent): QWidget(parent)
{movie = new QMovie(this);movie->setCacheMode(QMovie::CacheAll);movieLabel = new QLabel(tr("No movie loaded"));movieLabel->setAlignment(Qt::AlignCenter);movieLabel->setSizePolicy(QSizePolicy::Ignored, QSizePolicy::Ignored);movieLabel->setBackgroundRole(QPalette::Dark);movieLabel->setAutoFillBackground(true);currentMovieDirectory = "movies";createControls();createButtons();connect(movie, SIGNAL(frameChanged(int)), this, SLOT(updateFrameSlider()));connect(movie, SIGNAL(stateChanged(QMovie::MovieState)),this, SLOT(updateButtons()));connect(fitCheckBox, SIGNAL(clicked()), this, SLOT(fitToWindow()));connect(frameSlider, SIGNAL(valueChanged(int)), this, SLOT(goToFrame(int)));connect(speedSpinBox, SIGNAL(valueChanged(int)),this, SLOT(slot_valueChanged(int)));//            movie, SLOT(setSpeed(int)));mainLayout = new QVBoxLayout;mainLayout->addWidget(movieLabel);mainLayout->addLayout(controlsLayout);mainLayout->addLayout(buttonsLayout);setLayout(mainLayout);updateFrameSlider();updateButtons();setWindowTitle(tr("Movie Player"));resize(400, 400);
}void MoviePlayer::open()
{QString fileName = QFileDialog::getOpenFileName(this, tr("Open a Movie"),currentMovieDirectory);if (!fileName.isEmpty())openFile(fileName);
}void MoviePlayer::openFile(const QString &fileName)
{currentMovieDirectory = QFileInfo(fileName).path();movie->stop();movieLabel->setMovie(movie);movie->setFileName(fileName);movie->start();updateFrameSlider();updateButtons();
}void MoviePlayer::goToFrame(int frame)
{movie->jumpToFrame(frame);
}void MoviePlayer::fitToWindow()
{movieLabel->setScaledContents(fitCheckBox->isChecked());
}void MoviePlayer::updateFrameSlider()
{bool hasFrames = (movie->currentFrameNumber() >= 0);if (hasFrames) {if (movie->frameCount() > 0) {frameSlider->setMaximum(movie->frameCount() - 1);} else {if (movie->currentFrameNumber() > frameSlider->maximum())frameSlider->setMaximum(movie->currentFrameNumber());}frameSlider->setValue(movie->currentFrameNumber());} else {frameSlider->setMaximum(0);}frameLabel->setEnabled(hasFrames);frameSlider->setEnabled(hasFrames);
}void MoviePlayer::slot_valueChanged(int nPercentSpeed)
{qDebug().noquote() << "[" << __FILE__ << __LINE__ << "]" << "nPercentSpeed :" << nPercentSpeed;movie->setSpeed(nPercentSpeed);
}void MoviePlayer::updateButtons()
{playButton->setEnabled(movie->isValid() && movie->frameCount() != 1&& movie->state() == QMovie::NotRunning);pauseButton->setEnabled(movie->state() != QMovie::NotRunning);pauseButton->setChecked(movie->state() == QMovie::Paused);stopButton->setEnabled(movie->state() != QMovie::NotRunning);
}void MoviePlayer::createControls()
{fitCheckBox = new QCheckBox(tr("Fit to Window"));frameLabel = new QLabel(tr("Current frame:"));frameSlider = new QSlider(Qt::Horizontal);frameSlider->setTickPosition(QSlider::TicksBelow);frameSlider->setTickInterval(10);speedLabel = new QLabel(tr("Speed:"));speedSpinBox = new QSpinBox;speedSpinBox->setRange(1, 9999);speedSpinBox->setValue(100);speedSpinBox->setSuffix(tr("%"));controlsLayout = new QGridLayout;controlsLayout->addWidget(fitCheckBox, 0, 0, 1, 2);controlsLayout->addWidget(frameLabel, 1, 0);controlsLayout->addWidget(frameSlider, 1, 1, 1, 2);controlsLayout->addWidget(speedLabel, 2, 0);controlsLayout->addWidget(speedSpinBox, 2, 1);
}void MoviePlayer::createButtons()
{QSize iconSize(36, 36);openButton = new QToolButton;openButton->setIcon(style()->standardIcon(QStyle::SP_DialogOpenButton));openButton->setIconSize(iconSize);openButton->setToolTip(tr("Open File"));connect(openButton, SIGNAL(clicked()), this, SLOT(open()));playButton = new QToolButton;playButton->setIcon(style()->standardIcon(QStyle::SP_MediaPlay));playButton->setIconSize(iconSize);playButton->setToolTip(tr("Play"));connect(playButton, SIGNAL(clicked()), movie, SLOT(start()));pauseButton = new QToolButton;pauseButton->setCheckable(true);pauseButton->setIcon(style()->standardIcon(QStyle::SP_MediaPause));pauseButton->setIconSize(iconSize);pauseButton->setToolTip(tr("Pause"));connect(pauseButton, SIGNAL(clicked(bool)), movie, SLOT(setPaused(bool)));stopButton = new QToolButton;stopButton->setIcon(style()->standardIcon(QStyle::SP_MediaStop));stopButton->setIconSize(iconSize);stopButton->setToolTip(tr("Stop"));connect(stopButton, SIGNAL(clicked()), movie, SLOT(stop()));quitButton = new QToolButton;quitButton->setIcon(style()->standardIcon(QStyle::SP_DialogCloseButton));quitButton->setIconSize(iconSize);quitButton->setToolTip(tr("Quit"));connect(quitButton, SIGNAL(clicked()), this, SLOT(close()));buttonsLayout = new QHBoxLayout;buttonsLayout->addStretch();buttonsLayout->addWidget(openButton);buttonsLayout->addWidget(playButton);buttonsLayout->addWidget(pauseButton);buttonsLayout->addWidget(stopButton);buttonsLayout->addWidget(quitButton);buttonsLayout->addStretch();
}

调用

#include <QApplication>#include "movieplayer.h"int main(int argc, char *argv[])
{QApplication app(argc, argv);MoviePlayer player;player.show();player.show();return app.exec();
}

使用场景

在刷新页面时，可以使用QMovie来实现等待界面。
QMovie类也适用于在应用程序中显示电影。通过将QMovie对象传递给QLabel::setMovie()，可以将动画显示在QLabel控件中。

总之，QMovie类适用于需要播放简单动画或实现等待界面的各种场景。