three-base 2.0.168 → 2.0.172

package/pass/stroke_pass.js

@@ -15,23 +15,20 @@ const selectDepthTexture = (() => {
     baseDepthTexture.anisotropy = 16;
     return baseDepthTexture;
 })();
+// ⭐ 2026-10-11 皇上旨「简化渲染，少渲两遍」：selectDepthTexture 直接挂在 mask 目标上当
+// depth attachment —— 深度是光栅器的副产品（零额外代价），mask 那一次渲染顺带把它写进来。
+// 原先还要为同一个对象再单独渲一趟「只出深度」（同材质、同相机、同几何 ⇒ 深度值逐位相同），
+// stroke/glow/cover/bloom 四个 pass 各一遍 ⇒ 每个带特效的对象每帧白渲 4 趟，已整条删除。
 const selectTextureTarget = new WebGLRenderTarget(1024, 1024, {
     minFilter: LinearFilter,
     magFilter: LinearFilter,
     format: RGBAFormat,
+    depthTexture: selectDepthTexture,
     anisotropy: 16,
-    // 无 MSAA：mask 颜色与下方 selectDepthTextureTarget（深度）必须同为硬边缘，
+    // 无 MSAA：mask 颜色与它顺带写入的深度必须同为硬边缘，
     // 否则 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,
@@ -503,7 +500,6 @@ export default function stroke_pass(renderer, camera, object3d, baseDepthTexture
     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;
@@ -515,16 +511,14 @@ export default function stroke_pass(renderer, camera, object3d, baseDepthTexture
     selectDepthBlurTmpTextureTarget.setSize(size.x, size.y);
     selectDepthBlurTextureTarget.setSize(size.x, size.y);
     blurDepthTestTextureTarget.setSize(size.x, size.y);
-    // 1. 渲染物体本体 mask（灰度）
+    // 1. 渲染物体本体 mask（灰度）。⭐ 本体深度由同一趟光栅化顺带写进 selectDepthTexture
+    //   （挂在 selectTextureTarget 的 depth attachment 上）—— 原先这里还有第 2 趟「只渲深度」，
+    //   同材质/同相机/同几何 ⇒ 深度逐位相同，纯重复遍历，2026-10-11 皇上旨简化时删除。
+    //   （下面的步骤编号保留 3/4/5…，别处注释按号交叉引用，不随之重排。）
     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。

package/pass/stroke_pass.ts

@@ -18,25 +18,21 @@ const selectDepthTexture: DepthTexture = (() => {
     return baseDepthTexture;
 })();
 
+// ⭐ 2026-10-11 皇上旨「简化渲染，少渲两遍」：selectDepthTexture 直接挂在 mask 目标上当
+// depth attachment —— 深度是光栅器的副产品（零额外代价），mask 那一次渲染顺带把它写进来。
+// 原先还要为同一个对象再单独渲一趟「只出深度」（同材质、同相机、同几何 ⇒ 深度值逐位相同），
+// stroke/glow/cover/bloom 四个 pass 各一遍 ⇒ 每个带特效的对象每帧白渲 4 趟，已整条删除。
 const selectTextureTarget: WebGLRenderTarget = new WebGLRenderTarget(1024, 1024, {
     minFilter: LinearFilter,
     magFilter: LinearFilter,
     format: RGBAFormat,
+    depthTexture: selectDepthTexture,
     anisotropy: 16,
-    // 无 MSAA：mask 颜色与下方 selectDepthTextureTarget（深度）必须同为硬边缘，
+    // 无 MSAA：mask 颜色与它顺带写入的深度必须同为硬边缘，
     // 否则 mask 边缘平滑而深度硬 → depthTestShader 判定边界与 mask 视觉边缘错位，描边边缘锯齿。
     // 边缘抗锯齿统一由 mask 内部 FXAA + 终处理 FXAA 兜底。
 });
 
-// 无 MSAA 的深度专用目标：仅用于导出对象深度，供 depthTestShader 做遮挡判定（深度无需抗锯齿）
-const selectDepthTextureTarget: WebGLRenderTarget = new WebGLRenderTarget(1024, 1024, {
-    minFilter: LinearFilter,
-    magFilter: LinearFilter,
-    format: RGBAFormat,
-    depthTexture: selectDepthTexture,
-    anisotropy: 16,
-});
-
 const selectDepthTestTextureTarget: WebGLRenderTarget = new WebGLRenderTarget(1024, 1024, {
     minFilter: LinearFilter,
     magFilter: LinearFilter,
@@ -532,7 +528,6 @@ export default function stroke_pass(
     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;
@@ -545,17 +540,14 @@ export default function stroke_pass(
     selectDepthBlurTextureTarget.setSize(size.x, size.y);
     blurDepthTestTextureTarget.setSize(size.x, size.y);
 
-    // 1. 渲染物体本体 mask（灰度）
+    // 1. 渲染物体本体 mask（灰度）。⭐ 本体深度由同一趟光栅化顺带写进 selectDepthTexture
+    //   （挂在 selectTextureTarget 的 depth attachment 上）—— 原先这里还有第 2 趟「只渲深度」，
+    //   同材质/同相机/同几何 ⇒ 深度逐位相同，纯重复遍历，2026-10-11 皇上旨简化时删除。
+    //   （下面的步骤编号保留 3/4/5…，别处注释按号交叉引用，不随之重排。）
     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;
 

package/shaders/baseDepthVisShader.d.ts

@@ -2,7 +2,7 @@ import { ShaderMaterial } from "three";
 /**
  * 调试用：把 baseDepthTexture（可见深度图）直接以灰度输出到屏幕。
  * 对数深度：近=0(黑) 远=1(白)。
- *   - 全屏纯白  → 深度图为空（全 clear 1.0），说明 renderAoDepthPass 没把深度写进 baseDepthTexture；
+ *   - 全屏纯白  → 深度图为空（全 clear 1.0），说明 renderVisibleDepthPass 没把深度写进 baseDepthTexture；
  *                 此时所有依赖深度遮挡的后处理(stroke/glow/cover/frosted)都会"一律显示在前"。
  *   - 有灰阶/明暗  → 深度图正常，问题在比对侧(selectDepth / depthTestShader)。
  * 触发：在控制台执行 `window.__BASE_DEPTH_VIS = true` 后画面即切到该视图。

package/shaders/baseDepthVisShader.js

@@ -2,7 +2,7 @@ import { ShaderChunk, ShaderMaterial } from "three";
 /**
  * 调试用：把 baseDepthTexture（可见深度图）直接以灰度输出到屏幕。
  * 对数深度：近=0(黑) 远=1(白)。
- *   - 全屏纯白  → 深度图为空（全 clear 1.0），说明 renderAoDepthPass 没把深度写进 baseDepthTexture；
+ *   - 全屏纯白  → 深度图为空（全 clear 1.0），说明 renderVisibleDepthPass 没把深度写进 baseDepthTexture；
  *                 此时所有依赖深度遮挡的后处理(stroke/glow/cover/frosted)都会"一律显示在前"。
  *   - 有灰阶/明暗  → 深度图正常，问题在比对侧(selectDepth / depthTestShader)。
  * 触发：在控制台执行 `window.__BASE_DEPTH_VIS = true` 后画面即切到该视图。

package/shaders/baseDepthVisShader.ts

@@ -2,7 +2,7 @@ import { ShaderChunk, ShaderMaterial } from "three";
 /**
  * 调试用：把 baseDepthTexture（可见深度图）直接以灰度输出到屏幕。
  * 对数深度：近=0(黑) 远=1(白)。
- *   - 全屏纯白  → 深度图为空（全 clear 1.0），说明 renderAoDepthPass 没把深度写进 baseDepthTexture；
+ *   - 全屏纯白  → 深度图为空（全 clear 1.0），说明 renderVisibleDepthPass 没把深度写进 baseDepthTexture；
  *                 此时所有依赖深度遮挡的后处理(stroke/glow/cover/frosted)都会"一律显示在前"。
  *   - 有灰阶/明暗  → 深度图正常，问题在比对侧(selectDepth / depthTestShader)。
  * 触发：在控制台执行 `window.__BASE_DEPTH_VIS = true` 后画面即切到该视图。

package/shaders/debugDepthCompareShader.d.ts

@@ -5,7 +5,7 @@ import { ShaderMaterial } from "three";
  *   R = 全局 base 深度（baseDepthTexture，排除地板）
  *   G = 选区自身深度（selectDepthTexture，由 glow_pass/stroke_pass 渲染后写入 debugDepthState）
  * 两路都用 `pow(cameraFar+1, d)-1` 反推到近似线性视深再归一化（背景≈1 → 黄白）。
- *   - R 全白、G 也有内容 → 全局 base 深度没写进（renderAoDepthPass 失效），但选区深度正常；
+ *   - R 全白、G 也有内容 → 全局 base 深度没写进（renderVisibleDepthPass 失效），但选区深度正常；
  *   - R、G 都全白       → 两路深度都没写进；
  *   - R 有灰阶、G 全白   → 选区深度没写进（glow/stroke 自身的深度 pass 失效）；
  *   - R、G 都有灰阶      → 深度正常，问题在 depthTestShader 比对侧。

package/shaders/debugDepthCompareShader.js

@@ -5,7 +5,7 @@ import { ShaderChunk, ShaderMaterial } from "three";
  *   R = 全局 base 深度（baseDepthTexture，排除地板）
  *   G = 选区自身深度（selectDepthTexture，由 glow_pass/stroke_pass 渲染后写入 debugDepthState）
  * 两路都用 `pow(cameraFar+1, d)-1` 反推到近似线性视深再归一化（背景≈1 → 黄白）。
- *   - R 全白、G 也有内容 → 全局 base 深度没写进（renderAoDepthPass 失效），但选区深度正常；
+ *   - R 全白、G 也有内容 → 全局 base 深度没写进（renderVisibleDepthPass 失效），但选区深度正常；
  *   - R、G 都全白       → 两路深度都没写进；
  *   - R 有灰阶、G 全白   → 选区深度没写进（glow/stroke 自身的深度 pass 失效）；
  *   - R、G 都有灰阶      → 深度正常，问题在 depthTestShader 比对侧。

package/shaders/debugDepthCompareShader.ts

@@ -6,7 +6,7 @@ import { ShaderChunk, ShaderMaterial } from "three";
  *   R = 全局 base 深度（baseDepthTexture，排除地板）
  *   G = 选区自身深度（selectDepthTexture，由 glow_pass/stroke_pass 渲染后写入 debugDepthState）
  * 两路都用 `pow(cameraFar+1, d)-1` 反推到近似线性视深再归一化（背景≈1 → 黄白）。
- *   - R 全白、G 也有内容 → 全局 base 深度没写进（renderAoDepthPass 失效），但选区深度正常；
+ *   - R 全白、G 也有内容 → 全局 base 深度没写进（renderVisibleDepthPass 失效），但选区深度正常；
  *   - R、G 都全白       → 两路深度都没写进；
  *   - R 有灰阶、G 全白   → 选区深度没写进（glow/stroke 自身的深度 pass 失效）；
  *   - R、G 都有灰阶      → 深度正常，问题在 depthTestShader 比对侧。

package/shaders/debugExcludedShader.d.ts

@@ -3,11 +3,13 @@ import { ShaderMaterial } from "three";
  * 调试用：把「可见深度图」与「被排除面 mask」叠在一起看。
  *
  * 底色 = baseDepthTexture 灰度（近黑远白，同「全局深度图」档）；
- * 红色 = 该像素上的表面被 renderAoDepthPass 排除（sprite/线条/点、userData.aoTransparent、
- *        标了 userData.aoFloor 的地板 Ground1 等）→ **它写不进深度图，永远挡不住任何后处理**。
+ * 红色 = 该像素上的表面被 renderVisibleDepthPass 排除（sprite/线条/点、userData.aoTransparent）
+ *        → **它写不进深度图，永远挡不住任何后处理**。
+ *        ⚠️ 地板 Ground1 不在此列：2026-10-11 皇上旨「物体的深度都要进深度图」，原 aoFloor 排除特例
+ *        已整条拆除，地板现在是正常写深度的实心面（该像素应显示为灰、不是红）。
  *
- * 判读：挡不住你的那个面如果是红的 → 不是深度算法坏了，是它被设计成可透视；
- *       把该对象的 userData.aoTransparent 去掉 / 不要标 aoFloor，即可让它参与遮挡。
+ * 判读：挡不住你的那个面如果是红的 → 不是深度算法坏了，是它被标记成可透视；
+ *       把该对象的 userData.aoTransparent 去掉即可让它参与遮挡。
  */
 declare const debugExcludedShader: ShaderMaterial;
 export default debugExcludedShader;

package/shaders/debugExcludedShader.js

@@ -3,11 +3,13 @@ import { ShaderChunk, ShaderMaterial } from "three";
  * 调试用：把「可见深度图」与「被排除面 mask」叠在一起看。
  *
  * 底色 = baseDepthTexture 灰度（近黑远白，同「全局深度图」档）；
- * 红色 = 该像素上的表面被 renderAoDepthPass 排除（sprite/线条/点、userData.aoTransparent、
- *        标了 userData.aoFloor 的地板 Ground1 等）→ **它写不进深度图，永远挡不住任何后处理**。
+ * 红色 = 该像素上的表面被 renderVisibleDepthPass 排除（sprite/线条/点、userData.aoTransparent）
+ *        → **它写不进深度图，永远挡不住任何后处理**。
+ *        ⚠️ 地板 Ground1 不在此列：2026-10-11 皇上旨「物体的深度都要进深度图」，原 aoFloor 排除特例
+ *        已整条拆除，地板现在是正常写深度的实心面（该像素应显示为灰、不是红）。
  *
- * 判读：挡不住你的那个面如果是红的 → 不是深度算法坏了，是它被设计成可透视；
- *       把该对象的 userData.aoTransparent 去掉 / 不要标 aoFloor，即可让它参与遮挡。
+ * 判读：挡不住你的那个面如果是红的 → 不是深度算法坏了，是它被标记成可透视；
+ *       把该对象的 userData.aoTransparent 去掉即可让它参与遮挡。
  */
 const debugExcludedShader = new ShaderMaterial({
     uniforms: {

package/shaders/debugExcludedShader.ts

@@ -4,11 +4,13 @@ import { ShaderChunk, ShaderMaterial, Texture } from "three";
  * 调试用：把「可见深度图」与「被排除面 mask」叠在一起看。
  *
  * 底色 = baseDepthTexture 灰度（近黑远白，同「全局深度图」档）；
- * 红色 = 该像素上的表面被 renderAoDepthPass 排除（sprite/线条/点、userData.aoTransparent、
- *        标了 userData.aoFloor 的地板 Ground1 等）→ **它写不进深度图，永远挡不住任何后处理**。
+ * 红色 = 该像素上的表面被 renderVisibleDepthPass 排除（sprite/线条/点、userData.aoTransparent）
+ *        → **它写不进深度图，永远挡不住任何后处理**。
+ *        ⚠️ 地板 Ground1 不在此列：2026-10-11 皇上旨「物体的深度都要进深度图」，原 aoFloor 排除特例
+ *        已整条拆除，地板现在是正常写深度的实心面（该像素应显示为灰、不是红）。
  *
- * 判读：挡不住你的那个面如果是红的 → 不是深度算法坏了，是它被设计成可透视；
- *       把该对象的 userData.aoTransparent 去掉 / 不要标 aoFloor，即可让它参与遮挡。
+ * 判读：挡不住你的那个面如果是红的 → 不是深度算法坏了，是它被标记成可透视；
+ *       把该对象的 userData.aoTransparent 去掉即可让它参与遮挡。
  */
 const debugExcludedShader = new ShaderMaterial({
     uniforms: {