Template:KV BmNewLightShadowMain: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
No edit summary
m (Indented Expand and removed its margin_left.)
Line 7: Line 7:
-->
-->
{{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.
:{{important|Brush entities and [[Bmodel|bmodels]] are also included in static shadowmaps and they never update (including {{ent|func_physbox}}).}}
::{{important|Brush entities and [[Bmodel|bmodels]] are also included in static shadowmaps and they never update (including {{ent|func_physbox}}).}}
:{{note|Static shadowmaps will update after save reload (only once).}}
::{{note|Static shadowmaps will update after save reload (only once).}}
*1: Stationary - the same as Static, but with dynamic shadows for dynamic models.
:*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.
:*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.
{{expand|margin_left=2em|title=Examples|
:{{expand|title=Examples|
{{note|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.}}
{{note|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.}}
<gallery mode=packed heights=290px>
<gallery mode=packed heights=290px>
Line 22: Line 22:
}}
}}
{{KV|HasShadow|intn=HasShadow|choices|Sets shadows state for the light, enabled or disabled. Remember that the default choices is No.
{{KV|HasShadow|intn=HasShadow|choices|Sets shadows state for the light, enabled or disabled. Remember that the default choices is No.
*0: No
:*0: No
*1: Yes}}
:*1: Yes
{{expand|margin_left=2em|title=Examples|
}}
:{{expand|title=Examples|
<gallery mode=packed heights=290px>
<gallery mode=packed heights=290px>
File:HasShadow0.jpg| thumb | left | 510px | Has Shadow - NO
File:HasShadow0.jpg| thumb | left | 510px | Has Shadow - NO
Line 31: Line 32:
}}
}}
{{KV|ShadowMapLOD|intn=ShadowLod|choices|Resolution of shadowmap used by this light. This affects the quality of the shadows.
{{KV|ShadowMapLOD|intn=ShadowLod|choices|Resolution of shadowmap used by this light. This affects the quality of the shadows.
*0: 256
:*0: 256
*1: 512
:*1: 512
*2: 1024
:*2: 1024
{{expand|margin_left=2em|title=Examples|
:{{expand|title=Examples|
<gallery mode=packed heights=290px>
<gallery mode=packed heights=290px>
File:ShadowMapLOD256.jpg| thumb | left | 510px | 256
File:ShadowMapLOD256.jpg| thumb | left | 510px | 256
Line 41: Line 42:
</gallery>
</gallery>
}}
}}
{{important|You cannot use any value from here an unlimited number of times. More information [[NewLight_Point#Shadow_map_slots|below]].}}
:{{important|You cannot use any value from here an unlimited number of times. More information [[NewLight_Point#Shadow_map_slots|below]].}}
}}
}}
{{KV|ShadowRadius|intn=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 {{command|nr_shadow_rad_High}}, {{command|nr_shadow_rad_Med}} and {{command|nr_shadow_rad_Low}}.
{{KV|ShadowRadius|intn=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 {{command|nr_shadow_rad_High}}, {{command|nr_shadow_rad_Med}} and {{command|nr_shadow_rad_Low}}.
{{expand|margin_left=2em|title=Examples|
:{{expand|title=Examples|
<gallery mode=packed heights=290px>
<gallery mode=packed heights=290px>
File:ShadowRaduis1.jpg| thumb | left | 510px | ShadowRadius - 0.0001
File:ShadowRaduis1.jpg| thumb | left | 510px | ShadowRadius - 0.0001
Line 51: Line 52:
</gallery>
</gallery>
}}
}}
{{tip|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.}}
:{{tip|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.}}
}}
}}
{{KV|NearZ|intn=NearZ|float|NearZ used by shadowmap camera for this light. This is the distance at which the light source will start cast shadows.}}
{{KV|NearZ|intn=NearZ|float|NearZ used by shadowmap camera for this light. This is the distance at which the light source will start cast shadows.}}

Revision as of 23:34, 17 January 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.