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
Una clase base abstracta para animaciones Qt3D | |
La clase base para los tipos que proporcionan datos de animación de fotogramas clave | |
La clase base para los tipos que proporcionan capacidades de reproducción de animaciones | |
La clase base para los tipos utilizados para construir árboles de mezcla de animaciones | |
Realiza una mezcla aditiva de dos clips de animación basada en un factor aditivo | |
Proporciona capacidades de animación con fotogramas clave a Qt 3D | |
Representa un objeto de devolución de llamada de animación | |
Especifica datos de animación de fotogramas clave | |
Clase que contiene los datos de animación | |
Permite cargar datos de animación con fotogramas clave desde un archivo | |
Una clase controladora para animaciones | |
Una clase que agrupa animaciones | |
Componente que proporciona capacidades de reproducción de animaciones de un árbol de nodos de mezcla | |
Permite asignar los canales del clip a una invocación de un objeto de devolución de llamada | |
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 | |
Permite asignar los canales del clip a las propiedades de los objetos de la aplicación | |
Permite asignar los canales del clip a las propiedades de los objetos de la aplicación | |
Componente que proporciona funciones básicas de reproducción de animaciones | |
Clase utilizada para incluir un clip en un árbol de mezcla | |
Una clase base para gestionar fotogramas clave | |
Clase que implementa una animación sencilla con fotogramas clave para un QTransform | |
Realiza una interpolación lineal de dos clips de animación basada en un factor normalizado | |
Una clase que proporciona objetivos de transformación a la animación de formas de mezcla | |
Clase que implementa animación de morphing con formas de mezcla | |
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 += 3danimationLas 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.