Qt3DAnimation::QAdditiveClipBlend Class

class Qt3DAnimation::QAdditiveClipBlend

根据加法因子对两个动画片段执行加法混合。更多

Header: #include <QAdditiveClipBlend>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3danimation)
target_link_libraries(mytarget PRIVATE Qt6::3danimation)
qmake: QT += 3danimation
在 QML 中: AdditiveClipBlend
继承: Qt3DAnimation::QAbstractClipBlendNode
状态:已废弃

属性

公共功能

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 可用于基于单个动画片段创建高级动画效果。例如,如果您

  • baseClip 属性设置为正常行走循环动画片段,并将
  • additiveClip 属性设置为摇头差异剪辑、

调整additiveFactor 属性可控制additiveClipbaseClip 之间的相加程度。这样做的效果是,当additiveFactor 为 0 时,该混合节点将生成原始的行走循环片段。如果additiveFactor 的值为 1,它将生成包含摇头动画的行走循环片段。

该类实现的混合操作如下:

resultClip = baseClip + additiveFactor * additiveClip

您可以使用 0 至 1 范围之外的 additiveFacor 属性值,但请注意,输入的动画片段可能不是以这种方式编写的,因此这样做没有意义。

另请参阅 QBlendedClipAnimator

属性文档

additiveClip : Qt3DAnimation::QAbstractClipBlendNode*

该属性用于保存要与baseClip 混合的添加剪辑。混合量由additiveFactor 属性控制。

访问功能:

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

通知信号:

void additiveClipChanged(Qt3DAnimation::QAbstractClipBlendNode *additiveClip)

additiveFactor : float

指定混合因子,通常介于 0 和 1 之间,用于控制两个动画片段的混合。

访问功能:

float additiveFactor() const
void setAdditiveFactor(float additiveFactor)

通知信号:

void additiveFactorChanged(float additiveFactor)

baseClip : Qt3DAnimation::QAbstractClipBlendNode*

此属性用于保存基本动画片段。当additiveFactor 为零时,baseClip 也将是此混合节点的结果剪辑。

访问功能:

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

通知信号:

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.