three-base 2.0.193 → 2.0.195

package/MktMesh/glassPane.js

@@ -1,97 +0,0 @@
-/*
- * @Description: 正方形玻璃面 —— 2026-10-28 需求「mkteditor 还需要增加一个 正方的面的 功能, 要双面显示,
- *   环境贴图就用第一个全景, 效果用 three.js 的 webgl_materials_physical_transmission 案例, 并且要写入 json 数据和回显」。
- *
- * 定位：与「图片平面」（`./imagePlane.ts`）同为挂在 `MktMesh` 子树下的独立 Mesh，但材质完全不同：
- * - 图片平面 = MeshBasicMaterial + FrontSide + 自带内容瓦片（单面可见是 2026-10-22 单独点名的，⛔ 不适用于本类）；
- * - 玻璃面 = MeshPhysicalMaterial + DoubleSide + transmission（本次点名「要双面显示」⇒ 正反两面都画、都折射）。
- *   它自己没有内容纹理：画面 = 背后的东西被折射 + 一层反射，反射来自 `MktMesh` 给的**第一个全景**（`setEnvironmentTexture`）。
- *
- * 材质参数逐字对齐官方示例 `webgl_materials_physical_transmission` 的默认档
- * （transmission 1 / ior 1.5 / thickness 0.01 / roughness 0 / metalness 0 / specularIntensity 1 /
- *   specularColor 白 / envMapIntensity 1 / color 白 / opacity 1 / transparent true / side DoubleSide）。
- * ⛔ 示例 GUI 里那颗 `transmissionResolutionScale` 在 three 0.167 的构建里不存在（属主渲染器且该版本无此属性），
- *   写了会直接把类型检查打红 ⇒ 本文件与宿主都不设它，折射全屏缓冲用引擎默认分辨率。
- * ⛔ 不设 `alphaMap`：示例把它挂在那颗圆环上（切面形状用），玻璃面就是一块方板，没有alpha 轮廓要描。
- *
- * 形状：正方形 ⇒ 存档只有**一个**边长 `size`（米），宽恒等于高。几何仍是 PlaneGeometry(size, size)，
- * 原点在板中心，落地/贴墙那两种落点由调用者摆（与图片平面同一条口径，见编辑器 `addGlassPaneAt`）。
- */
-import { Color, DoubleSide, Mesh, MeshPhysicalMaterial, PlaneGeometry } from "three";
-const DEFAULT_SIZE = 1.5;
-/** 选中高亮色：与图片平面/模型槽同一档（同族观感一致，只换颜色不换形态） */
-const HIGHLIGHT_COLOR = "#ffd24a";
-export class GlassPane extends Mesh {
-    _originalColor = "#ffffff";
-    /** 反射环境纹理的身份（由 `MktMesh` 注入，本类只持有引用、⛔ 从不 dispose 它 —— 那张按地址缓存在库里） */
-    _envTex = null;
-    constructor(name) {
-        const geo = new PlaneGeometry(DEFAULT_SIZE, DEFAULT_SIZE);
-        const mat = new MeshPhysicalMaterial({
-            color: new Color("#ffffff"),
-            // 双面（本次点名「要双面显示」）：正面反面都画，也都能被射线打中
-            //（three 的射线拾取按材质 side 剔背面，见 `node_modules/three/src/objects/Mesh.js`）。
-            side: DoubleSide,
-            transparent: true,
-            opacity: 1,
-            // ↓ 以下六档 + 上面两档 = 官方示例的默认 GUI 值，一字未改
-            transmission: 1,
-            ior: 1.5,
-            thickness: 0.01,
-            roughness: 0,
-            metalness: 0,
-            specularIntensity: 1,
-            specularColor: new Color("#ffffff"),
-            envMapIntensity: 1,
-        });
-        super(geo, mat);
-        this.name = name || "玻璃面";
-    }
-    get paneSize() { return this.geometry.parameters.width; }
-    /** 换正方形边长（宽高等比跟着走：几何只有这一把尺） */
-    setPaneSize(size) {
-        this.geometry.dispose();
-        this.geometry = new PlaneGeometry(size, size);
-    }
-    /**
-     * 绑/摘反射环境纹理（`null` = 还没有可用的环境源）。
-     * ⚠️ 判等在前：`material.needsUpdate = true` 会涨材质版本 ⇒ 程序要重编译。库里给同一批玻璃面注入的是
-     *   **同一个 Texture 对象**（反射源只下载一次），逐颗重复赋同一张时必须早退，不然就是 N 次无谓重编译。
-     * ⚠️ 传进来的纹理必须已标 `EquirectangularReflectionMapping`：three 的 `WebGLCubeUVMaps` 只认那个标记才会
-     *   自动把它卷积成立方 UV（PMREM）；直接给一张普通 UV 纹理（例如全景拼合槽的那两张 RT）采出来是花屏。
-     */
-    setEnvironmentTexture(tex) {
-        if (this._envTex === tex)
-            return;
-        this._envTex = tex;
-        this.material.envMap = tex;
-        this.material.needsUpdate = true;
-    }
-    highlight() {
-        this.material.color.set(HIGHLIGHT_COLOR);
-    }
-    restoreColor() {
-        this.material.color.set(this._originalColor);
-    }
-    toData() {
-        return {
-            name: this.name || undefined,
-            position: { x: this.position.x, y: this.position.y, z: this.position.z },
-            rotation: { x: this.rotation.x, y: this.rotation.y, z: this.rotation.z },
-            size: this.paneSize,
-        };
-    }
-    applyData(d) {
-        if (d.name)
-            this.name = d.name;
-        this.position.set(d.position.x, d.position.y, d.position.z);
-        this.rotation.set(d.rotation.x, d.rotation.y, d.rotation.z);
-        this.setPaneSize(d.size);
-    }
-    /** 只释放自己的几何与材质；反射纹理归 `MktMesh` 管（多颗共用一张）。 */
-    dispose() {
-        this.geometry.dispose();
-        this.material.dispose();
-    }
-}
-export const GLASS_PANE_DEFAULTS = { size: DEFAULT_SIZE };

