Sur cette page

AnimationController QML Type

Un type de contrôleur destiné aux animations. En savoir plus...

Import Statement: import Qt3D.Animation 2.12
In C++: QAnimationController
Status: Technology preview

Ce type est en préversion technologique et est susceptible d'être modifié.

Propriétés

Méthodes

Description détaillée

Le type AnimationController permet de contrôler la sélection et la lecture des animations. Ce type permet de rechercher toutes les animations dans l’arborescence des entités et de créer des groupes d’ AnimationGroups s à partir des animations portant le même nom. L’utilisateur peut sélectionner le groupe d’animations actuellement contrôlé par le contrôleur d’animation en définissant l’animation active. La position de l’animation est ensuite propagée à ce groupe après mise à l’échelle et décalage de la valeur de position fournie à l’aide des valeurs « positionScale » et « positionOffset ».

Remarque : le contrôleur d’animation ne dispose pas de minuterie interne ;c’est donc à l’utilisateur qu’il incombe de mettre à jour la propriété de position en temps opportun.

Documentation des propriétés

activeAnimationGroup : int

Contient le groupe d'animations actuellement actif.

animationGroups : list<AnimationGroup>

Contient la liste des groupes d'animation du contrôleur.

entity : Entity

Contient l'entité à partir de laquelle les animations sont collectées et regroupées. Si le contrôleur contient déjà des animations, celles-ci sont effacées.

position : real

Contient la position actuelle de l'animation. Une fois la position définie, elle est mise à l'échelle et décalée à l'aide de positionScale/positionOffset, puis propagée au groupe d'animation actif.

positionOffset : real

Contient le décalage de position de l'animation.

positionScale : real

Contient l'échelle de position de l'animation.

recursive : bool

Indique s'il faut effectuer une recherche récursive dans l'arborescence des entités lors de la collecte des animations à partir de l'entité. Si la valeur est « true », les animations sont également recherchées parmi les entités enfants de l'entité. Si la valeur est « false », seule l'entité transmise au contrôleur est parcourue.

Documentation de la méthode

int getAnimationIndex(name)

Renvoie l'index de l'animation à l'aide de la fonction ` name`. Renvoie -1 si aucune animation ` AnimationGroup ` portant le nom indiqué n'est trouvée.

AnimationGroup getGroup(index)

Renvoie l'AnimationGroup avec l'index donné.

© 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.