Zh/$envmapmask: Difference between revisions
(Created page with "{{subst:#if: Translation of '$envmapmask' to '中文' via Template:LanguageBar buttons * * * * * * * * * * * * * * * * * * * * * * * * * * * *...") |
No edit summary |
||
Line 1: | Line 1: | ||
{{wip}}{{translating}} | |||
{{LanguageBar}} | {{LanguageBar}} | ||
Line 18: | Line 8: | ||
{{warning|<code>$envmapmask</code> will not work with materials using {{ent|$bumpmap}}/ in most situations; see [[#Alternative_methods]]. | {{warning|<code>$envmapmask</code> will not work with materials using {{ent|$bumpmap}}/ in most situations; see [[#Alternative_methods]]. | ||
{{note|Exceptions: | {{note|Exceptions: | ||
* ''' | * '''{{L|LightmappedReflective}}''' (uses {{ent|$normalmap}}) | ||
* {{mapbase|only}} ''' | * {{mapbase|only}} '''{{L|VertexLitGeneric}}''' | ||
* {{csgo|only}}''' | * {{csgo|only}}'''{{L|LightmappedGeneric}}''' | ||
}} }} | }} }} | ||
{{warning|<code>$envmapmask</code> will not work with materials using {{ent|$phong}}, at all. By default it will use the $basetexture's alpha channel for masking the envmap.}} | {{warning|<code>$envmapmask</code> will not work with materials using {{ent|$phong}}, at all. By default it will use the $basetexture's alpha channel for masking the envmap.}} | ||
Line 29: | Line 19: | ||
$envmapmask <texture> | $envmapmask <texture> | ||
{{L|VertexLitGeneric}} | |||
{ | { | ||
{{L|$envmap}} env_cubemap | |||
'''$envmapmask "props/tvscreen_test"''' | '''$envmapmask "props/tvscreen_test"''' | ||
} | } | ||
Line 37: | Line 27: | ||
==Additional parameters== | ==Additional parameters== | ||
[[File:Scanner mask.jpg|thumb|250px| | [[File:Scanner mask.jpg|thumb|250px|{{L|npc_cscanner}}'s mask.]] | ||
{{MatParam|$envmapmasktransform|matrix| | {{MatParam|$envmapmasktransform|matrix| | ||
Line 52: | Line 42: | ||
==Alternative methods== | ==Alternative methods== | ||
Rather than creating a whole new texture for a specular mask, you can embed one into the | Rather than creating a whole new texture for a specular mask, you can embed one into the {{L|alpha channel}} of the {{ent|$basetexture}} or {{code|$bumpmap}}. Model materials with {{code|$bumpmap}} '''must''' do this. Unfortunately, it ''won't'' reduce memory usage. | ||
If you do use these commands, transformations and other such parameters applied to {{code|$basetexture / $bumpmap}} will also apply to the specular mask. | If you do use these commands, transformations and other such parameters applied to {{code|$basetexture / $bumpmap}} will also apply to the specular mask. | ||
Line 61: | Line 51: | ||
* The alpha channel '''''is not''''' inverted in {{src07|2}} ''and'' {{csgo|2}} for models, but the alpha channel '''''is''''' inverted for brushes! | * The alpha channel '''''is not''''' inverted in {{src07|2}} ''and'' {{csgo|2}} for models, but the alpha channel '''''is''''' inverted for brushes! | ||
:* In {{src13}}, the alpha channel is only inverted for models if {{cmd|$phong}} is disabled! | :* In {{src13}}, the alpha channel is only inverted for models if {{cmd|$phong}} is disabled! | ||
* {{l4d2}} auto enables if '''$envmap''' is present. Opaque areas are reflective while transparent are matte. Set as | * {{l4d2}} auto enables if '''$envmap''' is present. Opaque areas are reflective while transparent are matte. Set as {{L|bool|true}} to invert {{code|$basetexture}} alpha channel behaviour. This allow {{code|{{L|$bumpmap}}}} have a dedicated {{code|{{L|$phong}}}} mask, when material transparency is not needed.}} | ||
{{bug|<ul> | {{bug|<ul> | ||
<li> In CSGO, this parameter breaks materials using {{ent|$translucent}}. Use {{code|$envmapmask}} or {{code|$normalmapalphaenvmapmask}} instead.<br> | <li> In CSGO, this parameter breaks materials using {{ent|$translucent}}. Use {{code|$envmapmask}} or {{code|$normalmapalphaenvmapmask}} instead.<br> | ||
<li> In all of: {{gmod}}{{src13}}{{tf2}}{{as}}{{csgo}} on {{ent|VertexLitGeneric}} ('''Without''' {{ent|$phong}}), {{ent|WorldVertexTransition}} and {{ent|LightmappedGeneric}}, <code>$basealphaenvmapmask</code> cannot be used with {{ent|$bumpmap}}.<br> | <li> In all of: {{gmod}}{{src13}}{{tf2}}{{as}}{{csgo}} on {{ent|VertexLitGeneric}} ('''Without''' {{ent|$phong}}), {{ent|WorldVertexTransition}} and {{ent|LightmappedGeneric}}, <code>$basealphaenvmapmask</code> cannot be used with {{ent|$bumpmap}}.<br> | ||
<li> In all of: {{gmod}}{{src13}}{{tf2}}{{as}}{{csgo}} on {{ent|LightmappedGeneric}} and {{ent|WorldVertexTransition}}, <code>$basealphaenvmapmask</code> cannot be used with {{ent|$selfillum}}, {{ent|$seamless_detail}} or {{ent|$distancealpha}}.<br> | <li> In all of: {{gmod}}{{src13}}{{tf2}}{{as}}{{csgo}} on {{ent|LightmappedGeneric}} and {{ent|WorldVertexTransition}}, <code>$basealphaenvmapmask</code> cannot be used with {{ent|$selfillum}}, {{ent|$seamless_detail}} or {{ent|$distancealpha}}.<br> | ||
<li> In {{csgo}}, on {{ent|LightmappedGeneric}} and {{ent|WorldVertexTransition}}, <code>$basealphaenvmapmask</code> cannot be used with | <li> In {{csgo}}, on {{ent|LightmappedGeneric}} and {{ent|WorldVertexTransition}}, <code>$basealphaenvmapmask</code> cannot be used with {{L|$detail#Parameters and Effects|$detailblendmode}} "9" or {{ent|$envmapanisotropy}}.<br> | ||
<li> In {{csgo}}, on {{ent|Lightmapped_4WayBlend}}, <code>$basealphaenvmapmask</code> cannot be used with {{ent|$selfillum}}. | <li> In {{csgo}}, on {{ent|Lightmapped_4WayBlend}}, <code>$basealphaenvmapmask</code> cannot be used with {{ent|$selfillum}}. | ||
<li> This cannot be used with {{ent|$bumpmap}} on {{ent|LightmappedGeneric}} | <li> This cannot be used with {{ent|$bumpmap}} on {{ent|LightmappedGeneric}} | ||
Line 72: | Line 62: | ||
<br>{{MatParam|$normalmapalphaenvmapmask|bool|Use the alpha channel of the {{code|$bumpmap}} or {{code|$normalmap}} as the specular mask. | <br>{{MatParam|$normalmapalphaenvmapmask|bool|Use the alpha channel of the {{code|$bumpmap}} or {{code|$normalmap}} as the specular mask. | ||
{{warning|Using this in combination with {{code| | {{warning|Using this in combination with {{code|{{L|$phong|$basemapalphaphongmask}}}} or {{code|{{L|$phong|$basemapluminancephongmask}}}} will set the mask used for the {{ent|$envmap}} to be those instead. <br> | ||
'''There are additional caveats''' when using {{ent|$phong}}. See its entry for more information about possible issues.}} | '''There are additional caveats''' when using {{ent|$phong}}. See its entry for more information about possible issues.}} | ||
}} | }} | ||
{{bug| | {{bug| | ||
* In all of: {{gmod}}{{src13}}{{tf2}}{{as}}{{csgo}} on {{ent|VertexLitGeneric}} ('''Without''' {{ent|$phong}}), <code>$normalmapalphaenvmapmask</code> cannot be used with | * In all of: {{gmod}}{{src13}}{{tf2}}{{as}}{{csgo}} on {{ent|VertexLitGeneric}} ('''Without''' {{ent|$phong}}), <code>$normalmapalphaenvmapmask</code> cannot be used with {{L|Glowing_Textures#.24selfillum|$selfillumfresnel}}.<br> | ||
:{{note| Using <code>$normalmapalphaenvmapmask</code> with {{ent|$phong}} and | :{{note| Using <code>$normalmapalphaenvmapmask</code> with {{ent|$phong}} and {{L|Glowing_Textures#.24selfillum|$selfillumfresnel}} has special caveats that should be considered. Check {{ent|$phong}} for for more information.}} | ||
* In {{csgo}}, on {{ent|LightmappedGeneric}} and {{ent|WorldVertexTransition}}, {{code| | * In {{csgo}}, on {{ent|LightmappedGeneric}} and {{ent|WorldVertexTransition}}, {{code|{{L|$normalmapalphaenvmapmask}}}} cannot be used with {{L|$detail#Parameters and Effects|$detailblendmode}} "9" or {{ent|$envmapanisotropy}}.}}<br> | ||
<br>{{MatParam|$selfillum_envmapmask_alpha|float|Use the alpha channel of the {{code|$envmapmask}} as the {{ent|$selfillum}} mask instead of {{code|$basetexture}}'s alpha.<br> | <br>{{MatParam|$selfillum_envmapmask_alpha|float|Use the alpha channel of the {{code|$envmapmask}} as the {{ent|$selfillum}} mask instead of {{code|$basetexture}}'s alpha.<br> | ||
: {{bug|This Parameter replaces {{code|$selfillum}}. If both are used it will result in an error. The material will not render.}} | : {{bug|This Parameter replaces {{code|$selfillum}}. If both are used it will result in an error. The material will not render.}} | ||
Line 92: | Line 82: | ||
==See also== | ==See also== | ||
* | * {{L|$basetexture}} | ||
* | * {{L|$envmap}} (environment map) | ||
* | * {{L|$phong}} (diffuse reflection) | ||
* | * {{L|$selfillum }} | ||
{{ACategory|Shader parameters|e}} | |||
{{ACategory|VMT Reflections}} |
Revision as of 20:50, 7 August 2025

As a courtesy, please do not edit this while this message is displayed.
If this page has not been edited for at least several hours to a few days, please remove this template. This message is intended to help reduce edit conflicts; please remove it between editing sessions to allow others to edit the page.
The person who added this notice will be listed in its edit history should you wish to contact them.

You can help by finishing the translation.
If this page cannot be translated for some reason, or is left untranslated for an extended period of time after this notice is posted, the page should be requested to be deleted.
Also, please make sure the article complies with the alternate languages guide.
$envmapmask
是一个材质着色器 参数,可在所有的 起源 游戏中使用。 It defines a specular mask which affects how strongly each pixel of a material reflects light from the $envmap. The mask should be a grayscale image in which entirely reflective areas are white and entirely matte areas are black. For diffuse type specularity which does not rely on
$envmap
, see $phong.


$envmapmask
which is not stored in a subfolder will cause the texture to fail loading in-game.
$envmapmask
will not work with materials using $bumpmap/ in most situations; see #Alternative_methods.

- LightmappedReflective (uses $normalmap)
- (仅存在于
之中) VertexLitGeneric
- (仅存在于
之中)LightmappedGeneric

$envmapmask
will not work with materials using $phong, at all. By default it will use the $basetexture's alpha channel for masking the envmap.
VMT syntax example
$envmapmask <texture>
VertexLitGeneric { $envmap env_cubemap $envmapmask "props/tvscreen_test" }
Additional parameters

$envmapmasktransform
$envmapmaskscale
$envmapmaskframe
CS:GO WorldVertexTransition Parameters
$envmapmask2
$envmapmasktransform2
$envmapframe2
Alternative methods
Rather than creating a whole new texture for a specular mask, you can embed one into the alpha channel of the $basetexture or $bumpmap. Model materials with $bumpmap must do this. Unfortunately, it won't reduce memory usage.
If you do use these commands, transformations and other such parameters applied to $basetexture / $bumpmap will also apply to the specular mask.

- Alpha channels embedded in $basetexture work in reverse. Transparent areas are reflective, opaque areas are matte. This is because, say, a window texture's alpha mask would be mostly black to allow for transparency -- yet that black part of the mask would also be the most reflective part. To avoid having to duplicate a texture file simply to invert the alpha mask, you can use this material parameter instead.
- The alpha channel is not inverted in
起源2007 and
反恐精英:全球攻势 for models, but the alpha channel is inverted for brushes!
- In
, the alpha channel is only inverted for models if $phong is disabled!
- In

- In CSGO, this parameter breaks materials using $translucent. Use $envmapmask or $normalmapalphaenvmapmask instead.
- In all of:
on VertexLitGeneric (Without $phong), WorldVertexTransition and LightmappedGeneric,
$basealphaenvmapmask
cannot be used with $bumpmap.
- In all of:
on LightmappedGeneric and WorldVertexTransition,
$basealphaenvmapmask
cannot be used with $selfillum, $seamless_detail or $distancealpha.
- In
, on LightmappedGeneric and WorldVertexTransition,
$basealphaenvmapmask
cannot be used with $detailblendmode "9" or $envmapanisotropy.
- In
, on Lightmapped_4WayBlend,
$basealphaenvmapmask
cannot be used with $selfillum. - This cannot be used with $bumpmap on LightmappedGeneric

- In all of:
on VertexLitGeneric (Without $phong),
$normalmapalphaenvmapmask
cannot be used with $selfillumfresnel .
注意: Using
$normalmapalphaenvmapmask
with $phong and $selfillumfresnel has special caveats that should be considered. Check $phong for for more information.
- In
, on LightmappedGeneric and WorldVertexTransition, $normalmapalphaenvmapmask cannot be used with $detailblendmode "9" or $envmapanisotropy. [todo tested in ?]
$selfillum_envmapmask_alpha
$envmapmaskintintmasktexture
Merging Specular Level into Normal Alpha in 3ds Max
To merge a Specular Level map into the Normal Map alpha, you can create a Composite Map node with the normal map in Layer 1 and the specular map in Mask 1. Then right-click the composite map, click Render Map and save this new image to file (remembering to keep the Gamma at 1.0 and using 32 bits per pixel in the save options).
These steps are automated in the Alpha Spec tool in Wall Worm 2.72+.
See also
- $basetexture
- $envmap (environment map)
- $phong (diffuse reflection)
- $selfillum