FrameAnimation QML Type

Diese Eigenschaft enthält die Anzahl der Bildaktualisierungen seit dem Start. Wenn die Frame-Animation neu gestartet wird, beginnt currentFrame bei 0.

Das folgende Beispiel zeigt, wie man auf Frame-Updates reagieren kann.

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

Diese Eigenschaft kann auch verwendet werden, um nur jedes n-te Bild zu rendern. Betrachten Sie eine fortgeschrittene Anwendung, bei der die Benutzeroberfläche zwei schwere Elemente enthält, und um eine gleichmäßige Gesamtbildrate von 60 Bildern pro Sekunde zu erreichen, beschließen Sie, diese schweren Elemente mit 30 Bildern pro Sekunde zu rendern, das erste bei jedem geraden Bild und das zweite bei jedem ungeraden Bild:

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

Standardmäßig ist frame gleich 0.

Diese Eigenschaft enthält die Zeit (in Sekunden) seit dem letzten Start.

Standardmäßig ist elapsedTime gleich 0.

Diese Eigenschaft enthält die Zeit (in Sekunden) seit der letzten Aktualisierung des Bildes.

Das folgende Beispiel zeigt, wie frameTime verwendet werden kann, um Elemente mit unterschiedlicher Geschwindigkeit zu animieren, wobei die Bildwiederholrate und mögliche fps-Einbrüche berücksichtigt werden.

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
    }
}

Standardmäßig ist frameTime auf 0 gesetzt.

Bei true wird die Frame-Animation angehalten, andernfalls wird sie fortgesetzt.

paused Der Standardwert ist false.

Siehe auch pause() und resume().

Wenn auf true gesetzt, wird die Bildanimation gestartet, andernfalls gestoppt.

running Standardwert ist false.

Siehe auch stop(), start(), und restart().

Diese Eigenschaft enthält die geglättete Zeit (in Sekunden) seit der letzten Bildaktualisierung.

Das folgende Beispiel zeigt, wie smoothFrameTime verwendet werden kann, um die durchschnittlichen fps anzuzeigen.

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

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

Standardmäßig ist smoothFrameTime gleich 0.

Dieses Signal wird ausgegeben, wenn FrameAnimation zu einem neuen Frame übergegangen ist.

Pausiert die Frame-Animation

Wenn die Frame-Animation bereits pausiert oder nicht running ist, hat der Aufruf dieser Methode keine Auswirkung. Die Eigenschaft paused wird nach einem Aufruf von pause() auf true gesetzt.

Setzt die Eigenschaften der Rahmenanimation zurück

Der Aufruf dieser Methode setzt die Eigenschaften frame und elapsedTime auf ihre Anfangswerte (0) zurück. Diese Methode hat keine Auswirkung auf die Eigenschaften running oder paused und kann aufgerufen werden, während sie wahr oder falsch sind.

Der Unterschied zwischen dem Aufruf von reset() und restart() besteht darin, dass reset() die Eigenschaften immer initialisiert, während restart() sie nur beim nächsten Frame-Update initialisiert, was z.B. nicht geschieht, wenn restart() unmittelbar von pause() gefolgt wird.

Neustart der Frame-Animation

Wenn FrameAnimation nicht läuft, wird sie gestartet, andernfalls wird sie angehalten, auf den Ausgangszustand zurückgesetzt und gestartet. Die Eigenschaft running wird nach einem Aufruf von restart() auf true gesetzt.

Setzt eine angehaltene Bildanimation fort

Wenn die Frame-Animation nicht pausiert oder nicht running ist, hat der Aufruf dieser Methode keine Auswirkung. Die Eigenschaft paused wird nach einem Aufruf von resume() auf false gesetzt.

Startet die Bildanimation

Wenn die Rahmenanimation bereits läuft, hat der Aufruf dieser Methode keine Auswirkung. Die Eigenschaft running wird nach einem Aufruf von start() auf true gesetzt.

Stoppt die Bildanimation

Wenn die Frame-Animation nicht läuft, hat der Aufruf dieser Methode keine Auswirkung. Die beiden Eigenschaften running und paused werden nach einem Aufruf von stop() auf false gesetzt.