AnimationController QML Type
アニメーション用のコントローラータイプ。詳細...
| Import Statement: | import Qt3D.Animation 2.12 |
| In C++: | QAnimationController |
| Status: | Technology preview |
この型はテクノロジープレビュー段階にあり、変更される可能性があります。
プロパティ
- activeAnimationGroup : int
- animationGroups : list<AnimationGroup>
- entity : Entity
- position : real
- positionOffset : real
- positionScale : real
- recursive : bool
方法
- int getAnimationIndex(name)
- AnimationGroup getGroup(index)
詳細な説明
AnimationController タイプは、アニメーションの選択と再生を制御します。 この型を使用すると、エンティティツリーからすべてのアニメーションを検索し、同名のアニメーションからAnimationGroups を作成することができます。ユーザーは、アクティブなアニメーションを設定することで、そのアニメーションコントローラーによって現在制御されているアニメーショングループを選択できます。その後、指定された位置値にpositionScale およびpositionOffset の値を適用してスケーリングおよびオフセットを行った後、その位置情報がそのグループに反映されます。
注: アニメーションコントローラーには 内部タイマーは搭載されていません。代わりに、位置プロパティを適時に更新するのはユーザーの責任となります。
プロパティのドキュメント
activeAnimationGroup : int
現在アクティブなアニメーショングループを保持します。
animationGroups : list<AnimationGroup>
コントローラー内のアニメーショングループのリストを保持します。
entity : Entity
エンティティのアニメーションが収集・グループ化される元となるオブジェクトを保持します。コントローラーにすでにアニメーションが保持されている場合は、それらがクリアされます。
position : real
アニメーションの現在の位置を保持します。位置が設定されると、positionScale/positionOffset によってスケーリングおよびオフセット処理が行われ、アクティブなアニメーショングループに反映されます。
positionOffset : real
アニメーションの位置オフセットを保持します。
positionScale : real
アニメーションのスケールを保持します。
recursive : bool
エンティティからアニメーションを収集する際に、エンティティツリーを再帰的に検索するかどうかを指定します。true に設定すると、そのエンティティの子エンティティからもアニメーションが検索されます。false に設定すると、コントローラーに渡されたエンティティのみが検索対象となります。
メソッドのドキュメント
int getAnimationIndex(name)
name を含むアニメーションのインデックスを返します。指定された名前のAnimationGroup が見つからない場合は -1 を返します。
AnimationGroup getGroup(index)
指定されたindex を持つAnimationGroup を返します。
© 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.