Auf dieser Seite

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

Methoden

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.