En esta página

Qt3DAnimation::QBlendedClipAnimator Class

class Qt3DAnimation::QBlendedClipAnimator

QBlendedClipAnimator es un componente que permite reproducir animaciones a partir de un árbol de nodos de mezcla. Más información...

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

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

Propiedades

  • blendTree : Qt3DAnimation::QAbstractClipBlendNode*

Funciones públicas

Qt3DAnimation::QAbstractClipBlendNode *blendTree() const

Ranuras públicas

void setBlendTree(Qt3DAnimation::QAbstractClipBlendNode *blendTree)

Señales

void blendTreeChanged(Qt3DAnimation::QAbstractClipBlendNode *blendTree)

Descripción detallada

Una instancia de QBlendedClipAnimator puede ser agregada por una QEntity para añadir la capacidad de reproducir clips de animación y aplicar los valores de animación calculados a las propiedades de los QObjects.

Mientras que un ` QClipAnimator ` obtiene sus datos de animación de un único clip de animación, `QBlendedClipAnimator` puede combinar varios clips. Los datos de animación se obtienen evaluando lo que se denomina un «árbol de mezcla». Un «blend tree» es una estructura jerárquica en la que los nodos hoja son nodos de valor que encapsulan un clip de animación (QAbstractAnimationClip); y los nodos internos representan operaciones de mezcla que actúan sobre los nodos a los que apuntan sus propiedades de operando.

Para asociar un árbol de mezcla a un QBlendedClipAnimator, configura la propiedad « blendTree » del animador para que apunte al nodo raíz de tu árbol de mezcla:

auto blendTreeRoot = new QAdditiveClipBlend();
...
auto animator = new QBlendedClipAnimator();
animator->setBlendTree(blendTreeRoot);

Un árbol de mezcla se puede construir a partir de los siguientes tipos de nodos:

Nota: El árbol de nodos de mezcla solo debe editarse cuando el animador no se esté ejecutando.

Con el tiempo se irán añadiendo tipos de nodos adicionales.

A modo de ejemplo, considera el siguiente árbol de mezcla:

Clip0----
        |
        Lerp Node----
        |           |
Clip1----           Additive Node
                    |
            Clip2----

Se puede crear y utilizar de la siguiente manera:

// Create leaf nodes of blend tree
auto clip0 = new QClipBlendValue(
    new QAnimationClipLoader(QUrl::fromLocalFile("walk.json")));
auto clip1 = new QClipBlendValue(
    new QAnimationClipLoader(QUrl::fromLocalFile("run.json")));
auto clip2 = new QClipBlendValue(
    new QAnimationClipLoader(QUrl::fromLocalFile("wave-arm.json")));

// Create blend tree inner nodes
auto lerpNode = new QLerpClipBlend();
lerpNode->setStartClip(clip0);
lerpNode->setEndClip(clip1);
lerpNode->setBlendFactor(0.5f); // Half-walk, half-run

auto additiveNode = new QAdditiveClipBlend();
additiveNode->setBaseClip(lerpNode); // Comes from lerp sub-tree
additiveNode->setAdditiveClip(clip2);
additiveNode->setAdditiveFactor(1.0f); // Wave arm fully

// Run the animator
auto animator = new QBlendedClipAnimator();
animator->setBlendTree(additiveNode);
animator->setChannelMapper(...);
animator->setRunning(true);

Al crear un conjunto de clips de animación y realizar fundidos dinámicos entre ellos en tiempo de ejecución mediante un árbol de fundidos, se abre un amplio abanico de posibles animaciones resultantes. Como ejemplos sencillos del árbol de fundidos anterior, donde alfa es el factor aditivo y beta el factor de fundido lerp, podemos obtener un continuo 2D de posibles animaciones:

(alpha = 0, beta = 1) Running, No arm waving --- (alpha = 1, beta = 1) Running, Arm waving
        |                                               |
        |                                               |
        |                                               |
(alpha = 0, beta = 0) Walking, No arm waving --- (alpha = 0, beta = 1) Running, No arm waving

Los árboles de mezcla más complejos ofrecen aún más flexibilidad a la hora de combinar tus clips de animación. Ten en cuenta que los valores utilizados para controlar el árbol de mezcla (alfa y beta en el ejemplo anterior) son simples propiedades de los nodos de mezcla. Esto significa que estas propiedades también pueden ser controladas por el marco de animación.

Documentación de propiedades

blendTree : Qt3DAnimation::QAbstractClipBlendNode*

Esta propiedad contiene la raíz del árbol de mezcla de animaciones que se evaluará antes de que el animador la interpole.

Funciones de acceso:

Qt3DAnimation::QAbstractClipBlendNode *blendTree() const
void setBlendTree(Qt3DAnimation::QAbstractClipBlendNode *blendTree)

Señal de notificador:

void blendTreeChanged(Qt3DAnimation::QAbstractClipBlendNode *blendTree)

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