Table 6.211 — DRM_Pyramid_Directional_Light

Property

Description

Class

  • <DRM Pyramid Directional Light>

Superclass

Subclass

  • None.

Definition

An instance of this DRM class specifies a light, the intensity of which varies depending on the observer’s position relative to the light’s location, direction, and pyramid-shaped lobe.

If a secondary colour exists, it is seen outside the lobe.

If TRUE, the use_full_intensity field specifies that the full intensity of the light is shown in the pyramid shaped area. Otherwise, the intensity of the light decreases (towards the minimum_colour_intensity value) as one moves away from the LIGHT_DIRECTION vector.

The minimum_colour_intensity field’s value is used in conjunction with the primary colour’s full intensity value. If the primary colour is a <DRM Colour Index> instance, the full intensity is specified by its intensity_level field. If the primary colour is a <DRM Inline Colour> instance, the full intensity is 1,0.

A location in the direct path of the <DRM Lobe Data> instance’s LIGHT_DIRECTION vector receives the full intensity value. If use_full_intensity is FALSE, the intensity decreases with increasing distance from the LIGHT_DIRECTION vector, until the boundary specified by the horizontal_width and vertical_width of the <DRM Lobe Data> instance is reached. Outside the lobe, the intensity is minimum_colour_intensity. If the minimum_colour_intensity value is 0,0, the secondary colour (if present) shall be seen outside the lobe at full intensity. If no secondary colour is present, nothing shall be visible outside the lobe.

If the value of the invisible_behind field is TRUE, the directional light is invisible when viewed from behind the plane of the directional light.

Class diagram

Figure 6.257 — DRM_Pyramid_Directional_Light

Inherited field elements

Field name

Range

Field data type

None

   

Field elements

Field name

Range

Field data type

use_full_intensity

 

Boolean

minimum_colour_intensity

[0,0, 1,0]

Long_Float

invisible_behind

 

Boolean

Default field values

Default field values for DRM_Pyramid_Directional_Light

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)

Composed of (two-way)

  • None.

Composed of (two-way metadata) (inherited)

  • None.

Composed of (two-way metadata)

  • None.

Component of (two-way) (inherited)

Component of (two-way)

  • None.

Constraints

Clarifications

1The <DRM Lobe Data> component specifies the lobe shape.

Example(s)