The SEDRIS Data Representation Model
APPENDIX A - Classes
Positional Light

Class Name: Positional Light

Superclass - <Base Positional Light>

Subclasses

This DRM class is concrete and has no subclasses.

Definition

An instance of this DRM class is a <Base Positional Light> instance that radiates in all directions from a specified point in 3D space, affecting only objects within the sphere of influence centred at that point and specified by the value of its radius field.

Primary Page in DRM Diagram:

Secondary Pages in DRM Diagram:

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

Example

  1. A <Positional Light> instance represents streetlight on a pole.

FAQs

No FAQs supplied.

Constraints

Composed of (two-way) (inherited)

Component of (two-way) (inherited)

Inherited Field Elements

SE_Boolean apply_to_children; 4
SE_Boolean override_positional_lights; 5
SE_Boolean override_infinite_lights; 6
SE_Boolean active_light_value; 7
SE_Float radius; 8
SE_Long_Float constant_attenuation_factor; 9
SE_Long_Float linear_attenuation_factor; 10
SE_Long_Float quadratic_attenuation_factor; 11

Notes

Composed of Notes


Classification_Data

A <Classification Data> component, if present, allows a data provider to specify whether the <Light Source> instance represents an environmental object, such as the sun.


Light_Source_Control_Link

If a <Light Source> instance is to be turned on and off dynamically, it has a <Light Source Control Link> component to express that control mechanism.


Location_3D

The <Location 3D> component specifies the position of the <Base Positional Light> instance.

Fields Notes

apply_to_children

For a <Light Source> instance that is a component of some <Aggregate Geometry> instance(s), apply_to_children provides a mechanism for limiting the scope of the <Light Source> instance. If apply_to_children is SE_TRUE, only <Primitive Geometry> instances in the component tree of those <Aggregate Geometry> instances are affected by the <Light Source> instance. If apply_to_children is SE_FALSE, the <Light Source> instance is not limited to the scope of those <Aggregate Geometry> instances and thus applies globally.

override_positional_lights

For a <Light Source> instance that is a component of some <Aggregate Geometry> instance, override_positional_lights provides a mechanism to indicate with a value of SE_TRUE that the effect of the <Light Source> instance overrides that of any <Base Positional Light> instances that would have otherwise applied to that <Aggregate Geometry> instance.

EXAMPLE  This might be appropriate if the <Light Source> instance is so close to the affected <Geometry Representation> instance(s) that the effects of the <Base Positional Light> instances would be negligible.

If override_positional_lights = SE_FALSE, the effect of the <Light Source> instance is combined with that of any <Base Positional Light> instances that are already in effect.

override_infinite_lights

For a <Light Source> instance that is a component of some <Aggregate Geometry> instance, override_infinite_lights provides a mechanism to indicate with a value of SE_TRUE that the effect of the <Light Source> instance overrides that of any <Infinite Light> instances that would have otherwise applied to that <Aggregate Geometry> instance. If override_infinite_lights = SE_FALSE, the effect of the <Light Source> instance is combined with that of any <Infinite Light> instances that are already in effect.

active_light_value

A value of SE_TRUE for the active_light_value field indicates that the light is on, while a value of SE_FALSE indicates that the light is off. For a <Light Source> instance with a <Light Source Control Link> component X, the value of the active_light_value field is obtained from X.

radius

The radius field, which is specified in metres, together with the <Location 3D> component specifies the zone of influence of the <Base Positional Light> instance.

constant_attenuation_factor

The constant_attenuation_factor field is the constant "a" in the attenuation quadratic (a + bd + cd2).

linear_attenuation_factor

The linear_attenuation_factor field is the constant "b" in the attenuation quadratic (a + bd + cd2).

quadratic_attenuation_factor

The quadratic_attenuation_factor field is the constant "c" in the attenuation quadratic (a + bd + cd2).


Prev: Polyhedron. Next: Predefined Function. Up:Index.

Last updated: July 26, 2006 Copyright © 2006 SEDRIS