AnimationController QML Type
Ein Controller-Typ für Animationen. Mehr...
| Import Statement: | import Qt3D.Animation 2.12 |
| In C++: | QAnimationController |
| Status: | Technology preview |
Dieser Typ befindet sich in der Technology Preview und kann sich noch ändern.
Eigenschaften
- activeAnimationGroup : int
- animationGroups : list<AnimationGroup>
- entity : Entity
- position : real
- positionOffset : real
- positionScale : real
- recursive : bool
Methoden
- int getAnimationIndex(name)
- AnimationGroup getGroup(index)
Ausführliche Beschreibung
Der Typ „AnimationController“ steuert die Auswahl und Wiedergabe von Animationen. Der Typ kann verwendet werden, um alle Animationen aus dem Entitätsbaum zu finden und aus den gleichnamigen Animationen „ AnimationGroups “ zu erstellen. Der Benutzer kann auswählen, welche Animationsgruppe derzeit vom Animations-Controller gesteuert wird, indem er die aktive Animation festlegt. Die Animationsposition wird dann an diese Gruppe weitergegeben, nachdem der angegebene Positionswert anhand der Werte „ positionScale “ und „ positionOffset “ skaliert und versetzt wurde.
Hinweis: Der Animationscontroller verfügt über keinen internen Timer; stattdessen ist der Benutzer dafür verantwortlich, die Positionseigenschaft rechtzeitig zu aktualisieren.
Dokumentation der Eigenschaften
activeAnimationGroup : int
Enthält die derzeit aktive Animationsgruppe.
animationGroups : list<AnimationGroup>
Enthält die Liste der Animationsgruppen im Controller.
entity : Entity
Enthält die Entität, aus der die Animationen gesammelt und gruppiert werden. Falls der Controller bereits Animationen enthält, werden diese gelöscht.
position : real
Speichert die aktuelle Position der Animation. Wenn die Position festgelegt ist, wird sie mit „ positionScale “ / „positionOffset “ skaliert und verschoben und an die aktive Animationsgruppe weitergegeben.
positionOffset : real
Enthält den Positionsversatz der Animation.
positionScale : real
Speichert die Positionsskala der Animation.
recursive : bool
Gibt an, ob der Entitätsbaum beim Erfassen von Animationen aus der Entität rekursiv durchsucht werden soll. Ist der Wert „true“, werden die Animationen auch in den untergeordneten Entitäten der Entität gesucht. Ist der Wert „false“, wird nur die an den Controller übergebene Entität durchsucht.
Methodendokumentation
int getAnimationIndex(name)
Gibt den Index der Animation mit der Funktion „ name “ zurück. Gibt -1 zurück, wenn keine Animation vom Typ „ AnimationGroup “ mit dem angegebenen Namen gefunden wird.
AnimationGroup getGroup(index)
Gibt den „ AnimationGroup “ mit dem angegebenen „ index “ zurück.
© 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.