$specmap texture: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
No edit summary
 
(4 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{LanguageBar}}
{{LanguageBar}}
{{cleanup|grammar}} {{This is a|shader parameter|name=$specmap_texture|game=Black Mesa}}  
{{This is a|shader parameter|name=$specmap_texture|game=Black Mesa}}  
[[File:NewSpecular=.jpg|thumb|right|New specular shader, example in <code>bs_c3m0d</code>. You can see how the floor reflects the red light source, the same for the floodlight.]]  
[[File:NewSpecular=.jpg|thumb|right|New specular shader, example in <code>bs_c3m0d</code>. You can see how the floor reflects the red light source, same with the floodlight.]]  
This shader is used for surfaces to give PBR style shiny speculars. Works with {{ent|VertexLitGeneric}} and {{ent|LightmappedGeneric}}. This shader works ''only'' with deferred rendering lighting entities which are using <code>SpecularMultiplier</code> parameter (in the game code or as the property), the entities are: {{ent|NewLight_Point}}, {{ent|NewLight_Spot}}, {{ent|npc_zombie_hev}} (flashlight), {{ent|prop_barrel_cactus}}, {{ent|prop_barrel_cactus_semilarge}}, {{ent|prop_barrel_interloper}}, {{ent|prop_barrel_interloper_small}}, {{ent|env_cascade_light}}, {{ent|bmortar}}, {{ent|npc_plantlight}}, {{ent|npc_plantlight_stalker}}, {{ent|player}} (flashlight).
Shader used on surfaces to give them PBR style speculars. Works with {{ent|VertexLitGeneric}} and {{ent|LightmappedGeneric}}. This shader ''only'' works with deferred rendering lighting entities, which are using the <code>SpecularMultiplier</code> parameter. Those entities are: {{ent|NewLight_Point}}, {{ent|NewLight_Spot}}, {{ent|npc_zombie_hev}} (flashlight), {{ent|prop_barrel_cactus}}, {{ent|prop_barrel_cactus_semilarge}}, {{ent|prop_barrel_interloper}}, {{ent|prop_barrel_interloper_small}}, {{ent|env_cascade_light}}, {{ent|bmortar}}, {{ent|npc_plantlight}}, {{ent|npc_plantlight_stalker}}, and {{ent|player}} (flashlight).


This shader is mainly used for {{ent|LightmappedGeneric}}, because this is the only option to have gloss effect on world geometry and [[bmodel]]. For {{ent|VertexLitGeneric}} mainly used {{ent|$phong}}, because new lights are also support this shader; this shader works with baked lights and have a lot of parameters, the only exception is {{ent|prop_static}}.
Mainly used with {{ent|LightmappedGeneric}}, because it is the only option for glossy effects on world geometry and [[bmodel | brush models]]. {{ent|VertexLitGeneric}} is mainly used with {{ent|$phong}} instead, because {{ent|$phong}} supports new lights, while this shader only supports baked lights and has a lot of parameters. The only exception to this is {{ent|prop_static}}.
{{ModernConfirm|Is this list is full ?}}
{{Confirm|Is this list full?}}
{{warning|This shader is pretty expensive for GPU. May not cause FPS drops, but it will heat up your GPU very much. Use wisely.}}
{{warning|This shader is pretty expensive for the GPU. Not necessarily FPS drops, but it will heat up your GPU. Use wisely.}}


