Lights (Effects)

The light component, as its name says, is used to emit light. It is never used in the game.

Keyword: light

Attributes

type <enum>

The type of light emission; one of the values of the following enumeration:

• ambient
• dir or directional
• point
• spot
• area

---

life <float> -single -loop <int> -sustain <int>

Used to define the life time of the light, in seconds; once this time is over the component will die.

The options -single, -loop and -sustain are mutually exclusive, meaning you can only have one at a time:

• -single: The light only appears once, and when the lifetime is over it dies.
• -loop: The light reappears the specified number of times.
• -sustain

---

color <float...>

The color of the emitted light. This field is animatable, so multiple colors can be specified to change the color over the lifetime of the light.

---

size <float...>

The size of the light, with the default value being 1.0. This field is animatable, so multiple values can be specified to change the size over the lifetime of the light. This attribute is exclusive with spotWidth, you can only have one of them.

---

spotWidth <float...> -penumbra <float>

Same as size, but you can specify the penumbra value as well.

---

flags <bitfield>

Some flags that define certain properties (each bit is a different value), its usage is unknown.

---

Examples

light lightEffect
	color (1, 0, 0) (1, 0.4, 0)
	size 3 2 3
	life 15 -single
	type spot
	spotWidth 2.5
end