SceneLoader QML Type

提供加载现有场景的功能。更多...

此类型已弃用。我们强烈建议不要在新代码中使用它。

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

属性

• source : url
• status : enumeration

方法

• Entity component(string entityName, enumeration componentType)
• Entity entity(string entityName)
• list entityNames()

详细说明

给定一个 3D 源文件，SceneLoader 将尝试解析该文件，并构建一个包含适当GeometryRenderer 、Transform 和 Material 组件的 Entity 对象树。

加载器将根据模型文件的属性尝试确定最佳材质。若需使用自定义材质，则必须遍历该树，并将默认关联的材质替换为您的自定义材质。

顾名思义，SceneLoader 加载的是完整的场景子树。如果您只想加载单个几何体，则应改用 Mesh。

SceneLoader 内部依赖于插件来支持多种 3D 文件格式。以下是Qt3D 支持的格式列表。

另请参阅 Mesh 和GeometryRenderer 。

属性文档

source : url

保存待加载源的网址。

status : enumeration [read-only]

保存场景加载状态。

• SceneLoader.None
• SceneLoader.正在加载
• SceneLoader.就绪
• SceneLoader.错误

另请参阅 Qt3DRender::QSceneLoader::Status 。

方法文档

Entity component(string entityName, enumeration componentType)

返回一个与已加载实体的componentType 匹配、且objectName与 entityName 匹配的组件。如果该实体有多个匹配的组件，则返回该实体组件列表中的第一个匹配项。如果没有匹配项，则返回一个未定义项。

• SceneLoader.UnknownComponent 未知组件类型
• SceneLoader.GeometryRendererComponent Qt3DRender::QGeometryRenderer 组件
• SceneLoader.TransformComponent Qt3DCore::QTransform 组件
• SceneLoader.MaterialComponent Qt3DRender::QMaterial 组件
• SceneLoader.LightComponent Qt3DRender::QAbstractLight 组件
• SceneLoader.CameraLensComponent Qt3DRender::QCameraLens 组件

另请参见 Qt3DRender::QSceneLoader::ComponentType 。

Entity entity(string entityName)

返回一个已加载的实体，其objectName 与entityName 参数匹配。如果多个实体名称相同，则无法确定返回的是其中哪一个，但返回的始终是同一个实体。

list entityNames()

返回已加载实体的objectNames 列表。