En esta página

Qt3DAnimation::QAdditiveClipBlend Class

class Qt3DAnimation::QAdditiveClipBlend

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

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

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

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 resultar útil para crear efectos de animación avanzados basados en clips de animación individuales. Por ejemplo, si:

  • estableces la propiedad « baseClip » en un clip de animación de ciclo de marcha normal y
  • estableces la propiedad « additiveClip » en un clip de diferencia de movimiento de cabeza sacudiéndose,

al ajustar la propiedad « additiveFactor » controlarás la cantidad de « additiveClip » que se añade a « baseClip ». Esto tiene como efecto que, con un « additiveFactor » de cero, este nodo de mezcla producirá el clip original del ciclo de marcha. Con un « additiveFactor » de 1, producirá el ciclo de marcha incluyendo una animación de movimiento de cabeza.

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

resultClip = baseClip + additiveFactor * additiveClip

No hay nada que te impida utilizar valores para la propiedad «additiveFacor» fuera del rango de 0 a 1, pero ten en cuenta que es posible que los clips de animación de entrada no estén creados de tal forma 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 va a mezclar con el « baseClip ». El grado de mezcla se controla mediante la propiedad « additiveFactor ».

Funciones de acceso:

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

Señal de notificación:

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 de notificación:

void additiveFactorChanged(float additiveFactor)

baseClip : Qt3DAnimation::QAbstractClipBlendNode*

Esta propiedad contiene el clip de animación base. Cuando el valor de « 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 de notificación:

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.