Qt Lottie Animation
Qt Lottie Animation se proporcionan las API de QML para renderizar gráficos y animaciones en archivos con formato Lottie. Estos suelen exportarse desde los complementos de Lottie para Adobe After Effects.
El elemento « LottieAnimation » renderiza animaciones en un búfer intermedio utilizando el renderizador de software QPainter. Esto puede suponer algunas restricciones de rendimiento en cuanto al tamaño 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. De este modo, pueden renderizarse utilizando el renderizador acelerado por hardware de Qt Quick.
Si los archivos Lottie se conocen en el momento de la compilación, también se pueden convertir a QML utilizando la herramienta lottietoqml o el comando CMake ` qt_target_qml_from_lottie `, que envuelve dicha herramienta.
Por último, el elemento « VectorImage » de Qt Quick puede cargar directamente archivos en formato Lottie. Los convierte a QML en tiempo de ejecución utilizando la funcionalidad de «lottietoqml» en un complemento.
Primeros pasos
Importa los tipos mediante la siguiente instrucción:
import Qt.labs.lottieqtLimitaciones
La implementación sigue la especificación maestra de Lottie. Las desviaciones en los archivos Lottie exportados con respecto a la especificación se tienen en cuenta en la medida de lo posible cuando se detectan diferencias.
Limitaciones generales
- No se admiten expresiones
- La línea de tiempo solo admite el modo de fotogramas, no el modo de tiempo
Advertencia: Se da por hecho quelos 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 a nivel de animación
No se admiten las siguientes propiedades:
assets- texto e imágenes reutilizablescharstexto
Capas
Las siguientes propiedades no son compatibles:
bm(modo de fusión)
Formas
Algunos elementos y formas menos habituales no son compatibles, entre ellos:
- Formas repetidoras anidadas
Ten en cuenta también que el comportamiento al utilizar varias rutas de recorte activas (por ejemplo, rutas 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 se puede utilizar la herramienta «lottietoqml» para convertir archivos Lottie en escenas de « 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 de GNU, versión 3. Consulta «Licencias de Qt» para obtener 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.