Shadow Generations Standard Shader Behaviors - Revision history

Justin113D: Added VAT information

2025-08-11T12:33:23Z

Added VAT information

← Older revision		Revision as of 12:33, 11 August 2025
Line 5:		Line 5:
	== Mesh Layers ==		== Mesh Layers ==

	Unless specified otherwise, a shader should have support for all 3 [[Mesh Layers\|mesh layers]]		''Unless specified otherwise, a shader should have support for all 3 [[Mesh Layers\|mesh layers]].''

	=== Punch-through ===		=== Punch-through ===
Line 69:		Line 69:
	Unfortunately, it is currently unknown how this is used.		Unfortunately, it is currently unknown how this is used.

	Unless specified otherwise, a shader should implement this.		''Unless specified otherwise, a shader should implement this.''

	=== Global Illumination ===		=== Global Illumination ===
Line 79:		Line 79:
	* Baked Ambient occlusion (AOGI)		* Baked Ambient occlusion (AOGI)

	Unless specified otherwise, a shader should have support for all types of GI.		''Unless specified otherwise, a shader should have support for all types of GI.''

	== Vertex Shader ==		== Vertex Shader ==
Line 97:		Line 97:
	}}		}}

	Unless specified otherwise, a (vertex-)shader should support billboard mode.		''Unless specified otherwise, a (vertex-)shader should support billboard mode.''

	=== Bone Weights ===		=== Bone Weights ===
Line 103:		Line 103:
	These make it possible to deform a model using a bone armature, like character models do. While this is usually limited to 4 weights per vertex, a model can use 8 weights by adding the boolean parameter <code>enable_max_bone_influences_8</code> to a material and setting it to <code>true</code>.		These make it possible to deform a model using a bone armature, like character models do. While this is usually limited to 4 weights per vertex, a model can use 8 weights by adding the boolean parameter <code>enable_max_bone_influences_8</code> to a material and setting it to <code>true</code>.

	Unless specified otherwise, a (vertex-)shader should support bone weights & 8-weights.		''Unless specified otherwise, a (vertex-)shader should support bone weights & 8-weights.''

	=== Multiple Tangents ===		=== Multiple Tangents ===
Line 109:		Line 109:
	Shaders with more than one normal map may support using a second set of normal-tangents, which is useful when using a different UV map for the second normal map that is "rotated" differently from the one used by the first normal map. This behavior is enabled by adding the boolean parameter <code>enable_multi_tangent_space</code> to a material and setting it to <code>true</code>.		Shaders with more than one normal map may support using a second set of normal-tangents, which is useful when using a different UV map for the second normal map that is "rotated" differently from the one used by the first normal map. This behavior is enabled by adding the boolean parameter <code>enable_multi_tangent_space</code> to a material and setting it to <code>true</code>.

	Whether this is available is specified per-shader.		''Whether this is available is specified per-shader.''

			=== Vertex Animation Textures ===

			Vertex animation textures (or short "<b>VAT</b>") are a technique that utilizes animation data stored in a texture per vertex to animate a vertex' position and normal direction.

			''Unless specified otherwise, a (vertex-)shader should support VATs.''

			==== Vertex Color VAT Direction ====

			There are 2 VAT modes, one of which uses vertex colors as an animation direction (though the specifics are currently not understood). Pixel shaders that otherwise use vertex colors usually check if the vertex colors are reserved by the VAT, and do not use them if that is the case.

			Some pixel shaders however, while the vertex shader supports VATs, do not check for whether the vertex color is used for VATs, which means that some shaders do not support this second VAT mode.

			''Unless specified otherwise, a pixel shader should check for this second VAT mode and not use vertex colors in that case.''

	== Other ==		== Other ==
Line 119:		Line 133:
	Unless specified, every (vertex-)shader should support instancing.		Unless specified, every (vertex-)shader should support instancing.

	If a shader is noted to not use instancing, then it could produce unexpected behavior, although a shader without instancing support has yet to be found.		<i>If a shader is noted to not use instancing, then it could produce unexpected behavior, although a shader without instancing support has yet to be found.</i>

	==== Compute instancing ====		==== Compute instancing ====
Line 125:		Line 139:
	A different type of instancing that allows for minor modifications to the visuals of a model per instance; Most shaders allow for HSV modifications to the albedo color, as well as separate, per-instance dithering.		A different type of instancing that allows for minor modifications to the visuals of a model per instance; Most shaders allow for HSV modifications to the albedo color, as well as separate, per-instance dithering.

	It is currently unknown whether this feature is used at all, especially since it has a very inconsistent implementation in the pixel shaders.		<i>It is currently unknown whether this feature is used at all, especially since it has a very inconsistent implementation in the pixel shaders.</i>

Justin113D: Filled out more TODOs

2025-08-10T20:00:22Z

Filled out more TODOs

← Older revision		Revision as of 20:00, 10 August 2025
Line 43:		Line 43:
	\|Subsurface Scattering (PBR)		\|Subsurface Scattering (PBR)
	\|Identical to the standard PBR model, with added subsurface scattering lighting.		\|Identical to the standard PBR model, with added subsurface scattering lighting.
			TODO: document how vertex colors are used
	\|-		\|-
	\|4		\|4
