Unity Graphics

Unity Graphics and Rendering

Render Pipeline Selection Guide

A render pipeline performs a series of operations that take the contents of a scene and displays them on a screen. Unity provides three render pipelines:

Decision flow:

1. Need ray tracing, volumetric clouds, or physically-based sky? --> HDRP
2. Need to target mobile, WebGL, or widest platform range? --> URP
3. Maintaining a legacy project with no migration budget? --> Built-in
4. Starting a new project? --> URP (most projects) or HDRP (high fidelity)

Warning: Render pipelines are NOT interchangeable. Materials, shaders, and post-processing from one pipeline do not work in another without conversion. Upgrading Built-in materials to URP/HDRP requires the pipeline's material upgrader; objects render bright pink if their shader is incompatible.

Source: Render Pipelines

URP (Universal Render Pipeline)

URP is a prebuilt Scriptable Render Pipeline made by Unity for creating optimized graphics across a range of platforms, from mobile to high-end consoles and PCs.

Key features:

• Forward, Forward+, and Deferred rendering paths
• Anti-aliasing: FXAA, SMAA, TAA, MSAA
• 2D Renderer for 2D games
• Renderer Features for custom rendering injection
• SRP Batcher for draw call optimization
• Built-in post-processing via Volume system

See: references/urp-guide.md Source: URP

HDRP (High Definition Render Pipeline)

HDRP is a prebuilt Scriptable Render Pipeline targeting AAA-quality games, automotive demos, and architectural visualization on high-end hardware. It requires compute shader-capable GPUs (DirectX 11/12, Metal, Vulkan).

Key features:

• Physically-based lighting with Physical Light Units
• Material types: Lit, StackLit, Layered Lit, Hair, Fabric, Eye, AxF, Terrain
• Ray tracing: reflections, GI, shadows, AO, subsurface scattering
• Volumetric fog and volumetric clouds
• Physically Based Sky, HDRI Sky, Gradient Sky
• Path tracing with denoising (Optix, Intel Open Image Denoise)
• Water system with caustics and underwater rendering
• Dynamic resolution with DLSS, FSR 1.0, TAA Upscaling

See: references/hdrp-guide.md Source: HDRP

Shader Graph

Shader Graph enables building shaders visually by creating and connecting nodes in a graph framework instead of writing code. Changes are reflected with instant feedback.

Render pipeline compatibility:

Shader Graph is included automatically when you install URP or HDRP.

Custom Function Node -- Inject custom HLSL code into Shader Graphs:

• String mode: Write HLSL directly; use $precision token for half/float
• File mode: Reference external .hlsl files with include guards

// File mode example with include guards
//UNITY_SHADER_NO_UPGRADE
#ifndef MYHLSLINCLUDE_INCLUDED
#define MYHLSLINCLUDE_INCLUDED

void MyFunction_float(float3 A, float B, out float3 Out)
{
    Out = A + B;
}
#endif //MYHLSLINCLUDE_INCLUDED

Pipeline detection in Custom Function nodes:

#ifdef SHADERGRAPH_PREVIEW
    half3 color = half3(0,0,0);
#else
    #if defined(UNIVERSAL_PIPELINE_CORE_INCLUDED)
        half4 shadowCoord = TransformWorldToShadowCoord(WorldPosition);
        Light mainLight = GetMainLight(shadowCoord);
        half3 color = mainLight.color;
    #else
        half3 color = half3(0, 0, 0);
    #endif
#endif

Conditional keywords by pipeline:

• Built-in: BUILTIN_PIPELINE_CORE_INCLUDED
• URP: UNIVERSAL_PIPELINE_CORE_INCLUDED
• HDRP: UNITY_HEADER_HD_INCLUDED
• Preview window: SHADERGRAPH_PREVIEW

See: references/shader-graph.md Source: Shader Graph

Shaders

A shader is a program that runs on the GPU. Unity categorizes shaders into three types:

1. Graphics Pipeline Shaders -- Most common; work with Shader objects to determine scene appearance
2. Compute Shaders -- Perform GPU calculations outside the regular graphics pipeline
3. Ray Tracing Shaders -- Handle ray tracing calculations (HDRP only)

Key terminology:

• Shader Object -- Instance of the Shader class wrapping shader programs and GPU instructions
• ShaderLab -- Unity's language for defining Shader object structure
• Shader Graph -- Visual, code-free shader creation tool
• Shader Asset -- A .shader file defining a Shader object
• HLSL -- High Level Shader Language used inside shader code blocks

