Qt中播放GIF动画

news2024/11/30 6:52:41

在Qt应用程序中，如果你想在QLabel控件上播放GIF动画，可以使用QMovie类与QLabel配合来实现。以下是详细步骤和代码示例：

步骤1：引入必要的头文件

首先，在你的源代码文件中包含QMovie和QLabel相关的头文件：

#include <QLabel>
#include <QMovie>

步骤2：创建QLabel和QMovie对象

在你的类中创建一个QLabel实例和一个QMovie实例。QMovie负责加载和播放GIF动画，QLabel则用来显示动画的内容。

QLabel *gifLabel = new QLabel(this); // 假设' this '是指向包含QLabel的父窗口或布局
QMovie *movie = new QMovie(":/resources/loading.gif"); // 加载资源文件中的GIF动画

// 或者加载本地文件
// QMovie *movie = new QMovie("path_to_your_gif_file.gif");

if (!movie->isValid()) { // 检查GIF是否有效
    qDebug() << "Invalid GIF file!";
} else {
    gifLabel->setMovie(movie);
}

步骤3：设置QLabel属性和启动QMovie

如果GIF文件有效，将其关联到QLabel上，并开始播放动画。

gifLabel->setAlignment(Qt::AlignCenter); // 可以根据需要设置对齐方式
movie->start(); // 开始播放GIF动画

// 若需要自适应GIF大小
gifLabel->setScaledContents(true); // 自动缩放GIF内容以适应QLabel尺寸

示例完整代码片段：

代码缺少MainWindow.ui，随便新建一个即可。最简单的方法是根据QtCreator向导新建MainWindow项目，然后复制MainWindow.cpp文件即可。
demo.pro

QT       += core gui
QT += multimedia multimediawidgets

greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

CONFIG += c++11

# You can make your code fail to compile if it uses deprecated APIs.
# In order to do so, uncomment the following line.
#DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000    # disables all the APIs deprecated before Qt 6.0.0

SOURCES += \
    MainWindow.cpp \
    main.cpp

HEADERS += \
    MainWindow.h

FORMS += \
    MainWindow.ui

# Default rules for deployment.
qnx: target.path = /tmp/$${TARGET}/bin
else: unix:!android: target.path = /opt/$${TARGET}/bin
!isEmpty(target.path): INSTALLS += target

RESOURCES += \
    resources.qrc

MainWindow.h

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>

namespace Ui {
class MainWindow;
}

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    explicit MainWindow(QWidget *parent = nullptr);
    ~MainWindow();

private:
    Ui::MainWindow *ui;
};

#endif // MAINWINDOW_H

MainWindow.cpp

#include "MainWindow.h"
#include "ui_MainWindow.h"
#include <QLabel>
#include <QMovie>
#include <QVBoxLayout>
#include <QDebug>

MainWindow::MainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    // 创建布局
    QVBoxLayout *layout = new QVBoxLayout;
    setCentralWidget(new QWidget());
    centralWidget()->setLayout(layout);

    // 创建并初始化QMovie
    QMovie *movie = new QMovie(":/resources/loading.gif");
    if (!movie->isValid()) {
        qDebug() << "Failed to load GIF.";
    } else {
        // 创建并设置QLabel
        QLabel *gifLabel = new QLabel(this);
        gifLabel->setMovie(movie);
        gifLabel->setAlignment(Qt::AlignCenter);
        gifLabel->setScaledContents(true);

        // 开始播放GIF
        movie->start();

        // 将QLabel添加到布局中
        layout->addWidget(gifLabel);
    }
}

MainWindow::~MainWindow()
{
    delete ui;
}

Main.cpp

#include "MainWindow.h"
#include <QApplication>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    MainWindow mainWindow;
    mainWindow.show();

    return app.exec();
}