Probe Volume settings and properties

This page explains the settings you can use to configure Probe Volumes.

Baking Set properties

To open Baking Set properties, either select the Baking Set asset in the Project window, or go to Window > Rendering > Lighting and select the Probe Volumes tab.

Baking

Property	Description
Baking Mode
	Single Scene	Bake only the active scene.
	Baking Sets (Advanced)	Bake all scenes that are part of the Baking Set
Baking Set	Indicates the active Baking Set.
Scenes	Lists the Scenes in the active Baking Set. Scene: Indicates whether the scene is loaded. Bake: When enabled, HDRP generates lighting for this scene. Use + and - to add or remove a Scene from the active Baking Set. Use the three-line icon to the left of each Scene to drag the Scene up or down in the list.

Lighting Scenarios

This section appears only if you enable Lighting Scenarios under Light Probe Lighting in the HDRP Asset.

Property			Description
Scenarios			Lists the Lighting Scenarios in the Baking Set. To rename a Lighting Scenario, double-click its name.
	Active		Set the currently loaded Lighting Scenario, which HDRP writes to when you select Generate Lighting.
	Status		Indicates the status of the active Lighting Scenario.
		Invalid Scenario	A warning icon appears if the active Lighting Scenario is baked but HDRP can't load it anymore, for example if another Lighting Scenario has been baked that caused changes in the probe subdivision.
		Not Baked	An information icon appears if you haven't baked any lighting data for the active Lighting Scenario.
		Not Loaded	An information icon appears if scenes in the Baking Set aren't currently loaded in the Hierarchy window, so HDRP can't determine the Lighting Scenario status.

Probe Placement

Property	Description
Probe Positions
	Recalculate	Recalculate probe positions during baking, so you can bake multiple Lighting Scenarios that would produce different brick layouts due to differences in scene geometry.
	Don't Recalculate	Don't recalculate probe positions during baking.
Min Probe Spacing	The minimum distance between probes, in meters. See Display and adjust Probe Volumes for additional information.
Max Probe Spacing	The maximum distance between probes, in meters. See Display and adjust Probe Volumes for additional information.
Renderer Filter Settings
	Layer Mask	Specify the Layers HDRP considers when it generates probe positions. Select a Layer to enable or disable it.
	Min Renderer Size	The smallest Renderer size HDRP considers when it places probes.

Probe Invalidity Settings

Property	Description
Probe Dilation Settings
	Enable Dilation	Enable HDRP replacing data in invalid probes with data from valid probes nearby. Enabled by default. See Fix issues with Probe Volumes.
	Search Radius	Determine how far from an invalid probe HDRP searches for valid neighbors. Higher values include more distant probes that may be in different lighting conditions than the invalid probe, resulting in unwanted behaviors.
	Validity Threshold	Set the ratio of backfaces a probe samples before HDRP considers it invalid. Higher values mean HDRP is more likely to mark a probe invalid.
	Dilation Iterations	Set the number of times Unity repeats the dilation calculation. This increases spread of dilation effect, but requires additional processing power.
	Squared Distance Weighting	Enable weighing the contribution of neighbouring probes by squared distance, rather than linear distance.
Virtual Offset Settings
	Enable Virtual Offset	Enable HDRP moving the capture point of invalid probes so they're valid again. See Fix issues with Probe Volumes.
	Search Distance Multiplier	Set the length of the sampling ray HDRP uses to search for valid probe positions. High values may cause unwanted results, such as probe capture points pushing through neighboring geometry.
	Geometry Bias	Set how far HDRP pushes a probe's capture point out of geometry after one of its sampling rays hits geometry.
	Ray Origin bias	Set the distance between a probe's center and the point HDRP uses to determine the origin of that probe's sampling ray. High values may cause unwanted results, such as sampling from an area of the scene with dissimilar lighting.
	Max Ray Hits	Set how many times a sampling ray hits geometry before HDRP determines the position of the probe where that ray originated.
	Layer Mask	Specify which layers HDRP includes in collision calculations for [Virtual Offset](probevolumes-fixissues.html).
	Refresh Virtual Offset Debug	Re-run the virtual offset simulation; it will be applied only for debug visualization sake and not affect baked data.

Probe Volume Disk Usage

Property	Description
Scenario Size	Indicates how much space on disk is used by the currently selected Lighting Scenario.
Baking Set Size	Indicates how much space on disk is used by all the baked data for the currently selected Baking Set. This includes the data for all Lighting Scenarios, and the data shared by all Lighting Scenarios.

Probe Volume Properties

Select a Probe Volume and open the Inspector to view its properties.

