three-base 2.0.172 → 2.0.180

package/MktMesh/imageTileLoader.js

@@ -0,0 +1,55 @@
+/*
+ * @Description: 图片平面（「加平面」）的瓦片纹理加载器 —— ⭐ 2026-10-22 晚旨配套：图片平面**不用拼合器 RT**，
+ * 直接把上传切好的 4 张瓦片纹理绑到材质。本类负责「按 url 下载 + 异步解码 + 缓存在本 renderer 上下文」，
+ * 并把第 i 片的采样窗口（inset）算好交出去。
+ *
+ * 设计要点：
+ * - 纹理是 **WebGL 上下文私有**资源：编辑页 / 预览页各持一个实例（各自 GL context），⛔ 不跨 renderer 共享同一 Texture。
+ * - 复用库里 `loadPanoTexture`（fetch + createImageBitmap 工作线程解码、`imageOrientation:"flipY"` 预翻 + flipY=false，
+ *   与全景同一套上下翻约定）；本类只补 `colorSpace = SRGBColorSpace`（硬件采样即解 sRGB→linear，与旧 RT 方案逐字节同口径）。
+ * - inset 用库的 `rtStitchTileInset(i, tw, th, IMAGE_TILE_GRID)`：上传多切 8px、采样只取中间干净块 ⇒ 接缝不回潮，
+ *   与上传切片 `rtStitchTileRects` 共用同一份几何（⛔ 不许在这里另算一份）。
+ * - 逐张就绪、逐张显影：未就绪那张 `get()` 返回 null ⇒ 调方把那片传 null（材质显示灰），下一帧就绪后即亮。
+ */
+import { SRGBColorSpace, Vector4 } from "three";
+import { loadPanoTexture, releasePanoTexture } from "./panoBitmapTexture";
+import { IMAGE_TILE_GRID, rtStitchTileInset } from "./mktShader";
+export class ImagePlaneTileLoader {
+    cache = new Map();
+    inflight = new Map();
+    /** 触发某张瓦片下载 + 解码（已缓存 / 在途则跳过）；完成后填入 cache，下一帧 feed 即取到 */
+    preload(url) {
+        if (!url || this.cache.has(url) || this.inflight.has(url))
+            return;
+        const p = loadPanoTexture(url)
+            .then((tex) => {
+            tex.colorSpace = SRGBColorSpace; // 硬件采样解 sRGB→linear（与旧 RT 方案逐字节同口径）
+            const img = tex.image;
+            this.cache.set(url, { tex, w: img?.width ?? 0, h: img?.height ?? 0 });
+        })
+            .catch(() => {
+            // 下载 / 解码失败：留空，下一帧 preload 重新触发（不把半截纹理绑上去）
+        })
+            .finally(() => {
+            this.inflight.delete(url);
+        });
+        this.inflight.set(url, p);
+    }
+    /** 取已就绪的瓦片（未就绪返回 null） */
+    get(url) {
+        return this.cache.get(url) || null;
+    }
+    /** 第 i 片（行优先、图像左上起）的采样窗口；瓦片未就绪时返回整张 [0,0,1,1] */
+    inset(entry, i) {
+        if (!entry.w || !entry.h)
+            return new Vector4(0, 0, 1, 1);
+        const [u0, v0, u1, v1] = rtStitchTileInset(i, entry.w, entry.h, IMAGE_TILE_GRID);
+        return new Vector4(u0, v0, u1, v1);
+    }
+    /** 释放本 loader 持有的全部瓦片纹理（项目重置 / 卸载场景时调用；⛔ 不关共享占位纹理） */
+    clear() {
+        this.cache.forEach((e) => e.tex && releasePanoTexture(e.tex));
+        this.cache.clear();
+        this.inflight.clear();
+    }
+}

package/MktMesh/imageTileLoader.ts

