Beam spotlight

Template:Base point It is used to draw a spotlight. Will draw a beam when the player views it side on, and a halo when it's facing towards the player. It will also create a dynamic light wherever the end of the spotlight rests. Other than its ability to rotate, this entity is functionally identical to point_spotlight.

Note:This spotlight is entirely client side, and rotation may be desynchronized between clients.

Idea:Can be set to rotate for a lighthouse search beam effect.

In code, it is represented by theCBeamSpotlightclass, defined in thebeamspotlight.cppfile.

Flags

• 1: Start On
• 2: No Dynamic Light - Do not create any actual light. This may look unrealistic.
• 4: Start rotation on
• 8: Reverse Direction
• 16: X Axis (^[Clarify] are these axes relative to the world or to the entity?)
• 32: Y Axis

Keyvalues

Max Rotation Speed (maxspeed) ([todo internal name (i)]) <integer>

The maximum rotation speed of the spotlight, in degrees per second.

Spotlight Length (SpotlightLength) ([todo internal name (i)]) <integer>

Length of the spotlight beam.

Spotlight Width (SpotlightWidth) ([todo internal name (i)]) <integer>

Width of the spotlight beam.

Color (R G B) (rendercolor) ([todo internal name (i)]) <color255>

The color of the beam. Black makes the beam invisible.

HDR color scale (HDRColorScale) ([todo internal name (i)]) <float>

float value to multiply sprite color by when running in HDR mode.

Halo Sprite (HaloSprite) ([todo internal name (i)]) <sprite>

The material that should be used for the halo.

Beam Sprite (BeamSprite) ([todo internal name (i)]) <sprite>

The material that should be used for the beam.

RenderFields:

Render Mode (rendermode) <byte choices>

Set a non-standard rendering mode on this entity.

Render Modes

0: Normal 1: Color 2: Texture 3: Glow 4: Solid/Alphatest 5: Additive 6: Removed, does nothing 7: Additive Fractional Frame 8: Alpha Add 9: World Space Glow 10: Don't Render

Render FX (renderfx) <byte choices>

Various somewhat legacy alpha effects. See render effects.

Render Amount / Transparency (renderamt) <byte>

Transparency amount, requires a Render Mode other than Normal. 0 is invisible, 255 is fully visible.

Render Color (R G B) (rendercolor) <color255>

Color tint.

Minimum / Maximum Effect Details Level (mincpulevel / maxcpulevel) <integer choices> (in all games since )

Don't render for players with Effect Details levels that exceed the minimum or maximum.

Choices

0: Default ("Low" for mincpulevel, "High" for maxcpulevel) 1: Low 2: Medium 3: High

Minimum / Maximum Shader Details Level (mingpulevel / maxgpulevel) <integer choices> (in all games since )

Don't render for players with Shader Details levels that exceed the minimum or maximum.

Choices

0: Default ("Low" for mingpulevel, "Very High" for maxgpulevel) 1: Low 2: Medium 3: High 4: Very High

See also:  cpu_level / gpu_level convars

Inputs

LightOn

Turn the spotlight on.

LightOff

Turn the spotlight off

Start

Start rotating.

Stop

Stop rotating.

Reverse

Reverse the direction of rotation.

RenderFields:

Alpha <integer 0–255>

Sets the entity's transparency to a number from 0 (invisible) to 255 (fully visible). Requires the entity to have its rendermode set to a number other than 0.

Color <color255RedirectInput/color32>

Sets an RGB color for the entity.

Outputs

OnLightOn

Fires when light turns on.

OnLightOff

Fires when light turns off.