RuntimeLoader QML Type

在运行时导入一个 3D 资源。更多...

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

枚举

• QueryFilter

属性

• bounds : Bounds
• errorString : string
• instancing : Instancing
• source : url
• status : enumeration

方法

• Object3D query(string arg) (since 6.12)
• List<Object3D> queryAll(QueryFilter filter) (since 6.12)

详细说明

RuntimeLoader 类型提供了一种在运行时直接从源文件加载 3D 资源的方法，无需先将其转换为QtQuick3D 的内部格式。

RuntimeLoader 支持 .obj 以及 glTF 2.0 版本的文件，包括文本格式（.gltf）和二进制格式（.glb）。

枚举文档

QueryFilter

指定要查询的对象类型。

另请参阅 queryAll()。

属性文档

bounds : Bounds [read-only]

该属性描述了导入模型周围边界体积的范围。

errorString : string [read-only]

该属性包含一个易于理解的字符串，用于指示最新加载操作的状态。

instancing : Instancing

如果设置了此属性，导入的模型将不会按常规方式渲染。相反，系统将根据实例表中的定义渲染多个实例。

有关详细信息，请参阅“实例化渲染”概述文档。

source : url

该属性存储包含 3D 资源的源文件的位置。修改此属性将卸载当前资源，并尝试从给定的 URL 加载资源。

加载操作的成功或失败由status 指示。

status : enumeration [read-only]

该属性保存了最近一次加载操作的状态。

方法文档

[since 6.12] Object3D query(string arg)

返回名称为给定名称的对象；如果不存在该名称的对象，则返回null 。

arg 参数是待查询对象的名称或查询字符串。例如，要查询名为“PaintMaterialX”的对象，请使用以下代码：

var object = runtimeLoader.query("PaintMaterial")

假设源资源文件中的对象命名合理，上述代码将按预期运行。但是，如果存在多个同名对象，查询将返回第一个与给定名称匹配的对象。若要查询特定对象并避免歧义，请使用完整的对象路径。

var object = runtimeLoader.query("/House2/Wall001/Mirror/Material")

此方法于 Qt 6.12 中引入。

[since 6.12] List<Object3D> queryAll(QueryFilter filter)

返回一个包含所有符合给定筛选条件对象的列表。

filter 参数用于指定要查询的对象类型。例如，要查询所有材质，请使用以下代码：

var materials = runtimeLoader.queryAll(RuntimeLoader.Materials)

上述代码将返回源资源文件中所有材质的一个列表。

此方法在 Qt 6.12 中引入。