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 2000 metres 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 500 metre 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 3000 metres then the final_intensity is 1.0 (using the secondary colour) because the observer is outside the volume and there is a secondary colour on the <Volume Light Behaviour> instance.

  2. The <Volume Light Behaviour> instance has a primary colour that is an <Inline Colour> instance (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> instance is a <Spherical Volume Extent> instance 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

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.

Fields Notes


use_full_intensity

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

minimum_colour_intensity

 The value of the minimum_colour_intensity field, 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 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 = 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 Geometry. Next: Volume LOD Data. Up:Index.

Last updated: July 16, 2004 Copyright © 2004 SEDRIS