three-base 2.0.137 → 2.0.142

package/{keyContorls.js → keyControls.js}

@@ -1,98 +1,101 @@
-/*
- * @Author: xiaosihan
- * @Date: 2022-03-20 14:48:33
- * @Last Modified by: xiaosihan
- * @Last Modified time: 2022-09-30 00:12:28
- */
-import { throttle } from "lodash";
-import { EventDispatcher, Vector3 } from "three";
-import { generateUUID } from "three/src/math/MathUtils";
-/**
- * 键盘 使用 ↑↓←→ 控制 x z 方向, 小键盘 1 0 控制 y 方向
- *
- * @class KeyContorls
- * @extends {EventDispatcher}
- */
-class KeyContorls extends EventDispatcher {
-    constructor() {
-        super();
-        this.addEvent();
-    }
-    uuid = generateUUID();
-    direction = new Vector3(0, 0, 0);
-    // 添加事件需要由外部实现
-    add(e) {
-        this.dispatchEvent({ ...e, type: "add" });
-    }
-    // 删除事件
-    delete(e) {
-        this.dispatchEvent({ ...e, type: "delete" });
-    }
-    // 回车按钮
-    enter(e) {
-        this.dispatchEvent({ ...e, type: "enter" });
-    }
-    keyDown = (e) => {
-        switch (e.keyCode) {
-            case 46: // 删除按钮
-                this.delete(e);
-                return;
-            case 13: // 回车按钮
-                this.enter(e);
-                return;
-            case 97: // 小键盘1
-                this.direction.set(0, 1, 0);
-                break;
-            case 96: // 小键盘0
-                this.direction.set(0, -1, 0);
-                break;
-            case 35: // 
-                this.direction.set(0, 0.001, 0);
-                break;
-            case 45:
-                this.direction.set(0, -0.001, 0);
-                break;
-            case 38: // 前
-                this.direction.set(0, 0, -1);
-                break;
-            case 37: // 后
-                this.direction.set(-1, 0, 0);
-                break;
-            case 40: // 左
-                this.direction.set(0, 0, 1);
-                break;
-            case 39: // 右
-                this.direction.set(1, 0, 0);
-                break;
-            default:
-                return;
-        }
-        if (e.shiftKey) {
-            this.direction.multiplyScalar(0.001);
-        }
-        if (e.ctrlKey) {
-            this.direction.multiplyScalar(0.1);
-        }
-        this.dispatchEvent({
-            type: "change",
-            direction: this.direction
-        });
-    };
-    _listeners;
-    // 节流 删除事件监听
-    removeEvent = throttle((type) => {
-        this._listeners = undefined;
-    }, 1000, { trailing: false });
-    addEventListener(type, listener) {
-        this.removeEvent(type);
-        super.addEventListener(type, listener);
-    }
-    addEvent() {
-        document.addEventListener("keydown", this.keyDown);
-    }
-    dispose() {
-        document.removeEventListener("keydown", this.keyDown);
-    }
-}
-const keyContorls = new KeyContorls();
-export default keyContorls;
+/*
+ * @Author: xiaosihan
+ * @Date: 2022-03-20 14:48:33
+ * @Last Modified by: xiaosihan
+ * @Last Modified time: 2022-09-30 00:12:28
+ */
+import { throttle } from "lodash";
+import { EventDispatcher, Vector3 } from "three";
+import { MathUtils } from "three";
+const { generateUUID } = MathUtils;
+/**
+ * 键盘 使用 ↑↓←→ 控制 x z 方向, 小键盘 1 0 控制 y 方向
+ *
+ * @class KeyControls
+ * @extends {EventDispatcher<KeyControlsEventTypeMap>}
+ */
+class KeyControls extends EventDispatcher {
+    constructor() {
+        super();
+        this.addEvent();
+    }
+    uuid = generateUUID();
+    direction = new Vector3(0, 0, 0);
+    _listeners;
+    // 添加事件需要由外部实现
+    add(e) {
+        this.dispatchEvent({ ...e, type: "add" });
+    }
+    // 删除事件
+    delete(e) {
+        this.dispatchEvent({ ...e, type: "delete" });
+    }
+    // 回车按钮
+    enter(e) {
+        this.dispatchEvent({ ...e, type: "enter" });
+    }
+    keyDown = (e) => {
+        switch (e.keyCode) {
+            case 46: // 删除按钮
+                this.delete(e);
+                return;
+            case 13: // 回车按钮
+                this.enter(e);
+                return;
+            case 97: // 小键盘1
+                this.direction.set(0, 1, 0);
+                break;
+            case 96: // 小键盘0
+                this.direction.set(0, -1, 0);
+                break;
+            case 35: // 
+                this.direction.set(0, 0.001, 0);
+                break;
+            case 45:
+                this.direction.set(0, -0.001, 0);
+                break;
+            case 38: // 前
+                this.direction.set(0, 0, -1);
+                break;
+            case 37: // 后
+                this.direction.set(-1, 0, 0);
+                break;
+            case 40: // 左
+                this.direction.set(0, 0, 1);
+                break;
+            case 39: // 右
+                this.direction.set(1, 0, 0);
+                break;
+            default:
+                return;
+        }
+        if (e.shiftKey) {
+            this.direction.multiplyScalar(0.001);
+        }
+        if (e.ctrlKey) {
+            this.direction.multiplyScalar(0.1);
+        }
+        this.dispatchEvent({
+            type: "change",
+            direction: this.direction
+        });
+    };
+    // 节流 删除事件监听
+    removeEvent = throttle((type) => {
+        this._listeners = undefined;
+    }, 1000, { trailing: false });
+    addEventListener(type, listener) {
+        this.removeEvent(type);
+        super.addEventListener(type, listener);
+    }
+    addEvent() {
+        document.addEventListener("keydown", this.keyDown);
+    }
+    dispose() {
+        document.removeEventListener("keydown", this.keyDown);
+    }
+}
+const keyControls = new KeyControls();
+window.keyControls = keyControls;
+export { KeyControls, keyControls };
+export default keyControls;

