Table 6.143—DRM_Infinite_Light

Property

Description

Superclass

·         <DRM Light Source>

Class

·         <DRM Infinite Light>

Subclass

·         none

Definition

An object of this DRM class specifies a type of <DRM Light Source> that is considered to be located infinitely far away. It illuminates uniformly along a particular direction. Color and control are inherited from <DRM Light Source>. An <DRM Infinite Light> has no bound of influence and so affects all components of any <DRM Aggregate Geometry> that references it.

Example(s)

·         An <DRM Environment Root> has a <DRM Spatial Index Related Geometry> component, representing the terrain in its transmittal. The <DRM Spatial Index Related Geometry> has a <DRM Infinite Light> component, representing the sun.

Inherited field elements

field_name

range

Field_Data_Type

apply_to_children1

 

Boolean

override_positional_lights2

 

Boolean

override_infinite_lights3

 

Boolean

active_light_value4

 

Boolean

Field elements

field_name

range

Field_Data_Type

none

 

 

Associated to (one-way) (inherited)

·         none

Associated to (one-way)

·         none

Associated by (one-way) (inherited)

·         none

Associated by (one-way)

·         none

Associated with (two-way) (inherited)

·         none

Associated with (two-way)

·         none

Composed of (two-way) (inherited)

·         one <DRM Ambient Colour

·         one <DRM Diffuse Colour>

·         zero or one <DRM Light Source Control Link>

·         one <DRM Specular Colour>

Composed of (two-way)

·         one <DRM Reference Vector>5

Composed of (two-way metadata) (inherited)

·         none

Composed of (two-way metadata)

·         none

Component of (two-way) (inherited)

·         one or more <DRM Aggregate Geometry>

Component of (two-way)

·         none

Constraints

·         none

Notes

1 Flag to allow lights to limit their scope to only affecting their children. If apply_to_children is FALSE, the light is assumed to apply globally.

2 Flag to reset the current cumulative definition of local <DRM Light Source>s If override_positional_lights is TRUE, all <DRM Positional Light>s in the current scope are cleared.

3 Flag to reset the current cumulative definition of <DRM Infinite Light>s. If override_infinite_lights is TRUE, all <DRM Infinite Light>s in the current scope are cleared.

4 This is the default/active state of the light indicating whether it is on (TRUE) or off..

5 Direction of light source illumination of type LIGHT_DIRECTION.

Class diagram

<DRM Infinite Light>