Filament 材质模型参数

材质模型一览

层叠顺序（外→内）

文档规定 lobe/层从外到内堆叠。结合 clearCoat、sheen、iridescence 专节：

flowchart TB
  CC["clearCoat + clearCoatRoughness / Normal"]
  IR["iridescence 薄膜"]
  SH["sheenColor + sheenRoughness"]
  BASE["Base: baseColor / metallic / roughness / reflectance ..."]
  CC --> IR --> SH --> BASE

上图：清漆在最外；彩虹膜在清漆下、sheen 上；sheen 在基座层之上。不需要某层时不要写该属性（哪怕写 0）——文档写明 clearCoat/anisotropy 赋 0 仍会增加开销。

Lit 核心参数（美术向）

reflectance 与 ior 描述同一物理量：通常只设其一，另一自动推导；两者都设可做出「物理不可能但艺术需要」的材质。

扩展层（生产向）

• clearCoat / clearCoatRoughness：车漆、易拉罐清漆、亮光木器等各向同性电介质罩层；强度宜 0/1。会约 加倍镜面计算成本。默认 clearCoatIorChange=true 时基座 baseColor 会因 IOR 变化显得变暗。
• sheenColor / sheenRoughness：织物绒毛感；位于 clearCoat 之下。若只要布料外观，用 Cloth 模型更省。
• iridescence（+ IOR、厚度 nm）：薄膜干涉色；默认厚度 400 nm；约 <100 nm 几乎无色，过厚则干涉过密不可读。实现近似 glTF KHR_materials_iridescence；Cloth 模型不可用。
• transmission / absorption / thickness / microThickness / dispersion / ior：透射与吸收；absorption 衰减 $e^{-\mathrm{absorption}\cdot\mathrm{distance}}$；艺术向可用透过色反推 $\mathrm{absorption}=-\ln(\mathrm{color})/\mathrm{distance}$。
• secondRoughness (+ weight)：第二镜面瓣（如金属铜绿）；始终各向同性。

Cloth / Subsurface 要点

Cloth：无 metallic/reflectance；额外 sheenColor（默认 $\sqrt{\mathrm{baseColor}}$）、subsurfaceColor（慎用高值，可干扰阴影）。丝绒：暗 baseColor + 亮/饱和 sheenColor。牛仔等：固有色在 baseColor，sheen 取亮度或默认。皮革/丝绸/缎面仍宜标准或各向异性 Lit。

与 UE / Substance 对照

线性色与预乘 Alpha

Filament 材质 RGB 均为线性；透明混合假定预乘 alpha。从 Substance 导出或手写常量时，勿把 8bit sRGB 字节直接当线性。见文档 §6 Handling colors 与 显示编码与 sRGB。

取舍

Lit 参数面很全，但每开一层（清漆、各向异性、第二粗糙、透射）都有明确成本开关——美术调「看起来有层」前，TA 应确认是否该用专用模型（Cloth）或简化层数。与 UE Substrate 的分层哲学相近但 API 不同，见 Substrate 材质。