View source for SurfaceGGX

{{Shader multi|SurfaceGGX|game1=Day of Infamy|game2=Insurgency}}   It was first introduced in Day of Infamy and back ported to Insurgency.  It supports [[Physically Based Rendering|PBR]].

{{Bug|This shader won't receive light properly from {{ent|env_projectedtexture}}s like the player's flashlight, instead making the material appear pure black.  If the player is allowed to use a flashlight, the best case scenario is to only use this shader on props in lit up areas.  This shader applied to weapon view models is safe from this however.}}

== Supported Parameters ==
;{{MatParam|[[$basetexture]]||Diffuse texture.}}
;{{MatParam|[[$bumpmap]]||Normal mapping. {{bug|Animated bump maps aren't possible as the shader lacks the <code>$bumpframe</code> parameter.}} }}
;{{MatParam|[[$color#Models|$color2]]||Color tinting.}}
;{{MatParam|[[$detail]]||Detail texturing.}}
;{{MatParam|[[$envmap]]||Specular reflections.}}
;{{MatParam|[[$alphatest]]||Alpha testing.}}

=== Metalness Parameters ===

;{{MatParam|$metal|bool|Enables use of the green channel of <code>$phongexponenttexture</code>.}}
;{{MatParam|$phongexponenttexture|texture|Despite the name, this is a mask that defines the metalness of the material.}}

=== Specular/Gloss Parameters ===

;{{MatParam|$pbr|bool|Enables PBR reflections.}}
;{{MatParam|$masks|texture|A mask for specular and glossiness.  <code>$pbr</code> must be enabled to work.}}

=== Misc. Parameters ===

;{{MatParam|$fuzz|bool|Enables a asperity/fuzz scattering pass on the material.}}
;{{MatParam|$fuzzmultiplier|float|Multiplier for the fuzz effect, default is 1.0.}}
;{{MatParam|$roughnessmultiplier|float|Multiplier for roughness.  {{TODO|More detail, what is roughness?}} }}
;{{MatParam|$subsurfacescattering|bool|Enables subsurface scattering on the material. {{TODO|More detail.}} }}
;{{MatParam|$disableenvmap|bool|Enabling disables <code>$envmap</code> reflections.  The shader will use <code>$envmap</code> by default even if it isn't specified, unless this is enabled.}}

== Configuring the masks ==
=== $phongexponenttexture ===
The RGB channels of <code>$phongexponenttexture</code> is configured as follows:
{| class="wikitable"
|-
! Channel !! Data
|-
| Red || Glossiness (roughness inverted)
|-
| Green || Metalness inverted
|-
| Blue || Sub-surface scattering mask
|}
<code>$metal</code> must be set to <code>1</code> in order to use the green channel.

{{Note|<code>$fuzz</code> and <code>$detailnormal</code> use the inverse of the blue channel.}}

=== $masks ===
The RGB and alpha channels of <code>$masks</code> is configured as follows:
{| class="wikitable"
|-
! Channel !! Data
|-
| RGB || Specular tint
|-
| Alpha || Glossiness
|}
<code>$pbr</code> must be enabled to make use of <code>$masks</code>.

== See also ==
*{{ent|WorldGGX}}, similar shader used for brushes and displacements.