19 KiB
title, date, background, label, tags, categories, intro
| title | date | background | label | tags | categories | intro | |||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Unity Shader Graph | 2024-08-10 12:15:05 | bg-[#7c7c7c] |
|
|
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
We are using SAIT to indicate the output type is "same as the input type". {.col-span-2}
1. Attributes
Positioning
Position - provides vertex position
-
Inputs
-
- - / No inputs
{.left-text}
-
-
Outputs
-
- - Vector3Provides vertex position
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Normal - supplies surface normal direction
-
Inputs
-
- - / No inputs
{.left-text}
-
-
Outputs
-
- - Vector3Provides surface normal
{.left-text}
-
{.shortcuts .marker-round .cols-2}
World Position - returns the object's world space position
-
Inputs
-
- - / No inputs
{.left-text}
-
-
Outputs
-
- - Vector3World space position
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Object Position - returns the object's local space position
-
Inputs
-
- - / No inputs
{.left-text}
-
-
Outputs
-
- - Vector3Local space position
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Screen Position - returns the object's screen space position
-
Inputs
-
- - / No inputs
{.left-text}
-
-
Outputs
-
- - Vector4Screen space position
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Camera Position - returns the camera's world space position
-
Inputs
-
- - / No inputs
{.left-text}
-
-
Outputs
-
- - Vector3Camera world space position
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Timing
Time - outputs various time-related values
-
Inputs
-
- - / No inputs
{.left-text}
-
-
Outputs
-
- - FloatTime (T) - The total elapsed time since the start of the shader FloatSin Time (T/8π) - A sine wave based on time FloatCos Time (T/8π) - A cosine wave based on time FloatDelta Time - Time passed between the previous frame and the current frame
{.left-text}
-
{.shortcuts .marker-round .cols-2}
2. Math Operations
Basic Math
Add - adds two values
-
Inputs
-
- - Float
VectorFirst value Float
VectorSecond value
{.left-text}
-
-
Outputs
-
- - SAIT Sum of the two inputs
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Subtract - subtracts one value from another
-
Inputs
-
- - Float
VectorMinuend Float
VectorSubtrahend
{.left-text}
-
-
Outputs
-
- - SAIT Difference of the two inputs
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Multiply - multiplies two values
-
Inputs
-
- - Float
Vector
MatrixFirst value Float
Vector
MatrixSecond value
{.left-text}
-
-
Outputs
-
- - SAIT The product of the two inputs
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Advanced Math
Power - raises input to a power
-
Inputs
-
- - FloatBase FloatExponent
{.left-text}
-
-
Outputs
-
- - FloatResult of base raised to the power of the exponent
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Sqrt - square root of input
-
Inputs
-
- - FloatInput value
{.left-text}
-
-
Outputs
-
- - FloatSquare root of the input
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Abs - outputs absolute value
-
Inputs
-
- - Float
VectorInput value
{.left-text}
-
-
Outputs
-
- - SAIT Absolute value of the input
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Dot Product - calculates dot product between two vectors
-
Inputs
-
- - Vector3
Vector4First vector Vector3
Vector4Second vector
{.left-text}
-
-
Outputs
-
- - FloatDot product result
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Cross Product - calculates cross product between two vectors
-
Inputs
-
- - Vector3First vector Vector3Second vector
{.left-text}
-
-
Outputs
-
- - Vector3Cross product result
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Trigonometry
Sin - outputs sine of input
-
Inputs
-
- - FloatInput in radians
{.left-text}
-
-
Outputs
-
- - FloatSine of the input
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Cos - outputs cosine of input
-
Inputs
-
- - FloatInput in radians
{.left-text}
-
-
Outputs
-
- - FloatCosine of the input
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Interpolation
Lerp - linear interpolation between two values
-
Inputs
-
- - Float
VectorStart value Float
VectorEnd value Float
VectorInterpolation factor (T)
{.left-text}
-
-
Outputs
-
- - SAIT Interpolated result
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Step - creates a step between two thresholds
-
Inputs
-
- - Float
VectorThreshold Float
VectorInput
{.left-text}
-
-
Outputs
-
- - SAIT Step result
{.left-text}
-
{.shortcuts .marker-round .cols-2}
3. Color Processing
Basic Color Manipulation
Color - provides a constant color value
-
Inputs
-
- - / No inputs
{.left-text}
-
-
Outputs
-
- - Vector4RGBA color value
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Add Color - adds two color values
-
Inputs
-
- - Vector4First color Vector4Second color
{.left-text}
-
-
Outputs
-
- - Vector4Sum of the two colors
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Multiply Color - multiplies two color values
-
Inputs
-
- - Vector4First color Vector4Second color
{.left-text}
-
-
Outputs
-
- - Vector4Product of the two colors
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Lerp Color - interpolates between two colors
-
Inputs
-
- - Vector4Start color Vector4End color FloatInterpolation factor (T)
{.left-text}
-
-
Outputs
-
- - Vector4Interpolated color
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Color Adjustment
Saturation - adjusts the saturation of input color
-
Inputs
-
- - Vector4Input color FloatSaturation factor
{.left-text}
-
-
Outputs
-
- - Vector4Adjusted color
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Contrast - adjusts contrast of input color
-
Inputs
-
- - Vector4Input color FloatContrast factor
{.left-text}
-
-
Outputs
-
- - Vector4Adjusted color
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Hue - shifts the hue of the input color
-
Inputs
-
- - Vector4Input color FloatHue shift amount
{.left-text}
-
-
Outputs
-
- - Vector4Color with shifted hue
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Invert Colors - inverts the input color
-
Inputs
-
- - Vector4Input color
{.left-text}
-
-
Outputs
-
- - Vector4Inverted color
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Replace Color - replaces a specific color in the input with a new color
-
Inputs
-
- - Vector4Input color Vector4Target color Vector4Replacement color
{.left-text}
-
-
Outputs
-
- - Vector4Color with replaced values
{.left-text}
-
{.shortcuts .marker-round .cols-2}
White Balance - adjusts the white balance of input color
-
Inputs
-
- - Vector4Input color FloatTemperature value FloatTint value
{.left-text}
-
-
Outputs
-
- - Vector4Adjusted color
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Channel Operations
Channel Mixer - modifies color channels independently
-
Inputs
-
- - Vector4Input color FloatRed channel multiplier FloatGreen channel multiplier FloatBlue channel multiplier
{.left-text}
-
-
Outputs
-
- - Vector4Modified color
{.left-text}
-
{.shortcuts .marker-round .cols-2}
4. Texture Processing
Sampling
Sample Texture - retrieves color data from texture
-
Inputs
-
- - Texture (sampler)Texture input Vector2UV coordinates
{.left-text}
-
-
Outputs
-
- - Vector4Color data from the texture
{.left-text}
-
{.shortcuts .marker-round .cols-2}
UV - provides UV coordinates for texture mapping
-
Inputs
-
- - / No inputs
{.left-text}
-
-
Outputs
-
- - Vector2UV coordinates
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Manipulation
Tiling Offset - adjusts tiling and offset of texture
-
Inputs
-
- - Vector2Tiling values Vector2Offset values
{.left-text}
-
-
Outputs
-
- - Vector2Modified UV coordinates
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Distortion - warps the surface of the object
-
Inputs
-
- - FloatDistortion strength Vector2UV coordinates
{.left-text}
-
-
Outputs
-
- - Vector2Warped UV coordinates
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Parallax - simulates depth using parallax mapping
-
Inputs
-
- - Texture (sampler) Input texture Vector2UV coordinates FloatDepth value
{.left-text}
-
-
Outputs
-
- - Vector2Adjusted UV coordinates
{.left-text}
-
{.shortcuts .marker-round .cols-2}
5. Effects
Visual Effects
Fresnel Effect - creates a glow effect on object edges
-
Inputs
-
- - Vector3View direction FloatPower of the effect
{.left-text}
-
-
Outputs
-
- - FloatFresnel effect value
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Dissolve - generates a dissolve transition effect
-
Inputs
-
- - Texture (sampler)Input texture FloatDissolve threshold
{.left-text}
-
-
Outputs
-
- - Vector4Dissolve effect output
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Reflection
Reflection - reflects based on surface normal direction
-
Inputs
-
- - Vector3Incident direction Vector3Surface normal
{.left-text}
-
-
Outputs
-
- - Vector3Reflected direction
{.left-text}
-
{.shortcuts .marker-round .cols-2}
Custom Function Node
Steps to Create a Custom Function Node
-
Step 1: Add Custom Function Node in Shader Graph
- Right-click in Shader Graph and choose "Create Node" > "Custom Function".
- Choose between "String" (for inline HLSL code) or "File" (for an external HLSL file).
-
Step 2: Configure the Node in Shader Graph
-
Set the name of the node.
-
If using "File", ensure the external HLSL file name exactly matches the function name defined in the HLSL file. This ensures the function is correctly referenced in the Shader Graph pipeline.
Example: If the file is named
CustomFunction.hlsl, the function inside it should also be namedCustomFunction.
-
-
Step 3: Add Inputs/Outputs in Shader Graph
-
Define the required
InputsandOutputsfor the custom function in Shader Graph. These will automatically generate ports for you to connect other nodes.Example:
- Inputs:
Float(time),Vector3(position) - Outputs:
Vector3(new position)
In the custom HLSL code, the
inandoutparameters correspond to these inputs and outputs:inrepresents the data coming into the function (e.g.,time,position).outdefines the return value (e.g., modifiedposition).
- Inputs:
-
-
Step 4: Write HLSL Code
-
If using the "String" option:
-
Directly write the HLSL code inside the custom function node editor in Shader Graph.
-
Ensure that the
inandoutparameters match the inputs and outputs you defined in Shader Graph. -
Example of inline code (using "String" mode):
float3 CustomPosition(in float time, in float3 position, out float3 newPosition) { newPosition = position + float3(sin(time), cos(time), 0.0); return newPosition; }
-
-
If using the "File" option:
-
Write the HLSL code in an external
.hlslfile and reference the file in Shader Graph. -
Example of an external HLSL file (using "File" mode):
-
1. Create an HLSL file named
CustomPosition.hlsl. -
2. Write the custom function inside the file. The
inandoutparameters should match the Shader Graph inputs and outputs.
float3 CustomPosition(in float time, in float3 position, out float3 newPosition) { newPosition = position + float3(sin(time), cos(time), 0.0); return newPosition; }-
3. Save the file in your project directory, for example,
Assets/Shaders/CustomPosition.hlsl. -
4. Link the file in Shader Graph:
- In the Custom Function Node, switch to "File" mode and reference
CustomPosition.hlsl.
-
-
-
-
Step 5: Use the Node in Shader Graph
-
Connect the custom function node’s input ports to other nodes, such as
TimeandPosition, to feed data into the custom function. -
Connect the output port to apply the function result in the Shader Graph pipeline.
-
Example Pipeline:
- Inputs:
Time(as a float) andPosition(as a vector) - Outputs:
Modified Position(vector with new position)
This would make the custom node update an object's position based on time in the shader.
- Inputs:
-
{.marker-timeline .shortcuts}
Also see
- Unity Shader Graph documentation (docs.unity3d.com)
- Tianle Yuan's Unity Visual Effect notes (yuantianle.com)