Qt Lottie Animation
Qt Lottie Animation proporciona API QML para renderizar gráficos y animaciones en archivos con formato Lottie. Éstos se exportan normalmente desde los plugins Lottie para Adobe After Effects.
El elemento LottieAnimation renderiza animaciones en un búfer intermedio utilizando el renderizador del software QPainter. Esto puede imponer algunas restricciones de rendimiento en los tamaños de las ilustraciones, así como en el hardware de destino. Como alternativa, se incluye una herramienta llamada lottietoqml. Esta herramienta convierte las animaciones Lottie a QML. Como resultado, pueden ser renderizadas utilizando el renderizador acelerado por hardware en Qt Quick.
Si los archivos Lottie son conocidos en el momento de compilar, también puedes convertirlos a QML usando la herramienta lottietoqml, o el comando qt_target_qml_from_lottie de CMake que envuelve la herramienta.
Por último, el elemento VectorImage Qt Quick puede cargar archivos con formato Lottie directamente. Los convierte a QML en tiempo de ejecución utilizando la funcionalidad lottietoqml en un plugin.
Para empezar
Importa los tipos usando la siguiente sentencia:
import Qt.labs.lottieqt
Limitaciones
La implementación sigue la especificación maestra para lottie. Las desviaciones en los archivos Lottie exportados en comparación con la especificación se tienen en cuenta en la medida de lo posible cuando se observan diferencias.
Limitaciones generales
- no se admiten expresiones
- la línea de tiempo sólo soporta el modo cuadro, no el modo tiempo
Advertencia: Se asume que los archivos de entrada para Qt Lottie Animation son contenido de confianza. Se recomienda a los desarrolladores de aplicaciones que nunca introduzcan datos procedentes de fuentes no fiables.
Limitaciones del nivel de animación
No se admiten las siguientes propiedades
assets- texto e imágenes reutilizablescharstexto
Capas
No se admiten las siguientes propiedades
ao(orientación automática)bm(modo de fusión)maskProperties(máscaras)sr(estiramiento temporal)
Formas
Algunos elementos y formas poco utilizados no son compatibles, entre ellos:
- el elemento
gstroke(trazo de degradado) - Formas de repetición anidadas
Tenga en cuenta también que el comportamiento cuando se utilizan varios trazados de recorte activos (por ejemplo, trazados de recorte en grupos anidados) es impredecible.
Efectos
Los únicos efectos compatibles son Slide y Layer Fill.
Ejemplos
- El ejemplo qtlottieviewer muestra cómo utilizar el elemento LottieAnimation para cargar, mostrar y controlar un archivo Lottie en una aplicación Qt Quick.
- El ejemplo lottietoqml muestra cómo utilizar la herramienta lottietoqml para convertir archivos Lottie en escenas Qt Quick y cargarlas en una aplicación.
Licencias
Qt Lottie Animation está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo la Licencia Pública General GNU, versión 3. Ver Licencias Qt para más detalles.
Referencia
Información relacionada
© 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.
