qt QAnimationDriver详解

news2025/2/12 9:04:43

1、概述

QAnimationDriver是Qt框架中提供的一个类，它主要用于自定义动画帧的时间控制和更新。通过继承和实现QAnimationDriver，开发者可以精确控制动画的时间步长和更新逻辑，从而实现丰富和灵活的动画效果。QAnimationDriver与QAbstractAnimation和QAnimationGroup等类结合使用，可以构建更复杂和高效的动画系统，为用户提供流畅而美观的动画交互体验。

2、重要方法

QAnimationDriver类提供了一些关键方法，用于动画的时间控制和更新。以下是一些重要的方法：

advance()：推进动画到下一帧。这个方法通常由动画系统调用，以根据当前的时间步长更新动画状态。
start()：启动动画驱动。这个方法用于开始动画的播放。
stop()：停止动画驱动。这个方法用于停止动画的播放。
update()：更新动画状态。这个方法通常用于在动画播放过程中，根据时间的变化更新动画的当前帧或状态。

此外，QAnimationDriver还可能提供一些用于设置动画属性、获取动画状态等的方法，具体取决于其实现和用途。

3、重要信号

QAnimationDriver类本身可能不直接定义信号，但它作为动画系统的一部分，通常会与QAbstractAnimation等类协作，这些类会发出信号来表示动画的状态变化。例如，QAbstractAnimation类定义了以下信号：

stateChanged()：当动画的状态（如停止、运行、暂停）发生变化时发出。
finished()：当动画播放完成时发出。
loopCountChanged()：当动画的循环次数发生变化时发出。

虽然这些信号不是QAnimationDriver直接定义的，但它们在动画系统中起着重要的作用，开发者可以通过连接这些信号来响应动画的状态变化。

4、常用枚举类型

QAnimationDriver类本身可能不直接定义枚举类型，但它可能会使用Qt框架中定义的一些枚举类型来表示动画的属性或状态。例如，QAbstractAnimation类定义了一些枚举类型来描述动画的状态和属性：

State：表示动画的状态，如Stopped（停止）、Running（运行）和Paused（暂停）。
DeletionPolicy：表示动画结束时对象的删除策略，如DeleteWhenStopped（停止时删除）和KeepWhenStopped（停止时保留）。

这些枚举类型在动画系统的设计和实现中起着重要的作用。

#include <QApplication>
#include <QWidget>
#include <QPainter>
#include <QAnimationDriver>
#include <QDebug>

class CustomAnimationDriver : public QAnimationDriver
{
public:
    CustomAnimationDriver() {
        m_elapsed = 0;
        m_timer.start();
    }

protected:
    void advance() override {
        // 更新经过的时间
        m_elapsed = m_timer.elapsed();
        // 通知动画系统时间已更新
        emit started();  // 使用信号替代notifyDriverChanged
    }

    qint64 elapsed() const override {
        return m_elapsed;
    }

private:
    qint64 m_elapsed;
    QTime m_timer;
};

class AnimatedWidget : public QWidget
{
public:
    AnimatedWidget(QWidget *parent = nullptr) : QWidget(parent), angle(0) {
        startTimer(16); // 16ms timer for smooth animation
    }

protected:
    void paintEvent(QPaintEvent *) override {
        QPainter painter(this);
        painter.setRenderHint(QPainter::Antialiasing);

        // 将坐标原点移到窗口中心
        painter.translate(width() / 2, height() / 2);
        painter.rotate(angle);

        // 绘制一个旋转的矩形
        painter.fillRect(-50, -25, 100, 50, Qt::blue);
    }

    void timerEvent(QTimerEvent *) override {
        angle = (angle + 2) % 360;  // 每次增加2度
        update();
    }

private:
    int angle;
};


int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    
    // 创建并设置自定义动画驱动
    CustomAnimationDriver *driver = new CustomAnimationDriver;
    driver->install();
    
    // 创建并显示动画窗口
    AnimatedWidget widget;
    widget.resize(300, 300);
    widget.show();
    
    int result = app.exec();
    return result;
}