Light spot

Entity Description

A cone-shaped, invisible light source. Can be turned on and off through inputs, though switchable lights may cause lightmap errors. This is a static spotlight that can be pointed at another entity.

Note:When using this entity, it is often necessary to turn the brightness value up significantly for the effects of the light to be visible. Values of 3000-4000 are sometimes necessary for light sources like streetlights.

• light and point_spotlight
• Light entities
• Tutorial: Quadratic/Linear/Constant in Lights

Keyvalues

• Template:Kv targetname The targetname value for a spotlight will point the light at the entity named. If no targetname is available, the entity will point with it's angles paramater.

Warning:Adding a targetname to this entity creates a dynamic (switchable) light source, and creates extra lightmap pages for each uniquely named light. This occurs regardless of whether the light entity receives any inputs at run time. Lights should not be named unless they will be turned on and off via inputs, and then only sparingly. Lights given the same name will be triggered together and share lightmap pages. Many dynamic lights in a level can cause performance problems and other errors. Lightmaps calculated for named lights are conspicuously simpler and cruder than unnamed lights.

• Template:Kv angles This will control the direction the light points at, if no targetname is specified.

• Template:Kv shadowcast Setting this to yes will allow the entity to cast a single directional shadow via it's orientation by modifying the shadow_control angles.

• _inner_cone

<integer> This is the inner focus of the light, or the edge of the brightest part of the light. It will fade from here out to the edge of the light cone.

• _cone

<integer>

• Template:Kv light

Flags

• 1 : Initially Off

Inputs

• TurnOn

Turns the light on.

• TurnOff

Turns the light off.

• Toggle

Toggles the light on or off.

• SetPattern

Sets the light's custom appearance to the input's parameters.

• FadeToPattern

Fades from the light's old pattern to the new one.