diff --git a/data-pipeline/scripts/build-seed-models.mjs b/data-pipeline/scripts/build-seed-models.mjs index cc2a8b0..3a5def5 100644 --- a/data-pipeline/scripts/build-seed-models.mjs +++ b/data-pipeline/scripts/build-seed-models.mjs @@ -52,13 +52,25 @@ for (const [systemSlug, items] of bySystem) { const scene = doc.createScene(systemSlug); doc.getRoot().setDefaultScene(scene); - const material = doc - .createMaterial(systemSlug) - .setBaseColorFactor(hexToRgb(systemColors[systemSlug] ?? "#cccccc")) - .setRoughnessFactor(0.6) - .setMetallicFactor(0.05); + // Cada item pode pedir uma cor própria (opts.color) pra se distinguir dos + // demais (ex: glândula amarela, vaso vermelho/azul, pelo castanho) em vez + // de todo o sistema sair de uma cor só — cache por hex evita recriar + // material repetido. + const materialCache = new Map(); + function materialFor(hex) { + if (materialCache.has(hex)) return materialCache.get(hex); + const mat = doc + .createMaterial(hex) + .setBaseColorFactor(hexToRgb(hex)) + .setRoughnessFactor(0.6) + .setMetallicFactor(0.05); + materialCache.set(hex, mat); + return mat; + } + const defaultHex = systemColors[systemSlug] ?? "#cccccc"; for (const item of items) { + const material = materialFor(item.color ?? defaultHex); const geo = buildGeometry(item.shape); const posAccessor = doc .createAccessor() diff --git a/data-pipeline/seed/build-manifest.mjs b/data-pipeline/seed/build-manifest.mjs index 00fcec5..5e81dca 100644 --- a/data-pipeline/seed/build-manifest.mjs +++ b/data-pipeline/seed/build-manifest.mjs @@ -1,7 +1,15 @@ // Gera manifest-tegumentar.json: o Z-Anatomy-Sample não inclui camadas de -// pele (epiderme/derme/hipoderme), então para o sistema tegumentar seguimos -// usando geometria esquemática simples (ver data-pipeline/README rodapé). -// Todos os outros sistemas vêm de malhas reais — veja scripts/extract-manifest.mjs. +// pele (epiderme/derme/hipoderme) nem seus anexos (folículo piloso, glândulas +// etc.) — são estruturas microscópicas, nenhum dataset de corpo inteiro as +// modela como malha. Por isso o sistema tegumentar usa um "bloco" esquemático +// (corte transversal de pele, como o diagrama clássico do Netter/Sobotta), +// construído com geometria paramétrica simples (caixas/esferas/cilindros — +// ver scripts/geometry.mjs e scripts/build-seed-models.mjs). +// +// Como as outras estruturas do sistema tegumentar ficam ocultas quando só +// esse sistema está visível, ativar "Tegumentar" sozinho na barra de camadas +// já isola e centraliza a câmera neste bloco (ver computeVisibleBoundingBox +// em Scene.tsx) — funciona como um "zoom didático" na pele. import { writeFileSync } from "node:fs"; import { fileURLToPath } from "node:url"; import path from "node:path"; @@ -24,13 +32,203 @@ function add(system, slug, namePt, nameEn, region, shape, position, opts = {}) { shape, position, rotation: opts.rotation ?? [0, 0, 0], + color: opts.color, }); } -const TX = ["Sistema Tegumentar"]; -add("tegumentar", "epiderme", "Epiderme", "Epidermis", [...TX, "Membro Superior", "Antebraço"], { type: "box", w: 0.09, h: 0.2, d: 0.005 }, [0.24, 0.85, 0.035], { description: "Camada mais externa da pele, avascular." }); -add("tegumentar", "derme", "Derme", "Dermis", [...TX, "Membro Superior", "Antebraço"], { type: "box", w: 0.09, h: 0.2, d: 0.01 }, [0.24, 0.85, 0.028], { description: "Camada intermediária, rica em vasos, nervos e anexos cutâneos." }); -add("tegumentar", "hipoderme", "Hipoderme (Tecido Subcutâneo)", "Hypodermis (Subcutaneous Tissue)", [...TX, "Membro Superior", "Antebraço"], { type: "box", w: 0.09, h: 0.2, d: 0.015 }, [0.24, 0.85, 0.018], { description: "Camada mais profunda, rica em tecido adiposo." }); +const TX = ["Sistema Tegumentar", "Corte Transversal da Pele"]; + +// Centro do "bloco" de pele (coordenadas do mundo, mesma escala do corpo +// Z-Anatomy — colado na face do antebraço). x/y = plano da superfície da +// pele; z = profundidade (z maior = mais externo/superficial). +const CX = 0.24; +const CY = 0.85; +const Z_SURFACE = 0.0375; // topo da epiderme = superfície da pele + +// Cilindros/caixas nascem com o eixo longo em Y; ROT_Z gira esse eixo para +// Z (perpendicular à pele, "entrando" no corpo) — usado por pelo, folículo, +// ducto sudoríparo e a alça capilar, que atravessam as camadas na vertical. +const ROT_Z = [Math.PI / 2, 0, 0]; + +// ---- As 3 camadas da pele ---- +add( + "tegumentar", "epiderme", "Epiderme", "Epidermis", [...TX], + { type: "box", w: 0.09, h: 0.2, d: 0.005 }, [CX, CY, 0.035], + { + color: "#e0a96d", + description: + "Camada mais externa e avascular da pele, formada por epitélio pavimentoso estratificado queratinizado; sua função é a principal barreira contra perda de água, atrito, micro-organismos e raios UV (com a ajuda da melanina).", + }, +); +add( + "tegumentar", "derme", "Derme", "Dermis", [...TX], + { type: "box", w: 0.09, h: 0.2, d: 0.01 }, [CX, CY, 0.028], + { + color: "#c97b4a", + description: + "Camada de tecido conjuntivo rica em colágeno e elastina, vasos sanguíneos, terminações nervosas e os anexos cutâneos (folículos pilosos, glândulas); sustenta a epiderme e dá à pele resistência e elasticidade.", + }, +); +add( + "tegumentar", "hipoderme", "Hipoderme (Tecido Subcutâneo)", "Hypodermis (Subcutaneous Tissue)", [...TX], + { type: "box", w: 0.09, h: 0.2, d: 0.015 }, [CX, CY, 0.018], + { + color: "#f2d4a3", + description: + "Camada mais profunda, rica em tecido adiposo; isola termicamente, absorve impactos e serve de reserva de energia — não é tecnicamente parte da pele, mas a conecta aos músculos e ossos subjacentes.", + }, +); + +// ---- Complexo pilossebáceo (pelo + folículo + músculo eretor + glândula sebácea) ---- +const HX = CX - 0.015, HY = CY + 0.03; +const HAIR_TILT = [Math.PI / 2 + 0.3, 0.2, 0]; + +add( + "tegumentar", "pelo", "Pelo (Haste Capilar)", "Hair Shaft", [...TX, "Complexo Pilossebáceo"], + { type: "cylinder", rt: 0.0006, rb: 0.001, h: 0.02 }, [HX, HY, Z_SURFACE + 0.01], + { + color: "#4a3527", + rotation: HAIR_TILT, + description: + "Porção do pelo visível acima da superfície da pele, formada por células queratinizadas mortas; sua cor vem da melanina produzida no bulbo piloso.", + }, +); +add( + "tegumentar", "foliculo-piloso", "Folículo Piloso", "Hair Follicle", [...TX, "Complexo Pilossebáceo"], + { type: "cylinder", rt: 0.0022, rb: 0.0022, h: 0.03 }, [HX, HY, 0.0225], + { + color: "#8a6a52", + rotation: HAIR_TILT, + description: + "Invaginação da epiderme para dentro da derme/hipoderme que envolve e forma a raiz do pelo; suas células-tronco também participam da regeneração da epiderme após lesões.", + }, +); +add( + "tegumentar", "bulbo-piloso", "Bulbo Piloso", "Hair Bulb", [...TX, "Complexo Pilossebáceo"], + { type: "sphere", r: 0.003 }, [HX - 0.006, HY + 0.012, 0.008], + { + color: "#6b4c38", + description: + "Base dilatada do folículo, na hipoderme; contém a papila dérmica (com vasos que nutrem o pelo) e a matriz germinativa, onde o pelo é produzido por divisão celular.", + }, +); +add( + "tegumentar", "musculo-eretor-do-pelo", "Músculo Eretor do Pelo", "Arrector Pili Muscle", [...TX, "Complexo Pilossebáceo"], + { type: "box", w: 0.0012, h: 0.014, d: 0.003 }, [HX + 0.004, HY - 0.006, 0.0295], + { + color: "#b5433a", + rotation: [1.05, 0, 0], + description: + "Pequeno músculo liso ligado obliquamente ao folículo; ao se contrair (frio, medo), eleva o pelo e comprime a glândula sebácea — é o responsável pela 'pele arrepiada' (piloereção).", + }, +); +add( + "tegumentar", "glandula-sebacea", "Glândula Sebácea", "Sebaceous Gland", [...TX, "Complexo Pilossebáceo"], + { type: "sphere", r: 0.004 }, [HX + 0.007, HY - 0.01, 0.031], + { + color: "#f2c14e", + description: + "Glândula anexa ao folículo piloso que secreta sebo — mistura oleosa que lubrifica o pelo e a pele e ajuda a impermeabilizá-la; sua obstrução está por trás da acne.", + }, +); + +// ---- Glândula sudorípara (écrina) + ducto + poro ---- +const SX = CX + 0.02, SY = CY - 0.02; +add( + "tegumentar", "glandula-sudoripara", "Glândula Sudorípara (Écrina)", "Eccrine Sweat Gland", [...TX, "Glândula Sudorípara"], + { type: "sphere", r: 0.005 }, [SX, SY, 0.014], + { + color: "#4f7cff", + description: + "Porção secretora enovelada, na derme profunda/hipoderme; produz o suor (água + eletrólitos), principal mecanismo de termorregulação do corpo por evaporação.", + }, +); +add( + "tegumentar", "ducto-sudoriparo", "Ducto Sudoríparo", "Sweat Duct", [...TX, "Glândula Sudorípara"], + { type: "cylinder", rt: 0.0012, rb: 0.0012, h: 0.0235 }, [SX, SY, 0.0258], + { + color: "#7ba6ff", + rotation: ROT_Z, + description: + "Canal que conduz o suor da glândula, atravessando a derme e a epiderme, até a superfície da pele.", + }, +); +add( + "tegumentar", "poro-sudoriparo", "Poro Sudoríparo", "Sweat Pore", [...TX, "Glândula Sudorípara"], + { type: "sphere", r: 0.0012 }, [SX, SY, Z_SURFACE + 0.0005], + { + color: "#a9c6ff", + description: "Abertura do ducto sudoríparo na superfície da epiderme, por onde o suor é liberado.", + }, +); + +// ---- Plexo vascular dérmico ---- +const VX = CX - 0.03, VY = CY - 0.05; +add( + "tegumentar", "arteriola-dermica", "Arteríola Dérmica", "Dermal Arteriole", [...TX, "Plexo Vascular Dérmico"], + { type: "cylinder", rt: 0.0012, rb: 0.0012, h: 0.014 }, [VX - 0.003, VY, 0.026], + { + color: "#c1121f", + rotation: ROT_Z, + description: "Ramo arterial que leva sangue oxigenado ao plexo de capilares da derme, nutrindo a pele (a epiderme em si não tem vasos).", + }, +); +add( + "tegumentar", "venula-dermica", "Vênula Dérmica", "Dermal Venule", [...TX, "Plexo Vascular Dérmico"], + { type: "cylinder", rt: 0.0012, rb: 0.0012, h: 0.014 }, [VX + 0.003, VY, 0.026], + { + color: "#3457d5", + rotation: ROT_Z, + description: "Ramo venoso que drena o sangue do plexo capilar dérmico de volta à circulação.", + }, +); +add( + "tegumentar", "alca-capilar-dermica", "Alça Capilar Dérmica", "Dermal Capillary Loop", [...TX, "Plexo Vascular Dérmico"], + { type: "cylinder", rt: 0.0006, rb: 0.0006, h: 0.006 }, [VX, VY, 0.032], + { + color: "#e0464f", + rotation: ROT_Z, + description: "Alça de capilares que sobe até as papilas dérmicas, logo abaixo da epiderme, levando nutrientes e oxigênio para a base da epiderme por difusão.", + }, +); + +// ---- Corpúsculos sensoriais ---- +add( + "tegumentar", "corpusculo-de-meissner", "Corpúsculo de Meissner", "Meissner's Corpuscle", [...TX, "Receptores Sensoriais"], + { type: "sphere", r: 0.0022 }, [CX + 0.03, CY + 0.06, 0.0335], + { + color: "#34d399", + description: + "Receptor sensorial encapsulado logo abaixo da epiderme; detecta toque leve e vibrações de baixa frequência — muito numeroso na ponta dos dedos e nos lábios.", + }, +); +add( + "tegumentar", "corpusculo-de-pacini", "Corpúsculo de Pacini", "Pacinian Corpuscle", [...TX, "Receptores Sensoriais"], + { type: "sphere", r: 0.006 }, [CX + 0.03, CY - 0.06, 0.012], + { + color: "#22d3ee", + description: + "Grande receptor sensorial encapsulado em camadas (como uma cebola), na hipoderme; detecta pressão profunda e vibrações de alta frequência.", + }, +); + +// ---- Tecido adiposo da hipoderme ---- +const FX = CX - 0.02, FY = CY - 0.075; +const FAT_OFFSETS = [ + [0, 0], [0.008, 0.004], [-0.006, 0.006], [0.003, -0.007], +]; +FAT_OFFSETS.forEach(([dx, dy], i) => { + add( + "tegumentar", `adipocito-${i + 1}`, `Lóbulo de Tecido Adiposo ${i + 1}`, `Adipose Tissue Lobule ${i + 1}`, + [...TX, "Tecido Adiposo"], + { type: "sphere", r: 0.006 }, [FX + dx, FY + dy, 0.015], + { + color: "#f7e08c", + description: + "Grupo de adipócitos (células de gordura) da hipoderme; armazena energia, isola termicamente e amortece impactos mecânicos.", + }, + ); +}); writeFileSync( path.resolve(__dirname, "manifest-tegumentar.json"),