# Sandbox.IndirectLightVolume

Dynamic Diffuse Global Illumination volume that provides indirect lighting using a 3D probe grid.
Probes store irradiance and distance data in volume textures that can be sampled by shaders.

- Kind: class
- Namespace: `Sandbox`
- Assembly: `Sandbox.Engine`
- Inherits: [Sandbox.Component](/api/Sandbox.Component)
- Modifiers: sealed

## Constructors

- [`IndirectLightVolume`](/api/Sandbox.IndirectLightVolume/.ctor)

## Properties

- [`Bounds`](/api/Sandbox.IndirectLightVolume/Bounds): World-space bounding box that defines the volume coverage area.
- [`Contrast`](/api/Sandbox.IndirectLightVolume/Contrast): Controls how much less energy to conserve during probe integration. Higher values give a harsher, more contrasty look.
- [`DistanceTexture`](/api/Sandbox.IndirectLightVolume/DistanceTexture): Volume texture storing probe distance/visibility data.
- [`InsideGeometry`](/api/Sandbox.IndirectLightVolume/InsideGeometry): How to handle probes detected inside geometry.
- [`IrradianceTexture`](/api/Sandbox.IndirectLightVolume/IrradianceTexture): Volume texture storing probe irradiance data (color).
- [`NormalBias`](/api/Sandbox.IndirectLightVolume/NormalBias): Bias applied along surface normals to prevent self-occlusion artifacts.
- [`ProbeCounts`](/api/Sandbox.IndirectLightVolume/ProbeCounts): Calculated probe count along each axis based on bounds and density.
- [`ProbeDensity`](/api/Sandbox.IndirectLightVolume/ProbeDensity): Number of probes per 1024 world units. Higher values increase probe resolution.
- [`RelocationTexture`](/api/Sandbox.IndirectLightVolume/RelocationTexture): Volume texture storing probe relocation offsets (XYZ = offset, W = active).
- [`RenderExcludeTags`](/api/Sandbox.IndirectLightVolume/RenderExcludeTags): Objects with any of these tags will be excluded when baking probes for this volume.

## Methods

- [`BakeAll`](/api/Sandbox.IndirectLightVolume/BakeAll)
- [`BakeProbes`](/api/Sandbox.IndirectLightVolume/BakeProbes): Starts the probe baking process to capture lighting into the volume textures.
- [`BakeProbesUnavailableMessage`](/api/Sandbox.IndirectLightVolume/BakeProbesUnavailableMessage)
- [`ClearProbeRelocation`](/api/Sandbox.IndirectLightVolume/ClearProbeRelocation): Clears all probe relocation offsets.
- [`ComputeProbeRelocation`](/api/Sandbox.IndirectLightVolume/ComputeProbeRelocation): Computes probe relocation offsets for all probes in the volume. Uses iterative refinement with mesh tracing. All computations are relative to probe spacing for resolution-independent behavior.
- [`ExtendToSceneBounds`](/api/Sandbox.IndirectLightVolume/ExtendToSceneBounds): Automatically sizes the volume to encompass all scene geometry.