LottieVectorImageController QML Type
Proporciona control de animación para un objeto ` VectorImage ` que muestra un archivo Lottie. Más...
| Import Statement: | import Qt.labs.lottieqt 1.0 |
| Since: | Qt 6.12 |
| Inherits: |
Propiedades
- currentFrame : real
- endFrame : real
- frameRate : real
- startFrame : real
- target : VectorImage
Métodos
- void gotoAndPlay(real frame)
- void gotoAndStop(real frame)
- void pause()
- void play()
- void start()
- void stop()
- void togglePause()
Descripción detallada
VectorImage Puede mostrar y reproducir animaciones Lottie, pero por sí solo solo ofrece una funcionalidad básica para controlar la reproducción. LottieVectorImageController amplía VectorImage con una API más potente para consultar y controlar la animación.
La propiedad ` target ` de `LottieVectorImageController` especifica el ` VectorImage ` que se va a controlar. Se establece de forma predeterminada si el `LottieVectorImageController` se crea como elemento secundario o propiedad de un ` VectorImage`. Cuando el ` VectorImage ` ha cargado un archivo Lottie y su ` status ` es ` Ready`, se pueden leer y escribir las propiedades del `LottieVectorImageController`, así como invocar sus funciones, para controlar la reproducción.
Junto con VectorImage, LottieVectorImageController imita la API del elemento LottieAnimation ya existente, por lo que suelen ser intercambiables sin apenas esfuerzo. (No se proporciona la función getDuration(), ya que puede sustituirse fácilmente por una expresión sencilla que utilice las propiedades endFrame, startFrame y, opcionalmente, frameRate ).
Véase también VectorImage y el ejemplo de qtlottieviewer.
Documentación de las propiedades
currentFrame : real [read-only]
El número del fotograma de la animación que se muestra actualmente.
endFrame : real [read-only]
El número del fotograma final de la animación («out-frame»), tal y como se especifica en el archivo fuente.
frameRate : real
Esta propiedad establece la velocidad de reproducción de la animación en fotogramas por segundo.
Cuando se carga la imagen vectorial, esta propiedad se establece en el valor de la velocidad de fotogramas especificado en el archivo de origen.
Tras la carga, se puede modificar frameRate para cambiar la velocidad de reproducción. Si se le asigna un valor vacío, se restablecerá al valor del archivo de origen.
startFrame : real [read-only]
El número del fotograma inicial de la animación («in-frame»), tal y como se especifica en el archivo fuente.
target : VectorImage
Esta propiedad especifica el VectorImage que se va a controlar.
Si el « LottieVectorImageController » se crea como elemento secundario o como propiedad de un « VectorImage », ese será el destino por defecto. De lo contrario, el destino debe establecerse explícitamente.
Documentación del método
void gotoAndPlay(real frame)
Desplaza la reproducción al fotograma número frame de Lottie y lo reproduce.
frame El valor se limitará entre startFrame y endFrame.
void gotoAndStop(real frame)
Desplaza la reproducción al fotograma número frame de Lottie y la pone en pausa.
frame quedará limitado entre startFrame y endFrame.
void pause()
Pone en pausa la reproducción.
void play()
Inicia (reanuda) la reproducción.
void start()
Reinicia la reproducción desde el punto « startFrame ».
void stop()
Restablece la reproducción a « startFrame » y la pone en pausa.
void togglePause()
Alterna entre los modos de reproducción y pausa de « target » VectorImage.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.