DOCG-7794 + DOCG-7793 Add Water Decal and PBR Sky shader graph for HDRP reference pages

Author: fatimah-f

Packages/com.unity.render-pipelines.high-definition/Documentation~/TableOfContents.md

@@ -427,19 +427,21 @@
     * [Shader Graph materials reference](shader-graph-materials-reference.md)
       * [Vertex context reference](vertex-context-reference.md)
       * [Fragment context reference](fragment-context-reference.md)
-      * [Hair Master Stack reference](hair-master-stack-reference.md)
-      * [Eye Master Stack reference](eye-master-stack-reference.md)
-      * [Fabric Master Stack reference](fabric-master-stack-reference.md)
-      * [Decal Master Stack reference](decal-master-stack-reference.md)
       * [Lit Master Stack reference](lit-master-stack-reference.md)
+      * [Decal Master Stack reference](decal-master-stack-reference.md)
+      * [Fabric Master Stack reference](fabric-master-stack-reference.md)
+      * [Eye Master Stack reference](eye-master-stack-reference.md)
+      * [Hair Master Stack reference](hair-master-stack-reference.md)
       * [Unlit Master Stack reference](unlit-master-stack-reference.md)
-      * [Fullscreen Master Stack reference](fullscreen-master-stack-reference.md)
       * [StackLit Master Stack reference](stacklit-master-stack-reference.md)
-      * [Canvas Master Stack reference](canvas-master-stack-reference.md)
+      * [Water Master Stack reference](master-stack-water.md)
+      * [Fullscreen Master Stack reference](fullscreen-master-stack-reference.md)
+      * [PBR Sky Master Stack reference](pbr-sky-master-stack-reference.md)
+      * [Water Decal Master Stack reference](water-decal-master-stack-reference.md)
       * [Fog Volume Master Stack reference](fog-volume-master-stack-reference.md)
       * [Six Way Master Stack reference](six-way-master-stack-reference.md)
-      * [Water Master Stack reference](master-stack-water.md)
-      * [Terrain Master Stack reference](terrain-master-stack-reference.md)
+      * [TerrainLit Master Stack reference](terrain-master-stack-reference.md)
+      * [Canvas Master Stack reference](canvas-master-stack-reference.md)
   * [Environmental effects reference](reference-environmental-effects.md)
     * [Sky reference](reference-sky.md)
       * [Gradient Sky Volume Override reference](gradient-sky-volume-override-reference.md)

Packages/com.unity.render-pipelines.high-definition/Documentation~/pbr-sky-master-stack-reference.md

