RuntimeLoader QML Type

Imports a 3D asset at runtime. 更多...

导入语句: import QtQuick3D.AssetUtils
Since: Qt 6.2
继承: Node

特性

详细描述

The RuntimeLoader type provides a way to load a 3D asset directly from source at runtime, without converting it to QtQuick3D 's internal format first.

Qt 6.2 supports the loading of glTF version 2.0 files in both in text (.gltf) and binary (.glb) formats.

特性文档编制

[read-only] bounds : Bounds

This property describes the extents of the bounding volume around the imported model.

注意: The value may not be available before the first render

[read-only] errorString : string

This property holds a human-readable string indicating the status of the latest load operation.


instancing : QtQuick3D::Instancing

If this property is set, the imported model will not be rendered normally. Instead, a number of instances will be rendered, as defined by the instance table.

实例化渲染 overview documentation for more information.


source : url

This property holds the location of the source file containing the 3D asset. Changing this property will unload the current asset and attempt to load an asset from the given URL.

The success or failure of the load operation is indicated by status .


[read-only] status : enumeration

This property holds the status of the latest load operation.

常量 描述
RuntimeLoader.Empty No URL was specified.
RuntimeLoader.Success The load operation was successful.
RuntimeLoader.Error The load operation failed. A human-readable error message is provided by errorString .