@@ -0,0 +1,64 @@
+/*
+ * @Description: 图片平面（「加平面」）的瓦片纹理加载器 —— ⭐ 2026-10-22 晚旨配套：图片平面**不用拼合器 RT**，
+ * 直接把上传切好的 4 张瓦片纹理绑到材质。本类负责「按 url 下载 + 异步解码 + 缓存在本 renderer 上下文」，
+ * 并把第 i 片的采样窗口（inset）算好交出去。
+ *
+ * 设计要点：
+ * - 纹理是 **WebGL 上下文私有**资源：编辑页 / 预览页各持一个实例（各自 GL context），⛔ 不跨 renderer 共享同一 Texture。
+ * - 复用库里 `loadPanoTexture`（fetch + createImageBitmap 工作线程解码、`imageOrientation:"flipY"` 预翻 + flipY=false，
+ *   与全景同一套上下翻约定）；本类只补 `colorSpace = SRGBColorSpace`（硬件采样即解 sRGB→linear，与旧 RT 方案逐字节同口径）。
+ * - inset 用库的 `rtStitchTileInset(i, tw, th, IMAGE_TILE_GRID)`：上传多切 8px、采样只取中间干净块 ⇒ 接缝不回潮，
+ *   与上传切片 `rtStitchTileRects` 共用同一份几何（⛔ 不许在这里另算一份）。
+ * - 逐张就绪、逐张显影：未就绪那张 `get()` 返回 null ⇒ 调方把那片传 null（材质显示灰），下一帧就绪后即亮。
+ */
+import { SRGBColorSpace, Texture, Vector4 } from "three";
+import { loadPanoTexture, releasePanoTexture } from "./panoBitmapTexture";
+import { IMAGE_TILE_GRID, rtStitchTileInset } from "./mktShader";
+
+interface TileEntry {
+    tex: Texture | null;
+    w: number;
+    h: number;
+}
+
+export class ImagePlaneTileLoader {
+    private cache = new Map<string, TileEntry>();
+    private inflight = new Map<string, Promise<void>>();
+
+    /** 触发某张瓦片下载 + 解码（已缓存 / 在途则跳过）；完成后填入 cache，下一帧 feed 即取到 */
+    preload(url: string): void {
+        if (!url || this.cache.has(url) || this.inflight.has(url)) return;
+        const p = loadPanoTexture(url)
+            .then((tex) => {
+                tex.colorSpace = SRGBColorSpace; // 硬件采样解 sRGB→linear（与旧 RT 方案逐字节同口径）
+                const img = tex.image as { width?: number; height?: number } | undefined;
+                this.cache.set(url, { tex, w: img?.width ?? 0, h: img?.height ?? 0 });
+            })
+            .catch(() => {
+                // 下载 / 解码失败：留空，下一帧 preload 重新触发（不把半截纹理绑上去）
+            })
+            .finally(() => {
+                this.inflight.delete(url);
+            });
+        this.inflight.set(url, p);
+    }
+
+    /** 取已就绪的瓦片（未就绪返回 null） */
+    get(url: string): TileEntry | null {
+        return this.cache.get(url) || null;
+    }
+
+    /** 第 i 片（行优先、图像左上起）的采样窗口；瓦片未就绪时返回整张 [0,0,1,1] */
+    inset(entry: TileEntry, i: number): Vector4 {
+        if (!entry.w || !entry.h) return new Vector4(0, 0, 1, 1);
+        const [u0, v0, u1, v1] = rtStitchTileInset(i, entry.w, entry.h, IMAGE_TILE_GRID);
+        return new Vector4(u0, v0, u1, v1);
+    }
+
+    /** 释放本 loader 持有的全部瓦片纹理（项目重置 / 卸载场景时调用；⛔ 不关共享占位纹理） */
+    clear(): void {
+        this.cache.forEach((e) => e.tex && releasePanoTexture(e.tex));
+        this.cache.clear();
+        this.inflight.clear();
+    }
+}

package/MktMesh/mktMappingShader.d.ts

