Template:KV BmNewLightShadowMain: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
m (Indented Expand and removed its margin_left.)
No edit summary
 
Line 1: Line 1:
<!--
<!--Purpose:
 
We are using this template for one or multiple pages related to Black Mesa new light entities. These templates allows you to use the same text for entities that have many identical properties, without having to make the same changes for several pages separately. This template is also may used in some other templates.-->
Purpose:
 
We are using this template for one or multiple pages related to Black Mesa new light entities. These templates allows you to use the same text for entities that have many identical properties, without having to make the same changes for several pages separately. This template is also may used in some other templates.
 
-->
{{KV|Light Type|intn=LightType|choices|Type of the light. This affects the behavior of the light source with parent, enable/disable dynamic models in shadowmaps, enable/disable static shadowmaps.
{{KV|Light Type|intn=LightType|choices|Type of the light. This affects the behavior of the light source with parent, enable/disable dynamic models in shadowmaps, enable/disable static shadowmaps.
:*0: Static - used only static shadowmaps, this means that shadows are cast only by static objects ([[prop_static]], geometry, etc). Cannot move with parent.
:*0: Static - used only static shadowmaps, this means that shadows are cast only by static objects ([[prop_static]], geometry, etc). Cannot move with parent.

Latest revision as of 07:40, 24 June 2025


Light Type (LightType) <choices>
Type of the light. This affects the behavior of the light source with parent, enable/disable dynamic models in shadowmaps, enable/disable static shadowmaps.
  • 0: Static - used only static shadowmaps, this means that shadows are cast only by static objects (prop_static, geometry, etc). Cannot move with parent.
Icon-Important.pngImportant:Brush entities and bmodels are also included in static shadowmaps and they never update (including func_physbox).
Note.pngNote:Static shadowmaps will update after save reload (only once).
  • 1: Stationary - the same as Static, but with dynamic shadows for dynamic models.
  • 2: Dynamic - lighting don't use static shadowmaps at all. It uses dynamic shadows for static objects and dynamic models. This type also can move with parent. This type is expensive, usually used for moving lights, but also can be used if you're getting issues due to static shadowmaps.
Examples
Note.pngNote:Note that shadow from metal box and grate box are flying on first and second pictures, that's because both was placed in air on map spawn. Doesn't happen on third picture, because the light updated shadow for both.
HasShadow (HasShadow) <choices>
Sets shadows state for the light, enabled or disabled. Remember that the default choices is No.
  • 0: No
  • 1: Yes
Examples
ShadowMapLOD (ShadowLod) <choices>
Resolution of shadowmap used by this light. This affects the quality of the shadows.
  • 0: 256
  • 1: 512
  • 2: 1024
Examples
Icon-Important.pngImportant:You cannot use any value from here an unlimited number of times. More information below.
ShadowRadius (ShadowRadius) <float>
Radius of shadow edges for soft shadows. If its value is negative, code will auto assign a value depending on ShadowLod. These code based values can be adjusted via convars nr_shadow_rad_High, nr_shadow_rad_Med and nr_shadow_rad_Low.
Examples
Tip.pngTip:Don't use very low values, because the shadows will look like stairs. Also don't use very high values, because the noise will spoil them a lot, or you'll see only noise.
NearZ (NearZ) <float>
NearZ used by shadowmap camera for this light. This is the distance at which the light source will start cast shadows.