HDRI Sky
The HDRI Sky Volume component override controls settings you can use to set up an HDRI Sky. A High-dynamic-range imaging (HDRI) Sky is a simple sky representation that uses a cubemap texture. With this component, you can define how HDRP updates the indirect lighting the sky generates in the Scene.
Tip: Unity HDRI Pack is available on the Unity Asset Store and provides 7 pre-converted HDR Cubemaps ready for use within your Project.
Using HDRI Sky
HDRI Sky uses the Volume framework, so to enable and modify HDRI Sky properties, you must add an HDRI Sky override to a Volume in your Scene. To add HDRI Sky to a Volume:
- In the Scene or Hierarchy view, select a GameObject that contains a Volume component to view it in the Inspector.
- In the Inspector, go to Add Override > Sky and select HDRI Sky.
After you add an HDRI Sky override, you must set the Volume to use HDRI Sky. The Visual Environment override controls which type of sky the Volume uses. To set the Volume to use HDRI Sky:
- In the Visual Environment override, go to the Sky > Sky Type
- Set Sky Type to HDRI Sky.
HDRP now renders an HDRI Sky for any Camera this Volume affects.
API
To access and control this override at runtime, use the Volume scripting API. Because of how the Volume system works, you edit properties in a different way to standard Unity components. There are also other nuances to be aware of too, such as each property has an overrideState. This indicates to the Volume system whether to use the property value you set, or use the default value stored in the Volume Profile. For information on how to use the API correctly, see Volume scripting API.
Properties
To edit properties in any Volume component override, enable the checkbox to the left of the property. This also tells HDRP to use the property value you specify for the Volume component rather than the default value. If you disable the checkbox, HDRP ignores the property you set and uses the Volume’s default value for that property instead.
| Property | Description | |
|---|---|---|
| HDRI Sky | Assign a HDRI Texture that HDRP uses to render the sky. | |
| Distortion Mode | Use the drop-down to select the method that HDRP uses to calculate the sky distortion. • None: No distortion. • Procedural: HDRP distorts the sky using a uniform wind direction. • Flowmap: HDRP distorts the sky with a user provided flowmap. |
|
| Orientation | The orientation of the distortion relative to the X world vector (in degrees). This value can be relative to the Global Wind Orientation defined in the Visual Environment. |
|
| Speed | The speed at which HDRP scrolls the distortion texture. This value can be relative to the Global Wind Speed defined in the Visual Environment. |
|
| Flowmap | Assign a flowmap, in LatLong layout, that HDRP uses to distort UVs when rendering the sky. This property only appears when you select Flowmap from the Distortion Mode drop-down. |
|
| Upper Hemisphere Only | Check the box if the flowmap contains distortion for the sky above the horizon only. This property only appears when you select Flowmap from the Distortion Mode drop-down. |
|
| Intensity Mode | Use the drop-down to select the method that HDRP uses to calculate the sky intensity. • Exposure: HDRP calculates intensity from an exposure value in EV100. • Multiplier: HDRP calculates intensity from a flat multiplier. • Lux: HDRP calculates intensity in terms of a target Lux value. |
|
| Exposure | Set the amount of light per unit area that HDRP applies to the HDRI Sky cubemap. This property only appears when you select Exposure from the Intensity Mode drop-down. |
|
| Multiplier | Set the multiplier for HDRP to apply to the Scene as environmental light. HDRP multiplies the environment light in your Scene by this value. This property only appears when you select Multiplier from the Intensity Mode drop-down. |
|
| Desired Lux Value | Set an absolute intensity for the HDR Texture you set in HDRI Sky, in Lux. This value represents the light received in a direction perpendicular to the ground. This is similar to the Lux unit you use to represent the Sun, so it's complimentary. This property only appears when you select Lux from the Intensity Mode drop-down. |
|
| Upper Hemisphere Lux Value | Displays the relative intensity, in Lux, for the current HDR texture set in HDRI Sky. The final multiplier HDRP applies for intensity is Desired Lux Value / Upper Hemisphere Lux Value. This field is an informative helper. This property only appears when you select Lux from the Intensity Mode drop-down. |
|
| Rotation | Use the slider to set the angle to rotate the cubemap, in degrees. | |
| Lock Sun | Make the Sun rotate automatically when you move the HDRI Sky, and the HDRI Sky rotate automatically when you rotate the Sun. | |
| Update Mode | Use the drop-down to set the rate at which HDRP updates the sky environment (using Ambient and Reflection Probes). • On Changed: HDRP updates the sky environment when one of the sky properties changes. • On Demand: HDRP waits until you manually call for a sky environment update from a script. • Realtime: HDRP updates the sky environment at regular intervals defined by the Update Period. |
|
| Update Period | Set the period (in seconds) for HDRP to update the sky environment. Set the value to 0 if you want HDRP to update the sky environment every frame. This property only appears when you set the Update Mode to Realtime. |
Advanced Properties
These properties only appear if you enable more options and then enable Backplate.
| Property | Description | ||
|---|---|---|---|
| Backplate | Indicates whether to project the bottom part of the HDRI onto a plane with various shapes such as a Rectangle, Circle, Ellipse, or Infinite plane. | ||
| Type | Specifies the shape of the backplate. • Disc: Projects the bottom of the HDRI texture onto a disc. • Rectangle: rojects the bottom of the HDRI texture onto a rectangle. • Ellipse: Projects the bottom of the HDRI texture onto an ellipse. • Infinite: Projects the bottom of the HDRI texture onto an infinite plane. |
||
| Ground Level | The height of the ground level in the scene. | ||
| Scale | The scale of the backplate. HDRP uses the X and Y values of this property to scale the backplate (for Ellipse X and Y must be different). | ||
| Projection | HDRP uses this number to control the projection of the bottom hemisphere of the HDRI on the backplate. Small projection distance implies higher pixels density with more distortion, large projection distance implies less pixels density with less distortion. | ||
| Rotation | The rotation of the physical backplate. | ||
| Texture Rotation | The rotation of the HDRI texture HDRP projects onto the backplate. | ||
| Texture Offset | The offset value to apply to the texture HDRP projects onto the backplate. | ||
| Blend Amount | The percentage of the transition between the backplate and the background HDRI. 0 means no blending, 25 means the blending starts at the end of the boundary of the backplate, 50 means the blending starts from the middle of the backplate and 100 means the transition starts from the center of the backplate with a smoothstep. | ||
| Point/Spot Shadow | Indicates whether the backplate receives shadows from point/spot Lights. | ||
| Directional Shadow | Indicates whether the backplate receives shadows from the main directional Light. | ||
| Area Shadow | Indicates whether the backplate receives shadows from area Lights. | ||
| Shadow Tint | Specifies the color to tint shadows cast onto the backplate. | ||
| Reset Color | Resets the saved Shadow Tint for the shadow. HDRP calculates a new default shadow tint when the HDRI changes. |
Note: To use ambient occlusion in the backplate, increase the value of the Direct Lighting Strength property on the Ambient Occlusion component override. As the backplate doesn't have global illumination, it can only get ambient occlusion from direct lighting.
Limitation: The backplate only appears in local reflection probes and it doesn't appear in the default sky reflection. This is because the default sky reflection is a cubemap projected at infinity which is incompatible with how Unity renders the backplate.