reze-engine 0.12.1 → 0.12.2

package/src/shaders/materials/default.ts

@@ -1,140 +1,17 @@
-// Blender 3.6 Principled BSDF defaults + Filmic "Medium High Contrast" tone mapping.
-// Metallic=0, Specular=0.5 (F0=0.04), Roughness=0.5.
-// Tone mapping via LUT sampled from Blender's OCIO pipeline (exposure -0.3 baked in).
+// Default material — Blender 3.6 Principled BSDF defaults, no NPR stack.
+// Metallic=0, Specular=0.5 (F0=0.04), Roughness=0.5. Serves as the EEVEE reference
+// path that every NPR material mixes against in its final stage.
 
 import { NODES_WGSL } from "./nodes"
+import { COMMON_MATERIAL_PRELUDE_WGSL } from "./common"
 
 export const DEFAULT_SHADER_WGSL = /* wgsl */ `
 
 ${NODES_WGSL}
+${COMMON_MATERIAL_PRELUDE_WGSL}
 
-const PI: f32 = 3.141592653589793;
 const DEFAULT_SPECULAR: f32 = 0.5;
-const ROUGHNESS: f32 = 0.5;
-
-struct CameraUniforms {
-  view: mat4x4f,
-  projection: mat4x4f,
-  viewPos: vec3f,
-  _padding: f32,
-};
-
-struct Light {
-  direction: vec4f,
-  color: vec4f,
-};
-
-struct LightUniforms {
-  ambientColor: vec4f,
-  lights: array<Light, 4>,
-};
-
-// Per-material uniforms. Add fields here only when a shader actually reads them;
-// preset-specific shaders (face.ts, future hair.ts) share this struct so the
-// engine can use one material bind-group layout.
-struct MaterialUniforms {
-  diffuseColor: vec3f,  // tint; multiplies sampled albedo (unused by current fs, reserved)
-  alpha: f32,            // 0 → discard; <1 → transparent draw call
-};
-
-struct VertexOutput {
-  @builtin(position) position: vec4f,
-  @location(0) normal: vec3f,
-  @location(1) uv: vec2f,
-  @location(2) worldPos: vec3f,
-};
-
-struct LightVP { viewProj: mat4x4f, };
-
-@group(0) @binding(0) var<uniform> camera: CameraUniforms;
-@group(0) @binding(1) var<uniform> light: LightUniforms;
-@group(0) @binding(2) var diffuseSampler: sampler;
-@group(0) @binding(3) var shadowMap: texture_depth_2d;
-@group(0) @binding(4) var shadowSampler: sampler_comparison;
-@group(0) @binding(5) var<uniform> lightVP: LightVP;
-@group(1) @binding(0) var<storage, read> skinMats: array<mat4x4f>;
-@group(2) @binding(0) var diffuseTexture: texture_2d<f32>;
-@group(2) @binding(1) var<uniform> material: MaterialUniforms;
-
-// ─── Filmic tone mapping (LUT extracted from Blender 3.6 OCIO) ─────
-// View transform = Filmic, Look = Medium High Contrast, Exposure = -0.3.
-// 14 samples at integer log2 stops from -10 to +3 (inclusive).
-// Extracted via scripts/extract_filmic_lut.py → probe image through scene
-// color management. Input: linear scene-referred. Output: sRGB display.
-
-fn filmic(x: f32) -> f32 {
-  var lut = array<f32, 14>(
-    0.0067, 0.0141, 0.0272, 0.0499, 0.0885, 0.1512, 0.2462,
-    0.3753, 0.5273, 0.6776, 0.8031, 0.8929, 0.9495, 0.9814
-  );
-  let t = clamp(log2(max(x, 1e-10)) + 10.0, 0.0, 13.0);
-  let i = u32(t);
-  let j = min(i + 1u, 13u);
-  return mix(lut[i], lut[j], t - f32(i));
-}
-
-fn tonemap(hdr: vec3f) -> vec3f {
-  return vec3f(filmic(hdr.x), filmic(hdr.y), filmic(hdr.z));
-}
-
-// ─── Shadow sampling (3×3 PCF) ──────────────────────────────────────
-
-fn sampleShadow(worldPos: vec3f, n: vec3f) -> f32 {
-  // Back-facing to key light: direct contribution is zero anyway, skip 9 texture samples.
-  if (dot(n, -light.lights[0].direction.xyz) <= 0.0) { return 0.0; }
-  let biasedPos = worldPos + n * 0.08;
-  let lclip = lightVP.viewProj * vec4f(biasedPos, 1.0);
-  let ndc = lclip.xyz / max(lclip.w, 1e-6);
-  let suv = vec2f(ndc.x * 0.5 + 0.5, 0.5 - ndc.y * 0.5);
-  let cmpZ = ndc.z - 0.001;
-  let ts = 1.0 / 2048.0;
-  // 3x3 PCF unrolled — Safari's Metal backend doesn't unroll nested shadow loops reliably.
-  let s00 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f(-ts, -ts), cmpZ);
-  let s10 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f(0.0, -ts), cmpZ);
-  let s20 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f( ts, -ts), cmpZ);
-  let s01 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f(-ts, 0.0), cmpZ);
-  let s11 = textureSampleCompareLevel(shadowMap, shadowSampler, suv, cmpZ);
-  let s21 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f( ts, 0.0), cmpZ);
-  let s02 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f(-ts,  ts), cmpZ);
-  let s12 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f(0.0,  ts), cmpZ);
-  let s22 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f( ts,  ts), cmpZ);
-  return (s00 + s10 + s20 + s01 + s11 + s21 + s02 + s12 + s22) * (1.0 / 9.0);
-}
-
-// ─── Vertex / Fragment ──────────────────────────────────────────────
-
-@vertex fn vs(
-  @location(0) position: vec3f,
-  @location(1) normal: vec3f,
-  @location(2) uv: vec2f,
-  @location(3) joints0: vec4<u32>,
-  @location(4) weights0: vec4<f32>
-) -> VertexOutput {
-  var output: VertexOutput;
-  let pos4 = vec4f(position, 1.0);
-  let weightSum = weights0.x + weights0.y + weights0.z + weights0.w;
-  let invWeightSum = select(1.0, 1.0 / weightSum, weightSum > 0.0001);
-  let nw = select(vec4f(1.0, 0.0, 0.0, 0.0), weights0 * invWeightSum, weightSum > 0.0001);
-  var skinnedPos = vec4f(0.0);
-  var skinnedNrm = vec3f(0.0);
-  for (var i = 0u; i < 4u; i++) {
-    let m = skinMats[joints0[i]];
-    let w = nw[i];
-    skinnedPos += (m * pos4) * w;
-    skinnedNrm += (mat3x3f(m[0].xyz, m[1].xyz, m[2].xyz) * normal) * w;
-  }
-  output.position = camera.projection * camera.view * vec4f(skinnedPos.xyz, 1.0);
-  // Skip VS normalize — interpolation denormalizes anyway, and FS always does normalize(input.normal).
-  output.normal = skinnedNrm;
-  output.uv = uv;
-  output.worldPos = skinnedPos.xyz;
-  return output;
-}
-
-struct FSOut {
-  @location(0) color: vec4f,
-  @location(1) mask: f32,
-};
+const DEFAULT_ROUGHNESS: f32 = 0.5;
 
 @fragment fn fs(input: VertexOutput) -> FSOut {
   let alpha = material.alpha;
@@ -142,30 +19,20 @@ struct FSOut {
 
   let n = normalize(input.normal);
   let v = normalize(camera.viewPos - input.worldPos);
-  let albedo = textureSample(diffuseTexture, diffuseSampler, input.uv).rgb;
-
   let l = -light.lights[0].direction.xyz;
   let sun = light.lights[0].color.xyz * light.lights[0].color.w;
   let amb = light.ambientColor.xyz;
   let shadow = sampleShadow(input.worldPos, n);
 
-  // 原理化BSDF (EEVEE port): metallic=0, specular=0.5, roughness=0.5, specular_tint=0.
-  let NL = max(dot(n, l), 0.0);
-  let NV = max(dot(n, v), 1e-4);
-
-  let f0 = vec3f(0.08 * DEFAULT_SPECULAR);
-  let f90 = mix(f0, vec3f(1.0), sqrt(DEFAULT_SPECULAR));
-  let brdf_lut = brdf_lut_sample(NV, ROUGHNESS);
-  let reflection_color = F_brdf_multi_scatter(f0, f90, brdf_lut.xy);
-
-  let spec_direct = bsdf_ggx(n, l, v, NL, NV, ROUGHNESS) * sun * shadow * ltc_brdf_scale_from_lut(brdf_lut);
-  let spec_indirect = amb;
-  let spec_radiance = (spec_direct + spec_indirect) * reflection_color;
+  let albedo = textureSample(diffuseTexture, diffuseSampler, input.uv).rgb;
 
-  let diffuse_radiance = albedo * (sun * NL * shadow / PI + amb);
+  let color = eval_principled(
+    PrincipledIn(albedo, 0.0, DEFAULT_SPECULAR, DEFAULT_ROUGHNESS, 1e30, 0.0, 0.0),
+    n, l, v, sun, amb, shadow
+  );
 
   var out: FSOut;
-  out.color = vec4f(diffuse_radiance + spec_radiance, alpha);
+  out.color = vec4f(color, alpha);
   out.mask = 1.0;
   return out;
 }

package/src/shaders/materials/eye.ts

@@ -1,146 +1,41 @@
-// Eye preset — default Principled BSDF (Specular=0.5, Roughness=0.5) + Emission socket set to albedo × 1.5.
-// Matches the published preset's instruction: "keep eyes in the default nodegraph, add emission 1.5".
-// Blender's Principled BSDF Emission socket is added on top of the shaded output (pre-tonemap, feeds bloom).
+// Eye preset — default Principled BSDF + Emission socket set to albedo × 1.5.
+// Matches the published preset author's instruction: "keep eyes in the default
+// nodegraph, add emission 1.5". Emission feeds bloom pre-tonemap.
 
 import { NODES_WGSL } from "./nodes"
+import { COMMON_MATERIAL_PRELUDE_WGSL } from "./common"
 
 export const EYE_SHADER_WGSL = /* wgsl */ `
 
 ${NODES_WGSL}
