Getting started with the High Definition Render Pipeline

The High Definition Render Pipeline (HDRP) uses Shaders and lighting units that are different to those in Unity's built-in render pipeline. This means that you must either create a new Project that uses HDRP, or upgrade an existing Project to use HDRP.

This documentation describes how to create a Scene that uses HDRP, and introduces you to key features that help you produce high fidelity visuals.

To upgrade an existing Project that doesn’t use HDRP, you need to convert the Materials to make them compatible with HDRP. For information about the upgrade process, see Upgrading to HDRP.

Creating an HDRP Project from the Template

To set up and manage your Unity Projects, install the Unity Hub.

Unity provides an HDRP Template Project which you can use to get set up with HDRP. To create an HDRP Template Project:

  1. Open the Unity Hub,
  2. Go to Projects, and select New Project.
  3. Open the Sample tab and select 3D Sample Scene (HDRP).
  4. Enter a Project name.
  5. Select Create project.

Unity creates a Project and automatically installs the HDRP package, and all its dependencies. After Unity opens the Template Project, you can see the main Scene.

This template is a great starting point for projects aiming at high-end graphics. It includes multiple physically-based lighting setups to help you realistically illuminate environments with HDRP. It also includes use-case examples for many of HDRP's features such as Decals, Volumes, and physically-accurate Materials.

Pipeline setup

Before you can use HDRP, you need an HDRP Asset, which controls the global rendering settings and creates an instance of the HD render pipeline. The High-Definition RP Template creates an HDRP Asset for you, but you can create different HDRP Assets to suit your rendering needs, such as one HDRP Asset for every target platform. An HDRP Asset allows you to enable features for your entire Project in the Editor. It allocates memory for the different features, so you cannot edit them at runtime. For more information, see HDRP Asset.

To find the right balance between render quality and runtime performance, adjust the Frame Settings for your Cameras. Frame Settings allow you to enable or disable effects at runtime on a per-Camera basis, as long as you enable the effect in the HDRP Asset before entering Play Mode/building your HDRP Project.

Render Pipeline Wizard

HDRP provides you with the Render Pipeline Wizard to help you set up your Project with HDRP. You can also use it to add support for DirectX Raytracing (DXR) or VR to your HDRP Project. If you use the High-Definition RP Template to create your Project, then you should not need to use the Render Pipeline Wizard, unless you want to use DXR or VR.

Volumes

Volumes allow you to partition your Scene into areas so that you can control lighting and effects at a finer level, rather than tuning an entire Scene. You can add as many volumes to your Scene as you want, to create different spaces, and then light them all individually for realistic effect. Each volume has an environment, so you can adjust its sky, fog, and shadow settings. You can also create custom Volume Profiles and switch between them.

To add a Volume to your Scene and edit its Volume Profile:

  1. Go to GameObject > Volume and select one of the options from the list.
  2. In the Scene or Hierarchy view, select the new GameObject to view it in the Inspector.
  3. On the Volume component, assign a Volume Profile to the Profile property field. If you want to create a new Volume Profile, click the New button to the right of the property field.
  4. The list of Volume overrides that the Volume Profile contains should now appear below the Profile property. Here you can add or remove Volume overrides and edit their properties.

Visual Environment

The Visual Environment override allows you to change the type of sky and fog you want in a Scene. For example, use volumetric fog to create atmospheric light rays, like this:

For more information, see Visual Environment, Sky overview, and Fog overview.

Materials and Shaders

HDRP provides Shaders that allow you to create a wide variety of different Materials. For example, you can create glass with a refractive effect or leaves with subsurface scattering. The options for a Material depend on which Shader the Material uses. HDRP shares many Material properties across Shaders. For more information, see HDRP Material features.

Lighting

To apply realistic lighting to your Scenes, HDRP uses Physical Light Units (PLU), which are based on real-life measurable values, just like you would see when looking for light bulbs at a store or measuring light with a photographic light meter. Note that for lights to behave properly when using PLU, you need to respect HDRP unit convention (1 Unity unit equals 1 meter). For more information, see Physical Light Units.

Also note that because of that, the HDRI sky used by HDRP by default has an exposure of 10. However, newly created directional lights have an intensity of 3.14 which can cause objects to look black because of the auto exposure compensating for the overly bright sky. Setting a value of 10000 to your directional light should work fine for a mix of indoor and outdoor scenes. If the HDRP wizard was setup properly, newly created scenes should have coherent values out of the box.

For more information, see HDRP Lighting features. For advice on adding lights to your Scene, see Light.

Light Explorer

HDRP adds settings to the Light Explorer (menu: Window > Rendering > Light Explorer) so that you can adjust HDRP features and lighting units.

Use the Light Explorer to change the settings of any type of Light within your Project without the need to locate the Lights in the Scene. You can also manage Reflection Probes and Light Probes in this window.

Shadows

The Shadows Volume override allows you to determine the overall quality of the Shadows in a Volume. For example, the Max Distance field calculates the quality of the Shadows based on the distance of the Camera from the Shadow.

For more information, see Shadows.