BlendedClipAnimator QML Type

BlendedClipAnimator は、ブレンドノードのツリー構造のアニメーション再生機能を提供するコンポーネントです。詳細...

このタイプはテクノロジープレビュー段階にあり、変更される可能性があります。

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• blendTree : AbstractClipBlendNode

詳細な説明

BlendedClipAnimatorのインスタンスは、エンティティによって集約され、アニメーションクリップを再生したり、計算されたアニメーション値をQObjectのプロパティに適用したりする機能を追加することができます。

ClipAnimator が単一のアニメーションクリップからアニメーションデータを取得するのに対し、BlendedClipAnimatorは複数のクリップをブレンドすることができます。アニメーションデータは、いわゆるブレンドツリーを評価することで取得されます。 ブレンドツリーは階層的なツリー構造であり、葉ノードはアニメーションクリップ（AbstractAnimationClip）をカプセル化した値ノードであり、内部ノードは、そのオペランドプロパティが指すノードに対して作用するブレンド演算を表します。

ブレンドツリーを BlendedClipAnimator に関連付けるには、アニメーターの `blendTree ` プロパティを設定して、ブレンドツリーのルートノードを指すようにします。

BlendedClipAnimator {
    blendTree: AdditiveClipBlend {
        ....
    }
}

ブレンドツリーは、以下のノードタイプから構成することができます：

• Qt3D.Animation.ClipBlendValue
• Qt3D.Animation.LerpClipBlend
• Qt3D.Animation.Qt3D.Animation.AdditiveClipBlend

今後、ノードの種類が追加される予定です。

例として、次のブレンドツリーを考えてみましょう。

Clip0----
        |
        Lerp Node----
        |           |
Clip1----           Additive Node
                    |
            Clip2----

これは次のように作成・使用できます：

BlendedClipAnimator {
    blendTree: AdditiveClipBlend {
        baseClip: LerpClipBlend {
            startClip: ClipBlendValue {
                clip: AnimationClipLoader { source: "walk.json" }
            }

            endClip: ClipBlendValue {
                clip: AnimationClipLoader { source: "run.json" }
            }
        }

        additiveClip: ClipBlendValue {
            clip: AnimationClipLoader { source: "wave-arm.json" }
        }
    }

    channelMapper: ChannelMapper {...}
    running: true
}

一連のアニメーションクリップを作成し、実行時にブレンドツリーを使ってそれらを動的にブレンドすることで、膨大な数のアニメーションを生成することが可能になります。上記のブレンドツリーの簡単な例として、アルファが加算係数、ベータがレップ（lerp）ブレンド係数である場合、次のような 2D の連続的なアニメーションが得られます：

(alpha = 0, beta = 1) Running, No arm waving --- (alpha = 1, beta = 1) Running, Arm waving
        |                                               |
        |                                               |
        |                                               |
(alpha = 0, beta = 0) Walking, No arm waving --- (alpha = 0, beta = 1) Running, No arm waving

より複雑なブレンドツリーを使用すれば、アニメーションクリップを組み合わせる際の柔軟性がさらに高まります。なお、ブレンドツリーを制御するために使用される値（上記のアルファとベータ）は、ブレンドノード上の単純なプロパティです。つまり、これらのプロパティ自体もアニメーションフレームワークによって制御可能です。

プロパティのドキュメント

blendTree : AbstractClipBlendNode

このプロパティには、アニメーターによって補間処理が行われる前に評価される、アニメーションブレンドツリーのルートが格納されます。