three-base 2.0.142 → 2.0.166

package/MktMesh/mktMappingShader.ts

@@ -1,139 +1,139 @@
-/*
- * 全景「序号直取」投射着色器（mapping shader）：MktMesh 基类（发布/预览）、
- * 编辑器 mapping 档墙体、家具立方体三处共用。
- *
- * 取图口径：按几何 attribute aPanoIndex 在 panoIndices 槽里对号取图，不看距离、不看夹角。
- * 与 blend / selected 共用同一份 floorVertexShader 与同一套采样口径（改采样两处同改）。
- */
-import { BackSide, Matrix4, ShaderMaterial, Vector3 } from "three";
-import { createPlaceholderTexture, floorVertexShader, MKT_PANO_MAX_SLOTS, RT_STITCH_SLOT_COUNT } from "./mktShader";
-
-/**
- * 序号直取片元（皇上旨 2026-09-29「三模式三 shader」之二）：
- * 按三角面 aPanoIndex 在 panoIndices 槽里找对应全景纹理 —— **不看距离、不看夹角**（blend 那套打分/归约整段没有）。
- * 槽内采样段（等距柱状投射 + 左右 2 张拼合槽 + 采样即线性、不再手动 pow 解码）与 blend **逐字同口径**；改采样口径两处同改。
- * 未设序号 / 序号不在槽里 / 该槽瓦片没绑好（weights≤0）→ uFaceMissingColor 深灰兜底
- * （皇上旨 09-28「装不下就深灰」；weights 闸是 09-29 拆分时补的 —— 原运行时分支没这道闸，
- * 槽没绑好但序号命中会采到 vec3(0) 纯黑，深灰才是钦定兜底色）。
- */
-function buildFloorMappingFragment(maxPano: number): string {
-    // 每个全景点占 **2** 张拼合槽纹理（32 片每 16 片拼一张：左半幅 / 右半幅）⇒ 8 × 2 = 16 = sampler 硬顶
-    const tileCount = maxPano * RT_STITCH_SLOT_COUNT;
-    let slotCalc = ""; // 每槽各自采样出 linK（weights[k]>0 才采；没绑好保持 0，由 facePick 的 weights 闸兜成深灰）
-    let slotFacePick = ""; // 逐槽展开「panoIndices[k]==vPanoIndex 则取 lin{k}」（ANGLE 禁动态索引 ⇒ JS 常量展开）
-    for (let k = 0; k < maxPano; k++) {
-        const base = k * RT_STITCH_SLOT_COUNT; // 本点占 2 个连续纹理槽：base=k*2 .. base+1（顺序 [左半幅, 右半幅]）
-        slotFacePick += `
-        if (panoIndices[${k}] >= 0.0 && weights[${k}] > 0.0 && abs(panoIndices[${k}] - vPanoIndex) < 0.5) faceCol = lin${k};`;
-        slotCalc += `
-        // ── 点槽 ${k}（纹理 ${base}..${base + 1}）──
-        vec3 lin${k} = vec3(0.0);
-        if (weights[${k}] > 0.0) {
-            mat4 tm = textureMatrices[${k}];
-            vec3 texPos = tm[3].xyz;            // 投影中心 = 纹理矩阵位置
-            mat3 texRot = mat3(tm);             // 纹理朝向 = 旋转分量
-            vec3 dir = normalize(vProjPos - texPos);
-            dir = texRot * dir;                 // 转到纹理局部方向
-            float lon = atan(dir.z, dir.x);
-            float u = lon * 0.15915494309189535 + 0.5; // 经度 -> u
-            float lat = asin(clamp(dir.y, -1.0, 1.0));
-            // 等距柱状线性 v（= 全图 UV），与 blend / 单全景分支**逐字同口径**
-            float v = 0.5 + lat * 0.3183098861837907; // 1/PI
-            // 左右两半 -> 拼合槽下标 [左半幅=0, 右半幅=1]（每槽 = 8×4 网格里 4×4=16 片拼成，见 RT_STITCH_SLOT_TILES）
-            // ⭐ 10-06 晚旨：竖着不再分块 ⇒ 槽只随 u 走（与 blend / 单全景分支**逐字同口径**）
-            int tileIdx = (u >= 0.5) ? 1 : 0;
-            float localU = (u < 0.5) ? (u * 2.0) : (u * 2.0 - 1.0);
-            // ⛔ 纵向不再减半（槽就是全高）⇒ localV 恒等于 v；写成 2v/2v-1 = 纵向分辨率白丢一半
-            float localV = v;
-            // 🧩 该点这 2 槽装的是整图（whole 形态 / 没切过片）⇒ 还原成全图 UV 再采样（与 blend 逐字同口径）
-            float panoU = (uPanoTiled[${k}] > 0.5) ? localU : u;
-            float panoV = (uPanoTiled[${k}] > 0.5) ? localV : v;
-            // ⚠️ ANGLE(D3D) 禁止动态索引 sampler 数组：以下 2 个采样下标均为「base + 字面量」常量表达式，编译安全
-            // ⭐ 采样即线性（与单全景 / blend / selected 三路同一条口径，10-07 旨「色彩空间统一使用 liner」）：纹理都标了
-            //    colorSpace = SRGBColorSpace ⇒ 硬件上传成 SRGB8_ALPHA8、texture2D 已解码一次；
-            //    这里**不再手动 pow 解码**（那遍是二次解码 = 整体压暗），末端只编码一次 ⇒ 与源图逐字节还原。
-            if (tileIdx == 0) lin${k} = texture2D(panoramas[${base}], vec2(panoU, panoV)).rgb;
-            else lin${k} = texture2D(panoramas[${base + 1}], vec2(panoU, panoV)).rgb;
-        }`;
-    }
-    return /* glsl */ `
-    #include <logdepthbuf_pars_fragment>
-    uniform sampler2D panoramas[${tileCount}];
-    uniform mat4 textureMatrices[${maxPano}];
-    uniform float weights[${maxPano}];     // 该槽瓦片绑好了没（writeSlot 按账本写）
-    uniform float uPanoTiled[${maxPano}];
-    // ── 全景序号映射（皇上旨 2026-09-28）：本材质**只有这一种取图方式**（原 uFaceMappingMode 运行时分支已按
-    //    09-29「三模式三 shader」拆出成独立 shader）──
-    uniform float panoIndices[${maxPano}]; // 每个 slot 对应的「全景全局序号」（-1=空）
-    uniform vec3 uFaceMissingColor;        // 未设序号 / 序号不在槽里 / 槽没绑好 时的深灰兜底色（线性空间）
-    // 色彩空间只有一条路（10-07 旨「统一使用 liner」）：原 uniform float uColorSpace; + 那段 pow 分支已整条撤除（与 blend 同口径）
-    uniform float uPanoramaVisible;
-    varying vec3 vProjPos;
-    varying float vPanoIndex;
-    #ifdef USE_INSTANCING_COLOR
-    varying vec3 vInstanceColor;
-    #endif
-    void main() {
-        // ⭐ 先逐槽采样出 linK（weights[k]>0 才采；没绑好保持 vec3(0)，由下面 facePick 的 weights 闸兜成深灰）。
-        //    ⛔ 这一段必须先跑：下面 slotFacePick 直接引用 linK —— 漏插本段就是
-        //    「ERROR: 'lin0' : undeclared identifier」编译失败（2026-10-02 shader error 1282 的根因）。
-${slotCalc}
-        vec3 faceCol = uFaceMissingColor;  // 默认深灰（未设序号 vPanoIndex<0 / 不在 panoIndices 里 / 槽没绑好）
-${slotFacePick}
-        vec3 col = faceCol;
-        // 全景投射显隐：关闭时回落中性素色（与 blend 一致）
-        if (uPanoramaVisible < 0.5) col = vec3(0.78, 0.78, 0.80);
-        #ifdef USE_INSTANCING_COLOR
-            col *= vInstanceColor;
-        #endif
-        gl_FragColor = vec4(col, 1.0);
-        // 输出颜色空间编码：渲染到线性 RT（主编辑器后处理链）时 passthrough，渲染到 sRGB 屏幕（预览弹窗）时自动编码 sRGB
-        #include <colorspace_fragment>
-        #include <logdepthbuf_fragment>
-    }
-`;
-}
-
-/**
- * 创建「全景序号直取」着色器材质（皇上旨 2026-09-29「三模式三 shader」之二）：
- * 编辑器「映射设置模式」的墙材质 + **基类 MktMesh（发布/预览）的固定墙材质**
- * （皇上旨：mktmesh 就只有按照 attribute 配置来显示全景这一种固定的 shader）。
- * uniform 形状与 blend 工厂同档（panoramas[16]/textureMatrices[8]/weights[8]/uPanoTiled[8]）⇒
- * 喂料复用 feedBlendProjection 的槽位指派路（feedFaceMapping），零新喂料路。
- * uFloorCoreRadius/uFloorFadeRange/uFloorOpacity 三根本 shader 不读，但喂料统一入口会写 ⇒ JS 侧留着（静默忽略）。
- */
-export function createMktFloorMappingShaderMaterial(options: { maxPano?: number } = {}): ShaderMaterial {
-    const maxPano = Math.min(options.maxPano ?? MKT_PANO_MAX_SLOTS, MKT_PANO_MAX_SLOTS);
-    const tileCount = maxPano * RT_STITCH_SLOT_COUNT; // 8 点 × 左/右 2 槽 = 16 = sampler 硬顶
-    const panoramas: import("three").Texture[] = [];
-    const matrices: Matrix4[] = [];
-    for (let i = 0; i < tileCount; i++) panoramas.push(createPlaceholderTexture());
-    for (let i = 0; i < maxPano; i++) matrices.push(new Matrix4());
-    return new ShaderMaterial({
-        uniforms: {
-            panoramas: { value: panoramas },
-            textureMatrices: { value: matrices },
-            weights: { value: new Float32Array(maxPano) },
-            uPanoTiled: { value: new Float32Array(maxPano).fill(1) },
-            panoIndices: { value: new Float32Array(maxPano).fill(-1) },
-            uFaceMissingColor: { value: new Vector3(0.18, 0.18, 0.18) },
-            // 喂料统一入口会写（见上注释）；本 shader 不读 ⇒ 声明在此只为喂料零分支
-            uFloorCoreRadius: { value: 4 },
-            uFloorFadeRange: { value: 4 },
-            uFloorOpacity: { value: 1 },
-            uPanoramaVisible: { value: 1 },
-            // 色彩空间只有一条路（10-07 旨「统一使用 liner」）⇒ 原 `uColorSpace: { value: 0 }` 已随那段 pow 分支整条撤除
-            // 投影空间逆矩阵：与 blend 同口径（顶点着色器共用 floorVertexShader）
-            uProjInvMatrix: { value: new Matrix4() },
-        },
-        vertexShader: floorVertexShader,
-        fragmentShader: buildFloorMappingFragment(maxPano),
-        // ⭐ 墙专用材质（基类 MktMesh = 预览/发布 + 编辑器 mapping 模式墙，**同一座工厂同一份参数**，
-        //   皇上旨 2026-10-07 明确以此为准）：shader 默认**反面显示**（BackSide），零厚度幕墙只画朝房间内的那一面。
-        //   地板走「仅显示选中」工厂、维持 DoubleSide；立方体 mapping 档与墙共用这份实例 ⇒ 朝向跟着墙（10-02 旨），
-        //   另两档另建一份并显式拉回 DoubleSide（见渲染器 `_applyDisplayMode`）。
-        side: BackSide,
-        transparent: false,
-        toneMapped: false,
-    });
-}
+/*
+ * 全景「序号直取」投射着色器（mapping shader）：MktMesh 基类（发布/预览）、
+ * 编辑器 mapping 档墙体、家具立方体三处共用。
+ *
+ * 取图口径：按几何 attribute aPanoIndex 在 panoIndices 槽里对号取图，不看距离、不看夹角。
+ * 与 blend / selected 共用同一份 floorVertexShader 与同一套采样口径（改采样两处同改）。
+ */
+import { BackSide, Matrix4, ShaderMaterial, Vector3 } from "three";
+import { createPlaceholderTexture, floorVertexShader, MKT_PANO_MAX_SLOTS, RT_STITCH_SLOT_COUNT } from "./mktShader";
+
+/**
+ * 序号直取片元（皇上旨 2026-09-29「三模式三 shader」之二）：
+ * 按三角面 aPanoIndex 在 panoIndices 槽里找对应全景纹理 —— **不看距离、不看夹角**（blend 那套打分/归约整段没有）。
+ * 槽内采样段（等距柱状投射 + 左右 2 张拼合槽 + 采样即线性、不再手动 pow 解码）与 blend **逐字同口径**；改采样口径两处同改。
+ * 未设序号 / 序号不在槽里 / 该槽瓦片没绑好（weights≤0）→ uFaceMissingColor 深灰兜底
+ * （皇上旨 09-28「装不下就深灰」；weights 闸是 09-29 拆分时补的 —— 原运行时分支没这道闸，
+ * 槽没绑好但序号命中会采到 vec3(0) 纯黑，深灰才是钦定兜底色）。
+ */
+function buildFloorMappingFragment(maxPano: number): string {
+    // 每个全景点占 **2** 张拼合槽纹理（32 片每 16 片拼一张：左半幅 / 右半幅）⇒ 8 × 2 = 16 = sampler 硬顶
+    const tileCount = maxPano * RT_STITCH_SLOT_COUNT;
+    let slotCalc = ""; // 每槽各自采样出 linK（weights[k]>0 才采；没绑好保持 0，由 facePick 的 weights 闸兜成深灰）
+    let slotFacePick = ""; // 逐槽展开「panoIndices[k]==vPanoIndex 则取 lin{k}」（ANGLE 禁动态索引 ⇒ JS 常量展开）
+    for (let k = 0; k < maxPano; k++) {
+        const base = k * RT_STITCH_SLOT_COUNT; // 本点占 2 个连续纹理槽：base=k*2 .. base+1（顺序 [左半幅, 右半幅]）
+        slotFacePick += `
+        if (panoIndices[${k}] >= 0.0 && weights[${k}] > 0.0 && abs(panoIndices[${k}] - vPanoIndex) < 0.5) faceCol = lin${k};`;
+        slotCalc += `
+        // ── 点槽 ${k}（纹理 ${base}..${base + 1}）──
+        vec3 lin${k} = vec3(0.0);
+        if (weights[${k}] > 0.0) {
+            mat4 tm = textureMatrices[${k}];
+            vec3 texPos = tm[3].xyz;            // 投影中心 = 纹理矩阵位置
+            mat3 texRot = mat3(tm);             // 纹理朝向 = 旋转分量
+            vec3 dir = normalize(vProjPos - texPos);
+            dir = texRot * dir;                 // 转到纹理局部方向
+            float lon = atan(dir.z, dir.x);
+            float u = lon * 0.15915494309189535 + 0.5; // 经度 -> u
+            float lat = asin(clamp(dir.y, -1.0, 1.0));
+            // 等距柱状线性 v（= 全图 UV），与 blend / 单全景分支**逐字同口径**
+            float v = 0.5 + lat * 0.3183098861837907; // 1/PI
+            // 左右两半 -> 拼合槽下标 [左半幅=0, 右半幅=1]（每槽 = 8×4 网格里 4×4=16 片拼成，见 RT_STITCH_SLOT_TILES）
+            // ⭐ 10-06 晚旨：竖着不再分块 ⇒ 槽只随 u 走（与 blend / 单全景分支**逐字同口径**）
+            int tileIdx = (u >= 0.5) ? 1 : 0;
+            float localU = (u < 0.5) ? (u * 2.0) : (u * 2.0 - 1.0);
+            // ⛔ 纵向不再减半（槽就是全高）⇒ localV 恒等于 v；写成 2v/2v-1 = 纵向分辨率白丢一半
+            float localV = v;
+            // 🧩 该点这 2 槽装的是整图（whole 形态 / 没切过片）⇒ 还原成全图 UV 再采样（与 blend 逐字同口径）
+            float panoU = (uPanoTiled[${k}] > 0.5) ? localU : u;
+            float panoV = (uPanoTiled[${k}] > 0.5) ? localV : v;
+            // ⚠️ ANGLE(D3D) 禁止动态索引 sampler 数组：以下 2 个采样下标均为「base + 字面量」常量表达式，编译安全
+            // ⭐ 采样即线性（与单全景 / blend / selected 三路同一条口径，10-07 旨「色彩空间统一使用 liner」）：纹理都标了
+            //    colorSpace = SRGBColorSpace ⇒ 硬件上传成 SRGB8_ALPHA8、texture2D 已解码一次；
+            //    这里**不再手动 pow 解码**（那遍是二次解码 = 整体压暗），末端只编码一次 ⇒ 与源图逐字节还原。
+            if (tileIdx == 0) lin${k} = texture2D(panoramas[${base}], vec2(panoU, panoV)).rgb;
+            else lin${k} = texture2D(panoramas[${base + 1}], vec2(panoU, panoV)).rgb;
+        }`;
+    }
+    return /* glsl */ `
+    #include <logdepthbuf_pars_fragment>
+    uniform sampler2D panoramas[${tileCount}];
+    uniform mat4 textureMatrices[${maxPano}];
+    uniform float weights[${maxPano}];     // 该槽瓦片绑好了没（writeSlot 按账本写）
+    uniform float uPanoTiled[${maxPano}];
+    // ── 全景序号映射（皇上旨 2026-09-28）：本材质**只有这一种取图方式**（原 uFaceMappingMode 运行时分支已按
+    //    09-29「三模式三 shader」拆出成独立 shader）──
+    uniform float panoIndices[${maxPano}]; // 每个 slot 对应的「全景全局序号」（-1=空）
+    uniform vec3 uFaceMissingColor;        // 未设序号 / 序号不在槽里 / 槽没绑好 时的深灰兜底色（线性空间）
+    // 色彩空间只有一条路（10-07 旨「统一使用 liner」）：原 uniform float uColorSpace; + 那段 pow 分支已整条撤除（与 blend 同口径）
+    uniform float uPanoramaVisible;
+    varying vec3 vProjPos;
+    varying float vPanoIndex;
+    #ifdef USE_INSTANCING_COLOR
+    varying vec3 vInstanceColor;
+    #endif
+    void main() {
+        // ⭐ 先逐槽采样出 linK（weights[k]>0 才采；没绑好保持 vec3(0)，由下面 facePick 的 weights 闸兜成深灰）。
+        //    ⛔ 这一段必须先跑：下面 slotFacePick 直接引用 linK —— 漏插本段就是
+        //    「ERROR: 'lin0' : undeclared identifier」编译失败（2026-10-02 shader error 1282 的根因）。
+${slotCalc}
+        vec3 faceCol = uFaceMissingColor;  // 默认深灰（未设序号 vPanoIndex<0 / 不在 panoIndices 里 / 槽没绑好）
+${slotFacePick}
+        vec3 col = faceCol;
+        // 全景投射显隐：关闭时回落中性素色（与 blend 一致）
+        if (uPanoramaVisible < 0.5) col = vec3(0.78, 0.78, 0.80);
+        #ifdef USE_INSTANCING_COLOR
+            col *= vInstanceColor;
+        #endif
+        gl_FragColor = vec4(col, 1.0);
+        // 输出颜色空间编码：渲染到线性 RT（主编辑器后处理链）时 passthrough，渲染到 sRGB 屏幕（预览弹窗）时自动编码 sRGB
+        #include <colorspace_fragment>
+        #include <logdepthbuf_fragment>
+    }
+`;
+}
+
+/**
+ * 创建「全景序号直取」着色器材质（皇上旨 2026-09-29「三模式三 shader」之二）：
+ * 编辑器「映射设置模式」的墙材质 + **基类 MktMesh（发布/预览）的固定墙材质**
+ * （皇上旨：mktmesh 就只有按照 attribute 配置来显示全景这一种固定的 shader）。
+ * uniform 形状与 blend 工厂同档（panoramas[16]/textureMatrices[8]/weights[8]/uPanoTiled[8]）⇒
+ * 喂料复用 feedBlendProjection 的槽位指派路（feedFaceMapping），零新喂料路。
+ * uFloorCoreRadius/uFloorFadeRange/uFloorOpacity 三根本 shader 不读，但喂料统一入口会写 ⇒ JS 侧留着（静默忽略）。
+ */
+export function createMktFloorMappingShaderMaterial(options: { maxPano?: number } = {}): ShaderMaterial {
+    const maxPano = Math.min(options.maxPano ?? MKT_PANO_MAX_SLOTS, MKT_PANO_MAX_SLOTS);
+    const tileCount = maxPano * RT_STITCH_SLOT_COUNT; // 8 点 × 左/右 2 槽 = 16 = sampler 硬顶
+    const panoramas: import("three").Texture[] = [];
+    const matrices: Matrix4[] = [];
+    for (let i = 0; i < tileCount; i++) panoramas.push(createPlaceholderTexture());
+    for (let i = 0; i < maxPano; i++) matrices.push(new Matrix4());
+    return new ShaderMaterial({
+        uniforms: {
+            panoramas: { value: panoramas },
+            textureMatrices: { value: matrices },
+            weights: { value: new Float32Array(maxPano) },
+            uPanoTiled: { value: new Float32Array(maxPano).fill(1) },
+            panoIndices: { value: new Float32Array(maxPano).fill(-1) },
+            uFaceMissingColor: { value: new Vector3(0.18, 0.18, 0.18) },
+            // 喂料统一入口会写（见上注释）；本 shader 不读 ⇒ 声明在此只为喂料零分支
+            uFloorCoreRadius: { value: 4 },
+            uFloorFadeRange: { value: 4 },
+            uFloorOpacity: { value: 1 },
+            uPanoramaVisible: { value: 1 },
+            // 色彩空间只有一条路（10-07 旨「统一使用 liner」）⇒ 原 `uColorSpace: { value: 0 }` 已随那段 pow 分支整条撤除
+            // 投影空间逆矩阵：与 blend 同口径（顶点着色器共用 floorVertexShader）
+            uProjInvMatrix: { value: new Matrix4() },
+        },
+        vertexShader: floorVertexShader,
+        fragmentShader: buildFloorMappingFragment(maxPano),
+        // ⭐ 墙专用材质（基类 MktMesh = 预览/发布 + 编辑器 mapping 模式墙，**同一座工厂同一份参数**，
+        //   皇上旨 2026-10-07 明确以此为准）：shader 默认**反面显示**（BackSide），零厚度幕墙只画朝房间内的那一面。
+        //   地板走「仅显示选中」工厂、维持 DoubleSide；立方体 mapping 档与墙共用这份实例 ⇒ 朝向跟着墙（10-02 旨），
+        //   另两档另建一份并显式拉回 DoubleSide（见渲染器 `_applyDisplayMode`）。
+        side: BackSide,
+        transparent: false,
+        toneMapped: false,
+    });
+}