Qt3DAnimation::QAnimationController Class
class Qt3DAnimation::QAnimationControllerUna 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.