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 许可证可用。
了解更多。