Surface Shaders (Built-in pipeline ONLY):

• Streamlined way to write lighting-interactive shaders
• Auto-generates vertex/pixel shaders and rendering passes
• NOT supported in URP or HDRP; use Shader Graph instead

HLSL in ShaderLab:

• Use HLSLPROGRAM directive to add shader code to Pass blocks
• Declare structs connecting shader variables to mesh vertex data
• Use #pragma directives to control compilation
• Support 16-bit precision for mobile optimization

Source: Shaders Introduction

Materials and Textures

Materials and shaders work together to define the appearance of a scene.

Materials

Key workflows:

• Create material assets and assign them to GameObjects
• Modify material properties at runtime via scripting
• Use Material Variants for managing large material collections
• Upgrade Built-in materials to URP/HDRP to prevent pink rendering

Material API -- Key properties and methods:

Important: Set your desired shader BEFORE modifying properties. Property assignments have no effect if the current shader does not support them.

Textures

Textures are bitmap images applied to mesh surfaces. Key concepts:

• Power-of-two dimensions recommended: 32, 64, 128, 256, 512, 1024, 2048, 4096
• LDR (Low Dynamic Range): PNG, JPG -- values 0.0-1.0
• HDR (High Dynamic Range): EXR, HDR -- extended color ranges
• RGBA: RGB color plus alpha channel for transparency
• Bits per pixel (bpp): Lower values reduce memory and improve GPU cache
• Anisotropic filtering: Improves quality at steep viewing angles

See: references/materials-textures.md Source: Materials, Textures

Cameras

Cameras create an image of a particular viewpoint in a scene, with output displayed on-screen or captured as a texture.

Projection modes:

• Perspective -- Replicates human vision; distant objects appear smaller (default)
• Orthographic -- No perspective; objects render at consistent size regardless of distance; useful for isometric/2D games

Key details:

• At least one camera required per scene
• Multiple cameras supported with configurable render order
• Render path set in Player settings; overridable per camera
• URP and HDRP have pipeline-specific camera documentation
• Orthographic cameras render fog uniformly rather than depth-based

Common camera setups:

• Puzzle games: static camera for full visibility
• FPS: camera parented to player at eye level
• Racing: camera following the vehicle

Source: Cameras

Post-Processing

Post-processing effects simulate physical camera/film properties or enable stylized visuals.

Warning: Post-processing solutions are NOT interchangeable across render pipelines. Each pipeline's effects and implementation methods differ.

HDRP anti-aliasing options:

• MSAA -- Most resource-intensive
• TAA -- Motion-dependent temporal smoothing
• SMAA -- Pattern-based edge blending
• FXAA -- Per-pixel; least intensive

HDRP exposure: Histogram-based with percentile selection, metering modes, and pre-exposure for precision with Physical Light Units.

Source: Post-Processing

Render Graph (Unity 6)

The Render Graph system provides a high-level representation of custom SRP render passes, explicitly stating how passes use resources. Both URP and HDRP use Render Graph.

Core Principles

1. Handle-based resources -- Use TextureHandle, BufferHandle, RendererListHandle instead of direct references
2. Scoped access -- Actual resources only accessible inside render pass execution code
3. Explicit declaration -- Each pass declares reads/writes, enabling dependency tracking
4. No persistence -- Resources created within one execution cannot carry to the next
5. RTHandle dependency -- Textures use RTHandle system

Three-Phase Execution (per frame)

1. Setup -- Declare all render passes and resource dependencies
2. Compilation -- System culls unused passes, calculates resource lifetimes for efficient allocation
3. Execution -- Run non-culled passes in declaration order

Key API Pattern -- AddRenderPass

using UnityEngine.Rendering;
using UnityEngine.Rendering.RenderGraphModule;

// 1. Define pass data
class MyPassData { public TextureHandle input, output; public float param; }

// 2. Create and configure pass
using (var builder = renderGraph.AddRenderPass<MyPassData>("MyPass", out var passData))
{
    passData.input = builder.ReadTexture(inputTexture);
    passData.output = builder.UseColorBuffer(
        renderGraph.CreateTexture(new TextureDesc(Vector2.one, true, true)
        { colorFormat = GraphicsFormat.R8G8B8A8_UNorm, name = "Output" }), 0);
    passData.param = 2.5f;

    builder.SetRenderFunc((MyPassData data, RenderGraphContext ctx) =>
    {
        var mpb = ctx.renderGraphPool.GetTempMaterialPropertyBlock();
        mpb.SetTexture("_MainTexture", data.input);
        mpb.SetFloat("_FloatParam", data.param);
        CoreUtils.DrawFullScreen(ctx.cmd, material, mpb);
    });
}

