En esta página

Qt3DAnimation::QAnimationController Class

class Qt3DAnimation::QAnimationController

Una clase de controlador para animaciones. Más información...

Encabezado: #include <qanimationcontroller.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3danimation)
target_link_libraries(mytarget PRIVATE Qt6::3danimation)
qmake: QT += 3danimation
En QML: AnimationController
Heredado de: QObject
Estado: Versión preliminar

Esta clase se encuentra en fase de vista previa tecnológica y está sujeta a cambios.

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 La clase controla la selección y reproducción de animaciones. La clase se puede utilizar para buscar todas las animaciones del árbol Qt3DCore::QEntity y crear un objeto ` QAnimationGroups ` 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

Contiene el grupo de animación actualmente activo.

Funciones de acceso:

int activeAnimationGroup() const
void setActiveAnimationGroup(int index)

Señal de notificación:

void activeAnimationGroupChanged(int index)

entity : Qt3DCore::QEntity*

Almacena la entidad de la que se recopilan y agrupan las animaciones. Si el controlador ya contiene animaciones, estas se borran.

Funciones de acceso:

Qt3DCore::QEntity *entity() const
void setEntity(Qt3DCore::QEntity *entity)

Señal de notificador:

void entityChanged(Qt3DCore::QEntity *entity)

position : float

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.

Funciones de acceso:

float position() const
void setPosition(float position)

Señal de notificación:

void positionChanged(float position)

positionOffset : float

Almacena el desplazamiento de posición de la animación.

Funciones de acceso:

float positionOffset() const
void setPositionOffset(float offset)

Señal de notificación:

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 de notificación:

void positionScaleChanged(float scale)

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.

Funciones de acceso:

bool recursive() const
void setRecursive(bool recursive)

Señal del notificador:

void recursiveChanged(bool recursive)

Documentación de las funciones de miembro

QAnimationController::QAnimationController(QObject *parent = nullptr)

Crea un nuevo `QAnimationController` con ` parent`.

void QAnimationController::addAnimationGroup(Qt3DAnimation::QAnimationGroup *animationGroup)

Añade el « animationGroup » indicado al controlador.

QList<Qt3DAnimation::QAnimationGroup *> QAnimationController::animationGroupList()

Devuelve la lista de grupos de animación que el controlador tiene actualmente.

[invokable] int QAnimationController::getAnimationIndex(const QString &name) const

Devuelve el índice de la animación con ` name`. Devuelve -1 si no se encuentra ninguna animación ` AnimationGroup ` con el nombre indicado.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] Qt3DAnimation::QAnimationGroup *QAnimationController::getGroup(int index) const

Devuelve el objeto « AnimationGroup » con el « index » indicado.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

void QAnimationController::removeAnimationGroup(Qt3DAnimation::QAnimationGroup *animationGroup)

Elimina el « animationGroup » indicado del controlador.

void QAnimationController::setAnimationGroups(const QList<Qt3DAnimation::QAnimationGroup *> &animationGroups)

Establece el grupo « animationGroups » para el controlador. Se borran los grupos anteriores.

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