@terra.gl/core 0.0.1-alpha.35 → 0.0.1-alpha.40

package/dist/index.d.ts

@@ -2,15 +2,20 @@ import { AmbientLight } from 'three';
 import { BaseEvent } from 'three';
 import { BufferGeometry } from 'three';
 import { Camera } from 'three';
+import { ClassOptions } from '../core/mixins';
 import { Clouds } from '@pmndrs/vanilla';
 import { Color } from 'three';
+import { default as default_2 } from '../handler/Handler';
 import { DirectionalLight } from 'three';
+import { EventClass as EventClass_2 } from '..';
+import { EventClass as EventClass_3 } from '../..';
 import { EventDispatcher } from 'three';
 import { Group } from 'three';
 import { Intersection } from 'three';
 import { Line2 } from 'three-stdlib';
 import { LineString as LineString_2 } from 'geojson';
 import { LoadingManager } from 'three';
+import { LocationInfo as LocationInfo_2 } from './util';
 import { MapControls } from 'three-stdlib';
 import { Material } from 'three';
 import { Matrix4 } from 'three';
@@ -33,6 +38,7 @@ import { Raycaster } from 'three';
 import { Scene } from 'three';
 import { Sprite } from 'three';
 import { Texture } from 'three';
+import { TileLoadingManager as TileLoadingManager_2 } from './LoaderFactory';
 import { Vector2 } from 'three';
 import { Vector3 } from 'three';
 import { WebGLRenderer } from 'three';
@@ -177,6 +183,25 @@ export declare type ArcGisSourceOptions = SourceOptions & {
     style?: string;
 };
 
+/**
+ * 箭头流动线样式
+ */
+export declare interface ArrowLineStyle extends BaseStyle {
+    type: 'arrow-line';
+    /** 箭头颜色 */
+    color?: string | number | Color;
+    /** 线条宽度 */
+    width?: number;
+    /** 箭头长度 */
+    arrowLength?: number;
+    /** 箭头间距 */
+    arrowSpacing?: number;
+    /** 速度因子 */
+    speed?: number;
+    /** 拐角半径 */
+    cornerRadius?: number;
+}
+
 /**
  * 几何体属性类型
  * @description 定义几何体的顶点属性数据结构
@@ -213,9 +238,6 @@ export declare type AttributesType = {
 
 export declare const author: any;
 
-declare class Base {
-}
-
 declare type BaseDrawToolOptions = MapToolOptions & {
     /** 模式名称，例如 'line' / 'polygon' / 'point' */
     mode: string;
@@ -302,6 +324,15 @@ export declare interface BaseStyle {
     depthTest?: boolean;
     depthWrite?: boolean;
     transparent?: boolean;
+    /** 发光配置（可选，配合全局 bloom 后处理） */
+    bloom?: boolean | {
+        /** 是否启用发光（默认 true） */
+        enabled?: boolean;
+        /** 发光强度（默认 1.0） */
+        intensity?: number;
+        /** 发光颜色（默认 '#ffffff'） */
+        color?: string;
+    };
 }
 
 /**
@@ -419,7 +450,7 @@ export declare interface BasicPointStyle extends BaseStyle {
 }
 
 /** 类选项类型 */
-declare type ClassOptions = Record<string, any>;
+declare type ClassOptions_2 = Record<string, any>;
 
 /**
  * 云朵要素配置选项
@@ -1091,6 +1122,8 @@ declare abstract class Feature extends Feature_base implements ICollidable {
     private _isApplyingStyle;
     /** 是否正在初始化几何体 */
     private _isGeometryInitializing;
+    /** 当前发光配置（如果有） */
+    private _bloomConfig?;
     /** 避让相关状态 */
     private _collisionState;
     /** 碰撞检测配置 */
