RuntimeLoader QML 类型

在运行时导入 3D 资产。《更多...

属性

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

RuntimeLoader 支持以文本 (.gltf) 和二进制 (.glb) 格式导入 .obj 和 glTF 2.0 文件。

bounds : Bounds [只读]

此属性描述了围绕导入模型的边界体的范围。

注意：在首次渲染之前，值可能不可用。

errorString : string [只读]

此属性持有一个表示最新加载操作状态的、可读的字符串。

instancing : Instancing

如果设置此属性，则导入的模型将不会按正常方式渲染。相反，将渲染一定数量的实例，由实例表定义。

有关更多信息，请参阅实例渲染概述文档。

source : url

此属性持有包含 3D 资产源文件的位置的路径。更改此属性将卸载当前资产，并尝试从给定的 URL 加载资产。

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

status : enumeration [只读]

此属性持有最新加载操作的状态。

常量	描述
`RuntimeLoader.Empty`	未指定 URL。
`RuntimeLoader.Success`	加载操作成功。
`RuntimeLoader.Error`	加载操作失败。 errorString 提供了一个易读的错误消息。