Qt3DRender::QSceneLoader Class
class Qt3DRender::QSceneLoaderPermite 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.
- Lista de todos los miembros, incluidos los heredados
- QSceneLoader forma parte de Entrada/Salida y Redes.
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.
| Constante | Valor | Descripción |
|---|---|---|
Qt3DRender::QSceneLoader::UnknownComponent | 0 | Tipo de componente desconocido |
Qt3DRender::QSceneLoader::GeometryRendererComponent | 1 | Componente Qt3DRender::QGeometryRenderer |
Qt3DRender::QSceneLoader::TransformComponent | 2 | Componente Qt3DCore::QTransform |
Qt3DRender::QSceneLoader::MaterialComponent | 3 | Componente Qt3DRender::QMaterial |
Qt3DRender::QSceneLoader::LightComponent | 4 | Componente Qt3DRender::QAbstractLight |
Qt3DRender::QSceneLoader::CameraLensComponent | 5 | Componente Qt3DRender::QCameraLens |
enum QSceneLoader::Status
Esta enumeración identifica el estado de la carga
| Constante | Valor | Descripción |
|---|---|---|
Qt3DRender::QSceneLoader::None | 0 | El « Qt3DRender::QSceneLoader » aún no se ha utilizado. |
Qt3DRender::QSceneLoader::Loading | 1 | El « Qt3DRender::QSceneLoader » está cargando actualmente el archivo de escena. |
Qt3DRender::QSceneLoader::Ready | 2 | El « Qt3DRender::QSceneLoader » ha cargado correctamente el archivo de escena. |
Qt3DRender::QSceneLoader::Error | 3 | Qt3DRender::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.