package/MktMesh/glassPane.ts

@@ -1,116 +0,0 @@
-/*
- * @Description: 正方形玻璃面 —— 2026-10-28 需求「mkteditor 还需要增加一个 正方的面的 功能, 要双面显示,
- *   环境贴图就用第一个全景, 效果用 three.js 的 webgl_materials_physical_transmission 案例, 并且要写入 json 数据和回显」。
- *
- * 定位：与「图片平面」（`./imagePlane.ts`）同为挂在 `MktMesh` 子树下的独立 Mesh，但材质完全不同：
- * - 图片平面 = MeshBasicMaterial + FrontSide + 自带内容瓦片（单面可见是 2026-10-22 单独点名的，⛔ 不适用于本类）；
- * - 玻璃面 = MeshPhysicalMaterial + DoubleSide + transmission（本次点名「要双面显示」⇒ 正反两面都画、都折射）。
- *   它自己没有内容纹理：画面 = 背后的东西被折射 + 一层反射，反射来自 `MktMesh` 给的**第一个全景**（`setEnvironmentTexture`）。
- *
- * 材质参数逐字对齐官方示例 `webgl_materials_physical_transmission` 的默认档
- * （transmission 1 / ior 1.5 / thickness 0.01 / roughness 0 / metalness 0 / specularIntensity 1 /
- *   specularColor 白 / envMapIntensity 1 / color 白 / opacity 1 / transparent true / side DoubleSide）。
- * ⛔ 示例 GUI 里那颗 `transmissionResolutionScale` 在 three 0.167 的构建里不存在（属主渲染器且该版本无此属性），
- *   写了会直接把类型检查打红 ⇒ 本文件与宿主都不设它，折射全屏缓冲用引擎默认分辨率。
- * ⛔ 不设 `alphaMap`：示例把它挂在那颗圆环上（切面形状用），玻璃面就是一块方板，没有alpha 轮廓要描。
- *
- * 形状：正方形 ⇒ 存档只有**一个**边长 `size`（米），宽恒等于高。几何仍是 PlaneGeometry(size, size)，
- * 原点在板中心，落地/贴墙那两种落点由调用者摆（与图片平面同一条口径，见编辑器 `addGlassPaneAt`）。
- */
-import { Color, DoubleSide, Mesh, MeshPhysicalMaterial, PlaneGeometry, Texture } from "three";
-
-/** 玻璃面的持久化数据（进 `MktMesh.exportData` 的 `glass` 键 / `importData` 还原） */
-export interface GlassPaneData {
-    name?: string;
-    position: { x: number; y: number; z: number };
-    rotation: { x: number; y: number; z: number };
-    /** 正方形边长（米）：宽 = 高 = 本值，⛔ 不拆成两档 */
-    size: number;
-}
-
-const DEFAULT_SIZE = 1.5;
-/** 选中高亮色：与图片平面/模型槽同一档（同族观感一致，只换颜色不换形态） */
-const HIGHLIGHT_COLOR = "#ffd24a";
-
-export class GlassPane extends Mesh<PlaneGeometry, MeshPhysicalMaterial> {
-    private _originalColor: string = "#ffffff";
-    /** 反射环境纹理的身份（由 `MktMesh` 注入，本类只持有引用、⛔ 从不 dispose 它 —— 那张按地址缓存在库里） */
-    private _envTex: Texture | null = null;
-
-    constructor(name?: string) {
-        const geo = new PlaneGeometry(DEFAULT_SIZE, DEFAULT_SIZE);
-        const mat = new MeshPhysicalMaterial({
-            color: new Color("#ffffff"),
-            // 双面（本次点名「要双面显示」）：正面反面都画，也都能被射线打中
-            //（three 的射线拾取按材质 side 剔背面，见 `node_modules/three/src/objects/Mesh.js`）。
-            side: DoubleSide,
-            transparent: true,
-            opacity: 1,
-            // ↓ 以下六档 + 上面两档 = 官方示例的默认 GUI 值，一字未改
-            transmission: 1,
-            ior: 1.5,
-            thickness: 0.01,
-            roughness: 0,
-            metalness: 0,
-            specularIntensity: 1,
-            specularColor: new Color("#ffffff"),
-            envMapIntensity: 1,
-        });
-        super(geo, mat);
-        this.name = name || "玻璃面";
-    }
-
-    get paneSize(): number { return (this.geometry as PlaneGeometry).parameters.width; }
-
-    /** 换正方形边长（宽高等比跟着走：几何只有这一把尺） */
-    setPaneSize(size: number): void {
-        this.geometry.dispose();
-        this.geometry = new PlaneGeometry(size, size);
-    }
-
-    /**
-     * 绑/摘反射环境纹理（`null` = 还没有可用的环境源）。
-     * ⚠️ 判等在前：`material.needsUpdate = true` 会涨材质版本 ⇒ 程序要重编译。库里给同一批玻璃面注入的是
-     *   **同一个 Texture 对象**（反射源只下载一次），逐颗重复赋同一张时必须早退，不然就是 N 次无谓重编译。
-     * ⚠️ 传进来的纹理必须已标 `EquirectangularReflectionMapping`：three 的 `WebGLCubeUVMaps` 只认那个标记才会
-     *   自动把它卷积成立方 UV（PMREM）；直接给一张普通 UV 纹理（例如全景拼合槽的那两张 RT）采出来是花屏。
-     */
-    setEnvironmentTexture(tex: Texture | null): void {
-        if (this._envTex === tex) return;
-        this._envTex = tex;
-        this.material.envMap = tex;
-        this.material.needsUpdate = true;
-    }
-
-    highlight(): void {
-        this.material.color.set(HIGHLIGHT_COLOR);
-    }
-
-    restoreColor(): void {
-        this.material.color.set(this._originalColor);
-    }
-
-    toData(): GlassPaneData {
-        return {
-            name: this.name || undefined,
-            position: { x: this.position.x, y: this.position.y, z: this.position.z },
-            rotation: { x: this.rotation.x, y: this.rotation.y, z: this.rotation.z },
-            size: this.paneSize,
-        };
-    }
-
-    applyData(d: GlassPaneData): void {
-        if (d.name) this.name = d.name;
-        this.position.set(d.position.x, d.position.y, d.position.z);
-        this.rotation.set(d.rotation.x, d.rotation.y, d.rotation.z);
-        this.setPaneSize(d.size);
-    }
-
-    /** 只释放自己的几何与材质；反射纹理归 `MktMesh` 管（多颗共用一张）。 */
-    dispose(): void {
-        this.geometry.dispose();
-        this.material.dispose();
-    }
-}
-
-export const GLASS_PANE_DEFAULTS = { size: DEFAULT_SIZE };