Table 6.180 — DRM_Positional_Light
|
Property |
Description |
|||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Class |
|
|||||||||||||||||||||||||||
|
Superclass |
||||||||||||||||||||||||||||
|
Subclass |
|
|||||||||||||||||||||||||||
|
Definition |
An instance of this DRM class is a <DRM Base Positional Light> 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. |
|||||||||||||||||||||||||||
|
Class diagram |
||||||||||||||||||||||||||||
|
Inherited field elements |
|
|||||||||||||||||||||||||||
|
Field elements |
|
|||||||||||||||||||||||||||
Associated to (one-way) (inherited) |
|
|||||||||||||||||||||||||||
Associated to (one-way) |
|
|||||||||||||||||||||||||||
Associated by (one-way) (inherited) |
|
|||||||||||||||||||||||||||
Associated by (one-way) |
|
|||||||||||||||||||||||||||
Associated with (two-way) (inherited) |
|
|||||||||||||||||||||||||||
Associated with (two-way) |
|
|||||||||||||||||||||||||||
Composed of (two-way) (inherited) |
|
|||||||||||||||||||||||||||
Composed of (two-way metadata) (inherited) |
|
|||||||||||||||||||||||||||
Composed of (two-way metadata) |
|
|||||||||||||||||||||||||||
Component of (two-way) (inherited) |
|
|||||||||||||||||||||||||||
Component of (two-way) |
|
|||||||||||||||||||||||||||
|
Constraints |
||||||||||||||||||||||||||||
|
Clarifications |
1 For a <DRM Light Source> instance (that is, an instance of one of the concrete classes descended from the class) that is a component of some <DRM Aggregate Geometry>, apply_to_children provides a mechanism for limiting the scope of the <DRM Light Source>. If apply_to_children is TRUE, only <DRM Primitive Geometry> in the component tree of those <DRM Aggregate Geometry> instances are affected by the given <DRM Light Source>. If apply_to_children is FALSE, the <DRM Light Source> is not limited to the scope of those <DRM Aggregate Geometry> instances and thus applies globally. 2 For a <DRM Light Source> instance that is a component of some <DRM Aggregate Geometry>, override_positional_lights provides a mechanism to indicate with a value of TRUE that the effect of the given <DRM Light Source> overrides that of any <DRM Base Positional Light> instances that would have otherwise applied to that <DRM Aggregate Geometry> - for example, if the given <DRM Light Source> is so close to the affected <DRM Geometry> that the <DRM Base Positional Light> effects would be negligible. If override_positional_lights = FALSE, the effect of the given <DRM Light Source> is combined with that of any <DRM Base Positional Light> instances that are already in effect. 3 For a <DRM Light Source> instance (that is, an instance of one of the concrete classes descended from the class) that is a component of some <DRM Aggregate Geometry>, override_infinite_lights provides a mechanism to indicate with a value of TRUE that the effect of the given <DRM Light Source> overrides that of any <DRM Infinite Light> instances that would have otherwise applied to that <DRM Aggregate Geometry>. If override_infinite_lights = FALSE, the effect of the given <DRM Light Source> is combined with that of any <DRM Infinite Light> instances that are already in effect. 4 A value of TRUE indicates that the light is on, while a value of FALSE indicates that the light is off. For a <DRM Light Source> with a <DRM Light Source Control Link> instance as a component, this is the default state of the light. 5 This radius, which is specified in metres, together with the <DRM 3D Location> component defines the zone of influence of the given <DRM Base Positional Light> instance. 6 This is the constant “a” in the attenuation quadratic (a + bd + cd**2). 7 This is the constant “b” in the attenuation quadratic (a + bd + cd**2). 8 This is the constant “c” in the attenuation quadratic (a + bd + cd**2). 9 If a <DRM Light Source> instance is subject to dynamic control - that is, if it can be turned on and off - it will have a <DRM Light Source Control Link> component to express that control mechanism. 10 This specifies the position of the given <DRM Base Positional Light> instance. |
|||||||||||||||||||||||||||
|
Example(s) |
|