Qt 5.7 | Qt 3D | QML Types | SceneLoader QML Type

Qt 5.7.1 Reference Documentation

# SceneLoader QML Type

Provides the facility to load an existing Scene More...

Import Statement: | import Qt3D.Render 2.0
Since: | Qt 5.7
Instantiates: | QSceneLoader

- List of all members, including inherited members

## Properties

- source : url
- status : enumeration

## Detailed Description

Given a 3D source file, the SceneLoader will try to parse it and build a tree of Entity objects with proper GeometryRenderer, Transform and Material components.

The loader will try to determine the best material to be used based on the properties of the model file. If you wish to use a custom material, you will have to traverse the tree and replace the default associated materials with yours.

As the name implies, SceneLoader loads a complete scene subtree. If you wish to load a single piece of geometry, you should rather use the Mesh instead.

SceneLoader internally relies on the use of plugins to support a wide variety of 3D file formats. Here is a list of formats that are supported by Qt3D.

Note: this component shouldn't be shared among several Entity instances. Undefined behavior will result.

See also Mesh and GeometryRenderer.

## Property Documentation

source : url

Holds the url to the source to be loaded.

[read-only] status : enumeration

Holds the status of scene loading.

- SceneLoader.None
- SceneLoader.Loading
- SceneLoader.Ready
- SceneLoader.Error

See also Qt3DRender::QSceneLoader::Status.