Documentation

Unity Engine

Unity Engine

Probe Adjustment Volume component reference

Reference for the Probe Adjustment Volume component.
Read time 4 minutesLast updated a month ago

Select a Probe Adjustment Volume Component and open the Inspector to view its properties.
Refer to the following for more information about using the Probe Adjustment Volume component:

Property

Description

Influence VolumeSets the shape, size and radius of the Adjustment Volume. The options are:
  • 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.
ModeSets how Unity overrides probes inside the Adjustment Volume.

Mode

Value

Description

Invalidate ProbesMark selected probes as invalid. Refer to How light probe validity works for more information.
Override Validity ThresholdOverride the threshold URP uses to determine whether Light Probes are marked as invalid. Refer to Adjust Dilation for more information.
Apply Virtual OffsetChange the position Light Probes use when sampling the lighting in the scene during baking. Refer to Adjust Virtual Offset for more information.
Override Virtual Offset SettingsOverride the biases URP uses during baking to determine when Light Probes use Virtual Offset, and calculate sampling positions. Refer to Adjust Virtual Offset for more information.
Intensity ScaleOverride the intensity of probes to brighten or darken affected areas.
Override Sky DirectionOverride the directions Unity uses to sample the ambient probe, if you enable sky occlusion.
Override Sample CountOverride the number of samples Unity uses for Adaptive Probe Volumes.
Override Rendering Layer MaskControl the Rendering Layer Mask for probes inside the Adjustment Volume. This option only appears if Rendering Layer Masks are enabled in the Baking Set. Refer to Use Rendering Layer Masks.

Mode settings

Property

Description

Dilation Validity ThresholdOverride the ratio of backfaces a probe samples before URP considers it invalid. This option only appears if you set Mode to Override Validity Threshold, and you enable Advanced Properties.
Virtual Offset RotationSet 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 DistanceSet how far URP pushes probes along the Virtual Offset Rotation vector. This option only appears if you set Mode to Apply Virtual Offset.
Geometry BiasSets how far URP 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 BiasOverride the distance between a probe's center and the point URP uses to determine the origin of that probe's sampling ray. This can be used to push rays beyond nearby geometry if the geometry causes issues. This option appears only if you set Mode to Override Virtual Offset Settings.
Intensity ScaleChange the brightness of all probes covered by the Probe Volumes Adjustment Volume component. 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 Intensity Scale.
Sky DirectionSet the direction Unity uses to sample the ambient probe. This option only appears if you set Mode to Override Sky Direction.
Rendering Layer Mask OperationChoose how to combine the volume’s mask with the probes’ mask: Override replaces the probes’ mask, Add adds the selected mask, Remove removes the selected mask. This option only appears if you set Mode to Override Rendering Layer Mask.
Rendering Layer MaskSelect the mask defined in the Baking Set. Up to four masks are supported and displayed by name. This option only appears if you set Mode to Override Rendering Layer Mask.

Probes

Property

Description

Direct Sample CountSet the number of samples Unity uses to calculate the direct light each probe stores. This option only appears if you set Mode to Override Sample Count.
Indirect Sample CountSet the number of samples Unity uses to calculate the indirect light each probe stores, including environment samples. This option only appears if you set Mode to Override Sample Count.
Sample Count MultiplierSet the value Unity multiplies Direct Sample Count and Indirect Sample Count by. This option only appears if you set Mode to Override Sample Count.
Max BouncesSet the number of times Unity bounces light off objects. This option only appears if you set Mode to Override Sample Count.

Sky Occlusion

Property

Description

Sample CountSet the number of samples Unity uses to calculate the amount of light each probe receives from the sky, if you enable sky occlusion. This option only appears if you set Mode to Override Sample Count.
Max BouncesSet the number of times Unity bounces light from the sky off objects to calculate the sky occlusion data, if you enable sky occlusion. This option only appears if you set Mode to Override Sample Count.