@@ -1,18 +1,19 @@
 import { ShaderMaterial } from "three";
 /**
- * ⭐ 融合材质的全景点数**上限**（皇上旨 10-06「一次能够展示 8 个全景纹理」）：每点占 **2** 张拼合槽纹理
- *   （32 片 8×4 → 左右 2 槽，每槽 4×4 格）⇒ **8 × 2 = 16 个 sampler**，再多样本编译不过。
- *   （sampler 总数 16 是硬件硬顶，本机 `MAX_TEXTURE_IMAGE_UNITS` 实测 16。）
+ * ⭐ 融合材质的全景点数**上限**：每点占 **3** 张拼合槽纹理（皇上旨 2026-10-23「全景的 RT 由原来的 2 个分成 3 个、
+ *   每个 4096×6144、竖直排列 3 个瓦片」⇒ 原图切 3×3=9 片，按**列**分 3 槽）⇒ 点数 × 3 必须 ≤ sampler 硬顶。
+ *   本机 `MAX_TEXTURE_IMAGE_UNITS` 实测 **16**：旧版 8 点 × 2 槽 = 16 正好用满，现每点 3 槽 ⇒ 只能取 ⌊16/3⌋ = **5**
+ *   （5 × 3 = 15）。皇上旨 2026-10-23 在「A」里拍板：保 3 槽不降画质，**同屏全景点数 8 → 5**。
  *
  * ⭐⭐ 2026-10-09 皇上旨「MktMesh 只有映射一种，blend/selected 归编辑器」⇒ 该常量从 `mktShader.ts`
  *   **搬到这里**（映射材质的所在地）。它同时是库与编辑器那份 blend 的**共同上限**，两边必须同值。
  */
-export declare const MKT_PANO_MAX_SLOTS = 8;
+export declare const MKT_PANO_MAX_SLOTS = 5;
 /**
  * 创建「全景序号直取」着色器材质（皇上旨 2026-09-29「三模式三 shader」之二）：
  * 编辑器「映射设置模式」的墙材质 + **基类 MktMesh（发布/预览）的固定墙材质**
  * （皇上旨：mktmesh 就只有按照 attribute 配置来显示全景这一种固定的 shader）。
- * uniform 形状与 blend 工厂同档（panoramas[16]/textureMatrices[8]/weights[8]/uPanoTiled[8]）⇒
+ * uniform 形状与 blend 工厂同档（panoramas[15]/textureMatrices[5]/weights[5]/uPanoTiled[5]）⇒
  * 喂料复用 feedBlendProjection 的槽位指派路（feedFaceMapping），零新喂料路。
  * uFloorCoreRadius/uFloorFadeRange/uFloorOpacity 三根本 shader 不读，但喂料统一入口会写 ⇒ JS 侧留着（静默忽略）。
  */

package/MktMesh/mktMappingShader.js

@@ -8,33 +8,42 @@
 import { BackSide, Matrix4, ShaderMaterial, Vector3 } from "three";
 import { createPlaceholderTexture, floorVertexShader, RT_STITCH_SLOT_COUNT } from "./mktShader";
 /**
- * ⭐ 融合材质的全景点数**上限**（皇上旨 10-06「一次能够展示 8 个全景纹理」）：每点占 **2** 张拼合槽纹理
- *   （32 片 8×4 → 左右 2 槽，每槽 4×4 格）⇒ **8 × 2 = 16 个 sampler**，再多样本编译不过。
- *   （sampler 总数 16 是硬件硬顶，本机 `MAX_TEXTURE_IMAGE_UNITS` 实测 16。）
+ * ⭐ 融合材质的全景点数**上限**：每点占 **3** 张拼合槽纹理（皇上旨 2026-10-23「全景的 RT 由原来的 2 个分成 3 个、
+ *   每个 4096×6144、竖直排列 3 个瓦片」⇒ 原图切 3×3=9 片，按**列**分 3 槽）⇒ 点数 × 3 必须 ≤ sampler 硬顶。
+ *   本机 `MAX_TEXTURE_IMAGE_UNITS` 实测 **16**：旧版 8 点 × 2 槽 = 16 正好用满，现每点 3 槽 ⇒ 只能取 ⌊16/3⌋ = **5**
+ *   （5 × 3 = 15）。皇上旨 2026-10-23 在「A」里拍板：保 3 槽不降画质，**同屏全景点数 8 → 5**。
  *
  * ⭐⭐ 2026-10-09 皇上旨「MktMesh 只有映射一种，blend/selected 归编辑器」⇒ 该常量从 `mktShader.ts`
  *   **搬到这里**（映射材质的所在地）。它同时是库与编辑器那份 blend 的**共同上限**，两边必须同值。
  */