// 3. Lifecycle: new RenderGraph() -> BeginRecording() -> AddPasses -> EndRecordingAndExecute() -> Cleanup()

RenderGraphBuilder Key Methods

Resource creation: CreateTexture(), CreateComputeBuffer(), CreateRendererList() Import external: ImportTexture(), ImportBackbuffer(), ImportBuffer()

Source: Render Graph

Rendering Optimization

Draw Call Batching

Batching combines meshes using the same material so Unity renders them with fewer render state updates.

SRP Batcher (URP/HDRP only):

• Reduces CPU time for draw calls by minimizing render-state changes between calls
• Material data persists in GPU memory
• Uses dedicated per-object GPU constant buffer
• For best results: use as few shader variants as possible
• Compatible with URP, HDRP, and custom SRP; NOT Built-in pipeline

Static Batching:

• Merges stationary meshes into unified vertex/index buffers (world-space)
• Each buffer supports up to 64,000 vertices
• Works at build time or runtime
• Only for Mesh Renderers (not Skinned Mesh Renderers)

Dynamic Batching:

• Transforms vertices to world space on CPU at runtime
• Useful for procedurally generated geometry (particles, lines, trails)
• Meshes limited to 900 vertex attributes or 300 vertices
• Not recommended for most uses: CPU overhead may exceed draw call savings
• Not supported in HDRP

GPU Instancing:

• Renders multiple instances of the same mesh in one draw call
• Enable via Material.enableInstancing
• Add per-instance properties (color, transform) via HLSL macros
• Requires shader support with instancing macros

Occlusion Culling

Prevents rendering of GameObjects hidden behind others. Works with frustum culling.

• Baking phase (Editor): Divides scene into cells, generates visibility data
• Runtime: Loads baked data, performs per-camera visibility queries
• Best for: GPU-bound projects with overdraw; small areas separated by solid geometry
• Limitation: Dynamic objects can be occluded but cannot occlude others
• URP/HDRP: Can use GPU occlusion culling instead of CPU-based approach

Source: Draw Call Batching, SRP Batcher

Common Patterns (C#)

Material Property Access at Runtime

// Set shader before modifying properties
material.SetColor("_BaseColor", Color.red);
material.SetFloat("_Smoothness", 0.8f);
material.SetTexture("_BaseMap", myTexture);
if (material.HasProperty("_Metallic"))
    material.SetFloat("_Metallic", 1.0f);
material.EnableKeyword("_EMISSION");

Instance vs Shared Material

Renderer rend = GetComponent<Renderer>();
rend.material.color = Color.blue;        // SAFE: creates per-object instance
// rend.sharedMaterial.color = Color.blue; // DANGEROUS: modifies asset for ALL objects

MaterialPropertyBlock (Per-Object Variation Without Material Instances)

// WARNING: MaterialPropertyBlock BREAKS SRP Batcher compatibility.
// Use only when SRP Batcher is not critical (e.g., Built-in pipeline, few unique objects).
// For SRP Batcher-compatible per-object variation, use GPU Instancing with instance properties
// or create material instances via renderer.material.
private static readonly int BaseColorID = Shader.PropertyToID("_BaseColor");
private MaterialPropertyBlock _propBlock = new MaterialPropertyBlock();

void SetColor(Color color)
{
    Renderer rend = GetComponent<Renderer>();
    rend.GetPropertyBlock(_propBlock);
    _propBlock.SetColor(BaseColorID, color);
    rend.SetPropertyBlock(_propBlock);
}

Anti-Patterns

Key API Quick Reference

Related Skills

• unity-lighting-vfx -- Lighting setup, light types, baking, VFX Graph, particle systems
• unity-platforms -- Platform-specific rendering settings, quality tiers, shader stripping
• unity-2d -- 2D Renderer (URP), sprite rendering, tilemap rendering

Additional Resources

• Render Pipelines Overview
• URP Documentation
• HDRP Documentation
• Shader Introduction
• Shader Graph
• Materials
• Textures
• Cameras
• Post-Processing
• Draw Call Batching
• SRP Batcher
• Occlusion Culling
• Render Graph API (SRP Core 17.0)
• Shader Graph 17.0
• HDRP Features
• Material Scripting API