{{note|Doesn't work if [[$phong]] is enabled.}}
{{note|Doesn't work if [[$phong]] is enabled.}}


{{bug|hidetested=1|If [[$alphatest|alpha tested]] material has a specular, and beneath it, there is also a material with the same shader, and in combination with new lights or a flashlight, this all will cause artifacts appear. This occurred after Crowbar Collective fixed the outline artifacts for alpha tested materials. [https://youtu.be/cb6Fw4rVXXo Example] (use full screen mode to watch).}}
{{bug|hidetested=1|If a material with [[$alphatest]] applied has a specular, and beneath it, there is another material with the same shader, will cause artifacts under a light source. This bug started occurring after Crowbar Collective fixed the outline artifacts for materials with [[$alphatest]].}}


{{note|{{ent|env_cascade_light}} doesn't work with this shader (at least on [[Bmodel|bmodels]] and world geometry).}}
{{note|{{ent|env_cascade_light}} doesn't work with this shader (at least on [[Bmodel|brush models]] and world geometry).}}
{{back | Black Mesa Level Creation}}
{{back | Black Mesa Level Creation}}


== Parameters and Effects ==
== Parameters and Effects ==
{{MatParam|$specmap_texture|texture|Defines a [[specularmap]] texture that will use specular.
{{MatParamDef|$specmap_texture|texture|Defines a [[specularmap]] texture for the shader.
{{expand|title=An example.|
{{expand|title=An example.|
<br>
<br>
Line 24: Line 24:
}}
}}
}}
}}
{{MatParam|$specularcolor|RGB matrix|Controls the color and saturation of the specularity. If all three values are the same - the color obtained from deferred rendering light source will be used.
{{MatParamDef|$specularcolor|RGB matrix|Controls the color and saturation of the specularity. If all three values are the same, the color obtained from deferred rendering light source will be used instead. Also affects specular intensity.
{{expand|title=Examples.|
{{expand|title=Examples.|
<br>
<br>
Line 34: Line 34:
}}
}}
}}
}}
{{MatParam|$specmap_mode|int|Defines style and behaviour for speculars, there are 3 available values - 0, 1, and 2.
{{MatParamDef|$specmap_mode|int|Defines style and behaviour for speculars. Only 3 applicable values: 0, 1, and 2.
{{expand|title=Examples.|
{{expand|title=Examples.|
<br>
<br>
Line 44: Line 44:
}}
}}
}}
}}
{{MatParam|$speculargloss|float|Defines gloss scale. Works differently depending on <code>$specmap_mode</code> value.
{{MatParamDef|$speculargloss|float|Defines glossiness. Works differently depending on <code>$specmap_mode</code> value.
{{expand|title=Examples of $specmap_mode - 0.|
{{expand|title=Examples of $specmap_mode - 0.|
<br>
<br>
Line 70: Line 70:
}}
}}
}}
}}
{{MatParam|$normalmapalphaenvmapmask|bool|Use the alpha channel of the {{code|$bumpmap}} or {{code|$normalmap}} as a specular mask. {{code|$specmap_texture}} will be used as an additional mask or glossiness mask if {{code|$specmap_mode}} is set. This allows a blendable specular mask on {{code|LightmappedGeneric}}.
{{MatParamDef|$normalmapalphaenvmapmask|bool|Use the alpha channel of the {{code|$bumpmap}} or {{code|$normalmap}} as a specular mask. {{code|$specmap_texture}} will be used as an additional mask or glossiness mask if {{code|$specmap_mode}} is set. This allows a blendable specular mask on {{code|LightmappedGeneric}}.
{{todo|Check to see if parameters such as {{code|$envmapmask}} or {{code|$basealphaenvmapmask}} and others affect newlight specular.}}
{{todo|Check to see if parameters such as {{code|$envmapmask}} or {{code|$basealphaenvmapmask}} and others affect new specular lights.}}
}}
{{MatParamDef|$fresnelreflection|float|If an [[$envmap]] is also defined, adds a fresnel effect to specularity. Operates the same as it does on [[$envmap]]. 0 is full effect, 1 is no fresnel.
{{tip|Use a value of ~0.8 for metal, ~0.1 for everything else to adhere to PBR.}}
}}
}}


Latest revision as of 12:06, 23 August 2025

English (en)Translate (Translate)

$specmap_texture is a material shader parameter available in Black Mesa Black Mesa.

New specular shader, example in bs_c3m0d. You can see how the floor reflects the red light source, same with the floodlight.

Shader used on surfaces to give them PBR style speculars. Works with VertexLitGeneric and LightmappedGeneric. This shader only works with deferred rendering lighting entities, which are using the SpecularMultiplier parameter. Those entities are: NewLight_Point, NewLight_Spot, npc_zombie_hev (flashlight), prop_barrel_cactus, prop_barrel_cactus_semilarge, prop_barrel_interloper, prop_barrel_interloper_small, env_cascade_light, bmortar, npc_plantlight, npc_plantlight_stalker, and player (flashlight).

Mainly used with LightmappedGeneric, because it is the only option for glossy effects on world geometry and brush models. VertexLitGeneric is mainly used with $phong instead, because $phong supports new lights, while this shader only supports baked lights and has a lot of parameters. The only exception to this is prop_static.

Confirm:Is this list full?
Warning.pngWarning:This shader is pretty expensive for the GPU. Not necessarily FPS drops, but it will heat up your GPU. Use wisely.
Note.pngNote:Doesn't work if $phong is enabled.
Icon-Bug.pngBug:If a material with $alphatest applied has a specular, and beneath it, there is another material with the same shader, will cause artifacts under a light source. This bug started occurring after Crowbar Collective fixed the outline artifacts for materials with $alphatest.
Note.pngNote:env_cascade_light doesn't work with this shader (at least on brush models and world geometry).
← Black Mesa Level Creation

Parameters and Effects

Defines a specularmap texture for the shader.
An example.


Controls the color and saturation of the specularity. If all three values are the same, the color obtained from deferred rendering light source will be used instead. Also affects specular intensity.
Examples.


  • $specularcolor - 1 1 1.

    $specularcolor - 1 1 1.

  • $specularcolor - 1 0 0.

    $specularcolor - 1 0 0.

  • $specularcolor - 1 0 1.

    $specularcolor - 1 0 1.

Defines style and behaviour for speculars. Only 3 applicable values: 0, 1, and 2.
Examples.


  • $specmap_mode - 0. Seems to ignore $specmap_texture.

    $specmap_mode - 0. Seems to ignore $specmap_texture.

  • $specmap_mode - 1. Seems to use $specmap_texture as glossiness map.

    $specmap_mode - 1. Seems to use $specmap_texture as glossiness map.

  • $specmap_mode - 2. Seems to use $specmap_texture as tint map.

    $specmap_mode - 2. Seems to use $specmap_texture as tint map.

Defines glossiness. Works differently depending on $specmap_mode value.
Examples of $specmap_mode - 0.


  • $specmap_mode - 0. $speculargloss - 10

    $specmap_mode - 0. $speculargloss - 10

  • $specmap_mode - 0. $speculargloss - 100

    $specmap_mode - 0. $speculargloss - 100

  • $specmap_mode - 0. $speculargloss - 500

    $specmap_mode - 0. $speculargloss - 500

Examples of $specmap_mode - 1.


  • $specmap_mode - 1. $speculargloss - 10

    $specmap_mode - 1. $speculargloss - 10

  • $specmap_mode - 1. $speculargloss - 100

    $specmap_mode - 1. $speculargloss - 100

  • $specmap_mode - 1. $speculargloss - 500

    $specmap_mode - 1. $speculargloss - 500

Examples of $specmap_mode - 2.


  • $specmap_mode - 2. $speculargloss - 10

    $specmap_mode - 2. $speculargloss - 10

  • $specmap_mode - 2. $speculargloss - 100

    $specmap_mode - 2. $speculargloss - 100

  • $specmap_mode - 2. $speculargloss - 500

    $specmap_mode - 2. $speculargloss - 500

Use the alpha channel of the $bumpmap or $normalmap as a specular mask. $specmap_texture will be used as an additional mask or glossiness mask if $specmap_mode is set. This allows a blendable specular mask on LightmappedGeneric.
Todo: Check to see if parameters such as $envmapmask or $basealphaenvmapmask and others affect new specular lights.
If an $envmap is also defined, adds a fresnel effect to specularity. Operates the same as it does on $envmap. 0 is full effect, 1 is no fresnel.
Tip.pngTip:Use a value of ~0.8 for metal, ~0.1 for everything else to adhere to PBR.

Example VMT:

"VertexlitGeneric" { "$basetexture" "models/props_hc/t0a0/generic16" "$bumpmap" "models/props_hc/t0a0/generic16_normal" "$surfaceprop" "Metal" "$specmap_texture" "models/props_hc/t0a0/generic16_spec" "$specmap_mode" "2" "$speculargloss" "800" "$specularcolor" "[ 1 1 1 ]" }

See also

Retrieved from "https://developer.valvesoftware.com/w/index.php?title=$specmap_texture&oldid=487413"