Qt3DAnimation::QAnimationController Class
class Qt3DAnimation::QAnimationControllerUna clase de controlador para animaciones. Más...
| Cabecera: | #include <QAnimationController> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3danimation)target_link_libraries(mytarget PRIVATE Qt6::3danimation) |
| qmake: | QT += 3danimation |
| En QML: | AnimationController |
| Hereda: | QObject |
| Status: | Obsoleto |
Propiedades
|
|
Funciones públicas
| QAnimationController(QObject *parent = nullptr) | |
| int | activeAnimationGroup() const |
| void | addAnimationGroup(Qt3DAnimation::QAnimationGroup *animationGroup) |
| QList<Qt3DAnimation::QAnimationGroup *> | animationGroupList() |
| Qt3DCore::QEntity * | entity() const |
| int | getAnimationIndex(const QString &name) const |
| Qt3DAnimation::QAnimationGroup * | getGroup(int index) const |
| float | position() const |
| float | positionOffset() const |
| float | positionScale() const |
| bool | recursive() const |
| void | removeAnimationGroup(Qt3DAnimation::QAnimationGroup *animationGroup) |
| void | setAnimationGroups(const QList<Qt3DAnimation::QAnimationGroup *> &animationGroups) |
Ranuras públicas
| void | setActiveAnimationGroup(int index) |
| void | setEntity(Qt3DCore::QEntity *entity) |
| void | setPosition(float position) |
| void | setPositionOffset(float offset) |
| void | setPositionScale(float scale) |
| void | setRecursive(bool recursive) |
Señales
| void | activeAnimationGroupChanged(int index) |
| void | entityChanged(Qt3DCore::QEntity *entity) |
| void | positionChanged(float position) |
| void | positionOffsetChanged(float offset) |
| void | positionScaleChanged(float scale) |
| void | recursiveChanged(bool recursive) |
Descripción Detallada
Qt3DAnimation::QAnimationController controla la selección y reproducción de animaciones. La clase puede ser utilizada para encontrar todas las animaciones del árbol Qt3DCore::QEntity y crear QAnimationGroups a partir de las animaciones con el mismo nombre. El usuario puede seleccionar qué grupo de animación se controla actualmente con el controlador de animación estableciendo la animación activa. La posición de la animación se propaga entonces a ese grupo después de escalar y desplazar el valor de posición proporcionado con los valores positionScale y positionOffset.
Nota: que el controlador de animación no tiene temporizador interno, sino que el usuario es responsable de actualizar la propiedad de posición de manera oportuna.
Documentación de la propiedad
activeAnimationGroup : int
Mantiene el grupo de animación actualmente activo.
Funciones de acceso:
| int | activeAnimationGroup() const |
| void | setActiveAnimationGroup(int index) |
Señal de aviso:
| void | activeAnimationGroupChanged(int index) |
entity : Qt3DCore::QEntity*
Contiene las animaciones de la entidad que se reúnen y agrupan. Si el controlador ya contiene animaciones, se borran.
Funciones de acceso:
| Qt3DCore::QEntity * | entity() const |
| void | setEntity(Qt3DCore::QEntity *entity) |
Señal del notificador:
| void | entityChanged(Qt3DCore::QEntity *entity) |
position : float
Mantiene la posición actual de la animación. Cuando se establece la posición, se escala y desplaza con positionScale/positionOffset y se propaga al grupo de animación activo.
Funciones de acceso:
| float | position() const |
| void | setPosition(float position) |
Señal notificadora:
| void | positionChanged(float position) |
positionOffset : float
Mantiene el offset de posición de la animación.
Funciones de acceso:
| float | positionOffset() const |
| void | setPositionOffset(float offset) |
Señal del notificador:
| void | positionOffsetChanged(float offset) |
positionScale : float
Mantiene la escala de posición de la animación.
Funciones de acceso:
| float | positionScale() const |
| void | setPositionScale(float scale) |
Señal del notificador:
| void | positionScaleChanged(float scale) |
recursive : bool
Establece si se busca recursivamente en el árbol de entidades cuando se recopilan animaciones de la entidad. Si se establece en true, las animaciones se buscan también en las entidades hijas de la entidad. Si se establece en false, sólo se buscará en la entidad pasada al controlador.
Funciones de acceso:
| bool | recursive() const |
| void | setRecursive(bool recursive) |
Señal del notificador:
| void | recursiveChanged(bool recursive) |
Documentación de la función miembro
QAnimationController::QAnimationController(QObject *parent = nullptr)
Construye un nuevo QAnimationController con parent.
void QAnimationController::addAnimationGroup(Qt3DAnimation::QAnimationGroup *animationGroup)
Añade la dirección animationGroup al controlador.
QList<Qt3DAnimation::QAnimationGroup *> QAnimationController::animationGroupList()
Devuelve la lista de grupos de animación que tiene actualmente el controlador.
[invokable] int QAnimationController::getAnimationIndex(const QString &name) const
Devuelve el índice de la animación con name. Devuelve -1 si no se encuentra ningún AnimationGroup con el nombre dado.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] Qt3DAnimation::QAnimationGroup *QAnimationController::getGroup(int index) const
Devuelve el AnimationGroup con el index dado.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
void QAnimationController::removeAnimationGroup(Qt3DAnimation::QAnimationGroup *animationGroup)
Elimina la dirección animationGroup del controlador.
void QAnimationController::setAnimationGroups(const QList<Qt3DAnimation::QAnimationGroup *> &animationGroups)
Establece el animationGroups para el controlador. Los grupos antiguos se borran.
© 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.
