[Port] [6000.4] Fixing Shader Graph Nodes Documentations Links

svc-reach-platform-support · Evergreen · commit 471fb8d17650 · 2025-12-12T15:02:07.000Z
diff --git a/Packages/com.unity.render-pipelines.high-definition/Editor/Material/ShaderGraph/Nodes/CustomPassNodes.cs b/Packages/com.unity.render-pipelines.high-definition/Editor/Material/ShaderGraph/Nodes/CustomPassNodes.cs
@@ -19,8 +19,6 @@ public CustomColorBufferNode()
             UpdateNodeAfterDeserialization();
         }
 
-        public override string documentationURL => NodeUtils.GetDocumentationString("HD-Custom-Color");
-
         const int kUvInputSlotId = 0;
         const string kUvInputSlotName = "UV";
 
diff --git a/Packages/com.unity.render-pipelines.high-definition/Editor/Material/ShaderGraph/Nodes/EmissionNode.cs b/Packages/com.unity.render-pipelines.high-definition/Editor/Material/ShaderGraph/Nodes/EmissionNode.cs
@@ -21,7 +21,7 @@ public EmissionNode()
             UpdateNodeAfterDeserialization();
         }
 
-        public override string documentationURL => Documentation.GetPageLink("SGNode-Emission");
+        public override string documentationURL => NodeUtils.GetDocumentationString("Emission");
 
         [SerializeField]
         EmissiveIntensityUnit _intensityUnit;
diff --git a/Packages/com.unity.render-pipelines.high-definition/Editor/Material/ShaderGraph/Nodes/ExposureNode.cs b/Packages/com.unity.render-pipelines.high-definition/Editor/Material/ShaderGraph/Nodes/ExposureNode.cs
@@ -36,8 +36,6 @@ public ExposureNode()
             UpdateNodeAfterDeserialization();
         }
 
-        public override string documentationURL => Documentation.GetPageLink("SGNode-Exposure");
-
         [SerializeField]
         ExposureType m_ExposureType;
         [EnumControl("Type")]
diff --git a/Packages/com.unity.render-pipelines.high-definition/Editor/Material/ShaderGraph/Nodes/FresnelEquationNode.cs b/Packages/com.unity.render-pipelines.high-definition/Editor/Material/ShaderGraph/Nodes/FresnelEquationNode.cs
@@ -33,8 +33,6 @@ class HDFresnelEquationNode : AbstractMaterialNode
 
         const string kFresnelOutputSlotName = "Fresnel";
 
-        public override string documentationURL => Documentation.GetPageLink("Fresnel-Equation-Node");
-
         private enum FresnelSlots
         {
             kDotVectorsInputSlotId,
diff --git a/Packages/com.unity.render-pipelines.high-definition/Editor/Material/ShaderGraph/Nodes/SurfaceGradientResolveNormal.cs b/Packages/com.unity.render-pipelines.high-definition/Editor/Material/ShaderGraph/Nodes/SurfaceGradientResolveNormal.cs
@@ -18,8 +18,6 @@ public SurfaceGradientResolveNormal()
             UpdateNodeAfterDeserialization();
         }
 
-        public override string documentationURL => Documentation.GetPageLink("SurfaceGradientResolveNormal");
-
         const int kNormalInputSlotId = 0;
         const string kNormalInputSlotName = "Normal";
 
diff --git a/Packages/com.unity.render-pipelines.universal/Editor/ShaderGraph/Nodes/UniversalSampleBufferNode.cs b/Packages/com.unity.render-pipelines.universal/Editor/ShaderGraph/Nodes/UniversalSampleBufferNode.cs
@@ -47,8 +47,6 @@ public BufferType bufferType
             }
         }
 
