En esta página

Qt 3D Animation C++ Classes

Los módulos de animación de Qt 3D ofrecen un conjunto de elementos predefinidos que te ayudarán a dar tus primeros pasos con Qt 3D. Más información...

Este módulo ha quedado obsoleto desde la versión 6.8. Recomendamos encarecidamente no utilizarlo en código nuevo.

Espacios de nombres

Clases

Qt3DAnimation::QAbstractAnimation

Una clase base abstracta para animaciones Qt3D

Qt3DAnimation::QAbstractAnimationClip

La clase base para los tipos que proporcionan datos de animación de fotogramas clave

Qt3DAnimation::QAbstractClipAnimator

La clase base para los tipos que proporcionan capacidades de reproducción de animaciones

Qt3DAnimation::QAbstractClipBlendNode

La clase base para los tipos utilizados para construir árboles de mezcla de animaciones

Qt3DAnimation::QAdditiveClipBlend

Realiza una mezcla aditiva de dos clips de animación basada en un factor aditivo

Qt3DAnimation::QAnimationAspect

Proporciona capacidades de animación con fotogramas clave a Qt 3D

Qt3DAnimation::QAnimationCallback

Representa un objeto de devolución de llamada de animación

Qt3DAnimation::QAnimationClip

Especifica datos de animación de fotogramas clave

Qt3DAnimation::QAnimationClipData

Clase que contiene los datos de animación

Qt3DAnimation::QAnimationClipLoader

Permite cargar datos de animación con fotogramas clave desde un archivo

Qt3DAnimation::QAnimationController

Una clase controladora para animaciones

Qt3DAnimation::QAnimationGroup

Una clase que agrupa animaciones

Qt3DAnimation::QBlendedClipAnimator

Componente que proporciona capacidades de reproducción de animaciones de un árbol de nodos de mezcla

Qt3DAnimation::QCallbackMapping

Permite asignar los canales del clip a una invocación de un objeto de devolución de llamada

Qt3DAnimation::QChannel

Define un canal para un QAnimationClipData. El sistema de animación interpola cada componente de canal de forma independiente, salvo en el caso de que el QChannel se denomine «Rotation» (distingue entre mayúsculas y minúsculas), en cuyo caso cuenta con cuatro QChannelComponents y el mismo número de fotogramas clave para cada QChannelComponent. En ese caso, la interpolación se realizará mediante SLERP

Qt3DAnimation::QChannelMapper

Permite asignar los canales del clip a las propiedades de los objetos de la aplicación

Qt3DAnimation::QChannelMapping

Permite asignar los canales del clip a las propiedades de los objetos de la aplicación

Qt3DAnimation::QClipAnimator

Componente que proporciona funciones básicas de reproducción de animaciones

Qt3DAnimation::QClipBlendValue

Clase utilizada para incluir un clip en un árbol de mezcla

Qt3DAnimation::QKeyFrame

Una clase base para gestionar fotogramas clave

Qt3DAnimation::QKeyframeAnimation

Clase que implementa una animación sencilla con fotogramas clave para un QTransform

Qt3DAnimation::QLerpClipBlend

Realiza una interpolación lineal de dos clips de animación basada en un factor normalizado

Qt3DAnimation::QMorphTarget

Una clase que proporciona objetivos de transformación a la animación de formas de mezcla

Qt3DAnimation::QMorphingAnimation

Clase que implementa animación de morphing con formas de mezcla

Qt3DAnimation::QVertexBlendAnimation

Una clase que implementa animación de morphing por mezcla de vértices

Descripción detallada

Este módulo aún se encuentra en fase de desarrollo, pero está disponible como vista previa tecnológica. Esto significa que es inestable, susceptible de sufrir cambios y se ofrece únicamente a título informativo.

#include <Qt3DAnimation>

Para vincularlo a la biblioteca C++ correspondiente, añade lo siguiente a tu archivo de proyecto qmake:

QT += 3danimation

Las clases, los tipos y las funciones se declaran bajo el espacio de nombres Qt3DAnimation.

Descripción general

El módulo de animación de Qt 3D añade soporte para especificar y utilizar animaciones que se pueden aplicar a las propiedades de los objetos de tu simulación. Inicialmente, este módulo admite animaciones basadas en fotogramas clave. Es decir, las propiedades tienen valores «fijados» en determinados momentos y, al reproducirlas, los valores de las propiedades se calculan mediante la interpolación entre los valores conocidos dentro de los fotogramas clave. Toda la evaluación de animaciones dentro del módulo de animación « Qt 3D » tiene lugar en el grupo de subprocesos « Qt 3D ». Esto permite que las animaciones se ejecuten con fluidez y se puedan escalar hasta alcanzar un alto rendimiento.

Datos de animación

Los datos de animación de fotogramas clave pueden crearse mediante programación a través de las API de animación de Qt 3D, como Qt3DAnimation::QKeyFrameData, o bien proceder de herramientas de creación de contenido digital (DCC) como Blender, Maya o 3D Studio Max. Qt 3D proporciona un script de exportación de ejemplo para datos de animación desde Blender. El formato que utiliza actualmente la animación de Qt 3D es un formato sencillo basado en JSON. Esto permite tanto a los desarrolladores como a los artistas trabajar fácilmente con los datos de animación. Más adelante se añadirán otros formatos optimizados para su uso en tiempo de ejecución.

Los datos de animación de fotogramas clave se pueden cargar desde un archivo utilizando la clase ` Qt3DAnimation::QAnimationClipLoader `. Para especificar los datos de animación mediante programación, utilice la clase ` Qt3DAnimation::QAnimationClip `.

Por defecto, los datos de fotogramas clave se especifican mediante curvas Bézier cúbicas. Esto permite crear animaciones fluidas a partir de un número reducido de puntos de datos de fotogramas clave. Más adelante se añadirán otros tipos de interpolación.

