En esta página

Qt3DAnimation::QAdditiveClipBlend Class

class Qt3DAnimation::QAdditiveClipBlend

Realiza una mezcla aditiva de dos clips de animación basada en un factor aditivo. Más...

Cabecera: #include <QAdditiveClipBlend>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3danimation)
target_link_libraries(mytarget PRIVATE Qt6::3danimation)
qmake: QT += 3danimation
En QML: AdditiveClipBlend
Hereda: Qt3DAnimation::QAbstractClipBlendNode
Status: Obsoleto

Propiedades

Funciones públicas

Qt3DAnimation::QAbstractClipBlendNode *additiveClip() const
float additiveFactor() const
Qt3DAnimation::QAbstractClipBlendNode *baseClip() const

Ranuras públicas

void setAdditiveClip(Qt3DAnimation::QAbstractClipBlendNode *additiveClip)
void setAdditiveFactor(float additiveFactor)
void setBaseClip(Qt3DAnimation::QAbstractClipBlendNode *baseClip)

Señales

void additiveClipChanged(Qt3DAnimation::QAbstractClipBlendNode *additiveClip)
void additiveFactorChanged(float additiveFactor)
void baseClipChanged(Qt3DAnimation::QAbstractClipBlendNode *baseClip)

Descripción Detallada

QAdditiveClipBlend puede ser útil para crear efectos de animación avanzados basados en clips de animación individuales. Por ejemplo, si

  • estableces la propiedad baseClip a un clip de animación de ciclo de paseo normal y
  • estableces la propiedad additiveClip a un clip de diferencia de cabeza temblorosa,

entonces ajustando la propiedad additiveFactor controlará cuánto de additiveClip se añade a baseClip. Esto tiene el efecto de que con un additiveFactor de cero, este nodo de mezcla producirá el clip de ciclo de paseo original. Con un additiveFactor de 1, producirá el ciclo de paseo incluyendo una animación de cabeza temblorosa.

La operación de mezcla implementada por esta clase es:

resultClip = baseClip + additiveFactor * additiveClip

No hay nada que le impida utilizar valores para la propiedad additiveFacor fuera del rango de 0 a 1, pero tenga en cuenta que los clips de animación de entrada pueden no estar creados de tal manera que esto tenga sentido.

Véase también QBlendedClipAnimator.

Documentación de la propiedad

additiveClip : Qt3DAnimation::QAbstractClipBlendNode*

Esta propiedad contiene el clip aditivo que se mezclará con baseClip. La cantidad de mezcla se controla mediante la propiedad additiveFactor.

Funciones de acceso:

Qt3DAnimation::QAbstractClipBlendNode *additiveClip() const
void setAdditiveClip(Qt3DAnimation::QAbstractClipBlendNode *additiveClip)

Señal del notificador:

void additiveClipChanged(Qt3DAnimation::QAbstractClipBlendNode *additiveClip)

additiveFactor : float

Especifica el factor de mezcla, normalmente entre 0 y 1, para controlar la mezcla de dos clips de animación.

Funciones de acceso:

float additiveFactor() const
void setAdditiveFactor(float additiveFactor)

Señal notificadora:

void additiveFactorChanged(float additiveFactor)

baseClip : Qt3DAnimation::QAbstractClipBlendNode*

Esta propiedad contiene el clip base de la animación. Cuando additiveFactor es cero el baseClip será también el clip resultante de este nodo de mezcla.

Funciones de acceso:

Qt3DAnimation::QAbstractClipBlendNode *baseClip() const
void setBaseClip(Qt3DAnimation::QAbstractClipBlendNode *baseClip)

Señal del notificador:

void baseClipChanged(Qt3DAnimation::QAbstractClipBlendNode *baseClip)

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