Class Name: Infinite Light

Superclass - <Light Source>

Subclasses

Definition

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

Primary Page in DRM Diagram:

• 21

Secondary Pages in DRM Diagram:

Example

1. Consider an <Environment Root> instance that has a <Spatial Index Related Geometry> component representing the terrain in its transmittal. The <Spatial Index Related Geometry> instance has an <Infinite Light> component, representing the sun.

FAQs

No FAQs supplied.

Constraints

• <<Publishable Object>>

Composed of (two-way) (inherited)

• one <Ambient Colour> instance
• zero or one <Classification Data> instance¹
• one <Diffuse Colour> instance
• zero or one <Light Source Control Link> instance²
• one <Specular Colour> instance

Composed of (two-way)

• one <Reference Vector> instance³

Component of (two-way) (inherited)

• one or more <Aggregate Geometry> instances

Inherited Field Elements

Notes

Composed of Notes

Classification_Data

Light_Source_Control_Link

Reference_Vector

Fields Notes

apply_to_children

For a <Light Source> instance that is a component of some <Aggregate Geometry> instance(s), apply_to_children provides a mechanism for limiting the scope of the <Light Source> instance. If apply_to_children is SE_TRUE, only <Primitive Geometry> instances in the component tree of those <Aggregate Geometry> instances are affected by the <Light Source> instance. If apply_to_children is SE_FALSE, the <Light Source> instance is not limited to the scope of those <Aggregate Geometry> instances and thus applies globally.

override_positional_lights

For a <Light Source> instance that is a component of some <Aggregate Geometry> instance, override_positional_lights provides a mechanism to indicate with a value of SE_TRUE that the effect of the <Light Source> instance overrides that of any <Base Positional Light> instances that would have otherwise applied to that <Aggregate Geometry> instance.

EXAMPLE  This might be appropriate if the <Light Source> instance is so close to the affected <Geometry Representation> instance(s) that the effects of the <Base Positional Light> instances would be negligible.

If override_positional_lights = SE_FALSE, the effect of the <Light Source> instance is combined with that of any <Base Positional Light> instances that are already in effect.

override_infinite_lights

For a <Light Source> instance that is a component of some <Aggregate Geometry> instance, override_infinite_lights provides a mechanism to indicate with a value of SE_TRUE that the effect of the <Light Source> instance overrides that of any <Infinite Light> instances that would have otherwise applied to that <Aggregate Geometry> instance. If override_infinite_lights = SE_FALSE, the effect of the <Light Source> instance is combined with that of any <Infinite Light> instances that are already in effect.

active_light_value

A value of SE_TRUE for the active_light_value field indicates that the light is on, while a value of SE_FALSE indicates that the light is off. For a <Light Source> instance with a <Light Source Control Link> component X, the value of the active_light_value field is obtained from X.