+${COMMON_MATERIAL_PRELUDE_WGSL}
 
-const PI_E: f32 = 3.141592653589793;
 const EYE_SPECULAR: f32 = 0.5;
 const EYE_ROUGHNESS: f32 = 0.5;
 const EYE_EMISSION_STRENGTH: f32 = 1.5;
 
-struct CameraUniforms {
-  view: mat4x4f,
-  projection: mat4x4f,
-  viewPos: vec3f,
-  _padding: f32,
-};
-
-struct Light {
-  direction: vec4f,
-  color: vec4f,
-};
-
-struct LightUniforms {
-  ambientColor: vec4f,
-  lights: array<Light, 4>,
-};
-
-struct MaterialUniforms {
-  diffuseColor: vec3f,
-  alpha: f32,
-};
-
-struct VertexOutput {
-  @builtin(position) position: vec4f,
-  @location(0) normal: vec3f,
-  @location(1) uv: vec2f,
-  @location(2) worldPos: vec3f,
-};
-
-struct LightVP { viewProj: mat4x4f, };
-
-@group(0) @binding(0) var<uniform> camera: CameraUniforms;
-@group(0) @binding(1) var<uniform> light: LightUniforms;
-@group(0) @binding(2) var diffuseSampler: sampler;
-@group(0) @binding(3) var shadowMap: texture_depth_2d;
-@group(0) @binding(4) var shadowSampler: sampler_comparison;
-@group(0) @binding(5) var<uniform> lightVP: LightVP;
-@group(1) @binding(0) var<storage, read> skinMats: array<mat4x4f>;
-@group(2) @binding(0) var diffuseTexture: texture_2d<f32>;
-@group(2) @binding(1) var<uniform> material: MaterialUniforms;
-
-fn sampleShadow(worldPos: vec3f, n: vec3f) -> f32 {
-  // Back-facing to key light: direct contribution is zero anyway, skip 9 texture samples.
-  if (dot(n, -light.lights[0].direction.xyz) <= 0.0) { return 0.0; }
-  let biasedPos = worldPos + n * 0.08;
-  let lclip = lightVP.viewProj * vec4f(biasedPos, 1.0);
-  let ndc = lclip.xyz / max(lclip.w, 1e-6);
-  let suv = vec2f(ndc.x * 0.5 + 0.5, 0.5 - ndc.y * 0.5);
-  let cmpZ = ndc.z - 0.001;
-  let ts = 1.0 / 2048.0;
-  // 3x3 PCF unrolled — Safari's Metal backend doesn't unroll nested shadow loops reliably.
-  let s00 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f(-ts, -ts), cmpZ);
-  let s10 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f(0.0, -ts), cmpZ);
-  let s20 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f( ts, -ts), cmpZ);
-  let s01 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f(-ts, 0.0), cmpZ);
-  let s11 = textureSampleCompareLevel(shadowMap, shadowSampler, suv, cmpZ);
-  let s21 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f( ts, 0.0), cmpZ);
-  let s02 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f(-ts,  ts), cmpZ);
-  let s12 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f(0.0,  ts), cmpZ);
-  let s22 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f( ts,  ts), cmpZ);
-  return (s00 + s10 + s20 + s01 + s11 + s21 + s02 + s12 + s22) * (1.0 / 9.0);
-}
-
-@vertex fn vs(
-  @location(0) position: vec3f,
-  @location(1) normal: vec3f,
-  @location(2) uv: vec2f,
-  @location(3) joints0: vec4<u32>,
-  @location(4) weights0: vec4<f32>
-) -> VertexOutput {
-  var output: VertexOutput;
-  let pos4 = vec4f(position, 1.0);
-  let weightSum = weights0.x + weights0.y + weights0.z + weights0.w;
-  let invWeightSum = select(1.0, 1.0 / weightSum, weightSum > 0.0001);
-  let nw = select(vec4f(1.0, 0.0, 0.0, 0.0), weights0 * invWeightSum, weightSum > 0.0001);
-  var skinnedPos = vec4f(0.0);
-  var skinnedNrm = vec3f(0.0);
-  for (var i = 0u; i < 4u; i++) {
-    let m = skinMats[joints0[i]];
-    let w = nw[i];
-    skinnedPos += (m * pos4) * w;
-    skinnedNrm += (mat3x3f(m[0].xyz, m[1].xyz, m[2].xyz) * normal) * w;
-  }
-  output.position = camera.projection * camera.view * vec4f(skinnedPos.xyz, 1.0);
-  // Skip VS normalize — interpolation denormalizes anyway, and FS always does normalize(input.normal).
-  output.normal = skinnedNrm;
-  output.uv = uv;
-  output.worldPos = skinnedPos.xyz;
-  return output;
-}
-
-struct FSOut {
-  @location(0) color: vec4f,
-  @location(1) mask: f32,
-};
-
 @fragment fn fs(input: VertexOutput) -> FSOut {
   let alpha = material.alpha;
   if (alpha < 0.001) { discard; }
 
   let n = normalize(input.normal);
   let v = normalize(camera.viewPos - input.worldPos);
-  let albedo = textureSample(diffuseTexture, diffuseSampler, input.uv).rgb;
-
   let l = -light.lights[0].direction.xyz;
   let sun = light.lights[0].color.xyz * light.lights[0].color.w;
   let amb = light.ambientColor.xyz;
   let shadow = sampleShadow(input.worldPos, n);
 
-  // 原理化BSDF (EEVEE port): metallic=0, specular=0.5, roughness=0.5, specular_tint=0.
-  let NL = max(dot(n, l), 0.0);
-  let NV = max(dot(n, v), 1e-4);
-
-  let f0 = vec3f(0.08 * EYE_SPECULAR);
-  let f90 = mix(f0, vec3f(1.0), sqrt(EYE_SPECULAR));
-  let brdf_lut = brdf_lut_sample(NV, EYE_ROUGHNESS);
-  let reflection_color = F_brdf_multi_scatter(f0, f90, brdf_lut.xy);
-
-  let spec_direct = bsdf_ggx(n, l, v, NL, NV, EYE_ROUGHNESS) * sun * shadow * ltc_brdf_scale_from_lut(brdf_lut);
-  let spec_indirect = amb;
-  let spec_radiance = (spec_direct + spec_indirect) * reflection_color;
+  let albedo = textureSample(diffuseTexture, diffuseSampler, input.uv).rgb;
 
-  let diffuse_radiance = albedo * (sun * NL * shadow / PI_E + amb);
-  // Principled Emission socket: emissive = emission_color × strength, added on top of shading.
+  let shaded = eval_principled(
+    PrincipledIn(albedo, 0.0, EYE_SPECULAR, EYE_ROUGHNESS, 1e30, 0.0, 0.0),
+    n, l, v, sun, amb, shadow
+  );
+  // Principled Emission socket: emissive = emission_color × strength, added on top.
   let emission = albedo * EYE_EMISSION_STRENGTH;
 
   var out: FSOut;
-  out.color = vec4f(diffuse_radiance + spec_radiance + emission, alpha);
+  out.color = vec4f(shaded + emission, alpha);
   out.mask = 1.0;
   return out;
 }

