Auf dieser Seite

qt_target_qml_from_lottie

Erzeugt QML-Code auf Basis einer Lottie-Datei.

Der Befehl ist in der Komponente „ LottieTools “ des Pakets „ Qt6 “ definiert, das wie folgt geladen werden kann:

find_package(Qt6 REQUIRED COMPONENTS LottieTools)

Dieser Befehl wurde in Qt 6.11 eingeführt.

Übersicht

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 ...]
                          )

Die Option „ ASYNCHRONOUS_SHAPES “ wurde in Qt 6.12 eingeführt.

Wenn versionsunabhängige Befehle deaktiviert sind, verwenden Sie stattdessen „ qt6_target_qml_from_lottie() “. Dieser Befehl unterstützt dieselben Argumente wie der vorgenannte Befehl.

Beispiel:

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
)

Beschreibung

qt_target_qml_from_lottie() erstellt die Build-Schritte, um lottietoqml auf die Liste der Lottie-Bilder in ` FILES` anzuwenden. Die Namen der generierten Dateien sollten in ` OUTPUTS` angegeben werden. Die Länge dieser Liste muss mit ` FILES` übereinstimmen, und das erste Element entspricht dem ersten Element in ` FILES ` und so weiter. Die in OUTPUTS angegebenen Namen entsprechen den Namen der QML-Typen, wie sie im Modul erscheinen. Diese können wiederum im Anwendungscode instanziiert werden.

Die generierten QML-Dateien werden dem QML-Modul unter target hinzugefügt. Sie müssen zunächst mit qt_add_qml_module() ein Modul für die „ target “ definieren.

Optional kann ein Argument ` COPYRIGHT_STATEMENT ` angegeben werden, um Copyright-Informationen in die generierten Dateien einzufügen.

Hinweis: Bestimmte Zeichen müssen für die Verwendung in der Befehlszeile mit Escape-Zeichen versehen werden, da es sonst auf einigen Plattformen zu Kompilierungsfehlern kommen kann.

TYPE_NAME ist ebenfalls optional und kann verwendet werden, um alle Vorkommen des Typs „ Shape “ in der generierten Datei durch einen benutzerdefinierten Typ zu ersetzen. Dies kann nützlich sein, um allgemeine Anpassungen an allen Formen in den bereitgestellten Lottie-Dateien vorzunehmen. „ TYPE_NAME “ sollte auf einen QML-Typ verweisen, der im QML-Modul „ target “ verfügbar ist.

Die Optionen „ CURVE_RENDERER “, „ ASYNCHRONOUS_SHAPES “, „ OPTIMIZE_PATHS “ und „ OUTLINE_STROKE_MODE “ entsprechen den Optionen „ --curve-renderer “, „ --asynchronous-shapes “, „ --optimize-paths “ und „ --outline-stroke-mode “ in 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.