Qt3DAnimation::QAdditiveClipBlend Class

class Qt3DAnimation::QAdditiveClipBlend

Führt eine additive Überblendung zweier Animationsclips auf der Grundlage eines Additionsfaktors durch. Mehr...

Überschrift:	`#include <qadditiveclipblend.h>`

CMake:	`find_package(Qt6 REQUIRED COMPONENTS 3danimation)` `target_link_libraries(mytarget PRIVATE Qt6::3danimation)`
qmake:	`QT += 3danimation`
In QML:	AdditiveClipBlend
Erbt von:	Qt3DAnimation::QAbstractClipBlendNode
Status:	Technologievorschau

Diese Klasse befindet sich in der Technologievorschau und kann sich noch ändern.

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

additiveClip : Qt3DAnimation::QAbstractClipBlendNode*
additiveFactor : float
baseClip : Qt3DAnimation::QAbstractClipBlendNode*

Ö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)

Ausführliche Beschreibung

QAdditiveClipBlend kann nützlich sein, um komplexe Animationseffekte auf der Grundlage einzelner Animationsclips zu erstellen. Wenn Sie beispielsweise:

die Eigenschaft „ baseClip “ auf einen normalen Laufzyklus-Animationsclip setzen und
die Eigenschaft „ additiveClip “ auf einen Differenzclip für Kopfschütteln setzen,

dann bestimmt die Einstellung der Eigenschaft „ additiveFactor “, in welchem Umfang der Clip „ additiveClip “ dem Clip „ baseClip “ hinzugefügt wird. Dies hat zur Folge, dass bei einem „ additiveFactor “-Wert von Null dieser Blend-Knoten den ursprünglichen Walk-Cycle-Clip liefert. Bei einem „ additiveFactor “-Wert von 1 liefert er den Walk-Cycle-Clip einschließlich einer Kopfschüttel-Animation.

Die von dieser Klasse implementierte Überblendungsoperation lautet:

resultClip = baseClip + additiveFactor * additiveClip

Es spricht nichts dagegen, Werte für die Eigenschaft `additiveFacor` außerhalb des Bereichs von 0 bis 1 zu verwenden, aber bitte beachten Sie, dass die Eingabe-Animationsclips möglicherweise nicht so erstellt wurden, dass dies sinnvoll ist.

Siehe auch QBlendedClipAnimator.

Eigenschaftsdokumentation

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

Legt den Überblendungsfaktor fest, der in der Regel zwischen 0 und 1 liegt, um die Überblendung zweier 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 der Wert „ additiveFactor “ Null ist, entspricht „baseClip“ auch dem resultierenden Clip dieses Blend-Knotens.

Zugriffsfunktionen:

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

Notifier-Signal:

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.