Line 48:		Line 49:
	\|Identical to the standard PBR model, with one exception: Reflections are rendered using with anisotropic distribution.		\|Identical to the standard PBR model, with one exception: Reflections are rendered using with anisotropic distribution.
	[[File:Anisotropic Reflections.png\|frame\|The left model uses standard reflections, while the model one the right uses anisotropic reflections]]		[[File:Anisotropic Reflections.png\|frame\|The left model uses standard reflections, while the model one the right uses anisotropic reflections]]
			TODO: document how vertex colors are used
	\|-		\|-
	\|5		\|5
Line 111:		Line 113:
	== Other ==		== Other ==

	=== ~~Subsurface Scattering~~ ===		=== Instancing ===

	~~TODO~~		By using instancing, a model can be rendered multiple times in the same call.

	~~=== Anisotropic Reflections ===~~		Unless specified, every (vertex-)shader should support instancing.

	~~TODO~~		If a shader is noted to not use instancing, then it could produce unexpected behavior, although a shader without instancing support has yet to be found.

	=== ~~Instancing~~ ===		==== Compute instancing ====

	~~TODO~~		A different type of instancing that allows for minor modifications to the visuals of a model per instance; Most shaders allow for HSV modifications to the albedo color, as well as separate, per-instance dithering.

	~~==== Compute~~ instancing ~~====~~

	~~TODO~~		It is currently unknown whether this feature is used at all, especially since it has a very inconsistent implementation in the pixel shaders.

Justin113D: formatting

2025-08-10T19:53:41Z

formatting

← Older revision		Revision as of 19:53, 10 August 2025
Line 61:		Line 61:
	\|		\|
	\|}		\|}


	=== Noise ===		=== Noise ===
Line 69:		Line 68:

	Unless specified otherwise, a shader should implement this.		Unless specified otherwise, a shader should implement this.


	=== Global Illumination ===		=== Global Illumination ===
Line 80:		Line 78:

	Unless specified otherwise, a shader should have support for all types of GI.		Unless specified otherwise, a shader should have support for all types of GI.


	== Vertex Shader ==		== Vertex Shader ==

Justin113D: First set of behaviors documented

2025-08-10T19:53:13Z

First set of behaviors documented

← Older revision		Revision as of 19:53, 10 August 2025
Line 3:		Line 3:
	Basically all material shaders in Shadow Generations follow a set of behaviors that can be assumed to be used unless specified otherwise		Basically all material shaders in Shadow Generations follow a set of behaviors that can be assumed to be used unless specified otherwise

	== ~~Render~~ Layers ==		== Mesh Layers ==

	~~TODO~~		Unless specified otherwise, a shader should have support for all 3 [[Mesh Layers\|mesh layers]]

			=== Punch-through ===

			Despite materials having an alpha clip threshold property, it is not used in any shader. Instead, the game uses a global threshold property that is always set to <code>0.5</code>.

			Similarly, [[Mesh Layers#dithering\|noise dither]] shaders always use a clip threshold of <code>0</code>.

	== Pixel Shader ==		== Pixel Shader ==

			These are standard behaviors for pixel shaders, the stage at which the color of a pixel gets determined.

	=== Shader Models ===		=== Shader Models ===
Line 53:		Line 61:
	\|		\|
	\|}		\|}


	=== Noise ===		=== Noise ===

	~~TODO~~		Many shaders implement a "noise" overlay and dither effect, internally referred to as <code>u_model_user_flag_0</code>.
			Unfortunately, it is currently unknown how this is used.

			Unless specified otherwise, a shader should implement this.


	=== Global Illumination ===		=== Global Illumination ===

	~~TODO~~		There are several types of global illumination (GI), most of which are mutually exclusive:

			* Baked lighting ("Just" GI) + baked shadows
			* Spherical Guassian GI (SGGI) + baked shadows
			* Baked Ambient occlusion (AOGI)

			Unless specified otherwise, a shader should have support for all types of GI.


	== Vertex Shader ==		== Vertex Shader ==

			These are standard behaviors for vertex shaders, the stage at which the position, color, etc. of a model-vertex gets determined.

	=== Billboards ===		=== Billboards ===

	TODO		By adding the <code>TrnsType</code> SCA parameter to a material and setting its value to <code>1</code>/<code>true</code>, you can enable billboard mode, making a model face the camera. Additionally, by adding the boolean parameter <code>u_enable_billboard_y</code> and setting it to <code>true</code> a model will only rotate around its Y axis.

			TODO: add gifs showing the effect

			{{Notice
			\| type=warn
			\| content=The default billboard mode is broken, and will incorrectly look at the camera when the model is rotated in any way.
			TODO: add gifs higlighting the glitch
			}}

			Unless specified otherwise, a (vertex-)shader should support billboard mode.

	=== Bone Weights ===		=== Bone Weights ===

	~~TODO~~		These make it possible to deform a model using a bone armature, like character models do. While this is usually limited to 4 weights per vertex, a model can use 8 weights by adding the boolean parameter <code>enable_max_bone_influences_8</code> to a material and setting it to <code>true</code>.

			Unless specified otherwise, a (vertex-)shader should support bone weights & 8-weights.

	=== Multiple Tangents ===		=== Multiple Tangents ===

	~~TODO~~		Shaders with more than one normal map may support using a second set of normal-tangents, which is useful when using a different UV map for the second normal map that is "rotated" differently from the one used by the first normal map. This behavior is enabled by adding the boolean parameter <code>enable_multi_tangent_space</code> to a material and setting it to <code>true</code>.

			Whether this is available is specified per-shader.

	== Other ==		== Other ==

