RuntimeLoader QML Type

Imports a 3D asset at runtime. More...

Import Statement:	import QtQuick3D.AssetUtils
Since:	Qt 6.2
Inherits:	Node

• List of all members, including inherited members

Properties

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

Detailed Description

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.

Property Documentation

[read-only] bounds : Bounds

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

[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.

See the Instanced Rendering 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.

Constant	Description
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.