SceneLoader QML Type
Bietet die Möglichkeit, eine vorhandene Szene zu laden. Mehr...
| Import Statement: | import Qt3D.Render 2.12 |
| In C++: | QSceneLoader |
| Inherits: | |
| Status: | Deprecated |
Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.
Eigenschaften
Methoden
- Entity component(string entityName, enumeration componentType)
- Entity entity(string entityName)
- list entityNames()
Ausführliche Beschreibung
Bei einer 3D-Quelldatei versucht der SceneLoader, diese zu analysieren und einen Baum aus Entity-Objekten mit den entsprechenden Komponenten „ GeometryRenderer “, „Transform“ und „Material“ aufzubauen.
Der Loader versucht, anhand der Eigenschaften der Modelldatei das am besten geeignete Material zu ermitteln. Wenn Sie ein benutzerdefiniertes Material verwenden möchten, müssen Sie die Baumstruktur durchlaufen und die standardmäßig zugeordneten Materialien durch Ihre eigenen ersetzen.
Wie der Name schon sagt, lädt der SceneLoader einen kompletten Szenen-Teilbaum. Wenn Sie ein einzelnes Geometrieelement laden möchten, sollten Sie stattdessen lieber den Mesh verwenden.
SceneLoader stützt sich intern auf Plugins, um eine Vielzahl von 3D-Dateiformaten zu unterstützen. Hier ist eine Liste der von Qt3D unterstützten Formate.
Hinweis: Diese Komponente sollte nicht von mehreren Entity-Instanzen gemeinsam genutzt werden. Dies führt zu undefiniertem Verhalten.
Siehe auch Mesh und GeometryRenderer.
Dokumentation zu den Eigenschaften
source : url
Enthält die URL der zu ladenden Quelle.
status : enumeration [read-only]
Gibt den Status des Ladevorgangs der Szene an.
- SceneLoader.Keine
- SceneLoader.Wird geladen
- SceneLoader.Bereit
- SceneLoader.Fehler
Siehe auch „ Qt3DRender::QSceneLoader::Status “.
Methodendokumentation
Entity component(string entityName, enumeration componentType)
Gibt eine Komponente zurück, deren „ componentType “ mit dem einer geladenen Entität übereinstimmt und deren „objectName“ mit dem unter entityName angegebenen übereinstimmt. Wenn die Entität mehrere passende Komponenten enthält, wird die erste Übereinstimmung in der Komponentenliste der Entität zurückgegeben. Wenn keine Übereinstimmung vorliegt, wird ein undefiniertes Element zurückgegeben.
- SceneLoader.UnknownComponent Unbekannter Komponententyp
- SceneLoader.GeometryRendererComponent Qt3DRender::QGeometryRenderer-Komponente
- SceneLoader.TransformComponent Qt3DCore::QTransform-Komponente
- SceneLoader.MaterialComponent Qt3DRender::QMaterial-Komponente
- SceneLoader.LightComponent Qt3DRender::QAbstractLight-Komponente
- SceneLoader.CameraLensComponent Qt3DRender::QCameraLens-Komponente
Siehe auch Qt3DRender::QSceneLoader::ComponentType.
Entity entity(string entityName)
Gibt eine geladene Entität zurück, deren „ objectName “-Parameter mit dem Parameter „ entityName “ übereinstimmt. Wenn mehrere Entitäten denselben Namen haben, ist nicht definiert, welche davon zurückgegeben wird, es wird jedoch immer dieselbe sein.
list entityNames()
Gibt eine Liste der „ objectNames “ der geladenen Entitäten zurück.
© 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.