Beam spotlight: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
mNo edit summary
m (swapped entity template and swapped other templates for new ones)
Line 1: Line 1:
{{lang|Beam spotlight}}
{{lang|Beam spotlight}}
{{CD|CBeamSpotlight|file1=beamspotlight.cpp}}
{{CD|CBeamSpotlight|file1=beamspotlight.cpp}}
{{base point|beam_spotlight|sprites=1|since=Left 4 Dead}} 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 {{ent|point_spotlight}}.


{{note|This spotlight is entirely client side, and rotation may be desynchronized between clients.}}
{{entity|type=e0|beam_spotlight|sprite=1|engine=2|since=Left 4 Dead}} 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 {{ent|point_spotlight}}.
{{note|This entity is also available in {{game link|Garry's Mod}}.}}


{{idea|Can be set to rotate for a lighthouse search beam effect.}}
{{ModernNote|This spotlight is entirely client side, and rotation may be desynchronized between clients.}}
{{ModernNote|This entity is also available in {{game link|Garry's Mod}}.}}
 
{{ModernTip|Can be set to rotate for a lighthouse search beam effect.}}


==Flags==
==Flags==

Revision as of 03:32, 28 March 2023

English (en)Русский (ru)Translate (Translate)
C++ Class hierarchy
CBeamSpotlight
CBaseEntity
C++ beamspotlight.cpp

Template:Entity 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.

Template:ModernNote Template:ModernNote

Template:ModernTip

Flags

Start On : [1]
No Dynamic Light - Do not create any actual light. : [2]
Start with Rotation On : [4]
Reverse Direction : [8]
X Axis : [16]
Y Axis : [32]

([Clarify] are these axes relative to the world or to the entity?)

Keyvalues

Max Rotation Speed (maxspeed) <integer>
The maximum rotation speed of the spotlight, in degrees per second.
Spotlight Length (SpotlightLength) <integer>
Length of the spotlight beam.
Spotlight Width (SpotlightWidth) <integer>
Width of the spotlight beam.
HDR color scale (HDRColorScale) <float>
Multiplier for sprite color by when running in HDR mode.
Halo Sprite (HaloSprite) <sprite> (only in Left 4 Dead)
The material that should be used for the halo.
Beam Sprite (BeamSprite) <sprite> (only in Left 4 Dead)
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 Obsolete
  • 5: Additive
  • 6: Removed, does nothing Obsolete
  • 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.

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.