Qt3DAnimation::QVertexBlendAnimation Class
class Qt3DAnimation::QVertexBlendAnimation实现顶点混合变形动画的类。更多
| Header： | #include <QVertexBlendAnimation> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS 3danimation)target_link_libraries(mytarget PRIVATE Qt6::3danimation) |
| qmake： | QT += 3danimation |
| 在 QML 中： | VertexBlendAnimation |
| 继承： | Qt3DAnimation::QAbstractAnimation |
| 状态： | 已废弃 |
属性
- interpolator : const float
- target : Qt3DRender::QGeometryRenderer*
- targetName : QString
- targetPositions : QList<float>
公共功能
| QVertexBlendAnimation(QObject *parent = nullptr) | |
| void | addMorphTarget(Qt3DAnimation::QMorphTarget *target) |
| float | interpolator() const |
| QList<Qt3DAnimation::QMorphTarget *> | morphTargetList() |
| void | removeMorphTarget(Qt3DAnimation::QMorphTarget *target) |
| void | setMorphTargets(const QList<Qt3DAnimation::QMorphTarget *> &targets) |
| Qt3DRender::QGeometryRenderer * | target() const |
| QString | targetName() const |
| QList<float> | targetPositions() const |
公共插槽
| void | setTarget(Qt3DRender::QGeometryRenderer *target) |
| void | setTargetName(const QString name) |
| void | setTargetPositions(const QList<float> &targetPositions) |
信号
| void | interpolatorChanged(float interpolator) |
| void | targetChanged(Qt3DRender::QGeometryRenderer *target) |
| void | targetNameChanged(const QString &name) |
| void | targetPositionsChanged(const QList<float> &targetPositions) |
详细说明
Qt3DAnimation::QVertexBlendAnimation 类实现了顶点混合变形动画到目标QGeometryRenderer 。QVertexBlendAnimation 会设置从morph targets 到目标QGeometryRenderer::geometry 的正确QAttributes ，并计算当前位置的插值器。与使用混合权重控制混合的QMorphingAnimation 不同，混合发生在连续的变形目标之间。属性之间的实际混合必须在材质中实现。Qt3DAnimation::QMorphPhongMaterial 为 phong 灯光模型实现了支持变形的材质。混合发生在两个属性--"基本 "和 "目标 "之间。基本属性和目标属性的名称取自变形目标名称，其中基本属性保留已有名称，目标属性名称后附加 "Target"。插值器可以设置为QParameter ，并与所使用的材质一致。动画中的所有变形目标都应包含与基本几何体名称相同的属性。
属性文档
[read-only] interpolator : const float
保存基础属性和目标属性之间的插值器。
访问功能：
| float | interpolator() const |
通知信号：
| void | interpolatorChanged(float interpolator) |
target : Qt3DRender::QGeometryRenderer*
保存变形动画应用的目标 QGeometryRenderer。
访问功能：
| Qt3DRender::QGeometryRenderer * | target() const |
| void | setTarget(Qt3DRender::QGeometryRenderer *target) |
通知信号
| void | targetChanged(Qt3DRender::QGeometryRenderer *target) |
targetName : QString
目标几何体的名称。这是一个方便的属性，可以更容易地将目标几何体与变形动画相匹配。该名称通常与目标 QGeometryRenderer 的父实体名称相同，但并非必须如此。
访问功能：
| QString | targetName() const |
| void | setTargetName(const QString name) |
通知信号
| void | targetNameChanged(const QString &name) |
targetPositions : QList<float>
保存形态目标的位置值。列表中的每个位置都指定了具有相同索引的相应 morph target 的位置。数值必须以升序排列。数值可以是正数或负数，没有预定义单位。
访问功能
| QList<float> | targetPositions() const |
| void | setTargetPositions(const QList<float> &targetPositions) |
Notifier 信号：
| void | targetPositionsChanged(const QList<float> &targetPositions) |
成员函数 文档
[explicit] QVertexBlendAnimation::QVertexBlendAnimation(QObject *parent = nullptr)
使用parent 构建一个新的 QVertexBlendAnimation。
void QVertexBlendAnimation::addMorphTarget(Qt3DAnimation::QMorphTarget *target)
在动画结尾处添加新的变形target 。
QList<Qt3DAnimation::QMorphTarget *> QVertexBlendAnimation::morphTargetList()
返回变形目标列表。
void QVertexBlendAnimation::removeMorphTarget(Qt3DAnimation::QMorphTarget *target)
从动画中移除变形target 。
void QVertexBlendAnimation::setMorphTargets(const QList<Qt3DAnimation::QMorphTarget *> &targets)
将变形targets 设置为动画。清除旧目标。
© 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.
