lottietoqml
lottietoqml は、Qtに同梱されているコマンドラインツールで、LottieドキュメントをQmlファイルに変換します。このQmlファイルは、Qt Quick アプリケーションのコンポーネントとして使用できます。
lottietoqml は、直接使用することも、qt_target_qml_from_lottieCMakeコマンドを介して使用することもできます。
lottietoqml をアプリケーションでどのように使用できるかのデモについては、lottietoqml の例を参照してください。
概要
lottietoqml ツールは、Lottie ファイルを、Qt Quick プリミティブを使用する QML ファイルに変換します。Qt Quick はハードウェアアクセラレーションに対応しているため、アニメーションのレンダリングは、 Qt Lottie Animation。さらに、Qt Quick はスケーラブル・ベクター・グラフィックス（SVG）をサポートしているため、生成されたアイテムは、可能な限りスムーズに変形させることができます。
使用方法
lottietoqml の基本的な使用方法は、入力ファイルと出力ファイルを指定することです：lottietoqml input.json output.qml 。これにより、input.json ファイルが読み込まれ、output.qml 内の対応するQt Quick シーンに変換されます。このシーンは、Qt Quick アプリケーションの一部として使用できます。
さらに、以下のオプションもサポートしています：
| オプション | 説明 |
|---|---|
| –copyright-statement <string> | 生成されたファイルの先頭に <string> をコメントとして追加します。 |
| -c, –curve-renderer | curve-renderer バックエンドを有効にします Qt Quick Shapes。これにより、マルチサンプリングを行わずにシーン内で滑らかでアンチエイリアス処理された形状を実現できますが、若干のオーバーヘッドが発生します。 |
-a,--asynchronous-shapes | 生成されたシーン内のすべてのShape 要素に対して、asynchronous モードを有効にします。これにより、CPU使用率と応答性が向上する可能性があります。 |
| -p, –optimize-paths | パスをQMLファイルに書き込む前に最適化を行い、後の読み込みやレンダリングを高速化できる可能性があります。 |
| –outline-stroke-mode | 元のパスではなく、塗りつぶされた図形のアウトライン（輪郭）をストロークします。 |
| -t, –type-name <文字列> | Shape の代わりに、出力ではタイプ名 <string> が使用されます。これにより、カスタムアイテムを使用して、Shape アイテムのデフォルトの動作を上書きできるようになります。 |
| -v, –view | 生成される予定のQt Quick 項目のプレビューを表示します。 |
© 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.
