QT_TARGET_QML_From_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 에 있는 로티 이미지 목록에서 lottietoqml을 실행하는 빌드 단계를 생성합니다. 생성된 파일의 이름은 OUTPUTS 에 지정해야 합니다. 이 목록의 길이는 FILES 와 같아야 하며, 첫 번째 요소는 FILES 등의 첫 번째 요소에 해당합니다. OUTPUTS 에 제공된 이름은 모듈에 표시되는 QML 유형의 이름입니다. 이들은 차례로 애플리케이션 코드에서 인스턴스화될 수 있습니다.

생성된 QML 파일은 target 의 QML 모듈에 추가됩니다. target 에 대한 모듈을 정의하려면 먼저 qt_add_qml_module()을 사용해야 합니다.

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

TYPE_NAME 는 선택 사항이며, 생성된 파일에서 Shape 유형의 모든 인스턴스를 사용자 정의 유형으로 대체하는 데 사용할 수 있습니다. 이는 제공된 로티 파일에 있는 모든 모양에 일반적인 사용자 지정을 하는 데 유용할 수 있습니다. TYPE_NAME 은 target QML 모듈에서 사용할 수 있는 QML 유형을 참조해야 합니다.

CURVE_RENDERER, OPTIMIZE_PATHS 및 OUTLINE_STROKE_MODE 옵션은 각각 --curve-renderer, --optimize-paths 및 --outline-stroke-mode 로티토큐ML에 해당합니다.

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