QAdditiveClipBlend Class

class Qt3DAnimation::QAdditiveClipBlend

Führt eine additive Überblendung von zwei Animationsclips auf der Grundlage eines additiven Faktors durch. Mehr...

Kopfzeile: #include <QAdditiveClipBlend>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3danimation)
target_link_libraries(mytarget PRIVATE Qt6::3danimation)
qmake: QT += 3danimation
In QML: AdditiveClipBlend
Vererbt: Qt3DAnimation::QAbstractClipBlendNode
Status: Veraltet

Eigenschaften

Öffentliche Funktionen

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

Öffentliche Slots

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

Signale

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

Detaillierte Beschreibung

QAdditiveClipBlend kann nützlich sein, um fortgeschrittene Animationseffekte basierend auf einzelnen Animationsclips zu erstellen. Zum Beispiel, wenn Sie:

  • die Eigenschaft baseClip auf einen normalen Gehzyklus-Animationsclip setzen und
  • die Eigenschaft additiveClip auf einen Clip mit schüttelndem Kopf einstellen,

dann steuert die Anpassung der Eigenschaft additiveFactor, wie viel von additiveClip zu baseClip hinzugefügt wird. Dies hat den Effekt, dass bei einem additiveFactor von Null dieser Mischknoten den ursprünglichen Gehzyklus-Clip ergibt. Bei einem Wert von additiveFactor von 1 wird der Gehzyklus einschließlich einer Kopfschüttelanimation wiedergegeben.

Die von dieser Klasse implementierte Überblendungsoperation ist:

resultClip = baseClip + additiveFactor * additiveClip

Nichts hindert Sie daran, Werte für die Eigenschaft additiveFacor außerhalb des Bereichs von 0 bis 1 zu verwenden, aber bitte beachten Sie, dass die eingegebenen Animationsclips möglicherweise nicht so verfasst sind, dass dies sinnvoll ist.

Siehe auch QBlendedClipAnimator.

Dokumentation der Eigenschaft

additiveClip : Qt3DAnimation::QAbstractClipBlendNode*

Diese Eigenschaft enthält den additiven Clip, der mit dem baseClip überblendet werden soll. Der Grad der Überblendung wird durch die Eigenschaft additiveFactor gesteuert.

Zugriffsfunktionen:

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

Benachrichtigungssignal:

void additiveClipChanged(Qt3DAnimation::QAbstractClipBlendNode *additiveClip)

additiveFactor : float

Gibt den Überblendungsfaktor an, der normalerweise zwischen 0 und 1 liegt, um die Überblendung von zwei Animationsclips zu steuern.

Zugriffsfunktionen:

float additiveFactor() const
void setAdditiveFactor(float additiveFactor)

Benachrichtigungssignal:

void additiveFactorChanged(float additiveFactor)

baseClip : Qt3DAnimation::QAbstractClipBlendNode*

Diese Eigenschaft enthält den Basis-Animationsclip. Wenn additiveFactor Null ist, ist der baseClip auch der resultierende Clip dieses Blend Nodes.

Zugriffsfunktionen:

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

Benachrichtigungssignal:

void baseClipChanged(Qt3DAnimation::QAbstractClipBlendNode *baseClip)

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