Skip to content

Component Icon Dynamic Occlusion (Depth Buffer) Component



The Dynamic Occlusion features (Raycasting and Depth Buffer) give awareness to your light beams: they react to the changes in the environment. Light Beams can be blocked and occluded by 3D or 2D geometry.

Dynamic Occlusion Off Dynamic Occlusion On
Dynamic Occlusion OFF Dynamic Occlusion ON

Without this feature, Volumetric Light Beams SD are not blocked by geometry: think about it like a Light with disabled shadows. This means that if you place a light beam against a wall, the light beam could shine through it and be visible from the other side.

Which Dynamic Occlusion should I use?

The plugin supports 2 different implementations of dynamic occlusion. You might be interested in using one or the other (or both) depending on your needs.
In short, Dynamic Occlusion using the Depth Buffer provides a more precise occlusion system, while using Raycasting offers better performance and supports 2D (a 2D sprite can be an occluder).
However none of these techniques perform true volumetric shadow. To achieve this, you have to use a Volumetric Light Beam HD with a Volumetric Shadow HD component.

Feature Raycasting Depth Buffer
Performance +++ ++
Partial occlusion No
(it can only be either fully blocked or not blocked)
Complex occluders No
(computed using only a single virtual plane)
Small occluders Yes
(occluders smaller than beam's radius won't be caught by depth buffer)
Require a Collider component on each occluder Yes No
2D support Yes No
True volumetric shadow No No

Dynamic Occlusion in Editor & Playmode

To maximize performance, when you are playing your game in the Editor, the Dynamic Occlusion will only be updated if at least one game camera looks at your beam.
This means you might see wrong occlusion effect applied on a beam in the Editor's Scene View if no game camera looks at it.


Inspector Dynamic Occlusion

This feature creates a virtual camera per beam to capture the depth buffer from the beam's point of view. It uses this depth texture to compute a very precise occlusion capable of handling partial and complex occlusions.


The Dynamic Occlusion (Depth Buffer) component must be attached to a Volumetric Light Beam. You can use this button at the bottom of the Volumetric Light Beam inspector.

Attach Dynamic Occlusion to a light beam


Layer Mask

The beam can only be occluded by objects located on the layers matching this mask.

Performance consideration

  • It's very important to set it as restrictive as possible (checking only the layers which are necessary) to perform a more efficient process in order to increase the performance.
  • You have to set an Override Layer in the Config when using this feature, and make sure the Layer Mask does NOT include this Override Layer to prevent from having a Layer Mask including any Volumetric Beam.

Occlusion Culling

Whether or not the virtual camera will use occlusion culling during rendering from the beam's POV.

Depth Map Resolution

Controls how large the depth texture captured by the virtual camera is.
The lower the resolution, the better the performance, but the less accurate the rendering.

Occluder Surface

Fade Distance Units

Fade out the beam before the occlusion surface in order to soften the transition.

Fade Distance Fade Distance
0.25 1.0

Update Rate

Update Rate

How often will the occlusion be processed?
Try to update the occlusion as rarely as possible to keep good performance.

  • Never: The occlusion will never be updated.
    The only way to update it is to manually call 'ProcessOcclusionManually()' from script whenever you need.
  • OnEnable: The occlusion will only be updated once on start, and each time the beam is enabled/activated (after being disabled/deactivated).
    It's suitable for static beams located in static environment.
  • OnBeamMove: The occlusion will only be updated when the beam will move.
    It's suitable for moving beams located in static environment.
  • EveryXFrames: The occlusion will be updated every X frame(s).
    It's suitable for static beams located in moving environment.
  • OnBeamMoveAndEveryXFrames: The occlusion will be updated when the beam will move in addition to every X frame(s).
    It's suitable for moving beams located in moving environment.

X frames to wait

How many frames we wait between 2 occlusion tests?

  • If you want your beam to be super responsive to the changes of your environment, update it every frame by setting 1.
  • If you want to save on performance, we recommend to wait few frames between each update by setting a higher value. For example with the value 3, the system will perform 1 occlusion test every 3 frames.