QAdditiveClipBlend Class

( Qt3DAnimation::QAdditiveClipBlend )

Performs an additive blend of two animation clips based on an additive factor. 更多...

頭: #include <QAdditiveClipBlend>
qmake: QT += 3danimation
Since: Qt 5.9
實例化: AdditiveClipBlend
繼承: Qt3DAnimation::QAbstractClipBlendNode

特性

公共函數

QAdditiveClipBlend (Qt3DCore::QNode * parent = nullptr)
~QAdditiveClipBlend ()
Qt3DAnimation::QAbstractClipBlendNode * additiveClip () const
float additiveFactor () const
Qt3DAnimation::QAbstractClipBlendNode * baseClip () const

公共槽

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

信號

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

保護函數

QAdditiveClipBlend (QAdditiveClipBlendPrivate & dd , Qt3DCore::QNode * parent = nullptr)

額外繼承成員

詳細描述

Performs an additive blend of two animation clips based on an additive factor.

QAdditiveClipBlend can be useful to create advanced animation effects based on individual animation clips. For example, if you:

  • 設置 baseClip property to a normal walk cycle animation clip and
  • 設置 additiveClip property to a shaking head difference clip,

then adjusting the additiveFactor property will control how much of the additiveClip gets added on to the baseClip . This has he effect that with an additiveFactor of zero, this blend node will yield the original walk cycle clip. With an additiveFactor of 1, it will yield the walk cycle including a shaking head animation.

The blending operation implemented by this class is:

resultClip = baseClip + additiveFactor * additiveClip
					

There is nothing stopping you from using values for the additiveFacor property outside the 0 to 1 range, but please be aware that the input animation clips may not be authored in such a way for this to make sense.

另請參閱 QBlendedClipAnimator .

特性文檔編製

additiveClip : Qt3DAnimation::QAbstractClipBlendNode *

This property holds the additive clip to be blended with the baseClip . The amount of blending is controlled by the additiveFactor 特性。

訪問函數:

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

通知程序信號:

void additiveClipChanged (Qt3DAnimation::QAbstractClipBlendNode * additiveClip )

additiveFactor : float

Specifies the blending factor, typically between 0 and 1, to control the blending of two animation clips.

訪問函數:

float additiveFactor () const
void setAdditiveFactor (float additiveFactor )

通知程序信號:

void additiveFactorChanged (float additiveFactor )

baseClip : Qt3DAnimation::QAbstractClipBlendNode *

This property holds the base animation clip. When the additiveFactor is zero the baseClip will also be the resulting clip of this blend node.

訪問函數:

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

通知程序信號:

void baseClipChanged (Qt3DAnimation::QAbstractClipBlendNode * baseClip )

成員函數文檔編製

QAdditiveClipBlend:: QAdditiveClipBlend ( Qt3DCore::QNode * parent = nullptr)

Default constructs an instance of QAdditiveClipBlend.

[protected] QAdditiveClipBlend:: QAdditiveClipBlend ( QAdditiveClipBlendPrivate & dd , Qt3DCore::QNode * parent = nullptr)

Copy constructor.

QAdditiveClipBlend:: ~QAdditiveClipBlend ()

Destroys the instance of QAdditiveClipBlend.