Complex Shader Processes - Revision history

Eric Lengyel at 04:14, 6 January 2025

2025-01-06T04:14:51Z

Eric Lengyel at 04:03, 6 January 2025

2025-01-06T04:03:40Z

← Older revision		Revision as of 04:03, 6 January 2025
Line 4:		Line 4:
	{{Tablehead\|Process\|Description}}		{{Tablehead\|Process\|Description}}
	\|-		\|-
	{{Process\|Diffuse Reflection\|Shader_diffuse.png\|Tangent-space normal '''N''' (optional)\|Scalar\|Calculates the Lambertian diffuse reflection factor '''N''' · '''L''', where '''L''' is the tangent-space direction to light. The result is saturated to the range [0,1]. If '''N''' is omitted, then it's as if '''N''' is (0,0,1).		{{Process\|Diffuse Reflection\|Shader_diffuse.png\|Tangent-space normal '''N''' (optional)\|Scalar\|Calculates the Lambertian diffuse reflection factor '''N''' · '''L''', where '''L''' is the tangent-space direction to light. The result is saturated to the range [0,1] and divided by pi. If '''N''' is omitted, then it's as if '''N''' is (0,0,1).

	This process implicitly uses the tangent light direction interpolant.		This process implicitly uses the tangent light direction interpolant.
Line 10:		Line 10:
	If the ambient reflection output depends on this process, then the results are undefined.}}		If the ambient reflection output depends on this process, then the results are undefined.}}
	\|-		\|-
	{{Process\|Specular Reflection\|Shader_specular.png\|Tangent-space normal '''N''' (optional), Specular power ''p'' (required)\|Scalar\|Calculates the Blinn specular reflection factor ('''N''' · '''H''')<sup>''p''</sup>, where '''H''' is the tangent-space direction halfway between the direction to light and direction to viewer. If '''N''' is omitted, then it's as if '''N''' is (0,0,1). The specular power ''p'' controls the sharpness of the specularity.		{{Process\|Specular Reflection\|Shader_specular.png\|Tangent-space normal '''N''' (optional), Specular power ''p'' (required)\|Scalar\|Calculates the Blinn specular reflection factor sat('''N''' · '''H''')<sup>''p''</sup>, where '''H''' is the tangent-space direction halfway between the direction to light and direction to viewer. If '''N''' is omitted, then it's as if '''N''' is (0,0,1). The specular power ''p'' controls the sharpness of the specularity.

	This process implicitly uses the tangent halfway direction interpolant, which in turn uses the tangent light direction and tangent view direction interpolants.		This process implicitly uses the tangent halfway direction interpolant, which in turn uses the tangent light direction and tangent view direction interpolants.

			If the ambient reflection output depends on this process, then the results are undefined.}}
			\|-
			{{Process\|Diffuse Transflection\|Shader_transflection.png\|Tangent-space normal '''N''' (optional)\|Scalar\|Calculates the diffuse transflection factor '''N''' · '''L''', where '''L''' is the tangent-space direction to light. The result is multiplied by the front-facing factor ''f'' and divided by pi, and it is ''not'' saturated. If '''N''' is omitted, then it's as if '''N''' is (0,0,1).

			This process implicitly uses the tangent light direction interpolant.

			If the ambient reflection output depends on this process, then the results are undefined.}}
			\|-
			{{Process\|Specular Transmission\|Shader_transmission.png\|Specular power ''p'' (required)\|Scalar\|Calculates the specular transmission factor sat(−'''L''' · '''V''')<sup>''p''</sup>, where '''L''' and '''V''' are the tangent-space direction to light and direction to viewer. The specular power ''p'' controls the sharpness of the specularity. This produces a transmission strength when a material is viewed from the back side with respect to the incoming light.

			This process implicitly uses the tangent light direction and view direction interpolants.

	If the ambient reflection output depends on this process, then the results are undefined.}}		If the ambient reflection output depends on this process, then the results are undefined.}}

Eric Lengyel at 03:46, 6 January 2025

2025-01-06T03:46:56Z

← Older revision		Revision as of 03:46, 6 January 2025
Line 59:		Line 59:
	\|-		\|-
	{{Process\|Composite Buffer\|Shader_composite.png\|None\|RGBA color\|Samples from the composite buffer at the current fragment coordinates.}}		{{Process\|Composite Buffer\|Shader_composite.png\|None\|RGBA color\|Samples from the composite buffer at the current fragment coordinates.}}
			\|-
			{{Process\|Generate Impostor Normal / Depth\|Shader_genimpostor.png\|3D vector '''N''' (optional)\|RGBA color\|When impostor textures are being generated, this process outputs the impostor normal in the RGB channels, and it outputs the impostor depth in the alpha channel.}}
	\|}		\|}

Eric Lengyel at 03:22, 6 January 2025

2025-01-06T03:22:09Z

← Older revision		Revision as of 03:22, 6 January 2025
Line 55:		Line 55:
	\|-		\|-
	{{Process\|Kill Fragment\|Shader_kill.png\|Scalar '''A''' (required), Scalar '''B''' (optional)\|None\|Kills the current fragment if '''A''' < '''B'''. If '''B''' is omitted, then the fragment is killed if '''A''' < 0.}}		{{Process\|Kill Fragment\|Shader_kill.png\|Scalar '''A''' (required), Scalar '''B''' (optional)\|None\|Kills the current fragment if '''A''' < '''B'''. If '''B''' is omitted, then the fragment is killed if '''A''' < 0.}}
			\|-
			{{Process\|Render Glyph\|Shader_glyph.png\|2D vector '''TEXC''' (required), RGBA color '''RGBA''' (required)\|RGBA color\|Renders glyph or vector graphics with Slug. The '''TEXC''' input should use the Texcoord 2 interpolant, and the '''RGBA''' input would normally use the Vertex Color interpolant.}}
			\|-
			{{Process\|Composite Buffer\|Shader_composite.png\|None\|RGBA color\|Samples from the composite buffer at the current fragment coordinates.}}
	\|}		\|}

Eric Lengyel at 02:25, 6 January 2025

2025-01-06T02:25:32Z

← Older revision		Revision as of 02:25, 6 January 2025
Line 13:		Line 13:

	This process implicitly uses the tangent halfway direction interpolant, which in turn uses the tangent light direction and tangent view direction interpolants.		This process implicitly uses the tangent halfway direction interpolant, which in turn uses the tangent light direction and tangent view direction interpolants.

	~~If the ambient reflection output depends on this process, then the results are undefined.}}~~
	\|-
	{{Process\|Microfacet Reflection\|Shader_microfacet.png\|Tangent-space normal '''N''' (optional)\|RGB color\|Calculates the Cook-Torrance microfacet reflection color. If '''N''' is omitted, then it's as if '''N''' is (0,0,1).

	~~This process implicitly uses the tangent light direction, tangent view direction, and tangent halfway direction interpolants.~~

	If the ambient reflection output depends on this process, then the results are undefined.}}		If the ambient reflection output depends on this process, then the results are undefined.}}

Eric Lengyel at 02:24, 6 January 2025

2025-01-06T02:24:31Z

← Older revision		Revision as of 02:24, 6 January 2025
Line 30:		Line 30:
	If the ambient reflection output depends on this process, then the results are undefined.}}		If the ambient reflection output depends on this process, then the results are undefined.}}
	\|-		\|-
	{{Process\|Combine ~~Normals~~\|Shader_combinenormals.png\|Normal vector '''N'''<sub>1</sub> (required), Normal vector '''N'''<sub>2</sub> (required), Scalar ''t'' (optional)\|3D vector\|If ''t'' is omitted, calculates a new normal vector corresponding to the normal that would be produced if the two height maps producing the input normals were added together.		{{Process\|Combine Normal Maps\|Shader_combinenormals.png\|Normal vector '''N'''<sub>1</sub> (required), Normal vector '''N'''<sub>2</sub> (required), Scalar ''t'' (optional)\|3D vector\|If ''t'' is omitted, calculates a new normal vector corresponding to the normal that would be produced if the two height maps producing the input normals were added together.

	If ''t'' is not omitted, then it determines how the heights are weighted, with the height corresponding to '''N'''<sub>1</sub> being weighted most when ''t'' is zero and the height corresponding to '''N'''<sub>2</sub> being weighted most when ''t'' is one. A value for ''t'' of 0.5 ~~does~~ produces an average height, which is not the same as the sum produces when ''t'' is omitted~~.}}~~		If ''t'' is not omitted, then it determines how the heights are weighted, with the height corresponding to '''N'''<sub>1</sub> being weighted most when ''t'' is zero and the height corresponding to '''N'''<sub>2</sub> being weighted most when ''t'' is one. A value for ''t'' of 0.5 produces an average height, which is not the same as the sum produces when ''t'' is omitted.}}
	\|-
	{{Process\|Front Normal\|Shader_frontnormal.png\|Normal vector '''N''' (required)\|3D vector\|Calculates a new normal vector by negating the ''z'' component of the input vector if the ''z'' component of the tangent-space light direction is negative. Otherwise, the input vector is passed through unchanged. This is useful when rendering two-sided triangles with a normal map because it has the effect of always facing the normal vector to the front with respect to the light direction.

	~~This process implicitly uses the tangent light direction interpolant.~~

	~~If the ambient reflection output depends on this process, then the results are undefined.~~

	~~''Tip:'' This process should not be used in impostor shaders~~.}}
	\|-		\|-
	{{Process\|Reflect Vector\|Shader_reflectvector.png\|3D vector '''V''' (required), 3D vector '''N''' (optional)\|3D vector\|Calculates the reflection of the vector '''V''' across the vector '''N'''. If '''N''' is omitted, then it's as if '''N''' is (0,0,1).}}		{{Process\|Reflect Vector\|Shader_reflectvector.png\|3D vector '''V''' (required), 3D vector '''N''' (optional)\|3D vector\|Calculates the reflection of the vector '''V''' across the vector '''N'''. If '''N''' is omitted, then it's as if '''N''' is (0,0,1).}}

Eric Lengyel: Created page with "This is a list of the complex shader processes that are available in the Shader Editor under the Complex tab. {| {{Table}} {{Tablehead|Process|Description}} |- {{Process|Diffuse Reflection|Shader_diffuse.png|Tangent-space normal '''N''' (optional)|Scalar|Calculates the Lambertian diffuse reflection factor '''N''' · '''L''', where '''L''' is the tangent-space direction to light. The result is saturated to the range [0,1]. If '''N''' is omitted, then..."

2023-07-15T11:59:05Z

Created page with "This is a list of the complex shader processes that are available in the Shader Editor under the Complex tab. {| {{Table}} {{Tablehead|Process|Description}} |- {{Process|Diffuse Reflection|Shader_diffuse.png|Tangent-space normal '''N''' (optional)|Scalar|Calculates the Lambertian diffuse reflection factor '''N''' · '''L''', where '''L''' is the tangent-space direction to light. The result is saturated to the range [0,1]. If '''N''' is omitted, then..."

New page

This is a list of the complex shader processes that are available in the [[Shader Editor]] under the Complex tab.

{| {{Table}}
{{Tablehead|Process|Description}}
|-
{{Process|Diffuse Reflection|Shader_diffuse.png|Tangent-space normal '''N''' (optional)|Scalar|Calculates the Lambertian diffuse reflection factor '''N''' · '''L''', where '''L''' is the tangent-space direction to light. The result is saturated to the range [0,1]. If '''N''' is omitted, then it's as if '''N''' is (0,0,1).

This process implicitly uses the tangent light direction interpolant.

If the ambient reflection output depends on this process, then the results are undefined.}}
|-
{{Process|Specular Reflection|Shader_specular.png|Tangent-space normal '''N''' (optional), Specular power ''p'' (required)|Scalar|Calculates the Blinn specular reflection factor ('''N''' · '''H''')''p'', where '''H''' is the tangent-space direction halfway between the direction to light and direction to viewer. If '''N''' is omitted, then it's as if '''N''' is (0,0,1). The specular power ''p'' controls the sharpness of the specularity.

This process implicitly uses the tangent halfway direction interpolant, which in turn uses the tangent light direction and tangent view direction interpolants.

If the ambient reflection output depends on this process, then the results are undefined.}}
|-
{{Process|Microfacet Reflection|Shader_microfacet.png|Tangent-space normal '''N''' (optional)|RGB color|Calculates the Cook-Torrance microfacet reflection color. If '''N''' is omitted, then it's as if '''N''' is (0,0,1).

This process implicitly uses the tangent light direction, tangent view direction, and tangent halfway direction interpolants.

If the ambient reflection output depends on this process, then the results are undefined.}}
|-
{{Process|Terrain Diffuse Reflection|Shader_terraindiffuse.png|Terrain normal '''N'''1 (optional), Terrain normal '''N'''2 (optional), Terrain normal '''N'''3 (optional)|Scalar|Calculates the Lambertian diffuse reflection factor for terrain. If any of the three inputs is missing, then the tangent-space normal vector is assumed to be (0,0,1). If all three inputs are present, then bump-mapped shading is performed. The three inputs should come from the three Terrain Normal processes.

If the ambient reflection output depends on this process, then the results are undefined.}}
|-
{{Process|Terrain Specular Reflection|Shader_terrainspecular.png|Terrain normal '''N'''1 (optional), Terrain normal '''N'''2 (optional), Terrain normal '''N'''3 (optional), Specular power ''p'' (required)|Scalar|Calculates the Blinn specular reflection factor for terrain. If any of the three inputs is missing, then the tangent-space normal vector is assumed to be (0,0,1). If all three inputs are present, then bump-mapped shading is performed. The three inputs should come from the three Terrain Normal processes. The specular power ''p'' controls the sharpness of the specularity.

If the ambient reflection output depends on this process, then the results are undefined.}}
|-
{{Process|Combine Normals|Shader_combinenormals.png|Normal vector '''N'''1 (required), Normal vector '''N'''2 (required), Scalar ''t'' (optional)|3D vector|If ''t'' is omitted, calculates a new normal vector corresponding to the normal that would be produced if the two height maps producing the input normals were added together.

If ''t'' is not omitted, then it determines how the heights are weighted, with the height corresponding to '''N'''1 being weighted most when ''t'' is zero and the height corresponding to '''N'''2 being weighted most when ''t'' is one. A value for ''t'' of 0.5 does produces an average height, which is not the same as the sum produces when ''t'' is omitted.}}
|-
{{Process|Front Normal|Shader_frontnormal.png|Normal vector '''N''' (required)|3D vector|Calculates a new normal vector by negating the ''z'' component of the input vector if the ''z'' component of the tangent-space light direction is negative. Otherwise, the input vector is passed through unchanged. This is useful when rendering two-sided triangles with a normal map because it has the effect of always facing the normal vector to the front with respect to the light direction.

This process implicitly uses the tangent light direction interpolant.

If the ambient reflection output depends on this process, then the results are undefined.

''Tip:'' This process should not be used in impostor shaders.}}
|-
{{Process|Reflect Vector|Shader_reflectvector.png|3D vector '''V''' (required), 3D vector '''N''' (optional)|3D vector|Calculates the reflection of the vector '''V''' across the vector '''N'''. If '''N''' is omitted, then it's as if '''N''' is (0,0,1).}}
|-
{{Process|Smooth Parameter|Shader_smooth.png|Value ''t'' (required)|Value of size matching ''t''|Calculates 3''t''2 − 2''t''3 componentwise. This has the effect of smoothing an interpolation parameter within the range [0,1] since the derivative at both endpoints is zero.}}
|-
{{Process|Steep Parameter|Shader_steep.png|Value ''t'' (required)|Value of size matching ''t''|Calculates 2''t'' − ''t''2 componentwise. This has the effect of making an interpolation start quickly at a steep slope and finish smoothly.}}
|-
{{Process|Linear Ramp|Shader_linearramp.png|Value '''A''' (required)|Value of size matching '''A'''|Remaps the range [''c'' − ½''w'', ''c'' + ½''w''] to the range [0,1] componentwise, where ''c'' is a center value and ''w'' is the width of the input range. The values of ''c'' and ''w'' are specified in the settings for the process.}}
|-
{{Process|Delta Depth|Shader_deltadepth.png|None|Scalar|Outputs the difference between the depth of the geometry in the structure buffer and the depth of the fragment being shaded, scaled by a factor ''s'' and clamped to the range [0,1]. The scale factor ''s'' is specified in the settings for the process.

If rendering to the structure buffer is disabled, then the output value is always 1.0.}}
|-
{{Process|Tangent to World Transform|Shader_tangenttoworld.png|3D vector '''V''' (required)|3D vector|Transforms the vector '''V''' from tangent space coordinates into world space coordinates.

This process implicitly uses three 3D vector interpolants containing the matrix that transforms from tangent space to world space.}}
|-
{{Process|Parallax Offset|Shader_parallax.png|2D vector '''TEXC''' (required)|2D vector|Perturbs the input texture coordinates using the parallax information in the normal map and outputs the result. The normal map is specified in the settings for the process. If parallax mapping is disabled, then the input texture coordinates '''TEXC''' are simply passed through to the output.

This process implicitly uses the tangent view direction interpolant.}}
|-
{{Process|Horizon Shadow|Shader_horizon.png|2D vector '''TEXC''' (required), RGB color '''RGB''' (required)|RGB color|Calculates the horizon map shadowing based on the two input horizon map sampled at the texture coordinates '''TEXC''' and multiplies the input color '''RGB''' by the amount of light reaching the surface. The horizon map is specified in the settings for the process. Flags for excluding horizon mapping for infinite or points lights can also be set. If horizon mapping is disabled or the shader is used in conjunction with a light type that has been excluded, then the input color '''RGB''' is simply passed through to the output.

This process implicitly uses the tangent light direction interpolant.

If the ambient reflection output depends on this process, then the results are undefined.}}
|-
{{Process|Kill Fragment|Shader_kill.png|Scalar '''A''' (required), Scalar '''B''' (optional)|None|Kills the current fragment if '''A''' < '''B'''. If '''B''' is omitted, then the fragment is killed if '''A''' < 0.}}
|}

== See Also ==

* [[Shader Editor]]
* [[Basic Shader Processes]]
* [[Mathematical Shader Processes]]
* [[Interpolant Shader Processes]]

[[Category:Shaders]]

← Older revision		Revision as of 04:14, 6 January 2025
Line 4:		Line 4:
	{{Tablehead\|Process\|Description}}		{{Tablehead\|Process\|Description}}
	\|-		\|-
	{{Process\|Diffuse Reflection\|Shader_diffuse.png\|~~Tangent~~-space normal '''N''' (optional)\|Scalar\|Calculates the Lambertian diffuse reflection factor '''N''' · '''L''', where '''L''' is the ~~tangent-space~~ direction to light. The result is saturated to the range [0,1] and divided by pi. If '''N''' is omitted, then it's as if '''N''' is (0,0,1).		{{Process\|Diffuse Reflection\|Shader_diffuse.png\|World-space or tangent-space normal '''N''' (optional)\|Scalar\|Calculates the Lambertian diffuse reflection factor '''N''' · '''L''', where '''L''' is the direction to light. The result is saturated to the range [0,1] and divided by pi. If '''N''' is omitted, then it's as if '''N''' is (0,0,1).

	This process implicitly uses the ~~tangent~~ light direction interpolant.		This process implicitly uses the world light direction interpolant.

	If the ambient reflection output depends on this process, then the results are undefined.}}		If the ambient reflection output depends on this process, then the results are undefined.}}
	\|-		\|-
	{{Process\|Specular Reflection\|Shader_specular.png\|~~Tangent~~-space normal '''N''' (optional), Specular power ''p'' (required)\|Scalar\|Calculates the Blinn specular reflection factor sat('''N''' · '''H''')<sup>''p''</sup>, where '''H''' is the ~~tangent-space~~ direction halfway between the direction to light and direction to viewer. If '''N''' is omitted, then it's as if '''N''' is (0,0,1). The specular power ''p'' controls the sharpness of the specularity.		{{Process\|Specular Reflection\|Shader_specular.png\|World-space or tangent-space normal '''N''' (optional), Specular power ''p'' (required)\|Scalar\|Calculates the Blinn specular reflection factor sat('''N''' · '''H''')<sup>''p''</sup>, where '''H''' is the direction halfway between the direction to light and direction to viewer. If '''N''' is omitted, then it's as if '''N''' is (0,0,1) in tangent space. The specular power ''p'' controls the sharpness of the specularity.

	This process implicitly uses the ~~tangent~~ halfway direction interpolant, which in turn uses the ~~tangent~~ light direction and ~~tangent~~ view direction interpolants.		This process implicitly uses the world halfway direction interpolant, which in turn uses the world light direction and world view direction interpolants.

	If the ambient reflection output depends on this process, then the results are undefined.}}		If the ambient reflection output depends on this process, then the results are undefined.}}
	\|-		\|-
	{{Process\|Diffuse Transflection\|Shader_transflection.png\|~~Tangent~~-space normal '''N''' (optional)\|Scalar\|Calculates the diffuse transflection factor '''N''' · '''L''', where '''L''' is the ~~tangent-space~~ direction to light. The result is multiplied by the front-facing factor ''f'' and divided by pi, and it is ''not'' saturated. If '''N''' is omitted, then it's as if '''N''' is (0,0,1).		{{Process\|Diffuse Transflection\|Shader_transflection.png\|World-space or tangent-space normal '''N''' (optional)\|Scalar\|Calculates the diffuse transflection factor '''N''' · '''L''', where '''L''' is the direction to light. The result is multiplied by the front-facing factor ''f'' and divided by pi, and it is ''not'' saturated. If '''N''' is omitted, then it's as if '''N''' is (0,0,1) in tangent space.

	This process implicitly uses the ~~tangent~~ light direction interpolant.		This process implicitly uses the world light direction interpolant.

	If the ambient reflection output depends on this process, then the results are undefined.}}		If the ambient reflection output depends on this process, then the results are undefined.}}
	\|-		\|-
	{{Process\|Specular Transmission\|Shader_transmission.png\|Specular power ''p'' (required)\|Scalar\|Calculates the specular transmission factor sat(−'''L''' · '''V''')<sup>''p''</sup>, where '''L''' and '''V''' are the ~~tangent-space~~ direction to light and direction to viewer. The specular power ''p'' controls the sharpness of the specularity. This produces a transmission strength when a material is viewed from the back side with respect to the incoming light.		{{Process\|Specular Transmission\|Shader_transmission.png\|Specular power ''p'' (required)\|Scalar\|Calculates the specular transmission factor sat(−'''L''' · '''V''')<sup>''p''</sup>, where '''L''' and '''V''' are the direction to light and direction to viewer. The specular power ''p'' controls the sharpness of the specularity. This produces a transmission strength when a material is viewed from the back side with respect to the incoming light.

	This process implicitly uses the ~~tangent~~ light direction and view direction interpolants.		This process implicitly uses the world light direction and view direction interpolants.

	If the ambient reflection output depends on this process, then the results are undefined.}}		If the ambient reflection output depends on this process, then the results are undefined.}}