QAnimationController Class

class Qt3DAnimation::QAnimationController

アニメーションのコントローラークラス。もっと詳しく...

Header: #include <QAnimationController>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3danimation)
target_link_libraries(mytarget PRIVATE Qt6::3danimation)
qmake: QT += 3danimation
In QML: AnimationController
Inherits: QObject
Status: Deprecated

プロパティ

パブリック関数

QAnimationController(QObject *parent = nullptr)
int activeAnimationGroup() const
void addAnimationGroup(Qt3DAnimation::QAnimationGroup *animationGroup)
QList<Qt3DAnimation::QAnimationGroup *> animationGroupList()
Qt3DCore::QEntity *entity() const
int getAnimationIndex(const QString &name) const
Qt3DAnimation::QAnimationGroup *getGroup(int index) const
float position() const
float positionOffset() const
float positionScale() const
bool recursive() const
void removeAnimationGroup(Qt3DAnimation::QAnimationGroup *animationGroup)
void setAnimationGroups(const QList<Qt3DAnimation::QAnimationGroup *> &animationGroups)

パブリックスロット

void setActiveAnimationGroup(int index)
void setEntity(Qt3DCore::QEntity *entity)
void setPosition(float position)
void setPositionOffset(float offset)
void setPositionScale(float scale)
void setRecursive(bool recursive)

シグナル

void activeAnimationGroupChanged(int index)
void entityChanged(Qt3DCore::QEntity *entity)
void positionChanged(float position)
void positionOffsetChanged(float offset)
void positionScaleChanged(float scale)
void recursiveChanged(bool recursive)

詳細説明

Qt3DAnimation::QAnimationController クラスはアニメーションの選択と再生を制御します。このクラスは、 ツリーからすべてのアニメーションを検索し、同じ名前のアニメーションから を作成するために使用できます。ユーザは、アクティブなアニメーションを設定することで、アニメーションコントローラで現在制御されているアニメーショングループを選択することができます。アニメーションの位置は、 と の値で、提供された位置の値をスケーリングしてオフセットした後、そのグループに伝搬されます。Qt3DCore::QEntity QAnimationGroups positionScale positionOffset

注意: アニメーション・コントローラーは内部タイマーを持っておらず、ユーザーがタイムリーにポジション・プロパティを更新する必要があります。

プロパティの説明

activeAnimationGroup : int

現在アクティブなアニメーショングループを保持します。

アクセス関数

int activeAnimationGroup() const
void setActiveAnimationGroup(int index)

通知シグナル

void activeAnimationGroupChanged(int index)

entity : Qt3DCore::QEntity*

アニメーションが収集され、グループ化されたエンティティを保持する。コントローラが既にアニメーションを保持している場合、それらはクリアされる。

アクセス関数

Qt3DCore::QEntity *entity() const
void setEntity(Qt3DCore::QEntity *entity)

通知シグナル

void entityChanged(Qt3DCore::QEntity *entity)

position : float

アニメーションの現在位置を保持する。位置が設定されると、positionScale/positionOffset 、スケーリングとオフセットが行われ、アクティブなアニメーショングループに伝搬されます。

アクセス関数

float position() const
void setPosition(float position)

Notifierシグナル:

void positionChanged(float position)

positionOffset : float

アニメーションの位置オフセットを保持します。

アクセス関数

float positionOffset() const
void setPositionOffset(float offset)

Notifier signal: アニメーションの位置オフセットを保持します:

void positionOffsetChanged(float offset)

positionScale : float

Notifierシグナル:アニメーションの位置スケールを保持します。

アクセス関数

float positionScale() const
void setPositionScale(float scale)

Notifierシグナル:アニメーションの位置スケールを保持します:

void positionScaleChanged(float scale)

recursive : bool

Notifierシグナル: エンティティからアニメーションを収集する際に、エンティティツリーを再帰的に検索するかどうかを保持する。trueに設定すると、アニメーションはエンティティの子エンティティからも検索されます。falseに設定すると、コントローラに渡されたエンティティのみが検索される。

アクセス関数

bool recursive() const
void setRecursive(bool recursive)

通知シグナル:

void recursiveChanged(bool recursive)

メンバ関数 ドキュメント

QAnimationController::QAnimationController(QObject *parent = nullptr)

parent を持つ新しい QAnimationController を構築します。

void QAnimationController::addAnimationGroup(Qt3DAnimation::QAnimationGroup *animationGroup)

与えられたanimationGroup をコントローラに追加します。

QList<Qt3DAnimation::QAnimationGroup *> QAnimationController::animationGroupList()

コントローラが現在保持しているアニメーショングループのリストを返します。

[invokable] int QAnimationController::getAnimationIndex(const QString &name) const

name を持つアニメーションのインデックスを返します。指定された名前のAnimationGroup が見つからない場合は -1 を返します。

注意: この関数は、メタオブジェクトシステムや QML から呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] Qt3DAnimation::QAnimationGroup *QAnimationController::getGroup(int index) const

与えられたindex を持つAnimationGroup を返します。

注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

void QAnimationController::removeAnimationGroup(Qt3DAnimation::QAnimationGroup *animationGroup)

指定されたanimationGroup をコントローラから削除します。

void QAnimationController::setAnimationGroups(const QList<Qt3DAnimation::QAnimationGroup *> &animationGroups)

コントローラのanimationGroups を設定します。古いグループはクリアされます。

本ドキュメントに含まれる文書の著作権は、各所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。