three-base 2.0.169 → 2.0.175

package/MktMesh/MktMesh.ts

@@ -130,8 +130,9 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
      *    ⇒ 与编辑态 `mktMeshEditRenderer._slotPanos` **同一份算法、同一个常数**（预览看到的那几张 = 编辑器里的那几张，均为 8 个全景槽）。
      *    存**对象引用**不存下标（删点会让下标整体前移，引用不会认错人）。
      *    消费方 = `feedFaceMapping`（墙 8 格）；⭐ 10-03 旨② 后预览立方体与墙**共用同一份材质**，
-     *    立方体几何无 `aPanoIndex` ⇒ `vPanoIndex ≡ 0` ⇒ 它显示的就是 0 号槽那张（墙与立方体天然同源，
-     *    原来那条「把中心那几张抄给立方体单全景材质」的 `currentTiles` 旁路已整条删除）。
+     *    ⭐ 10-12 旨后立方体**逐颗自带序号**（`InstancedChild.panoIndex` → 逐实例 `aPanoIndex`），
+     *    不再是从前那句「几何没这条 attribute ⇒ `vPanoIndex ≡ 0` ⇒ 全体看 0 号槽那张」；
+     *    原来那条「把中心那几张抄给立方体单全景材质」的 `currentTiles` 旁路已整条删除。
      */
     private _slotPanos: (MktTextureInfo | undefined)[] = [];
     /**
@@ -141,9 +142,13 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
      *  · 只读 XZ ⇒ 与名册历代那把「水平距离」尺同一把（09-28 旨），高度差不进尺子。
      *  · `null` ⇒ 回落 `camera.position`（老口径）：发布页那一路没有控制器引用，不注入就一切照旧。
      *  · 存的是**引用**（OrbitControls 原地改它那个 Vector3）⇒ 消费方设一次即可，不必每帧重设。
-     *  · ⚠️ 全景点矩阵本就是**世界矩阵**，锚点也取世界坐标；⛔ 别再乘一遍 `matrixWorld`（同 `updateTexture` 里那句提醒）。
+     *  · 注入的是**世界坐标**；`updateTexture` 里先 `worldToLocal` 换算到本网格局部空间再比距离
+     *    （全景矩阵与着色器取图的 `vProjPos` 都在局部空间，见那里的 2026-10-11 丙旨说明）。
+     *    ⛔ 反过来去给全景矩阵乘 `matrixWorld` 是错的：那会让 JS 侧的尺子和 shader 里的取图各走一路。
      */
     private _rosterCenter: Vector3 | null = null;