Justin113D: Added new sections, all TODO

2025-08-10T19:22:50Z

Added new sections, all TODO

@@ Line 1: / Line 1: @@
-The majority of all shadow generations shaders make use of "shader models", which loosely determine how a shader interacts with lighting or more.
+[[Shadow Generations Shaders|Return to shaders list]]
 {| class="wikitable" width="90%" style="margin: auto;"
@@ Line 41: / Line 53: @@
+|
 |}

Justin113D: Justin113D moved page Shadow Generations Shader Models to Shadow Generations Standard Shader Behaviors: Page gains more info alongside the models

2025-08-10T19:13:08Z

Justin113D moved page Shadow Generations Shader Models to Shadow Generations Standard Shader Behaviors: Page gains more info alongside the models

← Older revision	Revision as of 19:13, 10 August 2025
(No difference)

Justin113D at 18:50, 7 August 2025

2025-08-07T18:50:08Z

← Older revision		Revision as of 18:50, 7 August 2025
Line 18:		Line 18:
	\|Standard (PBR)		\|Standard (PBR)
	\|The "default" shading model, which is used by the majority of all material shaders. It uses the standard [[Hedgehog Engine 2 - Physically Based Rendering (PBR)\|physically based rendering]] lighting model.		\|The "default" shading model, which is used by the majority of all material shaders. It uses the standard [[Hedgehog Engine 2 - Physically Based Rendering (PBR)\|physically based rendering]] lighting model.
			This shading model is also affected by [[Hedgehog_Engine_2_-_Weather\|weather effects]]
	\|-		\|-
	\|3		\|3

Justin113D: Improved formatting around the aniso image

2025-08-07T18:48:08Z

Improved formatting around the aniso image

← Older revision		Revision as of 18:48, 7 August 2025
Line 26:		Line 26:
	\|Anisotropic Reflections (PBR)		\|Anisotropic Reflections (PBR)
	\|Identical to the standard PBR model, with one exception: Reflections are rendered using with anisotropic distribution.		\|Identical to the standard PBR model, with one exception: Reflections are rendered using with anisotropic distribution.
	[[File:Anisotropic Reflections.png]]		[[File:Anisotropic Reflections.png\|frame\|The left model uses standard reflections, while the model one the right uses anisotropic reflections]]
	The left model uses standard reflections, while the model one the right uses anisotropic reflections
	\|-		\|-
	\|5		\|5

Justin113D: Created page with "The majority of all shadow generations shaders make use of "shader models", which loosely determine how a shader interacts with lighting or more. {| class="wikitable" width="90%" style="margin: auto;" |+ !Index !Name !Description |- |0 |Clear |Technically, this is the "no shader model" shader model, and so far no shader has been discovered that uses it. It is used to determine where to draw the skybox |- |1 |Unlit |These shaders do no interact with lighting at all, but..."

2025-08-07T18:47:04Z

Created page with "The majority of all shadow generations shaders make use of "shader models", which loosely determine how a shader interacts with lighting or more. {| class="wikitable" width="90%" style="margin: auto;" |+ !Index !Name !Description |- |0 |Clear |Technically, this is the "no shader model" shader model, and so far no shader has been discovered that uses it. It is used to determine where to draw the skybox |- |1 |Unlit |These shaders do no interact with lighting at all, but..."

New page

The majority of all shadow generations shaders make use of "shader models", which loosely determine how a shader interacts with lighting or more.

{| class="wikitable" width="90%" style="margin: auto;"
|+
!Index
!Name
!Description
|-
|0
|Clear
|Technically, this is the "no shader model" shader model, and so far no shader has been discovered that uses it. It is used to determine where to draw the skybox
|-
|1
|Unlit
|These shaders do no interact with lighting at all, but just render out the emission channel and use that as is. These shaders allow for custom lighting behavior.
|-
|2
|Standard (PBR)
|The "default" shading model, which is used by the majority of all material shaders. It uses the standard [[Hedgehog Engine 2 - Physically Based Rendering (PBR)|physically based rendering]] lighting model.
|-
|3
|Subsurface Scattering (PBR)
|Identical to the standard PBR model, with added subsurface scattering lighting.
|-
|4
|Anisotropic Reflections (PBR)
|Identical to the standard PBR model, with one exception: Reflections are rendered using with anisotropic distribution.
[[File:Anisotropic Reflections.png]]
The left model uses standard reflections, while the model one the right uses anisotropic reflections
|-
|5
|Unknown
|
|-
|6
|Unknown
|
|-
|7
|Unknown
|
|}