s3m-three 0.4.18 → 0.4.20

package/dist/render/viewer/HeightIndex.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 世界高度范围的增量维护。
+ *
+ * 原来每注册一块瓦片都要把所有网格重新遍历一遍、每个都 clone 一个 Box3 再乘矩阵，
+ * 加载 n 块瓦片就是 O(n²) 次矩阵乘 + n² 个垃圾对象。现在只在网格进出的记一次，
+ * 全局值从缓存里滚：只有被移除的那块正好卡在边界上时，才回退到一次 O(n) 重算。
+ *
+ * 结果写进共享 uniform `uHeightMin` / `uHeightMax`，供着色器做高度渐变 / 拔高。
+ */
+import * as THREE from 'three';
+import type { StyleUniforms } from '../../core/types.js';
+export declare class HeightIndex {
+    private readonly uniforms;
+    /** 每块网格的世界高度范围 */
+    private readonly _meshHeight;
+    private _min;
+    private _max;
+    /** 换算世界包围盒用的临时对象，避免每次 new */
+    private readonly _box;
+    constructor(uniforms: StyleUniforms);
+    get size(): number;
+    add(mesh: THREE.Mesh): void;
+    remove(mesh: THREE.Mesh): void;
+    /** 数据集整体位移（换高程偏移 / 重新布局）后，缓存的世界高度全部失效 */
+    refreshAll(): void;
+    /** 场景清空时重置 */
+    clear(): void;
+    /** 当前高度范围（未初始化时是 Infinity / -Infinity，调用方自己兜底） */
+    get range(): {
+        min: number;
+        max: number;
+    };
+    private _recompute;
+    private _push;
+}
+//# sourceMappingURL=HeightIndex.d.ts.map

package/dist/render/viewer/HeightIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeightIndex.d.ts","sourceRoot":"","sources":["../../../src/render/viewer/HeightIndex.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,qBAAa,WAAW;IAQV,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAPrC,kBAAkB;IAClB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuD;IACnF,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,IAAI,CAAa;IACzB,6BAA6B;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;gBAEZ,QAAQ,EAAE,aAAa;IAEpD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,GAAG,IAAI;IAa3B,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,GAAG,IAAI;IAS9B,yCAAyC;IACzC,UAAU,IAAI,IAAI;IAUlB,cAAc;IACd,KAAK,IAAI,IAAI;IAMb,kDAAkD;IAClD,IAAI,KAAK,IAAI;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAExC;IAED,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,KAAK;CAUd"}

package/dist/render/viewer/HeightIndex.js

