Qt3DAnimation::QAbstractAnimationClip Class

class Qt3DAnimation::QAbstractAnimationClip

QAbstractAnimationClip 是提供关键帧动画数据类型的基类。更多

头文件：	`#include <QAbstractAnimationClip>`
CMake.QAbstractAnimationClip	`find_package(Qt6 REQUIRED COMPONENTS 3danimation)` `target_link_libraries(mytarget PRIVATE Qt6::3danimation)`
qmake：	`QT += 3danimation`
继承：	Qt3DCore::QNode
继承于	Qt3DAnimation::QAnimationClip 和Qt3DAnimation::QAnimationClipLoader
状态：	已废弃

所有成员（包括继承成员）的列表

属性

duration : const float

公共功能

virtual	~QAbstractAnimationClip()
float	duration() const

信号

void	durationChanged(float duration)

详细说明

要使用Qt 3D Animation 模块中的关键帧动画框架，需要为动画制作组件提供关键帧动画数据。动画数据由 QAbstractAnimationClip 的一个具体子类提供：

QAnimationClip 如果您想在应用程序中以编程方式创建动画数据，则应使用 QAbstractAnimationClip 的具体子类 QAbstractAnimationClip。实际数据是通过值类型设置的。QAnimationClipData

如果您要从文件（如艺术家创建的文件）中加载烘焙的动画数据，则应使用QAnimationClipLoader 类并设置其source 属性。

使用上述方法为动画剪辑填充数据后，Qt 3D 动画后台将更新只读的持续时间属性。

动画片段的典型用法如下：

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

动画剪辑还可用作动画混合树中的叶节点值：

// 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);

另请参阅 Qt3DAnimation::QAnimationClip 和Qt3DAnimation::QAnimationClipLoader 。

属性文档

`[read-only]` duration : const float

动画片段的持续时间（以秒为单位）。一旦使用其中一个具体子类向Qt 3D 提供了动画数据，它就会更新。

访问函数：

float duration() const

Notifier 信号：

void	durationChanged(float duration)

成员函数文档

`[virtual noexcept]` QAbstractAnimationClip::~QAbstractAnimationClip()

销毁该动画短片。

© 2025 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.