QEnvironmentLight

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

Synopsis

Functions

• def irradiance ()

• def specular ()

Slots

• def setIrradiance (irradiance)

• def setSpecular (specular)

Signals

• def irradianceChanged (environmentIrradiance)

• def specularChanged (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.

class PySide2.Qt3DRender.Qt3DRender.QEnvironmentLight([parent=None])

Parameters:

parent – PySide2.Qt3DCore.Qt3DCore.QNode

PySide2.Qt3DRender.Qt3DRender.QEnvironmentLight.irradiance()

Return type:

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture

Holds the current environment irradiance map texture.

By default, the environment irradiance texture is null.

Note

The exact meaning and use of this property is up to the material implementation.

PySide2.Qt3DRender.Qt3DRender.QEnvironmentLight.irradianceChanged(environmentIrradiance)

Parameters:

environmentIrradiance – PySide2.Qt3DRender.Qt3DRender.QAbstractTexture

PySide2.Qt3DRender.Qt3DRender.QEnvironmentLight.setIrradiance(irradiance)

Parameters:

irradiance – PySide2.Qt3DRender.Qt3DRender.QAbstractTexture

Holds the current environment irradiance map texture.

By default, the environment irradiance texture is null.

Note

The exact meaning and use of this property is up to the material implementation.

PySide2.Qt3DRender.Qt3DRender.QEnvironmentLight.setSpecular(specular)

Parameters:

specular – PySide2.Qt3DRender.Qt3DRender.QAbstractTexture

Holds the current environment specular map texture.

By default, the environment specular texture is null.

Note

The exact meaning and use of this property is up to the material implementation.

PySide2.Qt3DRender.Qt3DRender.QEnvironmentLight.specular()

Return type:

PySide2.Qt3DRender.Qt3DRender.QAbstractTexture

Holds the current environment specular map texture.

By default, the environment specular texture is null.

Note

The exact meaning and use of this property is up to the material implementation.

PySide2.Qt3DRender.Qt3DRender.QEnvironmentLight.specularChanged(environmentSpecular)

Parameters:

environmentSpecular – PySide2.Qt3DRender.Qt3DRender.QAbstractTexture