Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

Qt Lottie Animation

Qt Lottie Animation fournit des API QML pour le rendu de graphiques et d'animations dans des fichiers au format Lottie. Ces fichiers sont généralement exportés à partir des modules d'extension Lottie pour Adobe After Effects.

L'élément LottieAnimation rend les animations dans un tampon intermédiaire à l'aide du moteur de rendu logiciel QPainter. Cela peut imposer des restrictions de performance en fonction de la taille des illustrations et du matériel cible. Comme alternative, un outil appelé lottietoqml est inclus. Cet outil convertit les animations Lottie en QML. Par conséquent, elles peuvent être rendues à l'aide du moteur de rendu accéléré par le matériel dans Qt Quick.

Si les fichiers Lottie sont connus au moment de la compilation, vous pouvez également les convertir en QML en utilisant l'outil lottietoqml, ou la commande CMake qt_target_qml_from_lottie qui englobe l'outil.

Enfin, l'élément VectorImage Qt Quick peut charger directement des fichiers au format Lottie. Il les convertit en QML à Runtime en utilisant la fonctionnalité lottietoqml dans un plugin.

Pour commencer

Importez les types à l'aide de l'instruction suivante :

import Qt.labs.lottieqt

Limitations

L'implémentation suit la spécification principale pour Lottie. Les écarts dans les fichiers Lottie exportés par rapport à la spécification sont pris en compte autant que possible lorsque des différences sont constatées.

Limitations générales

  • les expressions ne sont pas prises en charge
  • la ligne de temps ne supporte que le mode image, pas le mode temps

Avertissement : Les fichiers d'entrée de Qt Lottie Animation sont supposés être des contenus de confiance. Il est conseillé aux développeurs d'applications de ne jamais transmettre de données provenant de sources non fiables.

Limitations au niveau de l'animation

Les propriétés suivantes ne sont pas prises en charge :

  • assets - texte et images réutilisables
  • chars texte

Couches

Les propriétés suivantes ne sont pas prises en charge :

  • ao (auto-orientation)
  • bm (mode de fusion)
  • maskProperties (masques)
  • sr (étirement dans le temps)

Formes

Certains éléments et formes rarement utilisés ne sont pas pris en charge, notamment

  • l'élément gstroke (trait dégradé)
  • les formes répétitives imbriquées

Notez également que le comportement lors de l'utilisation de plusieurs chemins de coupe actifs (par exemple, chemins de coupe dans des groupes imbriqués) est imprévisible.

Effets

Les seuls effets pris en charge sont Slide et Layer Fill.

Exemples

Licences

Qt Lottie Animation est disponible sous licence commerciale auprès de The Qt Company. En outre, il est disponible sous la licence publique générale GNU, version 3. Voir Qt Licensing pour plus de détails.

Référence

© 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.