VividRP

English | 简体中文

VividRP is an experimental Scriptable Render Pipeline (SRP) package for Unity 6. It centers on a visual, data-driven RenderGraph workflow and explores high-end rendering systems including deferred rendering, GPU Driven, Bindless, Ray Tracing, reference path tracing, volumetrics, virtual texturing, and temporal upscaling.

Core workflow

VividRP content is primarily authored as .vrdg graph assets:

1. In the Project window, choose Assets/Create/VividRP/Standard Render Graph for a runnable template, or Assets/Create/VividRP/Render Graph for an empty graph.
2. Double-click the .vrdg asset and configure passes and resource connections in the editor built on com.unity.graphtoolkit.
3. The importer compiles the graph into runtime RenderGraphData.
4. Assign the generated RenderGraphData to the Render Graph Asset field of a VividRenderPipelineAsset.

Pass ports are generated from fields marked with [RenderGraphResource]. At runtime, PassRecorder schedules three standard pass types:

• RasterPass for raster rendering;
• ComputePass for Compute Shader dispatch;
• UnsafePass when native CommandBuffer access is required.

The graph editor supports Texture, Buffer, Render List, History, Preview, and Acceleration Structure resources, as well as Local Subgraph-based SubSystems. The compile pipeline derives resource bindings and dependencies, performs pass culling, and validates graphs.

Included capabilities

The modules below have implementations in the current package. Availability still depends on project configuration, platform, and hardware support.

Area	Included systems
Core rendering	Pre-depth, GBuffer, deferred lighting, motion vectors, HZB, general object drawing, and color pyramids
Shadows and lighting	CSM / PCSS, clustered lighting, directional DXR shadows with SIGMA denoising, sky, and atmospheric scattering
Post processing	Auto exposure with Unity, HDRP, and Unreal preset Inspectors; bloom with mip-scattering and FFT-convolution modes; color grading; depth of field; ambient occlusion with XeGTAO or FidelityFX CACAO; lens flares; SSR with ReBlur; local exposure; and final compositing
Anti-aliasing and upscaling	CMAA2, TAA, TSR, and FSR3; DLSS Super Resolution / Ray Reconstruction require additional plugin integration
NVIDIA integration	NVAPI Shader Execution Reordering (SER)
Volumetrics	Global and local volumetric fog, VBuffer, volumetric lighting, and Max-Z generation
GPU Driven	Meshlet import and rendering, Visibility Buffer, object dispatch, debug overlay, bindless descriptor support, and Unity Terrain duplication/conversion, chunked meshlet baking, multi-level LODs, and up to eight terrain material layers with control-map blending
Ray Tracing	Serializable RTAS descriptors, RTAS construction, directional ray-traced shadows, and related debug passes
Reference path tracing	OpenPBR-based multi-bounce DXR prototype with stochastic RGB geometry opacity, thin-walled transmission, and partially transmissive solid refraction using a four-level medium stack and Beer–Lambert absorption; also includes analytic-light and HDRI MIS / next-event estimation, rectangle / disc BSDF-segment evaluation, shading-point-aware mixed light selection and a spatial index, face subsurface-scattering ear transmission, Rendering Debugger transport views, deterministic pixel capture, REBLUR signal routing for finite sun lighting, NRD REBLUR preview denoising, and a Unity Open Image Denoise backend
Hair path tracing	VividRP/Material/Hair DXR path based on the RTXCR Chiang near-field BCSDF, with DOTS strand geometry, persistent GPU strand updates, dynamic motion vectors, Reference PT, ReBLUR, and DLSS Ray Reconstruction guides; raster hair rendering and groom importing are not currently provided
Resources and subsystems	Virtual Texturing with SVT, GPU Driven Terrain surface bindings, adaptive mip bias and residency transitions, DBuffer Decals, LTC area lights, reflection-probe atlas, ReGIR, and sky management
Per-Object Buffer	Per-renderer shader data without MaterialPropertyBlock, centralized generated HLSL layouts, a color example, and an MPB CPU benchmark
Experimental particles	ECS paged-storage simulation, culling, sorting, Billboard / Mesh / Stretch rendering, trails, collisions, and sub-emitters
Editor and tools	DXC shader performance compiler backend, VividRP Wizard for Windows DX12 / DXC configuration, RenderGraph editing, importing, compilation, validation, node-registry generation, resource drawers, and EditMode tests
Materials and PBR	StandardLit, including Metallic / Smoothness / AO PBR remap ranges, SimpleLit, SimpleForward, and StandardLayeredLit, plus URP Lit and HDRP Lit material conversion tools

Cameras, lights, reflection probes, and most Volume settings have VividRP companion components or custom Inspectors.

Quick start

1. Open the project with Unity 6000.7.0a3, or a compatible 6000.7 release.
2. In Package Manager, use Add package from git URL to add https://github.com/af8a2a/CoreRP.git.
3. Add this package through Package Manager as an embedded or local package.
4. Create a VividRenderPipelineAsset through Assets/Create/VividRP/Vivid Render Pipeline.
5. Set that asset as the active render pipeline in Project Settings > Graphics.
6. Create and edit a Standard Render Graph, then assign its generated RenderGraphData to the pipeline asset.
7. For post-processing or global rendering settings, initialize Default Volume in the pipeline asset Inspector, or create a scene Volume Profile.
8. To enable temporal anti-aliasing, add VividAdditionalCameraData to a camera and select the desired mode.