@@ -0,0 +1,98 @@
+/**
+ * 世界高度范围的增量维护。
+ *
+ * 原来每注册一块瓦片都要把所有网格重新遍历一遍、每个都 clone 一个 Box3 再乘矩阵，
+ * 加载 n 块瓦片就是 O(n²) 次矩阵乘 + n² 个垃圾对象。现在只在网格进出的记一次，
+ * 全局值从缓存里滚：只有被移除的那块正好卡在边界上时，才回退到一次 O(n) 重算。
+ *
+ * 结果写进共享 uniform `uHeightMin` / `uHeightMax`，供着色器做高度渐变 / 拔高。
+ */
+import * as THREE from 'three';
+export class HeightIndex {
+    uniforms;
+    /** 每块网格的世界高度范围 */
+    _meshHeight = new Map();
+    _min = Infinity;
+    _max = -Infinity;
+    /** 换算世界包围盒用的临时对象，避免每次 new */
+    _box = new THREE.Box3();
+    constructor(uniforms) {
+        this.uniforms = uniforms;
+    }
+    get size() {
+        return this._meshHeight.size;
+    }
+    add(mesh) {
+        const bb = mesh.geometry?.boundingBox;
+        if (!bb)
+            return;
+        this._box.copy(bb).applyMatrix4(mesh.matrixWorld);
+        const min = this._box.min.z;
+        const max = this._box.max.z;
+        if (!Number.isFinite(min) || !Number.isFinite(max))
+            return;
+        this._meshHeight.set(mesh, { min, max });
+        if (min < this._min)
+            this._min = min;
+        if (max > this._max)
+            this._max = max;
+        this._push();
+    }
+    remove(mesh) {
+        const rec = this._meshHeight.get(mesh);
+        if (!rec)
+            return;
+        this._meshHeight.delete(mesh);
+        // 只有正好卡在边界上才需要重算，否则滚动的 min/max 依然成立
+        if (rec.min === this._min || rec.max === this._max)
+            this._recompute();
+        else
+            this._push();
+    }
+    /** 数据集整体位移（换高程偏移 / 重新布局）后，缓存的世界高度全部失效 */
+    refreshAll() {
+        if (this._meshHeight.size === 0)
+            return;
+        const meshes = [...this._meshHeight.keys()];
+        this._meshHeight.clear();
+        this._min = Infinity;
+        this._max = -Infinity;
+        for (const mesh of meshes)
+            this.add(mesh);
+        this._push();
+    }
+    /** 场景清空时重置 */
+    clear() {
+        this._meshHeight.clear();
+        this._min = Infinity;
+        this._max = -Infinity;
+    }
+    /** 当前高度范围（未初始化时是 Infinity / -Infinity，调用方自己兜底） */
+    get range() {
+        return { min: this._min, max: this._max };
+    }
+    _recompute() {
+        let min = Infinity;
+        let max = -Infinity;
+        for (const h of this._meshHeight.values()) {
+            if (h.min < min)
+                min = h.min;
+            if (h.max > max)
+                max = h.max;
+        }
+        this._min = min;
+        this._max = max;
+        this._push();
+    }
+    _push() {
+        let min = this._min;
+        let max = this._max;
+        if (!Number.isFinite(min) || !Number.isFinite(max) || max <= min) {
+            min = 0;
+            max = 100;
+        }
+        this.uniforms.uHeightMin.value = min;
+        this.uniforms.uHeightMax.value = max;
+    }
+}
+//# sourceMappingURL=HeightIndex.js.map

package/dist/render/viewer/HeightIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeightIndex.js","sourceRoot":"","sources":["../../../src/render/viewer/HeightIndex.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,MAAM,OAAO,WAAW;IAQO;IAP7B,kBAAkB;IACD,WAAW,GAAG,IAAI,GAAG,EAA4C,CAAC;IAC3E,IAAI,GAAG,QAAQ,CAAC;IAChB,IAAI,GAAG,CAAC,QAAQ,CAAC;IACzB,6BAA6B;IACZ,IAAI,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;IAEzC,YAA6B,QAAuB;QAAvB,aAAQ,GAAR,QAAQ,CAAe;IAAG,CAAC;IAExD,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,IAAgB;QAClB,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC;QACtC,IAAI,CAAC,EAAE;YAAE,OAAO;QAChB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO;QAC3D,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QACzC,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QACrC,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED,MAAM,CAAC,IAAgB;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,oCAAoC;QACpC,IAAI,GAAG,CAAC,GAAG,KAAK,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,GAAG,KAAK,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,UAAU,EAAE,CAAC;;YACjE,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED,yCAAyC;IACzC,UAAU;QACR,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QACxC,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC;QACtB,KAAK,MAAM,IAAI,IAAI,MAAM;YAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED,cAAc;IACd,KAAK;QACH,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC;IACxB,CAAC;IAED,kDAAkD;IAClD,IAAI,KAAK;QACP,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IAEO,UAAU;QAChB,IAAI,GAAG,GAAG,QAAQ,CAAC;QACnB,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC;QACpB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,IAAI,CAAC,CAAC,GAAG,GAAG,GAAG;gBAAE,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;YAC7B,IAAI,CAAC,CAAC,GAAG,GAAG,GAAG;gBAAE,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAEO,KAAK;QACX,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC;QACpB,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC;QACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;YACjE,GAAG,GAAG,CAAC,CAAC;YACR,GAAG,GAAG,GAAG,CAAC;QACZ,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,GAAG,GAAG,CAAC;QACrC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,GAAG,GAAG,CAAC;IACvC,CAAC;CACF"}

