reze-engine 0.16.1 → 0.16.3

package/src/shaders/materials/body.ts

@@ -1,92 +1,97 @@
-// M_Body — 仿深空之眼渲染预设v1.0_by_小绿毛猫 "M_Body". Toon + warm rim + rim1/rim2
-// stack mixed 50/50 against a Principled BSDF with noise-bumped normal.
-
-import { NODES_WGSL } from "./nodes"
-import { COMMON_MATERIAL_PRELUDE_WGSL } from "./common"
-
-export const BODY_SHADER_WGSL = /* wgsl */ `
-
-${NODES_WGSL}
-${COMMON_MATERIAL_PRELUDE_WGSL}
-
-const BODY_ROUGHNESS: f32 = 0.3;
-const BODY_SPECULAR: f32 = 0.5;
-const BODY_MIX_NPR: f32 = 0.5;
-const BODY_SPEC_CLAMP: f32 = 10.0;
-const BODY_RIM2_LAYER_BLEND: f32 = 0.20000000298023224;
-const BODY_RIM2_POW: f32 = 1.4300000667572021;
-const BODY_RIM2_BG: vec3f = vec3f(1.0, 0.4303792119026184, 0.3315804898738861);
-const BODY_WARM_STR: f32 = 0.30000001192092896;
-
-// smoothstep-based ramp: t*t*(3-2*t) between two color stops
-fn ramp_ease(f: f32, p0: f32, c0: vec4f, p1: f32, c1: vec4f) -> vec4f {
-  let t = saturate((f - p0) / max(p1 - p0, 1e-6));
-  let ss = t * t * (3.0 - 2.0 * t);
-  return mix(c0, c1, ss);
-}
-
-@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);
-  let toon = ramp_constant(ndotl_raw, 0.0, vec4f(0,0,0,1), 0.2966, vec4f(1,1,1,1)).r;
-
-  let shadow_tint = hue_sat_id(2.0, 0.3499999940395355, 1.0, tex_color);
-  let lit_tint = hue_sat_id(1.5, 1.0, 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 * 4.0;
-
-  let warm_input = clamp(toon + 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 * BODY_WARM_STR;
-
-  let rim1_str = fresnel(2.0, n, v) * layer_weight_facing(0.24000005424022675, n, v);
-  let rim1 = vec3f(0.984157919883728, 0.6110184788703918, 0.5736401677131653) * rim1_str;
-
-  let facing_raw = layer_weight_facing(BODY_RIM2_LAYER_BLEND, n, v);
-  let facing_pow = math_power(facing_raw, BODY_RIM2_POW);
-  let rim2_fac = ramp_ease(facing_pow, 0.0, vec4f(0,0,0,1), 0.5052, vec4f(1,1,1,1)).r;
-  let rim2_mixed = mix(emission3, BODY_RIM2_BG, rim2_fac);
-
-  let npr_stack = rim1 + rim2_mixed + warm_emission;
-
-  // ═══ PRINCIPLED BSDF with noise bump ═══
-  // Mapping loc=rot=0 in the Blender graph folds to a plain scale multiply.
-  // Height in rest space (restPos) so the bump rides with the skin; geometric basis stays
-  // worldPos so the perturbed normal matches the world-space n (see face.ts note).
-  let noise_val = tex_noise_d2(input.restPos * 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.6831911206245422, 0.19474034011363983, 0.13732507824897766));
-  let p_emission = bc * 0.2;
-
-  let principled = eval_principled(
-    PrincipledIn(principled_base, 0.0, BODY_SPECULAR, BODY_ROUGHNESS, BODY_SPEC_CLAMP, 0.0, 0.0),
-    bumped_n, l, v, sun, amb, shadow
-  ) + p_emission;
-
-  let final_color = mix(npr_stack, principled, BODY_MIX_NPR);
-
-  var out: FSOut;
-  out.color = vec4f(final_color, alpha);
-  out.mask = vec4f(1.0, 1.0, 0.0, out.color.a);
-  return out;
-}
-
-`
+// M_Body — 仿深空之眼渲染预设v1.0_by_小绿毛猫 "M_Body". Toon + warm rim + rim1/rim2
+// stack mixed 50/50 against a Principled BSDF with noise-bumped normal.
+
+import { NODES_WGSL } from "./nodes"
+import { COMMON_MATERIAL_PRELUDE_WGSL } from "./common"
+
+export const BODY_SHADER_WGSL = /* wgsl */ `
+
+${NODES_WGSL}
+${COMMON_MATERIAL_PRELUDE_WGSL}
+
+const BODY_ROUGHNESS: f32 = 0.3;
+const BODY_SPECULAR: f32 = 0.5;
+const BODY_MIX_NPR: f32 = 0.5;
+const BODY_SPEC_CLAMP: f32 = 10.0;
+const BODY_RIM2_LAYER_BLEND: f32 = 0.20000000298023224;
+const BODY_RIM2_POW: f32 = 1.4300000667572021;
+const BODY_RIM2_BG: vec3f = vec3f(1.0, 0.4303792119026184, 0.3315804898738861);
+const BODY_WARM_STR: f32 = 0.30000001192092896;
+
+// smoothstep-based ramp: t*t*(3-2*t) between two color stops
+fn ramp_ease(f: f32, p0: f32, c0: vec4f, p1: f32, c1: vec4f) -> vec4f {
+  let t = saturate((f - p0) / max(p1 - p0, 1e-6));
+  let ss = t * t * (3.0 - 2.0 * t);
+  return mix(c0, c1, ss);
+}
+
+@fragment fn fs(input: VertexOutput) -> FSOut {
+  let tex_s = textureSample(diffuseTexture, diffuseSampler, input.uv);
+  // MMD alpha semantics: material alpha × texture alpha. Hair/lace/accessory
+  // textures cut their shapes in the alpha channel — ignoring it renders each
+  // card's full quad with the texture's padding color (white shimmer on dark
+  // hair for models whose textures pad with white).
+  let alpha = material.alpha * tex_s.a;
+  if (alpha < 0.001) { discard; }
+
+  let n = safe_normal(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 = tex_s.rgb;
+
+  // ═══ NPR STACK ═══
+  let ndotl_raw = shader_to_rgb_diffuse(n, l, sun, amb, shadow);
+  let toon = ramp_constant(ndotl_raw, 0.0, vec4f(0,0,0,1), 0.2966, vec4f(1,1,1,1)).r;
+
+  let shadow_tint = hue_sat_id(2.0, 0.3499999940395355, 1.0, tex_color);
+  let lit_tint = hue_sat_id(1.5, 1.0, 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 * 4.0;
+
+  let warm_input = clamp(toon + 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 * BODY_WARM_STR;
+
+  let rim1_str = fresnel(2.0, n, v) * layer_weight_facing(0.24000005424022675, n, v);
+  let rim1 = vec3f(0.984157919883728, 0.6110184788703918, 0.5736401677131653) * rim1_str;
+
+  let facing_raw = layer_weight_facing(BODY_RIM2_LAYER_BLEND, n, v);
+  let facing_pow = math_power(facing_raw, BODY_RIM2_POW);
+  let rim2_fac = ramp_ease(facing_pow, 0.0, vec4f(0,0,0,1), 0.5052, vec4f(1,1,1,1)).r;
+  let rim2_mixed = mix(emission3, BODY_RIM2_BG, rim2_fac);
+
+  let npr_stack = rim1 + rim2_mixed + warm_emission;
+
+  // ═══ PRINCIPLED BSDF with noise bump ═══
+  // Mapping loc=rot=0 in the Blender graph folds to a plain scale multiply.
+  // Height in rest space (restPos) so the bump rides with the skin; geometric basis stays
+  // worldPos so the perturbed normal matches the world-space n (see face.ts note).
+  let noise_val = tex_noise_d2(input.restPos * 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.6831911206245422, 0.19474034011363983, 0.13732507824897766));
+  let p_emission = bc * 0.2;
+
+  let principled = eval_principled(
+    PrincipledIn(principled_base, 0.0, BODY_SPECULAR, BODY_ROUGHNESS, BODY_SPEC_CLAMP, 0.0, 0.0),
+    bumped_n, l, v, sun, amb, shadow
+  ) + p_emission;
+
+  let final_color = mix(npr_stack, principled, BODY_MIX_NPR);
+
+  var out: FSOut;
+  out.color = vec4f(final_color, alpha);
+  out.mask = vec4f(1.0, 1.0, 0.0, out.color.a);
+  return out;
+}
+
+`

