FrameAnimation QML Type

该属性用于保存自开始以来的帧更新次数。重新启动帧动画时，currentFrame 将从0 开始。

下面的示例展示了如何对帧更新做出反应。

FrameAnimation {
    running: true
    onTriggered: {
        // Run code on every frame update.
    }
}

该属性也可用于每隔 n 帧才渲染一次。考虑一种高级用法，即用户界面包含两个重型元素，为了达到流畅的 60fps 总帧率，您决定以 30fps 的帧率渲染这些重型元素，第一个元素每隔偶数帧渲染一次，第二个元素每隔奇数帧渲染一次：

FrameAnimation {
    running: true
    onTriggered: {
        if (currentFrame % 2 == 0)
            updateUIElement1();
        else
            updateUIElement2();
   }
}

默认情况下，frame 为 0。

该属性保存自上次启动以来的时间（以秒为单位）。

默认情况下，elapsedTime 为 0。

该属性保存自上一帧更新以来的时间（以秒为单位）。

下面的示例展示了如何使用 frameTime 以不同的速度为项目制作动画，并根据屏幕刷新率和可能出现的帧数下降进行调整。

Rectangle {
    id: rect
    property real speed: 90
    width: 100
    height: 100
    color: "red"
    anchors.centerIn: parent
}

FrameAnimation {
    id: frameAnimation
    running: true
    onTriggered: {
        // Rotate the item speed-degrees / second.
        rect.rotation += rect.speed * frameTime
    }
}

默认情况下，frameTime 为 0。

如果设置为 true，则暂停帧动画；否则恢复帧动画。

paused 默认为 false。

另请参阅 pause() 和resume()。

如果设置为 true，则启动帧动画；否则停止帧动画。

running 默认为 false。

另请参阅 stop()、start() 和restart()。

该属性保存自上一帧更新后的平滑时间（以秒为单位）。

下面的示例展示了如何使用 smoothFrameTime 显示平均帧频。

Text {
    text: "fps: " + frameAnimation.fps.toFixed(0)
}

FrameAnimation {
    id: frameAnimation
    property real fps: smoothFrameTime > 0 ? (1.0 / smoothFrameTime) : 0
    running: true
}

默认情况下，smoothFrameTime 为 0。

当FrameAnimation 跳转到新帧时会发出该信号。

暂停帧动画

如果帧动画已暂停或未running ，则调用此方法无效。调用pause() 后，paused 属性将为 true。

重置帧动画属性

调用此方法可将frame 和elapsedTime 重置为初始值（0）。该方法对running 或paused 属性没有影响，可以在它们为真或为假时调用。

调用reset() 和restart() 的区别在于，reset() 将始终初始化这些属性，而restart() 只在下一帧更新时才初始化这些属性，例如，如果restart() 之后紧接着是pause() ，则不会发生这种情况。

重新启动帧动画

如果FrameAnimation 没有运行，则会启动，否则会停止，重置为初始状态后再启动。调用restart() 后，running 属性将为 true。

恢复暂停的帧动画

如果帧动画未暂停或未running ，则调用此方法无效。调用resume() 后，paused 属性将变为 false。

启动帧动画

如果帧动画已在运行，则调用此方法无效。调用start() 后，running 属性将变为 true。

停止帧动画

如果帧动画尚未运行，调用此方法不会产生任何效果。调用stop() 后，running 和paused 属性都将为 false。