Qt Lottie Animation
Qt Lottie Animation bietet QML-APIs zum Rendern von Grafiken und Animationen in Dateien im Lottie-Format. Diese werden normalerweise von den Lottie-Plugins für Adobe After Effects exportiert.
Das Element LottieAnimation rendert Animationen in einen Zwischenpuffer unter Verwendung des QPainter-Software-Renderers. Dies kann zu Leistungseinschränkungen in Bezug auf die Größe der Illustrationen sowie auf die Zielhardware führen. Als Alternative ist ein experimentelles Werkzeug namens lottietoqml enthalten. Dieses Tool konvertiert Lottie-Animationen in QML. Dadurch können sie mit dem hardwarebeschleunigten Renderer in Qt Quick gerendert werden. Das Tool befindet sich derzeit in der technischen Vorschau. Es unterstützt noch nicht den vollen Funktionsumfang von Qt Lottie Animation unterstützt, und es ist mit inkompatiblen Änderungen zu rechnen.
Schließlich kann das Element VectorImage Qt Quick Dateien im Lottie-Format direkt laden. Er konvertiert sie mit Hilfe der lottietoqml [tech preview]-Funktionalität in einem Plugin direkt in QML.
Erste Schritte
Importieren Sie die Typen mit der folgenden Anweisung:
import Qt.labs.lottieqt
Beschränkungen
Die Implementierung folgt der Masterspezifikation für Lottie. Abweichungen in exportierten Lottie-Dateien im Vergleich zur Spezifikation werden so weit wie möglich berücksichtigt, wenn Unterschiede festgestellt werden.
Allgemeine Einschränkungen
- Ausdrücke werden nicht unterstützt
- die Zeitleiste unterstützt nur den Frame-Modus, nicht den Zeit-Modus
Warnung: Bei den Eingabedateien für Qt Lottie Animation wird davon ausgegangen, dass es sich um vertrauenswürdige Inhalte handelt. Anwendungsentwicklern wird empfohlen, niemals Daten aus nicht vertrauenswürdigen Quellen einzugeben.
Einschränkungen der Animationsebene
Die folgenden Eigenschaften werden nicht unterstützt:
assets- wiederverwendbarer Text und BildercharsText
Ebenen
Die folgenden Eigenschaften werden nicht unterstützt:
ao(Autoausrichtung)bm(Mischmodus)maskProperties(Masken)sr(Zeitdehnung)
Formen
Einige seltener verwendete Elemente und Formen werden nicht unterstützt, darunter:
- das Element
gstroke(Verlaufslinie) - Verschachtelte Wiederholerformen
Beachten Sie auch, dass das Verhalten bei der Verwendung mehrerer aktiver Beschneidungspfade (z. B. Beschneidungspfade in verschachtelten Gruppen) unvorhersehbar ist.
Effekte
Die einzigen unterstützten Effekte sind Slide und Layer Fill.
Beispiele
- Das qtlottieviewer-Beispiel demonstriert die Verwendung des Elements LottieAnimation zum Laden, Anzeigen und Steuern einer Lottie-Datei in einer Qt Quick -Anwendung.
- Das lottietoqml-Beispiel demonstriert, wie das lottietoqml-Tool verwendet werden kann, um Lottie-Dateien in Qt Quick -Szenen zu konvertieren und diese in eine Anwendung zu laden.
Lizenzen
Qt Lottie Animation ist unter kommerziellen Lizenzen von The Qt Company erhältlich. Darüber hinaus ist es unter der GNU General Public License, Version 3, erhältlich. Siehe Qt Licensing für weitere Details.
Referenz
Verwandte Informationen
© 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.
