Sur cette page

Qt3DAnimation::QAdditiveClipBlend Class

class Qt3DAnimation::QAdditiveClipBlend

Effectue un mélange additif de deux clips d'animation en fonction d'un facteur additif. En savoir plus...

En-tête : #include <qadditiveclipblend.h>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3danimation)
target_link_libraries(mytarget PRIVATE Qt6::3danimation)
qmake : QT += 3danimation
En QML : AdditiveClipBlend
Hérite de : Qt3DAnimation::QAbstractClipBlendNode
Statut : Aperçu technologique

Cette classe est en avant-première technologique et est susceptible d'être modifiée.

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 s'avérer utile pour créer des effets d'animation avancés à partir de clips d'animation individuels. Par exemple, si vous :

  • définissez la propriété « baseClip » sur un clip d’animation de cycle de marche normal et
  • définissez la propriété ` additiveClip ` sur un clip de différence représentant un mouvement de tête,

alors le réglage de la propriété « additiveFactor » permettra de contrôler la part de l’ additiveClip qui sera ajoutée à l’ baseClip. Cela a pour effet que, avec une additiveFactor de zéro, ce nœud de fusion produira le clip du cycle de marche d’origine. Avec une additiveFactor de 1, il produira le cycle de marche incluant une animation de hochement de tête.

L'opération de fusion 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 l’intervalle compris entre 0 et 1, mais sachez que les clips d’animation d’entrée ne sont peut-être pas conçus de manière à ce que cela ait un sens.

Voir également QBlendedClipAnimator.

Documentation des propriétés

additiveClip : Qt3DAnimation::QAbstractClipBlendNode*

Cette propriété contient le clip additif à fusionner avec l'baseClip. L'intensité de la fusion 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

Définit le facteur de fusion, généralement compris entre 0 et 1, permettant de 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 la valeur de l'additiveFactor est égale à zéro, le clip de base correspondra également au 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.