The SEDRIS Data Representation Model
APPENDIX A - Classes
Volume Light Behaviour

Class Name: Volume Light Behaviour

Superclass - <Light Rendering Behaviour>

Subclasses

This DRM class is concrete and has no subclasses.

Definition

An instance of this DRM class is a <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.

Primary Page in DRM Diagram:

Secondary Pages in DRM Diagram:

This class appears on only one page of the DRM class diagram.

Example

  1. The <Volume Light Behaviour> has a primary colour that is a <Colour Index> that has an intensity attribute of 0.95. The <Volume Light Behaviour> also has a secondary colour. The minimum_colour_intensity is 0.0. The use_full_intensity flag is SE_FALSE. The light is in the centre of the volume and the volume is a <Parallelepiped Volume Extent> representing a cube measuring 2000m per side.

    if:
    eye_distance_from_light = the distance of the viewing position from the light
    volume_distance_from_light = the distance between the light and the volume boundary along the same vector
    then:
    final_intensity = minimum_colour_intensity + (((volume_distance_from_light - eye_distance_from_light) / volume_distance_from_light) * (full_intensity - minimum_colour_intensity))

    If the observer's position from the light is a distance of 500m along a vector from the light to a corner of the volume then the final_intensity is 0.614.
    0.0 + (((1414.2 - 500.0) / 1414.2) * (0.95 - 0.0))

    If the observer's position from the light is 3000m then the final_intensity is 1.0 (using the secondary colour) because I am outside the volume and there is a secondary colour on the <Volume Light Behaviour>.

  2. The <Volume Light Behaviour> has a primary colour that is an <Inline Colour> (which makes the full intensity 1.0). The minimum_colour_intensity is 0.5. The use_full_intensity flag is SE_TRUE. The light is in the centre of the volume and the <Volume Extent> is a <Spherical Volume Extent> with a radius of 1000 metres.

    If the observer's distance from the light is a distance of 100 metres, the final_intensity is 1.0, since the observer's position is inside the volume and the use_full_intensity flag is set to SE_TRUE.

    If the observer's distance from the light is a distance of 0 units then the final_intensity is 1.0 since the observer's position is inside the volume and the use_full_intensity flag is set to SE_TRUE.

FAQs

No FAQs supplied.

Constraints

None.

Composed of (two-way)

Component of (two-way)(inherited)

Inherited Field Elements

This class has no inherited field elements.

Field Elements

SE_Boolean use_full_intensity; (notes)
SE_Long_Float minimum_colour_intensity; (notes)

Notes

Composed of Notes


Location_3D

 This specifies the centre of the volume.

Volume_Extent

 This specifies the shape of the volume.

World_Transformation

 If present, this component serves to locate and orient the
 volume within the currently scoped spatial reference frame.

Fields Notes


use_full_intensity

 If SE_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.

minimum_colour_intensity

 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 <Colour Index> instance, the
 full intensity is the intensity attribute of that instance.
 If the primary colour is an <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 = SE_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.

Prev: Volume Level Of Detail Data. Next: World 3x3. Up:Index.

Last updated: May 15, 2003 Copyright © 2003 SEDRIS™