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 에 대한 모듈을 정의해야 합니다.

참고: 명령줄에서 사용할 경우특정 문자는 이스케이프 처리해야 하며, 그렇지 않으면 일부 플랫폼에서 빌드 오류가 발생할 수 있습니다.

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.