LottieVectorImageController QML Type

Bietet Funktionen zur Steuerung von Animationen für ein „ VectorImage “, das eine Lottie-Datei anzeigt. Mehr...

• Liste aller Mitglieder, einschließlich vererbter Mitglieder

Eigenschaften

• currentFrame : real
• endFrame : real
• frameRate : real
• startFrame : real
• target : VectorImage

Methoden

• void gotoAndPlay(real frame)
• void gotoAndStop(real frame)
• void pause()
• void play()
• void start()
• void stop()
• void togglePause()

Ausführliche Beschreibung

VectorImage kann Lottie-Animationen anzeigen und abspielen, bietet jedoch für sich genommen nur rudimentäre Funktionen zur Steuerung der Wiedergabe. LottieVectorImageController erweitert VectorImage um eine leistungsfähigere API zur Abfrage und Steuerung der Animation.

Die Eigenschaft „ target “ von LottieVectorImageController gibt das zu steuernde „ VectorImage “ an. Sie ist standardmäßig gesetzt, wenn der „LottieVectorImageController“ als untergeordnetes Element oder als Eigenschaft eines „ VectorImage “ erstellt wird. Wenn der „ VectorImage “ eine Lottie-Datei geladen hat und sein „ status “ auf „ Ready “ gesetzt ist, können die Eigenschaften des „LottieVectorImageController“ gelesen und geschrieben sowie seine Funktionen aufgerufen werden, um die Wiedergabe zu steuern.

In Verbindung mit „ VectorImage “ ahmt der „LottieVectorImageController“ die API des bestehenden „ LottieAnimation “-Elements nach, sodass beide in der Regel mit geringem Aufwand austauschbar sind. (Die Funktion „ getDuration() “ wird nicht bereitgestellt, da sie sich auf einfache Weise durch einen Ausdruck ersetzen lässt, der die Eigenschaften „ endFrame “, „ startFrame “ und optional „ frameRate “ verwendet.)

Siehe auch „ VectorImage “ und das „qtlottieviewer“-Beispiel.

Dokumentation zu den Eigenschaften

currentFrame : real [read-only]

Die Nummer des aktuell angezeigten Animationsframes.

endFrame : real [read-only]

Die Nummer des letzten Bildes der Animation („Out-Frame“), wie in der Quelldatei angegeben.

frameRate : real

Diese Eigenschaft gibt die Wiedergabegeschwindigkeit der Animation in Bildern pro Sekunde an.

Beim Laden des Vektorbildes wird diese Eigenschaft auf den in der Quelldatei angegebenen Bildratenwert gesetzt.

Nach dem Laden kann „frameRate“ geändert werden, um die Wiedergabegeschwindigkeit anzupassen. Wird ihr ein leerer Wert zugewiesen, wird sie auf den Wert der Quelldatei zurückgesetzt.

startFrame : real [read-only]

Die Startbildnummer der Animation („in-frame“), wie sie in der Quelldatei angegeben ist.

target : VectorImage

Diese Eigenschaft legt die zu steuernde „ VectorImage “ fest.

Wird die „ LottieVectorImageController “ als untergeordnetes Element oder Eigenschaft eines „ VectorImage “ angelegt, gilt dieses als Standardziel. Andernfalls muss das Ziel explizit festgelegt werden.

Methodendokumentation

void gotoAndPlay(real frame)

Springt zur Lottie-Bildnummer frame und spielt die Wiedergabe ab.

frame wird auf den Bereich zwischen startFrame und endFrame begrenzt.

void gotoAndStop(real frame)

Springt zur Lottie-Bildnummer frame und hält die Wiedergabe an.

frame wird auf den Bereich zwischen startFrame und endFrame begrenzt.

void pause()

Hält die Wiedergabe an.

void play()

Startet (setzt fort) die Wiedergabe.

void start()

Setzt die Wiedergabe ab der Stelle „ startFrame “ fort.

void stop()

Setzt die Wiedergabe auf den „ startFrame “ zurück und hält sie an.

void togglePause()

Schaltet den „ target “ VectorImage zwischen Wiedergabe- und Pausenmodus um.