three-base 2.0.137 → 2.0.142

package/ThreeMouse.js

@@ -1,407 +1,453 @@
-//
-//
-//
-//
-//
-// 启动鼠标事件
-import { Raycaster, Vector2 } from "three";
-import { Mesh } from "three";
-import { debounce } from "lodash";
-import { computeBoundsTree, acceleratedRaycast } from "three-mesh-bvh";
-// Add the extension functions
-Mesh.prototype.raycast = acceleratedRaycast;
-/**
- *  js 专用的鼠标拾取模型对象
- */
-export default class ThreeMouse {
-    constructor(renderer, camera, scene) {
-        this._renderer = renderer;
-        this._camera = camera;
-        this._scene = scene;
-        this._frame = this._renderer.info.render.frame;
-        this._renderer.domElement.addEventListener("mouseenter", () => {
-            this._mouseInRenderer = true;
-        }, true); //鼠标进入开启拾取
-        this._renderer.domElement.addEventListener("mouseleave", this._mouseleave, true); //鼠标离开停止拾取
-        this._renderer.domElement.addEventListener("mousemove", this._mousemove, true); //鼠标移动监听事件
-        this._renderer.domElement.addEventListener("pointerdown", this._mousedown, true); //鼠标按下监听事件
-        this._renderer.domElement.addEventListener("pointerup", this._mouseup, true); //鼠标弹起监听事件
-    }
-    // 渲染器
-    _renderer;
-    _camera;
-    _scene;
-    // 鼠标在渲染器上面的位置
-    _mosePosition = new Vector2(0, 0);
-    // 鼠标按下的位置 如果和鼠标弹起的位置相同 才算一次有效的点击事件
-    _mouseDownPosition = new Vector2(0, 0);
-    //当前鼠标指针上的对象
-    _mesh_on;
-    //鼠标按下的对象
-    _mesh_Down;
-    //射线拾取器
-    _raycaster = new Raycaster();
-    // 当前渲染的帧数 ( 鼠标滑动事件 一帧只需要执行费一次即可 )
-    _frame = 0;
-    //鼠标是否在渲染器上
-    _mouseInRenderer = false;
-    // 鼠标滑动的事件
-    _mousemoveEvent;
-    // 鼠标事件
-    _mouseEvent;
-    // 需要被拾取的对象数组
-    _object3ds = [];
-    // 点击次数
-    _click_num = 0;
-    // 获取拾取到的对象
-    _getSelected(object3ds) {
-        let intersection;
-        if (object3ds.length) {
-            intersection = this._raycaster.intersectObjects(object3ds, false)[0];
-        }
-        return intersection;
-    }
-    // 判断对象上面是否有事件
-    hasEvent(object, types = []) {
-        if (!object) {
-            return false;
-        }
-        // 如果 启用事件为关闭的话就不执行事件
-        if (object["userData"] && object["userData"]["enableEvent"] === false) {
-            return false;
-        }
-        const hasevent = types.some((type) => {
-            //@ts-ignore
-            if (object["_listeners"] &&
-                object["_listeners"][type] &&
-                object["_listeners"][type][0]) {
-                return true;
-            }
-            // if (object["userData"] && object["userData"]["cursor"]) {
-            //     return true;
-            // }
-            return false;
-        });
-        return hasevent;
-    }
-    // 判断对象上是否有鼠标样式
-    hasCursor(object) {
-        if (!object) {
-            return false;
-        }
-        // 如果 启用事件为关闭的话就不执行事件
-        if (object["userData"] && object["userData"]["enableEvent"] === false) {
-            return false;
-        }
-        if (object["userData"] && object["userData"]["cursor"]) {
-            return true;
-        }
-    }
-    // 分发鼠标拾取事件
-    dispatchEvent() {
-        // 提取有事件的对象
-        const meshs = [];
-        this._scene.traverseVisible((mesh) => {
-            // 判断对象是否有指定的事件
-            if (this.hasCursor(mesh) ||
-                this.hasEvent(mesh, [
-                    "leftclick",
-                    "rightclick",
-                    "click",
-                    "dbclick",
-                    "mouseenter",
-                    "mouseleave",
-                    "mousemove",
-                    "mousedown",
-                    "mouseup",
-                ])) {
-                if (mesh.isMesh &&
-                    !mesh.geometry.boundsTree &&
-                    mesh.geometry.attributes.position &&
-                    mesh.geometry.attributes.position.count > 0) {
-                    computeBoundsTree.apply(mesh.geometry);
-                    //   disposeBoundsTree.apply((mesh as Mesh).geometry);
-                }
-                meshs.push(mesh);
-            }
-        });
-        this._object3ds = meshs;
-        // 没有鼠标事件就不往下执行了
-        if (!this._mousemoveEvent || !this._mouseInRenderer) {
-            return;
-        }
-        // 拾取模型
-        let intersection = this._getSelected(meshs);
-        if (intersection) {
-            const { face, object } = intersection;
-            // face && face.normal.applyMatrix4(object.matrixWorld);
-            const MouseEvent = Object.assign(intersection, {
-                // 将来可能用到的对象
-                e: this._mousemoveEvent,
-                renderer: this._renderer,
-                camera: this._camera,
-                object: intersection.object,
-                type: this._mousemoveEvent.type,
-                offsetX: this._mousemoveEvent.offsetX,
-                offsetY: this._mousemoveEvent.offsetY,
-                x: this._mousemoveEvent.x,
-                y: this._mousemoveEvent.y,
-            });
-            // 触发滑动事件
-            if (this._mesh_on === MouseEvent.object) {
-                if (this.hasEvent(MouseEvent.object, ["mousemove"])) {
-                    MouseEvent.type = "mousemove";
-                    MouseEvent.object.dispatchEvent(MouseEvent);
-                }
-                // 鼠标划入滑出事件
-            }
-            else if (this._mesh_on !== MouseEvent.object) {
-                if (this.hasEvent(this._mesh_on, ["mouseleave"])) {
-                    MouseEvent.type = "mouseleave";
-                    this._mesh_on.dispatchEvent(MouseEvent);
-                }
-                if (this.hasEvent(MouseEvent.object, ["mouseenter"])) {
-                    MouseEvent.type = "mouseenter";
-                    MouseEvent.object.dispatchEvent(MouseEvent);
-                }
-            }
-            this._mesh_on = MouseEvent.object || undefined; // 设置为当前鼠标上的对象
-            // 鼠标样式
-            if (this._mesh_on &&
-                this._mesh_on.userData &&
-                this._mesh_on.userData.cursor) {
-                this._renderer.domElement.style.cursor = this._mesh_on.userData.cursor;
-            }
-            else {
-                this._renderer.domElement.style.cursor = "auto";
-            }
-        }
-        else {
-            if (this.hasEvent(this._mesh_on, ["mouseleave"])) {
-                // 鼠标离开事件
-                this._mesh_on.dispatchEvent({
-                    e: this._mouseEvent,
-                    renderer: this._renderer,
-                    camera: this._camera,
-                    object: this._mesh_on,
-                    type: "mouseleave",
-                    offsetX: this._mousemoveEvent.offsetX,
-                    offsetY: this._mousemoveEvent.offsetY,
-                    x: this._mousemoveEvent.x,
-                    y: this._mousemoveEvent.y,
-                });
-            }
-            // 置空当前鼠标上面的对象
-            this._mesh_on = undefined;
-            this._renderer.domElement.style.cursor = "auto"; // 鼠标样式
-        }
-    }
-    // 鼠标离开事件
-    _mouseleave = (e) => {
-        this._mouseEvent = e;
-        this._mouseInRenderer = false;
-        // 鼠标离开事件
-        if (this._mousemoveEvent && this.hasEvent(this._mesh_on, ["mouseleave"])) {
-            this._mesh_on.dispatchEvent({
-                e: this._mouseEvent,
-                renderer: this._renderer,
-                camera: this._camera,
-                object: this._mesh_on,
-                type: "mouseleave",
-                offsetX: this._mousemoveEvent.offsetX,
-                offsetY: this._mousemoveEvent.offsetY,
-                x: this._mousemoveEvent.x,
-                y: this._mousemoveEvent.y,
-            });
-        }
-        // 置空当前鼠标上面的对象
-        this._mesh_on = undefined;
-        this._renderer.domElement.style.cursor = "auto"; // 鼠标样式
-    };
-    // 鼠标滑动 设置鼠标位置
-    _mousemove = (e) => {
-        this._mousemoveEvent = e;
-        this._frame = this._renderer.info.render.frame;
-        if (document.pointerLockElement) {
-            // 如果当前有元素 锁住了鼠标
-            this._mosePosition.set(0, 0); // 鼠标就指向canvas 的正中心
-        }
-        else {
-            this._mosePosition.x = (e.offsetX / this._renderer.domElement.offsetWidth) * 2 - 1;
-            this._mosePosition.y = -(e.offsetY / this._renderer.domElement.offsetHeight) * 2 + 1;
-        }
-        this._raycaster.setFromCamera(this._mosePosition, this._camera); // 设置射线拾取的参数
-    };
-    // 鼠标按下事件
-    _mousedown = (e) => {
-        this._mouseEvent = e;
-        // 记录按下的位置
-        this._mouseDownPosition.set(e.offsetX, e.offsetY);
-        this._mousemove(e);
-        let intersection = this._getSelected(this._object3ds);
-        if (!intersection || !this._mousemoveEvent) {
-            return;
-        }
-        this._mesh_Down = this._mesh_on = intersection.object;
-        // 触发鼠标按下事件
-        if (this.hasEvent(this._mesh_Down, ["mousedown"])) {
-            this._mesh_Down.dispatchEvent({
-                e: this._mouseEvent,
-                ...intersection,
-                renderer: this._renderer,
-                camera: this._camera,
-                object: intersection.object,
-                type: "mousedown",
-                offsetX: this._mousemoveEvent.offsetX,
-                offsetY: this._mousemoveEvent.offsetY,
-                x: this._mousemoveEvent.x,
-                y: this._mousemoveEvent.y,
-            });
-        }
-    };
-    // 鼠标弹起事件
-    _mouseup = debounce(async (e) => {
-        this._mouseEvent = e;
-        // 提取有事件的对象
-        const meshs = [];
-        let intersection = this._getSelected(this._object3ds);
-        if (!intersection || !this._mousemoveEvent) {
-            return;
-        }
-        this._mesh_on = intersection.object;
-        if (this.hasEvent(this._mesh_on, ["mouseup"])) {
-            this._mesh_on.dispatchEvent({
-                e: this._mouseEvent,
-                ...intersection,
-                renderer: this._renderer,
-                camera: this._camera,
-                object: intersection.object,
-                type: "mouseup",
-                offsetX: this._mousemoveEvent.offsetX,
-                offsetY: this._mousemoveEvent.offsetY,
-                x: this._mousemoveEvent.x,
-                y: this._mousemoveEvent.y,
-            });
-        }
-        // 触发鼠标弹起事件
-        if (this._mesh_Down &&
-            this._mesh_Down === this._mesh_on &&
-            Math.abs(this._mouseDownPosition.x - e.offsetX) < 5 &&
-            Math.abs(this._mouseDownPosition.y - e.offsetY) < 5) {
-            // 是否有双击事件
-            if (this.hasEvent(this._mesh_Down, ["dbclick"])) {
-                this._click_num++;
-                await new Promise((resolve) => setTimeout(resolve, 200));
-                // 只点击了一次
-                if (this._click_num === 1) {
-                    if (this.hasEvent(this._mesh_Down, ["click"])) {
-                        this._mesh_Down.dispatchEvent({
-                            e: this._mouseEvent,
-                            ...intersection,
-                            renderer: this._renderer,
-                            camera: this._camera,
-                            object: intersection.object,
-                            type: "click",
-                            offsetX: this._mousemoveEvent.offsetX,
-                            offsetY: this._mousemoveEvent.offsetY,
-                            x: this._mousemoveEvent.x,
-                            y: this._mousemoveEvent.y,
-                        });
-                    }
-                    if (this.hasEvent(this._mesh_Down, ["leftclick"]) && e.button === 0) {
-                        this._mesh_Down.dispatchEvent({
-                            e: this._mouseEvent,
-                            ...intersection,
-                            renderer: this._renderer,
-                            camera: this._camera,
-                            object: intersection.object,
-                            type: "leftclick",
-                            offsetX: this._mousemoveEvent.offsetX,
-                            offsetY: this._mousemoveEvent.offsetY,
-                            x: this._mousemoveEvent.x,
-                            y: this._mousemoveEvent.y,
-                        });
-                    }
-                    if (this.hasEvent(this._mesh_Down, ["rightclick"]) &&
-                        e.button === 2) {
-                        this._mesh_Down.dispatchEvent({
-                            e: this._mouseEvent,
-                            ...intersection,
-                            renderer: this._renderer,
-                            camera: this._camera,
-                            object: intersection.object,
-                            type: "rightclick",
-                            offsetX: this._mousemoveEvent.offsetX,
-                            offsetY: this._mousemoveEvent.offsetY,
-                            x: this._mousemoveEvent.x,
-                            y: this._mousemoveEvent.y,
-                        });
-                    }
-                }
-                else if (this._click_num > 1) {
-                    if (this.hasEvent(this._mesh_Down, ["dbclick"]) &&
-                        new Date().valueOf() - this._click_num > 1 &&
-                        e.button === 0) {
-                        this._mesh_Down.dispatchEvent({
-                            e: this._mouseEvent,
-                            ...intersection,
-                            renderer: this._renderer,
-                            camera: this._camera,
-                            object: intersection.object,
-                            type: "dbclick",
-                            offsetX: this._mousemoveEvent.offsetX,
-                            offsetY: this._mousemoveEvent.offsetY,
-                            x: this._mousemoveEvent.x,
-                            y: this._mousemoveEvent.y,
-                        });
-                    }
-                }
-            }
-            else {
-                if (this.hasEvent(this._mesh_Down, ["click"])) {
-                    this._mesh_Down.dispatchEvent({
-                        e: this._mouseEvent,
-                        ...intersection,
-                        renderer: this._renderer,
-                        camera: this._camera,
-                        object: intersection.object,
-                        type: "click",
-                        offsetX: this._mousemoveEvent.offsetX,
-                        offsetY: this._mousemoveEvent.offsetY,
-                        x: this._mousemoveEvent.x,
-                        y: this._mousemoveEvent.y,
-                    });
-                }
-                if (this.hasEvent(this._mesh_Down, ["leftclick"]) && e.button === 0) {
-                    this._mesh_Down.dispatchEvent({
-                        e: this._mouseEvent,
-                        ...intersection,
-                        renderer: this._renderer,
-                        camera: this._camera,
-                        object: intersection.object,
-                        type: "leftclick",
-                        offsetX: this._mousemoveEvent.offsetX,
-                        offsetY: this._mousemoveEvent.offsetY,
-                        x: this._mousemoveEvent.x,
-                        y: this._mousemoveEvent.y,
-                    });
-                }
-                if (this.hasEvent(this._mesh_Down, ["rightclick"]) && e.button === 2) {
-                    this._mesh_Down.dispatchEvent({
-                        e: this._mouseEvent,
-                        ...intersection,
-                        renderer: this._renderer,
-                        camera: this._camera,
-                        object: intersection.object,
-                        type: "rightclick",
-                        offsetX: this._mousemoveEvent.offsetX,
-                        offsetY: this._mousemoveEvent.offsetY,
-                        x: this._mousemoveEvent.x,
-                        y: this._mousemoveEvent.y,
-                    });
-                }
-            }
-            this._click_num = 0;
-        }
-    });
-}
+//
+//
+//
+//
+//
+//  启动鼠标事件
+import { InstancedMesh, Mesh, Raycaster, Vector2 } from "three";
+import { debounce } from "lodash";
+import { computeBoundsTree, acceleratedRaycast } from "three-mesh-bvh";
+/** 安全地分发事件到 Object3D 对象 */
+function dispatchObjectEvent(object, event) {
+    // 使用双重断言来安全地传递事件对象
+    object.dispatchEvent(event);
+}
+/** Patch Mesh.raycast with BVH acceleration. Call once before using ThreeMouse. */
+export function initBVHRaycast() {
+    if (Mesh.prototype.raycast !== acceleratedRaycast) {
+        Mesh.prototype.raycast = acceleratedRaycast;
+    }
+}
+export { computeBoundsTree, acceleratedRaycast };
+/**
+ *  js 专用的鼠标拾取模型对象
+ */
+export default class ThreeMouse {
+    constructor(renderer, camera, scene) {
+        this._renderer = renderer;
+        this._camera = camera;
+        this._scene = scene;
+        this._frame = this._renderer.info.render.frame;
+        this._renderer.domElement.addEventListener("mouseenter", () => {
+            this._mouseInRenderer = true;
+        }, true); //鼠标进入开启拾取
+        this._renderer.domElement.addEventListener("mouseleave", this._mouseleave, true); //鼠标离开停止拾取
+        this._renderer.domElement.addEventListener("mousemove", this._mousemove, true); //鼠标移动监听事件
+        this._renderer.domElement.addEventListener("pointerdown", this._mousedown, true); //鼠标按下监听事件
+        this._renderer.domElement.addEventListener("pointerup", this._mouseup, true); //鼠标弹起监听事件
+    }
+    // 渲染器
+    _renderer;
+    _camera;
+    _scene;
+    // 固定的实例化分组器（由 ThreeBase 注入），用于把 InstancedMesh 命中路由到 InstancedChild
+    instancedGroup;
+    // 鼠标在渲染器上面的位置
+    _mosePosition = new Vector2(0, 0);
+    // 鼠标按下的位置 如果和鼠标弹起的位置相同 才算一次有效的点击事件
+    _mouseDownPosition = new Vector2(0, 0);
+    //当前鼠标指针上的对象
+    _mesh_on;
+    //鼠标按下的对象
+    _mesh_Down;
+    //射线拾取器
+    _raycaster = new Raycaster();
+    // 当前渲染的帧数 ( 鼠标滑动事件 一帧只需要执行费一次即可 )
+    _frame = 0;
+    //鼠标是否在渲染器上
+    _mouseInRenderer = false;
+    // 鼠标滑动的事件
+    _mousemoveEvent;
+    // 鼠标事件
+    _mouseEvent;
+    // 需要被拾取的对象数组
+    _object3ds = [];
+    // 点击次数
+    _click_num = 0;
+    // 获取拾取到的对象
+    _getSelected(object3ds) {
+        let intersection;
+        if (object3ds.length) {
+            intersection = this._raycaster.intersectObjects(object3ds, false)[0];
+        }
+        return intersection;
+    }
+    // 判断对象上面是否有事件
+    hasEvent(object, types = []) {
+        if (!object) {
+            return false;
+        }
+        // 如果 启用事件为关闭的话就不执行事件
+        if (object["userData"] && object["userData"]["enableEvent"] === false) {
+            return false;
+        }
+        // 注意：three 的 hasEventListener(type, null) 因 indexOf(null) 永远 -1 而恒返回 false，
+        // 无法用来判断"是否存在任意监听器"。改为直接读取私有 _listeners 表判断该类型是否有监听。
+        const listeners = object._listeners;
+        const hasevent = types.some((type) => {
+            return !!(listeners && listeners[type] && listeners[type].length > 0);
+        });
+        return hasevent;
+    }
+    // 判断对象上是否有鼠标样式
+    hasCursor(object) {
+        if (!object) {
+            return false;
+        }
+        // 如果 启用事件为关闭的话就不执行事件
+        if (object["userData"] && object["userData"]["enableEvent"] === false) {
+            return false;
+        }
+        if (object["userData"] && object["userData"]["cursor"]) {
+            return true;
+        }
+    }
+    // 把命中的对象解析为事件派发目标：若命中 InstancedMesh 且属于某个 batch，
+    // 则路由到对应的 InstancedChild（逻辑实例），使实例成为透明事件接收端。
+    resolveTarget(object, instanceId) {
+        if (object instanceof InstancedMesh && this.instancedGroup) {
+            const child = this.instancedGroup.resolveInstance(object, instanceId);
+            if (child) {
+                return child;
+            }
+        }
+        return object;
+    }
+    // 分发鼠标拾取事件
+    dispatchEvent() {
+        // 提取有事件的对象
+        const meshs = [];
+        this._scene.traverseVisible((mesh) => {
+            // 逻辑实例节点（InstancedChild）自身不渲染、无几何，跳过收集（命中由 InstancedMesh 路由回来）
+            if (mesh.userData?.__instancedChild) {
+                return;
+            }
+            // 判断对象是否有指定的事件
+            if (this.hasCursor(mesh) ||
+                this.hasEvent(mesh, [
+                    "leftclick",
+                    "rightclick",
+                    "click",
+                    "dbclick",
+                    "mouseenter",
+                    "mouseleave",
+                    "mousemove",
+                    "mousedown",
+                    "mouseup",
+                ])) {
+                if (mesh instanceof Mesh &&
+                    !mesh.geometry.boundsTree &&
+                    mesh.geometry.attributes.position &&
+                    mesh.geometry.attributes.position.count > 0) {
+                    computeBoundsTree.apply(mesh.geometry);
+                    //   disposeBoundsTree.apply((mesh as Mesh).geometry);
+                }
+                meshs.push(mesh);
+            }
+        });
+        this._object3ds = meshs;
+        // 收集可拾取的 InstancedMesh（仅含注册了监听的已就绪 batch）
+        if (this.instancedGroup) {
+            this.instancedGroup.collectPickable(meshs);
+        }
+        // 没有鼠标事件就不往下执行了
+        if (!this._mousemoveEvent || !this._mouseInRenderer) {
+            return;
+        }
+        // 拾取模型
+        let intersection = this._getSelected(meshs);
+        if (intersection) {
+            const { face, object } = intersection;
+            // face && face.normal.applyMatrix4(object.matrixWorld);
+            const MouseEvent = Object.assign(intersection, {
+                // 将来可能用到的对象
+                e: this._mousemoveEvent,
+                renderer: this._renderer,
+                camera: this._camera,
+                object: intersection.object,
+                type: this._mousemoveEvent.type,
+                offsetX: this._mousemoveEvent.offsetX,
+                offsetY: this._mousemoveEvent.offsetY,
+                x: this._mousemoveEvent.x,
+                y: this._mousemoveEvent.y,
+            });
+            // 命中 InstancedMesh 时，把派发目标重定向到对应的 InstancedChild
+            const _target = this.resolveTarget(intersection.object, intersection.instanceId);
+            if (_target)
+                MouseEvent.object = _target;
+            // 触发滑动事件
+            if (this._mesh_on === MouseEvent.object) {
+                if (this.hasEvent(MouseEvent.object, ["mousemove"])) {
+                    MouseEvent.type = "mousemove";
+                    dispatchObjectEvent(MouseEvent.object, MouseEvent);
+                }
+                // 鼠标划入滑出事件
+            }
+            else if (this._mesh_on !== MouseEvent.object) {
+                if (this.hasEvent(this._mesh_on, ["mouseleave"])) {
+                    MouseEvent.type = "mouseleave";
+                    dispatchObjectEvent(this._mesh_on, MouseEvent);
+                }
+                if (this.hasEvent(MouseEvent.object, ["mouseenter"])) {
+                    MouseEvent.type = "mouseenter";
+                    dispatchObjectEvent(MouseEvent.object, MouseEvent);
+                }
+            }
+            this._mesh_on = MouseEvent.object || undefined; // 设置为当前鼠标上的对象
+            // 鼠标样式
+            if (this._mesh_on &&
+                this._mesh_on.userData &&
+                this._mesh_on.userData.cursor) {
+                this._renderer.domElement.style.cursor = this._mesh_on.userData.cursor;
+            }
+            else {
+                this._renderer.domElement.style.cursor = "auto";
+            }
+        }
+        else {
+            if (this.hasEvent(this._mesh_on, ["mouseleave"])) {
+                // 鼠标离开事件
+                dispatchObjectEvent(this._mesh_on, {
+                    e: this._mouseEvent,
+                    renderer: this._renderer,
+                    camera: this._camera,
+                    object: this._mesh_on,
+                    type: "mouseleave",
+                    offsetX: this._mousemoveEvent.offsetX,
+                    offsetY: this._mousemoveEvent.offsetY,
+                    x: this._mousemoveEvent.x,
+                    y: this._mousemoveEvent.y,
+                });
+            }
+            // 置空当前鼠标上面的对象
+            this._mesh_on = undefined;
+            this._renderer.domElement.style.cursor = "auto"; // 鼠标样式
+        }
+    }
+    // 鼠标离开事件
+    _mouseleave = (e) => {
+        this._mouseEvent = e;
+        this._mouseInRenderer = false;
+        // 鼠标离开事件
+        if (this._mousemoveEvent && this.hasEvent(this._mesh_on, ["mouseleave"])) {
+            dispatchObjectEvent(this._mesh_on, {
+                e: this._mouseEvent,
+                renderer: this._renderer,
+                camera: this._camera,
+                object: this._mesh_on,
+                type: "mouseleave",
+                offsetX: this._mousemoveEvent.offsetX,
+                offsetY: this._mousemoveEvent.offsetY,
+                x: this._mousemoveEvent.x,
+                y: this._mousemoveEvent.y,
+            });
+        }
+        // 置空当前鼠标上面的对象
+        this._mesh_on = undefined;
+        this._renderer.domElement.style.cursor = "auto"; // 鼠标样式
+    };
+    // 鼠标滑动 设置鼠标位置
+    _mousemove = (e) => {
+        this._mousemoveEvent = e;
+        this._frame = this._renderer.info.render.frame;
+        if (document.pointerLockElement) {
+            // 如果当前有元素 锁住了鼠标
+            this._mosePosition.set(0, 0); // 鼠标就指向canvas 的正中心
+        }
+        else {
+            this._mosePosition.x = (e.offsetX / this._renderer.domElement.offsetWidth) * 2 - 1;
+            this._mosePosition.y = -(e.offsetY / this._renderer.domElement.offsetHeight) * 2 + 1;
+        }
+        this._raycaster.setFromCamera(this._mosePosition, this._camera); // 设置射线拾取的参数
+    };
+    // 鼠标按下事件
+    _mousedown = (e) => {
+        this._mouseEvent = e;
+        // 记录按下的位置
+        this._mouseDownPosition.set(e.offsetX, e.offsetY);
+        this._mousemove(e);
+        let intersection = this._getSelected(this._object3ds);
+        if (!intersection || !this._mousemoveEvent) {
+            return;
+        }
+        // 命中 InstancedMesh 时把派发目标重定向到 InstancedChild，并改写 intersection.object
+        this._mesh_Down = this._mesh_on = this.resolveTarget(intersection.object, intersection.instanceId);
+        intersection.object = this._mesh_Down;
+        // 触发鼠标按下事件
+        if (this.hasEvent(this._mesh_Down, ["mousedown"])) {
+            dispatchObjectEvent(this._mesh_Down, {
+                e: this._mouseEvent,
+                ...intersection,
+                renderer: this._renderer,
+                camera: this._camera,
+                object: intersection.object,
+                type: "mousedown",
+                offsetX: this._mousemoveEvent.offsetX,
+                offsetY: this._mousemoveEvent.offsetY,
+                x: this._mousemoveEvent.x,
+                y: this._mousemoveEvent.y,
+            });
+        }
+    };
+    // 鼠标弹起事件
+    _mouseup = debounce(async (e) => {
+        this._mouseEvent = e;
+        // 提取有事件的对象
+        const meshs = [];
+        let intersection = this._getSelected(this._object3ds);
+        if (!intersection || !this._mousemoveEvent) {
+            return;
+        }
+        // 命中 InstancedMesh 时把派发目标重定向到 InstancedChild，并改写 intersection.object
+        this._mesh_on = this.resolveTarget(intersection.object, intersection.instanceId);
+        intersection.object = this._mesh_on;
+        if (this.hasEvent(this._mesh_on, ["mouseup"])) {
+            dispatchObjectEvent(this._mesh_on, {
+                e: this._mouseEvent,
+                ...intersection,
+                renderer: this._renderer,
+                camera: this._camera,
+                object: intersection.object,
+                type: "mouseup",
+                offsetX: this._mousemoveEvent.offsetX,
+                offsetY: this._mousemoveEvent.offsetY,
+                x: this._mousemoveEvent.x,
+                y: this._mousemoveEvent.y,
+            });
+        }
+        // 触发鼠标弹起事件
+        if (this._mesh_Down &&
+            this._mesh_Down === this._mesh_on &&
+            Math.abs(this._mouseDownPosition.x - e.offsetX) < 5 &&
+            Math.abs(this._mouseDownPosition.y - e.offsetY) < 5) {
+            // 是否有双击事件
+            if (this.hasEvent(this._mesh_Down, ["dbclick"])) {
+                this._click_num++;
+                await new Promise((resolve) => setTimeout(resolve, 200));
+                // 只点击了一次
+                if (this._click_num === 1) {
+                    if (this.hasEvent(this._mesh_Down, ["click"])) {
+                        dispatchObjectEvent(this._mesh_Down, {
+                            e: this._mouseEvent,
+                            ...intersection,
+                            renderer: this._renderer,
+                            camera: this._camera,
+                            object: intersection.object,
+                            type: "click",
+                            offsetX: this._mousemoveEvent.offsetX,
+                            offsetY: this._mousemoveEvent.offsetY,
+                            x: this._mousemoveEvent.x,
+                            y: this._mousemoveEvent.y,
+                        });
+                    }
+                    if (this.hasEvent(this._mesh_Down, ["leftclick"]) && e.button === 0) {
+                        dispatchObjectEvent(this._mesh_Down, {
+                            e: this._mouseEvent,
+                            ...intersection,
+                            renderer: this._renderer,
+                            camera: this._camera,
+                            object: intersection.object,
+                            type: "leftclick",
+                            offsetX: this._mousemoveEvent.offsetX,
+                            offsetY: this._mousemoveEvent.offsetY,
+                            x: this._mousemoveEvent.x,
+                            y: this._mousemoveEvent.y,
+                        });
+                    }
+                    if (this.hasEvent(this._mesh_Down, ["rightclick"]) &&
+                        e.button === 2) {
+                        dispatchObjectEvent(this._mesh_Down, {
+                            e: this._mouseEvent,
+                            ...intersection,
+                            renderer: this._renderer,
+                            camera: this._camera,
+                            object: intersection.object,
+                            type: "rightclick",
+                            offsetX: this._mousemoveEvent.offsetX,
+                            offsetY: this._mousemoveEvent.offsetY,
+                            x: this._mousemoveEvent.x,
+                            y: this._mousemoveEvent.y,
+                        });
+                    }
+                }
+                else if (this._click_num > 1) {
+                    if (this.hasEvent(this._mesh_Down, ["dbclick"]) &&
+                        new Date().valueOf() - this._click_num > 1 &&
+                        e.button === 0) {
+                        dispatchObjectEvent(this._mesh_Down, {
+                            e: this._mouseEvent,
+                            ...intersection,
+                            renderer: this._renderer,
+                            camera: this._camera,
+                            object: intersection.object,
+                            type: "dbclick",
+                            offsetX: this._mousemoveEvent.offsetX,
+                            offsetY: this._mousemoveEvent.offsetY,
+                            x: this._mousemoveEvent.x,
+                            y: this._mousemoveEvent.y,
+                        });
+                    }
+                }
+            }
+            else {
+                if (this.hasEvent(this._mesh_Down, ["click"])) {
+                    dispatchObjectEvent(this._mesh_Down, {
+                        e: this._mouseEvent,
+                        ...intersection,
+                        renderer: this._renderer,
+                        camera: this._camera,
+                        object: intersection.object,
+                        type: "click",
+                        offsetX: this._mousemoveEvent.offsetX,
+                        offsetY: this._mousemoveEvent.offsetY,
+                        x: this._mousemoveEvent.x,
+                        y: this._mousemoveEvent.y,
+                    });
+                }
+                if (this.hasEvent(this._mesh_Down, ["leftclick"]) && e.button === 0) {
+                    dispatchObjectEvent(this._mesh_Down, {
+                        e: this._mouseEvent,
+                        ...intersection,
+                        renderer: this._renderer,
+                        camera: this._camera,
+                        object: intersection.object,
+                        type: "leftclick",
+                        offsetX: this._mousemoveEvent.offsetX,
+                        offsetY: this._mousemoveEvent.offsetY,
+                        x: this._mousemoveEvent.x,
+                        y: this._mousemoveEvent.y,
+                    });
+                }
+                if (this.hasEvent(this._mesh_Down, ["rightclick"]) && e.button === 2) {
+                    dispatchObjectEvent(this._mesh_Down, {
+                        e: this._mouseEvent,
+                        ...intersection,
+                        renderer: this._renderer,
+                        camera: this._camera,
+                        object: intersection.object,
+                        type: "rightclick",
+                        offsetX: this._mousemoveEvent.offsetX,
+                        offsetY: this._mousemoveEvent.offsetY,
+                        x: this._mousemoveEvent.x,
+                        y: this._mousemoveEvent.y,
+                    });
+                }
+            }
+            this._click_num = 0;
+        }
+    });
+    /** 设置 Points（点云）拾取阈值（世界单位），数值越大越容易点中。
+     *  全景纹理标记改用 Points 后，通过它调节点击命中范围。 */
+    setPointsThreshold(threshold) {
+        this._raycaster.params.Points.threshold = threshold;
+    }
+    /** 移除 canvas 上的所有鼠标/指针事件监听（渲染器销毁时调用）。
+     *  注：mouseenter 为内联匿名监听，销毁时 canvas 已脱离 DOM，无需显式移除。 */
+    dispose() {
+        const dom = this._renderer.domElement;
+        dom.removeEventListener("mouseleave", this._mouseleave, true);
+        dom.removeEventListener("mousemove", this._mousemove, true);
+        dom.removeEventListener("pointerdown", this._mousedown, true);
+        dom.removeEventListener("pointerup", this._mouseup, true);
+    }
+}