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

ASYNCHRONOUS_SHAPES オプションは Qt 6.12 で導入されました。

バージョン指定なしのコマンドが無効になっている場合は、代わりに `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モジュールに追加されます。まず、qt_add_qml_module()を使用して、target のモジュールを定義する必要があります。

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

注：コマンドラインで使用する場合、特定の 文字はエスケープ処理を行う必要があります。そうしないと、一部のプラットフォームでビルドエラーが発生する可能性があります。

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

オプション `CURVE_RENDERER`、`ASYNCHRONOUS_SHAPES`、`OPTIMIZE_PATHS `、および `OUTLINE_STROKE_MODE ` は、それぞれlottietoqmlにおける `--curve-renderer`、`--asynchronous-shapes`、`--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.