Legacy Documentation: Version 5.0
Skybox
LOD Group

Reflection Probe

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Sumbission failed

For some reason your suggested change could not be submitted. Please try again in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Switch to Scripting

A Reflection Probe is rather like a camera that captures a spherical view of its surroundings in all directions. The captured image is then stored as a Cubemap that can be used by objects with reflective materials. Several reflection probes can be used in a given scene and objects can be set to use the cubemap produced by the nearest probe. The result is that the reflections on the object can change convincingly according to its environment.

A Reflection Probe showing reflections from a nearby object
A Reflection Probe showing reflections from a nearby object

Properties

Property: Function:
Type Is the probe for a Baked, Custom or Realtime setup?
Dynamic Objects (Custom type only) Forces objects not marked as Static to be baked in to the reflection.
Cubemap (Custom type only) Sets a custom cubemap for the probe.
Refresh Mode (Realtime type only) Selects if and how the probe will refresh at runtime. The On Awake option renders the probe only once when it first becomes active. Every Frame renders the probe every frame update, optionally using Time Slicing (see below). The Via Scripting option refreshes the probe from a user script command rather than an automatic update.
Time Slicing (Realtime type only) How should the probe distribute its updates over time? The options are All Faces At Once (spreads update over nine frames), Individual Faces (updates over fourteen frames) and No Time Slicing (the update happens entirely within one frame). See below for further details.
Runtime Settings
Importance The degree of “importance” of this probe compared to its neighbours. Higher values indicate greater importance; more important probes will have priority over less important one in cases where an object is within range of two or more probes. This setting also affects the Blending, explained below.
Intensity The intensity modifier that is applied to the texture of this probe in its shader.
Box Projection Should box projection be enabled for reflection UV mappings?
Size The size of the zone within which objects will be affected by this probe’s reflection cubemap. Also used by Box Projection.
Probe Origin The centre point of the probe’s zone of effect which is also used while baking the probe. Also used by Box Projection.
Cubemap Capture settings
Resolution The resolution of the captured reflection image.
HDR Should High Dynamic Range rendering be enabled for the cubemap? This also determines whether probe data is saved in OpenEXR or PNG format.
Shadow Distance Distance at which shadows are drawn when rendering the probe.
Clear Flags Option to specify how empty background areas of the cubemap will be filled. The options are Skybox and Solid Color.
Background Background colour to which the reflection cubemap is cleared before rendering.
Culling Mask Allows objects on specified layers to be included or excluded in the reflection. See the section about the Camera’s culling mask on the Layers page.
Use Occlusion Culling Should occlusion culling be used when baking the probe?
Clipping Planes Near and far clipping planes of the probe’s “camera”.

Details

At the top of the Reflection Probe inspector are two buttons that are used for editing the Size and Probe Origin properties directly within the scene. With the leftmost button (Size) selected, the probe’s zone of effect is shown in the scene as a yellow box shape with handles to adjust the box’s size.

The other button (Origin) allows you to drag the probe’s origin relative to the box. Note that the origin handle resembles the Transform position handle but the two positions are not the same. Also, the rotation and scale operations are not available for the probe box.

The probe’s Type property determines how the reflection data is created and updated:

  • Baked probes store a static reflection cubemap generated by baking in the editor.
  • Custom probes store a static cubemap which can either be generated by baking or set manually by the user.
  • Realtime probes update the cubemap at runtime and can therefore react to dynamic objects in the scene.

To make use of the reflection cubemap, an object must have the Reflection Probes option enabled on its Mesh Renderer and also be using a shader that supports reflection probes. When the object passes within the volume set by the probe’s Size and Probe Origin properties, the probe’s cubemap will be applied to the object.

You can also manually set which reflection probe to use for a particular object using the settings on the object’s Mesh Renderer. To do this, select one of the options for the Mesh Renderer’s Reflection Probes property (Simple, Blend Probes or Blend Probes and Skybox) and drag the chosen probe onto its Anchor Override property.

See the Reflection Probes section in the manual for further details about principles and usage.

Skybox
LOD Group