FrameAnimation QML Type

このプロパティは、開始からのフレーム更新数を保持します。フレームアニメーションが再開されると、currentFrame は0 から始まります。

次の例は、フレーム更新に反応する方法を示しています。

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

このプロパティは、n番目のフレームごとにのみレンダリングするために使用することもできます。UIに2つの重い要素があり、全体のフレームレートをスムーズな60fpsにするために、これらの重い要素を30fpsでレンダリングし、1つ目は偶数フレームごとに、2つ目は奇数フレームごとにレンダリングするような高度な使い方を考えてみましょう：

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

デフォルトでは、frame は 0 です。

このプロパティは、前回の開始からの時間（秒）を保持します。

デフォルトでは、elapsedTime は0である。

このプロパティは、前回のフレーム更新からの時間（秒）を保持します。

次の例では、frameTime を使用して、画面のリフレッシュレートと可能な fps 低下に合わせて、速度を変化させながらアイテムをアニメーションさせる方法を示します。

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 を使用して平均 fps を表示しています。

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 プロパティは真になります。

フレームアニメーションのプロパティをリセットする

このメソッドを呼び出すと、frame とelapsedTime が初期値（0）にリセットされます。このメソッドは、running またはpaused プロパティには影響せず、それらが true または false のときに呼び出すことができます。

reset() restart() pause() と の違いは、 は常にプロパティを初期化するのに対し、 は次のフレーム更新時にのみ初期化することです。restart() reset() restart()

フレームアニメーションを再開する

FrameAnimation が実行されていない場合は開始され、そうでない場合は停止され、初期状態にリセットされてから開始されます。restart() を呼び出すと、running プロパティは真になります。

一時停止中のフレームアニメーションを再開する

フレームアニメーションが一時停止されていないか、running されていない場合、このメソッドを呼び出しても効果はありません。resume() への呼び出し後、paused プロパティは false になります。

フレームアニメーションを開始する

フレームアニメーションがすでに実行されている場合、このメソッドを呼び出しても効果はありません。start() を呼び出すと、running プロパティは true になります。

フレームアニメーションを停止する

フレームアニメーションが実行されていない場合、このメソッドを呼び出しても効果はありません。stop() を呼び出すと、running とpaused の両プロパティは false になります。