Env cascade light

From Valve Developer Community
Revision as of 22:47, 15 May 2017 by Kidnation (talk | contribs) (I just recently found out that Insurgency is able to have dynamic lights in the game with CSM, since it's using an old build of CSGO. CSGO also had an update a few days ago thats supposed to fix this issue, there are still problems, however.)
Jump to navigation Jump to search

Template:Base point multi

Entity description

It casts an extremely accurate shadow map via the "tools/skybox" texture, acting as a real-time variation of light_environment. This form of lighting is known as cascade shadow maps which works by rendering shadow maps at scaling resolutions based on the players initial camera vector from the center of a spatial grid. These shadow maps are then stitched together, with the the accuracy and quality of the shadow maps scaling lower the further they are away from the player, thus trading accuracy for performance. Some games automatically add this entity to the map. But it can be placed manually to allow for it to be manipulated or killed to allow such things as dynamic lighting.


Icon-Bug.pngBug:In Counter-Strike: Global Offensive, this entity breaks Light Styles when active, which means named lights or lights with an animated appearance won't work correctly when this entity is active, however, a patch here recently claims to have fixed this issue, although there are problems still visible in certain situations.  [todo tested in ?]
Icon-Bug.pngBug:In Insurgency, you must compile your map with HDR in order to see the shadows from this entity, they'll be very faint otherwise!  [todo tested in ?]
Note.pngNote:It is recommended to have a light_environment in your map to create radiosity based lighting, as this entity does not bake radiosity and only creates a real-time shadow map.
Note.pngNote:Black Mesa: Source has their own implementation of this entity, which preserves Light Styles, it also has keyvalues that have yet to have been documented here.

Keyvalues

Light Color ([todo internal name (i)]) <color255>
This is the color of the sunlight.
Max shadow distance ([todo internal name (i)]) <boolean>
Maximum dynamic shadow distance. Higher values are slower, default on PC is 400 units.
Use light_environment's angles ([todo internal name (i)]) <float>
If true, the CSM shadow angles are automatically harvested from the light_environment's angles. If false, this entity's angles are used.
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

Start Disabled (StartDisabled) <boolean>
Stay dormant until activated (with theEnableinput).
Pitch Yaw Roll (Y Z X) (angles) <QAngle>
This entity's orientation in the world. Pitch is rotation around the Y axis, yaw is the rotation around the Z axis, roll is the rotation around the X axis.

Inputs

EnableDisable:

Enable / Disable
Enable/disable this entity from performing its task. It might also disappear from view.
SetAngles <stringRedirectInput/string>
Set the shadow direction.
LightColor <color255RedirectInput/color32>
This is the color of the sunlight.

Outputs