--- title: Unity Shader Graph date: 2024-08-10 12:15:05 background: bg-[#7c7c7c] label: tags: - unity - shader - computer graphics - visual effects categories: - Programming intro: | This is a visual cheat-sheet for the Unity Shader Graph. This tool is used to create custom shaders material in Unity, a popular game engine. --- ## Shader Graph Nodes {.cols-2} We are using **SAIT** to indicate the output type is "same as the input type". {.col-span-2} ### Basic Nodes Position - provides vertex position {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | None | No inputs | - **Outputs** - |-|-| | -------- | ---------------------- | | `Vector3`| Provides vertex position| {.shortcuts .marker-round .cols-2} Normal - supplies surface normal direction {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | None | No inputs | - **Outputs** - |-|-| | -------- | ---------------------- | | `Vector3`| Provides surface normal | {.shortcuts .marker-round .cols-2} Time - outputs time values {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | None | No inputs | - **Outputs** - |-|-| | -------- | ---------------------- | | `Float` | Outputs time values | {.shortcuts .marker-round .cols-2} Multiply - multiplies two values {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | `Float`, `Vector`, `Matrix` | First value | | `Float`, `Vector`, `Matrix` | Second value| - **Outputs** - |-|-| | -------- | ---------------------- | | SAIT | The product of the two inputs | {.shortcuts .marker-round .cols-2} Lerp - linear interpolation between two values {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | `Float` | Start value | | `Float` | End value | | `Float` | Interpolation factor (T)| - **Outputs** - |-|-| | -------- | ---------------------- | | `Float` | Interpolated result | {.shortcuts .marker-round .cols-2} Step - creates a step between two thresholds {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | `Float` | Threshold | | `Float` | Input | - **Outputs** - |-|-| | -------- | ---------------------- | | `Float` | Step result | {.shortcuts .marker-round .cols-2} ### Math Nodes Add - adds two values {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | `Float` or `Vector` | First value | | `Float` or `Vector` | Second value | - **Outputs** - |-|-| | -------- | ---------------------- | | SAIT | Sum of the two inputs | {.shortcuts .marker-round .cols-2} Subtract - subtracts one value from another {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | `Float` or `Vector` | Minuend | | `Float` or `Vector` | Subtrahend | - **Outputs** - |-|-| | -------- | ---------------------- | | SAIT | Difference of the two inputs | {.shortcuts .marker-round .cols-2} Sin - outputs sine of input {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | `Float` | Input in radians | - **Outputs** - |-|-| | -------- | ---------------------- | | `Float` | Sine of the input | {.shortcuts .marker-round .cols-2} Cos - outputs cosine of input {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | `Float` | Input in radians | - **Outputs** - |-|-| | -------- | ---------------------- | | `Float` | Cosine of the input | {.shortcuts .marker-round .cols-2} Power - raises input to a power {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | `Float` | Base | | `Float` | Exponent | - **Outputs** - |-|-| | -------- | ---------------------- | | `Float` | Result of base raised to the power of the exponent | {.shortcuts .marker-round .cols-2} Sqrt - square root of input {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | `Float` | Input value | - **Outputs** - |-|-| | -------- | ---------------------- | | `Float` | Square root of the input | {.shortcuts .marker-round .cols-2} Abs - outputs absolute value {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | `Float` or `Vector` | Input value | - **Outputs** - |-|-| | -------- | ---------------------- | | SAIT | Absolute value of the input | {.shortcuts .marker-round .cols-2} ### Texture Nodes Sample Texture - retrieves color data from texture {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | Texture (sampler) | Texture input | | `Vector2` | UV coordinates | - **Outputs** - |-|-| | -------- | ---------------------- | | `Vector4` | Color data from the texture | {.shortcuts .marker-round .cols-2} UV - provides UV coordinates for texture mapping {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | None | No inputs | - **Outputs** - |-|-| | -------- | ---------------------- | | `Vector2` | UV coordinates | {.shortcuts .marker-round .cols-2} Tiling Offset - adjusts tiling and offset of texture {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | `Vector2` | Tiling values | | `Vector2` | Offset values | - **Outputs** - |-|-| | -------- | ---------------------- | | `Vector2` | Modified UV coordinates | {.shortcuts .marker-round .cols-2} ### Effects Nodes Fresnel Effect - creates a glow effect on object edges {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | `Vector3` | View direction | | `Float` | Power of the effect | - **Outputs** - |-|-| | -------- | ---------------------- | | `Float` | Fresnel effect value | {.shortcuts .marker-round .cols-2} Dissolve - generates a dissolve transition effect {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | Texture (sampler) | Input texture | | `Float` | Dissolve threshold | - **Outputs** - |-|-| | -------- | ---------------------- | | `Vector4` | Dissolve effect output | {.shortcuts .marker-round .cols-2} Distortion - warps the surface of the object {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | `Float` | Distortion strength | | `Vector2` | UV coordinates | - **Outputs** - |-|-| | -------- | ---------------------- | | `Vector2` | Warped UV coordinates | {.shortcuts .marker-round .cols-2} Reflection - reflects based on surface normal direction {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | `Vector3` | Incident direction | | `Vector3` | Surface normal | - **Outputs** - |-|-| | -------- | ---------------------- | | `Vector3` | Reflected direction | {.shortcuts .marker-round .cols-2} ### Advanced Nodes World Position - returns the object's world space position {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | None | No inputs | - **Outputs** - |-|-| | -------- | ---------------------- | | `Vector3` | World space position | {.shortcuts .marker-round .cols-2} Object Position - returns the object's local space position {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | None | No inputs | - **Outputs** - |-|-| | -------- | ---------------------- | | `Vector3` | Local space position | {.shortcuts .marker-round .cols-2} Screen Position - returns the object's screen space position {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | None | No inputs | - **Outputs** - |-|-| | -------- | ---------------------- | | `Vector4` | Screen space position | {.shortcuts .marker-round .cols-2} Parallax - simulates depth using parallax mapping {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | Texture (sampler) | Input texture | | `Vector2` | UV coordinates | | `Float` | Depth value | - **Outputs** - |-|-| | -------- | ---------------------- | | `Vector2` | Adjusted UV coordinates| {.shortcuts .marker-round .cols-2} Camera Position - returns the camera's world space position {.cols-2} - **Inputs** - |-|-| | -------- | ---------------------- | | None | No inputs | - **Outputs** - |-|-| | -------- | ---------------------- | | `Vector3` | Camera world space position | {.shortcuts .marker-round .cols-2} ### Custom Function Node #### Steps to Create a Custom Function Node: - **Add Custom Function Node** - Right-click in Shader Graph and choose **"Create Node"** > **"Custom Function"**. - **Configure the Node** - Set a name and choose between **"String"** (inline code) or **"File"** (external HLSL file). - **Add Inputs/Outputs**: Define inputs (e.g., float, vector) and outputs. Example: - **Inputs**: Float (time), Vector3 (position) - **Outputs**: Vector3 (new position) - **Write Shader Code**: Enter the custom HLSL code. Example: ```hlsl float3 CustomPosition(float time, float3 position) { return position + float3(sin(time), cos(time), 0.0); } ``` - **Use the Node**: Integrate the custom node into your shader graph. {.marker-timeline} ## Also see {.cols-1} - [Unity Shader Graph documentation](https://docs.unity3d.com/Manual/shader-graph-overview.html) _(docs.unity3d.com)_ - [Tianle Yuan's Unity Visual Effect notes](https://yuantianle.github.io/11_Game_Development/Unity/) _(yuantianle.com)_