A3DGraphAmbientLightData Struct Reference

Data for an ambient light source entity (``) More...

Data Fields

A3DUns32 m_uiAmbientColorIndex
 The main or ambient color of the light source.
 
A3DUns32 m_uiDiffuseColorIndex
 The diffuse color of the light source.
 
A3DUns32 m_uiSpecularColorIndex
 The specular color of the light source.
 

Detailed Description

Data for an ambient light source entity (``)

Version
2.0

An ambient light simulates lighting that bounces everywhere and thus comes from no specific location. Ambient lights illuminate every face of an object regardless of their position or orientation.

All colors within this structure are global indexes to RGB color codes. The actual values can be queried using A3DGlobalGetGraphRgbColorData.

A3DGraphAmbientLightData is one of the four light source types provided by HOOPS. It is associated to the kA3DTypeGraphAmbientLight entity type. The other available light sources are A3DGraphPointLightData, A3DGraphSpotLightData and A3DGraphDirectionalLightData.

Ligthing color
The color of a lighting source is usually described with a single color, referenced to by m_uiAmbientColorIndex which is applied to the receiving material. Different implementations can take benefit from making the distinction between ambient, diffuse and specular colors upon computing light. These additional information can be written into m_uiDiffuseColorIndex and m_uiSpecularColorIndex. When ununsed, these values are either set to the same value as m_uiAmbientColorIndex or A3D_DEFAULT_COLOR_INDEX.
See also
A3DGlobalGetGraphRgbColorData
A3DGlobalInsertGraphRgbColor
A3DGraphRgbColorData
A3DGraphMaterialData
A3DGraphDirectionalLightData
A3DGraphPointLightData
A3DGraphSpotLightData