package/src/shaders/materials/cloth_rough.ts

@@ -20,7 +20,7 @@ const CLOTH_R_BUMP_STR: f32 = 1.0;
 const CLOTH_R_SPEC_CLAMP: f32 = 10.0;
 
 @fragment fn fs(input: VertexOutput) -> FSOut {
-  let n = normalize(input.normal);
+  let n = safe_normal(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;

package/src/shaders/materials/cloth_smooth.ts

@@ -17,7 +17,7 @@ const NPR_EMIT_STR: f32 = 18.200000762939453;
 const NPR_MIX_SHADER_FAC: f32 = 0.8999999761581421;
 
 @fragment fn fs(input: VertexOutput) -> FSOut {
-  let n = normalize(input.normal);
+  let n = safe_normal(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;
@@ -47,7 +47,7 @@ const NPR_MIX_SHADER_FAC: f32 = 0.8999999761581421;
   // ═══ PRINCIPLED BSDF ═══
   let principled_base = hue_sat_id(1.0, 0.800000011920929, 1.0, tex_rgb);
   let principled = eval_principled(
-    PrincipledIn(principled_base, 0.0, CLOTH_SPECULAR, CLOTH_ROUGHNESS, 1e30, 0.0, 0.0),
+    PrincipledIn(principled_base, 0.0, CLOTH_SPECULAR, CLOTH_ROUGHNESS, 10.0, 0.0, 0.0),
     n, l, v, sun, amb, shadow
   );
 

package/src/shaders/materials/common.ts

@@ -73,6 +73,16 @@ struct LightVP { viewProj: mat4x4f, };
 @group(2) @binding(0) var diffuseTexture: texture_2d<f32>;
 @group(2) @binding(1) var<uniform> material: MaterialUniforms;
 
+// Four-bone blended normals can cancel to ~zero on physics-driven parts
+// (opposing bone rotations at 50/50 weights) — normalize(0) is 0/0 = NaN,
+// which poisons the whole shading stack and flashes through bloom. Fall
+// back to up for degenerate normals instead.
+fn safe_normal(nIn: vec3f) -> vec3f {
+  let l2 = dot(nIn, nIn);
+  if (l2 < 1e-12) { return vec3f(0.0, 1.0, 0.0); }
+  return nIn * inverseSqrt(l2);
+}
+
 `;
 
 // ─── Shadow sampler (3×3 PCF) ───────────────────────────────────────

package/src/shaders/materials/default.ts

@@ -1,40 +1,45 @@
-// 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 DEFAULT_SPECULAR: f32 = 0.5;
-const DEFAULT_ROUGHNESS: f32 = 0.5;
-
-@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 albedo = textureSample(diffuseTexture, diffuseSampler, input.uv).rgb;
-
-  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(color, alpha);
-  out.mask = vec4f(1.0, 1.0, 0.0, out.color.a);
-  return out;
-}
-
-`
+// 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 DEFAULT_SPECULAR: f32 = 0.5;
+const DEFAULT_ROUGHNESS: f32 = 0.5;
+
+@fragment fn fs(input: VertexOutput) -> FSOut {
+  let tex_s = textureSample(diffuseTexture, diffuseSampler, input.uv);
+  // MMD alpha semantics: material alpha × texture alpha. Hair/lace/accessory
+  // textures cut their shapes in the alpha channel — ignoring it renders each
+  // card's full quad with the texture's padding color (white shimmer on dark
+  // hair for models whose textures pad with white).
+  let alpha = material.alpha * tex_s.a;
+  if (alpha < 0.001) { discard; }
+
+  let n = safe_normal(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 albedo = tex_s.rgb;
+
+  let color = eval_principled(
+    PrincipledIn(albedo, 0.0, DEFAULT_SPECULAR, DEFAULT_ROUGHNESS, 10.0, 0.0, 0.0),
+    n, l, v, sun, amb, shadow
+  );
+
+  var out: FSOut;
+  out.color = vec4f(color, alpha);
+  out.mask = vec4f(1.0, 1.0, 0.0, out.color.a);
+  return out;
+}
+
+`

package/src/shaders/materials/eye.ts

@@ -1,43 +1,48 @@
-// 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 EYE_SPECULAR: f32 = 0.5;
-const EYE_ROUGHNESS: f32 = 0.5;
-const EYE_EMISSION_STRENGTH: f32 = 1.5;
-
-@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 albedo = textureSample(diffuseTexture, diffuseSampler, input.uv).rgb;
-
-  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(shaded + emission, alpha);
-  out.mask = vec4f(1.0, 1.0, 0.0, out.color.a);
-  return out;
-}
-
-`
+// 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 EYE_SPECULAR: f32 = 0.5;
+const EYE_ROUGHNESS: f32 = 0.5;
+const EYE_EMISSION_STRENGTH: f32 = 1.5;
+
+@fragment fn fs(input: VertexOutput) -> FSOut {
+  let tex_s = textureSample(diffuseTexture, diffuseSampler, input.uv);
+  // MMD alpha semantics: material alpha × texture alpha. Hair/lace/accessory
+  // textures cut their shapes in the alpha channel — ignoring it renders each
+  // card's full quad with the texture's padding color (white shimmer on dark
+  // hair for models whose textures pad with white).
+  let alpha = material.alpha * tex_s.a;
+  if (alpha < 0.001) { discard; }
+
+  let n = safe_normal(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 albedo = tex_s.rgb;
+
+  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(shaded + emission, alpha);
+  out.mask = vec4f(1.0, 1.0, 0.0, out.color.a);
+  return out;
+}
+
+`

package/src/shaders/materials/face.ts

@@ -1,92 +1,97 @@
-// 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 ═══
-  // Height sampled in rest space (restPos) so the micro-bump doesn't swim under motion;
-  // bump_lh's geometric basis stays in worldPos so the perturbed normal lands in the same
-  // world frame as n (screen-space height gradient still pairs correctly with it).
-  let noise_val = tex_noise_d2(input.restPos * 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 = vec4f(1.0, 1.0, 0.0, out.color.a);
-  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 tex_s = textureSample(diffuseTexture, diffuseSampler, input.uv);
+  // MMD alpha semantics: material alpha × texture alpha. Hair/lace/accessory
+  // textures cut their shapes in the alpha channel — ignoring it renders each
+  // card's full quad with the texture's padding color (white shimmer on dark
+  // hair for models whose textures pad with white).
+  let alpha = material.alpha * tex_s.a;
+  if (alpha < 0.001) { discard; }
+
+  let n = safe_normal(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 = tex_s.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 ═══
+  // Height sampled in rest space (restPos) so the micro-bump doesn't swim under motion;
+  // bump_lh's geometric basis stays in worldPos so the perturbed normal lands in the same
+  // world frame as n (screen-space height gradient still pairs correctly with it).
+  let noise_val = tex_noise_d2(input.restPos * 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 = vec4f(1.0, 1.0, 0.0, out.color.a);
+  return out;
+}
+
+`