Renamed Texel Size node to Texture Size and added texel size outputs (#6315)

* Renamed the Texel Size node to Texture Size and added texel size output ports

Previously, the Texel Size node was actually returning the texture size - so I've renamed the node to reflect that.  I also added two new output ports to the node so that in addition to outputing the texture size, it also outputs the texel size.

* Changed file name of Texel Size Node to Texture Size Node and made some consistency changes.

* Updated the documentation based on Chris's feedback

Made Chris's suggested changes to the documentation

* Updated node thumbnail and removed an extra period from the documentation

* Added the definition of Texel to the documentation

Co-authored-by: sarah.welton <[email protected]>

Author: bencloward

com.unity.shadergraph/CHANGELOG.md

@@ -26,6 +26,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 ### Changed
  - Changed the title suffix on old nodes and properties rom "Deprecated" to "Legacy".
  - Updated searcher package dependency version to 4.9.1
+ - Renamed the Shader Graph Texel Size node to Texture Size and added two additional output ports that actually output the texel size in addition to the texture size.
 
 ### Fixed
  - Fixed a usability issue where in some cases searcher would suggest one collapsed category of results that user would have to manually expand anyway

com.unity.shadergraph/Documentation~/Input-Nodes.md

@@ -107,8 +107,8 @@
 |[**Sample Texture 3D**](Sample-Texture-3D-Node.md)| [**Sample Virtual Texture**](Sample-Virtual-Texture-Node.md) |
 |![Image](images/SampleTexture3DNodeThumb.png)| ![image](images/SampleVirtualTextureNodeThumb.png) |
 |Samples a Texture 3D and returns a color value for use in the shader.| Samples a Virtual Texture and returns color values for use in the shader.|
-|[**Sampler State**](Sampler-State-Node.md)|[**Texel Size**](Texel-Size-Node.md)|
-|![Image](images/SamplerStateNodeThumb.png)|![Image](images/TexelSizeNodeThumb.png)|
+|[**Sampler State**](Sampler-State-Node.md)|[**Texture Size**](Texture-Size-Node.md)|
+|![Image](images/SamplerStateNodeThumb.png)|![Image](images/TexelSizeNodeThumb.png) <!-- Add updated image -->|
 |Defines a Sampler State for sampling textures.|Returns the Width and Height of the texel size of Texture 2D input.|
 |[**Texture 2D Array Asset**](Texture-2D-Array-Asset-Node.md)|[**Texture 2D Asset**](Texture-2D-Asset-Node.md)|
 |![Image](images/Texture2DArrayAssetNodeThumb.png)|![Image](images/Texture2DAssetNodeThumb.png)|

com.unity.shadergraph/Documentation~/TableOfContents.md

@@ -137,10 +137,10 @@
             * [Sample Virtual Texture](Sample-Virtual-Texture-Node)
             * [Sampler State](Sampler-State-Node)
             * [Split Texture Transform](Split-Texture-Transform-Node)
-            * [Texel Size](Texel-Size-Node)
             * [Texture 2D Array Asset](Texture-2D-Array-Asset-Node)
             * [Texture 2D Asset](Texture-2D-Asset-Node)
             * [Texture 3D Asset](Texture-3D-Asset-Node)
+            * [Texture Size](Texture-Size-Node)
     * [Math](Math-Nodes)
         * Advanced
             * [Absolute](Absolute-Node)

com.unity.shadergraph/Documentation~/Texel-Size-Node.md

@@ -0,0 +1,44 @@
+# Texture Size Node
+
+The Texture Size node takes a Texture 2D input and returns the width and height texel resolution of the texture. It also returns the width and height size of each texel of the texture. The node uses the built in variable `{texturename}_TexelSize` to access the special properties of the given Texture 2D input.
+
+The term "texel" is short for "texture element" or "texture pixel." It represents a single pixel in the texture.  So, for example, if Texture resolution is 512x512 texels, the texture is sampled over the range [0-1] in UV space,  so each texel is 1/512 x 1/512 in size in UV coordinates.
+
+<!-- ![](images/) Add image of node-->
+
+If you experience texture sampling errors while using this node in a graph which includes Custom Function Nodes or Sub Graphs, you can resolve them by upgrading your version of Shader Graph to version 10.3 or later.
+
+> [!NOTE]
+> Don't use the default input to reference your **Texture 2D**, as this affects the performance of your graph. Connect a [Texture 2D Asset Node](Texture-2D-Asset-Node.md) to the Texture Size node's Texture input port and re-use this definition for sampling.
+
+## Create Node menu category
+
+The Texture Size node is under the **Input** &gt; **Texture** category in the Create Node menu.
+
+## Compatibility
+
+The Texture Size node is compatible with all render pipelines.
+
+## Ports
+
+| Name         | Direction | Type     | Binding | Description |
+|:------------ |:----------|:---------|:--------|:------------|
+| Texture      | Input     | Texture  | None    | The Texture 2D asset to measure. |
+| Width        | Output    | Float    | None    | The width of the Texture 2D asset in texels. |
+| Height       | Output    | Float    | None    | The height of the Texture 2D asset in texels. |
+| Texel Width  | Output    | Float    | None    | The texel width of the Texture 2D asset in UV coordinates. |
+| Texel Height | Output    | Float    | None    | The texel height of the Texture 2D asset in UV coordinates. |
+
+
+<!-- ## Example graph usage -->
+
+<!-- Add example usage of node -->
+
+## Generated Code Example
+
+The following example code represents one possible outcome of this node.
+
+```
+float _TexelSize_Width = Texture_TexelSize.z;
+float _TexelSize_Height = Texture_TexelSize.w;
+```

com.unity.shadergraph/Documentation~/Texture-Size-Node.md

@@ -6,38 +6,46 @@
 
 namespace UnityEditor.ShaderGraph
 {
-    [Title("Input", "Texture", "Texel Size")]
+    [Title("Input", "Texture", "Texture Size")]
     class Texture2DPropertiesNode : AbstractMaterialNode, IGeneratesBodyCode, IMayRequireMeshUV
     {
         public const int OutputSlotWId = 0;
         public const int OutputSlotHId = 2;
+        public const int OutputSlotTWId = 3;
+        public const int OutputSlotTHId = 4;
         public const int TextureInputId = 1;
         const string kOutputSlotWName = "Width";
         const string kOutputSlotHName = "Height";
+        const string kOutputSlotTWName = "Texel Width";
+        const string kOutputSlotTHName = "Texel Height";
         const string kTextureInputName = "Texture";
 
         public override bool hasPreview { get { return false; } }
 
         public Texture2DPropertiesNode()
         {
-            name = "Texel Size";
-            synonyms = new string[] { "texture size" };
+            name = "Texture Size";
+            synonyms = new string[] { "texel size" };
             UpdateNodeAfterDeserialization();
         }
 
         public sealed override void UpdateNodeAfterDeserialization()
         {
             AddSlot(new Vector1MaterialSlot(OutputSlotWId, kOutputSlotWName, kOutputSlotWName, SlotType.Output, 0, ShaderStageCapability.All));
             AddSlot(new Vector1MaterialSlot(OutputSlotHId, kOutputSlotHName, kOutputSlotHName, SlotType.Output, 0, ShaderStageCapability.All));
+            AddSlot(new Vector1MaterialSlot(OutputSlotTWId, kOutputSlotTWName, kOutputSlotTWName, SlotType.Output, 0, ShaderStageCapability.All));
+            AddSlot(new Vector1MaterialSlot(OutputSlotTHId, kOutputSlotTHName, kOutputSlotTHName, SlotType.Output, 0, ShaderStageCapability.All));
             AddSlot(new Texture2DInputMaterialSlot(TextureInputId, kTextureInputName, kTextureInputName));
-            RemoveSlotsNameNotMatching(new[] { OutputSlotWId, OutputSlotHId, TextureInputId });
+            RemoveSlotsNameNotMatching(new[] { OutputSlotWId, OutputSlotHId, OutputSlotTWId, OutputSlotTHId, TextureInputId });
         }
 
         // Node generations
         public virtual void GenerateNodeCode(ShaderStringBuilder sb, GenerationMode generationMode)
         {
             sb.AppendLine(string.Format("$precision {0} = {1}.texelSize.z;", GetVariableNameForSlot(OutputSlotWId), GetSlotValue(TextureInputId, generationMode)));
             sb.AppendLine(string.Format("$precision {0} = {1}.texelSize.w;", GetVariableNameForSlot(OutputSlotHId), GetSlotValue(TextureInputId, generationMode)));
+            sb.AppendLine(string.Format("$precision {0} = {1}.texelSize.x;", GetVariableNameForSlot(OutputSlotTWId), GetSlotValue(TextureInputId, generationMode)));
+            sb.AppendLine(string.Format("$precision {0} = {1}.texelSize.y;", GetVariableNameForSlot(OutputSlotTHId), GetSlotValue(TextureInputId, generationMode)));
         }
 
         public bool RequiresMeshUV(UVChannel channel, ShaderStageCapability stageCapability)