内容

• 公共类型
• 特性
• 公共函数
• 公共槽
• 信号
• 保护函数
• 详细描述

QSceneLoader 类

( Qt3DRender::QSceneLoader )

提供加载现有场景的设施 更多...

头：	#include <QSceneLoader>
qmake:	QT += 3drender
Since:	Qt 5.7
实例化：	SceneLoader
继承：	Qt3DCore::QComponent

• 所有成员列表，包括继承成员

公共类型

enum	ComponentType { UnknownComponent, GeometryRendererComponent, TransformComponent, MaterialComponent, LightComponent, CameraLensComponent }
enum	Status { None, Loading, Ready, Error }

特性

• source : QUrl
• status : const Status

• 1 特性继承自 Qt3DCore::QComponent
• 3 特性继承自 Qt3DCore::QNode
• 1 特性继承自 QObject

公共函数

	QSceneLoader (Qt3DCore::QNode * parent = nullptr)
Qt3DCore::QComponent *	component (const QString & entityName , ComponentType componentType ) const
Qt3DCore::QEntity *	entity (const QString & entityName ) const
QStringList	entityNames () const
QUrl	source () const
Status	status () const

• 2 公共函数继承自 Qt3DCore::QComponent
• 11 public functions inherited from Qt3DCore::QNode
• 32 公共函数继承自 QObject

公共槽

void	setSource (const QUrl & arg )

• 1 公共槽继承自 Qt3DCore::QComponent
• 3 公共槽继承自 Qt3DCore::QNode
• 1 公共槽继承自 QObject

信号

void	sourceChanged (const QUrl & source )
void	statusChanged (Status status )

• 3 信号继承自 Qt3DCore::QComponent
• 4 信号继承自 Qt3DCore::QNode
• 2 信号继承自 QObject

保护函数

QSceneLoader (QSceneLoaderPrivate & dd , Qt3DCore::QNode * parent = nullptr)

• 2 protected functions inherited from Qt3DCore::QNode
• 9 保护函数继承自 QObject

额外继承成员

• 11 静态公共成员继承自 QObject

详细描述

提供加载现有场景的设施

给定 3D 源文件， Qt3DRender::QSceneLoader 将试着剖析它并构建树为 Qt3DCore::QEntity 对象采用适当 Qt3DRender::QGeometryRenderer , Qt3DCore::QTransform and Qt3DRender::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.

顾名思义， Qt3DRender::QSceneLoader loads a complete scene subtree. If you wish to load a single piece of geometry, you should rather use the Qt3DRender::QMesh 代替。

Qt3DRender::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.

注意： this component shouldn't be shared among several Qt3DCore::QEntity instances. Undefined behavior will result.

另请参阅 Qt3DRender::QMesh and Qt3DRender::QGeometryRenderer .

成员类型文档编制

enum QSceneLoader:: ComponentType

This enum specifies a component type.

常量	值	描述
Qt3DRender::QSceneLoader::UnknownComponent	0	Unknown component type
Qt3DRender::QSceneLoader::GeometryRendererComponent	1	Qt3DRender::QGeometryRenderer component
Qt3DRender::QSceneLoader::TransformComponent	2	Qt3DCore::QTransform component
Qt3DRender::QSceneLoader::MaterialComponent	3	Qt3DRender::QMaterial component
Qt3DRender::QSceneLoader::LightComponent	4	Qt3DRender::QAbstractLight component
Qt3DRender::QSceneLoader::CameraLensComponent	5	Qt3DRender::QCameraLens component

enum QSceneLoader:: Status

This enum identifies the state of loading

常量	值	描述
Qt3DRender::QSceneLoader::None	0	Qt3DRender::QSceneLoader hasn't been used yet.
Qt3DRender::QSceneLoader::Loading	1	Qt3DRender::QSceneLoader is currently loading the scene file.
Qt3DRender::QSceneLoader::Ready	2	Qt3DRender::QSceneLoader successfully loaded the scene file.
Qt3DRender::QSceneLoader::Error	3	Qt3DRender::QSceneLoader encountered an error while loading the scene file.

特性文档编制

source : QUrl

Holds the url to the source to be loaded.

访问函数：

QUrl	source () const
void	setSource (const QUrl & arg )

通知程序信号：

void	sourceChanged (const QUrl & source )

status : const Status

Holds the status of scene loading.

• SceneLoader .None
• SceneLoader .Loading
• SceneLoader .Ready
• SceneLoader .Error

访问函数：

Status

status () const

通知程序信号：

void	statusChanged (Status status )

另请参阅 Qt3DRender::QSceneLoader::Status .

成员函数文档编制

QSceneLoader:: QSceneLoader ( Qt3DCore::QNode * parent = nullptr)

Default constructs an instance of QSceneLoader.

[protected] QSceneLoader:: QSceneLoader ( QSceneLoaderPrivate & dd , Qt3DCore::QNode * parent = nullptr)

Copy constructor.

Qt3DCore::QComponent *QSceneLoader:: component (const QString & entityName , ComponentType componentType ) const

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.

Qt3DCore::QEntity *QSceneLoader:: entity (const QString & entityName ) const

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.

QStringList QSceneLoader:: entityNames () const

返回列表为 objectNames of the loaded entities.