C
Q3DSElement 类
控制 Qt 3D Studio 展示中的场景对象(元素)。更多信息...
此类在 Qt 3D Studio 2.0 中引入。
属性
- elementPath : QString
公共函数
| Q3DSElement(Q3DSPresentation *presentation, const QString &elementPath, QObject *parent = nullptr) | |
| 虚拟 | ~Q3DSElement() |
| QString | elementPath() const |
公共槽
| void | fireEvent(const QString &eventName) |
| void | setAttribute(const QString &attributeName, const QVariant &value) |
| void | setElementPath(const QString &elementPath) |
信号
| void | elementPathChanged(const QString &elementPath) |
详细说明
此类提供向后兼容性。我们建议使用DataInput 和 DataOutput API 以在设计和代码之间建立合同和干净的用户界面。
此类是一个便利类,用于控制 Qt 3D Studio 展示中场景对象(例如,模型、材质、相机、层)的属性。
另请参阅Q3DSSurfaceViewer 和 Q3DSSceneElement。
属性文档
elementPath : QString
保存展示元素的元素路径。
元素路径通过名称引用场景中的对象,例如,Scene.Layer.Camera。在这里选择右侧的相机对象,即使场景包含具有默认相机名称的其他层(例如 Scene.Layer2.Camera)也是如此。
要引用存储在其他对象属性中的对象,可以使用点符号。此最典型的示例是通过对通过 SomeMaterial.diffusemap 的 sourcepath 属性选择的对象更改纹理图的源。
要访问子展示中的对象,请先加上子展示的名称,然后加上冒号,例如,SubPresentationOne:Scene.Layer.Camera。
访问函数
| QString | elementPath() const |
| void | setElementPath(const QString &elementPath) |
通知信号
| void | elementPathChanged(const QString &elementPath) |
成员函数文档
Q3DSElement::Q3DSElement(Q3DSPresentation *presentation, const QString &elementPath, QObject *parent = nullptr)
构建一个控制由 elementPath 指定的场景对象的 Q3DSElement 实例。可以指定一个可选的 parent 对象。构建的实例自动关联到指定的 presentation。也可以指定一个可选的 parent 对象。
[槽] void Q3DSElement::fireEvent(const QString &eventName)
在指定的 elementPath 场景对象上分发具有 eventName 的事件。
Qt 3D Studio 中创建的适当操作或在附加(行为)脚本中使用 registerForEvent() 方法注册的回调将在事件响应时执行。
[槽] void Q3DSElement::setAttribute(const QString &attributeName, const QVariant &value)
设置由 elementPath 指定的场景对象的属性(属性)的 value 值。
attributeName 是属性的 脚本名称。
[虚拟] Q3DSElement::~Q3DSElement()
析构函数。
根据某些 Qt 许可证可用。
了解更多。