Template:KV BmNewLightBase: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
(This template stores new lights related keyvalues for new lights from BMS. This template is base (we don't have all point/spot light kvs in newlights_settings). We will use it for KV BmNewLightPoint and KV BmNewLightSpot.)
 
No edit summary
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{KV|Enabled|intn=Enabled|Choices|
<!--Purpose:
Sets light state on spawn, enabled or disabled.
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.-->
*0: Enabled
*1: Disabled}}
{{KV|Appearance|intn=FlareStyle|Choices|Appearance presets.
{{Light appearances}}
{{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) ?}}
}}
{{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 Color|intn=LightColor|color255|The RGB color of the light. Colors must be between 0 and 255.}}
{{KV|Light Color|intn=LightColor|color255|The RGB color of the light. 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.
{{KV|Light Intensity|intn=Intensity|float|Intensity/brightness of the light. It's RGB * intensity.
{{expand|margin_left=2em|title=Examples|
:{{Note|With 0 it will make the light disabled, including the effects. Doesn't affect shadows.}}
<gallery mode=packed heights=290px>
File:cShadowC1.jpg| thumb | left | 510px | 0 0 0
File:cShadowC2.jpg| thumb | left | 510px | 255 0 0
File:cShadowC3.jpg| thumb | left | 510px | 255 128 128
</gallery>
}}
}}
}}
{{KV|Range|intn=Range|float|Range of the light, or how far the light source can illuminate. Measured in Hammer Units.
{{KV|Light Intensity|intn=Intensity|float|Intensity/brightness of the light. It's RGB * intensity.}}
:{{warning|This is one of the parameters that affects performance in the game. Smaller values ​​allow you to process less geometry and save performance.}}
:{{Note|With 0 it will make the light disabled (including the effects).}}
:{{important|Range is limited, the limit depends on intensity value. Do not use values ​​bigger than the intensity value allows.}}
{{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.
:{{expand|title=Examples|
{{expand|margin_left=2em|title=Examples|
<gallery mode=packed heights=280px>
<br>
File:range50.jpg| thumb | left | 510px | Range - 50
<gallery mode=packed heights=290px>
File:range1000.jpg| thumb | left | 510px | Range - 1000
File:cBS IN1.jpg| thumb | left | 510px | SpecularMultiplier - 1
File:range15000.jpg| thumb | left | 510px | Range - 15000
File:cBS IN10.jpg| thumb | left | 510px | SpecularMultiplier - 10
File:cBS IN20.jpg| thumb | left | 510px | SpecularMultiplier - 20
</gallery>
</gallery>
}}
}}
}}
}}
{{KV|Range|intn=Range|float|Range of the light, or how far the light source can illuminate. Measured in Hammer Units.}}
:{{warning|This is one of the parameters that affects performance in the game. Smaller values ​​allow you to process less geometry and save performance.}}
{{expand|margin_left=2em|title=Examples|
<br>
<gallery mode=packed heights=290px>
File:cL1.jpg| thumb | left | 510px | Range - 150
File:cL2.jpg| thumb | left | 510px | Range - 300
File:cL3.jpg| thumb | left | 510px | Range - 500
</gallery>
}}
{{KV|falloffConstant|intn=falloffConstant|integer|Constant value (works only if bUseOldFallOff is enabled).|nofgd=1|deprecated=1}}
{{KV|falloffLinear|intn=falloffLinear|integer|Linear value (works only if bUseOldFallOff is enabled).|nofgd=1|deprecated=1}}
{{KV|falloffQuadratic|intn=falloffQuadratic|integer|Quadratic value (works only if bUseOldFallOff is enabled).|nofgd=1|deprecated=1}}

Latest revision as of 07:26, 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
Retrieved from "https://developer.valvesoftware.com/w/index.php?title=Template:KV_BmNewLightBase&oldid=483235"