View source for Ru/$phong

[[File:Alyx phong closeup.jpg|thumb|200px|Шейдер Фонг обеспечивает подсветку кожи, губ и головной повязки Аликс.]]

Команда '''<code>$phong</code>''' [[VMT]] файла создает отражения различного цвета. В большинстве версиях движка доступна только с шейдером <code>[[VertexLitGeneric]]</code>; {{csgo}} '''[[Counter-Strike: Global Offensive]]''' (начиная с 2015) позволяет использовать с шейдером <code>[[LightmappedGeneric]]</code> (с некоторыми ограничениями). Подробнее смотрите [[Phong materials|Фонг материалы]].

==VMT syntax==

 $phong <[[bool]]>

Шейдер Фонг ''должен'' использовать стандартные значения для любых параметров конфигурации, которые вы не включили в свой файл материала. Однако оказывается так, что это не происходит. Тем не менее, все перечисленные ниже параметры обязательны, даже если их стандартные значения не меняются.

<syntaxhighlight lang=php>
VertexLitGeneric
{
	$phong 1

	$bumpmap				[texture]
	$phongexponent			5			// либо это
	$phongexponenttexture	[texture]	// либо это
	$phongboost				1.0
	$phongfresnelranges		"[0 0.5 1]"
}
</syntaxhighlight>

== Параметры шейдера ==

=== Masking ===

; <code>$bumpmap <[[texture]]></code>
: Здесь должна быть [[$bumpmap|карта нормалей]]. Ее [[alpha channel|альфа канал]] действует по умолчанию как [[Phong materials#Phong mask and exponent texture|маска Фонга]].
; {{L4D add|<code>$BasemapLuminancePhongMask <[[bool]]></code>}}
: Интенсивность Фонг основывается на яркости <code>$basetexture</code>.
;<code>$BasemapAlphaPhongMask <bool></code>
: Заменяет маску Фонга на [[alpha channel|альфа канал]] <code>[[$basetexture]]</code> вместо [[$bumpmap|карты нормалей]].
; <code>$PhongExponent <[[int]]></code>
: The numeric value overrides an exponent mask if present.
; <code>$PhongExponentTexture <texture></code> 
: An global [[Phong materials#Phong mask and exponent texture|exponent]] value, or a per-texel exponent texture map. In an exponent map:
:* '''<span style="color:red">Красный канал:</span>''' Exponent (size of highlight, 0-255, where a value of 0 is a large highlight, 255 small.)
:* '''<span style="color:green">Зеленый канал:</span>''' Albedo tint (if <code>$phongalbedotint 1</code>, higher is more tint)
:* '''<span style="color:blue">Синий канал:</span>''' Nothing
:* '''Alpha channel:''' <code>[[$rimlight]]</code> mask
; {{L4D add|<code>$shinyblood <[[int]]></code>}}
; {{L4D add|<code>$shinybloodexponent <int></code>}}
: {{todo|1=See ''[http://www.valvesoftware.com/publications/2010/GDC10_ShaderTechniquesL4D2.pdf#page=33 Shading a Bigger, Better Sequel: Techniques in Left 4 Dead 2]''.}}
; <code>$allowdiffusemodulation <int></code>
: {{todo}}
; <code>$DiffuseExp</code>
: {{todo|Does this have something to do with the ''$phongexponent'', ''$phongexponenttexture or both?}}

=== Brightness ===

; <code>$phongboost <[[int]]></code>
: Phong brightness factor. Larger values create a more intense highlight, useful for surfaces like metal and glass.
; <code>$PhongFresnelRanges <matrix></code>
: See [[Phong materials#Phong Fresnel ranges|Phong Fresnel ranges]]. Default is <code>"[0 0.5 1]"</code>.
; <code>$PhongDisableHalfLambert <bool></code> {{P2 add}}
: Used in [[Portal 2]] on the Personality Cores such as Wheatley, disables functionality of $halflambert. MAY need <code>$halflambert 0</code>!
;<code>$AmbientOcclusionTexture <texture></code>
: A "dirtmap". Mentioned in the SDK samples and seen in the VMT for Alyx's face. [[$ambientocclusion|Ambient Occlusion]] is generally used for the eyes and face.

=== Colours ===

; <code>$PhongAlbedoTint <bool></code>
: Allows the <code>[[$basetexture]]</code> to affect the colour of the Phong highlight. The amount of tint is defined by the green channel of <code>$phongexponenttexture</code> (see above).
; <code>$phongtint "[<red [[float]]> <green float> <blue float>]"</code>
: Modifies the colour of the phong reflection. The channels are interpreted relative to each other (so "[0 0 0]" and "[1 1 1]" are the same).
; <code>$PhongWarpTexture <texture></code> {{EP2 add}}
: {{todo|Used to create an iridescence effect, as seen on [[npc_hunter]]s.}}

== Phong shading on brush faces ==

A May 2015 update to {{csgo}} '''[[Counter-Strike: Global Offensive]]''' added limited support for Phong-based highlights on <code>[[LightmappedGeneric]]</code> materials. Currently it only works when the material is directly lit by an env_cascade_lighting, using the dynamic shadows as a mask (although traditional Phong masking is supported on top of this). It is known to work on displacements as well as <code>[[WorldVertexTransition]]</code> materials, but not water or <code>[[Lightmapped_4WayBlend]]</code>.

=== New Parameters ===

; <code>$phongMaskContrastBrightness "[<float> <float>]"</code>
: Defines the contrast level between light and dark areas in the mask, and the overall brightness, respectively. Added along with support for phong-shaded lightmapped textures. {{todo|Find out the range of both values, and whether or not it can be used on models.}}
; <code>$phongAmount "[<red float> <green float> <blue float> <brightness> float]"</code>
: Controls the tint and brightness. The fourth value can go beyond 1, but affects the brightness of the whole texture, not just the highlight.

== See also ==

* [[Phong materials]]
* [[$envmap]] (environment map)
* [[$lightwarptexture]]
* [[$rimlight]]

[[Category:List of Shader Parameters|P]]
[[Category:VMT Lighting]]