$specmap texture

$specmap_texture is a material shader parameter available in 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: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.

Bug: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:env_cascade_light doesn't work with this shader (at least on brush models and world geometry).

← Black Mesa Level Creation

Parameters and Effects

$specmap_texture <texture>

Defines a specularmap texture for the shader.

An example.

An example of specularmap from Black Mesa: Blue Shift.

$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.

Examples.

$specularcolor - 1 1 1. $specularcolor - 1 0 0. $specularcolor - 1 0 1.

$specmap_mode <integer>

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 - 1. Seems to use $specmap_texture as glossiness map. $specmap_mode - 2. Seems to use $specmap_texture as tint map.

$speculargloss <float>

Defines glossiness. Works differently depending on $specmap_mode value.

Examples of $specmap_mode - 0.

$specmap_mode - 0. $speculargloss - 10 $specmap_mode - 0. $speculargloss - 100 $specmap_mode - 0. $speculargloss - 500

Examples of $specmap_mode - 1.

$specmap_mode - 1. $speculargloss - 10 $specmap_mode - 1. $speculargloss - 100 $specmap_mode - 1. $speculargloss - 500

Examples of $specmap_mode - 2.

$specmap_mode - 2. $speculargloss - 10 $specmap_mode - 2. $speculargloss - 100 $specmap_mode - 2. $speculargloss - 500

$normalmapalphaenvmapmask <boolean>

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.

$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.

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

• $moss_enable - moss shader.
• $pomscale - parallax occlusion mapping shader.
• Lightmapped_4WayBlend - 4 way blend shader.
• $halflambert_gbuffer_off - gbuffer's halflambert option.
• newLight_Dir - directional sun light with godrays only.
• NewLights_Spawner - spawner of deferred point lights.
• env_lensflare - cinematic dynamic lens flare.
• newLight_Spot - spot deferred light entity.
• newLights_settings - entity that changes deferred light settings.
• godrays_settings - entity that changes godrays settings.
• env_cascade_light - deferred cascade sun light entity.
• New Lights Editor - in game deferred lights editor.
• Effect flags - effects flags, some of them are dynamic light effects.
• BlackMesa XenEngine: Part 4 – Lighting & Shadows - page from Chetan (lead programmer for Black Mesa) about new lights.
• BlackMesa XenEngine: Part2 – How a Frame is Rendered - page from Chetan (lead programmer for Black Mesa) about how a frame is rendered.
• BlackMesa XenEngine: Part1 – Heavily Modified Source Engine page from Chetan (lead programmer for Black Mesa) about Xengine.