En esta página

RuntimeLoader QML Type

Importa un recurso 3D en tiempo de ejecución. Más...

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

Node

Enumeraciones

Características

Métodos

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

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.

ConstanteDescripción
RuntimeLoader.TexturesConsulta de objetos de textura
RuntimeLoader.MaterialsBúsqueda de objetos de material
RuntimeLoader.NodesBúsqueda de objetos de nodo
RuntimeLoader.CamerasConsulta de objetos de cámara
RuntimeLoader.LightsConsulta de objetos de luz
RuntimeLoader.ModelsConsulta 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.

ConstanteDescripción
RuntimeLoader.EmptyNo se ha especificado ninguna URL.
RuntimeLoader.SuccessLa operación de carga se ha realizado correctamente.
RuntimeLoader.ErrorLa 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.