LottieVectorImageController QML Type

Permet de contrôler l'animation d'un élément « VectorImage » affichant un fichier Lottie. En savoir plus...

• Liste de tous les membres, y compris les membres hérités

Propriétés

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

Méthodes

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

Description détaillée

VectorImage peut afficher et lire des animations Lottie, mais en soi, il n'offre que des fonctionnalités rudimentaires pour contrôler la lecture. LottieVectorImageController étend VectorImage avec une API plus puissante permettant d'interroger et de contrôler l'animation.

La propriété ` target ` de `LottieVectorImageController` spécifie l’ VectorImage à contrôler. Elle est définie par défaut si le LottieVectorImageController est créé en tant qu’enfant ou propriété d’un VectorImage. Lorsque l’ VectorImage a chargé un fichier Lottie et que sa propriété status prend la valeur Ready, les propriétés du LottieVectorImageController peuvent être lues et modifiées, et ses fonctions appelées, afin de contrôler la lecture.

Associé à VectorImage, LottieVectorImageController reproduit l’API de l’élément LottieAnimation existant ; ils sont donc généralement interchangeables sans grand effort. (La fonction getDuration() n’est pas fournie, car elle peut être facilement remplacée par une simple expression utilisant les propriétés endFrame, startFrame et, éventuellement, frameRate.)

Voir également VectorImage et l’exemple qtlottieviewer.

Documentation sur les propriétés

currentFrame : real [read-only]

Numéro de l'image de l'animation actuellement affichée.

endFrame : real [read-only]

Le numéro de l'image de fin de l'animation (« out-frame »), tel qu'il est spécifié dans le fichier source.

frameRate : real

Cette propriété définit la vitesse de lecture de l'animation en images par seconde.

Lorsque l'image vectorielle est chargée, cette propriété est définie sur la valeur de fréquence d'images spécifiée dans le fichier source.

Une fois le chargement terminé, la propriété frameRate peut être modifiée pour changer la vitesse de lecture. Lui attribuer une valeur vide la réinitialise à la valeur du fichier source.

startFrame : real [read-only]

Numéro de l'image de départ de l'animation (« in-frame »), tel qu'il est indiqué dans le fichier source.

target : VectorImage

Cette propriété spécifie l'VectorImage à contrôler.

Si l’ LottieVectorImageController est créée en tant qu’enfant ou propriété d’un VectorImage, celui-ci sera la cible par défaut. Sinon, la cible doit être définie explicitement.

Documentation des méthodes

void gotoAndPlay(real frame)

Passe à l'image Lottie numéro frame et lance la lecture.

frame sera limité entre startFrame et endFrame.

void gotoAndStop(real frame)

Fait passer la lecture à l'image Lottie numéro frame et la met en pause.

frame sera limité entre startFrame et endFrame.

void pause()

Met la lecture en pause.

void play()

Lance (reprend) la lecture.

void start()

Reprend la lecture à partir de l'startFrame.

void stop()

Réinitialise la lecture à l'startFrame e et la met en pause.

void togglePause()

Permet de basculer entre les modes « lecture » et « pause » de l’ target VectorImage .