HedgeDocs - User contributions [en]

Shadow Generations Shaders - DistanceBlend dpn

2025-08-25T15:31:14Z

Justin113D: Fixed title

{{Shader Documentation
| game = Shadow Generations
| shader name = DistanceBlend_dpn
| sbo = model=2, no_transparent_layer, no_noise, no_compute_instancing

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses [[Texture Blending#Distance blending|distance blending]] to blend between 3 sets of textures.

| related shaders =
Blend_dpndpn,
Blend_dpnbdpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn

| behavior =
This shader uses [[Texture Blending#Distance blending|distance blending]] to blend between 3 sets of PBR textures:
* <code>diffuse</code>, <code>diffuse[1]</code> and <code>diffuse[2]</code>
* <code>normal</code>, <code>normal[1]</code> and <code>normal[2]</code>
* The <code>specular</code> texture counts as 3 different textures, each color channel containing the smoothness for a different set.

The specular factor is the same for every set, and the ambient occlusion from the <code>specular</code> texture only gets used for the first set, while the second and third sets don't receive any ambient occlusion.

The shaders <code>DistanceBlend</code> parameter determines at which distance to blend to each texture set:
* <code>X</code> and <code>Y</code> are used to blend to the second set of textures
* <code>Z</code> and <code>W</code> are used to blend to the third set of textures

The third set has priority over the second set, so if the distances are set up so that the third set starts blending in before the second, then the second won't be visible at all.

| vertex colors =
* Color is multiplied into the <code>diffuse</code> texture color
* Alpha is multiplied into the <code>diffuse</code> texture alpha

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|albedo]] color__,
First [[Opacity|opacity]];

diffuse,1,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|albedo]] color__,
Second [[Opacity|opacity]];

diffuse,2,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Third [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|albedo]] color__,
Third [[Opacity|opacity]];

specular,0,0,,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|smoothness]] factor,
Third [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|smoothness]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,2,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|normal map direction]]_,,;

normal,1,Any,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Second [[Normal_mapping|normal map direction]]_,,;

normal,2,Any,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Third [[Normal_mapping|normal map direction]]_,,;

| parameters =

DistanceBlend,
First distance center,
First fade range,
Second distance center,
Second fade range;

DetailFactor,
UV scale for the
* <code>diffuse[1]</code> texture
* <code>normal[1]</code> texture
* <code>specular</code> texture (only for sampling the second smoothness factor),
UV scale for the
* <code>diffuse[2]</code> texture
* <code>normal[2]</code> texture
* <code>specular</code> texture (only for sampling the third smoothness factor),,;

PBRFactor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor,,,;

| features =
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi
}}

Shadow Generations Shaders - DistanceBlend dpn

2025-08-25T15:30:08Z

Justin113D: Created page with "{{Shader Documentation | game = Shadow Generations | shader name = Blend_dpndpn | sbo = model=2, no_transparent_layer, no_noise, no_compute_instancing | overview = An advanced PBR shader that uses distance blending to blend between 3 sets of textures. | related shaders = Blend_dpndpn, Blend_dpnbdpn, BlendDetail_dndnd, BlendDetail_dpndpnn, Detail_dpndpn, Detail_dpnn, Direct..."

{{Shader Documentation
| game = Shadow Generations
| shader name = Blend_dpndpn
| sbo = model=2, no_transparent_layer, no_noise, no_compute_instancing

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses [[Texture Blending#Distance blending|distance blending]] to blend between 3 sets of textures.

| related shaders =
Blend_dpndpn,
Blend_dpnbdpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn

| behavior =
This shader uses [[Texture Blending#Distance blending|distance blending]] to blend between 3 sets of PBR textures:
* <code>diffuse</code>, <code>diffuse[1]</code> and <code>diffuse[2]</code>
* <code>normal</code>, <code>normal[1]</code> and <code>normal[2]</code>
* The <code>specular</code> texture counts as 3 different textures, each color channel containing the smoothness for a different set.

The specular factor is the same for every set, and the ambient occlusion from the <code>specular</code> texture only gets used for the first set, while the second and third sets don't receive any ambient occlusion.

The shaders <code>DistanceBlend</code> parameter determines at which distance to blend to each texture set:
* <code>X</code> and <code>Y</code> are used to blend to the second set of textures
* <code>Z</code> and <code>W</code> are used to blend to the third set of textures

The third set has priority over the second set, so if the distances are set up so that the third set starts blending in before the second, then the second won't be visible at all.

| vertex colors =
* Color is multiplied into the <code>diffuse</code> texture color
* Alpha is multiplied into the <code>diffuse</code> texture alpha

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|albedo]] color__,
First [[Opacity|opacity]];

diffuse,1,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|albedo]] color__,
Second [[Opacity|opacity]];

diffuse,2,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Third [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|albedo]] color__,
Third [[Opacity|opacity]];

specular,0,0,,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|smoothness]] factor,
Third [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|smoothness]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,2,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|normal map direction]]_,,;

normal,1,Any,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Second [[Normal_mapping|normal map direction]]_,,;

normal,2,Any,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Third [[Normal_mapping|normal map direction]]_,,;

| parameters =

DistanceBlend,
First distance center,
First fade range,
Second distance center,
Second fade range;

DetailFactor,
UV scale for the
* <code>diffuse[1]</code> texture
* <code>normal[1]</code> texture
* <code>specular</code> texture (only for sampling the second smoothness factor),
UV scale for the
* <code>diffuse[2]</code> texture
* <code>normal[2]</code> texture
* <code>specular</code> texture (only for sampling the third smoothness factor),,;

PBRFactor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor,,,;

| features =
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi
}}

Shadow Generations Shaders - DirectionBlend dpnndpn

2025-08-25T14:04:54Z

Justin113D: Added more shader links

