En esta página

Qt3DAnimation::QAbstractAnimationClip Class

class Qt3DAnimation::QAbstractAnimationClip

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

Encabezado: #include <qabstractanimationclip.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3danimation)
target_link_libraries(mytarget PRIVATE Qt6::3danimation)
qmake: QT += 3danimation
Heredado de: Qt3DCore::QNode
Heredado por:

Qt3DAnimation::QAnimationClip y Qt3DAnimation::QAnimationClipLoader

Estado: Versión preliminar

Esta clase se encuentra en fase de vista previa tecnológica y está sujeta a cambios.

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 por fotogramas clave del módulo de animación de Qt 3D, es necesario proporcionar al componente de animación que se esté utilizando los datos de animación por fotogramas clave. Los datos de animación los proporciona una de las subclases concretas de QAbstractAnimationClip:

QAnimationClip debe utilizarse cuando se desee 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 se cargan datos de animación predefinidos desde un archivo, por ejemplo, creados por un artista, se debe utilizar la clase ` QAnimationClipLoader ` y establecer su propiedad ` source `.

Una vez que el clip de animación se haya rellenado con datos utilizando los métodos anteriores, la propiedad «duration», de solo lectura, se actualizará mediante el backend de animación « Qt 3D ».

El uso habitual de los clips de animación es el siguiente:

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 valores de los nodos finales en los árboles de mezcla de animaciones:

// 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);

Véase también Qt3DAnimation::QAnimationClip y Qt3DAnimation::QAnimationClipLoader.

Documentación de propiedades

[read-only] duration : float

Almacena la duración del clip de animación en segundos. Se actualiza una vez que se proporcionan los datos de animación 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 funciones de miembro

[virtual noexcept] QAbstractAnimationClip::~QAbstractAnimationClip()

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