three-base 2.0.142 → 2.0.166

package/lensflare/LensFlare.d.ts

@@ -1,39 +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 {};
+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 {};