En esta página

Qt3DRender::QEnvironmentLight Class

class Qt3DRender::QEnvironmentLight

Incluir un objeto de iluminación ambiental en una escena de « Qt 3D ». Más información...

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

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

Propiedades

Funciones públicas

Qt3DRender::QAbstractTexture *irradiance() const
Qt3DRender::QAbstractTexture *specular() const

Ranuras públicas

void setIrradiance(Qt3DRender::QAbstractTexture *irradiance)
void setSpecular(Qt3DRender::QAbstractTexture *specular)

Señales

void irradianceChanged(Qt3DRender::QAbstractTexture *environmentIrradiance)
void specularChanged(Qt3DRender::QAbstractTexture *environmentSpecular)

Descripción detallada

QEnvironmentLight utiliza mapas cúbicos para implementar la iluminación basada en imágenes (IBL), una técnica que suele utilizarse junto con el renderizado basado en la física (PBR). Normalmente, se espera que los cubemaps se basen en imágenes de alto rango dinámico (HDR), con un formato OpenGL adecuado (como RGBA16F) que pueda gestionar el mayor rango de valores.

Existen diversas herramientas que pueden utilizarse para generar los cubemaps que necesita QEnvironmentLight. Algunos ejemplos son

HDRI Haven ofrece numerosas imágenes HDR con licencia CC0 que pueden utilizarse como material de partida para las herramientas mencionadas anteriormente.

Documentación de propiedades

irradiance : Qt3DRender::QAbstractTexture*

Almacena la textura del mapa de irradiancia del entorno actual.

Por defecto, la textura de irradiación ambiental es nula.

Nota: El significado exacto y el uso de esta propiedad dependen de la implementación del material.

Funciones de acceso:

Qt3DRender::QAbstractTexture *irradiance() const
void setIrradiance(Qt3DRender::QAbstractTexture *irradiance)

Señal de notificación:

void irradianceChanged(Qt3DRender::QAbstractTexture *environmentIrradiance)

specular : Qt3DRender::QAbstractTexture*

Contiene la textura del mapa especular del entorno actual.

Por defecto, la textura especular del entorno es nula.

Nota: El significado exacto y el uso de esta propiedad dependen de la implementación del material.

Funciones de acceso:

Qt3DRender::QAbstractTexture *specular() const
void setSpecular(Qt3DRender::QAbstractTexture *specular)

Señal de notificación:

void specularChanged(Qt3DRender::QAbstractTexture *environmentSpecular)

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