QSceneLoader

Provides the facility to load an existing Scene. More…

Synopsis

Functions

• def component (entityName, componentType)

• def entity (entityName)

• def entityNames ()

• def source ()

• def status ()

Slots

• def setSource (arg)

Signals

• def sourceChanged (source)

• def statusChanged (status)

Detailed Description

Given a 3D source file, the QSceneLoader will try to parse it and build a tree of QEntity objects with proper QGeometryRenderer , QTransform and QMaterial 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, QSceneLoader loads a complete scene subtree. If you wish to load a single piece of geometry, you should rather use the QMesh instead.

QSceneLoader 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 QEntity instances. Undefined behavior will result.

See also

QMesh QGeometryRenderer

class PySide6.Qt3DRender.Qt3DRender.QSceneLoader([parent=None])

Parameters

parent – PySide6.Qt3DCore.Qt3DCore.QNode

The constructor creates an instance with the specified parent.

PySide6.Qt3DRender.Qt3DRender.QSceneLoader.Status

This enum identifies the state of loading

Constant	Description
Qt3DRender.QSceneLoader.None	The QSceneLoader hasn’t been used yet.
Qt3DRender.QSceneLoader.Loading	The QSceneLoader is currently loading the scene file.
Qt3DRender.QSceneLoader.Ready	The QSceneLoader successfully loaded the scene file.
Qt3DRender.QSceneLoader.Error	The QSceneLoader encountered an error while loading the scene file.

PySide6.Qt3DRender.Qt3DRender.QSceneLoader.ComponentType

This enum specifies a component type.

Constant	Description
Qt3DRender.QSceneLoader.UnknownComponent	Unknown component type
Qt3DRender.QSceneLoader.GeometryRendererComponent	QGeometryRenderer component
Qt3DRender.QSceneLoader.TransformComponent	QTransform component
Qt3DRender.QSceneLoader.MaterialComponent	QMaterial component
Qt3DRender.QSceneLoader.LightComponent	QAbstractLight component
Qt3DRender.QSceneLoader.CameraLensComponent	QCameraLens component

PySide6.Qt3DRender.Qt3DRender.QSceneLoader.component(entityName, componentType)

Parameters

• entityName – str

• componentType – ComponentType

Return type

PySide6.Qt3DCore.Qt3DCore.QComponent

Returns a component matching componentType of a loaded entity with an objectName matching the entityName. If the entity has multiple matching components, the first match in the component list of the entity is returned. If there is no match, a null pointer is returned.

PySide6.Qt3DRender.Qt3DRender.QSceneLoader.entity(entityName)

Parameters

entityName – str

Return type

PySide6.Qt3DCore.Qt3DCore.QEntity

Returns a loaded entity with an objectName matching the entityName parameter. If multiple entities have the same name, it is undefined which one of them is returned, but it will always be the same one.

PySide6.Qt3DRender.Qt3DRender.QSceneLoader.entityNames()

Return type

list of strings

Returns a list of the objectNames of the loaded entities.

PySide6.Qt3DRender.Qt3DRender.QSceneLoader.setSource(arg)

Parameters

arg – PySide6.QtCore.QUrl

Holds the url to the source to be loaded.

PySide6.Qt3DRender.Qt3DRender.QSceneLoader.source()

Return type

PySide6.QtCore.QUrl

Holds the url to the source to be loaded.

PySide6.Qt3DRender.Qt3DRender.QSceneLoader.sourceChanged(source)

Parameters

source – PySide6.QtCore.QUrl

PySide6.Qt3DRender.Qt3DRender.QSceneLoader.status()

Return type

Status

Holds the status of scene loading.

• SceneLoader .None

• SceneLoader .Loading

• SceneLoader .Ready

• SceneLoader .Error

See also

Status

PySide6.Qt3DRender.Qt3DRender.QSceneLoader.statusChanged(status)

Parameters

status – Status