@@ -0,0 +1,39 @@
+# PBR Sky Master Stack reference
+
+You can modify the properties of a Physically Based Rendering (PBR) Sky Shader Graph in the PBR Sky Master Stack.
+
+Refer to [Create a physically based sky](create-a-physically-based-sky.md) for more information.
+
+## Contexts
+
+[!include[](snippets/master-stacks-contexts-intro.md)]
+
+### Vertex Context
+
+The Vertex context represents the vertex stage of this shader. Unity executes any block you connect to this context in the vertex function of this shader. For more information, refer to [Master Stack](https://docs.unity3d.com/Packages/com.unity.shadergraph@16.0/manual/Master-Stack.html).
+
+Vertex blocks aren't compatible with the PBR Sky Master Stack.
+
+### Fragment Context
+
+Depending on the [Graph Settings](#graph-settings) you choose, the Fragment Context displays the following blocks.
+
+| **Property** | **Description** | **Setting Dependency** | **Default Value** |
+| ------------ | --------------- | ---------------------- | ----------------- |
+| **Space Color** | Sets the base color of the sky. | None. | `Color.black` |
+| **Ground Color** | Sets the diffuse color of the ground surface. | **Ground Shading** enabled. | `Color.white` |
+| **Ground Emission** | Sets the emissive color of the ground surface.  | **Ground Shading** enabled. | `Color.black` |
+| **Ground Smoothness** | Controls the specular reflection sharpness of the ground surface. Choose a high value for sharper, mirror-like reflections, or a low value to produce rougher, more diffuse reflections. | **Ground Shading** enabled. | 0.0 |
+| **Ground Normal (Tangent Space)** | Sets the ground normal in tangent space. | **Ground Shading** enabled and **Fragment Normal Space** set to **Tangent**. | `CoordinateSpace.Tangent` |
+| **Ground Normal (Object Space)** | Sets the ground normal in object space. | **Ground Shading** enabled and **Fragment Normal Space** set to **Object**. | `CoordinateSpace.Object` |
+| **Ground Normal (World Space)** | Sets the ground normal in world space. | **Ground Shading** enabled and **Fragment Normal Space** set to **World**. | `CoordinateSpace.World` |
+
+## Graph Settings
+
+Explore the shader graph settings you can use to customize the Fragment Context.
+
+| **Setting**  | **Description** | 
+| ------------ | --------------- | 
+| **Fragment Normal Space** | Specifies the coordinate space for the normal input in the Fragment Context. The options are:<ul><li>**Tangent**: Normals are relative to the mesh surface’s UV orientation.</li><li>**Object**: Normals are relative to the mesh’s local coordinate system.</li><li>**World**: Normals are relative to the global scene coordinate system.</li></ul>When you change this setting, Unity adds the corresponding **Normal** Block to the Fragment context. |
+| **Ground Shading** | Enables rendering of a physically based ground surface or horizon beneath the sky. When you enable this setting, Unity adds the **Ground Color**, **Ground Emission**, **Ground Smoothness**, and **Ground Normal** Blocks to the Fragment context. |
+| **Custom Editor GUI** | Renders a custom editor GUI in the Inspector window of the material. Enter the name of the GUI class in the field. A Custom Editor GUI class might replace default properties. For more information, refer to [Custom material Inspectors](custom-material-inspectors.md).|

Packages/com.unity.render-pipelines.high-definition/Documentation~/shader-graph-materials-reference.md

@@ -4,20 +4,23 @@ Learn about the properties and behavior of HDRP Shader Graph contexts and master
 
 | Page | Description |
 | - | - |
-|[Vertex convertext reference](vertex-context-reference.md)|Learn about the Shader Graph Vertex context and blocks you can use with it in HDRP.|
-|[Fragment context reference](fragment-context-reference.md)|Learn about the Fragment Vertex context and blocks you can use with it in HDRP.|
-|[Hair Master Stack reference](hair-master-stack-reference.md)|Properties and options in the Hair master stack.|
-|[Eye Master Stack reference](eye-master-stack-reference.md)|Properties and options in the Eye master stack.|
-|[Fabric Master Stack reference](fabric-master-stack-reference.md)|Properties and options in the Fabric master stack.|
-|[Decal Master Stack reference](decal-master-stack-reference.md)|Properties and options in the Decal master stack.|
-|[Lit Master Stack reference](lit-master-stack-reference.md)|Properties and options in the Lit master stack.|
-|[Unlit Master Stack reference](unlit-master-stack-reference.md)|Properties and options in the Unlit master stack.|
-|[Fullscreen Master Stack reference](fullscreen-master-stack-reference.md)|Properties and options in the Fullscreen master stack.|
-|[StackLit Master Stack reference](stacklit-master-stack-reference.md)|Properties and options in the StackLit master stack.|
-|[Canvas Master Stack reference](canvas-master-stack-reference.md)|Properties and options in the Canvas master stack.|
-|[Fog Volume Master Stack reference](fog-volume-master-stack-reference.md)|Properties and options in the Fog Volume master stack.|
-|[Six Way Master Stack reference](six-way-master-stack-reference.md)|Properties and options in the Six Way master stack.|
-|[Terrain Master Stack reference](terrain-master-stack-reference.md)|Properties and options in the Terrain master stack.|
+| [Vertex context reference](vertex-context-reference.md) | Learn about the Shader Graph Vertex context and blocks you can use with it in HDRP. |
+| [Fragment context reference](fragment-context-reference.md) | Learn about the Fragment context and blocks you can use with it in HDRP. |
+| [Lit Master Stack reference](lit-master-stack-reference.md) | Properties and options in the Lit master stack. |
+| [Decal Master Stack reference](decal-master-stack-reference.md) | Properties and options in the Decal master stack. |
+| [Fabric Master Stack reference](fabric-master-stack-reference.md) | Properties and options in the Fabric master stack. |
+| [Eye Master Stack reference](eye-master-stack-reference.md) | Properties and options in the Eye master stack. |
+| [Hair Master Stack reference](hair-master-stack-reference.md) | Properties and options in the Hair master stack. |
+| [Unlit Master Stack reference](unlit-master-stack-reference.md) | Properties and options in the Unlit master stack. |
+| [StackLit Master Stack reference](stacklit-master-stack-reference.md) | Properties and options in the StackLit master stack. |
+| [Water Master Stack reference](master-stack-water.md) | Properties and options in the Water master stack. |
+| [Fullscreen Master Stack reference](fullscreen-master-stack-reference.md) | Properties and options in the Fullscreen master stack. |
+| [PBR Sky Master Stack reference](pbr-sky-master-stack-reference.md) | Properties and options in the PBR Sky master stack. |
+| [Water Decal Master Stack reference](water-decal-master-stack-reference.md) | Properties and options in the Water Decal master stack. |
+| [Fog Volume Master Stack reference](fog-volume-master-stack-reference.md) | Properties and options in the Fog Volume master stack. |
+| [Six Way Master Stack reference](six-way-master-stack-reference.md) | Properties and options in the Six Way master stack. |
+| [TerrainLit Master Stack reference](terrain-master-stack-reference.md) | Properties and options in the TerrainLit master stack. |
+| [Canvas Master Stack reference](canvas-master-stack-reference.md) | Properties and options in the Canvas master stack. |
 
 ## Additional resources
 

Packages/com.unity.render-pipelines.high-definition/Documentation~/snippets/master-stacks-contexts-intro.md

@@ -1,3 +1,3 @@
 This Master Stack material type has its own set of Graph Settings. Because of the relationship between settings and Blocks, this has consequences on which Blocks are relevant to the Graph. This section contains information on the Blocks this Master Stack material type adds by default, and which Blocks set properties for this Master Stack material type's Graph Settings.
 
-For more information about the relationship between Graph Settings and Blocks, see [Contexts and Blocks](../understand-shader-graph-in-hdrp.md).
+For more information about the relationship between Graph Settings and Blocks, refer to [Contexts and Blocks](../understand-shader-graph-in-hdrp.md).

Packages/com.unity.render-pipelines.high-definition/Documentation~/terrain-master-stack-reference.md

@@ -1,4 +1,4 @@
-# Terrain Master Stack reference
+# TerrainLit Master Stack reference
 
 You can modify the properties of a Terrain shader graph in the Terrain Master Stack.
 

Packages/com.unity.render-pipelines.high-definition/Documentation~/water-decal-master-stack-reference.md

@@ -0,0 +1,49 @@
+# Water Decal Master Stack reference
+
+You can modify the properties of a Water Decal Shader Graph in the Water Decal Master Stack.
+
+Refer to [Water Decals](introduction-to-water-decals.md) for more information.
+
+## Contexts
+
+[!include[](snippets/master-stacks-contexts-intro.md)]
+
+### Vertex Context
+
+The Vertex context represents the vertex stage of this shader. Unity executes any block you connect to this context in the vertex function of this shader. For more information, refer to [Master Stack](https://docs.unity3d.com/Packages/com.unity.shadergraph@16.0/manual/Master-Stack.html).
+
+Vertex blocks aren't compatible with the Water Decal Master Stack.
+
+### Fragment Context
+
+Depending on the [Graph Settings](#graph-settings) you choose, the Fragment Context displays the following blocks.
+
+| **Property** | **Description** | **Setting Dependency** | **Default Value** |
+| ------------ | --------------- | ---------------------- | -------------- |
+| **Deformation** | Sets height offset in the decal area to simulate surface displacement. | **Affect Deformation** enabled. | 0.0 |
+| **Horizontal Deformation** | Sets the horizontal offset in UV space to simulate water flow direction. | **Affect Deformation** enabled. | (0,0) |
+| **SurfaceFoam** | Sets the foam intensity on the water surface in the decal area. | **Affect Foam** enabled. | 0.0 |
+| **DeepFoam** | Sets the foam intensity for deeper water zones in the decal area. | **Affect Foam** enabled. | 0.0 |
+| **SimulationMask** | Sets the mask that defines areas affected by water simulation (for example, waves and currents). | **Affect Simulation** enabled. | (1,1,1) |
+| **SimulationFoamMask** | Sets the mask that defines areas where simulation-generated foam appears. | **Affect Foam** enabled. | 1.0 |
+| **LargeCurrent** | Defines large-scale water current direction and strength. | **Affect Large Current** enabled. | (0,0) |
+| **LargeCurrentInfluence** | Controls how much the large current affects the decal area. | **Affect Large Current** enabled. | 1.0 |
+| **RipplesCurrent** | Defines small ripple current direction and strength. | **Affect Ripples Current** enabled. |  (0,0) |
+| **RipplesCurrentInfluence** | Controls how much ripple currents affect the decal area. | **Affect Ripples Current** enabled. | 1.0 |
+
+## Graph Settings
+
+Explore the shader graph settings you can use to customize the Fragment Context.
+
+| **Setting**  | **Description** | 
+| ------------ | --------------- | 
+| **Affect Deformation** | Enables customizing deformation-related properties. When you enable this setting, Unity adds the **Deformation** and **Horizontal Deformation** Blocks to the Fragment context. |
+| **Affect Foam** | Enables customizing foam-related properties. When you enable this setting, Unity adds the **SurfaceFoam** and **DeepFoam** Blocks to the Fragment context. |
+| **Affect Simulation Mask** | Enables customizing simulation-related properties. When you enable this setting, Unity adds the **SimulationMask** and **SimulationFoamMask** Blocks to the Fragment context. |
+| **Affect Large Current** | Enables customizing current-related properties. When you enable this setting, Unity adds the **LargeCurrent** and **LargeCurrentInfluence** Blocks to the Fragment context. |
+| **Affect Ripples Current** | Enables customizing ripple-related properties. When you enable this setting, Unity adds the **RipplesCurrent** and **RipplesCurrentInfluence** Blocks to the Fragment context. |
+| **Custom Editor GUI** | Renders a custom editor GUI in the Inspector window of the material. Enter the name of the GUI class in the field. A Custom Editor GUI class might replace default properties. For more information, refer to [Custom material Inspectors](custom-material-inspectors.md).|
+
+## Additional resources
+
+- [Water surface fluctuations](water-decals-masking-landing.md)