-        public override string documentationURL => Documentation.GetPageLink(Documentation.packageName, "SGNode-Universal-Sample-Buffer");
-
         public UniversalSampleBufferNode()
         {
             name = "URP Sample Buffer";
diff --git a/Packages/com.unity.shadergraph/Documentation~/Custom-Color-Buffer-Node.md b/Packages/com.unity.shadergraph/Documentation~/Custom-Color-Buffer-Node.md
@@ -1,4 +1,4 @@
-# Custom Color Node (HDRP)
+# Custom Color Buffer Node (HDRP)
 
 The Custom Color Node accesses the custom pass color buffer allocated by HDRP.
 
diff --git a/Packages/com.unity.shadergraph/Documentation~/Custom-Render-Texture-Self-Node.md b/Packages/com.unity.shadergraph/Documentation~/Custom-Render-Texture-Self-Node.md
diff --git a/Packages/com.unity.shadergraph/Documentation~/Custom-Render-Texture-Size-Node.md b/Packages/com.unity.shadergraph/Documentation~/Custom-Render-Texture-Size-Node.md
diff --git a/Packages/com.unity.shadergraph/Documentation~/Custom-Render-Texture.md.meta b/Packages/com.unity.shadergraph/Documentation~/Custom-Render-Texture.md.meta
diff --git a/Packages/com.unity.shadergraph/Documentation~/Custom-Texture-Self.md.meta b/Packages/com.unity.shadergraph/Documentation~/Custom-Texture-Self.md.meta
diff --git a/Packages/com.unity.shadergraph/Documentation~/Custom-Texture-Size.md.meta b/Packages/com.unity.shadergraph/Documentation~/Custom-Texture-Size.md.meta
diff --git a/Packages/com.unity.shadergraph/Documentation~/Custom-Texture-Slice.md.meta b/Packages/com.unity.shadergraph/Documentation~/Custom-Texture-Slice.md.meta
diff --git a/Packages/com.unity.shadergraph/Documentation~/Dropdown-Node.md b/Packages/com.unity.shadergraph/Documentation~/Dropdown-Node.md
@@ -0,0 +1,65 @@
+# Dropdown node
+
+The Dropdown node is a node representation of a Dropdown property. It allows you to create a custom dropdown menu on a Subgraph node in its parent Shader Graph. You can specify the number of options that appear in the dropdown menu, and their names.
+
+After you create a Dropdown property and add a Dropdown node to a Subgraph, the Subgraph node in any parent Shader Graph displays with a dropdown control:
+
+![An image of the Graph window, that displays a parent Shader Graph with a Subgraph node. The Subgraph node has a dropdown menu because the Subgraph has a Dropdown property and contains a Dropdown node.](images/sg-subgraph-dropdown-node-example.png)
+
+## Create Node menu category
+
+The Subgraph Dropdown node isn't accessible from the Create Node menu.
+
+To add a Subgraph Dropdown node to a Subgraph:
+
+1. In the Shader Graph window, open a Subgraph.
+
+2. In the Blackboard, select **Add** (+) and select **Dropdown**.
+
+3. Enter a name for your new Dropdown property, and press Enter.
+
+4. Select your Dropdown property and drag it onto your graph to create a new Subgraph Dropdown node.
+
+5. Select your new Dropdown node in your graph or the Dropdown property in the Blackboard and open the Graph Inspector.
+
+6. Select the **Node Settings** tab.
+
+7. In the **Entries** table, select **Add to the list** (+) to add a new option to your dropdown. Each Entry adds a corresponding input port to your node.
+    To remove an Entry, select its handle in the list and select **Remove selection from the list** (-).
+
+8. (Optional) In the **Default** list, select the default Entry that you want Shader Graph to select on your property.
+
+![An image of the Graph window, that displays a Dropdown node in the Graph Editor. The Dropdown property is selected in the Blackboard and the Graph Inspector shows the available options for configuring the Dropdown property.](images/sg-subgraph-dropdown-node.png)
+
+## Compatibility
+
+The Subgraph Dropdown [!include[nodes-compatibility-all](./snippets/nodes-compatibility-all.md)]    <!-- ALL PIPELINES INCLUDE  -->
+
+## Ports
+
+> [!NOTE]
+> The Subgraph Dropdown node's number of input ports and their names directly correspond to the settings you specify in the Graph Inspector's **Node Settings** tab. The node always has one output port.
+
+A Subgraph Dropdown node's input ports always have the **DynamicVector** type. This means that you can make a connection to an input port from any node that outputs a float, Vector 2, Vector 3, Vector 4, or Boolean value. For more information, see [Dynamic Data Types](Data-Types.md#dynamic-data-types).
+
+It has one output port:
+
+| **Name**     | **Type**      | **Description**  |
+| :---         | :-----------  |   :----------    |
+| Out          | DynamicVector |  The selected option from the dropdown menu on the parent Shader Graph's Subgraph node. This value can also be the specified **Default** for the property in the Graph Inspector's **Node Settings** tab.     |
+
+
+## Example graph usage
+
+In the following example, a Subgraph Dropdown node changes the UV channel it sends to the Subgraph's Output node. The selection on the Subgraph node in the parent graph changes whether the Subgraph outputs **UV1** or **UV0**. If the Subgraph is used in multiple Shader Graphs, the Subgraph Dropdown node can change the UV channel output without changing the Subgraph:
+
+![An image of the Graph window. The first input port on a Subgraph Dropdown node connects to a UV node and receives UV0. The second input port connects to a UV node and receives UV1. The Subgraph Dropdown node sends its output to the Subgraph's Output node.](images/sg-subgraph-dropdown-node-example-2.png)
+
+
+## Related nodes
+
+<!-- OPTIONAL. Any nodes that may be related to this node in some way that's worth mentioning -->
+
+[!include[nodes-related](./snippets/nodes-related.md)] Subgraph Dropdown node:
+
+- [Subgraph node](Sub-graph-Node.md)
diff --git a/Packages/com.unity.shadergraph/Documentation~/Material-Quality-Keyword-Node.md b/Packages/com.unity.shadergraph/Documentation~/Material-Quality-Keyword-Node.md
@@ -0,0 +1,13 @@
+# Material Quality Keyword node
+
+The Material Quality Keyword node adds and uses global keywords MATERIAL_QUALITY_HIGH, MATERIAL_QUALITY_MEDIUM and MATERIAL_QUALITY_LOW and enables different behaviors for each one of the available quality types.
+
+**Note**:
+* Adding this keyword increases the amount of shader variants.
+* These quality keywords are only available in URP and HDRP, they are not available at the Built-in Render Pipeline.
+
+To manually set the quality level from a C# script, use the `UnityEngine.Rendering.MaterialQualityUtilities.SetGlobalShaderKeywords(...)` function.
+
+## Additional resources:
+
+* [Keywords](Keywords.md)
diff --git a/Packages/com.unity.shadergraph/Documentation~/Property-Node.md b/Packages/com.unity.shadergraph/Documentation~/Property-Node.md
@@ -0,0 +1,3 @@
+# Property node
+
+Returns the value of the associated [Blackboard](Blackboard.md) Property.
diff --git a/Packages/com.unity.shadergraph/Documentation~/Raytracing-Quality-Keyword-Node.md b/Packages/com.unity.shadergraph/Documentation~/Raytracing-Quality-Keyword-Node.md
@@ -0,0 +1,11 @@
+# Raytracing Quality Keyword node
+
+**Note**:
+* Adding this keyword increases the amount of shader variants.
+* These quality keywords are only available in HDRP, they are not available with the Built-in and Universal Render Pipelines.
+
+Refer to `https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@17.4/manual/SGNode-Raytracing-Quality.html` for more information.
+
+## Additional resources:
+
+* [Keywords](Keywords.md)
diff --git a/Packages/com.unity.shadergraph/Documentation~/Redirect-Node.md b/Packages/com.unity.shadergraph/Documentation~/Redirect-Node.md
@@ -0,0 +1,8 @@
+# Redirect node
+
+Use redirect nodes to improve the graph's organization. They have no effect on the generated shader code.
+
+Redirect nodes don't appear in the node search. To add a redirect node, do one of the following:
+- Double click on a wire.
+- Right click on a wire and select **Add Redirect Node**.
+- Select a wire and press `Ctrl/Cmd + R` on the keyboard.
diff --git a/Packages/com.unity.shadergraph/Documentation~/Slice-Index-Cubemap-Face-Node.md b/Packages/com.unity.shadergraph/Documentation~/Slice-Index-Cubemap-Face-Node.md
@@ -1,4 +1,4 @@
-# Custom Render Texture Slice Node
+# Slice Index / Cubemap Face Node
 
 ## Description
 
diff --git a/Packages/com.unity.shadergraph/Documentation~/Sub-Graph-Dropdown-Node.md b/Packages/com.unity.shadergraph/Documentation~/Sub-Graph-Dropdown-Node.md
diff --git a/Packages/com.unity.shadergraph/Documentation~/TableOfContents.md b/Packages/com.unity.shadergraph/Documentation~/TableOfContents.md
@@ -87,10 +87,10 @@
         * [Split](Split-Node.md)
         * [Swizzle](Swizzle-Node.md)
     * [Custom Render Texture](Custom-Render-Texture-Nodes.md)
-        * [Self](Custom-Texture-Self.md)
-        * [Size](Custom-Texture-Size.md)
-        * [Slice](Custom-Texture-Slice.md)
-    * [Dropdowns](Sub-Graph-Dropdown-Node.md)
+        * [Self](Custom-Render-Texture-Self-Node.md)
+        * [Size](Custom-Render-Texture-Size-Node.md)
+        * [Slice](Slice-Index-Cubemap-Face-Node.md)
+    * [Dropdown](Dropdown-Node.md)
     * [Input](Input-Nodes.md)
         * Basic
             * [Boolean](Boolean-Node.md)
@@ -175,6 +175,8 @@
             * [Element Texture Size](element-texture-size-node.md)
             * [Element Texture UV](element-texture-uv-node.md)
     * [Keyword](Keyword-Node.md)
+        * [Material Quality](Material-Quality-Keyword-Node.md)
+        * [Raytracing Quality](Raytracing-Quality-Keyword-Node.md)
     * [Math](Math-Nodes.md)
         * Advanced
             * [Absolute](Absolute-Node.md)
@@ -267,6 +269,8 @@
             * [Rectangle](Rectangle-Node.md)
             * [Rounded Polygon](Rounded-Polygon-Node.md)
             * [Rounded Rectangle](Rounded-Rectangle-Node.md)
+    * [Property](Property-Node.md)
+    * [Redirect](Redirect-Node.md)
     * [SpeedTree](SpeedTree8-SubGraphAssets.md)
     * [Sub Graphs](Sub-graph-Node.md)
         * [UVCombine](UVCombine-Node.md)
diff --git a/Packages/com.unity.shadergraph/Editor/Data/Nodes/Input/PropertyNode.cs b/Packages/com.unity.shadergraph/Editor/Data/Nodes/Input/PropertyNode.cs
@@ -20,7 +20,7 @@ public PropertyNode()
         }
 
         // Property-Types
-        public override string documentationURL => UnityEngine.Rendering.ShaderGraph.Documentation.GetPageLink("Property-Types");
+        public override string documentationURL => UnityEngine.Rendering.ShaderGraph.Documentation.GetPageLink("Property-Node");
 
         public override void UpdateNodeAfterDeserialization()
         {
diff --git a/Packages/com.unity.shadergraph/Editor/Data/Nodes/Utility/CustomFunctionNode.cs b/Packages/com.unity.shadergraph/Editor/Data/Nodes/Utility/CustomFunctionNode.cs
@@ -21,6 +21,8 @@ class CustomFunctionNode : AbstractMaterialNode, IGeneratesBodyCode, IGeneratesF
 
         public override IEnumerable<int> allowedNodeVersions => new int[] { 1 };
 
+        public override string documentationURL => NodeUtils.GetDocumentationString("Custom Function");
+
         [Serializable]
         public class MinimalCustomFunctionNode : IHasDependencies
         {
diff --git a/Packages/com.unity.shadergraph/Editor/Data/Nodes/Utility/DropdownNode.cs b/Packages/com.unity.shadergraph/Editor/Data/Nodes/Utility/DropdownNode.cs
@@ -15,6 +15,8 @@ class DropdownNode : AbstractMaterialNode, IOnAssetEnabled, IGeneratesBodyCode,
         internal const int k_MinEnumEntries = 2;
         protected override bool CanPropagateFloatLiteral => true;
 
+        public override string documentationURL => NodeUtils.GetDocumentationString("Dropdown");
+
         public DropdownNode()
         {
             UpdateNodeAfterDeserialization();
diff --git a/Packages/com.unity.shadergraph/Editor/Data/Nodes/Utility/KeywordNode.cs b/Packages/com.unity.shadergraph/Editor/Data/Nodes/Utility/KeywordNode.cs
@@ -18,6 +18,13 @@ class KeywordNode : AbstractMaterialNode, IOnAssetEnabled, IGeneratesBodyCode, I
 
         protected override bool CanPropagateFloatLiteral => true;
 
+        public override string documentationURL => NodeUtils.GetDocumentationString(keyword.overrideReferenceName switch
+        {
+            "MATERIAL_QUALITY" => "Material Quality Keyword",
+            "RAYTRACING_SHADER_GRAPH" => "Raytracing Quality Keyword",
+            _ => "Keyword",
+        });
+
         public KeywordNode()
         {
             UpdateNodeAfterDeserialization();
diff --git a/Packages/com.unity.shadergraph/Editor/Data/Nodes/Utility/RedirectNodeData.cs b/Packages/com.unity.shadergraph/Editor/Data/Nodes/Utility/RedirectNodeData.cs
@@ -14,6 +14,8 @@ class RedirectNodeData : AbstractMaterialNode
 
         protected override bool CanPropagateFloatLiteral => true;
 
+        public override string documentationURL => NodeUtils.GetDocumentationString("Redirect");
+
         public RedirectNodeData()
         {
             name = "Redirect Node";
diff --git a/Packages/com.unity.shadergraph/Editor/Generation/Targets/CustomRenderTexture/CustomTextureSlice.cs b/Packages/com.unity.shadergraph/Editor/Generation/Targets/CustomRenderTexture/CustomTextureSlice.cs
@@ -21,6 +21,8 @@ public CustomTextureSlice()
             UpdateNodeAfterDeserialization();
         }
 
+        public override string documentationURL => NodeUtils.GetDocumentationString("Slice Index Cubemap Face");
+
         protected int[] validSlots => new[] { OutputSlotCubeFaceId, OutputSlot3DSliceId };
 
         public sealed override void UpdateNodeAfterDeserialization()

Original file line number	Diff line number	Diff line change
`@@ -19,8 +19,6 @@ public CustomColorBufferNode()`
`19`	`19`	`UpdateNodeAfterDeserialization();`
`20`	`20`	`}`
`21`	`21`
`22`		`- public override string documentationURL => NodeUtils.GetDocumentationString("HD-Custom-Color");`
`23`		`-`
`24`	`22`	`const int kUvInputSlotId = 0;`
`25`	`23`	`const string kUvInputSlotName = "UV";`
`26`	`24`
Original file line number	Diff line number	Diff line change
`@@ -21,7 +21,7 @@ public EmissionNode()`
`21`	`21`	`UpdateNodeAfterDeserialization();`
`22`	`22`	`}`
`23`	`23`
`24`		`- public override string documentationURL => Documentation.GetPageLink("SGNode-Emission");`
	`24`	`+ public override string documentationURL => NodeUtils.GetDocumentationString("Emission");`
`25`	`25`
`26`	`26`	`[SerializeField]`
`27`	`27`	`EmissiveIntensityUnit _intensityUnit;`
Original file line number	Diff line number	Diff line change
`@@ -36,8 +36,6 @@ public ExposureNode()`
`36`	`36`	`UpdateNodeAfterDeserialization();`
`37`	`37`	`}`
`38`	`38`
`39`		`- public override string documentationURL => Documentation.GetPageLink("SGNode-Exposure");`
`40`		`-`
`41`	`39`	`[SerializeField]`
`42`	`40`	`ExposureType m_ExposureType;`
`43`	`41`	`[EnumControl("Type")]`
Original file line number	Diff line number	Diff line change
`@@ -33,8 +33,6 @@ class HDFresnelEquationNode : AbstractMaterialNode`
`33`	`33`
`34`	`34`	`const string kFresnelOutputSlotName = "Fresnel";`
`35`	`35`
`36`		`- public override string documentationURL => Documentation.GetPageLink("Fresnel-Equation-Node");`
`37`		`-`
`38`	`36`	`private enum FresnelSlots`
`39`	`37`	`{`
`40`	`38`	`kDotVectorsInputSlotId,`
Original file line number	Diff line number	Diff line change
`@@ -18,8 +18,6 @@ public SurfaceGradientResolveNormal()`
`18`	`18`	`UpdateNodeAfterDeserialization();`
`19`	`19`	`}`
`20`	`20`
`21`		`- public override string documentationURL => Documentation.GetPageLink("SurfaceGradientResolveNormal");`
`22`		`-`
`23`	`21`	`const int kNormalInputSlotId = 0;`
`24`	`22`	`const string kNormalInputSlotName = "Normal";`
`25`	`23`
Original file line number	Diff line number	Diff line change
`@@ -47,8 +47,6 @@ public BufferType bufferType`
`47`	`47`	`}`
`48`	`48`	`}`
`49`	`49`
`50`		`- public override string documentationURL => Documentation.GetPageLink(Documentation.packageName, "SGNode-Universal-Sample-Buffer");`
`51`		`-`
`52`	`50`	`public UniversalSampleBufferNode()`
`53`	`51`	`{`
`54`	`52`	`name = "URP Sample Buffer";`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Custom Color Node (HDRP)`
	`1`	`+# Custom Color Buffer Node (HDRP)`
`2`	`2`
`3`	`3`	`The Custom Color Node accesses the custom pass color buffer allocated by HDRP.`
`4`	`4`