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

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

Entity description

Shadow control.png

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


Keyvalues

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.
Name (targetname) <string>
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

Start Disabled (StartDisabled) <boolean>
Stay dormant until activated (with theEnableinput).

Inputs

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

EnableDisable:

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

Outputs