QAbstractAnimationClip Class

Detaillierte Beschreibung

Um das Keyframe-Animations-Framework im Modul Qt 3D Animation zu nutzen, muss die verwendete Animator-Komponente mit den Keyframe-Animationsdaten versorgt werden. Die Animationsdaten werden von einer der konkreten Unterklassen von QAbstractAnimationClip bereitgestellt:

• Qt3DAnimation::QAnimationClip
• Qt3DAnimation::QAnimationClipLoader

QAnimationClip sollte verwendet werden, wenn Sie die Animationsdaten programmatisch in Ihrer Anwendung erstellen wollen. Die eigentlichen Daten werden mit einem QAnimationClipData Werttyp gesetzt.

Wenn Sie die gebackenen Animationsdaten aus einer Datei laden, z. B. wie sie von einem Künstler erstellt wurden, dann verwenden Sie die Klasse QAnimationClipLoader und setzen Sie deren Eigenschaft source.

Sobald der Animationsclip mit Hilfe der oben genannten Methoden mit Daten gefüllt wurde, wird die schreibgeschützte Eigenschaft "Dauer" durch das Backend von Qt 3D Animation aktualisiert.

Die typische Verwendung von Animationsclips ist:

auto animator = new QClipAnimator();
auto clip = new QAnimationClipLoader();
clip->setSource(QUrl::fromLocalFile("bounce.json"));
animator->setClip(clip);
animator->setChannelMapper(...);
animator->setRunning(true);

Animationsclips werden auch als Blattknotenwerte in Animationsmischbäumen verwendet:

// Create leaf nodes of blend tree
auto slideClipValue = new QClipBlendValue(
    new QAnimationClipLoader(QUrl::fromLocalFile("slide.json")));
auto bounceClipValue = new QClipBlendValue(
    new QAnimationClipLoader(QUrl::fromLocalFile("bounce.json")));

// Create blend tree inner node
auto additiveNode = new QAdditiveClipBlend();
additiveNode->setBaseClip(slideClipValue);
additiveNode->setAdditiveClip(bounceClipValue);
additiveNode->setAdditiveFactor(0.5f);

// Run the animator
auto animator = new QBlendedClipAnimator();
animator->setBlendTree(additiveNode);
animator->setChannelMapper(...);
animator->setRunning(true);