Reproducción de animaciones

Además de los datos de animación que contienen los fotogramas clave, Qt 3D Animation también proporciona API para reproducir las animaciones y asignar los valores de propiedad resultantes a las propiedades de los objetos de la simulación. Actualmente hay dos formas de reproducir las animaciones:

Ambas están implementadas como subclases de ` Qt3DCore::QComponent `, lo que significa que los objetos de estos tipos pueden ser agregados por objetos ` Qt3DCore::QEntity ` para añadir capacidades de animación a las entidades simuladas.

Reproducción sencilla de animaciones

La clase ` Qt3DAnimation::QClipAnimator ` permite la reproducción de un único ` Qt3DAnimation::QAbstractAnimationClip ` a la vez. Para añadir una animación a una entidad, basta con añadir una instancia de la clase ` Qt3DAnimation::QClipAnimator ` a la propiedad ` components ` de la entidad.

El módulo de animación de Qt 3D adopta un enfoque ligeramente diferente al de QPropertyAnimation y AbstractAnimation. En esos marcos de animación, la animación especifica tanto los valores de animación como los objetos y propiedades de destino. Los componentes de animación de Qt 3D separan estos dos conceptos ortogonales. Por ejemplo, el componente Qt3DAnimation::QClipAnimator tiene una propiedad clip para especificar los datos de animación (Qt3DAnimation::QAnimationClip o Qt3DAnimation::QAnimationClipLoader).

Esto permite calcular los valores animados, pero se necesita más información para asignar dichos valores a las propiedades de los objetos. Esto se consigue mediante el objeto « Qt3DAnimation::QChannelMapper », que contiene una lista de objetos « Qt3DAnimation::QChannelMapping ». Se utiliza un « Qt3DAnimation::QChannelMapping » para asignar un canal específico de un clip de animación a una propiedad con nombre de un objeto de destino. Al separar de esta forma los datos de animación y las asignaciones de propiedades, se puede aplicar la misma animación a muchos objetos sin necesidad de tener múltiples copias de los datos de animación ni de los objetos. También permite reasignar fácilmente los datos de animación a otros objetos.

Reproducción de animaciones combinadas

El componente « Qt3DAnimation::QBlendedClipAnimator » permite ir más allá de lo que es posible con « Qt3DAnimation::QClipAnimator » al mezclar varios clips de animación antes de aplicar los cambios de propiedad a las propiedades de destino. El componente «animator» sigue utilizando un «channel mapper», al igual que el componente estándar « Qt3DAnimation::QClipAnimator ». Sin embargo, en lugar de especificar un único clip de animación, es necesario configurar la propiedad « blendTree » para que apunte al nodo raíz de un árbol de mezcla.

Un árbol de mezcla es una estructura de datos que representa cómo se agregan o se mezclan los clips de animación en función de las propiedades de los nodos del árbol de mezcla. El conjunto de nodos de árbol de mezcla admitidos actualmente es el siguiente:

Las entradas de los clips de animación de origen se especifican como nodos hoja en el árbol de mezcla utilizando instancias de la clase Qt3DAnimation::QClipBlendValue. Estos clips de animación pueden combinarse de numerosas formas. Por el momento, el módulo de animación de Qt3D ofrece interpolación lineal (LERP) y operaciones de mezcla aditiva. Con el tiempo se añadirán más tipos de nodos de mezcla. Se espera que estos incluyan, como mínimo, un nodo LERP generalizado y un nodo LERP baricéntrico.

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

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

Supongamos que « Clip0 » representa un ciclo de animación de marcha con una duración de 3 segundos y que « Clip1 » es un ciclo de animación de carrera con una duración de 2 segundos. Ambos son entradas (y dependencias) del nodo de mezcla « Lerp ». El resultado de evaluar el nodo Lerp depende de la propiedad blendFactor del nodo Lerp. Esta podría estar vinculada, por ejemplo, a la velocidad de un personaje humanoide. A medida que aumenta la velocidad del personaje, la animación pasa gradualmente de la animación de caminar en Clip0 a la animación de correr en Clip1.

Además, supongamos que Clip2 representa alguna animación de variación que se puede añadir (agitar los brazos o sacudir la cabeza, por ejemplo). La cantidad de este clip adicional que se añade se puede controlar mediante la propiedad « additiveFactor » del nodo de mezcla Additive.

Al evaluar un árbol de mezcla, se utiliza el tiempo normalizado (o fase) para que los clips de diferentes duraciones puedan mezclarse sin problemas. Por ejemplo, aunque los clips de animación de caminar y correr tengan duraciones diferentes, siempre que el animador los haya creado de tal forma que las pisadas coincidan en la misma fase, estos pueden interpolarse correctamente.

Esto implica que la duración del clip fusionado es, en realidad, una función de los factores de fusión de los nodos del árbol. Si nos centramos únicamente en el nodo « Lerp » del ejemplo anterior, cuando el factor de fusión del nodo « Lerp » es 0, solo se utiliza la animación de «walk» del Clip0, lo que da como resultado una duración de 3 segundos. Con un factor de mezcla de 1, la duración resultante será de 2 segundos. Para factores de mezcla intermedios, la duración se interpolará linealmente entre 3 y 2 segundos.

Al definir tus propios árboles de mezcla, tienes un control total sobre cómo combinar tu colección de clips de animación de entrada. El árbol de mezcla se puede configurar mediante las propiedades de los nodos de mezcla. Ten en cuenta también que las propiedades de los propios nodos de mezcla son simplemente propiedades estándar, por lo que, si se desea, estas podrían a su vez ser controladas por otras animaciones.

Referencia

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