Qt Lottie Animation
Qt Lottie Animation Lottie 형식 파일의 그래픽 및 애니메이션을 렌더링하기 위한 QML API를 제공합니다. 이러한 파일은 일반적으로 Adobe After Effects용 Lottie 플러그인에서 내보내집니다.
LottieAnimation 항목은 QPainter 소프트웨어 렌더러를 사용하여 애니메이션을 중간 버퍼에 렌더링합니다. 이로 인해 일러스트레이션의 크기나 대상 하드웨어에 따라 성능상의 제약이 발생할 수 있습니다. 대안으로, lottietoqml이라는 도구가 포함되어 있습니다. 이 도구는 Lottie 애니메이션을 QML로 변환합니다. 그 결과, Qt Quick 의 하드웨어 가속 렌더러를 사용하여 렌더링할 수 있습니다.
컴파일 시점에 Lottie 파일의 위치가 알려진 경우, lottietoqml 도구 또는 이 도구를 래핑하는 qt_target_qml_from_lottie CMake 명령어를 사용하여 파일을 QML로 변환할 수도 있습니다.
마지막으로, VectorImage 의 Qt Quick 항목은 Lottie 형식 파일을 직접 불러올 수 있습니다. 이 항목은 플러그인 내의 lottietoqml 기능을 사용하여 런타임에 해당 파일을 QML로 변환합니다.
시작하기
다음 문장을 사용하여 타입을 임포트하십시오:
import Qt.labs.lottieqt제한 사항
이 구현은 Lottie의 마스터 사양을 따릅니다. 내보낸 Lottie 파일이 사양과 다른 점이 발견될 경우, 가능한 한 이를 반영하도록 노력하고 있습니다.
일반적인 제한 사항
- 표현식은 지원되지 않습니다
- 타임라인은 시간 모드가 아닌 프레임 모드만 지원합니다
경고: Qt Lottie Animation 의 입력파일은 신뢰할 수 있는 콘텐츠로 간주됩니다. 애플리케이션 개발자는 신뢰할 수 없는 출처의 데이터를 절대 전달하지 말아야 합니다.
애니메이션 레벨 제한 사항
다음 속성은 지원되지 않습니다:
assets- 재사용 가능한 텍스트 및 이미지chars텍스트
레이어
다음 속성은 지원되지 않습니다:
bm(블렌드 모드)
도형
다음과 같이 드물게 사용되는 일부 요소 및 도형은 지원되지 않습니다:
- 중첩된 리피터 도형
또한, 여러 개의 활성 트림 경로(예: 중첩된 그룹 내의 트림 경로)를 사용할 때의 동작은 예측할 수 없음을 유의하십시오.
효과
지원되는 효과는 ‘ Slide ’와 ‘ Layer Fill ’뿐입니다.
예제
- qtlottieviewer 예제는 LottieAnimation 항목을 사용하여 Qt Quick 애플리케이션에서 Lottie 파일을 불러오고, 표시하고, 제어하는 방법을 보여줍니다.
- lottietoqml 예제는 lottietoqml 도구를 사용하여 Lottie 파일을 Qt Quick 장면으로 변환하고, 이를 애플리케이션에 로드하는 방법을 보여줍니다.
라이선스
Qt Lottie Animation 는 The Qt Company의 상용 라이선스에 따라 제공됩니다. 또한 GNU 일반 공중 사용 허가서(GNU General Public License) 버전 3에 의해서도 제공됩니다. 자세한 내용은 Qt 라이선싱을 참조하십시오.
참고
관련 정보
© 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.