This documentation is for a prerelease version of O3DE. Click here to switch to the latest release, or select a version from the dropdown.

Version:

Reflection Probe Component

A Reflection Probe applies specular reflections to meshes that are inside the volume of the probe. The reflections are stored as a cubemap, using the entity position of the Reflection Probe as the capture point when it is baked.

Each Reflection Probe consists of two volumes: an outer volume, specified using a Box shape component, and an inner volume. The outer volume defines the total area affected by the probe and is subject to blending with other overlapping probe volumes and the Global IBL specular cubemap. The inner volume defines the area that renders exclusively with the probe cubemap, meaning there is no blending from other probes or Global IBL. Note that the smallest volume is used if multiple probe inner volumes overlap.

Provider

Atom Gem

Dependencies

Box Shape component

Properties

Reflection Probe component properties

Inner Extents properties

PropertyDescriptionValuesDefault
HeightThe height of the reflection probe’s inner volume. The height is dependent on the Box Shape component’s dimension along the z-axis.0 to the Box Shape component’s Dimensions-Z propertyThe value of the Box Shape component’s Dimensions-Z property.
LengthThe length of the reflection probe’s inner volume. The length is dependent on the Box Shape component’s dimension along the y-axis.0 to the Box Shape component’s Dimensions-Y propertyThe value of the Box Shape component’s Dimensions-Y property.
WidthThe width of the reflection probe’s inner volume. The width is dependent on the Box Shape component’s dimension along the x-axis.0 to the Box Shape component’s Dimensions-X propertyThe value of the Box Shape component’s Dimensions-X property.

Settings properties

PropertyDescriptionValuesDefault
Parallax CorrectionCorrects the reflection by adjusting an offset from the capture position.BooleanEnabled
Show VisualizationShows a sphere to visualize the probe.BooleanEnabled
ExposureThe exposure to use when applying the reflection cubemap to the scene.-5.0 to 5.00.0

Cubemap Bake properties

PropertyDescriptionValuesDefault
Bake Reflection ProbeBakes the surrounding environment to a cubemap.--
Bake ExposureThe exposure to use when baking the reflection cubemap.-16.0 to 16.00.0

Cubemap properties

PropertyDescriptionValuesDefault
Use Baked CubemapIf enabled, uses a baked cubemap to create reflections.BooleanEnabled
Baked Cubemap QualityThe resolution of the baked cubemap.Very Low, Low, Medium, High, Very HighMedium
Baked Cubemap pathThe path to the baked cubemap file. When you bake a cubemap, this property automatically generates the path to the cubemap file.--