Optional: GPU Driven, Bindless, and Ray Tracing

• Enable GPU Driven in the pipeline asset Inspector.
• Open Window > Rendering > VividRP Wizard to place Direct3D 12 first for Windows Standalone and configure DXC for the active Build Profile; restart Unity after changing the graphics API.
• Bindless requires running the following script from the project root, then restarting Unity:

powershell -ExecutionPolicy Bypass -File .\Packages\VividRP\Setup-Bindless.ps1

• Ray Tracing requires DXR-compatible hardware and DX12. Add VividRP/Ray Tracing/Settings to a Volume Profile and configure it for the project.
• DLSS requires the NVIDIA dependencies and the DLSS_PLUGIN_INTEGRATE scripting define symbol.
• NVIDIA Shader Execution Reordering (SER) is an optional Reference Path Tracing acceleration for Windows x86_64 + DX12 and requires NVAPI support.
• Reference path tracing uses a dedicated .vrdg asset and pipeline asset for controlled-scene validation; it is not intended for real-time use or complete ground truth. StandardLit separates geometric coverage from material transmission: stochastic coverage is driven by Base Color.a × Base Map.a × Opacity Map.r, while Transmission Weight × Transmission Map.r controls OpenPBR transmission; both extra maps reuse the Base Map UV. Enable Thin-Walled Transmission for sheets; disable it for closed solids, where Transmission Depth specifies the Beer–Lambert distance represented by Transmission Color. Solid media can be nested up to four levels. Accumulation stops and history freezes at Target Sample Count. The OIDN backend is enabled only in the Editor or 64-bit Standalone builds when com.unity.rendering.denoising is available, and submits denoising once each convergence cycle. RTX Texture Filtering (RTXTF) can be enabled in the Reference Path Tracing Volume and is used by default only for opaque StandardLit surface texture reads.
• Hair uses a dedicated VividRP/Material/Hair material and Reference Path Tracing graph. It covers the ray-tracing path only and is intended to validate strand geometry, motion vectors, and denoising guides rather than replace a conventional raster-hair workflow.

Directory guide

• Runtime/RenderPipeline: pipeline, pipeline asset, global settings, and Volume integration.
• Runtime/RenderGraph: runtime graph data, resource descriptors, History / Preview, Pass Recorder, and Frame Context.
• Runtime/Core/History: camera-owned persistent texture and buffer history, imported into RenderGraph through the bridge.
• Runtime/Core/Hair: DOTS hair geometry and persistent GPU strand updates.
• Runtime/RenderPass: Core, Debug, and Example passes.
• Runtime/SubSystem: GPU Driven, Terrain, Virtual Texture, Volumetric, Sky, Decal, Reflection, DLSS, and other subsystems.
• Runtime/ComponentData: companion camera, light, and reflection-probe data.
• Runtime/PerObjectBuffer: per-renderer shader-data system and examples.
• Runtime/Experiment/Particle: experimental ECS particle system.
• Editor/RenderGraph: graph editor, importer, compiler, validation, and node-registry generation.
• Editor/PipelineResource: resource collection and synchronization for [PipelineResource] declarations.
• Shaders: package shaders and their assembly.
• Documentation~: workflow, constraints, and design notes.
• Tests/Editor: EditMode tests.

Resource synchronization and development notes

• .vrdg files are the RenderGraph source of truth. Do not manually maintain imported RenderGraphData contents.
• Eligible RenderGraph passes in VividRP.Runtime receive dedicated nodes from a Roslyn source generator at compile time, so there is no GeneratedRenderPassNodes.g.cs file to maintain or regenerate. Custom passes in consumer assemblies continue to use the generic node's PassScript option. Do not manually edit Runtime/Resources/PipelineResources.asset; update it through the resource-collection workflow.
• When upgrading from the former file-writing generator, first replace any consumer-authored node serialized as VividRP.Editor.RenderGraph.Generated.<CustomPass> with the generic pass node and set its PassScript. The new generator does not recreate dedicated node types for consumer assemblies.
• After changing [PipelineResource] or [ResourcePath] declarations, select Runtime/Resources/PipelineResources.asset and run Recollect Engine Resources in the Inspector.
• RenderGraph resource field names are contracts for ports, previews, and compiled bindings. Review graph assets and tests when changing them.
• Use camera-owned History resources for cross-frame textures and buffers. PassRecorder imports them through CameraHistoryRenderGraphBridge and commits them after successful graph execution, so a manual end-of-graph copy is unnecessary.

Documentation and roadmap

• RenderGraph Editor
• RenderGraph SubSystem
• RenderGraph Resource Descriptors
• Acceleration Structure Support
• Bindless Setup
• Local Exposure
• Ambient Occlusion (XeGTAO / FidelityFX CACAO)
• FFT Convolution Bloom
• NVIDIA Shader Execution Reordering
• RTX Texture Filtering
• Chiang Hair Path Tracing
• Virtual Texture Architecture
• VividTerrain Baking
• VividRP Wizard
• Per-Object Buffer
• Roadmaps: Shadow, Sky, Light Culling, Virtual Texture, SVT, Reference Path Tracing, and Hair Path Tracing