13. Reference (cheat sheet)

This page is a reference for “quickly finding things when you get confused while studying.”
In particular, HLSL items do not provide “concepts” but return value/signature/definition location/representative reference (xref).

13.0 Accurate Reference (IDE, URP 17.5.0)

• Lit Pass/Include Map: IDE Graph
• Function signature index: IDE Index
• Structure (including fields): IDE Index
• Macro index: IDE Index
• Lit core symbol xref: IDE Index

13.1 C# (SRP/URP) core types

• ScriptableRendererFeature — Renderer extension point
  • Related: 03. URP Architecture
• ScriptableRenderPass — Pass unit (RecordRenderGraph/Execute)
  • Related: 03. URP Architecture, 04. RenderGraph
• RenderGraph / TextureHandle — RenderGraph path/resource
  • Related: 04. RenderGraph, 05. Texture Resources and IDs
• CommandBuffer / CommandBufferPool — GPU command history
  • Related: 06. CommandBuffer/Context
• RTHandle — Render target handle for scale/dynamic resolution
  • Related: 05. Texture Resources and IDs

13.2 URP Frame Data (frequently used, RenderGraph path)

These are the data types accessed by ContextContainer frameData in the RenderGraph path.

• UniversalResourceData — Collection of resource handles such as camera color/depth/history
  • Related: 04. RenderGraph, 05. 텍스처/ID/핸들
• UniversalCameraData — Camera-related data (camera type/matrix/settings, etc.)
  • Related: 04. RenderGraph

Official documentation:

• Frame Data Access: https://docs.unity3d.com/kr/6000.5/Manual/urp/accessing-frame-data.html

13.3 HLSL(URP) core functions: signature/return value/definition location

The table below is the “Learning Core” extracted from the URP 17.5.0 ide index. For the full list, search IDE Index.

Representative xref (definition + call site): IDE Index

13.4 HLSL(URP) core structures: fields and definitions

Search the entire list from IDE Index.

13.5 Forward+(Cluster) Related

The most common pitfall is that GetAdditionalLightsCount() in Forward+ can be 0.
Detailed debugging routine: 07

13.6 ShaderLab Pass tags/LightMode (9 types as of URP 17.5.0 Lit)

Full pass and consumption-stage contract: 20. Pass Tags and LightMode Contract

13.7 Commonly seen calls (concepts) in RenderGraph “Builder”

The exact signature may be different for different versions of URP, but conceptually you see the following call over and over again:

• Add pass: renderGraph.AddRasterRenderPass<T>(...)
• Texture creation: renderGraph.CreateTexture(desc)
• Import external RTHandle: renderGraph.ImportTexture(rtHandle)
• Read declaration: builder.UseTexture(handle, AccessFlags.Read)
• Color target setting: builder.SetRenderAttachment(handle, index, AccessFlags.Write)
• Execution function settings: builder.SetRenderFunc((data, ctx) => { ... })

Related: 04. RenderGraph

13.8 Frequently seen calls (concepts) in ComputeGraphContext (Compute Pass)

In the Compute pass, ComputeGraphContext is passed, usually repeating the following pattern.

• Add pass: renderGraph.AddComputePass<T>(...)
• UAV texture creation: desc.enableRandomWrite = true
• Texture read/write declaration: builder.UseTexture(handle, AccessFlags.Read/Write)
• Binding: cmd.SetComputeTextureParam(...), cmd.SetComputeBufferParam(...)
• Run: cmd.DispatchCompute(...)

Related: 17. RenderGraph Compute/UAV

13.9 ShaderLab tag/key (representative)

• Tags { "RenderPipeline"="UniversalPipeline" } — Declare shader for URP
• Tags { "LightMode"="UniversalForward" } — Declaration of pass usage selected by URP
• Queue / RenderType — Render queue/render type (opaque/transparent) classification

Related: 09. URP 호환 셰이더 작성

13.10 “Where can I check?” quick link

• URP conversion helper/shader method: https://docs.unity3d.com/6000.5/Documentation/Manual/urp/use-built-in-shader-methods-transformations.html
• Forward+ additional light: https://docs.unity3d.com/6000.5/Documentation/Manual/urp/rendering/additional-lights-fplus.html
• Create RenderGraph pass: https://docs.unity3d.com/Manual/urp/render-graph-write-render-pass.html