View source for LightmappedGeneric

{{Source topicon}} {{lang}}
{{this is a|pixel shader|name=LightmappedGeneric}} It is the shader most commonly used to render [[lightmap]]ped [[brush]]es and [[displacement]]s. 

Models cannot use this shader; [[$lightmap|lightmapped models]] use the {{ent|VertexLitGeneric}} shader. 

== Supported Parameters ==

=== Basics ===
{{MatParam|$basetexture|texture|Defines an [[diffuse]] texture.}}
{{MatParam|$decal|bool|Use this material as a decal.}}
{{MatParam|$detail|texture|Detail texturing.}}
{{MatParam|$surfaceprop|string|Links the surface to a set of physical properties.}}

=== Adjustment ===
{{MatParam|$basetexturetransform|matrix| Transforms the texture before use in the material. This does not affect [[lightmap]]s on the surface. }}
{{MatParam|$color|RGB matrix|Independently scales the red, green and blue channels of an albedo.}}
{{MatParam|$decalscale|float|Same as a brush face's texture scale value: the number of [[unit|units]] that each [[texel]] covers. Normally 0.25 or lower. }}
{{MatParam|$detailscale|float|Fits the detail texture onto the material the given number of times (default {{=}} 4). Generally used instead of {{mono|$detailtexturetransform}} with a value of around 7 or 8 for a 128px detail texture. To independently scale the X and Y coordinates, place your values in brackets: {{mono|$detailscale "[ 4 8 ]"}}}}
{{MatParam|$detailblendfactor|normal|Controls the amount that the detail texture affects the base texture. The precise use of this depends on the blend factor; in most cases it acts similarly to [[$alpha]]. A value of 0 usually makes the detail texture have no effect, whilst a value of 1 applies the full effect.}}
{{MatParam|$detailblendmode|int|How to combine the detail material with the albedo.}}
{{MatParam|$modelmaterial|material|A separate [[VertexLitGeneric]] material to that will replace this one if the decal hits a [[Model|model]]. }}
{{MatParam|$pointsamplemagfilter|bool|only={{csgo}}{{jbep3}}|Disables texture filtering.}}
{{MatParam|$seamless_scale|since={{src07}}|float|Mitigation for displacement texture stretching.}}

=== Transparency ===
{{MatParam|$alpha|float|Scales the opacity of an entire material.
{{modernImportant|Can result in alpha sorting issues if brush is flagged as detail or tied to an entity!}}}}
{{MatParam|$alphatest|bool|Specifies a mask to use to determine binary opacity.}}
{{MatParam|$distancealpha|since={{src07}}|bool|Vector-like edge filtering.}}
{{MatParam|$nocull|bool|Disables backface culling.}}
{{MatParam|$translucent|bool|Specifies that the material should be partially see-through.
{{modernImportant|Can result in alpha sorting issues if brush is flagged as detail or tied to an entity!}}}}

=== Lighting ===
{{MatParam|$bumpmap|texture|Specifies a texture that will provide three-dimensional lighting information for a material.}}
{{MatParam|$blendmodulatetexture|since={{src06}}|texture|Control sharpness and bias of blend. See [[Blendmodulate]]}}
{{MatParam|$lightwarptexture|since={{src06}}|texture|Per-texel color modification via a warp texture. 
{{Note|Does not appear to be featured on {{ent|LightmappedGeneric}} in {{csgobranch|4}}.}}}}
{{MatParam|$selfillum|bool|Determines whether the surface is self-illuminated independent of environment lighting.}}
{{MatParam|$ssbump|since={{src07}}|bool|Flags the {{ent|$bumpmap}} as being a self-shadowing bumpmap.}}

=== Reflection ===
{{MatParam|$envmap|cubemap|Specular reflections.}}
{{MatParam|$phong|since={{csgo}}|also={{GMOD}}{{mapbase}}|bool|Diffuse reflections.
{{note|Phong is reflected only from [[env_cascade_light]].}}
:{{todo|Are there reflections from any other light sources?.}} 
{{warning|Standard phong color is always white and doesn't depend on the color of [[light_environment]] or [[env_cascade_light]].}}
{{bug|Normal map does not affect phong reflections if there is empty $envmap on the material, or if you haven't assigned any brush face on [[env_cubemap]] entity.}}}}
{{MatParam|$phong_exp|only={{lw}}|float|{{confirm|Is this for LW's Blinn–Phong reflections?}}}}
{{MatParam|$phong_exp2|only={{lw}}|float|{{confirm|Is this for LW's Blinn–Phong reflections?}}}}

==={{portal2}}Paint===
{{MatParam|$paintsplatnormalmap|texture|The paint splat normal map to use when paint is applied to the material. Defaults to <code>paint/splatnormal_default</code> if not specified.}}
{{MatParam|$paintsplatbubblelayout|texture|The layout texture which defines the distribution of bubbles in the paint. Defaults to <code>paint/bubblelayout</code> if not specified.}}
{{MatParam|$paintsplatbubble|texture|The normal mapped texture of a single bubble. Defaults to <code>paint/bubble</code> if not specified.}}
{{MatParam|$paintenvmap|texture|The environment map reflected in the paint. Defaults to <code>paint/paint_envmap_hdr</code> if not specified.}}


=== Texture Organization ===
{{MatParam|%keywords|string|Sets keywords <i>(comma separated)</i> filter that can be filtered in hammer for easier texture finding.{{example|<code>%keywords "wasteland,c17"</code> place the material under the <i>"wasteland"</i> and <i>"c17"</i> filters.}} }}
{{MatParam|%notooltexture|bool|Hides the material from Hammer's texture browser.{{warning|Non-functional in {{hammer++|4.1}}.}} }}
{{MatParam|%tooltexture|texture|Used to blend texture previews in [[Hammer]].}}

=== Effect ===
{{MatParam|$nofog|bool|Prevents fog from overdrawing a material.}}

== Caveats ==

=== Mapbase ===
LightmappedGeneric materials in [[Mapbase]] should have the shader '''{{mono|SDK_LightmappedGeneric}}'''.


== See also ==
*{{mono|[[WorldVertexTransition]]}}, a shader used on displacements to blend two materials together.
*{{mono|[[LightmappedTwoTexture]]}}, a brush shader that multiplies a texture on top of another one.
*{{mono|[[Lightmapped_4WayBlend]]}}, a shader used on displacements to blend up to four materials together.