En esta página

BlendedClipAnimator QML Type

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

Import Statement: import Qt3D.Animation 2.12
In C++: QBlendedClipAnimator
Inherits:

AbstractClipAnimator

Status: Technology preview

Este tipo se encuentra en fase de vista previa tecnológica y está sujeto a cambios.

Propiedades

Descripción detallada

Una entidad puede agregar una instancia de BlendedClipAnimator 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 ` ClipAnimator ` obtiene sus datos de animación de un único clip de animación, `BlendedClipAnimator` puede combinar varios clips. Los datos de animación se obtienen evaluando lo que se denomina un «árbol de mezcla». Un «árbol de mezcla» es una estructura jerárquica en la que los nodos hoja son nodos de valor que encapsulan un clip de animación (AbstractAnimationClip); 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 BlendedClipAnimator, configura la propiedad blendTree del animador para que apunte al nodo raíz de tu árbol de mezcla:

BlendedClipAnimator {
    blendTree: AdditiveClipBlend {
        ....
    }
}

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 más tipos de nodos.

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:

BlendedClipAnimator {
    blendTree: AdditiveClipBlend {
        baseClip: LerpClipBlend {
            startClip: ClipBlendValue {
                clip: AnimationClipLoader { source: "walk.json" }
            }

            endClip: ClipBlendValue {
                clip: AnimationClipLoader { source: "run.json" }
            }
        }

        additiveClip: ClipBlendValue {
            clip: AnimationClipLoader { source: "wave-arm.json" }
        }
    }

    channelMapper: ChannelMapper {...}
    running: true
}

Al crear un conjunto de clips de animación y mezclarlos dinámicamente en tiempo de ejecución mediante un árbol de mezcla, se abre un amplio abanico de animaciones posibles. Como ejemplos sencillos del árbol de mezcla anterior, donde «alpha» es el factor aditivo y «beta» es el factor de mezcla lerp, podemos obtener un continuo 2D de animaciones posibles:

(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 : AbstractClipBlendNode

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

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