QEnvironmentLight Class

class Qt3DRender::QEnvironmentLight

Encapsulate an environment light object in a Qt 3D scene. More...

Header:	#include <QEnvironmentLight>
CMake:	find_package(Qt6 COMPONENTS 3drender REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake:	QT += 3drender
Since:	Qt 5.9
Instantiated By:	EnvironmentLight
Inherits:	Qt3DCore::QComponent

• List of all members, including inherited members

Properties

• irradiance : Qt3DRender::QAbstractTexture*
• specular : Qt3DRender::QAbstractTexture*

Public Functions

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

Public Slots

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

Signals

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

Detailed Description

QEnvironmentLight uses cubemaps to implement image-based lighting (IBL), a technique often used in conjunction with physically-based rendering (PBR). The cubemaps are typically expected be based on high dynamic range (HDR) images, with a suitable OpenGL format (such as RGBA16F) that can handle the increased range of values.

There are a variety of tools that can be used to produce the cubemaps needed by QEnvironmentLight. Some examples include

• cmftStudio
• IBLBaker
• Lys

HDRI Haven provides many CC0-licensed HDR images that can be used as source material for the above tools.