Probe Volume settings and properties
This page explains the settings you can use to configure Probe Volumes.
Probe Volume Settings
To open Probe Volume Settings, open the Window menu, select Rendering, then select Probe Volume Settings.
Probe Volume Settings affect all the Probe Volumes in a Baking Set.
See Use Probe Volumes.
Property | Description | Probe Placement |
|
Freeze Placement | Disables probe position recalculation after the first bake. Makes it possible to bake Scenarios so they're compatible for blending purposes. | ||
Max Distance Between Probes | The maximum distance between probes, in meters. See Display and adjust Probe Volumes for additional information. | ||
Min Distance Between Probes | The minimum 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 Volume Size | The smallest Renderer size HDRP considers when it places probes. | ||
Dilation Settings | |||
Enable Dilation | Enables HDRP giving invalid probes data from valid probes nearby. Enabled by default. See Fix issues with Probe Volumes. | ||
Dilation Distance | Determines how far from an invalid probe HDRP searches for valid neighbors. Higher values include more distant probes. Probes that are too far away may be in different lighting conditions than the invalid probe. | ||
Dilation Validity Threshold | 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 Iteration Count | The number of times Unity repeats the dilation calculation. This increases spread of dilation effect, but requires additional processing power. | ||
Squared Distance Weighting | Enables weighing the contribution of neighbouring probes by squared distance, rather than linear distance. | ||
Virtual Offset Settings |
|||
Use Virtual Offset | Enables HDRP moving the capture point of invalid Light Probes so they're valid again. See Fix issues with Probe Volumes. | ||
Advanced | |||
Search multiplier | Determines 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. | ||
Bias Out Geometry | Determines how far HDRP pushes a probe's capture point out of geometry after one of its sampling rays hits geometry. | ||
Ray origin bias | 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 hits per ray | How many times a sampling ray hits geometry before HDRP determines the position of the probe where that ray originated. | ||
Collision mask | Layers HDRP includes in collision calculations for [Virtual Offset](probevolumes-fixissues.md). | ||
Stats | |||
|
Control | Description | |||
Load All Scenes in Set | Load all Scenes in this Baking Set. | |||
Clear Loaded Scenes Data | Clear baked lighting data for all loaded Scenes. | |||
Generate Lighting |
Bakes lighting for the active scene. For additional options, use the dropdown arrow on this button. These controls bake all Scene lighting, not just Probe Volumes. If you bake individual Scenes separately, then together, the new shared baked data overwrites the unique data in each of the individual Scenes.
|
Probe Volume properties
Select a Probe Volume and open the Inspector to view its properties.
Property | Description |
---|---|
Global | Enable to fit this Probe Volume to all Renderers in the Project that contribute Global Illumination. The list of Renderers updates every time you save or bake a Scene. Disable to resize this Probe Volume manually or select a different scope option, such as Fit to Scene. |
Size | The size of the Probe Volume. |
Fill Empty Spaces | Enable to make Unity fill the empty space between Renderers with bricks at the lowest density. |
Subdivision Override | |
Distance Between Probes | Set the maximum and minimum distance between probes. See Display and adjust Probe Volumes. |
Geometry Settings | If this Probe Volume isn't Global, use these settings to set its size. |
Geometry Settings
Override Renderer Filters | Enable to override the Renderer Filter configuration of the Baking Set to which this Scene belongs. | |
Layer Mask | Layers HDRP considers when it generates probe positions. | |
Min Volume Size | The minimum bounding box volume of Renderers Unity considers when it generates probe positions. | |
Fit to all Scenes | Fits this Probe Volume to all loaded Scenes. | |
Fit to Scene | Fits this Probe Volume to the active Scene. | |
Fit to Selection | Fits this Probe Volume to selected Renderers. Lock the Inspector to make additional selections. |
Probe Volume Touchup Component
Select a Probe Volume Touchup Component and open the Inspector to view its properties.
Property | Description |
---|---|
Size | The size of the Touchup Volume. |
Invalidate Probes | Enables making all the Light Probes in this volume invalid. |
Override Dilation Validity Threshold | Enables overriding Dilation Validity Threshold in the Probe Volume Settings. |
Dilation Validity Threshold | The value that will override the Dilation Validity Threshold value in the Probe Volume 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
The resize handles you use for other GameObjects do not resize a Probe Volume. In this screenshot, a red box indicates one of the handles.
The resize handles for Probe Volumes.