Phong materials: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
m (clean up, replaced: External Links → External links, {{Source| → {{src|)
m (Multipage Template + technical category)
Tag: Replaced
Line 1: Line 1:
[[Image:Alyx_phong_closeup.jpg|right|250px|thumb|Alyx as rendered with the new Episode One lighting enhancements.]]
{{Multipage}}
{{for|The VMT parameter|[[$phong]]}}
With the release of {{hl2ep1|4}} a number of enhancements were made to the way lighting works within the {{src|4}} engine. The emphasis was on global illumination in order to ground characters in the game worlds and make them seem to be truly present in their environment.


One of these enhancements was the addition of ''Phong shading'' for players with graphic cards using ''ps_2_b'' or later pixel shaders - around 70% of all users who played [[Half-Life 2: Episode One]], according to the [http://www.steampowered.com/status/ep1/ player stats]. This new feature gives texture artists the ability to include Phong terms which can be driven by specular masks and exponent textures. These integrate naturally with the existing lighting and provide greater definition, particularly to key characters such as [[Alyx Vance]].
[[Category:Technical]]
 
The Phong shading can also include a Fresnel term in order to heavily favor rim lighting cases as opposed to general specular highlights. Under very bright lights, the specular rim highlights are often bright enough to bloom out in a dramatic fashion as a result of the Source engine's normal [[HDR]] post-processing.
{{clarify|Lightmap compilers use phong shading to smooth out the lighting of brushes; this is separate from the more advanced real-time phong used by $phong, which also does diffuse specular reflections.}}
 
==A brief introduction to Phong shading==
 
''The following short introduction is not necessary knowledge to use the Source Phong shader, but does provide some technical insights as to how the technique works and may be of interest to some readers.''
 
In simple terms, Phong shading is a technique used in 3D graphics to get better resolution of specular reflections. It was developed by [http://en.wikipedia.org/wiki/Bui_Tuong_Phong Dr. Bui Tuong Phong] at the University of Utah in 1973. His original publications combined the interpolation part of technique with his reflection model, the term ''Phong shading '' is commonly used to refer to either just the reflection model or to the combination of the reflection model and the interpolation method.
 
[[Image:Phong reflection.jpg|right|250px|thumb|The Phong reflection equation expressed graphically.]]
===The Phong reflection model===
 
The Phong reflection model is basically a simplified method of deciding the shade of a specific point on a 3D surface.
 
*It doesn't take into account second-order reflections often found in raytraced or diffuse rendering. To compensate an extra ambient lighting term is added to the scene that is rendered.
*It divides the reflection from a surface into three subcomponents - specular reflection, diffuse reflection and ambient reflection.
 
Phong reflection is an [http://dictionary.reference.com/search?q=empirical empirical] model based on informal observation. Dr. Phong observed that for very shiny surfaces the specular highlight was small and that the intensity fell off rapidly, while for duller surfaces it was larger and fell off more gradually.
 
[[Image:Flatvsphong.jpg|right|250px|thumb|Phong interpolation example.]]
 
===Phong interpolation===
 
Phong shading provides a better approximation to a per-pixel application of an underlying reflection model by assuming a smoothly varying surface normal vector. The Phong interpolation method works particularly well when applied to the Phong reflection model or to any reflection model that has small specular highlights.
 
In some modern hardware, variants of the interpolation algorithm are called "pixel shading" (this should not be confused with "pixel shaders"). Usually this means that the lighting calculations can be done per-pixel and include other lighting variables such as surface normals from a normal map which are interpolated across the polygon.
 
==Phong in the Source engine==
 
[[Image:Shadetree.jpg|right|150px|thumb|The episodic shader tree.]]
While the above gives a fairly basic explanation of Phong shading as a concept, the effect you see in Episode One is in fact the result of a number of combined lighting effects working together. An overview of these effects and how they are combined can be seen in the diagram of the episodic shader tree.
 
With model lighting, Source uses methods which combine spatially varying directional irradiance samples from the radiosity solution  with local light sources and environment mapping. On graphics hardware that supports 2.0 pixel shaders and lower, Source computes diffuse illumination from up to two local light sources, either per pixel or per vertex. On newer graphics chips with longer pixel shaders, Source includes specular contributions with Fresnel terms as well as more custom effects.
 
Phong shading is part of these extended effects and can be seen in the path starting bottom left of the shader tree. Phong exponent, mask and Fresnel terms are combined to give a specular term which is combined with the diffuse solution in the final output.
 
The rest of this document will focus on the Phong part of the shading tree explaining how the components work and how to create them.
 
==Using the Phong shader==
 
To use Phong shading with your models, you need to add the directive <code>$phong 1</code> into your material's VMT file. This tells the shader to include a Phong pass when executing the shader code. You then need to define a Phong mask in your normal maps alpha channel, a Phong exponent either as a texture or constant and finally, parameters for remapping the Fresnel output.
 
===Phong shader parameters===
 
The following is a list of VMT parameters that are needed to enable the Phong effect.
 
; <code>[[$phong]] <[[bool]]></code>
: Disable/enabled a Phong pass for this material.
; <code>$phongexponenttexture path/to/vtf</code>
: Filename of texture which defines Phong exponent per texel.
; <code>$phongexponent 0..255</code>
: Phong exponent for local specular lights. Overides <code>$phongexponenttexture</code> applying a defined constant exponent value over the whole texture. Default 5.0.
; <code>$phongboost <[[float]]></code>
: Phong overbrightening factor. The phong mask channel should be authored to account for this. Default 1.0.
; <code>$phongfresnelranges "[n n n]"</code>
: Parameters for remapping Fresnel output, Default [0 0.5 1].
; <code>$basemapalphaphongmask <[[bool]]></code>
: Use the alpha channel of the <code>$basetexture</code> as Phong mask.
; <code>$basemapluminancephongmask <[[bool]]></code>
: Use the luminance of the <code>$basetexture</code> as Phong mask.
 
{{note|The Phong shader ''should'' use the default values for parameters that you omit from your VMT. However it appears that in some cases this doesn't happen and the shader doesn't work. Therefore it is recommended that you include all the paramters and specify the default values yourself.}}
 
===Example VMT for Phong===
 
The following simplified example is taken from [[Half-Life 2: Episode One]] and comes from the file <code>materials/models/Alyx/alyx_faceandhair.vmt</code> which controls the texture on Alyx's face:
 
<pre>
VertexLitGeneric
{
$basetexture models/Alyx/alyx_faceandhair
$bumpmap models/alyx/alyx_head_normal
$halflambert 1
$nodecal 1
$model 1
 
$phong 1
// $phongexponent 33
$phongexponenttexture models/Alyx/alyx_head_exponent
$phongboost 6
$phongfresnelranges "[0.05 0.5 1]"
}
</pre>
 
==Phong components and parameters in detail==
 
[[Image:Specvsexponentinphong2os.jpg|right|150px|thumb|Examples of the relationship between Phong (Specular) intensity and exponent values.]]
===Phong mask and exponent texture===
 
The ''Phong mask'' is a [http://en.wikipedia.org/wiki/Greyscale greyscale] image stored in the alpha channel of the models [[Normal_Maps|normal map]] (defined by <code>$bumpmap</code>). This mask defines on a per [[Texel|texel]] basis the intensity, or strength, of the Phong highlight for that texel. Black represents the lowest intensity and shows no Phong highlight at all (literally knocking it out), whereas white represents the brightest, or full intensity for that texel.
 
Instead of the normal map, the Phong mask can also be loaded from the alpha channel of the base texture, using the <code>$basemapalphaphongmask 1</code> parameter. Alternatively, the luminance of the base texture can directly be used as the mask with <code>$basemapluminancephongmask 1</code>.
 
[[Image:Phong mask.jpg|right|150px|thumb|Alyx's Phong Mask texture.]]
The ''Phong exponent'' defines the "tightness" of the highlight.  A higher exponent results in a smaller, tighter highlight while a lower exponent results in a broader flatter one.
 
Different materials will exhibit highlights (tighter or broader) based upon their physical properties.  A harder, smoother material such as a pool ball may have a very tight highlight while a softer, rougher material like a rubber tire may have a very broad specular highlight.  In the Phong lighting equation, there is an exponent which mathematically controls the shape of the resulting highlight (tight or broad), hence the naming.
 
[[Image:Phong exponent.jpg|right|150px|thumb|Alyx's Phong exponent texture.]]
The Phong exponent texture can be defined in one of two ways:
 
*<code>$phongexponenttexture</code> defines a texture which on a per texel bases defines the exponent value for a surface.
*<code>$phongexponent</code> overrides the exponent texture and is useful during development to get a quick overall specular term without painting a channel.  It is then usually just commented out when a given texture map gets made and added to the mix for a given material.
 
The Phong exponent texture uses the red and green channels of the image for different purposes. The red channel defines the Phong exponent value and the green for albedo tinting. However, albedo tinting is a "work in progress" feature and currently '''un-supported''' in the current shader in some branches. For this reason, and the sake of simplicity, you should use greyscale for exponent textures.
 
Note: 05/2017 - *Albedo tinting through the green channel of the exponent texture does work in Source Filmmaker.
 
{{note|Exponent values generally fall within the range 0 to 150. If you think of a texture channel has having a value from 0 to 255 or even just 0.0 to 1.0, the minimum value will map to an exponent of 1 while the maximum value will map to an exponent of 150.  Thus, it is possible to have texel values which map to floating point values between the integer values in the range of 0 to 150.  This number 150 is an arbitrary number Valve chose to correspond to a range found useful in practice. Choosing larger numbers can result in unwanted aliasing and this mapping was chosen to avoid it.}}
 
===Phong boost===
 
The Phong boost value is an overbrightening factor applied to the Phong mask channel. The Phong mask channel should be authored to take the Phong boost value into account for this. Values are unbound and can even be negative although this would probably provide worthless results.
 
[[Image:Defaultfresnelterms.jpg|right|150px|thumb|How the Fresnel range relates to surface and view angle.]]
===Phong Fresnel ranges===
[[Image:Alyxfresnel.jpg|right|150px|thumb|Alyx's Fresnel Term. A surface whose grazing angle is closer to the view angle appears brighter.]]
 
The Fresnel ranges values control the optional [http://en.wikipedia.org/wiki/Fresnel_equations Fresnel term] which is used to give ''rim lighting'' to a model. In short, this brightens those surfaces of the model that face away from the players viewpoint. The nearer their surface is to being parallel to the viewing angle, the brighter they become. These brighter surfaces are picked up by the [[HDR]] pass giving them a bloomed effect.
 
To explain this in more detail, reflective surfaces increase in reflectivity as the angle of view approaches a ''grazing angle''. Even a partially reflective surface theoretically becomes 100% reflective when the angle of view is parallel to the surface. This is called the ''Fresnel term''.  We can express how reflective a surface is using the symbol '''φ''' and with a value between 0 and 1.
 
In the VMT the Frensel Terms are defined using the format <code>$phongfresnelranges [&#966;<sup>X</sup> &#966;<sup>Y</sup> &#966;<sup>Z</sup>]</code>. X represents how reflective the surface is when the view angle equals the surface normal. Z represents reflectivity when the view angle equals the grazing angle. Y represents reflectivity half-way between these two.
 
The default range values for Alyx's face are <code>[0.05 0.5 1]</code> which gives a linear brightening of the surfaces as they turn away from the player's view point. You can see how this looks in the visualisation of the Fresnel term included with this article.
 
Although we've used values between 0 and 1 so far, the actual values are unbound and you can use any number you like. For example, in [[Day of Defeat: Source]] values of <code>[1 3 8]</code> can be seen. This is useful when you are using no Phong boost and your Phong mask and exponent textures are very dark to give a minimal Phong highlight. The large Fresnel range values effectively boost  the Fresnel term without effecting the Phong highlights of the model.
 
{{tip|If you don't want to have rim lighting on your model, you can use the Fresnel range <code>[0 0 0]</code> to disable it.}}
 
These codes will show you How Fresnel work
 
<source lang=cpp>
//source engine fresnel Ranges
float Fresnel2( vec3 vNormal, vec3 vEyeDir )
{
float fresnel = 1-saturate( dot( vNormal, vEyeDir ) ); // 1-(N.V) for Fresnel term
return fresnel * fresnel; // Square for a more subtle look
}
 
float Fresnel(vec3 vNormal, vec3 vEyeDir, vec3 vRanges)
{
 
float result, f = Fresnel2( vNormal, vEyeDir ); // Traditional Fresnel
 
if ( f > 0.5f )
result = mix( vRanges.y, vRanges.z, (2*f)-1 ); // Blend between mid and high values
else
        result = mix( vRanges.x, vRanges.y, 2*f ); // Blend between low and mid values
 
return result;
}</source>
 
==Notes==
 
Thanks to [http://www.pixelmaven.com/jason Jason Mitchell] of Valve with help preparing this article and for providing the pictures from his SIGGRAPH 2006 presentation.
 
Previously, the phong exponent textures were messed up in games using the Orange Box engine as they showed glossy white (noticable in DOD:S and in TF2 when using HWM models). Valve fixed this problem as of May 25, 2011.
 
== See also ==
 
* [[$phong]]
* [[$envmap]] (specular reflections)
* [[$rimlight]]
* [[$lightwarptexture]]
 
==External links==
[http://www.pixelmaven.com/jason Mitchell, Jason], Gary McTaggart and Chris Green (Valve), ''Shading in Valve's Source Engine''. Course 26: Advanced Real-Time Rendering in 3D Graphics and Games. SIGGRAPH, Boston, MA. August 2006:
*[https://steamcdn-a.akamaihd.net/apps/valve/2006/SIGGRAPH06_Course_ShadingInValvesSourceEngine.pdf Notes (see Chapter 7)]
*[https://steamcdn-a.akamaihd.net/apps/valve/2006/SIGGRAPH06_Course_ShadingInValvesSourceEngine_Slides.pdf Slides]
 
There is a ''' Substance Painter ''' Shader for Source Engine Phong shader (with most functions),you can edit your textures easily now.
*[https://share.substance3d.com/libraries/6595 Source Engine Phong Shader]
 
{{update}}


[[Category:Source]]
[[Category:Source]]

Revision as of 09:06, 5 January 2024

Template:Multipage

Retrieved from "https://developer.valvesoftware.com/w/index.php?title=Phong_materials&oldid=367488"