Light¶

name: Light
documentation:

A source of illumination with three different modes: point, spot and directional

extension
base: imml:MovableElement

choice: The following element types can be used in conjunction with this element
maxOccurs: unbounded
minOccurs: 0

Allow multiple of these elements

element
type: imml:Repeater
name: Repeater
maxOccurs: unbounded
minOccurs: 0

element
type: imml:Stack
name: Stack
maxOccurs: unbounded
minOccurs: 0

element
type: imml:Grid
name: Grid
maxOccurs: unbounded
minOccurs: 0

element
type: imml:Model
name: Model
maxOccurs: unbounded
minOccurs: 0

element
type: imml:Effect
name: Effect
maxOccurs: unbounded
minOccurs: 0

element
type: imml:Text
name: Text
maxOccurs: unbounded
minOccurs: 0

element
type: imml:Primitive
name: Primitive
maxOccurs: unbounded
minOccurs: 0

element
type: imml:Sound
name: Sound
maxOccurs: unbounded
minOccurs: 0

element
type: imml:Light
name: Light
maxOccurs: unbounded
minOccurs: 0

element
type: imml:Camera
name: Camera
maxOccurs: unbounded
minOccurs: 0

element
type: imml:Widget
name: Widget
maxOccurs: unbounded
minOccurs: 0

element
type: imml:Trigger
name: Trigger
maxOccurs: unbounded
minOccurs: 0

element
type: imml:MaterialGroup
name: MaterialGroup
maxOccurs: unbounded
minOccurs: 0

element
name: Define
maxOccurs: unbounded
minOccurs: 0
type: imml:Parameter
documentation:

A key/value pair defining a variable attached to this node

Allow only one of these elements

element
name: Network
type: imml:Network
maxOccurs: 1
minOccurs: 0

attribute
name: Enabled
type: imml:Boolean
use: optional
default: True
documentation:

When true, light is cast

attribute
name: CastShadows
type: imml:Boolean
use: optional
default: True
documentation:

When true, shadows are cast by this light

attribute
name: ConstantAttenuation
type: xs:float
use: optional
documentation:

Constant attenuation value specifying how the light intensity changes over distance. Valid values between 0 and infinity. Does not affect lights of type Directional.

attribute
name: LinearAttenuation
type: xs:float
use: optional
documentation:

Linear attenuation value specifying how the light intensity changes over distance. Valid values between 0 and infinity. Does not affect lights of type Directional.

attribute
name: QuadraticAttenuation
type: xs:float
use: optional
documentation:

Quadratic attenuation value specifying how the light intensity changes over distance. Valid values between 0 and infinity. Does not affect lights of type Directional.

attribute
name: Range
type: xs:float
use: optional
documentation:

Distance beyond which the light has no effect. Does not affect lights of type Directional.

attribute
name: Falloff
type: xs:float
use: optional
documentation:

Decrease in illumination between a spotlight's InnerCone and the outer edge of the OuterCone. Only valid for lights of type Spot

attribute
name: Diffuse
type: imml:Colour
use: optional
documentation:

Diffuse colour emitted by the light when enabled

attribute
name: Specular
type: imml:Colour
use: optional
documentation:

Specular colour emitted by the light when enabled

attribute
name: Type
type: imml:LightType
use: required
documentation:

The type of light source to simulate

attribute
name: InnerCone
type: xs:float
use: optional
documentation:

The angle in degrees of the inner cone. This value must be in the range from 0 through the value specified by OuterCone. Only valid for lights of type Spot.

attribute
name: OuterCone
type: xs:float
use: optional
documentation:

The angle in degrees of the outer cone. Points outside this cone are not lit. This value must be between 0 and pi. Only valid for lights of type Spot.