AnimationController QML Type
Un tipo de controlador para animaciones. Más información...
| Import Statement: | import Qt3D.Animation 2.12 |
| In C++: | QAnimationController |
| Status: | Technology preview |
Este tipo se encuentra en fase de vista previa tecnológica y está sujeto a cambios.
Propiedades
- activeAnimationGroup : int
- animationGroups : list<AnimationGroup>
- entity : Entity
- position : real
- positionOffset : real
- positionScale : real
- recursive : bool
Métodos
- int getAnimationIndex(name)
- AnimationGroup getGroup(index)
Descripción detallada
El tipo AnimationController controla la selección y la reproducción de animaciones. Este tipo se puede utilizar para buscar todas las animaciones del árbol de entidades y crear un « AnimationGroups » a partir de las animaciones con el mismo nombre. El usuario puede seleccionar qué grupo de animaciones se controla actualmente con el controlador de animaciones estableciendo la animación activa. A continuación, la posición de la animación se propaga a ese grupo tras escalar y desplazar el valor de posición proporcionado con los valores « positionScale » y « positionOffset ».
Nota: el controladorde animación no dispone de temporizador interno, por lo que es responsabilidad del usuario actualizar la propiedad de posición de forma oportuna.
Documentación de la propiedad
activeAnimationGroup : int
Almacena el grupo de animación actualmente activo.
animationGroups : list<AnimationGroup>
Contiene la lista de grupos de animación del controlador.
entity : Entity
Contiene la entidad de la que se recopilan y agrupan las animaciones. Si el controlador ya contiene animaciones, estas se borran.
position : real
Almacena la posición actual de la animación. Cuando se establece la posición, esta se escala y se desplaza mediante positionScale/positionOffset y se aplica al grupo de animación activo.
positionOffset : real
Almacena el desplazamiento de posición de la animación.
positionScale : real
Almacena la escala de posición de la animación.
recursive : bool
Indica si se realiza una búsqueda recursiva en el árbol de entidades al recopilar animaciones de la entidad. Si se establece en «true», las animaciones también se buscan en las entidades secundarias de la entidad. Si se establece en «false», solo se busca en la entidad pasada al controlador.
Documentación del método
int getAnimationIndex(name)
Devuelve el índice de la animación con « name ». Devuelve -1 si no se encuentra ninguna animación « AnimationGroup » con el nombre indicado.
AnimationGroup getGroup(index)
Devuelve el objeto ` AnimationGroup ` con el ` index` indicado.
© 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.