7.5 — GPU Compute (Noise + Erosão)
> **Depende de:** Fase 5 (RHI GPU), 7.1 (algoritmos CPU de referência) > **Quando fazer:** Resolução ≥ 513² ou erosão > 100 iterações com FPS aceitável em CPUObjetivo#
Mover geração procedural pesada (noise fBm, erosão hídrica) para compute shaders, reduzindo tempo de Generate Terrain de segundos para milissegundos em heightmaps grandes.
Escopo Inicial#
| Algoritmo | GPU | CPU fallback |
|---|---|---|
| fBm noise (todas as variantes) | ✅ | ✅ |
| Domain warp | ✅ | ✅ |
| Thermal erosion | ✅ | ✅ |
| Hydraulic erosion | ⚠️ Parcial | ✅ |
| Auto splat | ❌ v1 | ✅ |
| Fault lines / cliffs | ❌ v1 | ✅ |
Arquitetura#
text
TerrainGenerator::generate()
if (device && settings.useGpuGeneration && res >= threshold)
TerrainGpuGenerator::dispatch(heightmapBuffer, settings)
else
pipeline CPU existente
Recursos GPU#
cpp
struct TerrainGpuGenerator {
RHI::Buffer* heightmapBuffer; // SSBO, R32_FLOAT
RHI::Buffer* splatBuffer; // opcional, RGBA32F
RHI::Pipeline* noisePipeline;
RHI::Pipeline* erosionPipeline;
};
Shaders (novos)#
text
src/render/shaders/terrain_gen_noise.comp
src/render/shaders/terrain_gen_erosion.comp
Pipeline Compute#
text
1. Upload heightmap inicial (flat ou seed buffer)
2. Dispatch noise.comp (workgroup 8×8)
3. Dispatch warp.comp (opcional)
4. Loop N: erosion.comp
5. Readback ou usar buffer direto para mesh generation
Evitar readback#
Ideal: mesh generation também no GPU (geometry shader / tessellation) — fase futura.
Mínimo viável: readback só após geração completa → TerrainHeightmap::heights() para TerrainMeshBuilder.
Parâmetros UBO#
glsl
layout(binding = 0) uniform TerrainGenParams {
uvec2 resolution;
uint seed;
uint octaves;
float persistence;
float lacunarity;
float amplitude;
float baseHeight;
float noiseScale;
uint noiseType; // 0=Perlin, 1=Simplex, ...
uint erosionIters;
float thermalTalus;
};
Integração RHI#
Verificar suporte em RenderDevice:
- [ ]
createBuffercomStorage | TransferDst | TransferSrc - [ ]
dispatchCompute(pipeline, groupsX, groupsY, groupsZ) - [ ] Barriers entre compute e transfer
Se SDL_GPU não expuser compute na versão atual → adiar fase ou usar fragment shader fullscreen pass como fallback.
Editor#
- Checkbox Use GPU Generation (só visível se
device->supportsCompute()) - Benchmark label:
Generated in 12.4 ms (GPU)vs1.2 s (CPU)
Critérios de Aceitação#
- [ ] Noise fBm GPU produz resultado visualmente similar ao CPU (tolerância ±2%)
- [ ] 257² generate < 100 ms em GPU dedicada
- [ ] Fallback CPU automático se compute indisponível
- [ ] Sem leak de buffers GPU no shutdown (corrigir UAF em
TerrainGpuTexturesprimeiro)
Riscos#
- Divergência CPU/GPU entre plataformas (SPIR-V vs DXBC)
- Debug mais difícil — manter path CPU sempre funcional
- Readback stall — perfil com timestamp queries