SceneLoader QML Type

기존 씬을 로드하는 기능을 제공합니다. 더 보기...

Import Statement:	`import Qt3D.Render 2.8`
In C++:	QSceneLoader
Inherits:	Component
Status:	Deprecated

상속된 멤버를 포함한 모든 멤버 목록

속성

source : url
status : enumeration

방법

Entity component(string entityName, enumeration componentType)
Entity entity(string entityName)
list entityNames()

자세한 설명

3D 소스 파일이 주어지면 씬로더는 이를 파싱하고 적절한 GeometryRenderer, 트랜스폼 및 머티리얼 컴포넌트가 포함된 엔티티 오브젝트 트리를 빌드합니다.

로더는 모델 파일의 프로퍼티를 기반으로 사용할 최적의 머티리얼을 결정하려고 시도합니다. 커스텀 머티리얼을 사용하려면 트리를 탐색하여 기본 연결된 머티리얼을 사용자 머티리얼로 교체해야 합니다.

이름에서 알 수 있듯이 SceneLoader는 전체 씬 서브트리를 로드합니다. 단일 지오메트리 조각을 로드하려면 메시를 대신 사용해야 합니다.

SceneLoader는 내부적으로 다양한 3D 파일 형식을 지원하기 위해 플러그인을 사용합니다. 다음은 Qt3D에서 지원하는 포맷 목록입니다.

참고: 이 컴포넌트는 여러 엔티티 인스턴스 간에 공유해서는 안 됩니다. 정의되지 않은 동작이 발생할 수 있습니다.

Mesh 및 GeometryRenderer 을참조하세요 .

프로퍼티 문서

source : url

로드할 소스의 URL을 보유합니다.

status : enumeration [read-only]

씬 로딩 상태를 보유합니다.

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

Qt3DRender::QSceneLoader::Status 를참조하세요 .

메서드 문서

Entity component(string entityName, enumeration componentType)

로드된 엔티티의 객체 이름이 entityName 과 일치하는 컴포넌트 componentType 를 반환합니다. 엔티티에 일치하는 컴포넌트가 여러 개 있는 경우 엔티티의 컴포넌트 목록에서 첫 번째로 일치하는 것이 반환됩니다. 일치하는 항목이 없으면 정의되지 않은 항목이 반환됩니다.

SceneLoader.UnknownComponent 알 수 없는 컴포넌트 유형
SceneLoader.GeometryRendererComponent Qt3DRender::QGeometryRenderer 컴포넌트
SceneLoader.TransformComponent Qt3DCore::QTransform 컴포넌트
SceneLoader.MaterialComponent Qt3DRender::QMaterial 컴포넌트
SceneLoader.LightComponent Qt3DRender::QAbstractLight 컴포넌트
SceneLoader.CameraLensComponent Qt3DRender::QCameraLens 컴포넌트

Qt3DRender::QSceneLoader::ComponentType 를참조하세요 .

Entity entity(string entityName)

entityName 파라미터와 일치하는 objectName 로 로드된 엔티티를 반환합니다. 여러 엔티티의 이름이 같은 경우, 어떤 엔티티가 반환되는지는 정의되지 않지만 항상 같은 엔티티가 반환됩니다.

list entityNames()

로드된 엔티티의 objectNames 목록을 반환합니다.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.