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 effectue le rendu des 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 expérimental 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. Cet outil est actuellement considéré comme un aperçu technique. Il ne prend pas encore en charge l'ensemble des fonctionnalités supportées par Qt Lottie Animation et il faut s'attendre à des changements incompatibles.

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

Pour commencer

Importez les types en utilisant 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

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