En esta página

Qt3DAnimation::QKeyframeAnimation Class

class Qt3DAnimation::QKeyframeAnimation

Una clase que implementa una animación sencilla con fotogramas clave en QTransform. Más...

Encabezado: #include <qkeyframeanimation.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3danimation)
target_link_libraries(mytarget PRIVATE Qt6::3danimation)
qmake: QT += 3danimation
En QML: KeyframeAnimation
Heredado de: Qt3DAnimation::QAbstractAnimation
Estado: Versión preliminar

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

Tipos públicos

enum RepeatMode { None, Constant, Repeat }

Propiedades

Funciones públicas

QKeyframeAnimation(QObject *parent = nullptr)
void addKeyframe(Qt3DCore::QTransform *keyframe)
QEasingCurve easing() const
Qt3DAnimation::QKeyframeAnimation::RepeatMode endMode() const
QList<float> framePositions() const
QList<Qt3DCore::QTransform *> keyframeList() const
void removeKeyframe(Qt3DCore::QTransform *keyframe)
void setKeyframes(const QList<Qt3DCore::QTransform *> &keyframes)
Qt3DAnimation::QKeyframeAnimation::RepeatMode startMode() const
Qt3DCore::QTransform *target() const
QString targetName() const

Ranuras públicas

void setEasing(const QEasingCurve &easing)
void setEndMode(Qt3DAnimation::QKeyframeAnimation::RepeatMode mode)
void setFramePositions(const QList<float> &positions)
void setStartMode(Qt3DAnimation::QKeyframeAnimation::RepeatMode mode)
void setTarget(Qt3DCore::QTransform *target)
void setTargetName(const QString &name)

Señales

void easingChanged(const QEasingCurve &easing)
void endModeChanged(Qt3DAnimation::QKeyframeAnimation::RepeatMode endMode)
void framePositionsChanged(const QList<float> &positions)
void startModeChanged(Qt3DAnimation::QKeyframeAnimation::RepeatMode startMode)
void targetChanged(Qt3DCore::QTransform *target)
void targetNameChanged(const QString &name)

Descripción detallada

Una clase « Qt3DAnimation::QKeyframeAnimation » implementa una animación sencilla basada en fotogramas clave que se puede utilizar para animar QTransform. Los fotogramas clave consisten en múltiples QTransforms temporizados, que se interpolan y se aplican al objetivo QTransform. Se utiliza QEasingCurve entre fotogramas clave para controlar el interpolador. Se puede establecer RepeatMode para cuando la posición establecida en QKeyframeAnimation esté por debajo o por encima de los valores definidos en las posiciones de los fotogramas clave.

Documentación de los tipos de miembros

enum QKeyframeAnimation::RepeatMode

Esta enumeración especifica cómo se gestionan los valores de posición que no corresponden a fotogramas clave.

ConstanteValorDescripción
Qt3DAnimation::QKeyframeAnimation::None0La animación no se aplica a la transformación de destino.
Qt3DAnimation::QKeyframeAnimation::Constant1Se utiliza el valor del fotograma clave limítrofe.
Qt3DAnimation::QKeyframeAnimation::Repeat2La animación se repite.

Documentación de la propiedad

easing : QEasingCurve

Almacena la curva de suavizado del interpolador entre fotogramas clave.

Funciones de acceso:

QEasingCurve easing() const
void setEasing(const QEasingCurve &easing)

Señal de notificación:

void easingChanged(const QEasingCurve &easing)

endMode : RepeatMode

Mantiene el modo de repetición para los valores de posición superiores a la posición del último fotograma.

Funciones de acceso:

Qt3DAnimation::QKeyframeAnimation::RepeatMode endMode() const
void setEndMode(Qt3DAnimation::QKeyframeAnimation::RepeatMode mode)

Señal de notificación:

void endModeChanged(Qt3DAnimation::QKeyframeAnimation::RepeatMode endMode)

framePositions : QList<float>

Contiene las posiciones de los fotogramas clave. Cada posición de la lista especifica la posición del fotograma clave correspondiente con el mismo índice. Los valores deben estar ordenados de menor a mayor. Los valores pueden ser positivos o negativos y no tienen ninguna unidad predefinida.

Funciones de acceso:

QList<float> framePositions() const
void setFramePositions(const QList<float> &positions)

Señal de notificación:

void framePositionsChanged(const QList<float> &positions)

startMode : RepeatMode

Mantiene el modo de repetición para los valores de posición inferiores a la posición del primer fotograma.

Funciones de acceso:

Qt3DAnimation::QKeyframeAnimation::RepeatMode startMode() const
void setStartMode(Qt3DAnimation::QKeyframeAnimation::RepeatMode mode)

Señal de notificación:

void startModeChanged(Qt3DAnimation::QKeyframeAnimation::RepeatMode startMode)

target : Qt3DCore::QTransform*

Almacena el objeto de destino ` QTransform ` al que se aplica la animación.

Funciones de acceso:

Qt3DCore::QTransform *target() const
void setTarget(Qt3DCore::QTransform *target)

Señal de notificación:

void targetChanged(Qt3DCore::QTransform *target)

targetName : QString

Contiene el nombre de la transformación de destino. Se trata de una propiedad auxiliar que facilita la correspondencia entre la transformación de destino y la animación de fotogramas clave. El nombre suele ser el mismo que el de la entidad principal de la transformación de destino, aunque no tiene por qué serlo.

Funciones de acceso:

QString targetName() const
void setTargetName(const QString &name)

Señal de notificador:

void targetNameChanged(const QString &name)

Documentación de las funciones de miembro

[explicit] QKeyframeAnimation::QKeyframeAnimation(QObject *parent = nullptr)

Crea un objeto `QKeyframeAnimation` con ` parent`.

void QKeyframeAnimation::addKeyframe(Qt3DCore::QTransform *keyframe)

Añade un nuevo « keyframe » al final de la animación. El « QTransform » se puede añadir a la animación varias veces.

QList<Qt3DCore::QTransform *> QKeyframeAnimation::keyframeList() const

Devuelve la lista de fotogramas clave.

void QKeyframeAnimation::removeKeyframe(Qt3DCore::QTransform *keyframe)

Elimina un « keyframe » de la animación. Si se establece varias veces el mismo « QTransform » como fotograma clave, se eliminan todas las apariciones.

void QKeyframeAnimation::setKeyframes(const QList<Qt3DCore::QTransform *> &keyframes)

Establece el « keyframes » de la animación. Se borran los fotogramas clave anteriores.

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