En esta página

SceneLoader QML Type

Permite cargar una escena ya existente. Más información...

Import Statement: import Qt3D.Render 2.12
In C++: QSceneLoader
Inherits:

Component

Status: Deprecated

Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.

Propiedades

Métodos

Descripción detallada

A partir de un archivo fuente 3D, SceneLoader intentará analizarlo y construir un árbol de objetos Entity con los componentes adecuados de « GeometryRenderer », «Transform» y «Material».

El cargador intentará determinar el mejor material que se debe utilizar en función de las propiedades del archivo del modelo. Si deseas utilizar un material personalizado, tendrás que recorrer el árbol y sustituir los materiales predeterminados asociados por los tuyos.

Como su nombre indica, SceneLoader carga un subárbol completo de la escena. Si deseas cargar una sola pieza geométrica, deberías utilizar mejor Mesh.

SceneLoader se basa internamente en el uso de complementos para admitir una amplia variedad de formatos de archivo 3D. A continuación se muestra una lista de los formatos compatibles con Qt3D.

Nota: este componente no debe compartirse entre varias instancias de Entity. Se produciría un comportamiento indefinido.

Véase también Mesh y GeometryRenderer.

Documentación de propiedades

source : url

Contiene la URL de la fuente que se va a cargar.

status : enumeration [read-only]

Muestra el estado de la carga de la escena.

Véase también Qt3DRender::QSceneLoader::Status.

Documentación del método

Entity component(string entityName, enumeration componentType)

Devuelve un componente cuyo « componentType » coincida con el de una entidad cargada y cuyo «objectName» coincida con el de entityName. Si la entidad tiene varios componentes que coincidan, se devuelve el primero de la lista de componentes de la entidad. Si no hay ninguna coincidencia, se devuelve un elemento indefinido.

  • SceneLoader.UnknownComponent Tipo de componente desconocido
  • SceneLoader.GeometryRendererComponent Componente Qt3DRender::QGeometryRenderer
  • SceneLoader.TransformComponent Componente Qt3DCore::QTransform
  • SceneLoader.MaterialComponent: componente Qt3DRender::QMaterial
  • SceneLoader.LightComponent: componente Qt3DRender::QAbstractLight
  • SceneLoader.CameraLensComponent: componente Qt3DRender::QCameraLens

Véase también Qt3DRender::QSceneLoader::ComponentType.

Entity entity(string entityName)

Devuelve una entidad cargada cuyo parámetro « objectName » coincida con el parámetro « entityName ». Si hay varias entidades con el mismo nombre, no está definido cuál de ellas se devolverá, pero siempre será la misma.

list entityNames()

Devuelve una lista de los « objectNames » de las entidades cargadas.

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