Property	Description
Mode
	Global	HDRP sizes this Probe Volume to include all Renderers in your project that contribute Global Illumination. HDRP recalculates the volume size every time you save or generate lighting.
	Scene	HDRP sizes this Probe Volume to include all Renderers in the same scene as this Probe Volume. HDRP recalculates the volume size every time you save or generate lighting.
	Local	Set the size of this Probe Volume manually.
Size		Set the size of this Probe Volume. This setting only appears when Mode is set to Local.
Subdivision Override
Subdivision Override	Override Probe Spacing	Override the Probe Spacing set in the Baking Set for this Probe Volume.
Geometry Settings
	Override Renderer Filters	Enable filtering by Layer which GameObjects HDRP considers when it generates probe positions.
	Layer Mask	Filter by Layer which GameObjects HDRP considers when it generates probe positions.
	Min Renderer Size	The smallest Renderer size HDRP considers when it generates probe positions.
	Fill Empty Spaces	Enable HDRP filling the empty space between Renderers with bricks that have the largest distance between probes.

Probe Adjustment Volume

Select a Probe Adjustment Volume Component and open the Inspector to view its properties.

Property	Description
Influence Volume
	Shape	Set the shape of the Adjustment Volume to either Box or Sphere.
	Size	Set the size of the Adjustment Volume. This property only appears if you set Shape to Box.
	Radius	Set the radius of the Adjustment Volume. This property only appears if you set Shape to Sphere.
Mode	Select how to override probes inside the Adjustment Volume. Invalidate Probes: Mark selected probes as invalid. Override Validity Threshold: Override Dilation Validity Threshold. Apply Virtual Offset: Manually apply a Virtual Offset on selected probes. Override Virtual Offset Settings: Override Virtual Offset biases.
Intensity Scale	Set the scale HDRP applies to all probes in the Adjustment Volume. Use this sparingly, because changing the intensity of probe data can lead to inconsistencies in the lighting. This option only appears if you set Mode to Invalidate Probes, and you enable Additional Properties.
Dilation Validity Threshold	Override the ratio of backfaces a probe samples before HDRP considers it invalid. This option only appears if you set Mode to Override Validity Threshold, and you enable Additional Properties.
Virtual Offset Rotation	Set the rotation angle for the Virtual Offset vector on all probes in the Adjustment Volume. This option only appears if you set Mode to Apply Virtual Offset.
Virtual Offset Distance	Set how far HDRP pushes probes along the Virtual Offset Rotation vector. This option only appears if you set Mode to Apply Virtual Offset.
Geometry Bias	Sets how far HDRP pushes a probe's capture point out of geometry after one of its sampling rays hits geometry. This option only appears if you set Mode to Override Virtual Offset Settings.
Ray Origin Bias	Override the distance between a probe's center and the point HDRP uses to determine the origin of that probe's sampling ray. This option only appears if you set Mode to Override Virtual Offset Settings.

Probe Volumes Options Override

To add a Probe Volume Options Override, do the following:

Add a Volume to your Scene and make sure its area overlaps the position of the camera.
Select Add Override, then select Lighting > Probe Volume Options.

Property	Description
Normal Bias	Enable to move the position that object pixels use to sample the Light Probes, along the pixel's surface normal. The value is in meters.
View Bias	Enable to move the position that object pixels use to sample the Light Probes, towards the camera. The results of View Bias vary depending on the camera position. The value is in meters.
Scale Bias with Min Probe Distance	Scale the Normal Bias or View Bias so it's proportional to the spacing between Light Probes in a brick.
Sampling Noise	Enable to increase or decrease HDRP adding noise to lighting, to help fix seams.
Animate Sampling Noise	Enable to animate sampling noise when Temporal Anti-Aliasing (TAA) is enabled. This can make noise patterns less visible.
Leak Reduction Mode	Enable to choose the method Unity uses to reduce leaks. See Fix light leaks. Options: • Validity and Normal Based: Enable to make HDRP prevent invalid Light Probes contributing to the lighting result, and give Light Probes more weight than others based on the object pixel's sampling position. • None: No leak reduction.
Min Valid Dot Product Value	Enable to make HDRP reduce a Light Probe's influence on an object if the direction towards the Light Probe is too different to the object's surface normal direction. The value is the minimum dot product between the two directions where HDRP will reduce the Light Probe's influence.
Occlusion Only Reflection Normalization	Enable to limit Reflection Probe Normalization so it only decreases the intensity of reflections. Keep this enabled to reduce light leaks. See Frame Settings.

Size gizmo

To resize the Probe Volume, use one of the handles of the box gizmo in the Scene View. You can't resize a Probe Volume by rescaling the GameObject or using the scale gizmo.

In this screenshot, a red box indicates the box gizmo handles.

The resize handles for Probe Volumes.