RuntimeLoader QML Type
Importa un recurso 3D en tiempo de ejecución. Más...
| Import Statement: | import QtQuick3D.AssetUtils |
| Since: | Qt 6.2 |
| Inherits: |
Enumeraciones
Características
- bounds : Bounds
- errorString : string
- instancing : Instancing
- source : url
- status : enumeration
Métodos
Descripción detallada
El tipo RuntimeLoader permite cargar un recurso 3D directamente desde la fuente en tiempo de ejecución, sin necesidad de convertirlo primero al formato interno de QtQuick3D.
RuntimeLoader admite archivos .obj y glTF versión 2.0, tanto en formato de texto (.gltf) como binario (.glb).
Advertencia: RuntimeLoader no aísla ni valida el contenido de los recursos. La carga de recursos malformados o no fiables puede tener implicaciones de seguridad. Consulta source para obtener más detalles.
Documentación sobre enumeración
QueryFilter
Especifica el tipo de objetos que se van a consultar.
| Constante | Descripción |
|---|---|
RuntimeLoader.Textures | Consulta de objetos de textura |
RuntimeLoader.Materials | Búsqueda de objetos de material |
RuntimeLoader.Nodes | Búsqueda de objetos de nodo |
RuntimeLoader.Cameras | Consulta de objetos de cámara |
RuntimeLoader.Lights | Consulta de objetos de luz |
RuntimeLoader.Models | Consulta de objetos de modelo |
Véase también queryAll().
Documentación de propiedades
bounds : Bounds [read-only]
Esta propiedad describe los límites del volumen delimitador que rodea el modelo importado.
Nota: Es posible queel valor no esté disponible antes del primer renderizado.
errorString : string [read-only]
Esta propiedad contiene una cadena legible para el usuario que indica el estado de la última operación de carga.
instancing : Instancing
Si se establece esta propiedad, el modelo importado no se renderizará de forma normal. En su lugar, se renderizarán varias instancias, tal y como se define en la tabla de instancias.
Consulta la documentación general sobre el renderizado por instancias para obtener más información.
source : url
Esta propiedad contiene la ubicación del archivo fuente que contiene el recurso 3D. Al modificar esta propiedad, se descargará el recurso actual y se intentará cargar un recurso desde la URL indicada.
El éxito o el fallo de la operación de carga se indica mediante status.
Advertencia: RuntimeLoader no aísla ni valida el contenido de los recursos. La carga de recursos con formato incorrecto o de origen no fiable puede tener implicaciones de seguridad. Los desarrolladores de aplicaciones deben tener esto muy en cuenta antes de permitir la carga de contenido proporcionado por el usuario que no forme parte de la aplicación.
status : enumeration [read-only]
Esta propiedad indica el estado de la última operación de carga.
| Constante | Descripción |
|---|---|
RuntimeLoader.Empty | No se ha especificado ninguna URL. |
RuntimeLoader.Success | La operación de carga se ha realizado correctamente. |
RuntimeLoader.Error | La operación de carga ha fallado. Se proporciona un mensaje de error legible para el usuario en errorString. |
Documentación del método
[since 6.12] Object3D query(string arg)
Devuelve el objeto con el nombre indicado o « null » si no existe ningún objeto con ese nombre.
El parámetro « arg » es el nombre del objeto que se desea consultar o una cadena de consulta. Por ejemplo, para consultar el objeto denominado «PaintMaterialX», utiliza el siguiente código:
var object = runtimeLoader.query("PaintMaterial")El código anterior funciona según lo esperado, siempre que los objetos tengan nombres adecuados en el archivo de recursos de origen. Sin embargo, si hay varios objetos con el mismo nombre, la consulta devolverá el primer objeto encontrado que coincida con el nombre indicado. Para consultar un objeto específico y evitar ambigüedades, utiliza la ruta completa del objeto.
var object = runtimeLoader.query("/House2/Wall001/Mirror/Material")Nota: Incluso con las rutas, es posible que un archivo de recursos mal estructurado contenga varios objetos con la misma ruta, ya que las rutas se construyen a partir de los nombres de los objetos en el archivo de recursos de origen.
Nota: Los nombres delos objetos se definen tal y como aparecen en el archivo de recursos de origen.
Este método se introdujo en Qt 6.12.
[since 6.12] List<Object3D> queryAll(QueryFilter filter)
Devuelve una lista de todos los objetos que coinciden con el filtro indicado.
El parámetro « filter » especifica el tipo de objetos que se van a consultar. Por ejemplo, para consultar todos los materiales, utiliza el siguiente código:
var materials = runtimeLoader.queryAll(RuntimeLoader.Materials)El código anterior devuelve una lista de todos los materiales del archivo de recursos de origen.
Este método se introdujo en Qt 6.12.
© 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.