SceneLoader QML Type
既存のシーンを読み込む機能を提供します。詳細...
| Import Statement: | import Qt3D.Render 2.12 |
| In C++: | QSceneLoader |
| Inherits: | |
| Status: | Deprecated |
この型は非推奨です。新しいコードでの使用は強く推奨しません。
プロパティ
方法
- 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 。
プロパティのドキュメント
source : url
読み込むソースのURLを保持します。
status : enumeration [read-only]
シーンの読み込み状況を保持します。
- SceneLoader.None
- SceneLoader.読み込み中
- SceneLoader.Ready
- SceneLoader.エラー
関連項目: Qt3DRender::QSceneLoader::Status 。
メソッドのドキュメント
Entity component(string entityName, enumeration componentType)
entityName に一致するobjectNameを持つ、読み込まれたエンティティのcomponentType に一致するコンポーネントを返します。エンティティに一致するコンポーネントが複数ある場合は、そのエンティティのコンポーネントリストの最初の一致するものが返されます。一致するものがない場合は、undefined が返されます。
- 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 のリストを返します。
© 2026 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.