Editor de materiais
O separador Material edita assets PBR .mat no editor
Rust, enquanto o motor detém o modelo de material, o renderer de pré-visualização e o
formato CAFMAT3.
Onde vive#
| Parte | Dono | Localização |
|---|---|---|
| Painel Material (UI Rust) | Doppio | uikit/panels/material.rs |
| Modelo e formato de material | Motor | src/caffeine/assets/MaterialTypes.hpp, MaterialFile.cpp |
| Pré-visualização offscreen | Motor | src/caffeine/render/MaterialPreviewRenderer.cpp |
| Shader PBR | Motor | scene_lit.frag / terrain_lit.frag |
O MaterialEditorPanel.cpp C++ arquivado não é o editor atual. O Doppio lê e escreve
materiais através da C ABI, e o painel é uma vista Rust pura sobre
doppio_engine::Material.
Fluxo de dados#
- Abra ou crie um
.mat(o ficheiro começa porCAFMAT3;CAFMAT1eCAFMAT2continuam a ser carregados). - Uma edição de campo atualiza
MaterialSurfaceem memória. A crate do motor envolvecaffeine_material_save,caffeine_session_apply_materiale o par assíncronocaffeine_session_render_material_preview_begin/..._poll. - O motor atualiza a cache de materiais e pede um novo frame ao renderer de pré-visualização; o viewport lê a mesma superfície.
- O renderer desenha uma esfera num pequeno chão com luz direcional e o céu da cena, usando HDR, a stack de post-processing e probes de reflexão.
- Save escreve
CAFMAT3em disco; o material fica disponível no asset browser e nas cenas.
Nota. O albedo é guardado em sRGB como escolhido no editor. O renderer lineariza no shader; não pré-linearize valores num script.
Secções do painel#
| Secção | Campos |
|---|---|
| Surface | Albedo (RGBA), metallic, roughness, reflectance, cor e intensidade da emissão. |
| Maps | Slots de albedo, normal, ORM e emissão com asset pickers, normal strength, AO strength e convenção DirectX da normal. |
| UV | Tiling, offset e UVs com escala de objeto (um mesh a 2× mantém a densidade da textura). |
| Advanced | Alpha mode e cutoff, transmission e IOR, clearcoat e roughness, cor e roughness do sheen, força/espessura/IOR da iridescência, controlos de reflexão e parallax/displacement. |
| Baker | Bakes normal/AO/roughness/metallic/ORM, packings Unity, resolução e força. |
A altura é lida do canal alpha do normal map. heightScale ativa parallax occlusion;
displacementMode = 1 passa a displacement geométrico com subdivisão do mesh, para a
silhueta mudar e o relevo projetar sombras reais.
Pré-visualização#
A esfera usa o mesmo shader scene_lit do viewport. Os controlos do painel escolhem a
forma, o ambiente, a exposição, a geração de luz e o yaw/elevação/intensidade do sol.
TAA, probes e auto-exposure pedem frames extra até a imagem convergir.
.mat aberto.Material Generator#
O separador Material Generator partilha o painel central com o viewport. É um grafo de nós sobre imagens, ruído, padrões, filtros, blends e saídas, com pré-visualização ao vivo, vistas de canal (base, normal, height, roughness, AO, emissive, opacity, metal) e channel packing para ORM e layouts Unity. Bake to Material escreve os mapas selecionados no material aberto.
Veja o material pipeline e o guia de materiais.
Formato de ficheiro#
| Ficheiro | Função |
|---|---|
MaterialTypes.hpp |
MaterialSurface, MaterialAlphaMode, defaults e validação. |
MaterialFile.cpp |
Leitura/escrita CAFMAT3 e sanitizeMaterialSurface. |
MaterialPresets.hpp |
Presets nomeados (mirror, chrome, gold, glass…). |
MaterialPreviewRenderer.cpp |
Mundo de preview offscreen, luzes e readback. |