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 ソースファイルが与えられると、SceneLoader はそれを解析し、適切なGeometryRenderer 、Transform、Material コンポーネントを持つ Entity オブジェクトのツリーを構築しようとします。

ローダーは、モデルファイルのプロパティに基づいて、使用する最適なマテリアルを決定しようとします。カスタムマテリアルを使用したい場合は、ツリーをトラバースして、デフォルトの関連マテリアルを自分のマテリアルに置き換える必要があります。

その名の通り、SceneLoader は完全なシーンサブツリーをロードします。ジオメトリの単一ピースをロードしたい場合は、代わりに Mesh を使用する必要があります。

SceneLoader は内部的に、様々な 3D ファイルフォーマットをサポートするプラグインの使用に依存しています。以下はQt3D がサポートしているフォーマットのリストです。

注意： このコンポーネントは、複数の Entity インスタンス間で共有しないでください。未定義の動作になります。

Mesh とGeometryRendererも参照してください。

プロパティ Documentation

source : url

ロードされるソースへの URL を保持します。

status : enumeration [read-only]

シーンロードのステータスを保持します。

SceneLoader.None
SceneLoaderロード中
SceneLoader.Ready
SceneLoader.Error

Qt3DRender::QSceneLoader::Statusも参照してください。

メソッド・ドキュメント

Entity component(string entityName, enumeration componentType)

entityName に一致するobjectName を持つ、ロードされたエンティティのcomponentType に一致するコンポーネントを返します。エンティティに一致するコンポーネントが複数ある場合は、エンティティのコンポーネントリストで最初に一致するものが返されます。一致するものがない場合は、未定義の項目が返されます。

SceneLoader.UnknownComponent 不明なコンポーネントタイプ。
SceneLoader.GeometryRendererComponentQt3DRender::QGeometryRenderer コンポーネント
SceneLoader.TransformComponentQt3DCore::QTransform コンポーネント
SceneLoader.MaterialComponentQt3DRender::QMaterial コンポーネント
SceneLoader.LightComponentQt3DRender::QAbstractLight コンポーネント
SceneLoader.CameraLensComponentQt3DRender::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.