Materiais no passe forward 3D
O que o shader forward avalia realmente para meshes e terreno, os slots de sampler por trás disso, e porque os antigos campos “Phong” são hoje apenas dados legados.
Shaders:
src/caffeine/render/shaders/scene_lit.vert/.frag,terrain_lit.fragRenderer:GpuSceneRenderer
Visão Geral#
As meshes com um .mat usam metallic, roughness, ORM e emission. Ver
materials-pbr.md. O passe GPU avalia um lóbulo especular GGX:
final = ambient/IBL + Σ (diffuse Lambert + specular GGX) × shadow
- Difuso:
max(dot(N, L), 0) × albedo × lightColor × (1 - metallic) - Especular: GGX com roughness e metallic
- Normal mapping:
Nvia TBN e textura normal (meshes) ou triplanar (terreno)
O terreno (terrain_lit.frag) é um dieléctrico rugoso: difuso Lambert mais IBL do céu, com
normal map triplanar. Não tem lóbulo especular.
Componentes ECS#
MeshFilterComponent#
struct MeshFilterComponent {
MeshPrimitive primitive = MeshPrimitive::Cube;
std::string customMeshPath;
std::string customTexturePath;
std::string customNormalPath; // relativo ao projecto
std::string customMaterialPath;
f32 shininess = 32.0f; // legado; mantido para serialização
};
Inspector (Doppio): Albedo Texture, Normal Map, Shininess.
O shininess já não é lido pelo shader: o passe forward tira roughness e metallic do .mat
ou do material glTF embutido.
TerrainComponent#
char normalMapPath[256] = {};
f32 shininess = 16.0f; // legado; a iluminação do terreno não tem termo especular
bool castShadows = true;
bool receiveShadows = true;
Inspector: Normal Map, Shininess, Albedo Texture (camadas de splat).
Pipeline GPU#
flowchart LR
A[Shadow passes] --> B[Opaque pass]
B --> C[scene_lit / terrain_lit]
C --> D[Framebuffer viewport]
renderDirectionalShadows()— até 2 lâmpadas direcionais comcastShadows.renderPointShadows()/renderSpotShadows()— até 2 lâmpadas pontuais e 2 spot.- Passe principal com o UBO de luzes, o UBO de sombras e os uniforms de material.
Samplers (meshes — scene_lit.frag)#
| Slot | Textura |
|---|---|
| 0 | Albedo |
| 1 | Normal map |
| 2–3 | Shadow maps direcionais |
| 4–5 | Cubemaps de sombra pontual |
| 6–7 | Shadow maps de spot |
| 8 | Reflexão planar |
| 9 | Cubemap de probe de reflexão |
| 10 | Mapa ORM |
| 11 | Environment (céu) |
| 12–13 | Cor / profundidade do frame anterior (SSR, TAA) |
| 14 | Mapa de emission |
| 15 | Cópia da cena opaca (blend) |
Samplers (terreno — terrain_lit.frag)#
| Slot | Textura |
|---|---|
| 0 | Splat map |
| 1–4 | Camadas de splat |
| 5 | Normal map triplanar |
| 6–7 | Shadow maps direcionais |
| 8–9 | Cubemaps de sombra pontual |
| 10–11 | Shadow maps de spot |
Tangentes#
MeshLoader::computeMeshTangents() calcula tangentes por vértice (MikkTSpace simplificado)
depois de um import OBJ/glTF. O vertex shader constrói a matriz TBN:
TBN = mat3(normalize(T), normalize(B), normalize(N))
N' = normalize(TBN * (sample(normalMap) * 2 - 1))
Ver também#
materials-pbr.md— parâmetros do.mate o editor de materiaisshadow-mapping.md— passes de sombra GPU e a regra dos samplers../assets/mesh-loading.md— tangentes e import../terrain/terrain-system.md— sombreamento do terreno