Shadow control: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
No edit summary
No edit summary
Line 14: Line 14:
: {{tip|Shortening this distance can be used to approximate the effects of diffuse [[lighting]].}}}}
: {{tip|Shortening this distance can be used to approximate the effects of diffuse [[lighting]].}}}}
{{KV|All Shadows Disabled|intn=disableallshadows|choices|Disable shadows entirely.}}
{{KV|All Shadows Disabled|intn=disableallshadows|choices|Disable shadows entirely.}}
{{KV|Force Blob shadows|intn=ForceBlobShadows|choices|Enable blobby shadows (same that you can see if use lowest shadow detail).}}|only={{Black Mesa}}|
{{KV|Force Blob shadows|intn=ForceBlobShadows|choices|Enable blobby shadows (same that you can see if use lowest shadow detail).}}|only={{BMS}}|
{{warning|Never disable, otherwise game will crash on map launch.}}
{{warning|Never disable, otherwise game will crash on map launch.}}
{{KV|Enable Local Light Shadows|intn=enableshadowsfromlocallights|boolean|Enable shadow direction to be calculated on a per-entity basis and to be dictated by the light closest to the entity.
{{KV|Enable Local Light Shadows|intn=enableshadowsfromlocallights|boolean|Enable shadow direction to be calculated on a per-entity basis and to be dictated by the light closest to the entity.

Revision as of 08:57, 16 September 2023

English (en)Русский (ru)中文 (zh)Translate (Translate)
C++ Class hierarchy
CShadowControl
CBaseEntity
C++ shadowcontrol.cpp

Template:Format It defines the direction, color and attenuation distance of the dynamic shadows created by light_environment for the entire map.

Note.pngNote:Since Template:Game name, shadow direction can be determined by local lights instead of a global value. See below for more details.
Icon-Bug.pngBug:At least in Counter-Strike: Source Counter-Strike: Source, if the current level does not have this entity, shadow properties (angles and distance) will transfer from previous map that had shadow_control. Confirm in other games.  [todo tested in ?]

Template:Map properties

Note.pngNote:Deprecated in Counter-Strike: Global Offensive Counter-Strike: Global Offensive. Use env_cascade_light instead

Keyvalues

Shadow Color (color) <color255>
This is the color of the shadows.
Maximum Distance (distance) <float>
This is the maximum distance the shadow is allowed to cast, in inches.
Tip.pngTip:Shortening this distance can be used to approximate the effects of diffuse lighting.
All Shadows Disabled (disableallshadows) <choices>
Disable shadows entirely.
Force Blob shadows (ForceBlobShadows) <choices>
Enable blobby shadows (same that you can see if use lowest shadow detail).|only=Black Mesa|
Warning.pngWarning:Never disable, otherwise game will crash on map launch.
Enable Local Light Shadows (enableshadowsfromlocallights) <boolean> (in all games since Left 4 Dead) (also in Garry's ModMapbasePortal 2: Community Edition)
Enable shadow direction to be calculated on a per-entity basis and to be dictated by the light closest to the entity.
Note.pngNote:This keyvalue may not be available in some FGDs.
Cpp.pngCode:There is a custom version of this feature which could run on previous versions of Source. Click here for more information.
Tip.pngTip:Pitch is the sun's angle of elevation from the ground, and yaw is its compass bearing.
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

Inputs

color <color255RedirectInput/color32>
Set the shadow color.
direction <vectorRedirectInput/Vector>
Set the shadow direction.
SetDistance <floatRedirectInput/float>
Set the maximum shadow cast distance.
SetAngles <stringRedirectInput/string>
Set the shadow direction.
SetShadowsDisabled <integerRedirectInput/integer>
Set shadows disabled state.
SetForceBlobsEnabled <integerRedirectInput/integer>
Set shadows blob state.|only=Black Mesa|
Warning.pngWarning:Never set 0, otherwise game will crash with this message.
If you'll try set to 1
SetShadowsFromLocalLightsEnabled <integerRedirectInput/integer> (in all games since Left 4 Dead) (also in Garry's ModMapbasePortal 2: Community Edition)
Set local light shadows enabled state.
Note.pngNote:This input may not be available in some FGDs.

See Also