package/dist/render/viewer/LightRig.d.ts

@@ -0,0 +1,88 @@
+/**
+ * 光照与色调映射：四个光源 + 光照预设 + 环境贴图。
+ *
+ * 从 `S3MViewer` 里整体搬出来的第一块 —— 它只依赖 `scene` / `renderer` / 共享
+ * uniform / 宿主方位角，不碰几何、瓦片、拾取，是耦合最低的一块。
+ *
+ * ## 两个模块级全局态
+ *
+ * `setColorPipeline` / `setSrgbTextureDecode` / `setAnisotropyCap` 都是模块级设置，
+ * 影响**之后创建**的材质与纹理。所以切预设时已加载的瓦片要重载才换观感，
+ * 这是已知的架构债（一个页面两个 viewer 用不同预设会互相污染），
+ * 拆分没有改变这一点。
+ */
+import * as THREE from 'three';
+import { type LightingPreset } from '../lightingPreset.js';
+import type { LightOptions, S3MViewerOptions } from '../S3MViewer.js';
+import type { StyleUniforms } from '../../core/types.js';
+/**
+ * 宿主侧依赖。全部用取值函数而不是对象引用 —— 宿主可能在 mount 之前构造 viewer，
+ * 而 `scene` / `renderer` 在 mount 时才存在，存快照会拿到 null。
+ */
+export interface LightRigContext {
+    scene: () => THREE.Scene | null;
+    renderer: () => THREE.WebGLRenderer | null;
+    uniforms: StyleUniforms;
+    options: S3MViewerOptions;
+    /** 地图方位角（度），让主光跟着视角走；纯 three 宿主可以不传 */
+    getBearing?: () => number | undefined;
+    /** 宿主需要重画的信号 */
+    repaint: () => void;
+}
+export declare class LightRig {
+    private readonly ctx;
+    ambient: THREE.AmbientLight | null;
+    hemi: THREE.HemisphereLight | null;
+    key: THREE.DirectionalLight | null;
+    fill: THREE.DirectionalLight | null;
+    private readonly _state;
+    /** 环境贴图的 PMREM 渲染目标（setEnvironment 建的，dispose 时释放） */
+    private _envRT;
+    /** @internal 环境贴图 RT，供单测观察「有没有释放旧的」 */
+    get envRT(): THREE.WebGLRenderTarget | null;
+    set envRT(v: THREE.WebGLRenderTarget | null);
+    constructor(ctx: LightRigContext);
+    private _create;
+    /** 把四个光源挂进场景；重复调用是幂等的 */
+    addToScene(): void;
+    /** 光源实例是否已建（构造后、mount 前是 false） */
+    get created(): boolean;
+    private _applyOptions;
+    /**
+     * 更新光照位置与方向：
+     * - `'headlamp'`：随地图方位角 bearing 旋转，主光始终在镜头上方，受光面面向镜头；
+     * - `'fixed'`：固定世界方位角（如模拟恒定日光）。
+     */
+    update(): void;
+    /**
+     * supermap 完整版 = 光照强度 + 颜色管线一起切：
+     * direct 管线下纹理不做 sRGB 解码、片元按官方常数 Lambert 直乘（见 lightingPreset.ts）。
+     * 两个都是模块级全局态，只影响之后创建的材质 / 纹理 —— 已加载瓦片要重载才换。
+     */
+    applyColorPipeline(preset: LightingPreset): void;
+    setLightingPreset(preset: LightingPreset): void;
+    setLight(options: Partial<LightOptions>): void;
+    getLight(): LightOptions;
+    setToneMapping(toneMapping: THREE.ToneMapping, exposure?: number): void;
+    getToneMapping(): {
+        toneMapping: THREE.ToneMapping;
+        toneMappingExposure: number;
+    };
+    /**
+     * 挂 / 摘环境贴图。
+     *
+     * 金属度（`setStyle({ metalness })`）**必须**有环境图才看得出质感：
+     * PBR 的金属几乎没有漫反射，画面全靠 `scene.environment` 里的环境反射，
+     * 没有它时 metalness 一高就整片发黑，只剩两盏平行灯打成的小高光点。
+     *
+     * @param source 等距柱状图（.hdr / .jpg / .png，2:1）地址，或已加载的 `THREE.Texture`；
+     *               `null` = 关掉环境图
+     * @param intensity 环境光强度（`scene.environmentIntensity`，默认 1）
+     *
+     * 传入 URL 时纹理由内部加载并转成 PMREM（预滤波 mipmap）；传 Texture 时不会接管它的生命周期。
+     */
+    setEnvironment(source: string | THREE.Texture | null, intensity?: number): Promise<void>;
+    /** 释放环境贴图与光源（unmount 时调） */
+    dispose(): void;
+}
+//# sourceMappingURL=LightRig.d.ts.map

