Table 6.133 — DRM_Light_Source

Property

Description

Class

  • <DRM Light Source>

Superclass

Subclass

Definition

An instance of a concrete subclass descended from this abstract DRM class specifies a source of light emission.

Class diagram

Figure 6.155 — DRM_Light_Source

Inherited field elements

Field name

Range

Field data type

None

   

Field elements

Field name

Range

Field data type

apply_to_children1

 

Boolean

override_positional_lights2

 

Boolean

override_infinite_lights3

 

Boolean

active_light_value4

 

Boolean

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)

  • None.

Composed of (two-way)

Composed of (two-way metadata) (inherited)

  • None.

Composed of (two-way metadata)

  • None.

Component of (two-way) (inherited)

  • None.

Component of (two-way)

Constraints

Clarifications

1 For a <DRM Light Source> instance (that is, an instance of one of the concrete classes descended from the class) that is a component of some <DRM Aggregate Geometry>, apply_to_children provides a mechanism for limiting the scope of the <DRM Light Source>. If apply_to_children is TRUE, only <DRM Primitive Geometry> in the component tree of those <DRM Aggregate Geometry> instances are affected by the given <DRM Light Source>. If apply_to_children is FALSE, the <DRM Light Source> is not limited to the scope of those <DRM Aggregate Geometry> instances and thus applies globally.

2 For a <DRM Light Source> instance that is a component of some <DRM Aggregate Geometry>, override_positional_lights provides a mechanism to indicate with a value of TRUE that the effect of the given <DRM Light Source> overrides that of any <DRM Base Positional Light> instances that would have otherwise applied to that <DRM Aggregate Geometry> - for example, if the given <DRM Light Source> is so close to the affected <DRM Geometry> that the <DRM Base Positional Light> effects would be negligible. If override_positional_lights = FALSE, the effect of the given <DRM Light Source> is combined with that of any <DRM Base Positional Light> instances that are already in effect.

3 For a <DRM Light Source> instance (that is, an instance of one of the concrete classes descended from the class) that is a component of some <DRM Aggregate Geometry>, override_infinite_lights provides a mechanism to indicate with a value of TRUE that the effect of the given <DRM Light Source> overrides that of any <DRM Infinite Light> instances that would have otherwise applied to that <DRM Aggregate Geometry>. If override_infinite_lights = FALSE, the effect of the given <DRM Light Source> is combined with that of any <DRM Infinite Light> instances that are already in effect.

4 A value of TRUE indicates that the light is on, while a value of FALSE indicates that the light is off. For a <DRM Light Source> with a <DRM Light Source Control Link> instance as a component, this is the default state of the light.

5 If a <DRM Light Source> instance is subject to dynamic control - that is, if it can be turned on and off - it will have a <DRM Light Source Control Link> component to express that control mechanism.

Example(s)

See individual subclasses for examples.