qt_target_qml_from_lottie
Génère du code QML à partir d’un fichier Lottie.
La commande est définie dans le composant « LottieTools » du paquet « Qt6 », qui peut être chargé comme suit :
find_package(Qt6 REQUIRED COMPONENTS LottieTools)Cette commande a été introduite dans Qt 6.11.
Synopsis
qt_target_qml_from_lottie(target
[CURVE_RENDERER]
[ASYNCHRONOUS_SHAPES] # since Qt 6.12
[OPTIMIZE_PATHS]
[OUTLINE_STROKE_MODE]
[TYPE_NAME "MyShapeName"]
[COPYRIGHT_STATEMENT "Copyright © Company1"]
FILES file1.json [file2.json ...]
OUTPUTS File1.qml [File2.qml ...]
)L'option ` ASYNCHRONOUS_SHAPES ` a été introduite dans Qt 6.12.
Si les commandes sans version sont désactivées, utilisez plutôt qt6_target_qml_from_lottie(). Elle prend en charge le même ensemble d’arguments que cette commande.
Exemple :
qt_target_qml_from_lottie(applottietoqmlexample
CURVE_RENDERER
OPTIMIZE_PATHS
FILES
original/FingerprintIcon.json
original/GoogleIcons.json
original/HappyStar.json
original/HeartMedical.json
original/SurprisedBoy.json
original/USAMapWithOutlines.json
original/UserAuthentication.json
original/UserInteractionAnimation.json
original/UserInterface.json
OUTPUTS
generated/FingerprintIcon.qml
generated/GoogleIcons.qml
generated/HappyStar.qml
generated/HeartMedical.qml
generated/SurprisedBoy.qml
generated/USAMapWithOutlines.qml
generated/UserAuthentication.qml
generated/UserInteractionAnimation.qml
generated/UserInterface.qml
)Description
qt_target_qml_from_lottie() crée les étapes de construction nécessaires pour exécuter lottietoqml sur la liste d’images Lottie contenue dans FILES. Les noms des fichiers générés doivent être spécifiés dans OUTPUTS. La longueur de cette liste doit être identique à celle de FILES, et le premier élément correspond au premier élément de FILES, et ainsi de suite. Les noms fournis dans OUTPUTS seront les noms des types QML tels qu’ils apparaissent dans le module. Ceux-ci pourront ensuite être instanciés dans le code de l’application.
Les fichiers QML générés seront ajoutés au module QML de target. Vous devez d'abord utiliser qt_add_qml_module() pour définir un module pour l'target.
Vous pouvez éventuellement fournir un argument COPYRIGHT_STATEMENT pour insérer des informations de copyright dans les fichiers générés.
Remarque : certains caractères doivent être échappés pour une utilisation en ligne de commande, sinon des erreurs de compilation peuvent survenir sur certaines plateformes.
TYPE_NAME est également facultatif et peut être utilisé pour remplacer toutes les occurrences du type Shape dans le fichier généré par un type personnalisé. Cela peut s’avérer utile pour effectuer des personnalisations générales sur toutes les formes contenues dans les fichiers Lottie fournis. Le paramètre TYPE_NAME doit faire référence à un type QML disponible dans le module QML target.
Les options CURVE_RENDERER, ASYNCHRONOUS_SHAPES, OPTIMIZE_PATHS et OUTLINE_STROKE_MODE correspondent respectivement aux options --curve-renderer, --asynchronous-shapes, --optimize-paths et --outline-stroke-mode de lottietoqml.
© 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.