Sur cette page

Qt3DAnimation::QAdditiveClipBlend Class

class Qt3DAnimation::QAdditiveClipBlend

Effectue un mélange additif de deux clips d'animation sur la base d'un facteur additif. Plus d'informations...

En-tête : #include <QAdditiveClipBlend>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3danimation)
target_link_libraries(mytarget PRIVATE Qt6::3danimation)
qmake : QT += 3danimation
En QML : AdditiveClipBlend
Hérite : Qt3DAnimation::QAbstractClipBlendNode
Statut : Déclassé

Propriétés

Fonctions publiques

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

Emplacements publics

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

Signaux

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

Description détaillée

QAdditiveClipBlend peut être utile pour créer des effets d'animation avancés basés sur des clips d'animation individuels. Par exemple, si vous :

  • définissez la propriété baseClip à un clip d'animation de cycle de marche normal et
  • définissez la propriété additiveClip à un clip de différence de tête tremblante,

l'ajustement de la propriété additiveFactor contrôlera la quantité de additiveClip ajoutée à baseClip. Ainsi, avec un additiveFactor de zéro, ce nœud de fusion produira le clip de cycle de marche d'origine. Avec un additiveFactor de 1, il produira le cycle de marche avec une animation de tremblement de tête.

L'opération de mélange mise en œuvre par cette classe est la suivante :

resultClip = baseClip + additiveFactor * additiveClip

Rien ne vous empêche d'utiliser des valeurs pour la propriété additiveFacor en dehors de la plage de 0 à 1, mais sachez que les clips d'animation d'entrée peuvent ne pas être créés de manière à ce que cela ait un sens.

Voir également QBlendedClipAnimator.

Documentation sur les propriétés

additiveClip : Qt3DAnimation::QAbstractClipBlendNode*

Cette propriété contient le clip additif à mélanger avec le clip baseClip. L'importance du mélange est contrôlée par la propriété additiveFactor.

Fonctions d'accès :

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

Signal de notification :

void additiveClipChanged(Qt3DAnimation::QAbstractClipBlendNode *additiveClip)

additiveFactor : float

Spécifie le facteur de fusion, généralement compris entre 0 et 1, pour contrôler la fusion de deux clips d'animation.

Fonctions d'accès :

float additiveFactor() const
void setAdditiveFactor(float additiveFactor)

Signal de notification :

void additiveFactorChanged(float additiveFactor)

baseClip : Qt3DAnimation::QAbstractClipBlendNode*

Cette propriété contient le clip d'animation de base. Lorsque additiveFactor est égal à zéro, le clip de base sera également le clip résultant de ce nœud de fusion.

Fonctions d'accès :

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

Signal de notification :

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.