RuntimeLoader QML Type

Importiert ein 3D-Asset zur Laufzeit. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Aufzählungen

• QueryFilter

Eigenschaften

• bounds : Bounds
• errorString : string
• instancing : Instancing
• source : url
• status : enumeration

Methoden

• Object3D query(string arg) (since 6.12)
• List<Object3D> queryAll(QueryFilter filter) (since 6.12)

Ausführliche Beschreibung

Der Typ „RuntimeLoader“ bietet die Möglichkeit, ein 3D-Asset zur Laufzeit direkt aus der Quelle zu laden, ohne es zuvor in das interne Format von „ QtQuick3D “ zu konvertieren.

„RuntimeLoader“ unterstützt „.obj“- und „glTF“-Dateien der Version 2.0 sowohl im Textformat („.gltf“) als auch im Binärformat („.glb“).

Dokumentation zur Aufzählung

QueryFilter

Gibt den Typ der Objekte an, nach denen gesucht werden soll.

Siehe auch „ queryAll()“.

Dokumentation zu den Eigenschaften

bounds : Bounds [read-only]

Diese Eigenschaft beschreibt die Ausdehnung des Begrenzungsvolumens um das importierte Modell herum.

errorString : string [read-only]

Diese Eigenschaft enthält eine für Menschen lesbare Zeichenfolge, die den Status des letzten Ladevorgangs angibt.

instancing : Instancing

Wenn diese Eigenschaft gesetzt ist, wird das importierte Modell nicht wie üblich gerendert. Stattdessen werden mehrere Instanzen gerendert, wie in der Instanztabelle definiert.

Weitere Informationen finden Sie in der Dokumentation zur Übersicht über das instanzierte Rendering.

source : url

Diese Eigenschaft enthält den Speicherort der Quelldatei, die das 3D-Asset enthält. Durch Ändern dieser Eigenschaft wird das aktuelle Asset entladen und versucht, ein Asset von der angegebenen URL zu laden.

Der Erfolg oder Misserfolg des Ladevorgangs wird durch „ status “ angezeigt.

status : enumeration [read-only]

Diese Eigenschaft enthält den Status des letzten Ladevorgangs.

Methodendokumentation

[since 6.12] Object3D query(string arg)

Gibt das Objekt mit dem angegebenen Namen zurück oder „ null “, falls kein Objekt mit diesem Namen existiert.

Der Parameter „ arg “ ist der Name des abzufragenden Objekts oder eine Abfragezeichenfolge. Um beispielsweise das Objekt mit dem Namen „PaintMaterialX“ abzufragen, verwenden Sie den folgenden Code:

var object = runtimeLoader.query("PaintMaterial")

Der obige Code funktioniert wie erwartet, vorausgesetzt, die Objekte sind in der Quell-Asset-Datei sinnvoll benannt. Wenn es jedoch mehrere Objekte mit demselben Namen gibt, gibt die Abfrage das erste Objekt zurück, das dem angegebenen Namen entspricht. Um ein bestimmtes Objekt abzufragen und Mehrdeutigkeiten zu vermeiden, verwenden Sie den vollständigen Objektpfad.

var object = runtimeLoader.query("/House2/Wall001/Mirror/Material")

Diese Methode wurde in Qt 6.12 eingeführt.

[since 6.12] List<Object3D> queryAll(QueryFilter filter)

Gibt eine Liste aller Objekte zurück, die dem angegebenen Filter entsprechen.

Der Parameter „ filter “ gibt den Typ der abzufragenden Objekte an. Um beispielsweise alle Materialien abzufragen, verwenden Sie den folgenden Code:

var materials = runtimeLoader.queryAll(RuntimeLoader.Materials)

Der obige Code gibt eine Liste aller Materialien in der Quell-Asset-Datei zurück.

Diese Methode wurde in Qt 6.12 eingeführt.