package/dist/render/viewer/LightRig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LightRig.d.ts","sourceRoot":"","sources":["../../../src/render/viewer/LightRig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGlF,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAoBzD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;IAChC,QAAQ,EAAE,MAAM,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC;IAC3C,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACtC,gBAAgB;IAChB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,qBAAa,QAAQ;IAkBP,OAAO,CAAC,QAAQ,CAAC,GAAG;IAjBhC,OAAO,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,CAAQ;IAC1C,IAAI,EAAE,KAAK,CAAC,eAAe,GAAG,IAAI,CAAQ;IAC1C,GAAG,EAAE,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAQ;IAC1C,IAAI,EAAE,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAQ;IAE3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,sDAAsD;IACtD,OAAO,CAAC,MAAM,CAAwC;IAEtD,uCAAuC;IACvC,IAAI,KAAK,IAAI,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAE1C;IACD,IAAI,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,iBAAiB,GAAG,IAAI,EAE1C;gBAE4B,GAAG,EAAE,eAAe;IAYjD,OAAO,CAAC,OAAO;IAYf,yBAAyB;IACzB,UAAU,IAAI,IAAI;IAOlB,mCAAmC;IACnC,IAAI,OAAO,IAAI,OAAO,CAErB;IAID,OAAO,CAAC,aAAa;IAqBrB;;;;OAIG;IACH,MAAM,IAAI,IAAI;IAkBd;;;;OAIG;IACH,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAShD,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAS/C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAc9C,QAAQ,IAAI,YAAY;IAIxB,cAAc,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,QAAQ,SAAM,GAAG,IAAI;IAWpE,cAAc,IAAI;QAAE,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAA;KAAE;IAUjF;;;;;;;;;;;;OAYG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,GAAG,IAAI,EAAE,SAAS,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCzF,4BAA4B;IAC5B,OAAO,IAAI,IAAI;CAIhB"}

package/dist/render/viewer/LightRig.js

