qt_target_qml_from_lottie

Lottieファイルを元にQMLコードを生成します。

このコマンドはQt6 パッケージのLottieTools コンポーネントで定義されています：

find_package(Qt6 REQUIRED COMPONENTS LottieTools)

このコマンドはQt 6.11で導入されました。

概要

qt_target_qml_from_lottie(target
                          [CURVE_RENDERER]
                          [OPTIMIZE_PATHS]
                          [OUTLINE_STROKE_MODE]
                          [TYPE_NAME "MyShapeName"]
                          [COPYRIGHT_STATEMENT "Copyright © Company1"]
                          FILES file1.json [file2.json ...]
                          OUTPUTS File1.qml [File2.qml ...]
                          )

バージョンレスコマンドが無効になっている場合は、代わりにqt6_target_qml_from_lottie() を使用してください。このコマンドと同じ引数をサポートしています。

例

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
)

説明

qt_target_qml_from_lottie() は、FILES にある Lottie イメージのリストに対してlottietoqml を実行するためのビルド・ステップを作成します。生成されるファイル名はOUTPUTS で指定します。このリストの長さはFILES と同じでなければならず、最初の要素はFILES の最初の要素に対応します。OUTPUTS で指定された名前は、モジュールに現れるQML型の名前となります。これらの型はアプリケーションコードでインスタンス化することができます。

生成されたQMLファイルは、target のQMLモジュールに追加されます。最初にtarget のモジュールを定義するために、qt_add_qml_module()を使用する必要があります。

オプションとして、COPYRIGHT_STATEMENT 引数を指定すると、生成されたファイルに著作権情報を挿入することができます。

注意: コマンドラインで使用する場合は、特定の文字をエスケープする必要があります。

TYPE_NAME もオプションで、生成されるファイル中のShape 型のすべてのインスタンスをカスタム型に置き換えるために使用できる。これは、提供されたLottieファイル内のすべてのシェイプに対して一般的なカスタマイズを行うのに便利です。TYPE_NAME はtarget QMLモジュールで利用可能なQML型を参照する必要があります。

オプションCURVE_RENDERER 、OPTIMIZE_PATHS 、OUTLINE_STROKE_MODE は、それぞれlottietoqmlの--curve-renderer 、--optimize-paths 、--outline-stroke-mode に対応しています。

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