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
- activeAnimationGroup : int
- animationGroups : list<AnimationGroup>
- entity : Entity
- position : real
- positionOffset : real
- positionScale : real
- recursive : bool
Méthodes
- int getAnimationIndex(name)
- AnimationGroup getGroup(index)
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.