En esta página

Qt3DRender::QSceneLoader Class

class Qt3DRender::QSceneLoader

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

Encabezado: #include <qsceneloader.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
En QML: SceneLoader
Heredado de: Qt3DCore::QComponent
Estado: Obsoleto

Esta clase está en desuso. Se desaconseja encarecidamente su uso en código nuevo.

Tipos públicos

enum ComponentType { UnknownComponent, GeometryRendererComponent, TransformComponent, MaterialComponent, LightComponent, CameraLensComponent }
enum Status { None, Loading, Ready, Error }

Propiedades

Funciones públicas

QSceneLoader(Qt3DCore::QNode *parent = nullptr)
Qt3DCore::QComponent *component(const QString &entityName, Qt3DRender::QSceneLoader::ComponentType componentType) const
Qt3DCore::QEntity *entity(const QString &entityName) const
QStringList entityNames() const
QUrl source() const
Qt3DRender::QSceneLoader::Status status() const

Ranuras públicas

void setSource(const QUrl &arg)

Señales

void sourceChanged(const QUrl &source)
void statusChanged(Qt3DRender::QSceneLoader::Status status)

Descripción detallada

A partir de un archivo fuente 3D, el cargador Qt3DRender::QSceneLoader intentará analizarlo y construir un árbol de objetos Qt3DCore::QEntity con los componentes adecuados Qt3DRender::QGeometryRenderer, Qt3DCore::QTransform y Qt3DRender::QMaterial.

El cargador intentará determinar cuál es el mejor material que se debe utilizar basándose en 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, « Qt3DRender::QSceneLoader » carga un subárbol completo de la escena. Si deseas cargar una sola pieza de geometría, deberías utilizar en su lugar « Qt3DRender::QMesh ».

Qt3DRender::QSceneLoader A nivel interno, se basa en el uso de complementos para admitir una amplia variedad de formatos de archivos 3D. A continuación se muestra una lista de los formatos compatibles con Qt3D.

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

Véase también Qt3DRender::QMesh y Qt3DRender::QGeometryRenderer.

Documentación sobre los tipos de miembros

enum QSceneLoader::ComponentType

Esta enumeración especifica un tipo de componente.

ConstanteValorDescripción
Qt3DRender::QSceneLoader::UnknownComponent0Tipo de componente desconocido
Qt3DRender::QSceneLoader::GeometryRendererComponent1Componente Qt3DRender::QGeometryRenderer
Qt3DRender::QSceneLoader::TransformComponent2Componente Qt3DCore::QTransform
Qt3DRender::QSceneLoader::MaterialComponent3Componente Qt3DRender::QMaterial
Qt3DRender::QSceneLoader::LightComponent4Componente Qt3DRender::QAbstractLight
Qt3DRender::QSceneLoader::CameraLensComponent5Componente Qt3DRender::QCameraLens

enum QSceneLoader::Status

Esta enumeración identifica el estado de la carga

ConstanteValorDescripción
Qt3DRender::QSceneLoader::None0El « Qt3DRender::QSceneLoader » aún no se ha utilizado.
Qt3DRender::QSceneLoader::Loading1El « Qt3DRender::QSceneLoader » está cargando actualmente el archivo de escena.
Qt3DRender::QSceneLoader::Ready2El « Qt3DRender::QSceneLoader » ha cargado correctamente el archivo de escena.
Qt3DRender::QSceneLoader::Error3Qt3DRender::QSceneLoader ha detectado un error al cargar el archivo de escena.

Documentación de propiedades

source : QUrl

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

Funciones de acceso:

QUrl source() const
void setSource(const QUrl &arg)

Señal de notificación:

void sourceChanged(const QUrl &source)

[read-only] status : Status

Contiene el estado de la carga de la escena.

  • SceneLoader.None
  • SceneLoader.Loading
  • SceneLoader.Ready
  • SceneLoader.Error

Funciones de acceso:

Qt3DRender::QSceneLoader::Status status() const

Señal de notificador:

void statusChanged(Qt3DRender::QSceneLoader::Status status)

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

Documentación de las funciones de miembro

[explicit] QSceneLoader::QSceneLoader(Qt3DCore::QNode *parent = nullptr)

El constructor crea una instancia con el ` parent` especificado.

[invokable] Qt3DCore::QComponent *QSceneLoader::component(const QString &entityName, Qt3DRender::QSceneLoader::ComponentType componentType) const

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 puntero nulo.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] Qt3DCore::QEntity *QSceneLoader::entity(const QString &entityName) const

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

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] QStringList QSceneLoader::entityNames() const

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

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

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