RuntimeLoader QML Type

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

Import Statement: import QtQuick3D.AssetUtils
Since: Qt 6.2
Inherits:

Node

Eigenschaften

Detaillierte Beschreibung

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

RuntimeLoader unterstützt .obj und glTF Version 2.0 Dateien sowohl im Text (.gltf) als auch im Binärformat (.glb).

Eigenschaft Dokumentation

bounds : Bounds [read-only]

Diese Eigenschaft beschreibt die Ausmaße des Bounding Volumes um das importierte Modell.

Hinweis: Der Wert ist möglicherweise nicht vor dem ersten Rendering verfügbar.


errorString : string [read-only]

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


instancing : Instancing

Wenn diese Eigenschaft gesetzt ist, wird das importierte Modell nicht normal gerendert. Stattdessen wird eine Anzahl von Instanzen gerendert, wie in der Instanztabelle definiert.

Weitere Informationen finden Sie in der Übersichtsdokumentation zum Instanz-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.

KonstanteBeschreibung
RuntimeLoader.EmptyEs wurde keine URL angegeben.
RuntimeLoader.SuccessDer Ladevorgang war erfolgreich.
RuntimeLoader.ErrorDer Ladevorgang ist fehlgeschlagen. Eine für den Menschen lesbare Fehlermeldung wird von errorString bereitgestellt.

© 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.