{{Shader Documentation
| game = Shadow Generations
| shader name = DirectionBlend_dpnndpn
| sbo = model=2, no_noise, no_transparent_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses
* [[Texture Blending#Directional blending|directional blending]] to interpolate between two texture sets
* [[Texture Blending#Distance blending|distance blending]] to [[Texture Blending#Normal map blending|blend]] a detail [[Hedgehog Engine 2 - Textures#Normal map|normal map]] into the first normal texture

This shader is essentially a combination of the {{ShaderLink|Shadow Generations|DirectionBlend_dpndpn}} and {{ShaderLink|Shadow Generations|Detail_dpnn}} shaders.

| overview bugs = This shader has a bug where the second normal texture is not applied.

| related shaders =
Blend_dpnbdpn,
Blend_dpndpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DistanceBlend_dpn

| behavior =

=== Distance blending ===
Uses [[Texture Blending#Distance blending|distance blending]] to interpolate
* from the <code>normal</code> texture
* to the <code>normal</code> and <code>normal[1]</code> textures [[Texture Blending#Normal map blending|blended]] together
for the normal map of the first set of textures.

 The shader uses <code>detailDistance</code> and <code>detailFadeRange</code> from the stage RFL to determine the detail range.

=== Directional blending ===

This shader has two sets of PBR textures:
* <code>diffuse</code>, <code>specular</code> and <code>normal</code>
* <code>diffuse[1]</code>, <code>specular[1]</code> and <code>normal[2]</code>

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor is calculated using [[Texture Blending#Directional blending|directional blending]].

This involves various inputs:

{{{!}} class="wikitable"
{{!}}+
! Input
! Description
{{!}}-
{{!}} Normal map
{{!}} The <code>normal</code> (after[[#Distance blending|distance blending]]) texture is applied to the normal direction before calculating the directional blend factor
{{!}}-
{{!}} Red vertex color channel
{{!}} The [[Texture Blending#Variables|directional blend bias]]
{{!}}-
{{!}} <code>DirectionParam</code> parameter
{{!}} The [[Texture Blending#Directional blending|directional blend direction]]
{{!}}-
{{!}} <code>NormalBlendParam</code> parameter
{{!}} The [[Texture Blending#Directional blending|Directional blend intensity and offset]]
{{!}}-
{{!}} <code>diffuse</code> and <code>diffuse[1]</code> (multiplied together)
{{!}} The [[Texture Blending#Directional blending|Directional blend limit]]
{{!}}}

=== Transparency ===

(For some reason) the directional blend factor is used for the transparency, and not any of the diffuse textures alpha channels, which makes for limited use cases.

| vertex colors =
* The colors...
** Red channel is used as the [[Texture Blending#Variables|directional blend bias]]
** Green and blue channels are unused
* Alpha is unused

| bugs =
When the shader unpacks the <code>normal[2]</code> texture, the tangent and binormal vectors are left at 0, which results in no change by the normal map at all.

 Speculation:
The developers could have attempted to implement multi-tangent here, but must have compiled the shader before the multi-tangent system was properly implemented, which left the tangent and binormal at 0 and resulted in incorrectly unpacking the normal map.

| textures =
diffuse,0,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Texture Blending#Variables|directional blend limit]];

diffuse,1,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Texture Blending#Variables|directional blend limit]];

specular,0,Any,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,Any,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,Any,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|Normal map direction]]_,,;

normal,1,Any,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

normal,2,Any,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Second [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the <code>normal[1]</code> texture,,,;

DirectionParam, [[Texture Blending#Directional blending|Directional blend direction]]__,;

NormalBlendParam,
[[Texture Blending#Directional blending|Directional blend intensity]],
[[Texture Blending#Directional blending|Directional blend offset]],
,;

| gallery =
File:ShadowGenerations DirectionBlend dpnndpn example.jpg{{!}}How <code>DirectionBlend_dpnndpn</code> is used in Shadow Generations to create a "moss" layer on top of the cliffs in Kingdom Valley
File:ShadowGenerations DirectionBlend dpnndpn bug.png{{!}}Showing how the bug affects normals of the second set of textures

| technical =
For some reason using the <code>IBL_CAPTURE</code> debug view the directional blend factor is set to 0.
 Why this was done is unknown, and makes no sense, as this produces IBL textures with an incorrect looking environment.

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi

}}

Shadow Generations Shaders - DirectionBlend dpndpnn

2025-08-25T14:03:52Z

Justin113D: Added page

{{Shader Documentation
| game = Shadow Generations
| shader name = DirectionBlend_dpndpnn
| sbo = model=2, no_noise, no_transparent_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that
* uses [[Texture Blending#Directional blending|directional blending]] to interpolate between two texture sets
* [[Texture Blending#Normal map blending|blends]] an extra [[Hedgehog Engine 2 - Textures#Normal map|normal map]] textures into the other normal maps.

This shader is essentially a modification of the {{ShaderLink|Shadow Generations|DirectionBlend_dpndpn}} shader.

| related shaders =
Blend_dpnbdpn,
Blend_dpndpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =

=== Extra Normal Map ===
The <code>normal[2]</code> texture is [[Texture Blending#Normal map blending|blended]] into the <code>normal</code> and <code>normal[1]</code> textures before their usage.

=== Directional blending ===

This shader has two sets of PBR textures:
* <code>diffuse</code>, <code>specular</code> and <code>normal</code>
* <code>diffuse[1]</code>, <code>specular[1]</code> and <code>normal[1]</code>

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor is calculated using [[Texture Blending#Directional blending|directional blending]].

This involves various inputs:

{{{!}} class="wikitable"
{{!}}+
! Input
! Description
{{!}}-
{{!}} Normal map
{{!}} The <code>normal</code> texture is applied to the normal direction before calculating the directional blend factor
{{!}}-
{{!}} Red vertex color channel
{{!}} The [[Texture Blending#Variables|directional blend bias]]
{{!}}-
{{!}} <code>DirectionParam</code> parameter
{{!}} The [[Texture Blending#Directional blending|directional blend direction]]
{{!}}-
{{!}} <code>NormalBlendParam</code> parameter
{{!}} The [[Texture Blending#Directional blending|Directional blend intensity and offset]]
{{!}}-
{{!}} <code>diffuse</code> and <code>diffuse[1]</code> (multiplied together)
{{!}} The [[Texture Blending#Directional blending|Directional blend limit]]
{{!}}}

=== Transparency ===

(For some reason) the directional blend factor is used for the transparency, and not any of the diffuse textures alpha channels, which makes for limited use cases.

| vertex colors =
* The colors...
** Red channel is used as the [[Texture Blending#Variables|directional blend bias]]
** Green and blue channels are unused
* Alpha is unused

| textures =
diffuse,0,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Texture Blending#Variables|directional blend limit]];

diffuse,1,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Texture Blending#Variables|directional blend limit]];

specular,0,Any,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,Any,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,Any,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|Normal map direction]]_,,;

normal,1,Any,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Second [[Normal_mapping|Normal map direction]]_,,;

normal,2,Any,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Extra [[Normal_mapping|Normal map direction]] that is [[Texture Blending#Normal map blending|blended]] into the other normal maps_,,;

| parameters =

DirectionParam, [[Texture Blending#Directional blending|Directional blend direction]]__,;

NormalBlendParam,
[[Texture Blending#Directional blending|Directional blend intensity]],
[[Texture Blending#Directional blending|Directional blend offset]],
,;

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi

}}

File:ShadowGenerations DirectionBlend dpndpn example.jpg

2025-08-25T13:49:01Z

Justin113D: Justin113D uploaded a new version of File:ShadowGenerations DirectionBlend dpndpn example.jpg

An example for how the DirectionBlend_dpndpn shader is used in Shadow Generations

Shadow Generations Shaders - DirectionBlend dpnndpn

2025-08-25T13:28:25Z

Justin113D:

{{Shader Documentation
| game = Shadow Generations
| shader name = DirectionBlend_dpnndpn
| sbo = model=2, no_noise, no_transparent_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses
* [[Texture Blending#Directional blending|directional blending]] to interpolate between two texture sets
* [[Texture Blending#Distance blending|distance blending]] to [[Texture Blending#Normal map blending|blend]] a detail [[Hedgehog Engine 2 - Textures#Normal map|normal map]] into the first normal texture

| overview bugs = This shader has a bug where the second normal texture is not applied.

| related shaders =
Blend_dpnbdpn,
Blend_dpndpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DistanceBlend_dpn

| behavior =

=== Distance blending ===
Uses [[Texture Blending#Distance blending|distance blending]] to interpolate
* from the <code>normal</code> texture
* to the <code>normal</code> and <code>normal[1]</code> textures [[Texture Blending#Normal map blending|blended]] together
for the normal map of the first set of textures.

 The shader uses <code>detailDistance</code> and <code>detailFadeRange</code> from the stage RFL to determine the detail range.

=== Directional blending ===

This shader has two sets of PBR textures:
* <code>diffuse</code>, <code>specular</code> and <code>normal</code>
* <code>diffuse[1]</code>, <code>specular[1]</code> and <code>normal[2]</code>

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor is calculated using [[Texture Blending#Directional blending|directional blending]].

This involves various inputs:

{{{!}} class="wikitable"
{{!}}+
! Input
! Description
{{!}}-
{{!}} Normal map
{{!}} The <code>normal</code> (after[[#Distance blending|distance blending]]) texture is applied to the normal direction before calculating the directional blend factor
{{!}}-
{{!}} Red vertex color channel
{{!}} The [[Texture Blending#Variables|directional blend bias]]
{{!}}-
{{!}} <code>DirectionParam</code> parameter
{{!}} The [[Texture Blending#Directional blending|directional blend direction]]
{{!}}-
{{!}} <code>NormalBlendParam</code> parameter
{{!}} The [[Texture Blending#Directional blending|Directional blend intensity and offset]]
{{!}}-
{{!}} <code>diffuse</code> and <code>diffuse[1]</code> (multiplied together)
{{!}} The [[Texture Blending#Directional blending|Directional blend limit]]
{{!}}}

=== Transparency ===

(For some reason) the directional blend factor is used for the transparency, and not any of the diffuse textures alpha channels, which makes for limited use cases.

| vertex colors =
* The colors...
** Red channel is used as the [[Texture Blending#Variables|directional blend bias]]
** Green and blue channels are unused
* Alpha is unused

| bugs =
When the shader unpacks the <code>normal[2]</code> texture, the tangent and binormal vectors are left at 0, which results in no change by the normal map at all.

 Speculation:
The developers could have attempted to implement multi-tangent here, but must have compiled the shader before the multi-tangent system was properly implemented, which left the tangent and binormal at 0 and resulted in incorrectly unpacking the normal map.

| textures =
diffuse,0,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Texture Blending#Variables|directional blend limit]];

diffuse,1,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Texture Blending#Variables|directional blend limit]];

specular,0,Any,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,Any,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,Any,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|Normal map direction]]_,,;

normal,1,Any,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

normal,2,Any,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Second [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the <code>normal[1]</code> texture,,,;

DirectionParam, [[Texture Blending#Directional blending|Directional blend direction]]__,;

NormalBlendParam,
[[Texture Blending#Directional blending|Directional blend intensity]],
[[Texture Blending#Directional blending|Directional blend offset]],
,;

| gallery =
File:ShadowGenerations DirectionBlend dpnndpn example.jpg{{!}}How <code>DirectionBlend_dpnndpn</code> is used in Shadow Generations to create a "moss" layer on top of the cliffs in Kingdom Valley
File:ShadowGenerations DirectionBlend dpnndpn bug.png{{!}}Showing how the bug affects normals of the second set of textures

| technical =
For some reason using the <code>IBL_CAPTURE</code> debug view the directional blend factor is set to 0.
 Why this was done is unknown, and makes no sense, as this produces IBL textures with an incorrect looking environment.

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi

}}

Shadow Generations Shaders - DirectionBlend dpnndpn

2025-08-25T13:19:08Z

Justin113D: Added gallery

{{Shader Documentation
| game = Shadow Generations
| shader name = DirectionBlend_dpnndpn
| sbo = model=2, no_noise, no_transparent_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses
* [[Texture Blending#Directional blending|directional blending]] to interpolate between two texture sets
* [[Texture Blending#Distance blending|distance blending]] to [[Texture Blending#Normal map blending|blend]] a detail [[Hedgehog Engine 2 - Textures#Normal map|normal map]] into the first normal texture

| overview bugs = This shader has a bug where the second normal texture is not applied.

| related shaders =
Blend_dpnbdpn,
Blend_dpndpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DistanceBlend_dpn

| behavior =

=== Distance blending ===
Uses [[Texture Blending#Distance blending|distance blending]] to interpolate
* from the <code>normal</code> texture
* to the <code>normal</code> and <code>normal[1]</code> textures [[Texture Blending#Normal map blending|blended]] together
for the normal map of the first set of textures.

 The shader uses <code>detailDistance</code> and <code>detailFadeRange</code> from the stage RFL to determine the detail range.

=== Directional blending ===

This shader has two sets of PBR textures:
* <code>diffuse</code>, <code>specular</code> and <code>normal</code>
* <code>diffuse[1]</code>, <code>specular[1]</code> and <code>normal[2]</code>

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor is calculated using [[Texture Blending#Directional blending|directional blending]].

This involves various inputs:

{{{!}} class="wikitable"
{{!}}+
! Input
! Description
{{!}}-
{{!}} Normal map
{{!}} The <code>normal</code> (after[[#Distance blending|distance blending]]) texture is applied to the normal direction before calculating the directional blend factor
{{!}}-
{{!}} Red vertex color channel
{{!}} The [[Texture Blending#Variables|directional blend bias]]
{{!}}-
{{!}} <code>DirectionParam</code> parameter
{{!}} The [[Texture Blending#Directional blending|directional blend direction]]
{{!}}-
{{!}} <code>NormalBlendParam</code> parameter
{{!}} The [[Texture Blending#Directional blending|Directional blend intensity and offset]]
{{!}}-
{{!}} <code>diffuse</code> and <code>diffuse[1]</code> (multiplied together)
{{!}} The [[Texture Blending#Directional blending|Directional blend limit]]
{{!}}}

=== Transparency ===

(For some reason) the directional blend factor is used for the transparency, and not any of the diffuse textures alpha channels, which makes for limited use cases.

| vertex colors =
* The colors...
** Red channel is used as the [[Texture Blending#Variables|directional blend bias]]
** Green and blue channels are unused
* Alpha is unused

| bugs =
When the shader unpacks the <code>normal[2]</code> texture, the tangent and binormal vectors are left at 0, which results in no change by the normal map at all.

 Speculation:
The developers could have attempted to implement multi-tangent here, but must have compiled the shader before the multi-tangent system was properly implemented, which left the tangent and binormal at 0 and resulted in incorrectly unpacking the normal map.

| textures =
diffuse,0,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Texture Blending#Variables|directional blend limit]];

diffuse,1,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Texture Blending#Variables|directional blend limit]];

specular,0,Any,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,Any,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,Any,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|Normal map direction]]_,,;

normal,1,Any,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

normal,2,Any,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Second [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the <code>normal[1]</code> texture,,,;

DirectionParam, [[Texture Blending#Directional blending|Directional blend direction]]__,;

NormalBlendParam,
[[Texture Blending#Directional blending|Directional blend intensity]],
[[Texture Blending#Directional blending|Directional blend offset]],
,;

| gallery =
File:ShadowGenerations DirectionBlend dpnndpn example.jpg{{!}}How <code>DirectionBlend_dpnndpn</code> is used in Shadow Generations to create a "moss" layer on top of the cliffs in Kingdom Valley
File:ShadowGenerations DirectionBlend dpnndpn bug.png{{!}}Showing how the bug affects normals of the second set of textures

| technical =
For some reason using the <code>IBL_CAPTURE</code> debug view the directional blend factor is set to 0.
Why this was done is unknown, and makes no sense.

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi

}}

File:ShadowGenerations DirectionBlend dpnndpn bug.png

2025-08-25T13:17:43Z

Justin113D:

Showing how the DirectionBlend_dpnndpn shader in Shadow Generations is bugged

File:ShadowGenerations DirectionBlend dpnndpn example.jpg

2025-08-25T13:17:05Z

Justin113D:

An example for how the DirectionBlend_dpnndpn shader is used in Shadow Generations

Shadow Generations Shaders - BlendDetail dpndpnn

2025-08-25T12:17:51Z

Justin113D: Used new bugs parameter

{{Shader Documentation
| game = Shadow Generations
| shader name = BlendDetail_dpndpnn
| sbo = model=2, no_noise, no_compute_instancing, no_transparent_layer, no_punch_through_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses
* [[Texture Blending#Distance blending|distance blending]] to [[Texture Blending#Normal map blending|blend]] in a detail [[Hedgehog Engine 2 - Textures#Normal map|normal map]]
* Vertex alpha to blend between two sets of [[Hedgehog Engine 2 - Textures#Albedo|albedo]] and [[Hedgehog Engine 2 - Textures#PRM|PRM]] textures

It is essentially a combination of the {{ShaderLink|Shadow Generations|Blend_dpndpn}} and {{ShaderLink|Shadow Generations|Detail_dpnn}} shaders.

| related shaders =
Blend_dpndpn,
Blend_dpnbdpn,
BlendDetail_dndnd,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =
=== Distance blending ===
Uses [[Texture Blending#Distance blending|distance blending]] to interpolate
* from the <code>normal</code> texture
* to the <code>normal</code> and <code>normal[2]</code> textures [[Texture Blending#Normal map blending|blended]] together.

 The shader uses <code>detailDistance</code> and <code>detailFadeRange</code> from the stage RFL to determine the detail range.

=== Vertex alpha blending ===

This shader has two sets of PBR textures:
* <code>diffuse</code> and <code>specular</code>
* <code>diffuse[1]</code> and <code>specular[1]</code>

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor consists of just the vertex alpha.

* For the <code>specular</code> textures, the blend factor is used as is.
* For the <code>diffuse</code> textures, the blend factor is multiplied by the <code>diffuse[1]</code> texture alpha.

| vertex colors =
* Color is multiplied into the <code>diffuse</code> texture color
* Alpha is used as the basis for the blend factor

| bugs = The shader has 3 <code>normal</code> texture slots: Only <code>normal</code> and <code>normal[2]</code> are used, with <code>normal[1]</code> left unused.
Yet, to be able to specify a texture for the <code>normal[2]</code> slot, a material must have 3 texture slots, even if the slot for <code>normal[1]</code> is empty.
 In a similar vein, the shader has the <code>enable_multi_tangent_space</code> feature, but never makes use of it.

 Speculation:
What likely happened here is that the developers used the code from {{ShaderLink|Shadow Generations|Blend_dpndpn}} as a base and then added in the detail normal map logic from {{ShaderLink|Shadow Generations|Detail_dpnn}} but accidentally pasted it over the previous normal map code, leaving just the detail normal map code behind.

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;

diffuse,1,2,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
Multiplied into the vertex alpha (blend factor)\, but only for when blending the two diffuse textures!;

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,2,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|Normal map direction]]_,,;

normal,1,N/A,,Unused___;

normal,2,3,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the <code>normal[2]</code> texture,,,;

| features =
enable_multi_tangent_space,
is_use_tex_srt_anim,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi,

}}

Shadow Generations Shaders - BlendDetail dndnd

2025-08-25T12:17:11Z

Justin113D: Used new bug parameters

{{Shader Documentation
| game = Shadow Generations
| shader name = BlendDetail_dndnd
| sbo = model=2, no_noise, no_compute_instancing, no_transparent_layer, no_punch_through_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses
* vertex alpha to blend between two [[Hedgehog Engine 2 - Textures#Albedo|albedo]] textures
* [[Texture Blending#Distance blending|distance blending]] to apply detail [[Hedgehog Engine 2 - Textures#Albedo|albedo]] and [[Hedgehog Engine 2 - Textures#Normal map|normal map]] textures

| overview bugs = This shader has a severe bug where normals break outside the detail range!

| related shaders =
Blend_dpndpn,
Blend_dpnbdpn,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =

=== Vertex alpha blending ===

The shader has two sets of <code>diffuse</code> textures and two sets of <code>PBRFactor</code> parameters.

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor consists of just the vertex alpha.

=== Distance blending ===

Uses [[Texture Blending#Distance blending|distance blending]] to interpolate

{{{!}} class="wikitable
{{!}}+
! From...
!... to
{{!}}-
{{!}} the <code>normal</code> texture
{{!}} the <code>normal</code> and <code>normal[1]</code> textures [[Texture Blending#Normal map blending|blended]] together
{{!}}-
{{!}} the combined <code>diffuse</code> textures
{{!}} the combined <code>diffuse</code> textures overlaid with the <code>diffuse[1]</code> texture using [[Texture Blending#Detail blending|detail blending]]
{{!}}}

| vertex colors =
* Color is not used
* Alpha is used as the basis for the blend factor

| bugs = The shader checks if the surface is within the detail range, and only then applies the detail diffuse and the detail normal textures.
Unfortunately, the surface' normal direction never gets set outside this <code>if</code>-block, which means normals are completely broken outside the detail range.

| textures =

diffuse,0,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;

diffuse,1,2,
Detail albedo,
[[Texture Blending#Detail blending|Detail color]]__,;

diffuse,2,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
[[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the <code>diffuse[1]</code> and <code>normal[1]</code> textures,,,;

PBRFactor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
;

PBRFactor2,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
;

| features =
enable_multi_tangent_space,
is_use_tex_srt_anim,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi,

}}

Shadow Generations Shaders - DirectionBlend dpnndpn

2025-08-25T12:15:55Z

Justin113D: Added bug warnings

{{Shader Documentation
| game = Shadow Generations
| shader name = DirectionBlend_dpnndpn
| sbo = model=2, no_noise, no_transparent_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses
* [[Texture Blending#Directional blending|directional blending]] to interpolate between two texture sets
* [[Texture Blending#Distance blending|distance blending]] to [[Texture Blending#Normal map blending|blend]] a detail [[Hedgehog Engine 2 - Textures#Normal map|normal map]] into the first normal texture

| overview bugs = This shader has a bug where the second normal texture is not applied.

| related shaders =
Blend_dpnbdpn,
Blend_dpndpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DistanceBlend_dpn

| behavior =

=== Distance blending ===
Uses [[Texture Blending#Distance blending|distance blending]] to interpolate
* from the <code>normal</code> texture
* to the <code>normal</code> and <code>normal[1]</code> textures [[Texture Blending#Normal map blending|blended]] together
for the normal map of the first set of textures.

 The shader uses <code>detailDistance</code> and <code>detailFadeRange</code> from the stage RFL to determine the detail range.

=== Directional blending ===

This shader has two sets of PBR textures:
* <code>diffuse</code>, <code>specular</code> and <code>normal</code>
* <code>diffuse[1]</code>, <code>specular[1]</code> and <code>normal[2]</code>

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor is calculated using [[Texture Blending#Directional blending|directional blending]].

This involves various inputs:

{{{!}} class="wikitable"
{{!}}+
! Input
! Description
{{!}}-
{{!}} Normal map
{{!}} The <code>normal</code> (after[[#Distance blending|distance blending]]) texture is applied to the normal direction before calculating the directional blend factor
{{!}}-
{{!}} Red vertex color channel
{{!}} The [[Texture Blending#Variables|directional blend bias]]
{{!}}-
{{!}} <code>DirectionParam</code> parameter
{{!}} The [[Texture Blending#Directional blending|directional blend direction]]
{{!}}-
{{!}} <code>NormalBlendParam</code> parameter
{{!}} The [[Texture Blending#Directional blending|Directional blend intensity and offset]]
{{!}}-
{{!}} <code>diffuse</code> and <code>diffuse[1]</code> (multiplied together)
{{!}} The [[Texture Blending#Directional blending|Directional blend limit]]
{{!}}}

=== Transparency ===

(For some reason) the directional blend factor is used for the transparency, and not any of the diffuse textures alpha channels, which makes for limited use cases.

| vertex colors =
* The colors...
** Red channel is used as the [[Texture Blending#Variables|directional blend bias]]
** Green and blue channels are unused
* Alpha is unused

| bugs =
When the shader unpacks the <code>normal[2]</code> texture, the tangent and binormal vectors are left at 0, which results in no change by the normal map at all.

 Speculation:
The developers could have attempted to implement multi-tangent here, but must have compiled the shader before the multi-tangent system was properly implemented, which left the tangent and binormal at 0 and resulted in incorrectly unpacking the normal map.

| textures =
diffuse,0,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Texture Blending#Variables|directional blend limit]];

diffuse,1,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Texture Blending#Variables|directional blend limit]];

specular,0,Any,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,Any,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,Any,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|Normal map direction]]_,,;

normal,1,Any,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

normal,2,Any,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Second [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the <code>normal[1]</code> texture,,,;

DirectionParam, [[Texture Blending#Directional blending|Directional blend direction]]__,;

NormalBlendParam,
[[Texture Blending#Directional blending|Directional blend intensity]],
[[Texture Blending#Directional blending|Directional blend offset]],
,;

| technical =
For some reason using the <code>IBL_CAPTURE</code> debug view the directional blend factor is set to 0.
Why this was done is unknown, and makes no sense.

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi

}}

Template:Shader Documentation

2025-08-25T12:11:35Z

Justin113D: Fixed typo

<includeonly>{{DISPLAYTITLE:{{{game}}} Shaders - {{{shader name}}}}}
[[{{{game}}} Shaders|Return to shaders list]]
== Overview ==
{{#invoke:ShaderDoc|create_sbo|game={{{game}}}|parameters={{{sbo|}}}}}
{{{overview}}}
{{#if:{{{overview bugs|}}}|{{notice
|type=warn
|content={{{overview bugs}}}
It is advised to not used this shader.}}}}
{{#if:{{{related shaders|}}}|
=== Related shaders ===
{{#invoke:ShaderDoc|shader_link_list
|game={{{game}}}
|shaders={{{related shaders}}}
}}|}}
== Behavior ==
{{{behavior|}}}
{{#if:{{{multi tangent|}}}|
=== Multi-tangent ===
{{{multi tangent}}}
|}}
=== Vertex Colors ===
{{{vertex colors|Shader does not use vertex colors}}}
{{#if:{{{bugs|}}}|
=== Bugs ===
{{notice
|type=warn
|content={{{bugs}}}}}}}
<div style="clear: both"/>

== Material Inputs ==

=== Textures ===
{{#if:{{{textures|}}}|
{{{!}} class="wikitable" width="100%"
{{!}}+
!width=1%{{!}}{{#tip-text: Name|Name of the material texture slot}}
!width=1%{{!}}{{#tip-text: Index|Index of the texture slot name, starting from 0; This is important when a shader has the same slot name multiple times, in which case their order determines how each slot is used}}
!width=1%{{!}}{{#tip-text: UV Index|Which UV map the slot uses, which is either an index from 0 to 3 or "any", in which case the UV map can be selected in the material.
If a model does not have a UV Map for the specified index, then the game will fall back to UV Index 0}}
!width=1%{{!}}{{#tip-text: Kind|General usage format of the texture slot. More precise documentation is found on the right}}
!width=24%{{!}} {{#tip-text: Red|How the red component of the texture gets used}}
!width=24%{{!}} {{#tip-text: Green|How the green component of the texture gets used}}
!width=24%{{!}} {{#tip-text: Blue|How the blue component of the texture gets used}}
!width=24%{{!}} {{#tip-text: Alpha|How the alpha component of the texture gets used}}
{{#invoke:ShaderDoc|shader_table|{{{textures}}}}}
{{!}}}|This shader does not use any textures.}}

=== Parameters ===
{{#if:{{{parameters|}}}|
{{{!}} class="wikitable" width="100%"
{{!}}+
!width=1%{{!}}{{#tip-text: Name|Name of the parameter}}
!width=25%{{!}}{{#tip-text: X|The first component of the parameter}}
!width=25%{{!}}{{#tip-text: Y|The second component of the parameter}}
!width=25%{{!}}{{#tip-text: Z|The third component of the parameter}}
!width=25%{{!}}{{#tip-text: W|The fourth component of the parameter}}
{{#invoke:ShaderDoc|shader_table|{{{parameters}}}}}
{{!}}}|This shader does not use any parameters.}}
{{#if:{{{gallery|}}}|
== Gallery ==
{{#tag:gallery|{{{gallery}}}|perrow=4|widths=400px|heights=300px|mode=nolines|}}|}}
== Technical ==
{{{technical|}}}
{{#if:{{{features|}}}|
{{{!}} class="mw-collapsible mw-collapsed wikitable" width="300px"
{{!}}-
!Shader Features
{{#invoke:ShaderDoc|technical_features|{{{features}}}}}
{{!}}}|}}<nowiki/></includeonly>
<noinclude>
<templatedata>
{
"params": {
"game": {
"label": "Game",
"description": "Which game this shader belongs to",
"type": "string",
"required": true
},
"shader name": {
"label": "Shader name",
"description": "The name of the shader",
"type": "string",
"required": true
},
"sbo": {
"label": "Shader behavior overview",
"description": "Parameters for the shader behavior overview",
"type": "string",
"required": false
},
"overview": {
"label": "Overview",
"description": "Overview content",
"type": "content",
"required": true
},
"overview bug": {
"label": "Overview bug",
"description": "Overview bug content",
"type": "content",
"required": false
},
"related shaders": {
"label": "Related shaders",
"description": "List of related shaders",
"type": "string",
"required": false
},
"behavior": {
"label": "Behavior",
"description": "Behavior content",
"type": "content",
"required": false
},
"multi tangent": {
"label": "Multi tangent",
"description": "Multi tangent behavior",
"type": "content",
"required": false
},
"vertex colors": {
"label": "Vertex color",
"description": "Vertex color behavior",
"type": "content",
"required": false
},
"bugs": {
"label": "Bugs",
"description": "Bugs in behavior",
"type": "content",
"required": false
},
"textures": {
"label": "Textures",
"description": "Texture table contents; Fields seperated by commas, column spans specified by underscores and rows seperated by semicolons",
"type": "content",
"required": false
},
"parameters": {
"label": "Parameters",
"description": "Parameter table contents; Fields seperated by commas, column spans specified by underscores and rows seperated by semicolons",
"type": "content",
"required": false
},
"gallery": {
"label": "Gallery contents",
"description": "Picture gallery contents",
"type": "string",
"required": false
},
"technical": {
"label": "Technical",
"description": "Technical information",
"type": "content",
"required": false
},
"features": {
"label": "Shader features (technical)",
"description": "List of technical features that the shader has been compiled with",
"type": "content",
"required": false
}
}
}
</templatedata>

== Example ==

{{Shader Documentation
| game = Shadow Generations

| shader name = Common_dpn

| sbo = model=2,
no_opaque_layer,
no_punch_through_layer,
noise_dithering

| overview = A standard PBR shader with no special behavior.

| overview bugs =

BUGS!

| related shaders =
Common_dn,
Common_dp,
Common_dpn,
Common_dpna,
Common_dither_dpn

| behavior = Lorem ipsum.

| multi tangent =
Lorem ipsum.

| vertex colors =
* Color is multiplied into the <code>diffuse</code> texture color
* Alpha is multiplied into the <code>diffuse</code> texture alpha

| bugs =
BUGS!

| textures =
diffuse,0,0,[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],[[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,Transparency;
test,1,2,,,,,;

| parameters =
diffuse,[[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;
PBRFactor
,[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor
,[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor
,[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor
,;

| gallery = File:ShadowGenerations Detail dpnn example.jpg{{!}}How <code>Detail_dpnn</code> is used for cliffs in Rail Canyon to blend in detail normals when the camera is closer to the surface

| technical = lorem ipsum.

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_deferred_rendering,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi
}}
== Other ==
Outside template
</noinclude>

Template:Shader Documentation

2025-08-25T12:11:02Z

Justin113D: Added bugs panels

<includeonly>{{DISPLAYTITLE:{{{game}}} Shaders - {{{shader name}}}}}
[[{{{game}}} Shaders|Return to shaders list]]
== Overview ==
{{#invoke:ShaderDoc|create_sbo|game={{{game}}}|parameters={{{sbo|}}}}}
{{{overview}}}
{{#if:{{{overview bugs|}}}|{{notice
|type=warn
|content={{{overview bugs}}}
It is adviced to not used this shader.}}}}
{{#if:{{{related shaders|}}}|
=== Related shaders ===
{{#invoke:ShaderDoc|shader_link_list
|game={{{game}}}
|shaders={{{related shaders}}}
}}|}}
== Behavior ==
{{{behavior|}}}
{{#if:{{{multi tangent|}}}|
=== Multi-tangent ===
{{{multi tangent}}}
|}}
=== Vertex Colors ===
{{{vertex colors|Shader does not use vertex colors}}}
{{#if:{{{bugs|}}}|
=== Bugs ===
{{notice
|type=warn
|content={{{bugs}}}}}}}
<div style="clear: both"/>

== Material Inputs ==

=== Textures ===
{{#if:{{{textures|}}}|
{{{!}} class="wikitable" width="100%"
{{!}}+
!width=1%{{!}}{{#tip-text: Name|Name of the material texture slot}}
!width=1%{{!}}{{#tip-text: Index|Index of the texture slot name, starting from 0; This is important when a shader has the same slot name multiple times, in which case their order determines how each slot is used}}
!width=1%{{!}}{{#tip-text: UV Index|Which UV map the slot uses, which is either an index from 0 to 3 or "any", in which case the UV map can be selected in the material.
If a model does not have a UV Map for the specified index, then the game will fall back to UV Index 0}}
!width=1%{{!}}{{#tip-text: Kind|General usage format of the texture slot. More precise documentation is found on the right}}
!width=24%{{!}} {{#tip-text: Red|How the red component of the texture gets used}}
!width=24%{{!}} {{#tip-text: Green|How the green component of the texture gets used}}
!width=24%{{!}} {{#tip-text: Blue|How the blue component of the texture gets used}}
!width=24%{{!}} {{#tip-text: Alpha|How the alpha component of the texture gets used}}
{{#invoke:ShaderDoc|shader_table|{{{textures}}}}}
{{!}}}|This shader does not use any textures.}}

=== Parameters ===
{{#if:{{{parameters|}}}|
{{{!}} class="wikitable" width="100%"
{{!}}+
!width=1%{{!}}{{#tip-text: Name|Name of the parameter}}
!width=25%{{!}}{{#tip-text: X|The first component of the parameter}}
!width=25%{{!}}{{#tip-text: Y|The second component of the parameter}}
!width=25%{{!}}{{#tip-text: Z|The third component of the parameter}}
!width=25%{{!}}{{#tip-text: W|The fourth component of the parameter}}
{{#invoke:ShaderDoc|shader_table|{{{parameters}}}}}
{{!}}}|This shader does not use any parameters.}}
{{#if:{{{gallery|}}}|
== Gallery ==
{{#tag:gallery|{{{gallery}}}|perrow=4|widths=400px|heights=300px|mode=nolines|}}|}}
== Technical ==
{{{technical|}}}
{{#if:{{{features|}}}|
{{{!}} class="mw-collapsible mw-collapsed wikitable" width="300px"
{{!}}-
!Shader Features
{{#invoke:ShaderDoc|technical_features|{{{features}}}}}
{{!}}}|}}<nowiki/></includeonly>
<noinclude>
<templatedata>
{
"params": {
"game": {
"label": "Game",
"description": "Which game this shader belongs to",
"type": "string",
"required": true
},
"shader name": {
"label": "Shader name",
"description": "The name of the shader",
"type": "string",
"required": true
},
"sbo": {
"label": "Shader behavior overview",
"description": "Parameters for the shader behavior overview",
"type": "string",
"required": false
},
"overview": {
"label": "Overview",
"description": "Overview content",
"type": "content",
"required": true
},
"overview bug": {
"label": "Overview bug",
"description": "Overview bug content",
"type": "content",
"required": false
},
"related shaders": {
"label": "Related shaders",
"description": "List of related shaders",
"type": "string",
"required": false
},
"behavior": {
"label": "Behavior",
"description": "Behavior content",
"type": "content",
"required": false
},
"multi tangent": {
"label": "Multi tangent",
"description": "Multi tangent behavior",
"type": "content",
"required": false
},
"vertex colors": {
"label": "Vertex color",
"description": "Vertex color behavior",
"type": "content",
"required": false
},
"bugs": {
"label": "Bugs",
"description": "Bugs in behavior",
"type": "content",
"required": false
},
"textures": {
"label": "Textures",
"description": "Texture table contents; Fields seperated by commas, column spans specified by underscores and rows seperated by semicolons",
"type": "content",
"required": false
},
"parameters": {
"label": "Parameters",
"description": "Parameter table contents; Fields seperated by commas, column spans specified by underscores and rows seperated by semicolons",
"type": "content",
"required": false
},
"gallery": {
"label": "Gallery contents",
"description": "Picture gallery contents",
"type": "string",
"required": false
},
"technical": {
"label": "Technical",
"description": "Technical information",
"type": "content",
"required": false
},
"features": {
"label": "Shader features (technical)",
"description": "List of technical features that the shader has been compiled with",
"type": "content",
"required": false
}
}
}
</templatedata>

== Example ==

{{Shader Documentation
| game = Shadow Generations

| shader name = Common_dpn

| sbo = model=2,
no_opaque_layer,
no_punch_through_layer,
noise_dithering

| overview = A standard PBR shader with no special behavior.

| overview bugs =

BUGS!

| related shaders =
Common_dn,
Common_dp,
Common_dpn,
Common_dpna,
Common_dither_dpn

| behavior = Lorem ipsum.

| multi tangent =
Lorem ipsum.

| vertex colors =
* Color is multiplied into the <code>diffuse</code> texture color
* Alpha is multiplied into the <code>diffuse</code> texture alpha

| bugs =
BUGS!

| textures =
diffuse,0,0,[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],[[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,Transparency;
test,1,2,,,,,;

| parameters =
diffuse,[[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;
PBRFactor
,[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor
,[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor
,[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor
,;

| gallery = File:ShadowGenerations Detail dpnn example.jpg{{!}}How <code>Detail_dpnn</code> is used for cliffs in Rail Canyon to blend in detail normals when the camera is closer to the surface

| technical = lorem ipsum.

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_deferred_rendering,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi
}}
== Other ==
Outside template
</noinclude>

Shadow Generations Shaders - DirectionBlend dpnndpn

2025-08-25T12:06:54Z

Justin113D:

{{Shader Documentation
| game = Shadow Generations
| shader name = DirectionBlend_dpnndpn
| sbo = model=2, no_noise, no_transparent_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses
* [[Texture Blending#Directional blending|directional blending]] to interpolate between two texture sets
* [[Texture Blending#Distance blending|distance blending]] to [[Texture Blending#Normal map blending|blend]] a detail [[Hedgehog Engine 2 - Textures#Normal map|normal map]] into the first normal texture

{{notice
|type=warn
|content=This shader has a bug where the second normal texture is not applied.
It is advised to not use this shader.
}}

| related shaders =
Blend_dpnbdpn,
Blend_dpndpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DistanceBlend_dpn

| behavior =

=== Distance blending ===
Uses [[Texture Blending#Distance blending|distance blending]] to interpolate
* from the <code>normal</code> texture
* to the <code>normal</code> and <code>normal[1]</code> textures [[Texture Blending#Normal map blending|blended]] together
for the normal map of the first set of textures.

 The shader uses <code>detailDistance</code> and <code>detailFadeRange</code> from the stage RFL to determine the detail range.

=== Directional blending ===

This shader has two sets of PBR textures:
* <code>diffuse</code>, <code>specular</code> and <code>normal</code>
* <code>diffuse[1]</code>, <code>specular[1]</code> and <code>normal[2]</code>

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor is calculated using [[Texture Blending#Directional blending|directional blending]].

This involves various inputs:

{{{!}} class="wikitable"
{{!}}+
! Input
! Description
{{!}}-
{{!}} Normal map
{{!}} The <code>normal</code> (after[[#Distance blending|distance blending]]) texture is applied to the normal direction before calculating the directional blend factor
{{!}}-
{{!}} Red vertex color channel
{{!}} The [[Texture Blending#Variables|directional blend bias]]
{{!}}-
{{!}} <code>DirectionParam</code> parameter
{{!}} The [[Texture Blending#Directional blending|directional blend direction]]
{{!}}-
{{!}} <code>NormalBlendParam</code> parameter
{{!}} The [[Texture Blending#Directional blending|Directional blend intensity and offset]]
{{!}}-
{{!}} <code>diffuse</code> and <code>diffuse[1]</code> (multiplied together)
{{!}} The [[Texture Blending#Directional blending|Directional blend limit]]
{{!}}}

=== Transparency ===

(For some reason) the directional blend factor is used for the transparency, and not any of the diffuse textures alpha channels, which makes for limited use cases.

| vertex colors =
* The colors...
** Red channel is used as the [[Texture Blending#Variables|directional blend bias]]
** Green and blue channels are unused
* Alpha is unused

| textures =
diffuse,0,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Texture Blending#Variables|directional blend limit]];

diffuse,1,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Texture Blending#Variables|directional blend limit]];

specular,0,Any,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,Any,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,Any,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|Normal map direction]]_,,;

normal,1,Any,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

normal,2,Any,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Second [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the <code>normal[1]</code> texture,,,;

DirectionParam, [[Texture Blending#Directional blending|Directional blend direction]]__,;

NormalBlendParam,
[[Texture Blending#Directional blending|Directional blend intensity]],
[[Texture Blending#Directional blending|Directional blend offset]],
,;

| technical =
For some reason using the <code>IBL_CAPTURE</code> debug view the directional blend factor is set to 0.
Why this was done is unknown, and makes no sense.

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi

}}

Shadow Generations Shaders - DirectionBlend dpnndpn

2025-08-25T12:02:13Z

Justin113D: Created page with "{{Shader Documentation | game = Shadow Generations | shader name = DirectionBlend_dpnndpn | sbo = model=2, no_noise, no_transparent_layer | overview = An advanced PBR shader that uses directional blending to interpolate between two texture sets. | related shaders = Blend_dpnbdpn, Blend_dpndpn, BlendDetail_dndnd, BlendDetail_dpndpnn, Detail_dpndpn, Detail_dpnn, DirectionB..."

{{Shader Documentation
| game = Shadow Generations
| shader name = DirectionBlend_dpnndpn
| sbo = model=2, no_noise, no_transparent_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses [[Texture Blending#Directional blending|directional blending]] to interpolate between two texture sets.

| related shaders =
Blend_dpnbdpn,
Blend_dpndpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DistanceBlend_dpn

| behavior =

=== Distance blending ===
Uses [[Texture Blending#Distance blending|distance blending]] to interpolate
* from the <code>normal</code> texture
* to the <code>normal</code> and <code>normal[1]</code> textures [[Texture Blending#Normal map blending|blended]] together
for the normal map of the first set of textures.

 The shader uses <code>detailDistance</code> and <code>detailFadeRange</code> from the stage RFL to determine the detail range.

=== Directional blending ===

This shader has two sets of PBR textures:
* <code>diffuse</code>, <code>specular</code> and <code>normal</code>
* <code>diffuse[1]</code>, <code>specular[1]</code> and <code>normal[2]</code>

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor is calculated using [[Texture Blending#Directional blending|directional blending]].

This involves various inputs:

{{{!}} class="wikitable"
{{!}}+
! Input
! Description
{{!}}-
{{!}} Normal map
{{!}} The <code>normal</code> (after[[#Distance blending|distance blending]]) texture is applied to the normal direction before calculating the directional blend factor
{{!}}-
{{!}} Red vertex color channel
{{!}} The [[Texture Blending#Variables|directional blend bias]]
{{!}}-
{{!}} <code>DirectionParam</code> parameter
{{!}} The [[Texture Blending#Directional blending|directional blend direction]]
{{!}}-
{{!}} <code>NormalBlendParam</code> parameter
{{!}} The [[Texture Blending#Directional blending|Directional blend intensity and offset]]
{{!}}-
{{!}} <code>diffuse</code> and <code>diffuse[1]</code> (multiplied together)
{{!}} The [[Texture Blending#Directional blending|Directional blend limit]]
{{!}}}

=== Transparency ===

(For some reason) the directional blend factor is used for the transparency, and not any of the diffuse textures alpha channels, which makes for limited use cases.

| vertex colors =
* The colors...
** Red channel is used as the [[Texture Blending#Variables|directional blend bias]]
** Green and blue channels are unused
* Alpha is unused

| textures =
diffuse,0,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Texture Blending#Variables|directional blend limit]];

diffuse,1,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Texture Blending#Variables|directional blend limit]];

specular,0,Any,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,Any,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,Any,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|Normal map direction]]_,,;

normal,1,Any,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

normal,2,Any,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Second [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the <code>normal[1]</code> texture,,,;

DirectionParam, [[Texture Blending#Directional blending|Directional blend direction]]__,;

NormalBlendParam,
[[Texture Blending#Directional blending|Directional blend intensity]],
[[Texture Blending#Directional blending|Directional blend offset]],
,;

| technical =
For some reason using the <code>IBL_CAPTURE</code> debug view the directional blend factor is set to 0.
Why this was done is unknown, and makes no sense.

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi

}}

Shadow Generations Shaders - Blend dpnbdpn

2025-08-25T11:40:18Z

Justin113D: Added PBR link

{{Shader Documentation
| game = Shadow Generations
| shader name = Blend_dpnbdpn
| sbo = model=2, no_transparent_layer, no_punch_through_layer, no_noise, no_compute_instancing, multi_tangent

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that lets you blend between two sets of textures using vertex alpha and a mask texture.

| related shaders =
Blend_dpndpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =
This shader has two sets of PBR textures:
* <code>diffuse</code>, <code>specular</code> and <code>normal</code>
* <code>diffuse[1]</code>, <code>specular[1]</code> and <code>normal[1]</code>

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor consists of the vertex alpha multiplied by the <code>transparency</code> textures red channel.

* For the <code>specular</code> and <code>normal</code> textures, the blend factor is used as is.
* For the <code>diffuse</code> textures, the blend factor is multiplied by the <code>diffuse[1]</code> texture alpha.

| multi tangent =
When enabled, the second set of tangents will be used to [[Normal_mapping#Tangent_Space|unpack]] the <code>normal[1]</code> texture.

| vertex colors =
* Color is multiplied into the blended together diffuse texture color
* Alpha is used as the basis for the blend factor

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;

diffuse,1,2,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
Multiplied into the vertex alpha (blend factor)\, but only for when blending the two diffuse textures!;

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,2,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Second [[Normal_mapping|Normal map direction]]_,,;

transparency,0,3,
Mask,
Multiplied into the vertex alpha (blend factor),,,;

| gallery =
File:ShadowGenerations Blend dpnbdpn example.jpg{{!}}How <code>Blend_dpnbdpn</code> is used for the Ship in the metal overlord boss fight to make use of already existing textures

| features =
is_use_tex_srt_anim,
enable_multi_tangent_space,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi

}}

Shadow Generations Shaders - DirectionBlend dpndpn

2025-08-25T11:29:28Z

Justin113D:

{{Shader Documentation
| game = Shadow Generations
| shader name = DirectionBlend_dpndpn
| sbo = model=2, no_noise, no_transparent_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses [[Texture Blending#Directional blending|directional blending]] to interpolate between two texture sets.

| related shaders =
Blend_dpnbdpn,
Blend_dpndpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =

=== Directional blending ===

This shader has two sets of PBR textures:
* <code>diffuse</code>, <code>specular</code> and <code>normal</code>
* <code>diffuse[1]</code>, <code>specular[1]</code> and <code>normal[1]</code>

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor is calculated using [[Texture Blending#Directional blending|directional blending]].

This involves various inputs:

{{{!}} class="wikitable"
{{!}}+
! Input
! Description
{{!}}-
{{!}} Normal map
{{!}} The <code>normal</code> texture is applied to the normal direction before calculating the directional blend factor
{{!}}-
{{!}} Red vertex color channel
{{!}} The [[Texture Blending#Variables|directional blend bias]]
{{!}}-
{{!}} <code>DirectionParam</code> parameter
{{!}} The [[Texture Blending#Directional blending|directional blend direction]]
{{!}}-
{{!}} <code>NormalBlendParam</code> parameter
{{!}} The [[Texture Blending#Directional blending|Directional blend intensity and offset]]
{{!}}-
{{!}} <code>diffuse</code> and <code>diffuse[1]</code> (multiplied together)
{{!}} The [[Texture Blending#Directional blending|Directional blend limit]]
{{!}}}

=== Transparency ===

(For some reason) the directional blend factor is used for the transparency, and not any of the diffuse textures alpha channels, which makes for limited use cases.

| vertex colors =
* The colors...
** Red channel is used as the [[Texture Blending#Variables|directional blend bias]]
** Green and blue channels are unused
* Alpha is unused

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Texture Blending#Variables|directional blend limit]];

diffuse,1,2,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Texture Blending#Variables|directional blend limit]];

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,2,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Second [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DirectionParam, [[Texture Blending#Directional blending|Directional blend direction]]__,;

NormalBlendParam,
[[Texture Blending#Directional blending|Directional blend intensity]],
[[Texture Blending#Directional blending|Directional blend offset]],
,;

| gallery =
File:ShadowGenerations DirectionBlend dpndpn example.jpg{{!}}How <code>DirectionBlend_dpndpn</code> is used in Shadow Generations to create a "gravel" layer on top of rocky surfaces on Chaos Island

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi

}}

Shadow Generations Shaders - DirectionBlend dpndpn

2025-08-25T11:12:13Z

Justin113D: Added gallery

{{Shader Documentation
| game = Shadow Generations
| shader name = DirectionBlend_dpndpn
| sbo = model=2, no_noise, no_transparent_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses [[Texture Blending#Directional blending|directional blending]] to interpolate between two texture sets.

| related shaders =
Blend_dpnbdpn,
Blend_dpndpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =

=== Directional blending ===

This shader has two sets of PBR textures:
* <code>diffuse</code>, <code>specular</code> and <code>normal</code>
* <code>diffuse[1]</code>, <code>specular[1]</code> and <code>normal[1]</code>

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor is calculated using [[Texture Blending#Directional blending|directional blending]].

This involves various inputs:

{{{!}} class="wikitable"
{{!}}+
! Input
! Description
{{!}}-
{{!}} Normal map
{{!}} The <code>normal</code> texture is applied to the normal direction before calculating the directional blend factor
{{!}}-
{{!}} Red vertex color channel
{{!}} The [[Texture Blending#Variables|directional blend bias]]
{{!}}-
{{!}} <code>DirectionParam</code> parameter
{{!}} The [[Texture Blending#Directional blending|directional blend direction]]
{{!}}-
{{!}} <code>NormalBlendParam</code> parameter
{{!}} The [[Texture Blending#Directional blending|Directional blend intensity and offset]]
{{!}}-
{{!}} <code>diffuse</code> and <code>diffuse[1]</code> (multiplied together)
{{!}} The [[Texture Blending#Directional blending|Directional blend limit]]
{{!}}}

=== Transparency ===

(For some reason) the blend factor is used for the transparency, and not any of the diffuse textures alpha channels.

| vertex colors =
* The colors...
** Red channel is used as the [[Texture Blending#Variables|directional blend bias]]
** Green and blue channels are unused
* Alpha is unused

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Texture Blending#Variables|directional blend limit]];

diffuse,1,2,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Texture Blending#Variables|directional blend limit]];

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,2,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Second [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DirectionParam, [[Texture Blending#Directional blending|Directional blend direction]]__,;

NormalBlendParam,
[[Texture Blending#Directional blending|Directional blend intensity]],
[[Texture Blending#Directional blending|Directional blend offset]],
,;

| gallery =
File:ShadowGenerations DirectionBlend dpndpn example.jpg{{!}}How <code>DirectionBlend_dpndpn</code> is used in Shadow Generations to create a "gravel" layer on top of rocky surfaces on Chaos Island

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi

}}

File:ShadowGenerations DirectionBlend dpndpn example.jpg

2025-08-25T11:10:25Z

Justin113D:

An example for how the DirectionBlend_dpndpn shader is used in Shadow Generations

Shadow Generations Shaders - DirectionBlend dpndpn

2025-08-25T10:58:47Z

Justin113D: Created page with "{{Shader Documentation | game = Shadow Generations | shader name = DirectionBlend_dpndpn | sbo = model=2, no_noise, no_transparent_layer | overview = An advanced PBR shader that uses directional blending to interpolate between two texture sets. | related shaders = Blend_dpnbdpn, Blend_dpndpn, BlendDetail_dndnd, BlendDetail_dpndpnn, Detail_dpndpn, Detail_dpnn, DirectionBl..."

{{Shader Documentation
| game = Shadow Generations
| shader name = DirectionBlend_dpndpn
| sbo = model=2, no_noise, no_transparent_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses [[Texture Blending#Directional blending|directional blending]] to interpolate between two texture sets.

| related shaders =
Blend_dpnbdpn,
Blend_dpndpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =

=== Directional blending ===

This shader has two sets of PBR textures:
* <code>diffuse</code>, <code>specular</code> and <code>normal</code>
* <code>diffuse[1]</code>, <code>specular[1]</code> and <code>normal[1]</code>

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor is calculated using [[Texture Blending#Directional blending|directional blending]].

This involves various inputs:

{{{!}} class="wikitable"
{{!}}+
! Input
! Description
{{!}}-
{{!}} Normal map
{{!}} The <code>normal</code> texture is applied to the normal direction before calculating the directional blend factor
{{!}}-
{{!}} Red vertex color channel
{{!}} The [[Texture Blending#Variables|directional blend bias]]
{{!}}-
{{!}} <code>DirectionParam</code> parameter
{{!}} The [[Texture Blending#Directional blending|directional blend direction]]
{{!}}-
{{!}} <code>NormalBlendParam</code> parameter
{{!}} The [[Texture Blending#Directional blending|Directional blend intensity and offset]]
{{!}}-
{{!}} <code>diffuse</code> and <code>diffuse[1]</code> (multiplied together)
{{!}} The [[Texture Blending#Directional blending|Directional blend limit]]
{{!}}}

=== Transparency ===

(For some reason) the blend factor is used for the transparency, and not any of the diffuse textures alpha channels.

| vertex colors =
* The colors...
** Red channel is used as the [[Texture Blending#Variables|directional blend bias]]
** Green and blue channels are unused
* Alpha is unused

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Texture Blending#Variables|directional blend limit]];

diffuse,1,2,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Texture Blending#Variables|directional blend limit]];

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,2,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Second [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DirectionParam, [[Texture Blending#Directional blending|Directional blend direction]]__,;

NormalBlendParam,
[[Texture Blending#Directional blending|Directional blend intensity]],
[[Texture Blending#Directional blending|Directional blend offset]],
,;

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi

}}

Shadow Generations Shaders - Blend dpndpn

2025-08-25T10:38:24Z

Justin113D: Added PBR link

{{Shader Documentation
| game = Shadow Generations
| shader name = Blend_dpndpn
| sbo = model=2, no_transparent_layer, no_punch_through_layer, no_noise, no_compute_instancing, multi_tangent

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that lets you blend between two sets of textures using vertex alpha.

| related shaders =
Blend_dpnbdpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =
This shader has two sets of PBR textures:
* <code>diffuse</code>, <code>specular</code> and <code>normal</code>
* <code>diffuse[1]</code>, <code>specular[1]</code> and <code>normal[1]</code>

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor consists of just the vertex alpha.

* For the <code>specular</code> and <code>normal</code> textures, the blend factor is used as is.
* For the <code>diffuse</code> textures, the blend factor is multiplied by the <code>diffuse[1]</code> texture alpha.

| multi tangent =
When enabled, the second set of tangents will be used to [[Normal_mapping#Tangent_Space|unpack]] the <code>normal[1]</code> texture.

| vertex colors =
* Color is multiplied into the blended together diffuse texture color
* Alpha is used as the basis for the blend factor

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;

diffuse,1,2,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
Multiplied into the vertex alpha (blend factor)\, but only for when blending the two diffuse textures!;

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,2,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Second [[Normal_mapping|Normal map direction]]_,,;

| gallery =

File:ShadowGenerations Blend dpndpn example.jpg{{!}}How <code>Blend_dpndpn</code> is used to transition from the bridge to the grass

| features =
is_use_tex_srt_anim,
enable_multi_tangent_space,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi

}}

Shadow Generations Shaders - BlendDetail dndnd

2025-08-23T23:02:37Z

Justin113D: Added behavior

{{Shader Documentation
| game = Shadow Generations
| shader name = BlendDetail_dndnd
| sbo = model=2, no_noise, no_compute_instancing, no_transparent_layer, no_punch_through_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses
* vertex alpha to blend between two [[Hedgehog Engine 2 - Textures#Albedo|albedo]] textures
* [[Texture Blending#Distance blending|distance blending]] to apply detail [[Hedgehog Engine 2 - Textures#Albedo|albedo]] and [[Hedgehog Engine 2 - Textures#Normal map|normal map]] textures

{{notice
|type=warn
|content=This shader has a severe bug where normals break outside the detail range!
It is advised to not use this shader.
}}

| related shaders =
Blend_dpndpn,
Blend_dpnbdpn,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =

=== Vertex alpha blending ===

The shader has two sets of <code>diffuse</code> textures and two sets of <code>PBRFactor</code> parameters.

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor consists of just the vertex alpha.

=== Distance blending ===

Uses [[Texture Blending#Distance blending|distance blending]] to interpolate

{{{!}} class="wikitable
{{!}}+
! From...
!... to
{{!}}-
{{!}} the <code>normal</code> texture
{{!}} the <code>normal</code> and <code>normal[1]</code> textures [[Texture Blending#Normal map blending|blended]] together
{{!}}-
{{!}} the combined <code>diffuse</code> textures
{{!}} the combined <code>diffuse</code> textures overlaid with the <code>diffuse[1]</code> texture using [[Texture Blending#Detail blending|detail blending]]
{{!}}}

=== Bugs ===
{{notice
|type=warn
|content=The shader checks if the surface is within the detail range, and only then applies the detail diffuse and the detail normal textures.
Unfortunately, the surface' normal direction never gets set outside this <code>if</code>-block, which means normals are completely broken outside the detail range.
}}

| vertex colors =
* Color is not used
* Alpha is used as the basis for the blend factor

| textures =

diffuse,0,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;

diffuse,1,2,
Detail albedo,
[[Texture Blending#Detail blending|Detail color]]__,;

diffuse,2,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
[[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the <code>diffuse[1]</code> and <code>normal[1]</code> textures,,,;

PBRFactor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
;

PBRFactor2,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
;

| features =
enable_multi_tangent_space,
is_use_tex_srt_anim,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi,

}}

Shadow Generations Shaders - BlendDetail dndnd

2025-08-23T22:53:40Z

Justin113D: Spelling

{{Shader Documentation
| game = Shadow Generations
| shader name = BlendDetail_dndnd
| sbo = model=2, no_noise, no_compute_instancing, no_transparent_layer, no_punch_through_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses
* vertex alpha to blend between two [[Hedgehog Engine 2 - Textures#Albedo|albedo]] textures
* [[Texture Blending#Distance blending|distance blending]] to apply detail [[Hedgehog Engine 2 - Textures#Albedo|albedo]] and [[Hedgehog Engine 2 - Textures#Normal map|normal map]] textures

{{notice
|type=warn
|content=This shader has a severe bug where normals break outside the detail range!
It is advised to not use this shader.
}}

| related shaders =
Blend_dpndpn,
Blend_dpnbdpn,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =

Todo

=== Bugs ===
{{notice
|type=warn
|content=The shader checks if the surface is within the detail range, and only then applies the detail diffuse and the detail normal textures.
Unfortunately, the surface' normal direction never gets set outside this <code>if</code>-block, which means normals are completely broken outside the detail range.
}}

| vertex colors =
* Color is not used
* Alpha is used as the basis for the blend factor

| textures =

diffuse,0,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;

diffuse,1,2,
Detail albedo,
[[Texture Blending#Detail blending|Detail color]]__,;

diffuse,2,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
[[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the <code>diffuse[1]</code> and <code>normal[1]</code> textures,,,;

PBRFactor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
;

PBRFactor2,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
;

| features =
enable_multi_tangent_space,
is_use_tex_srt_anim,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi,

}}

Shadow Generations Shaders - BlendDetail dndnd

2025-08-23T22:52:36Z

Justin113D: Created page with "{{Shader Documentation | game = Shadow Generations | shader name = BlendDetail_dndnd | sbo = model=2, no_noise, no_compute_instancing, no_transparent_layer, no_punch_through_layer | overview = An advanced PBR shader that uses * vertex alpha to blend between two albedo textures * distance blending to apply detail Hedgehog Engine 2 - T..."

{{Shader Documentation
| game = Shadow Generations
| shader name = BlendDetail_dndnd
| sbo = model=2, no_noise, no_compute_instancing, no_transparent_layer, no_punch_through_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses
* vertex alpha to blend between two [[Hedgehog Engine 2 - Textures#Albedo|albedo]] textures
* [[Texture Blending#Distance blending|distance blending]] to apply detail [[Hedgehog Engine 2 - Textures#Albedo|albedo]] and [[Hedgehog Engine 2 - Textures#Normal map|normal map]] textures

{{notice
|type=warn
|content=This shader has a severe bug where normals break outside the detail range!
It is advised to not use this shader.
}}

| related shaders =
Blend_dpndpn,
Blend_dpnbdpn,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =

Todo

=== Bugs ===
{{notice
|type=warn
|content=The shader checks if the surface is within the detail range, and only then applies the detail diffuse and the detail normal textures.
Unfortunately, the surface' normal direction never gets set outside this <code>if</code>-blocks, which means normals are completely broken outside the detail range.
}}

| vertex colors =
* Color is not used
* Alpha is used as the basis for the blend factor

| textures =

diffuse,0,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;

diffuse,1,2,
Detail albedo,
[[Texture Blending#Detail blending|Detail color]]__,;

diffuse,2,Any,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
[[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the <code>diffuse[1]</code> and <code>normal[1]</code> textures,,,;

PBRFactor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
;

PBRFactor2,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
;

| features =
enable_multi_tangent_space,
is_use_tex_srt_anim,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi,

}}

Shadow Generations Shaders - Detail dpndpn

2025-08-23T22:49:00Z

Justin113D: Added detail color link

{{Shader Documentation
| game = Shadow Generations
| shader name = Detail_dpndpn
| sbo = model=2, no_noise, no_transparent_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses [[Texture Blending#Distance blending|distance blending]] to blend in a set of detail textures.

| related shaders =
Blend_dpndpn,
Blend_dpnbdpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =
Uses [[Texture Blending#Distance blending|distance blending]] to interpolate
* from the first set of textures
* to the first set of texture with the second set of texture blended into them.

Each of the second textures is blended into the first differently:

{{{!}} Class="wikitable"
{{!}}+
! Texture property
! blend method
{{!}}-
{{!}} Albedo
{{!}} Uses [[Texture Blending#Detail blending|detail blending]]
{{!}}-
{{!}} Transparency
{{!}} Not blended
{{!}}-
{{!}} Specular
{{!}} Not blended
{{!}}-
{{!}} Roughness
{{!}} Uses [[Texture Blending#Detail blending|detail blending]]
{{!}}-
{{!}} Metallic
{{!}} Addition; Remaps the detail metallic to a range of <code>-1</code> to <code>1</code> beforehand
{{!}}-
{{!}} Ambient Occlusion
{{!}} Multiplication
{{!}}-
{{!}} Normal
{{!}} Uses [[Texture Blending#Normal blending|normal blending]]
{{!}}}

 The shader uses <code>detailDistance</code> and <code>detailFadeRange</code> from the stage RFL to determine the detail range.

| vertex colors =
* Color is multiplied into the <code>diffuse</code> texture color
* Alpha is multiplied into the <code>diffuse</code> texture alpha

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
[[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Opacity|Opacity]];

diffuse,1,2,
Detail albedo,
[[Texture Blending#Detail blending|Detail color]]__,;

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,2,
Detail PRM,,
Detail Smoothness,
Detail Metallic,
Detail Ambient Occlusion;

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
[[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the second set of textures,,,;

| gallery =

File:ShadowGenerations Detail dpndpn example.jpg{{!}}How <code>Detail_dpndpn</code> is used in the Mephiles boss arena to add details when the camera is close to the floor

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi,

}}

Shadow Generations Shaders - Detail dpndpn

2025-08-23T22:47:02Z

Justin113D: Corrected detail texture index and uv index

{{Shader Documentation
| game = Shadow Generations
| shader name = Detail_dpndpn
| sbo = model=2, no_noise, no_transparent_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses [[Texture Blending#Distance blending|distance blending]] to blend in a set of detail textures.

| related shaders =
Blend_dpndpn,
Blend_dpnbdpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =
Uses [[Texture Blending#Distance blending|distance blending]] to interpolate
* from the first set of textures
* to the first set of texture with the second set of texture blended into them.

Each of the second textures is blended into the first differently:

{{{!}} Class="wikitable"
{{!}}+
! Texture property
! blend method
{{!}}-
{{!}} Albedo
{{!}} Uses [[Texture Blending#Detail blending|detail blending]]
{{!}}-
{{!}} Transparency
{{!}} Not blended
{{!}}-
{{!}} Specular
{{!}} Not blended
{{!}}-
{{!}} Roughness
{{!}} Uses [[Texture Blending#Detail blending|detail blending]]
{{!}}-
{{!}} Metallic
{{!}} Addition; Remaps the detail metallic to a range of <code>-1</code> to <code>1</code> beforehand
{{!}}-
{{!}} Ambient Occlusion
{{!}} Multiplication
{{!}}-
{{!}} Normal
{{!}} Uses [[Texture Blending#Normal blending|normal blending]]
{{!}}}

 The shader uses <code>detailDistance</code> and <code>detailFadeRange</code> from the stage RFL to determine the detail range.

| vertex colors =
* Color is multiplied into the <code>diffuse</code> texture color
* Alpha is multiplied into the <code>diffuse</code> texture alpha

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
[[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Opacity|Opacity]];

diffuse,1,2,
Detail albedo,
Detail color__,;

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,2,
Detail PRM,,
Detail Smoothness,
Detail Metallic,
Detail Ambient Occlusion;

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
[[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the second set of textures,,,;

| gallery =

File:ShadowGenerations Detail dpndpn example.jpg{{!}}How <code>Detail_dpndpn</code> is used in the Mephiles boss arena to add details when the camera is close to the floor

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi,

}}

Shadow Generations Shaders - BlendDetail dpndpnn

2025-08-23T22:34:45Z

Justin113D: Added missing feature

{{Shader Documentation
| game = Shadow Generations
| shader name = BlendDetail_dpndpnn
| sbo = model=2, no_noise, no_compute_instancing, no_transparent_layer, no_punch_through_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses
* [[Texture Blending#Distance blending|distance blending]] to [[Texture Blending#Normal map blending|blend]] in a detail [[Hedgehog Engine 2 - Textures#Normal map|normal map]]
* Vertex alpha to blend between two sets of [[Hedgehog Engine 2 - Textures#Albedo|albedo]] and [[Hedgehog Engine 2 - Textures#PRM|PRM]] textures

It is essentially a combination of the {{ShaderLink|Shadow Generations|Blend_dpndpn}} and {{ShaderLink|Shadow Generations|Detail_dpnn}} shaders.

| related shaders =
Blend_dpndpn,
Blend_dpnbdpn,
BlendDetail_dndnd,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =
=== Distance blending ===
Uses [[Texture Blending#Distance blending|distance blending]] to interpolate
* from the <code>normal</code> texture
* to the <code>normal</code> and <code>normal[2]</code> textures [[Texture Blending#Normal map blending|blended]] together.

 The shader uses <code>detailDistance</code> and <code>detailFadeRange</code> from the stage RFL to determine the detail range.

=== Vertex alpha blending ===

This shader has two sets of PBR textures:
* <code>diffuse</code> and <code>specular</code>
* <code>diffuse[1]</code> and <code>specular[1]</code>

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor consists of just the vertex alpha.

* For the <code>specular</code> textures, the blend factor is used as is.
* For the <code>diffuse</code> textures, the blend factor is multiplied by the <code>diffuse[1]</code> texture alpha.

=== Bugs ===

{{notice
|type=warn
|content=The shader has 3 <code>normal</code> texture slots: Only <code>normal</code> and <code>normal[2]</code> are used, with <code>normal[1]</code> left unused.
Yet, to be able to specify a texture for the <code>normal[2]</code> slot, a material must have 3 texture slots, even if the slot for <code>normal[1]</code> is empty.
 In a similar vein, the shader has the <code>enable_multi_tangent_space</code> feature, but never makes use of it.

 Speculation:
What likely happened here is that the developers used the code from {{ShaderLink|Shadow Generations|Blend_dpndpn}} as a base and then added in the detail normal map logic from {{ShaderLink|Shadow Generations|Detail_dpnn}} but accidentally pasted it over the previous normal map code, leaving just the detail normal map code behind.
}}

| vertex colors =
* Color is multiplied into the <code>diffuse</code> texture color
* Alpha is used as the basis for the blend factor

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;

diffuse,1,2,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
Multiplied into the vertex alpha (blend factor)\, but only for when blending the two diffuse textures!;

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,2,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|Normal map direction]]_,,;

normal,1,N/A,,Unused___;

normal,2,3,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the <code>normal[2]</code> texture,,,;

| features =
enable_multi_tangent_space,
is_use_tex_srt_anim,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi,

}}

Shadow Generations Shaders - Common dpnm

2025-08-22T20:45:28Z

Justin113D: Used new gallery parameter

{{Shader Documentation
| game = Shadow Generations
| shader name = Common_dpnm
| sbo = model=2, no_noise

| overview =
A standard [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader with an additional mask texture to apply a color decal.

| related shaders =
Common_dpn

| behavior =
The <code>diffuse [1]</code> texture is a mask that controls the visibility of the <code>diffuse</code> parameter color, which gets multiplied with the <code>diffuse</code> texture color.
 This is useful if you want to animate specific regions of a material with a single color.

| vertex colors =
* Color is multiplied into the <code>diffuse</code> texture color
* Alpha is multiplied into the <code>diffuse</code> texture alpha

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
[[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Opacity|Opacity]];

diffuse,1,0,
Mask,
Controls the visibility of the <code>diffuse</code> parameter color,,,;

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
[[Normal_mapping|Normal map direction]]_,,;

| parameters =
diffuse, (RGB) Color multiplied with the sampled diffuse texture color based on <code>diffuse [1]</code>__,;

| gallery =

File:SXSG Common dpnm example.jpg{{!}}Using <code>Common_dpnm</code> to overlay a red color over a ground texture using the HedgeDocs logo

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_deferred_rendering,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi

}}

Shadow Generations Shaders - Detail dpndpn

2025-08-22T20:44:46Z

Justin113D: Used new gallery parameter

{{Shader Documentation
| game = Shadow Generations
| shader name = Detail_dpndpn
| sbo = model=2, no_noise, no_transparent_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses [[Texture Blending#Distance blending|distance blending]] to blend in a set of detail textures.

| related shaders =
Blend_dpndpn,
Blend_dpnbdpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =
Uses [[Texture Blending#Distance blending|distance blending]] to interpolate
* from the first set of textures
* to the first set of texture with the second set of texture blended into them.

Each of the second textures is blended into the first differently:

{{{!}} Class="wikitable"
{{!}}+
! Texture property
! blend method
{{!}}-
{{!}} Albedo
{{!}} Uses [[Texture Blending#Detail blending|detail blending]]
{{!}}-
{{!}} Transparency
{{!}} Not blended
{{!}}-
{{!}} Specular
{{!}} Not blended
{{!}}-
{{!}} Roughness
{{!}} Uses [[Texture Blending#Detail blending|detail blending]]
{{!}}-
{{!}} Metallic
{{!}} Addition; Remaps the detail metallic to a range of <code>-1</code> to <code>1</code> beforehand
{{!}}-
{{!}} Ambient Occlusion
{{!}} Multiplication
{{!}}-
{{!}} Normal
{{!}} Uses [[Texture Blending#Normal blending|normal blending]]
{{!}}}

 The shader uses <code>detailDistance</code> and <code>detailFadeRange</code> from the stage RFL to determine the detail range.

| vertex colors =
* Color is multiplied into the <code>diffuse</code> texture color
* Alpha is multiplied into the <code>diffuse</code> texture alpha

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
[[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Opacity|Opacity]];

diffuse,0,0,
Detail albedo,
Detail color__,;

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,2,
Detail PRM,,
Detail Smoothness,
Detail Metallic,
Detail Ambient Occlusion;

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
[[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the second set of textures,,,;

| gallery =

File:ShadowGenerations Detail dpndpn example.jpg{{!}}How <code>Detail_dpndpn</code> is used in the Mephiles boss arena to add details when the camera is close to the floor

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi,

}}

Shadow Generations Shaders - Blend dpnbdpn

2025-08-22T20:44:06Z

Justin113D: Used new gallery parameter

{{Shader Documentation
| game = Shadow Generations
| shader name = Blend_dpnbdpn
| sbo = model=2, no_transparent_layer, no_punch_through_layer, no_noise, no_compute_instancing, multi_tangent

| overview =
An advanced PBR shader that lets you blend between two sets of textures using vertex alpha and a mask texture.

| related shaders =
Blend_dpndpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =
This shader has two sets of PBR textures:
* <code>diffuse</code>, <code>specular</code> and <code>normal</code>
* <code>diffuse[1]</code>, <code>specular[1]</code> and <code>normal[1]</code>

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor consists of the vertex alpha multiplied by the <code>transparency</code> textures red channel.

* For the <code>specular</code> and <code>normal</code> textures, the blend factor is used as is.
* For the <code>diffuse</code> textures, the blend factor is multiplied by the <code>diffuse[1]</code> texture alpha.

| multi tangent =
When enabled, the second set of tangents will be used to [[Normal_mapping#Tangent_Space|unpack]] the <code>normal[1]</code> texture.

| vertex colors =
* Color is multiplied into the blended together diffuse texture color
* Alpha is used as the basis for the blend factor

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;

diffuse,1,2,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
Multiplied into the vertex alpha (blend factor)\, but only for when blending the two diffuse textures!;

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,2,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Second [[Normal_mapping|Normal map direction]]_,,;

transparency,0,3,
Mask,
Multiplied into the vertex alpha (blend factor),,,;

| gallery =
File:ShadowGenerations Blend dpnbdpn example.jpg{{!}}How <code>Blend_dpnbdpn</code> is used for the Ship in the metal overlord boss fight to make use of already existing textures

| features =
is_use_tex_srt_anim,
enable_multi_tangent_space,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi

}}

Shadow Generations Shaders - Blend dpndpn

2025-08-22T20:43:40Z

Justin113D: Used new gallery parameter

{{Shader Documentation
| game = Shadow Generations
| shader name = Blend_dpndpn
| sbo = model=2, no_transparent_layer, no_punch_through_layer, no_noise, no_compute_instancing, multi_tangent

| overview =
An advanced PBR shader that lets you blend between two sets of textures using vertex alpha.

| related shaders =
Blend_dpnbdpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =
This shader has two sets of PBR textures:
* <code>diffuse</code>, <code>specular</code> and <code>normal</code>
* <code>diffuse[1]</code>, <code>specular[1]</code> and <code>normal[1]</code>

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor consists of just the vertex alpha.

* For the <code>specular</code> and <code>normal</code> textures, the blend factor is used as is.
* For the <code>diffuse</code> textures, the blend factor is multiplied by the <code>diffuse[1]</code> texture alpha.

| multi tangent =
When enabled, the second set of tangents will be used to [[Normal_mapping#Tangent_Space|unpack]] the <code>normal[1]</code> texture.

| vertex colors =
* Color is multiplied into the blended together diffuse texture color
* Alpha is used as the basis for the blend factor

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;

diffuse,1,2,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
Multiplied into the vertex alpha (blend factor)\, but only for when blending the two diffuse textures!;

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,2,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Second [[Normal_mapping|Normal map direction]]_,,;

| gallery =

File:ShadowGenerations Blend dpndpn example.jpg{{!}}How <code>Blend_dpndpn</code> is used to transition from the bridge to the grass

| features =
is_use_tex_srt_anim,
enable_multi_tangent_space,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi

}}

Shadow Generations Shaders - Detail dpnn

2025-08-22T20:42:48Z

Justin113D: Used new gallery parameter

{{Shader Documentation
| game = Shadow Generations
| shader name = Detail_dpnn
| sbo = model=2, no_noise, no_transparent_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses [[Texture Blending#Distance blending|distance blending]] to [[Texture Blending#Normal map blending|blend]] in a detail [[Hedgehog Engine 2 - Textures#Normal map|normal map]].

| related shaders =
Blend_dpndpn,
Blend_dpnbdpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =
Uses [[Texture Blending#Distance blending|distance blending]] to interpolate
* from the <code>normal</code> texture
* to the <code>normal</code> and <code>normal[1]</code> textures [[Texture Blending#Normal map blending|blended]] together.

The shader uses <code>detailDistance</code> and <code>detailFadeRange</code> from the stage RFL to determine the detail range.

| vertex colors =
* Color is multiplied into the <code>diffuse</code> texture color
* Alpha is multiplied into the <code>diffuse</code> texture alpha

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
[[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Opacity|Opacity]];

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
[[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the <code>normal[1]</code> texture,,,;

| gallery =

File:ShadowGenerations Detail dpnn example.jpg{{!}}How <code>Detail_dpnn</code> is used for cliffs in Rail Canyon to blend in detail normals when the camera is closer to the surface

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi,

}}

Template:Shader Documentation

2025-08-22T20:42:12Z

Justin113D: Added gallery

<includeonly>{{DISPLAYTITLE:{{{game}}} Shaders - {{{shader name}}}}}
[[{{{game}}} Shaders|Return to shaders list]]
== Overview ==
{{#invoke:ShaderDoc|create_sbo|game={{{game}}}|parameters={{{sbo|}}}}}
{{{overview}}}
{{#if:{{{related shaders|}}}|
=== Related shaders ===
{{#invoke:ShaderDoc|shader_link_list
|game={{{game}}}
|shaders={{{related shaders}}}
}}|}}
== Behavior ==
{{{behavior|}}}
{{#if:{{{multi tangent|}}}|
=== Multi-tangent ===
{{{multi tangent}}}
|}}
=== Vertex Colors ===
{{{vertex colors|Shader does not use vertex colors}}}

<div style="clear: both"/>

== Material Inputs ==

=== Textures ===
{{#if:{{{textures|}}}|
{{{!}} class="wikitable" width="100%"
{{!}}+
!width=1%{{!}}{{#tip-text: Name|Name of the material texture slot}}
!width=1%{{!}}{{#tip-text: Index|Index of the texture slot name, starting from 0; This is important when a shader has the same slot name multiple times, in which case their order determines how each slot is used}}
!width=1%{{!}}{{#tip-text: UV Index|Which UV map the slot uses, which is either an index from 0 to 3 or "any", in which case the UV map can be selected in the material.
If a model does not have a UV Map for the specified index, then the game will fall back to UV Index 0}}
!width=1%{{!}}{{#tip-text: Kind|General usage format of the texture slot. More precise documentation is found on the right}}
!width=24%{{!}} {{#tip-text: Red|How the red component of the texture gets used}}
!width=24%{{!}} {{#tip-text: Green|How the green component of the texture gets used}}
!width=24%{{!}} {{#tip-text: Blue|How the blue component of the texture gets used}}
!width=24%{{!}} {{#tip-text: Alpha|How the alpha component of the texture gets used}}
{{#invoke:ShaderDoc|shader_table|{{{textures}}}}}
{{!}}}|This shader does not use any textures.}}

=== Parameters ===
{{#if:{{{parameters|}}}|
{{{!}} class="wikitable" width="100%"
{{!}}+
!width=1%{{!}}{{#tip-text: Name|Name of the parameter}}
!width=25%{{!}}{{#tip-text: X|The first component of the parameter}}
!width=25%{{!}}{{#tip-text: Y|The second component of the parameter}}
!width=25%{{!}}{{#tip-text: Z|The third component of the parameter}}
!width=25%{{!}}{{#tip-text: W|The fourth component of the parameter}}
{{#invoke:ShaderDoc|shader_table|{{{parameters}}}}}
{{!}}}|This shader does not use any parameters.}}
{{#if:{{{gallery|}}}|
== Gallery ==
{{#tag:gallery|{{{gallery}}}|perrow=4|widths=400px|heights=300px|mode=nolines|}}|}}
== Technical ==
{{{technical|}}}
{{#if:{{{features|}}}|
{{{!}} class="mw-collapsible mw-collapsed wikitable" width="300px"
{{!}}-
!Shader Features
{{#invoke:ShaderDoc|technical_features|{{{features}}}}}
{{!}}}|}}<nowiki/></includeonly>
<noinclude>
<templatedata>
{
"params": {
"game": {
"label": "Game",
"description": "Which game this shader belongs to",
"type": "string",
"required": true
},
"shader name": {
"label": "Shader name",
"description": "The name of the shader",
"type": "string",
"required": true
},
"sbo": {
"label": "Shader behavior overview",
"description": "Parameters for the shader behavior overview",
"type": "string",
"required": false
},
"overview": {
"label": "Overview",
"description": "Overview content",
"type": "content",
"required": true
},
"related shaders": {
"label": "Related shaders",
"description": "List of related shaders",
"type": "string",
"required": false
},
"behavior": {
"label": "Behavior",
"description": "Behavior content",
"type": "content",
"required": false
},
"multi tangent": {
"label": "Multi tangent",
"description": "Multi tangent behavior",
"type": "content",
"required": false
},
"vertex colors": {
"label": "Vertex color",
"description": "Vertex color behavior",
"type": "content",
"required": false
},
"textures": {
"label": "Textures",
"description": "Texture table contents; Fields seperated by commas, column spans specified by underscores and rows seperated by semicolons",
"type": "content",
"required": false
},
"parameters": {
"label": "Parameters",
"description": "Parameter table contents; Fields seperated by commas, column spans specified by underscores and rows seperated by semicolons",
"type": "content",
"required": false
},
"gallery": {
"label": "Gallery contents",
"description": "Picture gallery contents",
"type": "string",
"required": false
},
"technical": {
"label": "Technical",
"description": "Technical information",
"type": "content",
"required": false
},
"features": {
"label": "Shader features (technical)",
"description": "List of technical features that the shader has been compiled with",
"type": "content",
"required": false
}
}
}
</templatedata>

== Example ==

{{Shader Documentation
| game = Shadow Generations

| shader name = Common_dpn

| sbo = model=2,
no_opaque_layer,
no_punch_through_layer,
noise_dithering

| overview = A standard PBR shader with no special behavior.

| related shaders =
Common_dn,
Common_dp,
Common_dpn,
Common_dpna,
Common_dither_dpn

| behavior = Lorem ipsum.

| multi tangent =
Lorem ipsum.

| vertex colors =
* Color is multiplied into the <code>diffuse</code> texture color
* Alpha is multiplied into the <code>diffuse</code> texture alpha

| textures =
diffuse,0,0,[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],[[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,Transparency;
test,1,2,,,,,;

| parameters =
diffuse,[[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;
PBRFactor
,[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor
,[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor
,[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor
,;

| gallery = File:ShadowGenerations Detail dpnn example.jpg{{!}}How <code>Detail_dpnn</code> is used for cliffs in Rail Canyon to blend in detail normals when the camera is closer to the surface

| technical = lorem ipsum.

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_deferred_rendering,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi
}}
== Other ==
Outside template
</noinclude>

Module:ShaderDoc

2025-08-22T20:41:39Z

Justin113D: Removed gallery function

--[[

This module provides several functions used in the "Shader_Documentation" template

]]

local shader_doc = {}

--[[
create_sbo

Creates an "Shader behavior overview" from a list of comma separated parameters

Usage:
{{#invoke:ShaderDoc|create_sbo|game=Game|parameters=model=2,toggle_1,toggle_2,toggle_3,etc}}

parameters:
game: Prefix to use for the template
parameters: A list of comma separated names. If a name is not "assigned", it will receive the value "1"
]]
function shader_doc.create_sbo( frame )
local game = frame.args['game'];
local parameters = frame.args['parameters'] or '';

local parameter_list = mw.text.split( parameters, ',' );

local args = {};

for _, parameter in ipairs( parameter_list ) do
if #parameter > 0 then
local name = parameter;
local value = 1;

local equal_pos, equal_end = mw.ustring.find( parameter, '=' );
if equal_pos ~= nil then
name = mw.text.trim(mw.ustring.sub(parameter, 1, equal_pos - 1));
value = mw.text.trim(mw.ustring.sub(parameter, equal_end + 1, #parameter));
else
name = mw.text.trim(name);
end
mw.log(name)
mw.log(value)
mw.log('---')

args[name] = value;
end
end

local title = game .. ' Shader Behavior';

return frame:expandTemplate{ title = title, args = args };
end

--[[
shader_link_list

This function produces a bullet list of links to shaders

Usage:
{{#invoke:ShaderDoc|shader_link_list|game=game_name|shaders=shader_a,shader_b,shader_c,etc}}

parameters:
game: The shader link prefix
shaders: A comma separated list of shaders to list
]]
function shader_doc.shader_link_list( frame )
local game = frame.args['game'];
local shaders = frame.args['shaders'];

if game == nil then
return shader_doc._error( 'Game not specified' );
end

if shaders == nil then
return shader_doc._error( 'Shaders not specified' );
end

local shader_list = mw.text.split( shaders, ',' );
local result = '';

for _, shader in ipairs( shader_list ) do
local trimmed_shader = mw.text.trim(shader);

if #trimmed_shader > 0 then
result = result .. '* [[' .. game .. ' Shaders - ' .. trimmed_shader .. '|' .. trimmed_shader .. ']]\n';
end
end

return result;

end

--[[
shader_table

This function converts comma separated items to a list row

Usage:
{{#invoke:ShaderDoc|technical_features|cell1,cell2,cell3}}

info:
commas (,) = seperate items
underscores (_) before commas = span to the next cell
semicolons (;) = seperate rows
backslash (\) before any of these 4: escape
]]
function shader_doc.shader_table( frame )
local contents = frame.args[1];

if contents == nil then
return shader_doc._error( 'No contents' );
end

if #contents > 0 and string.sub(contents, -1) ~= ';' then
contents = contents .. ';';
end

local current_cell_text = '';
local span_length = 0;
local current_row = {};
local rows = {};
local escaped = false;

for cp in mw.ustring.gcodepoint( contents ) do
local char = mw.ustring.char( cp );
local skip = false;

if span_length > 0 then
if char == '_' then
span_length = span_length + 1;
skip = true;
elseif char ~= ',' and char ~= ';' then
for i = 1,span_length,1 do
current_cell_text = current_cell_text .. '_'
end
span_length = 0;
end
end

if escaped and not skip then
escaped = false;
current_cell_text = current_cell_text .. char;
skip = true;
end

if not skip then
if char == '\\' then
escaped = true;
elseif char == '_' then
span_length = 1;
elseif char == ',' or char == ';' then

table.insert(current_row, {
['text'] = current_cell_text,
['span_length'] = span_length
});

span_length = 0;
current_cell_text = '';

if char == ';' then
table.insert(rows, current_row);
current_row = {};
end
else
current_cell_text = current_cell_text .. char;
end
end
end

local result = '';

for i, row in ipairs(rows) do
result = result .. '|-\n';
for j, cell in ipairs(row) do
if j == 1 then
result = result .. '!';
else
result = result .. '|';
end

span_length = cell['span_length'];
if span_length > 0 then
result = result .. 'colspan="' .. (span_length + 1) .. '"|';
end

current_cell_text = mw.text.trim(cell['text']);

if #current_cell_text == 0 then
current_cell_text = 'N/A';
end

if j == 1 then
current_cell_text = '<code>' .. current_cell_text .. '</code>';
end

result = result .. current_cell_text .. '\n';
end
end

return result;
end

--[[
technical_features

This function produces single column table rows with code formatting.

Usage:
{{#invoke:ShaderDoc|technical_features|feature_a,feature_b,feature_c,etc}}

parameters:
features: A comma separated list of technical features
]]
function shader_doc.technical_features( frame )
local features = frame.args[1];

if features == nil then
return shader_doc._error( 'Features not specified' );
end

local feature_list = mw.text.split( features, ',' );
local result = '';

for _, feature in ipairs( feature_list ) do
local trimmed_feature = mw.text.trim(feature);
if #trimmed_feature > 0 then
result = result .. '|-\n|<code>' .. trimmed_feature .. '</code>\n';
end
end

return result;
end

--[[
Helper function to handle error messages.
]]
function shader_doc._error( error_str )
local frame = mw.getCurrentFrame();
local error_category = frame.args.error_category or 'Errors reported by Module String';
local ignore_errors = frame.args.ignore_errors or false;
local no_category = frame.args.no_category or false;

if shader_doc._getBoolean(ignore_errors) then
return '';
end

local error_str = 'String Module Error: ' .. error_str .. '';
if error_category ~= '' and not shader_doc._getBoolean( no_category ) then
error_str = '[[Category:' .. error_category .. ']]' .. error_str;
end

return error_str;
end

--[[
Helper Function to interpret boolean strings
]]
function shader_doc._getBoolean( boolean_str )
local boolean_value;

if type( boolean_str ) == 'string' then
boolean_str = boolean_str:lower();
if boolean_str == 'false' or boolean_str == 'no' or boolean_str == '0'
or boolean_str == '' then
boolean_value = false;
else
boolean_value = true;
end
elseif type( boolean_str ) == 'boolean' then
boolean_value = boolean_str;
else
error( 'No boolean value found' );
end
return boolean_value
end

return shader_doc;

Module:ShaderDoc

2025-08-22T20:35:19Z

Justin113D: Gallery tests

--[[

This module provides several functions used in the "Shader_Documentation" template

]]

local shader_doc = {}

--[[
create_sbo

Creates an "Shader behavior overview" from a list of comma separated parameters

Usage:
{{#invoke:ShaderDoc|create_sbo|game=Game|parameters=model=2,toggle_1,toggle_2,toggle_3,etc}}

parameters:
game: Prefix to use for the template
parameters: A list of comma separated names. If a name is not "assigned", it will receive the value "1"
]]
function shader_doc.create_sbo( frame )
local game = frame.args['game'];
local parameters = frame.args['parameters'] or '';

local parameter_list = mw.text.split( parameters, ',' );

local args = {};

for _, parameter in ipairs( parameter_list ) do
if #parameter > 0 then
local name = parameter;
local value = 1;

local equal_pos, equal_end = mw.ustring.find( parameter, '=' );
if equal_pos ~= nil then
name = mw.text.trim(mw.ustring.sub(parameter, 1, equal_pos - 1));
value = mw.text.trim(mw.ustring.sub(parameter, equal_end + 1, #parameter));
else
name = mw.text.trim(name);
end
mw.log(name)
mw.log(value)
mw.log('---')

args[name] = value;
end
end

local title = game .. ' Shader Behavior';

return frame:expandTemplate{ title = title, args = args };
end

--[[
shader_link_list

This function produces a bullet list of links to shaders

Usage:
{{#invoke:ShaderDoc|shader_link_list|game=game_name|shaders=shader_a,shader_b,shader_c,etc}}

parameters:
game: The shader link prefix
shaders: A comma separated list of shaders to list
]]
function shader_doc.shader_link_list( frame )
local game = frame.args['game'];
local shaders = frame.args['shaders'];

if game == nil then
return shader_doc._error( 'Game not specified' );
end

if shaders == nil then
return shader_doc._error( 'Shaders not specified' );
end

local shader_list = mw.text.split( shaders, ',' );
local result = '';

for _, shader in ipairs( shader_list ) do
local trimmed_shader = mw.text.trim(shader);

if #trimmed_shader > 0 then
result = result .. '* [[' .. game .. ' Shaders - ' .. trimmed_shader .. '|' .. trimmed_shader .. ']]\n';
end
end

return result;

end

--[[
shader_table

This function converts comma separated items to a list row

Usage:
{{#invoke:ShaderDoc|technical_features|cell1,cell2,cell3}}

info:
commas (,) = seperate items
underscores (_) before commas = span to the next cell
semicolons (;) = seperate rows
backslash (\) before any of these 4: escape
]]
function shader_doc.shader_table( frame )
local contents = frame.args[1];

if contents == nil then
return shader_doc._error( 'No contents' );
end

if #contents > 0 and string.sub(contents, -1) ~= ';' then
contents = contents .. ';';
end

local current_cell_text = '';
local span_length = 0;
local current_row = {};
local rows = {};
local escaped = false;

for cp in mw.ustring.gcodepoint( contents ) do
local char = mw.ustring.char( cp );
local skip = false;

if span_length > 0 then
if char == '_' then
span_length = span_length + 1;
skip = true;
elseif char ~= ',' and char ~= ';' then
for i = 1,span_length,1 do
current_cell_text = current_cell_text .. '_'
end
span_length = 0;
end
end

if escaped and not skip then
escaped = false;
current_cell_text = current_cell_text .. char;
skip = true;
end

if not skip then
if char == '\\' then
escaped = true;
elseif char == '_' then
span_length = 1;
elseif char == ',' or char == ';' then

table.insert(current_row, {
['text'] = current_cell_text,
['span_length'] = span_length
});

span_length = 0;
current_cell_text = '';

if char == ';' then
table.insert(rows, current_row);
current_row = {};
end
else
current_cell_text = current_cell_text .. char;
end
end
end

local result = '';

for i, row in ipairs(rows) do
result = result .. '|-\n';
for j, cell in ipairs(row) do
if j == 1 then
result = result .. '!';
else
result = result .. '|';
end

span_length = cell['span_length'];
if span_length > 0 then
result = result .. 'colspan="' .. (span_length + 1) .. '"|';
end

current_cell_text = mw.text.trim(cell['text']);

if #current_cell_text == 0 then
current_cell_text = 'N/A';
end

if j == 1 then
current_cell_text = '<code>' .. current_cell_text .. '</code>';
end

result = result .. current_cell_text .. '\n';
end
end

return result;
end

--[[
create_gallery

This function creates a gallery, because for some reason this cant be done in a regular template.

]]

function shader_doc.create_gallery( frame )
local parameters = frame.args[1] or '';
local contents = frame.args[2] or '';

local gallery = mw.html.create( 'gallery' );
gallery:wikitext( contents );

return tostring( gallery );
end

--[[
technical_features

This function produces single column table rows with code formatting.

Usage:
{{#invoke:ShaderDoc|technical_features|feature_a,feature_b,feature_c,etc}}

parameters:
features: A comma separated list of technical features
]]
function shader_doc.technical_features( frame )
local features = frame.args[1];

if features == nil then
return shader_doc._error( 'Features not specified' );
end

local feature_list = mw.text.split( features, ',' );
local result = '';

for _, feature in ipairs( feature_list ) do
local trimmed_feature = mw.text.trim(feature);
if #trimmed_feature > 0 then
result = result .. '|-\n|<code>' .. trimmed_feature .. '</code>\n';
end
end

return result;
end

--[[
Helper function to handle error messages.
]]
function shader_doc._error( error_str )
local frame = mw.getCurrentFrame();
local error_category = frame.args.error_category or 'Errors reported by Module String';
local ignore_errors = frame.args.ignore_errors or false;
local no_category = frame.args.no_category or false;

if shader_doc._getBoolean(ignore_errors) then
return '';
end

local error_str = 'String Module Error: ' .. error_str .. '';
if error_category ~= '' and not shader_doc._getBoolean( no_category ) then
error_str = '[[Category:' .. error_category .. ']]' .. error_str;
end

return error_str;
end

--[[
Helper Function to interpret boolean strings
]]
function shader_doc._getBoolean( boolean_str )
local boolean_value;

if type( boolean_str ) == 'string' then
boolean_str = boolean_str:lower();
if boolean_str == 'false' or boolean_str == 'no' or boolean_str == '0'
or boolean_str == '' then
boolean_value = false;
else
boolean_value = true;
end
elseif type( boolean_str ) == 'boolean' then
boolean_value = boolean_str;
else
error( 'No boolean value found' );
end
return boolean_value
end

return shader_doc;

Module:ShaderDoc

2025-08-22T20:24:53Z

Justin113D: Added create_gallery

--[[

This module provides several functions used in the "Shader_Documentation" template

]]

local shader_doc = {}

--[[
create_sbo

Creates an "Shader behavior overview" from a list of comma separated parameters

Usage:
{{#invoke:ShaderDoc|create_sbo|game=Game|parameters=model=2,toggle_1,toggle_2,toggle_3,etc}}

parameters:
game: Prefix to use for the template
parameters: A list of comma separated names. If a name is not "assigned", it will receive the value "1"
]]
function shader_doc.create_sbo( frame )
local game = frame.args['game'];
local parameters = frame.args['parameters'] or '';

local parameter_list = mw.text.split( parameters, ',' );

local args = {};

for _, parameter in ipairs( parameter_list ) do
if #parameter > 0 then
local name = parameter;
local value = 1;

local equal_pos, equal_end = mw.ustring.find( parameter, '=' );
if equal_pos ~= nil then
name = mw.text.trim(mw.ustring.sub(parameter, 1, equal_pos - 1));
value = mw.text.trim(mw.ustring.sub(parameter, equal_end + 1, #parameter));
else
name = mw.text.trim(name);
end
mw.log(name)
mw.log(value)
mw.log('---')

args[name] = value;
end
end

local title = game .. ' Shader Behavior';

return frame:expandTemplate{ title = title, args = args };
end

--[[
shader_link_list

This function produces a bullet list of links to shaders

Usage:
{{#invoke:ShaderDoc|shader_link_list|game=game_name|shaders=shader_a,shader_b,shader_c,etc}}

parameters:
game: The shader link prefix
shaders: A comma separated list of shaders to list
]]
function shader_doc.shader_link_list( frame )
local game = frame.args['game'];
local shaders = frame.args['shaders'];

if game == nil then
return shader_doc._error( 'Game not specified' );
end

if shaders == nil then
return shader_doc._error( 'Shaders not specified' );
end

local shader_list = mw.text.split( shaders, ',' );
local result = '';

for _, shader in ipairs( shader_list ) do
local trimmed_shader = mw.text.trim(shader);

if #trimmed_shader > 0 then
result = result .. '* [[' .. game .. ' Shaders - ' .. trimmed_shader .. '|' .. trimmed_shader .. ']]\n';
end
end

return result;

end

--[[
shader_table

This function converts comma separated items to a list row

Usage:
{{#invoke:ShaderDoc|technical_features|cell1,cell2,cell3}}

info:
commas (,) = seperate items
underscores (_) before commas = span to the next cell
semicolons (;) = seperate rows
backslash (\) before any of these 4: escape
]]
function shader_doc.shader_table( frame )
local contents = frame.args[1];

if contents == nil then
return shader_doc._error( 'No contents' );
end

if #contents > 0 and string.sub(contents, -1) ~= ';' then
contents = contents .. ';';
end

local current_cell_text = '';
local span_length = 0;
local current_row = {};
local rows = {};
local escaped = false;

for cp in mw.ustring.gcodepoint( contents ) do
local char = mw.ustring.char( cp );
local skip = false;

if span_length > 0 then
if char == '_' then
span_length = span_length + 1;
skip = true;
elseif char ~= ',' and char ~= ';' then
for i = 1,span_length,1 do
current_cell_text = current_cell_text .. '_'
end
span_length = 0;
end
end

if escaped and not skip then
escaped = false;
current_cell_text = current_cell_text .. char;
skip = true;
end

if not skip then
if char == '\\' then
escaped = true;
elseif char == '_' then
span_length = 1;
elseif char == ',' or char == ';' then

table.insert(current_row, {
['text'] = current_cell_text,
['span_length'] = span_length
});

span_length = 0;
current_cell_text = '';

if char == ';' then
table.insert(rows, current_row);
current_row = {};
end
else
current_cell_text = current_cell_text .. char;
end
end
end

local result = '';

for i, row in ipairs(rows) do
result = result .. '|-\n';
for j, cell in ipairs(row) do
if j == 1 then
result = result .. '!';
else
result = result .. '|';
end

span_length = cell['span_length'];
if span_length > 0 then
result = result .. 'colspan="' .. (span_length + 1) .. '"|';
end

current_cell_text = mw.text.trim(cell['text']);

if #current_cell_text == 0 then
current_cell_text = 'N/A';
end

if j == 1 then
current_cell_text = '<code>' .. current_cell_text .. '</code>';
end

result = result .. current_cell_text .. '\n';
end
end

return result;
end

--[[
create_gallery

This function creates a gallery, because for some reason this cant be done in a regular template.

]]

function shader_doc.create_gallery( frame )
local parameters = frame.args[1] or '';
local contents = frame.args[2] or '';
return '<gallery ' .. parameters .. '>\n' .. contents .. '\n</gallery>';
end

--[[
technical_features

This function produces single column table rows with code formatting.

Usage:
{{#invoke:ShaderDoc|technical_features|feature_a,feature_b,feature_c,etc}}

parameters:
features: A comma separated list of technical features
]]
function shader_doc.technical_features( frame )
local features = frame.args[1];

if features == nil then
return shader_doc._error( 'Features not specified' );
end

local feature_list = mw.text.split( features, ',' );
local result = '';

for _, feature in ipairs( feature_list ) do
local trimmed_feature = mw.text.trim(feature);
if #trimmed_feature > 0 then
result = result .. '|-\n|<code>' .. trimmed_feature .. '</code>\n';
end
end

return result;
end

--[[
Helper function to handle error messages.
]]
function shader_doc._error( error_str )
local frame = mw.getCurrentFrame();
local error_category = frame.args.error_category or 'Errors reported by Module String';
local ignore_errors = frame.args.ignore_errors or false;
local no_category = frame.args.no_category or false;

if shader_doc._getBoolean(ignore_errors) then
return '';
end

local error_str = 'String Module Error: ' .. error_str .. '';
if error_category ~= '' and not shader_doc._getBoolean( no_category ) then
error_str = '[[Category:' .. error_category .. ']]' .. error_str;
end

return error_str;
end

--[[
Helper Function to interpret boolean strings
]]
function shader_doc._getBoolean( boolean_str )
local boolean_value;

if type( boolean_str ) == 'string' then
boolean_str = boolean_str:lower();
if boolean_str == 'false' or boolean_str == 'no' or boolean_str == '0'
or boolean_str == '' then
boolean_value = false;
else
boolean_value = true;
end
elseif type( boolean_str ) == 'boolean' then
boolean_value = boolean_str;
else
error( 'No boolean value found' );
end
return boolean_value
end

return shader_doc;

Shadow Generations Shaders - BlendDetail dpndpnn

2025-08-22T20:12:30Z

Justin113D: Added page

{{Shader Documentation
| game = Shadow Generations
| shader name = BlendDetail_dpndpnn
| sbo = model=2, no_noise, no_compute_instancing, no_transparent_layer, no_punch_through_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses
* [[Texture Blending#Distance blending|distance blending]] to [[Texture Blending#Normal map blending|blend]] in a detail [[Hedgehog Engine 2 - Textures#Normal map|normal map]]
* Vertex alpha to blend between two sets of [[Hedgehog Engine 2 - Textures#Albedo|albedo]] and [[Hedgehog Engine 2 - Textures#PRM|PRM]] textures

It is essentially a combination of the {{ShaderLink|Shadow Generations|Blend_dpndpn}} and {{ShaderLink|Shadow Generations|Detail_dpnn}} shaders.

| related shaders =
Blend_dpndpn,
Blend_dpnbdpn,
BlendDetail_dndnd,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =
=== Distance blending ===
Uses [[Texture Blending#Distance blending|distance blending]] to interpolate
* from the <code>normal</code> texture
* to the <code>normal</code> and <code>normal[2]</code> textures [[Texture Blending#Normal map blending|blended]] together.

 The shader uses <code>detailDistance</code> and <code>detailFadeRange</code> from the stage RFL to determine the detail range.

=== Vertex alpha blending ===

This shader has two sets of PBR textures:
* <code>diffuse</code> and <code>specular</code>
* <code>diffuse[1]</code> and <code>specular[1]</code>

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor consists of just the vertex alpha.

* For the <code>specular</code> textures, the blend factor is used as is.
* For the <code>diffuse</code> textures, the blend factor is multiplied by the <code>diffuse[1]</code> texture alpha.

=== Bugs ===

{{notice
|type=warn
|content=The shader has 3 <code>normal</code> texture slots: Only <code>normal</code> and <code>normal[2]</code> are used, with <code>normal[1]</code> left unused.
Yet, to be able to specify a texture for the <code>normal[2]</code> slot, a material must have 3 texture slots, even if the slot for <code>normal[1]</code> is empty.
 In a similar vein, the shader has the <code>enable_multi_tangent_space</code> feature, but never makes use of it.

 Speculation:
What likely happened here is that the developers used the code from {{ShaderLink|Shadow Generations|Blend_dpndpn}} as a base and then added in the detail normal map logic from {{ShaderLink|Shadow Generations|Detail_dpnn}} but accidentally pasted it over the previous normal map code, leaving just the detail normal map code behind.
}}

| vertex colors =
* Color is multiplied into the <code>diffuse</code> texture color
* Alpha is used as the basis for the blend factor

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;

diffuse,1,2,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
Multiplied into the vertex alpha (blend factor)\, but only for when blending the two diffuse textures!;

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,2,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|Normal map direction]]_,,;

normal,1,N/A,,Unused___;

normal,2,3,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the <code>normal[2]</code> texture,,,;

| features =
enable_multi_tangent_space,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi,

}}

Shadow Generations Shaders - Detail dpnn

2025-08-22T19:58:58Z

Justin113D: Simplified detail normal map documentation

{{Shader Documentation
| game = Shadow Generations
| shader name = Detail_dpnn
| sbo = model=2, no_noise, no_transparent_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses [[Texture Blending#Distance blending|distance blending]] to [[Texture Blending#Normal map blending|blend]] in a detail [[Hedgehog Engine 2 - Textures#Normal map|normal map]].

| related shaders =
Blend_dpndpn,
Blend_dpnbdpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =
Uses [[Texture Blending#Distance blending|distance blending]] to interpolate
* from the <code>normal</code> texture
* to the <code>normal</code> and <code>normal[1]</code> textures [[Texture Blending#Normal map blending|blended]] together.

The shader uses <code>detailDistance</code> and <code>detailFadeRange</code> from the stage RFL to determine the detail range.

| vertex colors =
* Color is multiplied into the <code>diffuse</code> texture color
* Alpha is multiplied into the <code>diffuse</code> texture alpha

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
[[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Opacity|Opacity]];

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
[[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the <code>normal[1]</code> texture,,,;

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi,

}}
== Gallery ==
<gallery perrow="4" widths="400px" heights="300px" mode="nolines">
File:ShadowGenerations Detail dpnn example.jpg|How <code>Detail_dpnn</code> is used for cliffs in Rail Canyon to blend in detail normals when the camera is closer to the surface
</gallery>

Template:ShaderLink

2025-08-22T19:44:48Z

Justin113D: Fixed newline

<includeonly>[[{{{game|{{{1}}}}}} Shaders - {{{shader|{{{2}}}}}}|{{{shader|{{{2}}}}}}]]</includeonly><noinclude>
<templatedata>
{
"params": {
"game": {
"label": "Game",
"description": "Which game this shader belongs to",
"type": "string",
"required": true
},
"shader": {
"label": "Shader",
"description": "The name of the shader",
"type": "string",
"required": true
}

}
}
</templatedata>

== Overview ==
This template is primarily intended to be used with the [https://en.wikipedia.org/wiki/Template:For_loop for loop] template.

== Examples ==

{{ShaderLink
| game=Shadow Generations
| shader=Common_dpn
}}

{{ShaderLink|Shadow Generations|Common_dpn}}

{{ShaderLink|Shadow Generations|Common_dpn}} {{ShaderLink|Shadow Generations|Common_dpn}}

</noinclude>

Shadow Generations Shaders - Blend dpnbdpn

2025-08-22T19:42:15Z

Justin113D: Wording

{{Shader Documentation
| game = Shadow Generations
| shader name = Blend_dpnbdpn
| sbo = model=2, no_transparent_layer, no_punch_through_layer, no_noise, no_compute_instancing, multi_tangent

| overview =
An advanced PBR shader that lets you blend between two sets of textures using vertex alpha and a mask texture.

| related shaders =
Blend_dpndpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =
This shader has two sets of PBR textures:
* <code>diffuse</code>, <code>specular</code> and <code>normal</code>
* <code>diffuse[1]</code>, <code>specular[1]</code> and <code>normal[1]</code>

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor consists of the vertex alpha multiplied by the <code>transparency</code> textures red channel.

* For the <code>specular</code> and <code>normal</code> textures, the blend factor is used as is.
* For the <code>diffuse</code> textures, the blend factor is multiplied by the <code>diffuse[1]</code> texture alpha.

| multi tangent =
When enabled, the second set of tangents will be used to [[Normal_mapping#Tangent_Space|unpack]] the <code>normal[1]</code> texture.

| vertex colors =
* Color is multiplied into the blended together diffuse texture color
* Alpha is used as the basis for the blend factor

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;

diffuse,1,2,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
Multiplied into the vertex alpha (blend factor)\, but only for when blending the two diffuse textures!;

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,2,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Second [[Normal_mapping|Normal map direction]]_,,;

transparency,0,3,
Mask,
Multiplied into the vertex alpha (blend factor),,,;

| features =
is_use_tex_srt_anim,
enable_multi_tangent_space,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi

}}
== Gallery ==
<gallery perrow="4" widths="400px" heights="300px" mode="nolines">
File:ShadowGenerations Blend dpnbdpn example.jpg|How <code>Blend_dpnbdpn</code> is used for the Ship in the metal overlord boss fight to make use of already existing textures
</gallery>

Shadow Generations Shaders - Blend dpndpn

2025-08-22T19:41:58Z

Justin113D: Wording

{{Shader Documentation
| game = Shadow Generations
| shader name = Blend_dpndpn
| sbo = model=2, no_transparent_layer, no_punch_through_layer, no_noise, no_compute_instancing, multi_tangent

| overview =
An advanced PBR shader that lets you blend between two sets of textures using vertex alpha.

| related shaders =
Blend_dpnbdpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =
This shader has two sets of PBR textures:
* <code>diffuse</code>, <code>specular</code> and <code>normal</code>
* <code>diffuse[1]</code>, <code>specular[1]</code> and <code>normal[1]</code>

The shader uses a blend factor to [[Texture Blending#Interpolation|interpolate]] from the first set of textures to second one.
 This blend factor consists of just the vertex alpha.

* For the <code>specular</code> and <code>normal</code> textures, the blend factor is used as is.
* For the <code>diffuse</code> textures, the blend factor is multiplied by the <code>diffuse[1]</code> texture alpha.

| multi tangent =
When enabled, the second set of tangents will be used to [[Normal_mapping#Tangent_Space|unpack]] the <code>normal[1]</code> texture.

| vertex colors =
* Color is multiplied into the blended together diffuse texture color
* Alpha is used as the basis for the blend factor

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
First [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,;

diffuse,1,2,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
Second [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
Multiplied into the vertex alpha (blend factor)\, but only for when blending the two diffuse textures!;

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
First [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,2,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
Second [[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
First [[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Second [[Normal_mapping|Normal map direction]]_,,;

| features =
is_use_tex_srt_anim,
enable_multi_tangent_space,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi

}}
== Gallery ==
<gallery perrow="4" widths="400px" heights="300px" mode="nolines">
File:ShadowGenerations Blend dpndpn example.jpg|How <code>Blend_dpndpn</code> is used to transition from the bridge to the grass
</gallery>

File:ShadowGenerations Detail dpnn example.jpg

2025-08-22T19:20:07Z

Justin113D: Justin113D uploaded a new version of File:ShadowGenerations Detail dpnn example.jpg

An example for how the Detail_dpnn shader is used in Shadow Generations

Shadow Generations Shaders - Detail dpndpn

2025-08-22T19:11:17Z

Justin113D: Added gallery

{{Shader Documentation
| game = Shadow Generations
| shader name = Detail_dpndpn
| sbo = model=2, no_noise, no_transparent_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses [[Texture Blending#Distance blending|distance blending]] to blend in a set of detail textures.

| related shaders =
Blend_dpndpn,
Blend_dpnbdpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =
Uses [[Texture Blending#Distance blending|distance blending]] to interpolate
* from the first set of textures
* to the first set of texture with the second set of texture blended into them.

Each of the second textures is blended into the first differently:

{{{!}} Class="wikitable"
{{!}}+
! Texture property
! blend method
{{!}}-
{{!}} Albedo
{{!}} Uses [[Texture Blending#Detail blending|detail blending]]
{{!}}-
{{!}} Transparency
{{!}} Not blended
{{!}}-
{{!}} Specular
{{!}} Not blended
{{!}}-
{{!}} Roughness
{{!}} Uses [[Texture Blending#Detail blending|detail blending]]
{{!}}-
{{!}} Metallic
{{!}} Addition; Remaps the detail metallic to a range of <code>-1</code> to <code>1</code> beforehand
{{!}}-
{{!}} Ambient Occlusion
{{!}} Multiplication
{{!}}-
{{!}} Normal
{{!}} Uses [[Texture Blending#Normal blending|normal blending]]
{{!}}}

 The shader uses <code>detailDistance</code> and <code>detailFadeRange</code> from the stage RFL to determine the detail range.

| vertex colors =
* Color is multiplied into the <code>diffuse</code> texture color
* Alpha is multiplied into the <code>diffuse</code> texture alpha

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
[[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Opacity|Opacity]];

diffuse,0,0,
Detail albedo,
Detail color__,;

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,2,
Detail PRM,,
Detail Smoothness,
Detail Metallic,
Detail Ambient Occlusion;

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
[[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the second set of textures,,,;

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi,

}}
== Gallery ==
<gallery perrow="4" widths="400px" heights="300px" mode="nolines">
File:ShadowGenerations Detail dpndpn example.jpg|How <code>Detail_dpndpn</code> is used in the Mephiles boss arena to add details when the camera is close to the floor
</gallery>

File:ShadowGenerations Detail dpndpn example.jpg

2025-08-22T19:10:07Z

Justin113D:

An example for how the Detail_dpndpn shader is used in Shadow Generations

Shadow Generations Shaders - Detail dpndpn

2025-08-22T18:16:55Z

Justin113D: Formatting

{{Shader Documentation
| game = Shadow Generations
| shader name = Detail_dpndpn
| sbo = model=2, no_noise, no_transparent_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses [[Texture Blending#Distance blending|distance blending]] to blend in a set of detail textures.

| related shaders =
Blend_dpndpn,
Blend_dpnbdpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =
Uses [[Texture Blending#Distance blending|distance blending]] to interpolate
* from the first set of textures
* to the first set of texture with the second set of texture blended into them.

Each of the second textures is blended into the first differently:

{{{!}} Class="wikitable"
{{!}}+
! Texture property
! blend method
{{!}}-
{{!}} Albedo
{{!}} Uses [[Texture Blending#Detail blending|detail blending]]
{{!}}-
{{!}} Transparency
{{!}} Not blended
{{!}}-
{{!}} Specular
{{!}} Not blended
{{!}}-
{{!}} Roughness
{{!}} Uses [[Texture Blending#Detail blending|detail blending]]
{{!}}-
{{!}} Metallic
{{!}} Addition; Remaps the detail metallic to a range of <code>-1</code> to <code>1</code> beforehand
{{!}}-
{{!}} Ambient Occlusion
{{!}} Multiplication
{{!}}-
{{!}} Normal
{{!}} Uses [[Texture Blending#Normal blending|normal blending]]
{{!}}}

 The shader uses <code>detailDistance</code> and <code>detailFadeRange</code> from the stage RFL to determine the detail range.

| vertex colors =
* Color is multiplied into the <code>diffuse</code> texture color
* Alpha is multiplied into the <code>diffuse</code> texture alpha

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
[[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Opacity|Opacity]];

diffuse,0,0,
Detail albedo,
Detail color__,;

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,2,
Detail PRM,,
Detail Smoothness,
Detail Metallic,
Detail Ambient Occlusion;

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
[[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the second set of textures,,,;

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi,

}}
== Gallery ==
<gallery perrow="4" widths="400px" heights="300px" mode="nolines">
</gallery>

Texture Blending

2025-08-22T18:10:03Z

Justin113D: Spelling

= Texture Blending =

This page documents the different ways two textures can be blended.

== Interpolation ==

Interpolation, specifically linear interpolation (or "lerping") uses a "blend factor" parameter to decide which of two textures should be more visible.
 When "Interpolating from <code>a</code> to <code>b</code> using <code>x</code>" then
* <code>a</code> will be 100% visible when <code>x</code> is <code>0</code>
* <code>b</code> will be 100% visible when <code>x</code> is <code>1</code>
* <code>a</code> will be 50% visible, and <code>b</code> will be 50% visible when <code>x</code> is <code>0.5</code>
* <code>a</code> will be 25% visible, and <code>b</code> will be 75% visible when <code>x</code> is <code>0.75</code>
and so fourth.

Textures that provide a blend factor are usually referred to as "masks".

[[File:LinearInterpolationExample.png|frame|center|alt=An example of how linear interpolation is used to blend two textures together|thumb|An example of how linear interpolation is used to blend two textures together]]

As you can see, this behavior is basically like using the mask texture as the second images alpha channel, and then overlaying them.

=== Smoothstep ===

Usually "interpolating" refers to "linearly interpolating", but there are non-linear ways to interpolate between two textures too.

The most common non-linear way to interpolate is by using "smooth Hermite interpolation" (often referred to as just "smoothstep").

{| class="wikitable" style="width: 90%; margin: auto;"
|-
|style="width: 30%"|[[File:SmoothstepGraph.png|256px|center|A graph with a linear and a smoothstep curve]]
|style="width: 30%"|[[File:SmoothstepGradientComparison.png|256px|center]]
|style="width: 30%"|[[File:SmoothstepGradientComparison Spherical.png|256px|center]]
|-
|A graph with a linear and a smoothstep curve
|A linear gradient and the same gradient used as the blend factor when interpolating from black to white using smoothstep
|A spherical gradient and the same gradient used as the blend factor when interpolating from black to white using smoothstep
|}

=== Directional blending ===
Directional blending involves using the [[Normal_mapping#What_are_normals?|normal directions]] of a model and a "target direction" to then calculate the angle between those two directions and using that as the blending factor for interpolate between two textures.

* When the target direction points in the same direction as the models normal direction, then the blending factor is 1
* The closer the models normal direction rotates away from the target direction, the closer the blending factor gets to 0
* At a 90° difference, the blending factor reaches 0
* Below 90°, the blending factor turns negative (reaching -1 at 180°), but this value gets rounded up to 0

[[File:DirectionalBlending.png|center|frame|Directional blending in action]]

==== Variables ====

The blend factor can also be altered by various variables that game-shaders usually make use of:

{| class="wikitable" style="margin: auto"
|+
! Name
! Description
|-
| Bias
|Used to shift the blend factor closer to either end, where
* 0.5 does not change the factor at all
* 1 shifts it completely to 1
* 0 shifts it completely to 0
|-
| Blend limit
| Limits the blend factor to a value
|-
| Blend intensity
| Changes how quickly the blend factor reaches a value of 1; Works similar to the bias, where 0.5 is the unchanging "center".
|-
| Blend offset
| A value added after all other parameters that moves the "starting point" of the factor.
|}

{{notice
|type=warn
|content=This variable-model has been based off how Shadow Generations directional blend shaders work
}}

==== Examples ====

{| class="wikitable" style="width: 100%"
|+
!colspan="3"|Directional blending examples using <code>m03_rockcliff01_sy1.material</code> from Shadow Generations
|-
|colspan="3"|[[File:DirectionalBlendingExamples.png|frame|center]]
|-
|width="33%"|The two diffuse textures being blended with the default directional blend factor
|width="33%"|Using an intensity of 0.9 to change the blend factor
|width="33%"|Using a normal map to change the normal directions and make the directional blend factor more varying
|}

=== Distance blending ===
By using the distance between the camera and the surface to render as the blend factor, you can blend between textures depending on how far away the camera is.

Usually when doing this, a range is specified before which the blend factor is 0 and after which it is 1, e.g. starting to blend a texture in when 100 units away and making it fully visible at 50 units.

== Normal map blending ==
This is used to combine two normal maps:

[[File:NormalMapBlending.png|center|frame|Two normals maps being blended together]]

{| class="mw-collapsible mw-collapsed wikitable" width="778px" style="margin:auto;"
|-
! The math behind
|-
| Normal maps are combined like this using a simple function:
<syntaxhighlight lang="hlsl" line="1">
float3 BlendNormals(float3 a, float3 b)
{
a += float3(0, 0, 1);
b *= float3(-1, -1, 1);

return a * dot(a, b) / a.z - b;
}</syntaxhighlight>
|}

== Detail blending ==
Detail textures are used to add extra detail to a color texture, usually used with with [[#Distance Blending|distance blending]].

A detail textures default color is a perfect gray (RGB values of 0.5, or #808080), at which the color texture is applied to will not change. Colors darker than this gray will darken the main texture, and lighter ones will brighten it.

[[File:DetailBlendExample.png|frame|center| <code>w13_dtd_floor02_dfsp_y_mm1_abd</code> and <code>w13_dtd_floor02_dfsp_y_mm1_detail_abd</code> from Shadow Generations being combined using detail blending]]

{| class="mw-collapsible mw-collapsed wikitable" width="778px" style="margin:auto;"
|-
! The math behind
|-
| A detail texture is blended into a main texture using this function:
<syntaxhighlight lang="hlsl" line="1">
float3 BlendDetail(float3 main, float3 detail)
{
float3 positive = detail * main * 2;
float3 negative = 1 - (1 - detail) * ((1 - main) * 2);
bool3 check = main < 0.5;

return check ? positive : negative;
}</syntaxhighlight>
|}

Shadow Generations Shaders - Detail dpndpn

2025-08-22T18:09:25Z

Justin113D: Added page

{{Shader Documentation
| game = Shadow Generations
| shader name = Detail_dpndpn
| sbo = model=2, no_noise, no_transparent_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses [[Texture Blending#Distance blending|distance blending]] to blend in a set of detail textures.

| related shaders =
Blend_dpndpn,
Blend_dpnbdpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpnn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =
Uses [[Texture Blending#Distance blending|distance blending]] to interpolate
* from the first set of textures
* to the first set of texture with the second set of texture blended into them.

Each of the second textures is blended into the first differently:

{{{!}} Class="wikitable"
{{!}}+
! Texture property
! blend method
{{!}}-
{{!}} Albedo
{{!}} Uses [[Texture Blending#Detail blending|detail blending]]
{{!}}-
{{!}} Transparency
{{!}} Not blended
{{!}}-
{{!}} Specular
{{!}} Not blended
{{!}}-
{{!}} Roughness
{{!}} Uses [[Texture Blending#Detail blending|detail blending]]
{{!}}-
{{!}} Metallic
{{!}} Addition; Remaps the detail metallic to a range of <code>-1</code> to <code>1</code> beforehand
{{!}}-
{{!}} Ambient Occlusion
{{!}} Multiplication
{{!}}-
{{!}} Normal
{{!}} Uses [[Texture Blending#Normal blending|normal blending]]
{{!}}}

The shader uses <code>detailDistance</code> and <code>detailFadeRange</code> from the stage RFL to determine the detail range.

| vertex colors =
* Color is multiplied into the <code>diffuse</code> texture color
* Alpha is multiplied into the <code>diffuse</code> texture alpha

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
[[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Opacity|Opacity]];

diffuse,0,0,
Detail albedo,
Detail color__,;

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

specular,1,2,
Detail PRM,,
Detail Smoothness,
Detail Metallic,
Detail Ambient Occlusion;

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
[[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
Detail [[Normal_mapping|Normal map direction]]_,,;

| parameters =

DetailFactor,
UV scale for the second set of textures,,,;

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi,

}}
== Gallery ==
<gallery perrow="4" widths="400px" heights="300px" mode="nolines">
</gallery>

Shadow Generations Shaders - Detail dpnn

2025-08-22T17:22:08Z

Justin113D: Added gallery and RFL variable names

{{Shader Documentation
| game = Shadow Generations
| shader name = Detail_dpnn
| sbo = model=2, no_noise, no_transparent_layer

| overview =
An advanced [[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)|PBR]] shader that uses [[Texture Blending#Distance blending|distance blending]] to [[Texture Blending#Normal map blending|blend]] in a detail [[Hedgehog Engine 2 - Textures#Normal map|normal map]].

| related shaders =
Blend_dpndpn,
Blend_dpnbdpn,
BlendDetail_dndnd,
BlendDetail_dpndpnn,
Detail_dpndpn,
DirectionBlend_dpndpn,
DirectionBlend_dpndpnn,
DirectionBlend_dpnndpn,
DistanceBlend_dpn

| behavior =
Uses [[Texture Blending#Distance blending|distance blending]] to interpolate
* from the <code>normal</code> texture
* to the <code>normal</code> and <code>normal[1]</code> textures [[Texture Blending#Normal map blending|blended]] together.

The shader uses <code>detailDistance</code> and <code>detailFadeRange</code> from the stage RFL to determine the detail range.

| vertex colors =
* Color is multiplied into the <code>diffuse</code> texture color
* Alpha is multiplied into the <code>diffuse</code> texture alpha

| textures =
diffuse,0,0,
[[Hedgehog Engine 2 - Textures#Albedo|Albedo]],
[[Hedgehog_Engine_2_-_Physically_Based_Rendering_(PBR)#Albedo|Albedo]] color__,
[[Opacity|Opacity]];

specular,0,0,
[[Hedgehog Engine 2 - Textures#PRM|PRM]],
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Specular|Specular]] factor\; Gets multiplied by 0.25,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Smoothness|Smoothness]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Metallic|Metallic]] factor,
[[Hedgehog Engine 2 - Physically Based Rendering (PBR)#Ambient Occlusion|Ambient Occlusion]];

normal,0,0,
[[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
[[Normal_mapping|Normal map direction]]_,,;

normal,1,2,
Detail [[Hedgehog Engine 2 - Textures#Normal map|Normal map]],
[[Normal_mapping|Normal map direction]] that is [[Texture Blending#Normal map blending|blended]] into the <code>normal</code> texture based on camera distance_,,;

| parameters =

DetailFactor,
UV scale for the <code>normal[1]</code> texture,,,;

| features =
is_compute_instancing,
is_use_tex_srt_anim,
enable_alpha_threshold,
is_use_gi_prt,
is_use_gi_sg,
is_use_gi,

}}
== Gallery ==
<gallery perrow="4" widths="400px" heights="300px" mode="nolines">
File:ShadowGenerations Detail dpnn example.jpg|How <code>Detail_dpnn</code> is used for cliffs in Rail Canyon to blend in detail normals when the camera is closer to the surface
</gallery>

File:ShadowGenerations Detail dpnn example.jpg

2025-08-22T17:20:00Z

Justin113D:

An example for how the Detail_dpnn shader is used in Shadow Generations