Table 6.302 — 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> instance, 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.

If TRUE, the use_full_intensity field specifies 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.

The value of the minimum_colour_intensity field 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_level of that instance. If the primary colour is a <DRM Inline Colour> instance, the full intensity is 1,0.

If the observer’s location is the same as that of the light, it receives 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 is seen. If no secondary colour is used, nothing is seen.

Class diagram

Figure 6.374 — DRM_Volume_Light_Behaviour

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

Default field values

Default field values for DRM_Volume_Light_Behaviour

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

1The <DRM Location 3D> component specifies the centre of the volume.

2The <DRM Volume Extent> component specifies the shape of the volume.

Example(s)