Qt Lottie Animation
Qt Lottie Animation 는 그래픽과 애니메이션을 로티 형식 파일로 렌더링하기 위한 QML API를 제공합니다. 이러한 파일은 일반적으로 Adobe After Effects용 Lottie 플러그인에서 내보냅니다.
LottieAnimation 항목은 QPainter 소프트웨어 렌더러를 사용하여 애니메이션을 중간 버퍼로 렌더링합니다. 이 경우 일러스트레이션의 크기와 대상 하드웨어에 따라 일부 성능 제한이 있을 수 있습니다. 이에 대한 대안으로 lottietoqml이라는 실험용 도구가 포함되어 있습니다. 이 도구는 로티 애니메이션을 QML로 변환합니다. 그 결과 Qt Quick 의 하드웨어 가속 렌더러를 사용하여 렌더링할 수 있습니다. 이 도구는 현재 기술 미리보기 단계로 간주됩니다. 이 도구는 아직까지 Qt Lottie Animation 에서 지원하는 모든 기능을 아직 지원하지 않으며 호환되지 않는 변경 사항이 예상됩니다.
마지막으로 VectorImage Qt Quick 항목은 로티 형식 파일을 직접 로드할 수 있습니다. 플러그인의 lottietoqml [기술 미리보기] 기능을 사용하여 즉석에서 QML로 변환합니다.
시작하기
다음 문을 사용하여 유형을 가져옵니다:
import Qt.labs.lottieqt
제한 사항
구현은 로티에 대한 마스터 사양을 따릅니다. 내보낸 로티 파일에서 사양과 비교하여 차이가 발견되면 가능한 한 많이 고려됩니다.
일반적인 제한 사항
- 표현식은 지원되지 않습니다.
- 타임라인은 시간 모드가 아닌 프레임 모드만 지원합니다.
경고: Qt Lottie Animation 의 입력 파일은 신뢰할 수 있는 콘텐츠로 가정합니다. 애플리케이션 개발자는 신뢰할 수 없는 출처의 데이터를 전달하지 않는 것이 좋습니다.
애니메이션 수준 제한
다음 속성은 지원되지 않습니다:
assets
- 재사용 가능한 텍스트 및 이미지chars
텍스트
레이어
다음 속성은 지원되지 않습니다:
ao
(자동 방향)bm
(혼합 모드)maskProperties
(마스크)sr
(시간 늘이기)
도형
다음과 같이 자주 사용되지 않는 일부 요소와 도형은 지원되지 않습니다:
gstroke
(그라데이션 스트로크) 요소- 중첩된 리피터 도형
또한 여러 개의 활성 트림 경로(예: 중첩된 그룹 내 트림 경로)를 사용할 때의 동작은 예측할 수 없습니다.
효과
지원되는 효과는 Slide
및 Layer Fill
입니다.
예제
- qtlottieviewer 예제는 LottieAnimation 항목을 사용하여 Qt Quick 애플리케이션에서 로티 파일을 로드, 표시 및 제어하는 방법을 보여줍니다.
- lottietoqml 예제에서는 lottietoqml 도구를 사용하여 로티 파일을 Qt Quick 장면으로 변환하고 애플리케이션에 로드하는 방법을 보여줍니다.
라이선스
Qt Lottie Animation 는 The Qt Company의 상용 라이선스에 따라 제공됩니다. 또한 GNU 일반 공중 사용 허가서 버전 3에 따라 사용할 수 있습니다. 자세한 내용은 Qt 라이선스를 참조하십시오.
참조
관련 정보
© 2025 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.