+    /** 锚点换算到局部空间的落点（每帧复用同一只临时量，避免分配） */
+    private _rosterAnchorLocal: Vector3 = new Vector3();
     /**
      * ⭐ 皇上旨 2026-10-03「整套搬进库（彻底同源）」：库侧不再自养「按全景序号取整槽、齐活才写」那一路，
      *    改成与编辑态**同一份换绑策略**（`./panoSlotBind`）+ 同一口径的三张表：
@@ -716,15 +721,21 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
             this.activeIndex = -1;
             return;
         }
-        const ref = this._rosterCenter ?? camera.position;
+        // ⭐ 皇上旨 2026-10-11 丙：尺子的两端必须落在**同一个空间**。注入的锚点是世界坐标，而下面那把尺子量的
+        //    全景位置记在本网格的**局部（制图）空间** —— 依据是着色器自己：`vProjPos = uProjInvMatrix·modelMatrix·pos`
+        //    = M⁻¹·M·pos = 局部（`uProjInvMatrix` 正是 `syncProjInvMatrix` 里那句 `matrixWorld` 求逆），片元再拿
+        //    `dir = vProjPos - tm[3].xyz` 取图 ⇒ 全景矩阵只可能和 `vProjPos` 同空间，即局部。
+        //    所以换算放在**锚点这一端**（`worldToLocal`），⛔ 不去给全景矩阵乘 `matrixWorld`：那是把 JS 的尺子
+        //    和 shader 的取图拆成两路。网格无变换时这一步是恒等 ⇒ 老项目逐字不变；有旋转时（消费方给 mkt 加了
+        //    `rotation.y`）原来会把「往世界的某一头走」量成「往局部的另一头走」，人走到位了名册还不动。
+        const ref = this._rosterAnchorLocal.copy(this._rosterCenter ?? camera.position);
+        this.worldToLocal(ref);
         const dists: { t: MktTextureInfo; d: number }[] = [];
         for (let i = 0; i < n; i++) {
             const e = this.textures[i].matrix.elements;
             this._tmpV3.set(e[12], e[13], e[14]);
-            // ⚠️ 全景点矩阵**本身就是世界矩阵**（见上方 textures 字段注释），位置已在世界空间，
-            //    可直接与锚点的世界坐标比距离 —— 这里**绝不能再乘 matrixWorld**：那是双重变换，
-            //    MktMesh 一有整体变换就会算错「离锚点最近的是哪张」（选错全景）。
-            //    （2026-09-19 曾误以为它记在模型空间而多乘了一次，趁 MktDevMesh 对齐时一并纠正。）
+            // ⚠️ 全景点矩阵记在本网格的局部空间（与 `wallPoints` 同一空间，见上面丙旨那段着色器推导），
+            //    所以拿来直接和**已换算到局部**的 `ref` 比距离；⛔ 这里绝不乘 `matrixWorld`（双重变换 = 选错全景）。
             // ⭐ 09-28 09:33 旨：挑图与编辑器取图同一把「**水平距离**」尺（XZ 平面，不含高度差）。
             // const d = this._tmpV3.distanceTo(camera.position);   // 旧原理：三维直线距离——全景点同高（y 恒 1.6）时与本式排序等价，注释保留备查
             // ⭐ 10-07 第二十一道旨：尺子的另一端从相机位置换成 `ref`（控制器中心点；未注入时它就是相机位置）。
@@ -823,6 +834,9 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
      *  ⭐ `rt:` 虚拟键（32 瓦片拼合槽）走拼合器 peek；⛔ 不在这里 pump（每帧驱动点唯一，见 `updateTexture`，
      *    否则一帧画好几格 = 把「每帧只载入一张新纹理」那道闸从后门拆了）。 */
     private _peekTileAt(key: string, original: boolean): Texture | null {
+        // ⭐ 2026-10-25：空地址 = 「这个点还没设图片」，不是一条能加载的 URL ⇒ 直接判没有。
+        //    放过去会让 ensureTileTexture 拿空串请求当前文档地址、失败后每帧重试。
+        if (!key) return null;
         if (isRtStitchKey(key)) {
             const p = rtStitchKeyParts(key);
             if (!p) return null;
@@ -859,6 +873,8 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
      *  ⚠️ 皇上旨 2026-09-28「加载瓦片的时候, 瓦片纹理不需要添加 oss 的参数」⇒ 真瓦片（`original=true`，现行 32 片/全景）走原图，
      *     整图档才按 ossSize 档缩（`resolveOssUrl`）。 */
     private ensureTileTexture(key: string, original = false): Texture | null {
+        // ⭐ 2026-10-25：空地址直接判「没有」，不起载（与编辑态 ensureFloorTexture 同一道闸）。
+        if (!key) return null;
         const cached = this._texCache.get(key);
         if (cached) return cached;
         if (cached === null) return null; // 加载中
@@ -905,8 +921,9 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
             // `_glRenderer` 还没被 `onBeforeRender` 捕获到（构造后尚未渲染过一帧）⇒ 跳过预上传，
             // 交给 three 在绑定那一帧自己上传 —— 那是改造前的老路径，不会报错，只是那一张没享受「错峰」。
             if (this._glRenderer) this._glRenderer.initTexture(tex);
-        } catch (e) {
-            console.warn("[MktMesh] 瓦片预上传失败，交给常规渲染路径自行上传：", e);
+        } catch {
+            // 皇上旨 2026-10-12「日志都去掉」⇒ 这里不再出声；降级路径本身不变（下面照记「已处理」，
+            // 最坏退回 three 在绑定那一帧自己上传的老路径）。
         }
         // ⚠️ 成败都记「已处理」。不记 ⇒ 这张永远进不了 `_texUploaded` ⇒ 那一格永远换不上新图，
         //    比「卡一下」严重得多；记了最坏也只是退回 three 在绑定那一帧自己上传的老路径。
@@ -949,6 +966,17 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
                 continue;
             }
             idxU[s] = this.textures.indexOf(info);
+            // ⭐ 2026-10-25 皇上旨「把默认图去掉，图片没有加载的时候就显示纯灰色」：
+            //    这个点**没设图片**（url 空且没有切片）⇒ 按空槽喂料，权重 0 ⇒ 片元回落 uFaceMissingColor 中性灰。
+            //    ⛔ 别把空地址放下去：空 key 会走到 `_peekTileAt` → `ensureTileTexture("")` 发一次空请求
+            //    （解析成当前文档地址），失败后下一帧再试 = 每帧一个废请求。序号照留（归属还在，只是没图）。
+            const hasSource = !!info.url || !!(info.tiles && info.tiles.length > 0);
+            if (!hasSource) {
+                for (let k = 0; k < RT_STITCH_SLOT_COUNT; k++) panos[base + k] = this._placeholder;
+                mats[s].identity();
+                ws[s] = 0;
+                continue;
+            }
             // 各槽喂什么地址 = 「用户选的形态 + 该点有没有切过片」共同决定（whole 或无 tiles ⇒ 各槽同为一张整图）
             const tiles = mktPanoTexUrls(info.url, info.tiles, this._panoTexMode);
             // ⚠️ 「是不是真瓦片」只算一次：喂地址（走不走 OSS 尺寸档）与写 uPanoTiled 共用同一个值
@@ -1065,12 +1093,10 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
         // setWallPoints 已按位置重算过映射（旧为空 → 全 -1），此处用存档里的逐面指派覆盖。
         // 几何拓扑由同一份 wallPoints 重建，面索引与导出时一致 ⇒ 逐面写入即可对齐。
         // ⭐ 皇上旨 2026-10-03「补」：长度不符**不再整份丢弃**——按较小长度逐面灌回（存档多出的面丢掉，
-        //   墙变长多出来的那些面保持 setWallPoints 按位置继承到的值），并把两个数 warn 出来（不静默吞）。
+        //   墙变长多出来的那些面保持 setWallPoints 按位置继承到的值）。
+        //   2026-10-12 旨「日志都去掉」⇒ 这一条不再 warn，差值只按较小者静默还原。
         const imported = (data.panoFaceMapping && data.panoFaceMapping.length ? data.panoFaceMapping : []) as number[];
         const faceCount = this.panoFaceMapping.length;
-        if (imported.length && imported.length !== faceCount) {
-            console.warn(`[MktMesh] 存档序号映射面数 ${imported.length} ≠ 当前墙体面数 ${faceCount}，按较小者逐面还原（差值来自墙点/墙高变化）`);
-        }
         const restore = Math.min(imported.length, faceCount);
         if (restore > 0) {
             for (let f = 0; f < restore; f++) this.panoFaceMapping[f] = imported[f];

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());