Reflexos
Os quatro modos de reflexão que o passe forward suporta — off, planar, screen-space e probes por objecto — e como o renderer recorre ao céu.
Resolver:
Render::resolveForwardRenderFeaturesGPU:GpuSceneRenderer(planar, SSR, probes por objecto) Shader:scene_lit.frag(slots environment + probe + SSR)
Configura-se no componente Forward Render Features (Inspector) ou via
caffeine.forwardrender.*. Sem componente na cena, budgetSafeForwardDefaults() usa o
modo Probe com screen-space tracing ligado.
| Modo | O que faz | Custo |
|---|---|---|
| Off | Apenas céu/IBL | Mínimo |
| Planar | Redesenho espelhado em Y (planeY), alvo HDR, resolutionScale |
+1 passe de cena (sem sombras no espelho) |
| Screen-space | SSR no shader (histórico de cor/profundidade) | Taps por pixel |
| Probe (default) | Cubemap HDR por objecto polido (LRU, ≤ maxReflectionProbes por frame, 1 captura/frame) |
6 faces × resolução do probe |
Only when camera settled adia as capturas caras enquanto a câmara se move (o TAA continua a convergir).
Probes por objecto#
- Objectos com roughness baixa entram na fila; os mais próximos da câmara recebem probe.
- Cubemap
RGBA16Fcom mips; amostragem por draw no shader (slot 9). - A entidade capturada é excluída do próprio cubemap (
excludeEntity) para evitar auto-reflexo. - As faces do cubemap usam a projecção NDC da SDL com Y invertido (top-left, y-up).
SSR#
- Lê a cor e a profundidade do frame anterior (por
viewId). - Os parâmetros vêm de
PostProcessComponent.screenSpaceReflectionsou do bloco Reflections das forward features.
Céu (environment map)#
GpuEnvironmentMap — equirectangular + mips (slot 11):
- Fonte: um
SkyboxComponentactivo ouGpuSceneRenderOptions::environmentPath. - Especular: sempre que o skybox está ligado (metais). Difuso: só com IBL difuso activo.
Onde o passe de probe/planar não tem geometria, o shader recorre ao céu.
Material Editor#
MaterialPreviewRenderer: um mundo mínimo + GpuSceneRenderer + um probe. Ver
../editor/material-editor.md.