-export const MKT_PANO_MAX_SLOTS = 8;
+export const MKT_PANO_MAX_SLOTS = 5;
 /**
  * 序号直取片元（皇上旨 2026-09-29「三模式三 shader」之二）：
  * 按三角面 aPanoIndex 在 panoIndices 槽里找对应全景纹理 —— **不看距离、不看夹角**（blend 那套打分/归约整段没有）。
- * 槽内采样段（等距柱状投射 + 左右 2 张拼合槽 + 采样即线性、不再手动 pow 解码）与 blend **逐字同口径**；改采样口径两处同改。
+ * 槽内采样段（等距柱状投射 + 左/中/右 3 张拼合槽 + 采样即线性、不再手动 pow 解码）与 blend **逐字同口径**；改采样口径两处同改。
  * 未设序号 / 序号不在槽里 / 该槽瓦片没绑好（weights≤0）→ uFaceMissingColor 深灰兜底
  * （皇上旨 09-28「装不下就深灰」；weights 闸是 09-29 拆分时补的 —— 原运行时分支没这道闸，
  * 槽没绑好但序号命中会采到 vec3(0) 纯黑，深灰才是钦定兜底色）。
  */
 function buildFloorMappingFragment(maxPano) {
-    // 每个全景点占 **2** 张拼合槽纹理（32 片每 16 片拼一张：左半幅 / 右半幅）⇒ 8 × 2 = 16 = sampler 硬顶
+    // 每个全景点占 **3** 张拼合槽纹理（9 片 3×3 按列分：左列 / 中列 / 右列，每槽竖叠 3 片）⇒ 5 × 3 = 15 ≤ sampler 硬顶 16
     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（顺序 [左半幅, 右半幅]）
+        const base = k * RT_STITCH_SLOT_COUNT; // 本点占 3 个连续纹理槽：base=k*3 .. base+2（顺序 [左列, 中列, 右列]）
+        // ⚠️ ANGLE(D3D) 禁止动态索引 sampler 数组 ⇒ 展开成「base + 字面量」常量下标 if 链；末条裸 else 兜住 u==1 边界
+        const slotSamples = [];
+        for (let s = 0; s < RT_STITCH_SLOT_COUNT; s++) {
+            const cond = s === RT_STITCH_SLOT_COUNT - 1
+                ? "else"
+                : `${s === 0 ? "if" : "else if"} (tileIdx == ${s})`;
+            slotSamples.push(`            ${cond} lin${k} = texture2D(panoramas[${base + s}], vec2(panoU, panoV)).rgb;`);
+        }
         slotFacePick += `
         if (panoIndices[${k}] >= 0.0 && weights[${k}] > 0.0 && abs(panoIndices[${k}] - vPanoIndex) < 0.5) faceCol = lin${k};`;
         slotCalc += `
-        // ── 点槽 ${k}（纹理 ${base}..${base + 1}）──
+        // ── 点槽 ${k}（纹理 ${base}..${base + RT_STITCH_SLOT_COUNT - 1}）──
         vec3 lin${k} = vec3(0.0);
         if (weights[${k}] > 0.0) {
             mat4 tm = textureMatrices[${k}];
@@ -47,21 +56,19 @@ function buildFloorMappingFragment(maxPano) {
             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 = 纵向分辨率白丢一半
+            // 三等分经度 -> 拼合槽下标 [左列=0, 中列=1, 右列=2]（每槽 = 3×3 网格里一整列、竖 3 片拼成，见 RT_STITCH_SLOT_TILES）
+            // ⭐ 10-06 晚旨「竖着不再分块」继续成立、10-23 旨把横向从 2 等分改成 3 等分 ⇒ 槽只随 u 走（与 blend / 单全景分支**逐字同口径**）
+            int tileIdx = int(clamp(floor(u * ${RT_STITCH_SLOT_COUNT}.0), 0.0, ${RT_STITCH_SLOT_COUNT - 1}.0));
+            float localU = u * ${RT_STITCH_SLOT_COUNT}.0 - float(tileIdx);
+            // ⛔ 纵向不再减半（槽就是全高）⇒ localV 恒等于 v；写成 nv/nv-1 = 纵向分辨率白丢一档
             float localV = v;
-            // 🧩 该点这 2 槽装的是整图（whole 形态 / 没切过片）⇒ 还原成全图 UV 再采样（与 blend 逐字同口径）
+            // 🧩 该点这 3 槽装的是整图（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;
+${slotSamples.join("\n")}
         }`;
     }
     return /* glsl */ `
@@ -105,13 +112,13 @@ ${slotFacePick}
  * 创建「全景序号直取」着色器材质（皇上旨 2026-09-29「三模式三 shader」之二）：
  * 编辑器「映射设置模式」的墙材质 + **基类 MktMesh（发布/预览）的固定墙材质**
  * （皇上旨：mktmesh 就只有按照 attribute 配置来显示全景这一种固定的 shader）。
- * uniform 形状与 blend 工厂同档（panoramas[16]/textureMatrices[8]/weights[8]/uPanoTiled[8]）⇒
+ * uniform 形状与 blend 工厂同档（panoramas[15]/textureMatrices[5]/weights[5]/uPanoTiled[5]）⇒
  * 喂料复用 feedBlendProjection 的槽位指派路（feedFaceMapping），零新喂料路。
  * uFloorCoreRadius/uFloorFadeRange/uFloorOpacity 三根本 shader 不读，但喂料统一入口会写 ⇒ JS 侧留着（静默忽略）。
  */
 export function createMktFloorMappingShaderMaterial(options = {}) {
     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 tileCount = maxPano * RT_STITCH_SLOT_COUNT; // 5 点 × 左/中/右 3 槽 = 15（sampler 硬顶 16）
     const panoramas = [];
     const matrices = [];
     for (let i = 0; i < tileCount; i++)

package/MktMesh/mktMappingShader.ts

@@ -9,34 +9,45 @@ import { BackSide, Matrix4, ShaderMaterial, Vector3 } from "three";
 import { createPlaceholderTexture, floorVertexShader, RT_STITCH_SLOT_COUNT } from "./mktShader";
 
 /**
- * ⭐ 融合材质的全景点数**上限**（皇上旨 10-06「一次能够展示 8 个全景纹理」）：每点占 **2** 张拼合槽纹理
- *   （32 片 8×4 → 左右 2 槽，每槽 4×4 格）⇒ **8 × 2 = 16 个 sampler**，再多样本编译不过。
- *   （sampler 总数 16 是硬件硬顶，本机 `MAX_TEXTURE_IMAGE_UNITS` 实测 16。）
+ * ⭐ 融合材质的全景点数**上限**：每点占 **3** 张拼合槽纹理（皇上旨 2026-10-23「全景的 RT 由原来的 2 个分成 3 个、
+ *   每个 4096×6144、竖直排列 3 个瓦片」⇒ 原图切 3×3=9 片，按**列**分 3 槽）⇒ 点数 × 3 必须 ≤ sampler 硬顶。
+ *   本机 `MAX_TEXTURE_IMAGE_UNITS` 实测 **16**：旧版 8 点 × 2 槽 = 16 正好用满，现每点 3 槽 ⇒ 只能取 ⌊16/3⌋ = **5**
+ *   （5 × 3 = 15）。皇上旨 2026-10-23 在「A」里拍板：保 3 槽不降画质，**同屏全景点数 8 → 5**。
  *
  * ⭐⭐ 2026-10-09 皇上旨「MktMesh 只有映射一种，blend/selected 归编辑器」⇒ 该常量从 `mktShader.ts`
  *   **搬到这里**（映射材质的所在地）。它同时是库与编辑器那份 blend 的**共同上限**，两边必须同值。
  */
-export const MKT_PANO_MAX_SLOTS = 8;
+export const MKT_PANO_MAX_SLOTS = 5;
 
 /**
  * 序号直取片元（皇上旨 2026-09-29「三模式三 shader」之二）：
  * 按三角面 aPanoIndex 在 panoIndices 槽里找对应全景纹理 —— **不看距离、不看夹角**（blend 那套打分/归约整段没有）。
- * 槽内采样段（等距柱状投射 + 左右 2 张拼合槽 + 采样即线性、不再手动 pow 解码）与 blend **逐字同口径**；改采样口径两处同改。
+ * 槽内采样段（等距柱状投射 + 左/中/右 3 张拼合槽 + 采样即线性、不再手动 pow 解码）与 blend **逐字同口径**；改采样口径两处同改。
  * 未设序号 / 序号不在槽里 / 该槽瓦片没绑好（weights≤0）→ uFaceMissingColor 深灰兜底
  * （皇上旨 09-28「装不下就深灰」；weights 闸是 09-29 拆分时补的 —— 原运行时分支没这道闸，
  * 槽没绑好但序号命中会采到 vec3(0) 纯黑，深灰才是钦定兜底色）。
  */
 function buildFloorMappingFragment(maxPano: number): string {
-    // 每个全景点占 **2** 张拼合槽纹理（32 片每 16 片拼一张：左半幅 / 右半幅）⇒ 8 × 2 = 16 = sampler 硬顶
+    // 每个全景点占 **3** 张拼合槽纹理（9 片 3×3 按列分：左列 / 中列 / 右列，每槽竖叠 3 片）⇒ 5 × 3 = 15 ≤ sampler 硬顶 16
     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（顺序 [左半幅, 右半幅]）
+        const base = k * RT_STITCH_SLOT_COUNT; // 本点占 3 个连续纹理槽：base=k*3 .. base+2（顺序 [左列, 中列, 右列]）
+        // ⚠️ ANGLE(D3D) 禁止动态索引 sampler 数组 ⇒ 展开成「base + 字面量」常量下标 if 链；末条裸 else 兜住 u==1 边界
+        const slotSamples: string[] = [];
+        for (let s = 0; s < RT_STITCH_SLOT_COUNT; s++) {
+            const cond = s === RT_STITCH_SLOT_COUNT - 1
+                ? "else"
+                : `${s === 0 ? "if" : "else if"} (tileIdx == ${s})`;
+            slotSamples.push(
+                `            ${cond} lin${k} = texture2D(panoramas[${base + s}], vec2(panoU, panoV)).rgb;`,
+            );
+        }
         slotFacePick += `
         if (panoIndices[${k}] >= 0.0 && weights[${k}] > 0.0 && abs(panoIndices[${k}] - vPanoIndex) < 0.5) faceCol = lin${k};`;
         slotCalc += `
