Qt3DAnimation::QBlendedClipAnimator Class

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 propiedades de QObjects.

Mientras que un QClipAnimator obtiene sus datos de animación de un único clip de animación, QBlendedClipAnimator puede mezclar múltiples clips. Los datos de animación se obtienen evaluando el llamado árbol de mezcla. Un árbol de mezcla es una estructura de árbol jerárquica en la que los nodos de hoja son nodos de valor que encapsulan un clip de animación (QAbstractAnimationClip); y los nodos internos representan operaciones de mezcla que operan sobre los nodos señalados por sus propiedades operando.

Para asociar un árbol de mezcla con un QBlendedClipAnimator, establezca la propiedad blendTree del animador para que apunte al nodo raíz de su árbol de mezcla:

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

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

• Qt3DAnimation::QClipBlendValue
• Qt3DAnimation::QLerpClipBlend
• Qt3DAnimation::QAdditiveClipBlend

Con el tiempo se añadirán nuevos tipos de nodos.

Como ejemplo, considere 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 mezclar entre ellos dinámicamente en tiempo de ejecución con un árbol de mezcla, abrimos un enorme conjunto de posibles animaciones resultantes. Como ejemplos sencillos del árbol de mezcla anterior, donde alfa es el factor aditivo y beta es el factor de mezcla 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 para combinar tus clips de animación. Ten en cuenta que los valores utilizados para controlar el árbol de mezcla (alfa y beta) son simples propiedades de los nodos de mezcla. Esto significa que estas propiedades también pueden ser controladas por la estructura de animación.