Light Help¶

• Light Help
• Introduction
• Child Elements
• Example
• Attributes
• Enabled
• CastShadows
• ConstantAttenuation
• LinearAttenuation
• QuadraticAttenuation
• Range
• Falloff
• Diffuse
• Specular
• Type
• InnerCone
• OuterCone
• See Also
• Comments

Introduction¶

Lights provide illumination within IMML. They have different modes; Point, Spot and Directional

Child Elements¶

Allows 0 to Many of these elements

• Camera
• Define
• Grid
• Light
• MaterialGroup
• Model
• Primitive
• Repeater
• Sound
• Stack
• Text
• Trigger
• Widget

Only One of each of these elements are allowed

• Shader
• Network

Example¶

1 <Light Name="Light" Enabled="True" InnerCone="10" Range="20" Type="Point" Diffuse="#666666" Specular="#333333" Position="-11.43102,17.41145,-13.84528"/>

Attributes¶

Enabled¶

Type	imml:Boolean
Use	optional
Default	True
Documentation	When true, light is cast

CastShadows¶

Type	imml:Boolean
Use	optional
Default	True
Documentation	When true, shadows are cast by this light

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.

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.

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.

Range¶

Type	xs:float
Use	optional
Documentation	Distance beyond which the light has no effect. Does not affect lights of type Directional.

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

Diffuse¶

Type	imml:Colour
Use	optional
Documentation	Diffuse colour emitted by the light when enabled

Specular¶

Type	imml:Colour
Use	optional
Documentation	Specular colour emitted by the light when enabled

Type¶

Type	imml:LightType
Use	required
Documentation	The type of light source to simulate

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.

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.

See Also¶

Dynamic use of the light element in the Light table