# ReflectionProbe3D

Local cubemap reflections inside a probe box.

```{raw} html
<span class="example-docs-badge">📄 Docs only</span>

```

**Tags:** `3d` `reflection` `ibl` `probe`

A mirror-finish sphere sits inside a ReflectionProbe3D placed in a room with
vividly coloured interior walls (red/green/blue/yellow). The probe captures the
room into a local cubemap, so the sphere reflects the *room* colours, clearly
different from the faint global sky reflection a sphere would otherwise pick up.

Phase-1 desktop renderer feature:
  - Scene captured six times from the probe origin into a cubemap.
  - The engine's existing split-sum IBL precompute (irradiance + prefiltered
    specular) runs per-probe; results land in a shared cubemap array.
  - Fragments inside the probe box sample the local probe IBL (box-projected
    reflection); fragments outside fall back to the global environment IBL.

Run windowed:   uv run python examples/features/3d/reflection_probe.py
Run headless:   uv run python examples/features/3d/reflection_probe.py --test

Controls:
    Escape  - Quit

## Source

```{literalinclude} ../../examples/features/3d/reflection_probe.py
:language: python
:linenos:
```