docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    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
    Baking Sets Lists the Baking Sets in your Project. Use + and - to add or remove a Baking Set.
    Scenes Lists the Scenes in the Baking Set selected.
    Each Scene includes a probes icon if the Scene has one or more Probe Volumes.
    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 Lists the Lighting Scenarios in the Baking Set selected.
    Active Scenario appears if this is the active scenario HDRP bakes lighting data into. Not baked appears if you haven't baked lighting data into the Lighting Scenario.
    To rename a Scenario, double-click its name.

    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
    • Active Scenario Size on Disk
    • Baking Set Total Size on Disk

    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.
    • Bake the set: Bakes lighting for all Scenes in this Baking Set.
    • Bake loaded Scenes: Bakes lighting for all Scenes loaded in the Scene Hierarchy that are part of the selected Baking Set.
    • Bake active Scene: Bakes the Scene selected in the Scene Hierarchy.

    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 FiltersEnable to override the Renderer Filter configuration of the Baking Set to which this Scene belongs.
     Layer MaskLayers 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 ScenesFits this Probe Volume to all loaded Scenes.
    Fit to SceneFits 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:

    1. Add a Volume to your Scene and make sure its area overlaps the position of the camera.
    2. 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.

    In This Article
    Back to top
    Copyright © 2025 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)