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

Qt Lottie Animation

Qt Lottie Animation fournit des API QML permettant d’afficher des graphiques et des animations à partir de fichiers au format Lottie. Ceux-ci sont généralement exportés à partir des plugins 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 entraîner certaines limitations en termes de performances, tant au niveau de la taille des illustrations que du matériel cible. Une alternative est proposée : un outil appelé « lottietoqml » est inclus. Cet outil convertit les animations Lottie au format QML. Elles peuvent ainsi ê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 à l'aide de l'outil lottietoqml, ou de la commande CMake ` qt_target_qml_from_lottie ` qui encapsule cet outil.

Enfin, l’élément Qt Quick « VectorImage » peut charger directement des fichiers au format Lottie. Il les convertit en QML lors de l’exécution à l’aide de la fonctionnalité « lottietoqml » intégrée à 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 de Lottie. Les écarts constatés entre les fichiers Lottie exportés et la spécification sont pris en compte autant que possible dès qu’ils sont détectés.

Limitations générales

  • Les expressions ne sont pas prises en charge
  • La timeline ne prend en charge que le mode « frame » (image), et non le mode « time » (temps)

Avertissement : les fichiers d'entrée destinés à l'Qt Lottie Animation t sont considérés comme du contenu fiable. 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

Calques

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

  • bm (mode de fusion)

Formes

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

  • les formes répétitives imbriquées

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

Effets

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

Exemples

  • L'exemple qtlottieviewer montre comment utiliser l'élément « LottieAnimation » pour charger, afficher et contrôler un fichier Lottie dans une application « Qt Quick ».
  • L'exemple « lottietoqml » montre comment utiliser l'outil « lottietoqml » pour convertir des fichiers Lottie en scènes « Qt Quick » et les charger dans une application.

Licences

Qt Lottie Animation est disponible sous licence commerciale auprès de The Qt Company. Il est également disponible sous licence GNU General Public License, version 3. Pour plus d’informations, consultez la page Licences Qt.

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.