View source for Ru/$envmap

{{LanguageBar}}
{{For|the set of material parameters used to mask specular reflections via textures|[[$envmapmask]]}} 
{{This is a|shader parameter|name=$envmap|engine=source}} 
{{Update translation}}
[[File:Specular.jpg|thumb|Зеркальные отражения в полную яркость.]]
It most commonly used to approximate the [[wikipedia:specular reflection|specular reflections]] seen on smooth surfaces, such as metals and plastics. This is achieved by mapping the {{L|Normal|vertex normals}} of a {{L|3D Model|model}} to positions on a cubemap - specified by <code>$envmap</code> - and adding the sampled color from the cubemap to the model's surface. Typically, the cubemap is a simple, static "environment map" which has been pre-rendered (although a custom cubemap can be animated).

When <code>$envmap</code> is set to <code>{{ent|env_cubemap}}</code> and {{ent|buildcubemaps}} has been run on the map, the engine will automatically select the environment map contained in the {{L|BSP}} which is nearest to the model as it moves through the world, providing a ''very'' rough approximation of dynamic reflections.

The other form of specularity supported by Source is the {{L|$phong|Phong}} type, which provides simpler reflections on both static '''and''' dynamic models.

== Доступность ==
'''<code>$envmap</code>''' был представлен в {{src|4}} в {{hl2}} и {{css}}. Также доступен во всех поздних играх.

{{Bug|{{hls}} The latest Source engine version (v24) of {{hls|3}} does support <code>$envmap</code> if it uses an <code>env_cubemap</code>, but the {{ent|buildcubemaps}} command does ''not'' work properly. If the cubemaps are built in another game and then the BSP is added into HL:S, they will work fine. Is not clear if in older versions there were more issues; but, due such problems, Valve used static reflective images for every reflective texture in the game.|only=hls}}

== Синтаксис ==
<pre>
$envmap env_cubemap
</pre>

"env_cubemap" is typically used, which tells {{L|VBSP}} to swap in the name of the nearest <code>env_cubemap</code> when the map compiles. However, it is also possible to use a static cubemap image that has been manually created.

{{note|Если <code>$envmap</code> используется без указания {{ent|$basetexture}}, то даже в таком случае зеркальные отражения будут отображены.}}
{{note|Большинство текстур карт-кубов не будут иметь отражения, если использовать их как оверлеи или декали{{clarify}}.}}
{{note|На прозрачность карты-куба влияет альфа-канал {{ent|$basetexture}}, даже при использовании $envmapmask.}}

== Создание пользовательской статичной cubemap текстуры ==

Creating a custom cubemap texture might be required for some circumstances and is used occasionally in some Valve models.

{{bug| Cubemaps flagged as sRGB will only properly load as sRGB when {{L|HDR}} is disabled. Either include an HDR {{code|.hdr.vtf}} equivalent for an sRGB-encoded SDR {{code|.vtf}} cubemap, or encode the SDR cubemap in regular RGB. 
{{modernConfirm|What games can actually load SDR cubemaps in HDR mode? {{css}} handles such fine (printing warnings about missing a proper HDR cubemap in the console), but {{dods}} seems not be able to load SDR cubemaps in HDR mode (regardless of sRGB-ness), resulting in the surface glowing white.}}}}

=== В {{L|VTFEdit}} ===

For this to work you will need to have the 6 sides of the cubemap saved as individual textures in the correct orientation for it to appear correctly in the Source Engine. So some faces might need to be rotated either clockwise or counter clockwise. Each face will need to be mirrored horizontally before orientation.
{{note|Pre-{{as|4}} games require 7 faces for the cubemap to work. The seventh in this case is a round texture, used as a sphere map for the (broken) <code>$envmapsphere</code> parameter. VTFEdit can generate this face automatically, via the "Advanced" tab when importing.}}

To the right hand side of this page you will find two guide images to aid in properly rotating each side of your environment render.<br>
Save one or both of those guides on your computer and then import your environment render onto it or recreate it in a smaller scale, then rotate your sides as instructed by the images.<br>
Save every side as a separate image file, their names should be the number found on that specific square. This will ensure that the environment texture will be built correctly, as the numbers also represent the import order in {{L|VTFEdit}}.