@@ -0,0 +1,229 @@
+/**
+ * 光照与色调映射：四个光源 + 光照预设 + 环境贴图。
+ *
+ * 从 `S3MViewer` 里整体搬出来的第一块 —— 它只依赖 `scene` / `renderer` / 共享
+ * uniform / 宿主方位角，不碰几何、瓦片、拾取，是耦合最低的一块。
+ *
+ * ## 两个模块级全局态
+ *
+ * `setColorPipeline` / `setSrgbTextureDecode` / `setAnisotropyCap` 都是模块级设置，
+ * 影响**之后创建**的材质与纹理。所以切预设时已加载的瓦片要重载才换观感，
+ * 这是已知的架构债（一个页面两个 viewer 用不同预设会互相污染），
+ * 拆分没有改变这一点。
+ */
+import * as THREE from 'three';
+import { resolveLightingPreset } from '../lightingPreset.js';
+import { setColorPipeline } from '../StyleMaterial.js';
+import { setAnisotropyCap, setSrgbTextureDecode } from '../TextureFactory.js';
+const DEFAULT_LIGHT = {
+    ambientIntensity: 0.4,
+    ambientColor: 0xffffff,
+    hemisphereIntensity: 0.8,
+    hemisphereColor: 0xffffff,
+    hemisphereGroundColor: 0xb6c0cb,
+    keyLightIntensity: 1.0,
+    keyLightColor: 0xffffff,
+    fillLightIntensity: 0.35,
+    fillLightColor: 0xffffff,
+    mode: 'headlamp',
+    azimuth: 150,
+    altitude: 50,
+};
+export class LightRig {
+    ctx;
+    ambient = null;
+    hemi = null;
+    key = null;
+    fill = null;
+    _state;
+    /** 环境贴图的 PMREM 渲染目标（setEnvironment 建的，dispose 时释放） */
+    _envRT = null;
+    /** @internal 环境贴图 RT，供单测观察「有没有释放旧的」 */
+    get envRT() {
+        return this._envRT;
+    }
+    set envRT(v) {
+        this._envRT = v;
+    }
+    constructor(ctx) {
+        this.ctx = ctx;
+        this._state = { ...DEFAULT_LIGHT };
+        const options = ctx.options;
+        if (options.lightingPreset && options.lightingPreset !== 'default') {
+            Object.assign(this._state, resolveLightingPreset(options.lightingPreset));
+            this.applyColorPipeline(options.lightingPreset);
+        }
+        if (options.light)
+            Object.assign(this._state, options.light);
+    }
+    /* ---------------------------------------------------------------- 场景挂载 */
+    _create() {
+        this.ambient = new THREE.AmbientLight(this._state.ambientColor, this._state.ambientIntensity);
+        this.hemi = new THREE.HemisphereLight(this._state.hemisphereColor, this._state.hemisphereGroundColor, this._state.hemisphereIntensity);
+        this.key = new THREE.DirectionalLight(this._state.keyLightColor, this._state.keyLightIntensity);
+        this.fill = new THREE.DirectionalLight(this._state.fillLightColor, this._state.fillLightIntensity);
+        this.update();
+    }
+    /** 把四个光源挂进场景；重复调用是幂等的 */
+    addToScene() {
+        const scene = this.ctx.scene();
+        if (!scene)
+            return;
+        if (!this.ambient)
+            this._create();
+        scene.add(this.ambient, this.hemi, this.key, this.fill);
+    }
+    /** 光源实例是否已建（构造后、mount 前是 false） */
+    get created() {
+        return this.ambient !== null;
+    }
+    /* ---------------------------------------------------------------- 参数 */
+    _applyOptions() {
+        const s = this._state;
+        if (this.ambient) {
+            this.ambient.intensity = s.ambientIntensity;
+            this.ambient.color.set(s.ambientColor);
+        }
+        if (this.hemi) {
+            this.hemi.intensity = s.hemisphereIntensity;
+            this.hemi.color.set(s.hemisphereColor);
+            this.hemi.groundColor.set(s.hemisphereGroundColor);
+        }
+        if (this.key) {
+            this.key.intensity = s.keyLightIntensity;
+            this.key.color.set(s.keyLightColor);
+        }
+        if (this.fill) {
+            this.fill.intensity = s.fillLightIntensity;
+            this.fill.color.set(s.fillLightColor);
+        }
+    }
+    /**
+     * 更新光照位置与方向：
+     * - `'headlamp'`：随地图方位角 bearing 旋转，主光始终在镜头上方，受光面面向镜头；
+     * - `'fixed'`：固定世界方位角（如模拟恒定日光）。
+     */
+    update() {
+        if (!this.key || !this.fill)
+            return;
+        const s = this._state;
+        const bearing = s.mode === 'fixed' ? 0 : ((this.ctx.getBearing?.() ?? 0) * Math.PI) / 180;
+        const place = (light, azOffsetDeg, elevDeg) => {
+            if (!light)
+                return;
+            const az = bearing + (azOffsetDeg * Math.PI) / 180;
+            const el = (elevDeg * Math.PI) / 180;
+            const c = Math.cos(el);
+            light.position.set(Math.sin(az) * c, Math.cos(az) * c, Math.sin(el)).multiplyScalar(1000);
+        };
+        place(this.key, s.azimuth, s.altitude);
+        place(this.fill, s.azimuth + 65, Math.max(10, s.altitude - 20));
+        // direct 管线的官方 Lambert 用主光方向（共享 uniform，所有材质同步生效）
+        const sun = this.ctx.uniforms?.uSunDirection;
+        if (sun)
+            sun.value.copy(this.key.position).normalize();
+    }
+    /**
+     * supermap 完整版 = 光照强度 + 颜色管线一起切：
+     * direct 管线下纹理不做 sRGB 解码、片元按官方常数 Lambert 直乘（见 lightingPreset.ts）。
+     * 两个都是模块级全局态，只影响之后创建的材质 / 纹理 —— 已加载瓦片要重载才换。
+     */
+    applyColorPipeline(preset) {
+        const direct = preset === 'supermap';
+        setColorPipeline(direct ? 'direct' : 'linear');
+        setSrgbTextureDecode(!direct);
+        // 官方不开各向异性：远处直接采高 mip 平均成纯色（"灰色滤镜"的一部分）。
+        // 我们默认 Infinity（倾斜摄影立面清晰度优先），supermap 模式必须收回。
+        setAnisotropyCap(direct ? 1 : Infinity);
+    }
+    setLightingPreset(preset) {
+        Object.assign(this._state, resolveLightingPreset(preset));
+        this.applyColorPipeline(preset);
+        this.ctx.options.lightingPreset = preset;
+        this._applyOptions();
+        this.update();
+        this.ctx.repaint();
+    }
+    setLight(options) {
+        const normalized = { ...options };
+        if (normalized.mainColor !== undefined && normalized.keyLightColor === undefined) {
+            normalized.keyLightColor = normalized.mainColor;
+        }
+        if (normalized.mainIntensity !== undefined && normalized.keyLightIntensity === undefined) {
+            normalized.keyLightIntensity = normalized.mainIntensity;
+        }
+        Object.assign(this._state, normalized);
+        this._applyOptions();
+        this.update();
+        this.ctx.repaint();
+    }
+    getLight() {
+        return { ...this._state };
+    }
+    setToneMapping(toneMapping, exposure = 1.0) {
+        this.ctx.options.toneMapping = toneMapping;
+        this.ctx.options.toneMappingExposure = exposure;
+        const r = this.ctx.renderer();
+        if (r) {
+            r.toneMapping = toneMapping;
+            r.toneMappingExposure = exposure;
+            this.ctx.repaint();
+        }
+    }
+    getToneMapping() {
+        const r = this.ctx.renderer();
+        return {
+            toneMapping: r ? r.toneMapping : (this.ctx.options.toneMapping ?? THREE.NoToneMapping),
+            toneMappingExposure: r ? r.toneMappingExposure : (this.ctx.options.toneMappingExposure ?? 1.0),
+        };
+    }
+    /* ---------------------------------------------------------------- 环境贴图 */
+    /**
+     * 挂 / 摘环境贴图。
+     *
+     * 金属度（`setStyle({ metalness })`）**必须**有环境图才看得出质感：
+     * PBR 的金属几乎没有漫反射，画面全靠 `scene.environment` 里的环境反射，
+     * 没有它时 metalness 一高就整片发黑，只剩两盏平行灯打成的小高光点。
+     *
+     * @param source 等距柱状图（.hdr / .jpg / .png，2:1）地址，或已加载的 `THREE.Texture`；
+     *               `null` = 关掉环境图
+     * @param intensity 环境光强度（`scene.environmentIntensity`，默认 1）
+     *
+     * 传入 URL 时纹理由内部加载并转成 PMREM（预滤波 mipmap）；传 Texture 时不会接管它的生命周期。
+     */
+    async setEnvironment(source, intensity = 1) {
+        const renderer = this.ctx.renderer();
+        const scene = this.ctx.scene();
+        if (!renderer || !scene)
+            return;
+        scene.environmentIntensity = Math.max(0, intensity);
+        if (source == null) {
+            scene.environment = null;
+            this._envRT?.dispose();
+            this._envRT = null;
+            this.ctx.repaint();
+            return;
+        }
+        const fromUrl = typeof source === 'string';
+        const tex = fromUrl ? await new THREE.TextureLoader().loadAsync(source) : source;
+        // PMREM 只认等距柱状图；普通贴图也按 2:1 全景处理
+        tex.mapping = THREE.EquirectangularReflectionMapping;
+        const pmrem = new THREE.PMREMGenerator(renderer);
+        pmrem.compileEquirectangularShader();
+        const rt = pmrem.fromEquirectangular(tex);
+        pmrem.dispose();
+        if (fromUrl)
+            tex.dispose();
+        scene.environment = rt.texture;
+        // 上一张（同一个 viewer 反复换）要释放，否则显存里会一直堆
+        this._envRT?.dispose();
+        this._envRT = rt;
+        this.ctx.repaint();
+    }
+    /** 释放环境贴图与光源（unmount 时调） */
+    dispose() {
+        this._envRT?.dispose();
+        this._envRT = null;
+    }
+}
+//# sourceMappingURL=LightRig.js.map