@@ -1135,6 +1168,28 @@ declare abstract class Feature extends Feature_base implements ICollidable {
      * @returns 当前样式或undefined
      */
     getStyle(): Style | undefined;
+    /**
+     * 设置当前要素的发光状态
+     *
+     * @param enabled 是否启用发光
+     * @param options 可选：发光强度和颜色
+     */
+    setBloom(enabled: boolean, options?: {
+        intensity?: number;
+        color?: string;
+    }): this;
+    /**
+     * 获取当前要素的发光配置
+     */
+    getBloom(): {
+        enabled: boolean;
+        intensity: number;
+        color: string;
+    } | undefined;
+    /**
+     * 内部方法：把发光配置应用到 Three 对象上
+     */
+    private _applyBloomToObject;
     /**
      * 应用样式（带重试机制）
      *
@@ -1325,17 +1380,17 @@ declare abstract class Feature extends Feature_base implements ICollidable {
 declare const Feature_base: {
     new (...args: any[]): {
         [key: string]: any;
-        _handlers?: Handler[];
+        _handlers?: default_2[];
         addHandler(name: string | number, handlerClass: new (arg0: /*elided*/ any) => any): /*elided*/ any;
         removeHandler(name: string | number): /*elided*/ any;
         _clearHandlers(): void;
     };
 } & {
     new (...args: any[]): {
-        eventClass: EventClass;
-        on: (type: string, listener: (data?: any) => void) => EventClass;
-        trigger: (type: string, data?: any) => EventClass;
-        off: (type: string, listener: (... /** Three.js几何对象 */args: any[]) => void) => EventClass;
+        eventClass: EventClass_2;
+        on: (type: string, listener: (data?: any) => void) => EventClass_2;
+        trigger: (type: string, data?: any) => EventClass_2;
+        off: (type: string, listener: (...args: any[]) => void) => EventClass_2;
     };
 } & {
     new (...args: any[]): {
@@ -1380,6 +1435,52 @@ declare type FeatureOptions = {
     rotateAngle?: number;
 };
 
+/**
+ * 流动管线样式配置
+ */
+export declare interface FlowLineStyle extends BaseStyle {
+    type: 'flow-tube-line';
+    /** 管道颜色 */
+    color?: string | number | Color;
+    /** 管道半径 */
+    radius: number;
+    /** 径向分段数 */
+    radialSegments?: number;
+    /** 管长分段数 */
+    tubularSegments?: number;
+    /** 速度因子 */
+    speed?: number;
+    /** 条纹宽度 */
+    stripeWidth?: number;
+    /** 条纹间距 */
+    stripeSpacing?: number;
+    /** 条纹颜色 */
+    stripeColor?: string | number | Color;
+    /** 拐角半径 */
+    cornerRadius?: number;
+    /** 是否只显示箭头，隐藏管道 */
+    arrowOnly?: boolean;
+}
+
+/**
+ * 纹理流动线样式配置（发光箭头线等）
+ */
+export declare interface FlowTextureLineStyle extends BaseStyle {
+    type: 'flow-texture-line';
+    /** 线颜色（与纹理颜色相乘，用于整体调色） */
+    color?: string | number | Color;
+    /** 线宽（世界坐标单位） */
+    width?: number;
+    /** 流动纹理 URL，例如箭头贴图 */
+    flowTexture: string;
+    /** 流动速度，越大流动越快 */
+    speed?: number;
+    /** 纹理沿线方向重复次数（控制箭头密度） */
+    repeat?: number;
+    /** 拐角半径（预留，与 FlowLineStyle 含义一致） */
+    cornerRadius?: number;
+}
+
 /**
  * flyTo方法参数接口
  */
@@ -1556,80 +1657,6 @@ export declare function getSafeTileUrlAndBounds(source: ISource, x: number, y: n
     clipBounds: [number, number, number, number];
 };
 
-/**
- * 所有交互Handler类的基类
- *
- * @english
- * Base class for all the interaction handlers
- * @category handler
- * @abstract
- * @protected
- */
-declare abstract class Handler extends Handler_base {
-    target: any;
-    dom?: HTMLElement;
-    _enabled: boolean;
-    constructor(target: any);
-    abstract addHooks(): void;
-    abstract removeHooks(): void;
-    /**
-     * 启用Handler
-     *
-     * @english
-     * Enables the handler
-     */
-    enable(): this;
-    /**
-     * 停用Handler
-     *
-     * @english
-     * Disables the handler
-     */
-    disable(): this;
-    /**
-     * 检查Handler是否启用
-     *
-     * @english
-     * Returns true if the handler is enabled.
-     */
-    enabled(): boolean;
-    /**
-     * 从target上移除Handler
-     *
-     * @english
-     * remove handler from target
-     */
-    remove(): void;
-}
-
-declare const Handler_base: {
-    new (...args: any[]): {
-        eventClass: EventClass;
-        on: (type: string, listener: (data?: any) => void) => EventClass;
-        trigger: (type: string, data?: any) => EventClass;
-        off: (type: string, listener: (...args: any[]) => void) => EventClass;
-    };
-} & {
-    new (...args: any[]): {
-        [x: string]: any;
-        options: any;
-        _isUpdatingOptions?: boolean;
-        _initHooksCalled?: boolean;
-        _initHooks?: Function[];
-        proxyOptions(): /*elided*/ any;
-        callInitHooks(): /*elided*/ any;
-        setOptions(options: ClassOptions): /*elided*/ any;
-        config(conf?: string | ClassOptions, value?: any): /*elided*/ any | ClassOptions;
-        onConfig(_conf: ClassOptions): void;
-        _visitInitHooks(proto: {
-            _initHooks: any;
-        }): void;
-    };
-    mergeOptions(options: ClassOptions): /*elided*/ any & typeof Base;
-    addInitHook(fn: Function | string, ...args: any[]): /*elided*/ any & typeof Base;
-    include(...sources: any[]): /*elided*/ any & typeof Base;
-} & typeof Base;
-
 /**
  * 包围盒接口
  *
@@ -2360,17 +2387,17 @@ declare abstract class Layer extends Layer_base {
 declare const Layer_base: {
     new (...args: any[]): {
         [key: string]: any;
-        _handlers?: Handler[];
+        _handlers?: default_2[];
         addHandler(name: string | number, handlerClass: new (arg0: /*elided*/ any) => any): /*elided*/ any;
         removeHandler(name: string | number): /*elided*/ any;
         _clearHandlers(): void;
     };
 } & {
     new (...args: any[]): {
-        eventClass: EventClass;
-        on: (type: string, listener: (data?: any) => void) => EventClass;
-        trigger: (type: string, data?: any) => EventClass;
-        off: (type: string, listener: (...args: any[]) => void) => EventClass;
+        eventClass: EventClass_2;
+        on: (type: string, listener: (data?: any) => void) => EventClass_2;
+        trigger: (type: string, data?: any) => EventClass_2;
+        off: (type: string, listener: (...args: any[]) => void) => EventClass_2;
     };
 } & {
     new (...args: any[]): {
@@ -2579,6 +2606,13 @@ export declare class LineString extends Line {
      * - 'basic-line': 基础线样式
      */
     _createObject(style: Style): Promise<Object3D>;
+    /**
+     * 更新几何体
+     *
+     * @description
+     * 更新线几何体的顶点坐标，并重新计算边界信息
+     * 自动处理与地图中心的位置关系
+     */
     /**
      * 更新几何体
      *
@@ -2599,7 +2633,7 @@ export declare type LineStringOptions = LineOptions & {};
 /**
  * 面样式联合类型
  */
-export declare type LineStyle = BaseLineStyle | PipelineStyle;
+export declare type LineStyle = BaseLineStyle | PipelineStyle | FlowLineStyle | FlowTextureLineStyle;
 
 /**
  * Factory for loader
@@ -3000,23 +3034,38 @@ declare class Map extends Map_base {
       * @param options 飞行参数对象
       */
      flyToPoint(options: FlyToPointOptions): void;
+     /**
+      * 销毁地图实例，释放所有资源
+      * @description
+      * 该方法会清理以下资源：
+      * 1. 移除所有事件监听器
+      * 2. 清空所有图层
+      * 3. 销毁碰撞引擎
+      * 4. 销毁viewer（包括renderer、scene、controls等）
+      * 5. 清理DOM容器
+      */
+     destroy(): void;
     }
     export { Map_2 as Map }
 
     declare const Map_base: {
         new (...args: any[]): {
             [key: string]: any;
-            _handlers?: Handler[];
+            _handlers?: default_2[];
             addHandler(name: string | number, handlerClass: new (arg0: /*elided*/ any) => any): /*elided*/ any;
             removeHandler(name: string | number): /*elided*/ any;
             _clearHandlers(): void;
         };
     } & {
         new (...args: any[]): {
-            eventClass: EventClass;
-            on: (type: string, listener: (data?: any) => void) => EventClass;
-            trigger: (type: string, data?: any) => EventClass;
-            off: (type: string, listener: (...args: any[]) => void) => EventClass;
+            eventClass: EventClass_2;
+            on: (type: string, listener: (data?: any) => void) => EventClass_2;
+            trigger: (type: string, data?: any) => EventClass_2;
+            off: (type: string, listener: (
+            /**
+             * 创建一个空基类（仅用于混入起点）
+             */
+            ...args: any[]) => void) => EventClass_2;
         };
     } & {
         new (...args: any[]): {
@@ -3206,10 +3255,10 @@ declare class Map extends Map_base {
 
     declare const MapTool_base: {
         new (...args: any[]): {
-            eventClass: EventClass;
-            on: (type: string, listener: (data?: any) => void) => EventClass;
-            trigger: (type: string, data?: any) => EventClass;
-            off: (type: string, listener: (...args: any[]) => void) => EventClass;
+            eventClass: EventClass_3;
+            on: (type: string, listener: (data?: any) => void) => EventClass_3;
+            trigger: (type: string, data?: any) => EventClass_3;
+            off: (type: string, listener: (...args: any[]) => void) => EventClass_3;
         };
     } & {
         new (...args: any[]): {
@@ -3220,14 +3269,14 @@ declare class Map extends Map_base {
             _initHooks?: Function[];
             proxyOptions(): /*elided*/ any;
             callInitHooks(): /*elided*/ any;
-            setOptions(options: ClassOptions): /*elided*/ any;
-            config(conf?: string | ClassOptions, value?: any): ClassOptions | /*elided*/ any;
-            onConfig(_conf: ClassOptions): void;
+            setOptions(options: ClassOptions_2): /*elided*/ any;
+            config(conf?: string | ClassOptions_2, value?: any): ClassOptions_2 | /*elided*/ any;
+            onConfig(_conf: ClassOptions_2): void;
             _visitInitHooks(proto: {
                 _initHooks: any;
             }): void;
         };
-        mergeOptions(options: ClassOptions): /*elided*/ any & typeof EmptyBase;
+        mergeOptions(options: ClassOptions_2): /*elided*/ any & typeof EmptyBase;
         addInitHook(fn: Function | string, ...args: any[]): /*elided*/ any & typeof EmptyBase;
         include(...sources: any[]): /*elided*/ any & typeof EmptyBase;
     } & typeof EmptyBase;
@@ -3235,7 +3284,7 @@ declare class Map extends Map_base {
     /**
      * MapTool 配置项（预留，将来可以扩展）
      */
-    declare type MapToolOptions = ClassOptions & {};
+    declare type MapToolOptions = ClassOptions_2 & {};
 
     /**
      * Martini网格瓦片生成器
@@ -4137,6 +4186,24 @@ declare class Map extends Map_base {
          * @returns 是否应用成功
          */
         private _applyLineStyle;
+        /**
+         * 应用流动管线样式
+         * @param object 目标对象
+         * @returns 是否应用成功
+         */
+        private _applyFlowLineStyle;
+        /**
+         * 应用箭头流动线样式
+         * @param object 目标对象
+         * @returns 是否应用成功
+         */
+        private _applyArrowLineStyle;
+        /**
+         * 应用流动纹理管线样式
+         * @param object 目标对象
+         * @returns 是否应用成功
+         */
+        private _applyFlowTextureLineStyle;
         /**
          * 应用多边形样式
          * @param object 目标对象
@@ -4208,7 +4275,7 @@ declare class Map extends Map_base {
     /**
      * 样式配置联合类型
      */
-    export declare type StyleConfig = PointStyle | BaseLineStyle | PipelineStyle | ModelStyle | CustomStyle | BasePolygonStyle | ExtrudeStyle | WaterStyle | CloudStyle | BaseWaterStyle | LabelStyle | IconLabelStyle;
+    export declare type StyleConfig = PointStyle | BaseLineStyle | PipelineStyle | FlowLineStyle | ArrowLineStyle | FlowTextureLineStyle | ModelStyle | CustomStyle | BasePolygonStyle | ExtrudeStyle | WaterStyle | CloudStyle | BaseWaterStyle | LabelStyle | IconLabelStyle | IconPointStyle | BasicPointStyle;
 
     /**
      * 样式输入类型
@@ -4670,7 +4737,7 @@ declare class Map extends Map_base {
         /** Set vector tile source */
         set vtSource(value: ISource | undefined);
         /** Loader manager */
-        manager: TileLoadingManager;
+        manager: TileLoadingManager_2;
         /**
          * Load getmetry and materail of tile from x, y and z coordinate.
          *
@@ -4852,20 +4919,20 @@ declare class Map extends Map_base {
          * @param geo 地理坐标
          * @returns 地面信息
          */
-        getLocalInfoFromGeo(geo: Vector3): LocationInfo | undefined;
+        getLocalInfoFromGeo(geo: Vector3): LocationInfo_2 | undefined;
         /**
          * 获取指定世界坐标的地面信息
          * @param pos 世界坐标
          * @returns 地面信息
          */
-        getLocalInfoFromWorld(pos: Vector3): LocationInfo | undefined;
+        getLocalInfoFromWorld(pos: Vector3): LocationInfo_2 | undefined;
         /**
          * 获取指定屏幕坐标的地面信息
          * @param camera 相机
          * @param pointer 屏幕坐标
          * @returns 位置信息
          */
-        getLocalInfoFromScreen(camera: Camera, pointer: Vector2): LocationInfo | undefined;
+        getLocalInfoFromScreen(camera: Camera, pointer: Vector2): LocationInfo_2 | undefined;
         /**
          * 获取当前正在下载的瓦片数量
          */
@@ -5484,6 +5551,10 @@ declare class Map extends Map_base {
         /** 是否启用调试模式 */
         private debug;
         private flyTween;
+        /** 后期处理：bloom 管线 */
+        private composer?;
+        private renderPass?;
+        private bloomPass?;
         /**
          * 获取雾效因子
          */
@@ -5665,6 +5736,23 @@ declare class Map extends Map_base {
          */
         getWidthHeight(): number[];
         _createGorund(): Mesh<PlaneGeometry, MeshStandardMaterial, Object3DEventMap>;
+        /**
+         * 销毁viewer实例，释放所有资源
+         * @description
+         * 该方法会清理以下资源：
+         * 1. 停止动画循环
+         * 2. 销毁控制器
+         * 3. 清理场景中的所有对象
+         * 4. 销毁渲染器
+         * 5. 销毁后期处理器
+         * 6. 移除DOM元素
+         */
+        destroy(): void;
+        /**
+         * 销毁材质资源
+         * @param material 要销毁的材质
+         */
+        private _disposeMaterial;
     }
 
     /**
@@ -5731,6 +5819,16 @@ declare class Map extends Map_base {
          * 0 = 正上方俯视，90 = 水平
          */
         polarDeg?: number;
+        /** Bloom 后处理配置（可选） */
+        bloom?: {
+            enabled?: boolean;
+            /** 辉光强度，对应 UnrealBloomPass 的 strength */
+            strength?: number;
+            /** 辉光扩散半径，对应 UnrealBloomPass 的 radius */
+            radius?: number;
+            /** 触发辉光的亮度阈值，对应 UnrealBloomPass 的 threshold */
+            threshold?: number;
+        };
     };
 
     export declare function waitFor(condition: boolean, delay?: number): Promise<void>;