[[File:Cubemap T assembly guide.png|thumb|Orientation guide for T-assembled environments. Click to enlarge]]
[[File:Cubemap Blender-Render assembly guide.png|thumb|Orientation guide for {{Blender}} render results. Click to enlarge]]

Once you have all the image sides ready you can just import them all into VTFEdit and select "Environment Map". [[Valve_Texture_Format#Image_data_format_table|Texture format]] is up to you, generally DXT1 will do.

[[File:Cubemap_tut1_cra0.png|320px]]

Enable the "Clamp S" and "Clamp T" texture flags.

Then just save it all as a .vtf file and use it in your VMT like so:

<pre>
"$Envmap" "effects/my_cubemap"
</pre>
"effects" is the usual folder for environments/cubemaps You may put yours anywhere you like

=== В VTEX ===

VTEX will automatically mirror and orient your faces, you need only to provide correctly named textures. Name each file something like envmap001a*.tga, where * is put '''BK, FT, LF, RT, UP, or DN'''. If you took a cubemap screenshot in-game, this step will already by done, but to make them work properly with Vtex.exe you must use HDRShop (but before you need to change textures format to BMP, because HDRShop can only work with that kind of format) and then covert them to PFM files format.

{{todo|What axis does each direction relate to?}}
;
[[File:Cubemap_axis_reference_1.jpg]]

Create a text file the same name as your textures (e.g. envmap001a.txt). If building for HDR write in the following, otherwise leave it blank:

<source lang=c>
pfm 1 // read .pfm file instead of .tga
pfmscale 1 // higher values will result in a brighter sky
nocompress 1 // disable compression (HDR compression is only supported by skyboxes)
</source>

Put these files into materialsrc and then just drag-n-drop .txt file into vtex.exe and you should end up with a working cubemap! HDR envmaps will be named like envmap001a.hdr.vtf, and only need to exist to work.

== Параметры и Эффекты ==

<span  id="$envmapmask"></span>
{{MatParam|$envmapmask|texture|Смотреть {{ent|$envmapmask}}. Текстура, которая по-{{L|texel|тексельно}} определяет яркость зеркального отражения.}}
<span  id="$envmaptint"></span>
{{MatParam|$envmaptint|RGB matrix|Контролирует яркость отражения {{L|RGB|красного, зелёного и синего}} канала. Использоваться может любое положительное число. По умолчанию: <code>"[1 1 1]"</code>, что означает 100% яркость.
{{important| '''На {{ent|VertexLitGeneric}} этот параметр конвертируется из гамма в линейное пространство'''. Вводимые значения преобразуются в {{code|X^2.2f}}. Например, 0.25 равно не 25% отражения, а ~5%! }}
{{note|Вы ''обязаны'' использовать кавычки, так как внутри значения есть пробелы.}}
{{note|Можно указать значение одиночным числом с плавающей запятой. В таком случае это значение будет применено ко всем трём каналам одинаково (Например '''$envmaptint''' 0.5 будет равен '''$envmaptint''' "[0.5 0.5 0.5]"). Однако, судя по всему, этот метод не является полностью надёжным.{{confirm}}}}
{{tip|Этот параметр часто используется для того, чтобы приглушить яркость зеркального отражения без использования выше описанной <code>$envmapmask</code>.}}}}
<span  id="$envmapcontrast"></span>
{{MatParam|$envmapcontrast|normal|Контролирует [[Wikipedia:Contrast (vision)|контраст]] отражения. 0 - натуральный контраст, а 1 возводит цвет в квадратную степень (т.е. цвет*цвет).
: {{note|Не работает при включённом {{L|$phong}}.}}
: {{tip|Use higher contrasts to diminish relatively darker areas and increase "hot spots".}}}}
<span  id="$envmapsaturation"></span>
{{MatParam|$envmapsaturation|RGB matrix|Контролирует цветовую насыщенность отражения. 0 - серые тона, а 1 - натуральный цвет. Красный, Зелёный и Синий цвета можно изменять используя <code>"[к з с]" </code> соответственно.
: {{note|In the Shadercode for {{src13|2}} and {{as|2}} the parameter is defined as a float parameter. However it will be used as a vec3 and the Shader expects and uses it as such.}}
: {{note|Не работает при включённом на моделях {{L|$phong}}.}}
: {{bug|{{css}} Работает только на моделях.{{modernConfirm|Эта ошибка существует в других {{src13mp}} играх использующие обычные затенения? (кроме: {{hl2dm}} {{hldms}} {{dods}} {{tf2}}) }} }} }}
<span  id="$envmapframe"></span>
{{MatParam|$envmapframe|int|The frame to start an animated cubemap on.}}
<span  id="$envmapmode"></span>
{{MatParam|$envmapmode|int|Depreciated  MATERIAL_VAR_ENVMAPMODE  {{=}} (1 << 25), // OBSOLETE|deprecated=1}}
<span  id="$basetexturenoenvmap"></span>
{{MatParam|$basetexturenoenvmap|and=$basetexture2noenvmap|bool|Used for materials with two {{L|albedo}}s, to make one or the other matte. See also {{ent|$basetexture}} and {{ent|$basetexture2}}.
:{{note|Superseded in {{csgo}} by <code>[[$envmapmask#CS:GO_WorldVertexTransition_Parameters|$envmapmask2]].</code>}}|dx9=1|shaders=WorldVertexTransition|removed={{csgo}}}}
<span  id="$envmapoptional"></span>
{{MatParam|$envmapoptional|choices|Sets the oldest {{L|DirectX Versions|DirectX version}} that should draw the reflection. Choose from:
:*<code>80</code> (DirectX 8)
:*<code>81</code> (DirectX 8.1)
:*<code>90</code> (DirectX 9)
:*<code>95</code> (DirectX 9 with Shader Model 3)|removed={{l4d}}}}
<span  id="$envmapsphere"></span>
{{MatParam|$envmapsphere|bool|Determines whether the material's envmap should be a spheremap (using matcap shading like {{gldsrc}} {{L|MDL (GoldSrc)|"chrome"}} textures) instead of a cubemap. Set this to 1 to use a spheremap.
: {{bug|In {{L|DirectX Versions|DirectX 9}} mode, this will instead act like a regular cubemap with all 6 faces being identical.}}|deprecated=1|removed={{as}}|also={{gmod}}}}
<span  id="$noenvmapmip"></span>
{{MatParam|$noenvmapmip|bool|Only use the top-level mipmap of the cubemap.|only={{csgo}}|shaders=LightmappedGeneric}}
[[File:Reflection tinting example.png|thumb|200px|Вентиляция без и с оттенком отражения. В нижней части изображения перечислены параметры использованные для создания этого эффекта.]]
<span  id="$fresnelreflection"></span>
{{MatParam|$fresnelreflection|float|Добавляет [http://www.3drender.com/glossary/fresneleffect.htm эффект Френеля] отражению. 0 - нет эффекта, а 1 - накладывает полный эффект, схож с <code>{{L|Water_(shader)|Water}}</code>. Эффект умножается при значениях выше 1.
{{bug|Значения инвертированы в {{bms}}, 0 - накладывает полный эффект, а 1 - нет эффекта.}}|since={{src06}}|shaders=LightmappedGeneric, Lightmapped_4WayBlend, WorldVertexTransition}}
<span  id="$envmapfresnel"></span>
{{MatParam|$envmapfresnel|float|Тоже самое что и <code>$fresnelreflection</code>, но для <code>VertexLitGeneric</code>. По умолчанию будет использовать диапазон установленный <code>$phongfresnelranges</code>.
: {{note|Работает только если сначала был включён {{L|$phong}} {{l4d}}.}}
|since={{src07}}|dx9=1|shaders=VertexLitGeneric}}
[[File:Anisotropic reflection example.jpeg|thumb|200px|Пример анизотропных отражений в игре с включённым $envmapanisotropyscale.]]
<span  id="$envmapfresnelminmaxexp"></span>
{{MatParam|$envmapfresnelminmaxexp|vector|Устанавливает диапазон френеля для материалов, использующих <code>$envmapfresnel</code> без фонга. По умолчанию: <code>"[0 1 2]"</code>.
: {{Note|Значения френеля для этого параметра отличаются от <code>{{L|$phong|$phongfresnelranges}}</code>. Первое значение - минимальное количество френеля, второе значение - максимальное количество френеля, а третье значение - экспонента.}}
: {{bug|Не может быть использован вместе с {{ent|$bumpmap}}. Вместо этого используйте <code>$phongfresnelranges</code>.}}|since={{l4d}}|shaders=VertexLitGeneric}}
<span  id="$envmaplightscale"></span>
{{MatParam|$envmaplightscale|float|Tint the surface's specular reflection with its lightmap. This matches a surface's reflection with its diffuse lighting and acts as rudimentary reflection occlusion. With a value of 1, a surface will have no reflection if it isn't lit at all. For models in {{csgo}}, vertex lighting is used for the tinting instead of a lightmap.{{note|Values above 1 for this parameter are technically permitted, but start inverting the effect.}}|since={{as}}|also={{gmod}}|shaders=LightmappedGeneric, Lightmapped_4WayBlend {{csgo}}, VertexLitGeneric {{csgo}}, WorldVertexTransition {{csgo}}}}
<span  id="$envmaplightscaleminmax"></span>
{{MatParam|$envmaplightscaleminmax|vector2|Thresholds for the lightmap reflection tinting effect. Setting the minimum value higher increases the minimum light amount at which the reflection gets nerfed to nothing.|only={{csgo}}|also={{gmod}}|shaders=LightmappedGeneric, Lightmapped_4WayBlend, VertexLitGeneric, WorldVertexTransition}}
<span  id="$envmapanisotropy"></span>
{{MatParam|$envmapanisotropy|bool|Enables anisotropic reflection emulation by warping the reflection downwards.<br>
For this it uses the alpha channel of the {{ent|$bumpmap}}.<br>
It linearly interpolates between a normal reflection vector and an anisotropic one.<br>
This means that values of 0 in the alpha will result in normal reflections, and a value of 1 will result in anisotropic reflections. {{bug|Does not work with {{ent|$normalmapalphaenvmapmask}}}} {{bug|Does not work with {{ent|$basealphaenvmapmask}} except {{ent|Lightmapped_4WayBlend}}}} {{note|Requires a {{ent|$bumpmap}} to be present.}}|only={{csgo}}|shaders=LightmappedGeneric, Lightmapped_4WayBlend, WorldVertexTransition}}
<span  id="$envmapanisotropyscale"></span>
{{MatParam|$envmapanisotropyscale|normal| Multiplier for how much the reflection should be warped.|only={{csgo}}|shaders=LightmappedGeneric, Lightmapped_4WayBlend, WorldVertexTransition}}

== Консольные команды ==

{{IO|{{L|buildcubemaps}}|Generates cubemaps for use in materials. If this isn't run, objects will reflect the skybox (OB) or have an invalid reflection, white in Ep1 and pink checkerboards in MP.}}
{{IO|envmap|Generates an environment map at the player's position and dumps it in cubemap_screenshots/, in six separate PFM files (or, if running without HDR, TGA files).
: {{tip|Cubemaps created this way will capture dynamic entities and models in them, which are normally hidden when using <code>buildcubemaps</code>.}}}}
{{IO|mat_envmaptgasize|param=int|Устанавливает разрешение для файлов созданных с помощью <code>envmap</code>. Значение по умолчанию: 32}}
{{IO|mat_fastspecular|param=bool|Quickly disable or enable specular rendering without reloading materials. This does not affect performance, only appearance. <code>mat_specular</code> must be used for proper performance testing.
: {{bug|Не работает в некоторых играх.}}}}
: {{note|Despite common misconception, setting this to 0 does ''not'' enable a "fancy specular" mode, it simply disables specular rendering entirely.}}
{{IO|mat_specular|param=bool|Отключает или включает зеркальные отражения, выгружает или загружает зеркальные материалы из памяти. По умолчанию 1.}}
{{IO|r_showenvcubemap|param=bool|Команда для отображения всех cubemaps на всех динамических объектах в полную яркость. Использовалось для создания изображения в начале статьи.}}

== Смотреть также ==

* {{L|$envmapmask}} (маска зеркального отражения)
* {{L|$phong}} (для рассеянного отражения)
* {{L|Cubemap}}

{{ACategory|Shader parameters|e}}
{{ACategory|VMT Reflections}}