Qt3DAnimation::QAdditiveClipBlend Class
class Qt3DAnimation::QAdditiveClipBlend加算係数に基づいて、2つのアニメーションクリップを加算合成します。詳細...
| ヘッダー: | #include <qadditiveclipblend.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3danimation) target_link_libraries(mytarget PRIVATE Qt6::3danimation) |
| qmake: | QT += 3danimation |
| QML内: | AdditiveClipBlend |
| 継承元: | Qt3DAnimation::QAbstractClipBlendNode |
| ステータス: | テクノロジープレビュー |
このクラスはテクノロジープレビュー段階にあり、変更される可能性があります。
プロパティ
- additiveClip : Qt3DAnimation::QAbstractClipBlendNode*
- additiveFactor : float
- baseClip : 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 プロパティを調整することで、additiveClip がbaseClip にどれだけ加算されるかを制御できます。これにより、additiveFactor が0の場合、このブレンドノードは元のウォークサイクルクリップを出力します。additiveFactor が1の場合、頭を振るアニメーションを含むウォークサイクルが出力されます。
このクラスで実装されているブレンド操作は以下の通りです：
resultClip = baseClip + additiveFactor * additiveClipadditiveFacor プロパティに 0 から 1 の範囲外の値を使用することを妨げるものはありませんが、入力アニメーションクリップが、その設定が意味をなすように作成されていない可能性があることにご注意ください。
QBlendedClipAnimatorも参照してください 。
プロパティのドキュメント
additiveClip : Qt3DAnimation::QAbstractClipBlendNode*
このプロパティには、baseClip とブレンドされる加算クリップが格納されます。ブレンドの量は、additiveFactor プロパティによって制御されます。
アクセス関数：
| Qt3DAnimation::QAbstractClipBlendNode * | additiveClip() const |
| void | setAdditiveClip(Qt3DAnimation::QAbstractClipBlendNode *additiveClip) |
通知シグナル:
| void | additiveClipChanged(Qt3DAnimation::QAbstractClipBlendNode *additiveClip) |
additiveFactor : float
2つのアニメーションクリップのブレンドを制御するためのブレンド係数を指定します。通常、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) |
© 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.