package/keyControls.ts

@@ -0,0 +1,107 @@
+/*
+ * @Author: xiaosihan
+ * @Date: 2022-03-20 14:48:33
+ * @Last Modified by: xiaosihan
+ * @Last Modified time: 2022-09-30 00:12:28
+ */
+import { throttle } from "lodash";
+import { EventDispatcher, EventListener, Vector3 } from "three";
+import { MathUtils } from "three";
+const { generateUUID } = MathUtils;
+import type { KeyControlsEventTypeMap, KeyAddEvent, KeyDeleteEvent, KeyEnterEvent } from "./EventMap";
+
+/**
+ * 键盘 使用 ↑↓←→ 控制 x z 方向, 小键盘 1 0 控制 y 方向
+ *
+ * @class KeyControls
+ * @extends {EventDispatcher<KeyControlsEventTypeMap>}
+ */
+class KeyControls extends EventDispatcher<KeyControlsEventTypeMap> {
+    constructor() {
+        super();
+        this.addEvent();
+    }
+    uuid: string = generateUUID();
+    direction: Vector3 = new Vector3(0, 0, 0);
+    _listeners?: {
+        [key: string]: Array<(event: { type: string }) => void>;
+    };
+    // 添加事件需要由外部实现
+    add(e: KeyAddEvent): void {
+        this.dispatchEvent({ ...e, type: "add" });
+    }
+    // 删除事件
+    delete(e: KeyboardEvent | KeyDeleteEvent): void {
+        this.dispatchEvent({ ...e, type: "delete" });
+    }
+    // 回车按钮
+    enter(e: KeyboardEvent | KeyEnterEvent): void {
+        this.dispatchEvent({ ...e, type: "enter" });
+    }
+    keyDown = (e: KeyboardEvent): void => {
+        switch (e.keyCode) {
+            case 46: // 删除按钮
+                this.delete(e);
+                return;
+            case 13: // 回车按钮
+                this.enter(e);
+                return;
+            case 97: // 小键盘1
+                this.direction.set(0, 1, 0);
+                break;
+            case 96: // 小键盘0
+                this.direction.set(0, -1, 0);
+                break;
+            case 35: // 
+                this.direction.set(0, 0.001, 0);
+                break;
+            case 45:
+                this.direction.set(0, -0.001, 0);
+                break;
+            case 38: // 前
+                this.direction.set(0, 0, -1);
+                break;
+            case 37: // 后
+                this.direction.set(-1, 0, 0);
+                break;
+            case 40: // 左
+                this.direction.set(0, 0, 1);
+                break;
+            case 39: // 右
+                this.direction.set(1, 0, 0);
+                break;
+            default:
+                return;
+        }
+        if (e.shiftKey) {
+            this.direction.multiplyScalar(0.001);
+        }
+        if (e.ctrlKey) {
+            this.direction.multiplyScalar(0.1);
+        }
+        this.dispatchEvent({
+            type: "change",
+            direction: this.direction
+        });
+    };
+    // 节流 删除事件监听
+    removeEvent = throttle((type: string): void => {
+        this._listeners = undefined;
+    }, 1000, { trailing: false });
+    addEventListener<T extends string>(type: T, listener: EventListener<{}, T, this>): void {
+        this.removeEvent(type);
+        super.addEventListener(type, listener);
+    }
+    addEvent(): void {
+        document.addEventListener("keydown", this.keyDown);
+    }
+    dispose(): void {
+        document.removeEventListener("keydown", this.keyDown);
+    }
+}
+const keyControls = new KeyControls();
+
+(window as unknown as Record<string, unknown>).keyControls = keyControls;
+
+export { KeyControls, keyControls };
+export default keyControls;

