Класс QSceneLoader

(Qt3DRender::QSceneLoader)

Предоставляет возможность загружать существующую сцену Подробнее...

Заголовок:	#include <QSceneLoader>
qmake:	QT += 3drender
С момента:	Qt 5.7
Инициализируется:	SceneLoader
Наследуется от:	Qt3DCore::QComponent

Список всех членов, включая унаследованные

Типы

Перечисление	ComponentType { UnknownComponent, GeometryRendererComponent, TransformComponent, MaterialComponent, LightComponent, CameraLensComponent }
Перечисление	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 открытые функции унаследованы от 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 защищённые функции унаследованы от Qt3DCore::QNode
9 защищённые функции унаследованы от QObject

Дополнительные унаследованные члены

11 статических публичных членов унаследованы от QObject

Подробное описание

Предоставляет возможность загружать существующую сцену

Учитывая 3D-исходный файл, Qt3DRender::QSceneLoader попытается разобрать его и построить дерево объектов Qt3DCore::QEntity с надлежащими компонентами Qt3DRender::QGeometryRenderer, Qt3DCore::QTransform и Qt3DRender::QMaterial.

Загрузчик попытается определить наилучший материал для использования на основе свойств файла модели. Если вы хотите использовать пользовательский материал, вам нужно будет пройтись по дереву и заменить используемые по умолчанию материалы своими.

Как следует из названия, Qt3DRender::QSceneLoader загружает полное поддерево сцены. Если вы хотите загрузить только часть геометрии, используйте вместо этого Qt3DRender::QMesh.

Qt3DRender::QSceneLoader внутренне полагается на использование плагинов для поддержки широкого спектра 3D-форматов файлов. Здесь представлен список поддерживаемых Qt3D форматов.

Примечание: этот компонент не следует использовать совместно с несколькими экземплярами Qt3DCore::QEntity. Будет результатом неопределённое поведение.

См. также Qt3DRender::QMesh и Qt3DRender::QGeometryRenderer.

Документация по типам членов

перечисление QSceneLoader::ComponentType

Это перечисление определяет тип компонента.

Константа	Значение	Описание
`Qt3DRender::QSceneLoader::UnknownComponent`	`0`	Неизвестный тип компонента
`Qt3DRender::QSceneLoader::GeometryRendererComponent`	`1`	компонент Qt3DRender::QGeometryRenderer
`Qt3DRender::QSceneLoader::TransformComponent`	`2`	компонент Qt3DCore::QTransform
`Qt3DRender::QSceneLoader::MaterialComponent`	`3`	компонент Qt3DRender::QMaterial
`Qt3DRender::QSceneLoader::LightComponent`	`4`	компонент Qt3DRender::QAbstractLight
`Qt3DRender::QSceneLoader::CameraLensComponent`	`5`	компонент Qt3DRender::QCameraLens

перечисление QSceneLoader::Status

Это перечисление определяет состояние загрузки

Константа	Значение	Описание
`Qt3DRender::QSceneLoader::None`	`0`	Qt3DRender::QSceneLoader ещё не использовался.
`Qt3DRender::QSceneLoader::Loading`	`1`	В данный момент Qt3DRender::QSceneLoader загружает файл сцены.
`Qt3DRender::QSceneLoader::Ready`	`2`	Файл сцены успешно загружен Qt3DRender::QSceneLoader.
`Qt3DRender::QSceneLoader::Error`	`3`	При загрузке файла сцены Qt3DRender::QSceneLoader произошла ошибка.

Документация по свойству

source : QUrl

Содержит URL-адрес источника, который должен быть загружен.

Функции доступа:

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

Сигнал уведомления:

void	sourceChanged(const QUrl &source)

status : const Status

Содержит статус загрузки сцены.

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

Функции доступа:

Status status() const

Сигнал уведомления:

void	statusChanged(Status status)

См. также Qt3DRender::QSceneLoader::Status.

Документация по членам-функциям

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

Создаёт экземпляр QSceneLoader по умолчанию.

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

Копирующий конструктор.

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

Возвращает компонент, соответствующий componentType загруженного объекта с именем объекта, соответствующим entityName. Если объект имеет несколько соответствующих компонентов, возвращается первый компонент из списка компонентов объекта. Если соответствия нет, возвращается указатель null.

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

Возвращает загруженный объект с именем, соответствующим параметру entityName. Если несколько объектов имеют одинаковое имя, поведение не определено, но возвращаемый объект всегда будет одним и тем же.

QStringList QSceneLoader::entityNames() const

Возвращает список имён загруженных объектов.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qt3drender-qsceneloader.html