Qt3DRender::QSceneLoader Class
class Qt3DRender::QSceneLoaderPermite cargar una escena existente. Más...
| Cabecera: | #include <QSceneLoader> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender)target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| En QML: | SceneLoader |
| Hereda: | Qt3DCore::QComponent |
| Status: | Obsoleto |
- Lista de todos los miembros, incluyendo los heredados
- QSceneLoader es 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
Dado un archivo fuente 3D, Qt3DRender::QSceneLoader intentará analizarlo y construir un árbol de objetos Qt3DCore::QEntity con los componentes Qt3DRender::QGeometryRenderer, Qt3DCore::QTransform y Qt3DRender::QMaterial adecuados.
El cargador intentará determinar el mejor material a utilizar basándose en las propiedades del fichero modelo. Si desea utilizar un material personalizado, tendrá que recorrer el árbol y sustituir los materiales asociados por defecto por los suyos.
Como su nombre indica, Qt3DRender::QSceneLoader carga un subárbol de escena completo. Si desea cargar una sola pieza de geometría, deberá utilizar Qt3DRender::QMesh.
Qt3DRender::QSceneLoader internamente se basa en el uso de plugins para admitir una amplia variedad de formatos de archivo 3D. Esta es una lista de los formatos soportados por Qt3D.
Nota: este componente no debe ser compartido entre varias instancias de Qt3DCore::QEntity. Se producirá un comportamiento indefinido.
Ver también Qt3DRender::QMesh y Qt3DRender::QGeometryRenderer.
Documentación de tipos de miembros
enum QSceneLoader::ComponentType
Este enum especifica un tipo de componente.
| Constante | Valor | Descripción |
|---|---|---|
Qt3DRender::QSceneLoader::UnknownComponent | 0 | Tipo de componente desconocido |
Qt3DRender::QSceneLoader::GeometryRendererComponent | 1 | Qt3DRender::QGeometryRenderer componente |
Qt3DRender::QSceneLoader::TransformComponent | 2 | Qt3DCore::QTransform componente |
Qt3DRender::QSceneLoader::MaterialComponent | 3 | Qt3DRender::QMaterial componente |
Qt3DRender::QSceneLoader::LightComponent | 4 | Qt3DRender::QAbstractLight componente |
Qt3DRender::QSceneLoader::CameraLensComponent | 5 | Qt3DRender::QCameraLens componente |
enum QSceneLoader::Status
Este enum identifica el estado de carga
| Constante | Valor | Descripción |
|---|---|---|
Qt3DRender::QSceneLoader::None | 0 | El Qt3DRender::QSceneLoader no se ha utilizado todavía. |
Qt3DRender::QSceneLoader::Loading | 1 | El Qt3DRender::QSceneLoader está cargando actualmente el archivo de escena. |
Qt3DRender::QSceneLoader::Ready | 2 | Qt3DRender::QSceneLoader ha cargado correctamente el archivo de escena. |
Qt3DRender::QSceneLoader::Error | 3 | Qt3DRender::QSceneLoader ha encontrado 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 del notificador:
| void | sourceChanged(const QUrl &source) |
[read-only] status : Status
Mantiene el estado de carga de la escena.
- SceneLoaderNinguno
- SceneLoaderCargando
- SceneLoaderListo
- 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 miembro
[explicit] QSceneLoader::QSceneLoader(Qt3DCore::QNode *parent = nullptr)
El constructor crea una instancia con la dirección parent especificada.
[invokable] Qt3DCore::QComponent *QSceneLoader::component(const QString &entityName, Qt3DRender::QSceneLoader::ComponentType componentType) const
Devuelve un componente que coincida con componentType de una entidad cargada con un objectName que coincida con entityName. Si la entidad tiene varios componentes coincidentes, se devuelve el primero que coincida en la lista de componentes de la entidad. Si no hay ninguna coincidencia, se devuelve un puntero nulo.
Nota: Esta función puede invocarse 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 con un objectName que coincide con el parámetro entityName. Si varias entidades tienen el mismo nombre, no está definido cuál de ellas se devuelve, pero siempre será la misma.
Nota: Esta función puede invocarse 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 puede invocarse 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.
