Table 6.297 — DRM_Volume_Light_Behaviour

Property

Description

Class

  • <DRM Volume Light Behaviour>

Superclass

Subclass

  • None.

Definition

An instance of this DRM class is a <DRM Light Rendering Behaviour>, the colour of which varies depending on the observer's position relative to the light's location and to the volume's geometry. The volume surrounds the light. Within the volume, the light has the primary colour; outside the volume, it takes the secondary colour.

Class diagram

Figure 6.356 — DRM_Volume_Light_Behaviour

Inherited field elements

Field name

Range

Field data type

None

   

Field elements

Field name

Range

Field data type

use_full_intensity1

 

Boolean

minimum_colour_intensity2

 

Long_Float

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)

Component of (two-way)

  • None.

Constraints

Clarifications

1 If TRUE, this value indicates that the full intensity of the light is shown within the volume. Otherwise, the intensity of the light decreases towards the minimum_colour_intensity value) as the observer moves away from the light. The intensity of the light reaches the minimum_colour_intensity value when the observer reaches the boundary of the volume.

2 This value, which shall be between 0.0 and 1.0, is used in conjunction with the intensity value of the primary colour. If the primary colour is a <DRM Colour Index> instance, the full intensity is the intensity attribute of that instance. If the primary colour is an <DRM Inline Colour>, the full intensity is 1.0.

If the observer's location is the same as that of the light, it receive the full (intensity) value. As the observer moves away from the light (but is still within the volume), the intensity decreases toward the minimum_colour_intensity value, unless use_full_intensity = TRUE). Once the observer is outside the volume, the intensity is that of the minimum_colour_intensity value. If the minimum_colour_intensity value is 0.0 and the observer is outside the volume, the secondary colour will be seen. If no secondary colour is used, nothing will be seen.

3 This specifies the centre of the volume.

4 This specifies the shape of the volume.

Example(s)