En esta página

Qt3DAnimation::QAbstractAnimationClip Class

class Qt3DAnimation::QAbstractAnimationClip

QAbstractAnimationClip es la clase base para los tipos que proporcionan datos de animación de fotogramas clave. Más...

Cabecera: #include <QAbstractAnimationClip>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3danimation)
target_link_libraries(mytarget PRIVATE Qt6::3danimation)
qmake: QT += 3danimation
Hereda: Qt3DCore::QNode
Heredado por:

Qt3DAnimation::QAnimationClip y Qt3DAnimation::QAnimationClipLoader

Estado: Deprecated

Propiedades

Funciones públicas

virtual ~QAbstractAnimationClip()
float duration() const

Señales

void durationChanged(float duration)

Descripción detallada

Para utilizar el marco de animación de fotogramas clave en el módulo Qt 3D Animation es necesario proporcionar al componente animador en uso los datos de animación de fotogramas clave. Los datos de animación son proporcionados por una de las subclases concretas de QAbstractAnimationClip:

QAnimationClip se debe utilizar cuando se desea crear los datos de animación mediante programación dentro de la aplicación. Los datos reales se establecen con un tipo de valor QAnimationClipData.

Si estas cargando los datos de la animación desde un archivo, por ejemplo creado por un artista, entonces usa la clase QAnimationClipLoader y establece su propiedad source.

Una vez que el clip de animación ha sido rellenado con datos usando los métodos anteriores, la propiedad de duración de sólo lectura será actualizada por el backend Qt 3D Animation.

El uso típico de los clips de animación es:

auto animator = new QClipAnimator();
auto clip = new QAnimationClipLoader();
clip->setSource(QUrl::fromLocalFile("bounce.json"));
animator->setClip(clip);
animator->setChannelMapper(...);
animator->setRunning(true);

Los clips de animación también se utilizan como los valores del nodo hoja en los árboles de mezcla de animación:

// Create leaf nodes of blend tree
auto slideClipValue = new QClipBlendValue(
    new QAnimationClipLoader(QUrl::fromLocalFile("slide.json")));
auto bounceClipValue = new QClipBlendValue(
    new QAnimationClipLoader(QUrl::fromLocalFile("bounce.json")));

// Create blend tree inner node
auto additiveNode = new QAdditiveClipBlend();
additiveNode->setBaseClip(slideClipValue);
additiveNode->setAdditiveClip(bounceClipValue);
additiveNode->setAdditiveFactor(0.5f);

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

Ver también Qt3DAnimation::QAnimationClip y Qt3DAnimation::QAnimationClipLoader.

Documentación de propiedades

[read-only] duration : float

Contiene la duración del clip de animación en segundos. Se actualiza una vez que los datos de la animación se proporcionan a Qt 3D utilizando una de las subclases concretas.

Funciones de acceso:

float duration() const

Señal del notificador:

void durationChanged(float duration)

Documentación de la función miembro

[virtual noexcept] QAbstractAnimationClip::~QAbstractAnimationClip()

Destruye este clip de animación.

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