package/dist/render/viewer/LightRig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LightRig.js","sourceRoot":"","sources":["../../../src/render/viewer/LightRig.ts"],"names":[],"mappings":"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"}

package/dist/render/viewer/PickService.d.ts

@@ -0,0 +1,109 @@
+/**
+ * 拾取：屏幕坐标 → 射线 → 命中单体 / 位置 / 包围盒。
+ *
+ * 从 `S3MViewer` 整体搬出来的第二大块。它持有**拾取表**（`pickables`）与
+ * 2 字节 pickId 池 —— 这两样本来就是一件事：瓦片注册时分配 id 并登记，
+ * 淘汰时回收，拾取时按 id 反查。
+ *
+ * ## pickId 为什么要回收
+ *
+ * 拾取结果编码在 RG 两个通道里，只有 65535 个槽。倾斜摄影一块瓦片可能几十个网格，
+ * 一个数据集上千块瓦片就是几万个 —— 不回收的话瓦片进出几轮就溢出了。
+ *
+ * ## 泼溅是独立分支
+ *
+ * 泼溅既没有 `instanceMatrix`，也没有 `geoRef.pickInfo` 里的单体表。走通用路径会在
+ * `_instanceFeature()` 拿到 null 直接返回 —— 表现是「点得中但拿不到结果」。
+ */
+import * as THREE from 'three';
+import type { FeatureStyleManager } from '../FeatureStyleManager.js';
+import type { Picker } from '../Picker.js';
+import type { InstanceFeature } from '../../core/FeatureInfo.js';
+import type { GeoPackageEntry, SegmentBox } from '../../core/types.js';
+import type { PickResult, PickableRef } from '../S3MViewer.js';
+export interface PickHost {
+    readonly picker: Picker | null;
+    readonly camera: THREE.Camera | null;
+    readonly scene: THREE.Scene | null;
+    readonly canvas: HTMLCanvasElement | null;
+    readonly style: {
+        floorHeight: number;
+    };
+    readonly sceneAnchor: {
+        x: number;
+        y: number;
+        z: number;
+        meterInMercator: number;
+        altitude?: number;
+    } | null;
+    readonly datasets: Map<string, {
+        name: string;
+    }>;
+    readonly featureStyleManager: FeatureStyleManager;
+    readonly smidMeshes: Map<number, Set<THREE.Mesh>>;
+    lngLatFromWorld(x: number, y: number): [number, number];
+    gpuPathPoseAt(smid: number): {
+        pos: [number, number, number];
+        yaw: number;
+    } | null;
+    isFeatureHidden(smid: number | null, batchId: number): boolean;
+}
+export declare class PickService {
+    private readonly host;
+    /** 拾取表：pickId → 网格 */
+    readonly pickables: Map<number, PickableRef>;
+    private _pickSeq;
+    private readonly _freePickIds;
+    constructor(host: PickHost);
+    /** 分配一个 pickId（优先复用回收的） */
+    allocPickId(): number;
+    releasePickId(id: number): void;
+    /** 全部网格（拾取表的另一种视角，供样式 / 统计遍历） */
+    meshes(): THREE.Mesh[];
+    clear(): void;
+    /** 获取指定屏幕像素对应的场景射线（用于高精度求交与穿透拾取） */
+    getRayAt(x: number, y: number): THREE.Ray | null;
+    intersectMeshAtRay(mesh: THREE.Mesh, ray: THREE.Ray, instanceIndex?: number): THREE.Vector3 | null;
+    buildPickResult(hit: {
+        objectId: number;
+        batchId: number;
+        instanceIndex?: number;
+    }, ref: PickableRef, exactPoint?: THREE.Vector3, ray?: THREE.Ray): PickResult | null;
+    /**
+     * 泼溅的拾取结果。
+     *
+     * 整块泼溅瓦片当一个单体（没有单体级 smid 可报），命中点由 `splatRaycast` 给出 ——
+     * 它按每个高斯的 3σ 球求交，比拾取那一趟为了命中率摊开的 4px 方块准得多。
+     * 包围盒必须由 `iCenter` 算：geometry 的 position 只是 [-1,1]² 的四边形角点。
+     */
+    buildSplatPickResult(hit: {
+        objectId: number;
+        batchId: number;
+        instanceIndex?: number;
+    }, ref: PickableRef, exactPoint?: THREE.Vector3, ray?: THREE.Ray): PickResult | null;
+    /** 按 canvas 左上角的 CSS 像素坐标拾取。 */
+    pick(x: number, y: number): PickResult | null;
+    /**
+     * 拾取指定屏幕像素对应的世界坐标与场景位置。
+     * 优先与命中的建筑网格精确求交；未命中建筑时若视线与地表相交则返回地面交点。
+     */
+    pickPosition(x: number, y: number): {
+        lngLat: [number, number];
+        altitude: number;
+        point: [number, number, number];
+    } | null;
+    /**
+     * 沿视线方向穿透拾取多个单体，按由近至远排序返回。
+     */
+    drillPick(x: number, y: number, limit?: number): PickResult[];
+    /**
+     * 获取指定 SMID 单体的经纬度包围盒 [[minLng, minLat], [maxLng, maxLat]]。
+     * 若模型尚未加载到场景中或无此单体则返回 null。
+     */
+    getFeatureBounds(smid: number): [[number, number], [number, number]] | null;
+    /** 实例序号 → 所属单体（按网格缓存反查表，实例多的数据不用每次重建） */
+    instanceFeature(mesh: THREE.Mesh, geoRef: GeoPackageEntry | undefined, instanceIndex: number): InstanceFeature | null;
+    /** 实例化几何的单体包围盒：base mesh 的包围盒套上该实例的矩阵 */
+    instanceBox(mesh: THREE.Mesh, instanceIndex: number): SegmentBox | null;
+}
+//# sourceMappingURL=PickService.d.ts.map

package/dist/render/viewer/PickService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PickService.d.ts","sourceRoot":"","sources":["../../../src/render/viewer/PickService.ts"],"names":[],"mappings":"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"}