Template:KV BmNewLightBaseMain: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
(This template stores new lights related keyvalues for all MAIN new light ents from BMS. This template will be used in NewLight_Point, NewLights_Settings, NewLight_Spot.)
 
No edit summary
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{KV BmNewLightBase}}
<!--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 BmNewLightBase}}
{{KV|Enabled|intn=Enabled|Choices|
{{KV|Enabled|intn=Enabled|Choices|
Sets light state on spawn, enabled or disabled.
Sets light state on spawn, enabled or disabled.
*0: Enabled
:*0: Enabled
*1: Disabled}}
:*1: Disabled}}
{{KV|Appearance|intn=FlareStyle|Choices|Appearance presets.
{{KV|Appearance|intn=style|integer choices|Appearance presets.
{{Light appearances}}
{{Lightstyle presets}}
{{tip|Use new lights instead for lights with custom appearance, because static lightmapped lights reduces performance with this feature (especially near displacements).}}
:{{tip|Use new lights instead for lights with custom appearance, because static lightmapped lights reduces performance with this feature (especially near displacements).}}
{{ModernConfirm|Is it possible to have your own light styles (the property are using integer values) ?}}
:{{note|Custom light styles are not possible.}}
}}
}}
{{bug|hidetested=1|{{ent|NewLights_settings}} doesn't apply this property if applied on Static or Stationary light type. Fixes after save reload. Works fine with Dynamic light type.}}
{{KV|Light Ambient Color|intn=LightColorAmbient|color255|The RGB color of the shadows. Colors must be between 0 and 255.
{{KV|Light Ambient Color|intn=LightColorAmbient|color255|The RGB color of the shadows. Colors must be between 0 and 255.
{{expand|margin_left=2em|title=Examples|
:{{expand|title=Examples|
<gallery mode=packed heights=290px>
<gallery mode=packed heights=240px>
File:cShadowC1.jpg| thumb | left | 510px | 0 0 0
File:LightColorAmbient_000_000_000.jpg| thumb | left | 510px | 0 0 0
File:cShadowC2.jpg| thumb | left | 510px | 255 0 0
File:LightColorAmbient_000_000_255.jpg| thumb | left | 510px | 0 0 255
File:cShadowC3.jpg| thumb | left | 510px | 255 128 128
File:LightColorAmbient_255_168_168.jpg| thumb | left | 510px | 255 168 168
</gallery>
</gallery>
}}
}}
}}
}}
{{KV|SpecularMultiplier|intn=SpecMultiplier|float|Specular multiplier. Sets intensity of [https://developer.valvesoftware.com/wiki/New_Specular new specular] shader from this light source. It's RGB * Intensity * SpecularMultiplier.
{{KV|SpecularMultiplier|intn=SpecMultiplier|float|Specular multiplier. Sets intensity of [https://developer.valvesoftware.com/wiki/New_Specular new specular] shader from this light source. It's RGB * Intensity * SpecularMultiplier. 0 means disabled.
{{expand|margin_left=2em|title=Examples|
:{{expand|title=Examples|
<br>
<br>
<gallery mode=packed heights=290px>
<gallery mode=packed heights=350px>
File:cBS IN1.jpg| thumb | left | 510px | SpecularMultiplier - 1
File:SpecMultiplier0point5.jpg| thumb | left | 510px |0.5
File:cBS IN10.jpg| thumb | left | 510px | SpecularMultiplier - 10
File:SpecMultiplier1point0.jpg| thumb | left | 510px |1
File:cBS IN20.jpg| thumb | left | 510px | SpecularMultiplier - 20
File:SpecMultiplier2point0.jpg| thumb | left | 510px |2
</gallery>
</gallery>
}}
}}
}}
}}
{{KV|falloffConstant|intn=falloffConstant|integer|Constant value (works only if bUseOldFallOff is enabled).|nofgd=1|deprecated=1}}
{{KV|falloffConstant|intn=falloffConstant|integer|Constant value (can work only if old falloff is enabled).|nofgd=1|deprecated=1}}
{{KV|falloffLinear|intn=falloffLinear|integer|Linear value (works only if bUseOldFallOff is enabled).|nofgd=1|deprecated=1}}
{{KV|falloffLinear|intn=falloffLinear|integer|Linear value (can work only if old falloff is enabled).|nofgd=1|deprecated=1}}
{{KV|falloffQuadratic|intn=falloffQuadratic|integer|Quadratic value (works only if bUseOldFallOff is enabled).|nofgd=1|deprecated=1}}
{{KV|falloffQuadratic|intn=falloffQuadratic|integer|Quadratic value (can work only if old falloff is enabled).|nofgd=1|deprecated=1}}

Latest revision as of 07:36, 24 June 2025


Light Color (LightColor) <color255>
The RGB color of the light. Colors must be between 0 and 255.
Light Intensity (Intensity) <float>
Intensity/brightness of the light. It's RGB * intensity.
Note.pngNote:With 0 it will make the light disabled, including the effects. Doesn't affect shadows.
Range (Range) <float>
Range of the light, or how far the light source can illuminate. Measured in Hammer Units.
Warning.pngWarning:This is one of the parameters that affects performance in the game. Smaller values ​​allow you to process less geometry and save performance.
Icon-Important.pngImportant:Range is limited, the limit depends on intensity value. Do not use values ​​bigger than the intensity value allows.
Examples
  • Range - 50
    Range - 50
  • Range - 1000
    Range - 1000
  • Range - 15000
    Range - 15000
Enabled (Enabled) <choices>
Sets light state on spawn, enabled or disabled.
  • 0: Enabled
  • 1: Disabled
Appearance (style) <integer choices>
Appearance presets.
Lightstyle presets (epilepsy warning)
Literal Value Description Sequence Preview
0 Normal m Lightstyle 0.png
10 Fluorescent flicker mmamammmmammamamaaamammma Lightstyle 10.gif
2 Slow, strong pulse abcdefghijklmnopqrstuvwxyzyxwvutsrqponmlkjihgfedcba Lightstyle 2.gif
11 Slow pulse, noblack abcdefghijklmnopqrrqponmlkjihgfedcba Lightstyle 11.gif
5 Gentle pulse jklmnopqrstuvwxyzyxwvutsrqponmlkj Lightstyle 5.gif
1 Flicker A mmnmmommommnonmmonqnmmo Lightstyle 1.gif
6 Flicker B nmonqnmomnmomomno Lightstyle 6.gif
3 Candle A mmmmmaaaaammmmmaaaaaabcdefgabcdefg Lightstyle 3.gif
7 Candle B mmmaaaabcdefgmmmmaaaammmaamm Lightstyle 7.gif
8 Candle C mmmaaammmaaammmabcdefaaaammmmabcdefmmmaaaa Lightstyle 8.gif
4 Fast strobe mamamamamama Lightstyle 4.gif
9 Slow strobe aaaaaaaazzzzzzzz Lightstyle 9.gif
12 Underwater light mutation mmnnmmnnnmmnn Lightstyle 12.gif
Tip.pngTip:Use new lights instead for lights with custom appearance, because static lightmapped lights reduces performance with this feature (especially near displacements).
Note.pngNote:Custom light styles are not possible.
Light Ambient Color (LightColorAmbient) <color255>
The RGB color of the shadows. Colors must be between 0 and 255.
Examples
  • 0 0 0
    0 0 0
  • 0 0 255
    0 0 255
  • 255 168 168
    255 168 168
SpecularMultiplier (SpecMultiplier) <float>
Specular multiplier. Sets intensity of new specular shader from this light source. It's RGB * Intensity * SpecularMultiplier. 0 means disabled.
Examples


  • 0.5

    0.5

  • 1

    1

  • 2

    2

falloffConstant (falloffConstant) <integer> !FGD Obsolete
Deprecated.
Constant value (can work only if old falloff is enabled).
falloffLinear (falloffLinear) <integer> !FGD Obsolete
Deprecated.
Linear value (can work only if old falloff is enabled).
falloffQuadratic (falloffQuadratic) <integer> !FGD Obsolete
Deprecated.
Quadratic value (can work only if old falloff is enabled).
Retrieved from "https://developer.valvesoftware.com/w/index.php?title=Template:KV_BmNewLightBaseMain&oldid=483238"