-        // ── 点槽 ${k}（纹理 ${base}..${base + 1}）──
+        // ── 点槽 ${k}（纹理 ${base}..${base + RT_STITCH_SLOT_COUNT - 1}）──
         vec3 lin${k} = vec3(0.0);
         if (weights[${k}] > 0.0) {
             mat4 tm = textureMatrices[${k}];
@@ -49,21 +60,19 @@ function buildFloorMappingFragment(maxPano: number): string {
             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 = 纵向分辨率白丢一半
+            // 三等分经度 -> 拼合槽下标 [左列=0, 中列=1, 右列=2]（每槽 = 3×3 网格里一整列、竖 3 片拼成，见 RT_STITCH_SLOT_TILES）
+            // ⭐ 10-06 晚旨「竖着不再分块」继续成立、10-23 旨把横向从 2 等分改成 3 等分 ⇒ 槽只随 u 走（与 blend / 单全景分支**逐字同口径**）
+            int tileIdx = int(clamp(floor(u * ${RT_STITCH_SLOT_COUNT}.0), 0.0, ${RT_STITCH_SLOT_COUNT - 1}.0));
+            float localU = u * ${RT_STITCH_SLOT_COUNT}.0 - float(tileIdx);
+            // ⛔ 纵向不再减半（槽就是全高）⇒ localV 恒等于 v；写成 nv/nv-1 = 纵向分辨率白丢一档
             float localV = v;
-            // 🧩 该点这 2 槽装的是整图（whole 形态 / 没切过片）⇒ 还原成全图 UV 再采样（与 blend 逐字同口径）
+            // 🧩 该点这 3 槽装的是整图（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;
+${slotSamples.join("\n")}
         }`;
     }
     return /* glsl */ `
@@ -108,13 +117,13 @@ ${slotFacePick}
  * 创建「全景序号直取」着色器材质（皇上旨 2026-09-29「三模式三 shader」之二）：
  * 编辑器「映射设置模式」的墙材质 + **基类 MktMesh（发布/预览）的固定墙材质**
  * （皇上旨：mktmesh 就只有按照 attribute 配置来显示全景这一种固定的 shader）。
- * uniform 形状与 blend 工厂同档（panoramas[16]/textureMatrices[8]/weights[8]/uPanoTiled[8]）⇒
+ * uniform 形状与 blend 工厂同档（panoramas[15]/textureMatrices[5]/weights[5]/uPanoTiled[5]）⇒
  * 喂料复用 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 tileCount = maxPano * RT_STITCH_SLOT_COUNT; // 5 点 × 左/中/右 3 槽 = 15（sampler 硬顶 16）
     const panoramas: import("three").Texture[] = [];
     const matrices: Matrix4[] = [];
     for (let i = 0; i < tileCount; i++) panoramas.push(createPlaceholderTexture());