package/lensflare/LensFlare.d.ts

@@ -0,0 +1,39 @@
+import { BufferGeometry, Mesh } from "three";
+import { LensflareElement } from "three/examples/jsm/objects/Lensflare.js";
+import { Object3D, WebGLRenderer } from "three";
+/**
+ * 屏幕叠加入口：渲染器在最终画面输出到屏幕后调用一次，
+ * 把所有本帧可见的 LensFlare 鬼影以加色混合叠加到当前屏幕帧缓冲。
+ * 仅当 renderer 当前渲染目标为屏幕（null）时生效；中间后处理 target 调用会被忽略。
+ * 不依赖具体渲染器类型（只要是 three WebGLRenderer），LensFlare 与 ThreeBase 零耦合。
+ */
+export declare function flushLensflareOverlays(renderer: WebGLRenderer, camera: any): void;
+/** 内联 fork 自 three r167 的 Lensflare 主类（去除了屏幕外整体 cull）。
+ *  仅在官方实现上做了两处改动：
+ *   1) 移除 `if ( validArea.containsPoint(...) )` 对鬼影渲染的整体包裹，改为始终渲染；
+ *   2) 新增 occlusionForceVisible uniform，光源在屏幕外时置 1 强制可见。 */
+declare class BaseLensflare extends Mesh {
+    static Geometry: BufferGeometry;
+    isLensflare: boolean;
+    addElement: (element: LensflareElement) => void;
+    dispose: () => void;
+    /** 屏幕叠加：由模块级 flushLensflareOverlays() 在渲染器输出屏幕后统一调用，把鬼影画到当前帧缓冲。 */
+    renderScreenOverlay: (renderer: WebGLRenderer, camera: any) => void;
+    constructor();
+}
+export interface LensFlareOptions {
+    /** 主光点/鬼影染色（默认橙色 "#ff9933"） */
+    color?: string;
+    /** 主光点屏幕像素尺寸（默认 700，与官方示例一致） */
+    mainSize?: number;
+    /** 渲染器实例：传入后提前注册屏幕叠加监听（不传则在首次渲染时自动从 renderer 取得）。
+     *  组件自身监听 renderer 的 afterRender，仅在渲染目标为屏幕时叠加鬼影，与具体渲染框架（如 ThreeBase）彻底解耦。 */
+    renderer?: WebGLRenderer;
+}
+/** 对外暴露的镜头光晕组件：fork 自 three 的 Lensflare，已去除「光源出屏幕整串消失」的限制。 */
+export default class LensFlare extends BaseLensflare {
+    constructor(opts?: LensFlareOptions);
+    /** 把光晕挂到某个光源（或任意 Object3D）上，使其出现在该对象的世界坐标处 */
+    attachTo(target: Object3D): this;
+}
+export {};