package/src/shaders/materials/face.ts

@@ -1,201 +1,89 @@
-// M_Face — WGSL trace of 仿深空之眼渲染预设v1.0_by_小绿毛猫_material_graph_dump.json "M_Face"; VALTORGB stops from m_graphs (dump omits curve keys).
-
-import { NODES_WGSL } from "./nodes"
-
-export const FACE_SHADER_WGSL = /* wgsl */ `
-
-${NODES_WGSL}
-
-struct CameraUniforms {
-  view: mat4x4f,
-  projection: mat4x4f,
-  viewPos: vec3f,
-  _padding: f32,
-};
-
-struct Light {
-  direction: vec4f,
-  color: vec4f,
-};
-
-struct LightUniforms {
-  ambientColor: vec4f,
-  lights: array<Light, 4>,
-};
-
-struct MaterialUniforms {
-  diffuseColor: vec3f,
-  alpha: f32,
-};
-
-struct VertexOutput {
-  @builtin(position) position: vec4f,
-  @location(0) normal: vec3f,
-  @location(1) uv: vec2f,
-  @location(2) worldPos: vec3f,
-};
-
-struct LightVP { viewProj: mat4x4f, };
-
-@group(0) @binding(0) var<uniform> camera: CameraUniforms;
-@group(0) @binding(1) var<uniform> light: LightUniforms;
-@group(0) @binding(2) var diffuseSampler: sampler;
-@group(0) @binding(3) var shadowMap: texture_depth_2d;
-@group(0) @binding(4) var shadowSampler: sampler_comparison;
-@group(0) @binding(5) var<uniform> lightVP: LightVP;
-@group(1) @binding(0) var<storage, read> skinMats: array<mat4x4f>;
-@group(2) @binding(0) var diffuseTexture: texture_2d<f32>;
-@group(2) @binding(1) var<uniform> material: MaterialUniforms;
-
-// 3x3 PCF shadow sampling, 2048 map, normal-bias 0.08, depth-bias 0.001
-fn sampleShadow(worldPos: vec3f, n: vec3f) -> f32 {
-  // Back-facing to key light: direct contribution is zero anyway, skip 9 texture samples.
-  if (dot(n, -light.lights[0].direction.xyz) <= 0.0) { return 0.0; }
-  let biasedPos = worldPos + n * 0.08;
-  let lclip = lightVP.viewProj * vec4f(biasedPos, 1.0);
-  let ndc = lclip.xyz / max(lclip.w, 1e-6);
-  let suv = vec2f(ndc.x * 0.5 + 0.5, 0.5 - ndc.y * 0.5);
-  let cmpZ = ndc.z - 0.001;
-  let ts = 1.0 / 2048.0;
-  // 3x3 PCF unrolled — Safari's Metal backend doesn't unroll nested shadow loops reliably.
-  let s00 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f(-ts, -ts), cmpZ);
-  let s10 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f(0.0, -ts), cmpZ);
-  let s20 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f( ts, -ts), cmpZ);
-  let s01 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f(-ts, 0.0), cmpZ);
-  let s11 = textureSampleCompareLevel(shadowMap, shadowSampler, suv, cmpZ);
-  let s21 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f( ts, 0.0), cmpZ);
-  let s02 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f(-ts,  ts), cmpZ);
-  let s12 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f(0.0,  ts), cmpZ);
-  let s22 = textureSampleCompareLevel(shadowMap, shadowSampler, suv + vec2f( ts,  ts), cmpZ);
-  return (s00 + s10 + s20 + s01 + s11 + s21 + s02 + s12 + s22) * (1.0 / 9.0);
-}
-
-const PI_F: f32 = 3.141592653589793;
-const FACE_SPECULAR: f32 = 0.5;
-const FACE_ROUGHNESS: f32 = 0.3;
-const FACE_RIM2_POW: f32 = 0.6300000548362732;
-const FACE_RIM2_BG: vec3f = vec3f(1.0, 0.4684903025627136, 0.3698573112487793);
-const FACE_WARM_STR: f32 = 0.30000001192092896;
-const FACE_BRIGHT_TEX_THRESH: f32 = 0.9300000071525574;
-const FACE_MIX_NPR: f32 = 0.5;
-// EEVEE Light Clamp equivalent (Render Props → Sampling → Clamping). Caps direct
-// specular firefly from the noise-bumped normal's NDF aliasing — Blender hides this
-// via TAA, which we don't have. Value mirrors EEVEE's default Clamp Indirect=10.0.
-const FACE_SPEC_CLAMP: f32 = 10.0;
-
-@vertex fn vs(
-  @location(0) position: vec3f,
-  @location(1) normal: vec3f,
-  @location(2) uv: vec2f,
-  @location(3) joints0: vec4<u32>,
-  @location(4) weights0: vec4<f32>
-) -> VertexOutput {
-  var output: VertexOutput;
-  let pos4 = vec4f(position, 1.0);
-  let weightSum = weights0.x + weights0.y + weights0.z + weights0.w;
-  let invWeightSum = select(1.0, 1.0 / weightSum, weightSum > 0.0001);
-  let nw = select(vec4f(1.0, 0.0, 0.0, 0.0), weights0 * invWeightSum, weightSum > 0.0001);
-  var skinnedPos = vec4f(0.0);
-  var skinnedNrm = vec3f(0.0);
-  for (var i = 0u; i < 4u; i++) {
-    let m = skinMats[joints0[i]];
-    let w = nw[i];
-    skinnedPos += (m * pos4) * w;
-    skinnedNrm += (mat3x3f(m[0].xyz, m[1].xyz, m[2].xyz) * normal) * w;
-  }
-  output.position = camera.projection * camera.view * vec4f(skinnedPos.xyz, 1.0);
-  // Skip VS normalize — interpolation denormalizes anyway, and FS always does normalize(input.normal).
-  output.normal = skinnedNrm;
-  output.uv = uv;
-  output.worldPos = skinnedPos.xyz;
-  return output;
-}
-
-struct FSOut {
-  @location(0) color: vec4f,
-  @location(1) mask: f32,
-};
-
-@fragment fn fs(input: VertexOutput) -> FSOut {
-  let alpha = material.alpha;
-  if (alpha < 0.001) { discard; }
-
-  let n = normalize(input.normal);
-  let v = normalize(camera.viewPos - input.worldPos);
-  let l = -light.lights[0].direction.xyz;
-  let intensity = light.lights[0].color.w;
-  let sun = light.lights[0].color.xyz * intensity;
-
-  let tex_color = textureSample(diffuseTexture, diffuseSampler, input.uv).rgb;
-  let shadow = sampleShadow(input.worldPos, n);
-
-  let ndotl_raw = shader_to_rgb_diffuse(n, l, sun, light.ambientColor.xyz, shadow);
-  // ramp_constant_edge_aa: avoids binary fac shimmer on terminator (fwidth + smoothstep).
-  let toon = ramp_constant_edge_aa(ndotl_raw, 0.2966, vec4f(0,0,0,1), vec4f(1,1,1,1)).r;
-
-  let shadow_tint = hue_sat(0.46000000834465027, 2.0, 0.3499999940395355, 1.0, tex_color);
-  let lit_tint = hue_sat(0.46000000834465027, 1.600000023841858, 1.5, 1.0, tex_color);
-  let toon_color = mix_blend(toon, shadow_tint, lit_tint);
-  let bc = bright_contrast(toon_color, 0.1, 0.2);
-
-  let emission3 = bc * 2.5;
-
-  let warm_input = clamp(toon * 0.5 + 0.5, 0.0, 1.0);
-  let warm_color = ramp_cardinal(warm_input, 0.2409,
-    vec4f(0.2426, 0.068, 0.0588, 1.0), 0.4663,
-    vec4f(0.6677, 0.5024, 0.5126, 1.0)).rgb;
-  let warm_emission = warm_color * FACE_WARM_STR;
-
-  let rim1_str = fresnel(2.0, n, v) * layer_weight_facing(0.24, n, v);
-  let rim1 = vec3f(0.984157919883728, 0.6110184788703918, 0.5736401677131653) * rim1_str;
-
-  let rim2_raw = fresnel(1.45, n, v) * layer_weight_fresnel(0.61, n, v);
-  let rim2_fac = math_power(rim2_raw, FACE_RIM2_POW);
-  let rim2_mixed = mix(emission3, FACE_RIM2_BG, rim2_fac);
-
-  // Blender implicitly converts Color → Float via BT.601 grayscale when plugging a color
-  // output into a Math node's Value input. An earlier trace used tex_color.r, which fires
-  // aggressively on R-dominant skin — single near-white R pixels produced firefly speckles.
-  // color_to_value matches the Blender socket semantic and only fires on genuinely near-
-  // white painted features (the author's intent).
-  let tex_gate = math_greater_than(color_to_value(tex_color), FACE_BRIGHT_TEX_THRESH);
-  let bright_emit = vec3f(tex_gate) * 3.0;
-
-  let npr_stack = rim1 + rim2_mixed + bright_emit + warm_emission;
-
-  // Noise bump — Mapping loc=rot=0 folds to a plain scale multiply.
-  let noise_val = tex_noise_d2(input.worldPos * vec3f(1.0, 1.0, 1.5), 1.0);
-  let noise_ramp = ramp_linear(noise_val, 0.0, vec4f(0,0,0,1), 1.0, vec4f(1,1,1,1)).r;
-  let bumped_n = bump_lh(0.324644535779953, noise_ramp, n, input.worldPos);
-
-  let principled_base = mix_blend(noise_ramp, bc, vec3f(0.6832, 0.1947, 0.1373));
-  let p_emission = bc * 0.2;
-
-  // Principled BSDF (EEVEE port): metallic=0, specular=0.5, roughness=0.3, specular_tint=0.
-  let NL = max(dot(bumped_n, l), 0.0);
-  let NV = max(dot(bumped_n, v), 1e-4);
-
-  let f0 = vec3f(0.08 * FACE_SPECULAR);
-  let f90 = mix(f0, vec3f(1.0), sqrt(FACE_SPECULAR));
-  let brdf_lut = brdf_lut_sample(NV, FACE_ROUGHNESS);
-  let reflection_color = F_brdf_multi_scatter(f0, f90, brdf_lut.xy);
-
-  let spec_direct_raw = bsdf_ggx(bumped_n, l, v, NL, NV, FACE_ROUGHNESS) * sun * shadow * ltc_brdf_scale_from_lut(brdf_lut);
-  let spec_direct = min(spec_direct_raw, vec3f(FACE_SPEC_CLAMP));
-  let spec_indirect = light.ambientColor.xyz;
-  let spec_radiance = (spec_direct + spec_indirect) * reflection_color;
-
-  // Indirect diffuse = base_color × L_w per Blender closure_eval_surface_lib.glsl line 302;
-  // probe_evaluate_world_diff returns radiance (SH-projected, not cosine-convolved).
-  let diffuse_radiance = principled_base * (sun * NL * shadow / PI_F + light.ambientColor.xyz);
-  let principled = diffuse_radiance + spec_radiance + p_emission;
-
-  let final_color = mix(npr_stack, principled, FACE_MIX_NPR);
-
-  var out: FSOut;
-  out.color = vec4f(final_color, alpha);
-  out.mask = 1.0;
-  return out;
-}
-
-`
+// M_Face — 仿深空之眼渲染预设v1.0_by_小绿毛猫 "M_Face". Toon + warm rim + dual fresnel
+// rim + BT.601 bright-tex gate, mixed 50/50 against a Principled BSDF with noise bump.
+
+import { NODES_WGSL } from "./nodes"
+import { COMMON_MATERIAL_PRELUDE_WGSL } from "./common"
+
+export const FACE_SHADER_WGSL = /* wgsl */ `
+
+${NODES_WGSL}
+${COMMON_MATERIAL_PRELUDE_WGSL}
+
+const FACE_SPECULAR: f32 = 0.5;
+const FACE_ROUGHNESS: f32 = 0.3;
+const FACE_MIX_NPR: f32 = 0.5;
+const FACE_SPEC_CLAMP: f32 = 10.0;
+const FACE_RIM2_POW: f32 = 0.6300000548362732;
+const FACE_RIM2_BG: vec3f = vec3f(1.0, 0.4684903025627136, 0.3698573112487793);
+const FACE_WARM_STR: f32 = 0.30000001192092896;
+const FACE_BRIGHT_TEX_THRESH: f32 = 0.9300000071525574;
+
+@fragment fn fs(input: VertexOutput) -> FSOut {
+  let alpha = material.alpha;
+  if (alpha < 0.001) { discard; }
+
+  let n = normalize(input.normal);
+  let v = normalize(camera.viewPos - input.worldPos);
+  let l = -light.lights[0].direction.xyz;
+  let sun = light.lights[0].color.xyz * light.lights[0].color.w;
+  let amb = light.ambientColor.xyz;
+  let shadow = sampleShadow(input.worldPos, n);
+
+  let tex_color = textureSample(diffuseTexture, diffuseSampler, input.uv).rgb;
+
+  // ═══ NPR STACK ═══
+  let ndotl_raw = shader_to_rgb_diffuse(n, l, sun, amb, shadow);
+  // ramp_constant_edge_aa: avoids binary fac shimmer on terminator (fwidth + smoothstep).
+  let toon = ramp_constant_edge_aa(ndotl_raw, 0.2966, vec4f(0,0,0,1), vec4f(1,1,1,1)).r;
+
+  let shadow_tint = hue_sat(0.46000000834465027, 2.0, 0.3499999940395355, 1.0, tex_color);
+  let lit_tint = hue_sat(0.46000000834465027, 1.600000023841858, 1.5, 1.0, tex_color);
+  let toon_color = mix_blend(toon, shadow_tint, lit_tint);
+  let bc = bright_contrast(toon_color, 0.1, 0.2);
+
+  let emission3 = bc * 2.5;
+
+  let warm_input = clamp(toon * 0.5 + 0.5, 0.0, 1.0);
+  let warm_color = ramp_cardinal(warm_input, 0.2409,
+    vec4f(0.2426, 0.068, 0.0588, 1.0), 0.4663,
+    vec4f(0.6677, 0.5024, 0.5126, 1.0)).rgb;
+  let warm_emission = warm_color * FACE_WARM_STR;
+
+  let rim1_str = fresnel(2.0, n, v) * layer_weight_facing(0.24, n, v);
+  let rim1 = vec3f(0.984157919883728, 0.6110184788703918, 0.5736401677131653) * rim1_str;
+
+  let rim2_raw = fresnel(1.45, n, v) * layer_weight_fresnel(0.61, n, v);
+  let rim2_fac = math_power(rim2_raw, FACE_RIM2_POW);
+  let rim2_mixed = mix(emission3, FACE_RIM2_BG, rim2_fac);
+
+  // Blender implicitly converts Color → Float via BT.601 grayscale when a color output
+  // feeds a Math node's Value input. Using tex_color.r instead fires on R-dominant skin
+  // and produces firefly speckles on near-white R pixels — color_to_value matches the
+  // Blender socket semantic and only gates genuinely near-white painted features.
+  let tex_gate = math_greater_than(color_to_value(tex_color), FACE_BRIGHT_TEX_THRESH);
+  let bright_emit = vec3f(tex_gate) * 3.0;
+
+  let npr_stack = rim1 + rim2_mixed + bright_emit + warm_emission;
+
+  // ═══ PRINCIPLED BSDF with noise bump ═══
+  let noise_val = tex_noise_d2(input.worldPos * vec3f(1.0, 1.0, 1.5), 1.0);
+  let noise_ramp = ramp_linear(noise_val, 0.0, vec4f(0,0,0,1), 1.0, vec4f(1,1,1,1)).r;
+  let bumped_n = bump_lh(0.324644535779953, noise_ramp, n, input.worldPos);
+
+  let principled_base = mix_blend(noise_ramp, bc, vec3f(0.6832, 0.1947, 0.1373));
+  let p_emission = bc * 0.2;
+
+  let principled = eval_principled(
+    PrincipledIn(principled_base, 0.0, FACE_SPECULAR, FACE_ROUGHNESS, FACE_SPEC_CLAMP, 0.0, 0.0),
+    bumped_n, l, v, sun, amb, shadow
+  ) + p_emission;
+
+  let final_color = mix(npr_stack, principled, FACE_MIX_NPR);
+
+  var out: FSOut;
+  out.color = vec4f(final_color, alpha);
+  out.mask = 1.0;
+  return out;
+}
+
+`