light_environment

From Sven Co-op
Revision as of 00:29, 28 January 2019 by GeckonCZ (talk | contribs) (Import of converted entguide pages from Sven Manor.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
light_environment
Type

point

Status

supported

 


This entity will cause light to be emitted from all sky-textured surfaces in the map. Use this for sunlight, or pale blue moonlight, or whatever other light the environment in your map may have. The light and brightness emitted by this should fit your environment map to look right. Arrange target of light by using Pitch value and Yaw compass at object properties. Note that brushes using "SKY" texture cannot have mixed face content (whole sky brush need to be textured).

1 Keyvalues

ZHLT Fade : _fade

In the simplest words, it customizes light fading. '1.0' for normal fade, larger values for 'shorter' lights.

ZHLT Falloff : _falloff

Changed the way how the light is calculated in compile process. Default means 'Inverse square' (unless you changed default light spreading in compile commands). Linear option makes light spreading less, creating collimated light, just light movie projector, searchlights, flashlights e.t.c. Sometimes other light settings and light placement make this keyvalue nugatory.

Pitch : pitch

Determines position of the virtual sun. Pitch '0' for sun casting light from the ground level (minimal light, shadows simulates eclipse-like blackout), '90' for most top position (yaw value don't need to be set if pitch is 90 or -90). Negative values places sun beneath ground level, so in the basic sky configuration (sky textures above the ground) the map is full-lit (no shadows).

Brightness : _light

Red, green and blue amounts of the light color, from 0 to 255, followed by the brightness, which can have pretty much any value greater than 0. It is not limited to 200 or 255 and can be a decimal, although that level of precision is rarely required.

Ambient Color : _diffuse_light

Color and intensity of sky ambient color - light from sky itself, not directly from light source. E.g. ambient color for sunny cloudless day would be light blue. It will affect mostly shaded spots.

Sun Spread : _spread

You can control shadows of light_environment. It's useful when you want to add more realistic shadows depends on light type-for sunny day shadows will be sharper, when for cloudy or rainy weather more blurred:

2 Issues

Light and light_spot are ignored by models when light_environment is used, they will use lightning from sky only. Use light_spot with "Is sky" keyvalue set to "Yes" to fix this, but only if you need this (e.g. your map is dark and models not getting light from point lights).