This article's documentation is for anything that uses the Source engine. Click here for more information.

sunlight_shadow_control

From Valve Developer Community
Jump to navigation Jump to search
Class hierarchy
CSunlightShadowControl
CBaseEntity
sunlightshadowcontrol.cpp
Shadow control.png

sunlight_shadow_control is a logical entity available in all Source Source games since Alien Swarm Alien Swarm.

An entity to control the sunlight that casts shadows in the map. Nearly identical to env_global_light in both function and appearance.

Keyvalues

Name (targetname) <string> [ Edit ]
The name that other entities refer to this entity by, via Inputs/Outputs or other keyvalues (e.g. parentname or target).
Also displayed in Hammer's 2D views and Entity Report.
See also:  Generic Keyvalues, Inputs and Outputs available to all entities

Pitch Yaw Roll (Y Z X) ([todo internal name (i)]) <string>
This is the light cast direction. Pitch is rotation around the Y axis, yaw is the rotation around the Z axis, and roll is the rotation around the X axis.
Light Color ([todo internal name (i)]) <color255>
This is the color of the sunlight.
Color Transition Time ([todo internal name (i)]) <float>
This is the number of seconds it takes to get from 0 to 255.
Distance ([todo internal name (i)]) <float>
This is the distance of the sun, greater distances produce more orthogonal shadows.
FOV ([todo internal name (i)]) <float>
This is the field of view that the sunlight casts in. Use lower values for more distant sun and sharper shadows.
NearZ Distance ([todo internal name (i)]) <float>
This controls the near clipping plane's distance from the player.
North Offset ([todo internal name (i)]) <float>
This offsets the from the player position where the sun is attached.
Texture Name ([todo internal name (i)]) <material>
Enable Shadows ([todo internal name (i)]) <boolean>
Enables/disables shadows from this projected texture.
Start Disabled (StartDisabled) <boolean>
Stay dormant until activated (with theEnableinput).

Inputs

LightColor <color255RedirectInput/color32>
Set the light color.
SetAngles <stringRedirectInput/string>
Set the sun direction.
SetDistance <floatRedirectInput/float>
Set the distance of the sun.
SetFOV <floatRedirectInput/float>
Set the field of view the sun casts.
SetNearZDistance <floatRedirectInput/float>
Set the near z distance.
SetNorthOffset <floatRedirectInput/float>
Sets the north offset.
SetTexture <stringRedirectInput/string>
Set the texture cookie of the sunlight.
EnableShadows <booleanRedirectInput/boolean>
Set the if shadows are enabled

EnableDisable:

Enable / Disable
Enable/disable this entity from performing its task. It might also disappear from view.