three-base 2.0.142 → 2.0.166

package/pass/stroke_pass.d.ts

@@ -1,2 +1,2 @@
-import { DepthTexture, WebGLRenderer, Camera, Object3D } from "three";
-export default function stroke_pass(renderer: WebGLRenderer, camera: Camera, object3d: Object3D, baseDepthTexture: DepthTexture, devicePixelRatio: number): void;
+import { DepthTexture, WebGLRenderer, Camera, Object3D } from "three";
+export default function stroke_pass(renderer: WebGLRenderer, camera: Camera, object3d: Object3D, baseDepthTexture: DepthTexture, devicePixelRatio: number): void;

package/pass/stroke_pass.js

@@ -1,61 +1,61 @@
-/*
- * @Author: xiaosihan
- * @Date: 2023-05-09 00:35:17
- * @Last Modified by: xiaosihan
- * @Last Modified time: 2025-01-28 04:02:16
- */
-import { Color, DepthFormat, DepthTexture, LinearFilter, NoBlending, NormalBlending, RGBAFormat, RawShaderMaterial, Scene, ShaderChunk, ShaderMaterial, UnsignedIntType, Vector2, WebGLRenderTarget } from "three";
-import fsQuad from "./fsQuad";
-import { debugDepthState } from "./debugDepthState";
-import { DEPTH_TEST_BIAS } from "./depthTestBias";
-const selectDepthTexture = (() => {
-    const baseDepthTexture = new DepthTexture(1024, 1024);
-    baseDepthTexture.format = DepthFormat;
-    baseDepthTexture.type = UnsignedIntType;
-    baseDepthTexture.anisotropy = 16;
-    return baseDepthTexture;
-})();
-const selectTextureTarget = new WebGLRenderTarget(1024, 1024, {
-    minFilter: LinearFilter,
-    magFilter: LinearFilter,
-    format: RGBAFormat,
-    anisotropy: 16,
-    // 无 MSAA：mask 颜色与下方 selectDepthTextureTarget（深度）必须同为硬边缘，
-    // 否则 mask 边缘平滑而深度硬 → depthTestShader 判定边界与 mask 视觉边缘错位，描边边缘锯齿。
-    // 边缘抗锯齿统一由 mask 内部 FXAA + 终处理 FXAA 兜底。
-});
-// 无 MSAA 的深度专用目标：仅用于导出对象深度，供 depthTestShader 做遮挡判定（深度无需抗锯齿）
-const selectDepthTextureTarget = new WebGLRenderTarget(1024, 1024, {
-    minFilter: LinearFilter,
-    magFilter: LinearFilter,
-    format: RGBAFormat,
-    depthTexture: selectDepthTexture,
-    anisotropy: 16,
-});
-const selectDepthTestTextureTarget = new WebGLRenderTarget(1024, 1024, {
-    minFilter: LinearFilter,
-    magFilter: LinearFilter,
-    format: RGBAFormat,
-    anisotropy: 16,
-    // 无 MSAA：深度测试 mask 无需抗锯齿，去掉以提速
-});
-const blur1TextureTarget = new WebGLRenderTarget(1024, 1024, { minFilter: LinearFilter, magFilter: LinearFilter, format: RGBAFormat });
-const blur2TextureTarget = new WebGLRenderTarget(1024, 1024, { minFilter: LinearFilter, magFilter: LinearFilter, format: RGBAFormat });
-// 外扩深度临时/结果目标：depthMinBlurShader 把本体深度图随描边一起外扩，
-// 外扩区取邻域最近深度（忽略背景 1.0），使外扩区 selD<1.0，depthTest 才能正确判遮挡（不漏光）。
-const selectDepthBlurTmpTextureTarget = new WebGLRenderTarget(1024, 1024, { minFilter: LinearFilter, magFilter: LinearFilter, format: RGBAFormat });
-const selectDepthBlurTextureTarget = new WebGLRenderTarget(1024, 1024, { minFilter: LinearFilter, magFilter: LinearFilter, format: RGBAFormat });
-// 外扩描边经深度测试后的结果（步骤 5.6）：独立 target，避免回写 blur1 触发历史回归 bug
-const blurDepthTestTextureTarget = new WebGLRenderTarget(1024, 1024, { minFilter: LinearFilter, magFilter: LinearFilter, format: RGBAFormat });
-const size = new Vector2();
-const depthTestShader = new ShaderMaterial({
-    uniforms: {
-        map: { value: null },
-        baseDepth: { value: null },
-        selectDepth: { value: null },
-        cameraFar: { value: 1000.0 },
-        uDebugVis: { value: 0.0 },
-    },
+/*
+ * @Author: xiaosihan
+ * @Date: 2023-05-09 00:35:17
+ * @Last Modified by: xiaosihan
+ * @Last Modified time: 2025-01-28 04:02:16
+ */
+import { Color, DepthFormat, DepthTexture, LinearFilter, NoBlending, NormalBlending, RGBAFormat, RawShaderMaterial, Scene, ShaderChunk, ShaderMaterial, UnsignedIntType, Vector2, WebGLRenderTarget } from "three";
+import fsQuad from "./fsQuad";
+import { debugDepthState } from "./debugDepthState";
+import { DEPTH_TEST_BIAS } from "./depthTestBias";
+const selectDepthTexture = (() => {
+    const baseDepthTexture = new DepthTexture(1024, 1024);
+    baseDepthTexture.format = DepthFormat;
+    baseDepthTexture.type = UnsignedIntType;
+    baseDepthTexture.anisotropy = 16;
+    return baseDepthTexture;
+})();
+const selectTextureTarget = new WebGLRenderTarget(1024, 1024, {
+    minFilter: LinearFilter,
+    magFilter: LinearFilter,
+    format: RGBAFormat,
+    anisotropy: 16,
+    // 无 MSAA：mask 颜色与下方 selectDepthTextureTarget（深度）必须同为硬边缘，
+    // 否则 mask 边缘平滑而深度硬 → depthTestShader 判定边界与 mask 视觉边缘错位，描边边缘锯齿。
+    // 边缘抗锯齿统一由 mask 内部 FXAA + 终处理 FXAA 兜底。
+});
+// 无 MSAA 的深度专用目标：仅用于导出对象深度，供 depthTestShader 做遮挡判定（深度无需抗锯齿）
+const selectDepthTextureTarget = new WebGLRenderTarget(1024, 1024, {
+    minFilter: LinearFilter,
+    magFilter: LinearFilter,
+    format: RGBAFormat,
+    depthTexture: selectDepthTexture,
+    anisotropy: 16,
+});
+const selectDepthTestTextureTarget = new WebGLRenderTarget(1024, 1024, {
+    minFilter: LinearFilter,
+    magFilter: LinearFilter,
+    format: RGBAFormat,
+    anisotropy: 16,
+    // 无 MSAA：深度测试 mask 无需抗锯齿，去掉以提速
+});
+const blur1TextureTarget = new WebGLRenderTarget(1024, 1024, { minFilter: LinearFilter, magFilter: LinearFilter, format: RGBAFormat });
+const blur2TextureTarget = new WebGLRenderTarget(1024, 1024, { minFilter: LinearFilter, magFilter: LinearFilter, format: RGBAFormat });
+// 外扩深度临时/结果目标：depthMinBlurShader 把本体深度图随描边一起外扩，
+// 外扩区取邻域最近深度（忽略背景 1.0），使外扩区 selD<1.0，depthTest 才能正确判遮挡（不漏光）。
+const selectDepthBlurTmpTextureTarget = new WebGLRenderTarget(1024, 1024, { minFilter: LinearFilter, magFilter: LinearFilter, format: RGBAFormat });
+const selectDepthBlurTextureTarget = new WebGLRenderTarget(1024, 1024, { minFilter: LinearFilter, magFilter: LinearFilter, format: RGBAFormat });
+// 外扩描边经深度测试后的结果（步骤 5.6）：独立 target，避免回写 blur1 触发历史回归 bug
+const blurDepthTestTextureTarget = new WebGLRenderTarget(1024, 1024, { minFilter: LinearFilter, magFilter: LinearFilter, format: RGBAFormat });
+const size = new Vector2();
+const depthTestShader = new ShaderMaterial({
+    uniforms: {
+        map: { value: null },
+        baseDepth: { value: null },
+        selectDepth: { value: null },
+        cameraFar: { value: 1000.0 },
+        uDebugVis: { value: 0.0 },
+    },
     vertexShader: `
         ${ShaderChunk.common}
         ${ShaderChunk.logdepthbuf_pars_vertex}
@@ -65,7 +65,7 @@ const depthTestShader = new ShaderMaterial({
             gl_Position = projectionMatrix * modelViewMatrix * vec4( position, 1.0 );
             ${ShaderChunk.logdepthbuf_vertex}
         }
-    `,
+    `,
     fragmentShader: `
         ${ShaderChunk.logdepthbuf_pars_fragment}
         uniform sampler2D map;
@@ -102,17 +102,17 @@ const depthTestShader = new ShaderMaterial({
         gl_FragColor = texture2D(map, vUv);
         ${ShaderChunk.logdepthbuf_fragment}
     }
-    `,
-    blending: NoBlending,
-    depthTest: true,
-    depthWrite: true,
-    transparent: true
-});
-const FXAAShaderMaterial = new ShaderMaterial({
-    uniforms: {
-        tDiffuse: { value: null },
-        resolution: { value: new Vector2(1 / 1024, 1 / 1024) }
-    },
+    `,
+    blending: NoBlending,
+    depthTest: true,
+    depthWrite: true,
+    transparent: true
+});
+const FXAAShaderMaterial = new ShaderMaterial({
+    uniforms: {
+        tDiffuse: { value: null },
+        resolution: { value: new Vector2(1 / 1024, 1 / 1024) }
+    },
     vertexShader: `
         ${ShaderChunk.common}
         ${ShaderChunk.logdepthbuf_pars_vertex}
@@ -122,7 +122,7 @@ const FXAAShaderMaterial = new ShaderMaterial({
             gl_Position = projectionMatrix * modelViewMatrix * vec4( position, 1.0 );
             ${ShaderChunk.logdepthbuf_vertex}
         }
-    `,
+    `,
     fragmentShader: `
         ${ShaderChunk.logdepthbuf_pars_fragment}
         precision highp float;
@@ -295,48 +295,48 @@ const FXAAShaderMaterial = new ShaderMaterial({
                 );
             ${ShaderChunk.logdepthbuf_fragment}
         }
-    `,
-    blending: NoBlending,
-    depthTest: false,
-    depthWrite: false,
-    transparent: true
-});
-const strokeShader = new RawShaderMaterial({
-    uniforms: {
-        tDiffuse: { value: null },
-        color: { value: new Color("#0f0") },
-        width: { value: 1.0 },
-        opacity: { value: 1.0 },
-        resolution: { value: new Vector2(1 / 512, 1 / 512) },
-        offset: {
-            value: [
-                new Vector2(0.000, 1.000),
-                new Vector2(0.259, 0.966),
-                new Vector2(0.500, 0.866),
-                new Vector2(0.707, 0.707),
-                new Vector2(0.866, 0.500),
-                new Vector2(0.966, 0.259),
-                new Vector2(1.000, 0.000),
-                new Vector2(0.966, -0.259),
-                new Vector2(0.866, -0.500),
-                new Vector2(0.707, -0.707),
-                new Vector2(0.500, -0.866),
-                new Vector2(0.259, -0.966),
-                new Vector2(0.000, -1.000),
-                new Vector2(-0.259, -0.966),
-                new Vector2(-0.500, -0.866),
-                new Vector2(-0.707, -0.707),
-                new Vector2(-0.866, -0.500),
-                new Vector2(-0.966, -0.259),
-                new Vector2(-1.000, -0.000),
-                new Vector2(-0.966, 0.259),
-                new Vector2(-0.866, 0.500),
-                new Vector2(-0.707, 0.707),
-                new Vector2(-0.500, 0.866),
-                new Vector2(-0.259, 0.966)
-            ]
-        }
-    },
+    `,
+    blending: NoBlending,
+    depthTest: false,
+    depthWrite: false,
+    transparent: true
+});
+const strokeShader = new RawShaderMaterial({
+    uniforms: {
+        tDiffuse: { value: null },
+        color: { value: new Color("#0f0") },
+        width: { value: 1.0 },
+        opacity: { value: 1.0 },
+        resolution: { value: new Vector2(1 / 512, 1 / 512) },
+        offset: {
+            value: [
+                new Vector2(0.000, 1.000),
+                new Vector2(0.259, 0.966),
+                new Vector2(0.500, 0.866),
+                new Vector2(0.707, 0.707),
+                new Vector2(0.866, 0.500),
+                new Vector2(0.966, 0.259),
+                new Vector2(1.000, 0.000),
+                new Vector2(0.966, -0.259),
+                new Vector2(0.866, -0.500),
+                new Vector2(0.707, -0.707),
+                new Vector2(0.500, -0.866),
+                new Vector2(0.259, -0.966),
+                new Vector2(0.000, -1.000),
+                new Vector2(-0.259, -0.966),
+                new Vector2(-0.500, -0.866),
+                new Vector2(-0.707, -0.707),
+                new Vector2(-0.866, -0.500),
+                new Vector2(-0.966, -0.259),
+                new Vector2(-1.000, -0.000),
+                new Vector2(-0.966, 0.259),
+                new Vector2(-0.866, 0.500),
+                new Vector2(-0.707, 0.707),
+                new Vector2(-0.500, 0.866),
+                new Vector2(-0.259, 0.966)
+            ]
+        }
+    },
     vertexShader: `
 		attribute vec3 position;
 		attribute vec2 uv;
@@ -344,7 +344,7 @@ const strokeShader = new RawShaderMaterial({
 		void main() {
 			vUv = uv;
 			gl_Position = vec4(position, 1.0);
-		}`,
+		}`,
     fragmentShader: `
 		#ifdef GL_ES
 			precision highp float;
@@ -380,22 +380,22 @@ const strokeShader = new RawShaderMaterial({
 			} else {
 				gl_FragColor = stroke();
 			}
-		}`,
-    blending: NoBlending,
-    depthTest: false,
-    depthWrite: false,
-    transparent: true
-});
-// 深度 min-blur（最近深度，忽略背景 1.0）：随描边一起把深度图向外扩，
-// 外扩区 selD = 物体最近深度(<1.0) 而非清屏 1.0，depthTest 在外扩区才能正确判遮挡（不漏光），
-// 同时本体区仍靠 depthTestShader 的 EPSILON 容差防自遮挡闪烁（无缝）。separable（direction 控制 H/V）。
-const depthMinBlurShader = new ShaderMaterial({
-    uniforms: {
-        tDepth: { value: null },
-        resolution: { value: new Vector2(1 / 512, 1 / 512) },
-        radius: { value: 1.0 },
-        direction: { value: new Vector2(1, 0) },
-    },
+		}`,
+    blending: NoBlending,
+    depthTest: false,
+    depthWrite: false,
+    transparent: true
+});
+// 深度 min-blur（最近深度，忽略背景 1.0）：随描边一起把深度图向外扩，
+// 外扩区 selD = 物体最近深度(<1.0) 而非清屏 1.0，depthTest 在外扩区才能正确判遮挡（不漏光），
+// 同时本体区仍靠 depthTestShader 的 EPSILON 容差防自遮挡闪烁（无缝）。separable（direction 控制 H/V）。
+const depthMinBlurShader = new ShaderMaterial({
+    uniforms: {
+        tDepth: { value: null },
+        resolution: { value: new Vector2(1 / 512, 1 / 512) },
+        radius: { value: 1.0 },
+        direction: { value: new Vector2(1, 0) },
+    },
     vertexShader: `
         ${ShaderChunk.common}
         ${ShaderChunk.logdepthbuf_pars_vertex}
@@ -405,7 +405,7 @@ const depthMinBlurShader = new ShaderMaterial({
             gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
             ${ShaderChunk.logdepthbuf_vertex}
         }
-    `,
+    `,
     fragmentShader: `
         ${ShaderChunk.logdepthbuf_pars_fragment}
         uniform sampler2D tDepth;
@@ -426,17 +426,17 @@ const depthMinBlurShader = new ShaderMaterial({
             gl_FragColor = vec4(minD, 0.0, 0.0, 1.0);
             ${ShaderChunk.logdepthbuf_fragment}
         }
-    `,
-    blending: NoBlending,
-    depthTest: false,
-    depthWrite: false,
-    transparent: true,
-});
-const filterSelectShader = new RawShaderMaterial({
-    uniforms: {
-        selectTexture: { value: null },
-        blurTexture: { value: null }
-    },
+    `,
+    blending: NoBlending,
+    depthTest: false,
+    depthWrite: false,
+    transparent: true,
+});
+const filterSelectShader = new RawShaderMaterial({
+    uniforms: {
+        selectTexture: { value: null },
+        blurTexture: { value: null }
+    },
     vertexShader: `
 		attribute vec3 position;
 		attribute vec2 uv;
@@ -445,7 +445,7 @@ const filterSelectShader = new RawShaderMaterial({
 			vUv = uv;
 			gl_Position = vec4(position, 1.0);
 		}
-	`,
+	`,
     fragmentShader: `
 		#ifdef GL_ES
 			precision highp float;
@@ -458,16 +458,16 @@ const filterSelectShader = new RawShaderMaterial({
 			gl_FragColor = texture2D(blurTexture, vUv);
 			gl_FragColor.a -= (texture2D(selectTexture, vUv).a);
 		}
-	`,
-    blending: NoBlending,
-    depthTest: false,
-    depthWrite: false,
-    transparent: true
-});
-const copyShader = new ShaderMaterial({
-    uniforms: {
-        map: { value: null },
-    },
+	`,
+    blending: NoBlending,
+    depthTest: false,
+    depthWrite: false,
+    transparent: true
+});
+const copyShader = new ShaderMaterial({
+    uniforms: {
+        map: { value: null },
+    },
     vertexShader: `
         ${ShaderChunk.common}
         ${ShaderChunk.logdepthbuf_pars_vertex}
@@ -477,7 +477,7 @@ const copyShader = new ShaderMaterial({
             gl_Position = projectionMatrix * modelViewMatrix * vec4( position, 1.0 );
             ${ShaderChunk.logdepthbuf_vertex}
         }
-    `,
+    `,
     fragmentShader: `
         ${ShaderChunk.logdepthbuf_pars_fragment}
         uniform sampler2D map;
@@ -486,116 +486,116 @@ const copyShader = new ShaderMaterial({
             gl_FragColor = texture2D(map, vUv);
             ${ShaderChunk.logdepthbuf_fragment}
         }
-    `,
-    depthTest: true,
-    depthWrite: true,
-    transparent: true
-});
-const scene = new Scene();
-export default function stroke_pass(renderer, camera, object3d, baseDepthTexture, devicePixelRatio) {
-    const { stroke_enable = false, stroke_color = "#04fa12", stroke_width = 1 } = object3d.userData;
-    if (!stroke_enable || stroke_width === 0) {
-        return;
-    }
-    const originRenderTarget = renderer.getRenderTarget();
-    // 灰度图渲染目标跟随主画面尺寸（= width × effectiveRatio），与 baseRenderTarget 完全一致，
-    // 消除灰度图与主画面尺寸不一致导致的放大重采样摩尔纹
-    renderer.getSize(size);
-    size.multiplyScalar(devicePixelRatio);
-    selectTextureTarget.setSize(size.x, size.y);
-    selectDepthTextureTarget.setSize(size.x, size.y);
-    // 缺陷修复：three r167 的 WebGLRenderTarget.setSize 不会同步 depthTexture，
-    // 需手动把 selectDepthTexture 尺寸与全屏 baseDepth 对齐，否则深度比例错位导致描边被错误 discard
-    selectDepthTexture.image.width = size.x;
-    selectDepthTexture.image.height = size.y;
-    selectDepthTexture.needsUpdate = true;
-    selectDepthTestTextureTarget.setSize(size.x, size.y);
-    blur1TextureTarget.setSize(size.x, size.y);
-    blur2TextureTarget.setSize(size.x, size.y);
-    selectDepthBlurTmpTextureTarget.setSize(size.x, size.y);
-    selectDepthBlurTextureTarget.setSize(size.x, size.y);
-    blurDepthTestTextureTarget.setSize(size.x, size.y);
-    // 1. 渲染物体本体 mask（灰度）
-    renderer.setRenderTarget(selectTextureTarget);
-    scene.children = [object3d];
-    renderer.clear();
-    renderer.render(scene, camera);
-    // 2. 渲染物体本体深度（无 MSAA，供 depthTest 判定遮挡）
-    renderer.setRenderTarget(selectDepthTextureTarget);
-    scene.children = [object3d];
-    renderer.clear();
-    renderer.render(scene, camera);
-    // 调试：把本次渲染的选区深度记到全局调试状态，供面板「辉光深度比对」读取
-    debugDepthState.lastSelectDepth = selectDepthTexture;
-    // 3. 深度测试（用本体 mask）：被真实更近物体挡住的「本体描边」部分 discard。
-    //    背景像素 baseDepth≈1.0（最远）永远不小于物体深度 → 不丢弃，浮空物体描边正常显示。
-    //    选中对象自身像素 baseD≈selD → 不丢弃，本体描边保留。
-    renderer.setRenderTarget(selectDepthTestTextureTarget);
-    renderer.clear();
-    depthTestShader.uniforms.map.value = selectTextureTarget.texture;
-    depthTestShader.uniforms.baseDepth.value = baseDepthTexture;
-    depthTestShader.uniforms.selectDepth.value = selectDepthTexture;
-    depthTestShader.uniforms.cameraFar.value = camera.far;
-    depthTestShader.uniforms.uDebugVis.value = (window.__STROKE_DEPTH_VIS) ? 1.0 : 0.0;
-    fsQuad.render(renderer, depthTestShader);
-    // 4. 从「深度测试后的本体描边」开始外扩（外扩环自动继承本体遮挡判定 → 不漏光），
-    //    描边粗细由 stroke_width 控制的迭代次数决定。
-    strokeShader.uniforms.resolution.value.set(1 / size.x, 1 / size.y);
-    FXAAShaderMaterial.uniforms.resolution.value.set(1 / size.x, 1 / size.y);
-    strokeShader.uniforms.color.value.set(stroke_color);
-    strokeShader.uniforms.width.value = 1;
-    renderer.setRenderTarget(blur1TextureTarget);
-    strokeShader.uniforms.tDiffuse.value = selectDepthTestTextureTarget.texture;
-    fsQuad.render(renderer, strokeShader);
-    renderer.setRenderTarget(blur2TextureTarget);
-    strokeShader.uniforms.tDiffuse.value = blur1TextureTarget.texture;
-    fsQuad.render(renderer, strokeShader);
-    // 迭代外扩（stroke_width 控制粗细）
-    for (let i = 0; i < stroke_width - 2; i++) {
-        renderer.setRenderTarget(blur1TextureTarget);
-        strokeShader.uniforms.tDiffuse.value = blur2TextureTarget.texture;
-        fsQuad.render(renderer, strokeShader);
-        renderer.setRenderTarget(blur2TextureTarget);
-        strokeShader.uniforms.tDiffuse.value = blur1TextureTarget.texture;
-        fsQuad.render(renderer, strokeShader);
-    }
-    // 5. 最后抗锯齿
-    renderer.setRenderTarget(blur1TextureTarget);
-    FXAAShaderMaterial.uniforms.tDiffuse.value = blur2TextureTarget.texture;
-    fsQuad.render(renderer, FXAAShaderMaterial);
-    // 5.5 ⭐ 外扩环深度测试（补齐此前只定义未调用的死代码）：
-    //   本体深度随描边一起外扩（separable H/V，外扩区取邻域最近深度），
-    //   再用它对外扩后的描边做一次 depthTest。
-    //   缺了这一步，外扩环（描边的视觉主体）永远不参与遮挡判定 →
-    //   物体被挡住时描边依旧从遮挡物前方漏出来（"深度测试看起来失效"的真根因之一）。
-    depthMinBlurShader.uniforms.resolution.value.set(1 / size.x, 1 / size.y);
-    depthMinBlurShader.uniforms.radius.value = Math.max(1, stroke_width);
-    // H：直接采 DepthTexture（selectDepthTexture），其 .r 即对数深度
-    depthMinBlurShader.uniforms.direction.value.set(1, 0);
-    depthMinBlurShader.uniforms.tDepth.value = selectDepthTexture;
-    renderer.setRenderTarget(selectDepthBlurTmpTextureTarget);
-    fsQuad.render(renderer, depthMinBlurShader);
-    // V
-    depthMinBlurShader.uniforms.direction.value.set(0, 1);
-    depthMinBlurShader.uniforms.tDepth.value = selectDepthBlurTmpTextureTarget.texture;
-    renderer.setRenderTarget(selectDepthBlurTextureTarget);
-    fsQuad.render(renderer, depthMinBlurShader);
-    // 5.6 对外扩后的描边判遮挡：被更近几何挡住的外扩环像素 discard。
-    //     ⚠️ 输出到独立 target，绝不回写 blur1（历史回归 bug：blur1 被 depthTest 结果覆盖
-    //        会导致步骤 6 相减归零、描边全不显示）。
-    renderer.setRenderTarget(blurDepthTestTextureTarget);
-    renderer.clear();
-    depthTestShader.uniforms.map.value = blur1TextureTarget.texture;
-    depthTestShader.uniforms.baseDepth.value = baseDepthTexture;
-    depthTestShader.uniforms.selectDepth.value = selectDepthBlurTextureTarget.texture;
-    depthTestShader.uniforms.cameraFar.value = camera.far;
-    depthTestShader.uniforms.uDebugVis.value = 0.0;
-    fsQuad.render(renderer, depthTestShader);
-    // 6. 合成：最终外扩描边(blurDepthTest，已判遮挡) 减去 深度测试后的本体描边
-    //    = 仅保留描边外扩环；本体被减掉。filterSelectShader 用 NormalBlending 叠到场景上。
-    renderer.setRenderTarget(originRenderTarget);
-    filterSelectShader.uniforms.selectTexture.value = selectDepthTestTextureTarget.texture;
-    filterSelectShader.uniforms.blurTexture.value = blurDepthTestTextureTarget.texture;
-    filterSelectShader.blending = NormalBlending;
-    fsQuad.render(renderer, filterSelectShader);
-}
+    `,
+    depthTest: true,
+    depthWrite: true,
+    transparent: true
+});
+const scene = new Scene();
+export default function stroke_pass(renderer, camera, object3d, baseDepthTexture, devicePixelRatio) {
+    const { stroke_enable = false, stroke_color = "#04fa12", stroke_width = 1 } = object3d.userData;
+    if (!stroke_enable || stroke_width === 0) {
+        return;
+    }
+    const originRenderTarget = renderer.getRenderTarget();
+    // 灰度图渲染目标跟随主画面尺寸（= width × effectiveRatio），与 baseRenderTarget 完全一致，
+    // 消除灰度图与主画面尺寸不一致导致的放大重采样摩尔纹
+    renderer.getSize(size);
+    size.multiplyScalar(devicePixelRatio);
+    selectTextureTarget.setSize(size.x, size.y);
+    selectDepthTextureTarget.setSize(size.x, size.y);
+    // 缺陷修复：three r167 的 WebGLRenderTarget.setSize 不会同步 depthTexture，
+    // 需手动把 selectDepthTexture 尺寸与全屏 baseDepth 对齐，否则深度比例错位导致描边被错误 discard
+    selectDepthTexture.image.width = size.x;
+    selectDepthTexture.image.height = size.y;
+    selectDepthTexture.needsUpdate = true;
+    selectDepthTestTextureTarget.setSize(size.x, size.y);
+    blur1TextureTarget.setSize(size.x, size.y);
+    blur2TextureTarget.setSize(size.x, size.y);
+    selectDepthBlurTmpTextureTarget.setSize(size.x, size.y);
+    selectDepthBlurTextureTarget.setSize(size.x, size.y);
+    blurDepthTestTextureTarget.setSize(size.x, size.y);
+    // 1. 渲染物体本体 mask（灰度）
+    renderer.setRenderTarget(selectTextureTarget);
+    scene.children = [object3d];
+    renderer.clear();
+    renderer.render(scene, camera);
+    // 2. 渲染物体本体深度（无 MSAA，供 depthTest 判定遮挡）
+    renderer.setRenderTarget(selectDepthTextureTarget);
+    scene.children = [object3d];
+    renderer.clear();
+    renderer.render(scene, camera);
+    // 调试：把本次渲染的选区深度记到全局调试状态，供面板「辉光深度比对」读取
+    debugDepthState.lastSelectDepth = selectDepthTexture;
+    // 3. 深度测试（用本体 mask）：被真实更近物体挡住的「本体描边」部分 discard。
+    //    背景像素 baseDepth≈1.0（最远）永远不小于物体深度 → 不丢弃，浮空物体描边正常显示。
+    //    选中对象自身像素 baseD≈selD → 不丢弃，本体描边保留。
+    renderer.setRenderTarget(selectDepthTestTextureTarget);
+    renderer.clear();
+    depthTestShader.uniforms.map.value = selectTextureTarget.texture;
+    depthTestShader.uniforms.baseDepth.value = baseDepthTexture;
+    depthTestShader.uniforms.selectDepth.value = selectDepthTexture;
+    depthTestShader.uniforms.cameraFar.value = camera.far;
+    depthTestShader.uniforms.uDebugVis.value = (window.__STROKE_DEPTH_VIS) ? 1.0 : 0.0;
+    fsQuad.render(renderer, depthTestShader);
+    // 4. 从「深度测试后的本体描边」开始外扩（外扩环自动继承本体遮挡判定 → 不漏光），
+    //    描边粗细由 stroke_width 控制的迭代次数决定。
+    strokeShader.uniforms.resolution.value.set(1 / size.x, 1 / size.y);
+    FXAAShaderMaterial.uniforms.resolution.value.set(1 / size.x, 1 / size.y);
+    strokeShader.uniforms.color.value.set(stroke_color);
+    strokeShader.uniforms.width.value = 1;
+    renderer.setRenderTarget(blur1TextureTarget);
+    strokeShader.uniforms.tDiffuse.value = selectDepthTestTextureTarget.texture;
+    fsQuad.render(renderer, strokeShader);
+    renderer.setRenderTarget(blur2TextureTarget);
+    strokeShader.uniforms.tDiffuse.value = blur1TextureTarget.texture;
+    fsQuad.render(renderer, strokeShader);
+    // 迭代外扩（stroke_width 控制粗细）
+    for (let i = 0; i < stroke_width - 2; i++) {
+        renderer.setRenderTarget(blur1TextureTarget);
+        strokeShader.uniforms.tDiffuse.value = blur2TextureTarget.texture;
+        fsQuad.render(renderer, strokeShader);
+        renderer.setRenderTarget(blur2TextureTarget);
+        strokeShader.uniforms.tDiffuse.value = blur1TextureTarget.texture;
+        fsQuad.render(renderer, strokeShader);
+    }
+    // 5. 最后抗锯齿
+    renderer.setRenderTarget(blur1TextureTarget);
+    FXAAShaderMaterial.uniforms.tDiffuse.value = blur2TextureTarget.texture;
+    fsQuad.render(renderer, FXAAShaderMaterial);
+    // 5.5 ⭐ 外扩环深度测试（补齐此前只定义未调用的死代码）：
+    //   本体深度随描边一起外扩（separable H/V，外扩区取邻域最近深度），
+    //   再用它对外扩后的描边做一次 depthTest。
+    //   缺了这一步，外扩环（描边的视觉主体）永远不参与遮挡判定 →
+    //   物体被挡住时描边依旧从遮挡物前方漏出来（"深度测试看起来失效"的真根因之一）。
+    depthMinBlurShader.uniforms.resolution.value.set(1 / size.x, 1 / size.y);
+    depthMinBlurShader.uniforms.radius.value = Math.max(1, stroke_width);
+    // H：直接采 DepthTexture（selectDepthTexture），其 .r 即对数深度
+    depthMinBlurShader.uniforms.direction.value.set(1, 0);
+    depthMinBlurShader.uniforms.tDepth.value = selectDepthTexture;
+    renderer.setRenderTarget(selectDepthBlurTmpTextureTarget);
+    fsQuad.render(renderer, depthMinBlurShader);
+    // V
+    depthMinBlurShader.uniforms.direction.value.set(0, 1);
+    depthMinBlurShader.uniforms.tDepth.value = selectDepthBlurTmpTextureTarget.texture;
+    renderer.setRenderTarget(selectDepthBlurTextureTarget);
+    fsQuad.render(renderer, depthMinBlurShader);
+    // 5.6 对外扩后的描边判遮挡：被更近几何挡住的外扩环像素 discard。
+    //     ⚠️ 输出到独立 target，绝不回写 blur1（历史回归 bug：blur1 被 depthTest 结果覆盖
+    //        会导致步骤 6 相减归零、描边全不显示）。
+    renderer.setRenderTarget(blurDepthTestTextureTarget);
+    renderer.clear();
+    depthTestShader.uniforms.map.value = blur1TextureTarget.texture;
+    depthTestShader.uniforms.baseDepth.value = baseDepthTexture;
+    depthTestShader.uniforms.selectDepth.value = selectDepthBlurTextureTarget.texture;
+    depthTestShader.uniforms.cameraFar.value = camera.far;
+    depthTestShader.uniforms.uDebugVis.value = 0.0;
+    fsQuad.render(renderer, depthTestShader);
+    // 6. 合成：最终外扩描边(blurDepthTest，已判遮挡) 减去 深度测试后的本体描边
+    //    = 仅保留描边外扩环；本体被减掉。filterSelectShader 用 NormalBlending 叠到场景上。
+    renderer.setRenderTarget(originRenderTarget);
+    filterSelectShader.uniforms.selectTexture.value = selectDepthTestTextureTarget.texture;
+    filterSelectShader.uniforms.blurTexture.value = blurDepthTestTextureTarget.texture;
+    filterSelectShader.blending = NormalBlending;
+    fsQuad.render(renderer, filterSelectShader);
+}

package/shaders/FXAAShaderMaterial.d.ts

@@ -1,3 +1,3 @@
-import { ShaderMaterial } from "three";
-declare const FXAAShaderMaterial: ShaderMaterial;
-export default FXAAShaderMaterial;
+import { ShaderMaterial } from "three";
+declare const FXAAShaderMaterial: ShaderMaterial;
+export default FXAAShaderMaterial;