# indicatrix-cut — the `gpu` feature and its fallback rules
What the `gpu` feature routes through the GPU megakernel, the measured speedup,
and exactly when and why a frame or batch falls back to the CPU tracer instead.
For everything else see [the README](../README.md).
```
cargo build -p indicatrix-cut --features gpu
```
Routes both the viewport's progressive accumulation *and* the high-resolution
export worker through `indicatrix`'s verified GPU megakernel
(`indicatrix::renderer::gpu::frame`) instead of the multithreaded CPU tracer. **Off
by default**, so an ordinary build pulls in neither `wgpu` nor `pollster` and
behaves exactly as it did before the feature existed.
Export is where it matters most — a 4K render at 1024 spp is ~8.5 billion
spectral paths. Measured on this project's integrated AMD Radeon (Vulkan), at
960x540 / 64 spp / 12 bounces on Emerald: **1.44 s on GPU vs 10.66 s across 16
CPU threads, a 7.4x speedup**. A discrete GPU widens that considerably.
The fallback is per frame (per batch, for an export), not per session, and is a
normal outcome rather than an error — each frame or batch is offered to the GPU
and falls through to the CPU tracer whenever it declines:
| No usable adapter on this machine | Logged once at startup; every frame then uses the CPU |
| The environment is an HDR map | The megakernel has no `env_mode` for it |
Biaxial materials (Alexandrite, Topaz, Tanzanite) are **not** on that list any
more: the `BiaxialIndicatrix` machinery is ported to WGSL and verified at the
same Tier 2 / Tier 3 bar as every other material, so `GemMaterial::gpu_supported`
is now unconditionally `true`. See `indicatrix::renderer::gpu_backend`'s module doc
comment for the authoritative decline list.
Both the viewport (`bridge::render_thread`) and the export worker
(`bridge::export_thread`) go through the same `bridge::gpu_backend::FrameGpu`, so
there is one decline-and-fall-back rule rather than two that could drift apart.
Both backends *add* into the same accumulation buffer with the same meaning for
the sample counter, so a render that switches between them mid-flight continues a
correct running average rather than restarting.
One thing the GPU cannot supply is the denoiser's first-hit depth/normal/facet-id
guide buffers — the megakernel returns radiance only. That is the same gap a
remote worker's `FRAME` payload has, and it takes the same answer: `bridge::guide_pass`'s
local primary-ray prepass, cached on pose plus geometry, reused unchanged here.