@terra.gl/core 0.0.1-alpha.47 → 0.0.1-alpha.49

package/dist/assets/terra.css

@@ -89,8 +89,8 @@
   border-right: 8px solid transparent;
   border-top: 9px solid rgba(255, 255, 255, 0.8);
   /* 继承毛玻璃效果 */
-  backdrop-filter: blur(20px) saturate(180%);
-  -webkit-backdrop-filter: blur(20px) saturate(180%);
+  /* backdrop-filter: blur(20px) saturate(180%);
+  -webkit-backdrop-filter: blur(20px) saturate(180%); */
   pointer-events: none;
 }
 

package/dist/index.d.ts

@@ -448,6 +448,8 @@ export declare interface BasicPointStyle extends BaseStyle {
     size: number;
     /** 是否发光 */
     glow?: boolean;
+    /** 是否随距离衰减 */
+    sizeAttenuation?: boolean;
 }
 
 /** 类选项类型 */
@@ -1160,6 +1162,18 @@ declare abstract class Feature extends Feature_base implements ICollidable {
      * @returns Promise<void> | void
      */
     abstract _toThreeJSGeometry(): Promise<void> | void;
+    /**
+     * 快速更新几何体顶点位置（不重建整个几何体）
+     *
+     * @description
+     * 用于拖拽、编辑等实时交互场景，仅更新顶点位置而不销毁重建几何体。
+     * 子类可以重写此方法以实现特定的快速更新逻辑。
+     * 默认实现会调用完整的_toThreeJSGeometry方法。
+     *
+     * @virtual
+     * @returns void
+     */
+    protected _updateGeometryPositions(): void;
     /**
      * 设置样式
      *
@@ -1237,6 +1251,20 @@ declare abstract class Feature extends Feature_base implements ICollidable {
      * @returns 地图实例或null
      */
     getMap(): Map_2 | null;
+    /**
+     * 设置要素坐标（地理坐标）
+     * @param coordinates 经纬度坐标
+     */
+    setCoordinates(coordinates: any): this;
+    /**
+     * 坐标变化后的内部处理
+     * @param fastUpdate - 是否使用快速更新模式（仅更新顶点位置，不重建几何体）
+     */
+    protected _onPositionChanged(fastUpdate?: boolean): void;
+    /**
+     * 获取要素中心点（地理坐标）
+     */
+    getCenter(): [number, number];
     /**
      * 绑定到图层（内部使用）
      *
@@ -1438,6 +1466,10 @@ declare type FeatureOptions = {
     };
     /** 旋转角度（弧度） */
     rotateAngle?: number;
+    /** 是否可拖拽（默认false） */
+    draggable?: boolean;
+    /** 是否可编辑（默认false） */
+    editable?: boolean;
 };
 
 /**
@@ -2204,7 +2236,7 @@ export declare class Label extends Point_3 {
      * 创建标签要素
      * @param options 标签配置选项
      */
-    constructor(options: MakerOptions_2);
+    constructor(options: MarkerOptions_2);
     /**
      * 将要素转换为Three.js几何体
      * @returns Promise<void>
@@ -2213,6 +2245,13 @@ export declare class Label extends Point_3 {
      * 根据样式配置创建文本标签几何体
      */
     _toThreeJSGeometry(): Promise<void>;
+    /**
+     * 快速更新几何体顶点位置（不重建整个几何体）
+     *
+     * @description
+     * 用于拖拽、编辑等实时交互场景，仅更新Label的位置而不销毁重建几何体。
+     */
+    protected _updateGeometryPositions(): void;
     /**
      * 创建标签对象
      * @param style 样式配置
@@ -2278,6 +2317,13 @@ export declare interface LabelStyle extends BaseStyle {
     fixedSize?: number;
     /** 屏幕空间大小，语义为在屏幕上的目标高度（CSS 像素） */
     screenSpaceSize?: number;
+    /** 文本偏移 */
+    textOffset?: {
+        x: number;
+        y: number;
+    };
+    /** 整体锚点 */
+    anchor?: [number, number];
 }
 
 /**
@@ -2469,7 +2515,7 @@ declare const Layer_base: {
         proxyOptions(): /*elided*/ any;
         callInitHooks(): /*elided*/ any;
         setOptions(options: ClassOptions): /*elided*/ any;
-        config(conf?: string | ClassOptions, value?: any): /*elided*/ any | ClassOptions;
+        config(conf?: string | ClassOptions, value?: any): ClassOptions | /*elided*/ any;
         onConfig(_conf: ClassOptions): void;
         _visitInitHooks(proto: {
             _initHooks: any;
@@ -2655,6 +2701,14 @@ export declare class LineString extends Line {
      * 根据样式配置创建线几何体，并进行坐标转换
      */
     _toThreeJSGeometry(): Promise<void>;
+    /**
+     * 快速更新几何体顶点位置（不重建整个几何体）
+     *
+     * @description
+     * 用于拖拽、编辑等实时交互场景，仅更新Line2的顶点位置而不销毁重建几何体。
+     * 这比完整重建快得多，并且能保持feature在拖拽过程中可见。
+     */
+    protected _updateGeometryPositions(): void;
     /**
      * 创建线对象
      * @param style 样式配置
@@ -2754,109 +2808,6 @@ declare enum LODAction {
     remove = 2
 }
 
-/**
- * 标记点要素类
- *
- * @description
- * 表示3D场景中的标记点要素，继承自Point类
- * 提供多种标记点样式支持：
- * - 基础点样式
- * - 图标点样式
- * - 带标签的图标点样式
- *
- * @extends Point
- */
-export declare class Maker extends Point_3 {
-    /** 要素类型标识 */
-    _type: string;
-    /**
-     * 创建标记点要素实例
-     *
-     * @param options - 标记点配置选项
-     */
-    constructor(options: MakerOptions);
-    /**
-     * 将要素转换为Three.js几何体
-     *
-     * @description
-     * 根据样式配置创建标记点几何体，并进行坐标转换
-     *
-     * @returns Promise<void>
-     */
-    _toThreeJSGeometry(): Promise<void>;
-    /**
-     * 创建标记点对象
-     *
-     * @description
-     * 支持以下样式类型：
-     * - 'basic-point': 基础点样式
-     * - 'icon-point': 图标点样式
-     * - 'icon-label-point': 带标签的图标点样式
-     *
-     * @param style - 样式配置
-     * @returns 创建的标记点对象
-     * @throws 如果样式类型不支持会抛出错误
-     */
-    _createObject(style: Style): Promise<Object3D>;
-    /**
-     * 计算碰撞检测用的屏幕空间包围盒（根据不同类型使用不同的计算策略）
-     *
-     * @description
-     * 重写父类方法，根据标记点的具体类型（Sprite、Mesh等）使用不同的计算策略
-     * 提供更精确的包围盒计算
-     *
-     * @param camera - 当前相机
-     * @param renderer - 渲染器实例
-     * @returns 包围盒信息或null（如果计算失败）
-     */
-    _calculateCollisionBoundingBox(camera: Camera, renderer: WebGLRenderer): {
-        width: number;
-        height: number;
-        offsetX: number;
-        offsetY: number;
-    } | null;
-    /**
-     * 计算Sprite的屏幕空间包围盒 - 基于实际显示
-     *
-     * @description
-     * 针对Sprite类型的标记点进行精确的包围盒计算，
-     * 基于Sprite的缩放比例估算实际屏幕尺寸
-     *
-     * @param sprite - Sprite对象
-     * @returns 包围盒信息或null（如果计算失败）
-     * @private
-     */
-    private _calculateSpriteBoundingBox;
-    /**
-     * 获取备用的简单包围盒
-     *
-     * @description
-     * 当精确计算失败时，根据样式类型返回不同的默认尺寸
-     *
-     * @returns 默认包围盒信息
-     */
-    _getFallbackBoundingBox(): {
-        width: number;
-        height: number;
-        offsetX: number;
-        offsetY: number;
-    };
-}
-
-/**
- * 标记点要素配置选项
- *
- * @extends PointOptions
- */
-export declare type MakerOptions = PointOptions & {};
-
-/**
- * 标签要素配置选项
- *
- * @extends PointOptions
- */
-declare type MakerOptions_2 = PointOptions & {};
-
 /**
  * 地图主类，继承自事件混入和基础混入
  */
@@ -2914,7 +2865,7 @@ declare class Map extends Map_base {
      */
     static addOnLoadHook(fn: string | ((this: Map, ...args: any[]) => void), ...args: any[]): typeof Map;
     /**
-     * 内部方法：调用所有加载钩子函数
+     * 内部方法:调用所有加载钩子函数
      */
     _callOnLoadHooks(): void;
     /**
@@ -3137,7 +3088,7 @@ declare class Map extends Map_base {
             proxyOptions(): /*elided*/ any;
             callInitHooks(): /*elided*/ any;
             setOptions(options: ClassOptions): /*elided*/ any;
-            config(conf?: string | ClassOptions, value?: any): /*elided*/ any | ClassOptions;
+            config(conf?: string | ClassOptions, value?: any): ClassOptions | /*elided*/ any;
             onConfig(_conf: ClassOptions): void;
             _visitInitHooks(proto: {
                 _initHooks: any;
@@ -3346,6 +3297,117 @@ declare class Map extends Map_base {
      */
     declare type MapToolOptions = ClassOptions_2 & {};
 
+    /**
+     * 标记点要素类
+     *
+     * @description
+     * 表示3D场景中的标记点要素，继承自Point类
+     * 提供多种标记点样式支持：
+     * - 基础点样式
+     * - 图标点样式
+     * - 带标签的图标点样式
+     *
+     * @extends Point
+     */
+    export declare class Marker extends Point_3 {
+        /** 要素类型标识 */
+        _type: string;
+        /**
+         * 创建标记点要素实例
+         *
+         * @param options - 标记点配置选项
+         */
+        constructor(options: MarkerOptions);
+        /**
+         * 将要素转换为Three.js几何体
+         *
+         * @description
+         * 根据样式配置创建标记点几何体，并进行坐标转换
+         *
+         * @returns Promise<void>
+         */
+        _toThreeJSGeometry(): Promise<void>;
+        /**
+         * 快速更新几何体顶点位置（不重建整个几何体）
+         *
+         * @description
+         * 用于拖拽、编辑等实时交互场景，仅更新Marker的位置而不销毁重建几何体。
+         * 这比完整重建快得多，并且能保持feature在拖拽过程中可见。
+         */
+        protected _updateGeometryPositions(): void;
+        /**
+         * 创建标记点对象
+         *
+         * @description
+         * 支持以下样式类型：
+         * - 'basic-point': 基础点样式
+         * - 'icon-point': 图标点样式
+         * - 'icon-label-point': 带标签的图标点样式
+         *
+         * @param style - 样式配置
+         * @returns 创建的标记点对象
+         * @throws 如果样式类型不支持会抛出错误
+         */
+        _createObject(style: Style): Promise<Object3D>;
+        /**
+         * 计算碰撞检测用的屏幕空间包围盒（根据不同类型使用不同的计算策略）
+         *
+         * @description
+         * 重写父类方法，根据标记点的具体类型（Sprite、Mesh等）使用不同的计算策略
+         * 提供更精确的包围盒计算
+         *
+         * @param camera - 当前相机
+         * @param renderer - 渲染器实例
+         * @returns 包围盒信息或null（如果计算失败）
+         */
+        _calculateCollisionBoundingBox(camera: Camera, renderer: WebGLRenderer): {
+            width: number;
+            height: number;
+            offsetX: number;
+            offsetY: number;
+        } | null;
+        /**
+         * 计算Sprite的屏幕空间包围盒 - 基于实际显示
+         *
+         * @description
+         * 针对Sprite类型的标记点进行精确的包围盒计算，
+         * 基于Sprite的缩放比例估算实际屏幕尺寸
+         *
+         * @param sprite - Sprite对象
+         * @returns 包围盒信息或null（如果计算失败）
+         * @private
+         */
+        private _calculateSpriteBoundingBox;
+        /**
+         * 获取备用的简单包围盒
+         *
+         * @description
+         * 当精确计算失败时，根据样式类型返回不同的默认尺寸
+         *
+         * @returns 默认包围盒信息
+         */
+        _getFallbackBoundingBox(): {
+            width: number;
+            height: number;
+            offsetX: number;
+            offsetY: number;
+        };
+    }
+
+    /**
+     * 标记点要素配置选项
+     *
+     * @extends PointOptions
+     */
+    export declare type MarkerOptions = PointOptions & {};
+
+    /**
+     * 标签要素配置选项
+     *
+     * @extends PointOptions
+     */
+    declare type MarkerOptions_2 = PointOptions & {};
+
     /**
      * Martini网格瓦片生成器
      * @description 基于RTIN（Right-Triangulated Irregular Networks）方法的高度图瓦片生成器
@@ -3928,6 +3990,14 @@ declare class Map extends Map_base {
          * @abstract
          */
         _toThreeJSGeometry(): void;
+        /**
+         * 快速更新几何体顶点位置（不重建整个几何体）
+         *
+         * @description
+         * 用于编辑等实时交互场景，仅更新点的位置而不销毁重建几何体。
+         * 这比完整重建快得多，并且能保持feature在编辑过程中可见。
+         */
+        protected _updateGeometryPositions(): void;
         /**
          * 创建基础点几何体
          * @returns Points实例
@@ -4010,6 +4080,15 @@ declare class Map extends Map_base {
          * 根据样式配置创建多边形几何体，并进行坐标转换
          */
         _toThreeJSGeometry(): Promise<void>;
+        /**
+         * 快速更新几何体顶点位置（不重建整个几何体）
+         *
+         * @description
+         * 用于拖拽、编辑等实时交互场景。
+         * 对于basic-polygon类型，实现快速更新避免重建；
+         * 对于复杂类型（extrude/water），仍然调用完整重建。
+         */
+        protected _updateGeometryPositions(): void;
         /**
          * 创建多边形对象
          * @param style 样式配置
@@ -5723,7 +5802,7 @@ declare class Map extends Map_base {
      * Three.js场景初始化类
      * @extends EventDispatcher<ViewerEventMap>
      */
-    export declare class Viewer extends EventDispatcher<ViewerEventMap> {
+    export declare class Viewer extends ViewerBase {
         /** 场景对象 */
         readonly scene: Scene;
         /** WebGL渲染器 */
@@ -5901,6 +5980,11 @@ declare class Map extends Map_base {
          * @throws 当center或cameraCoord参数无效时静默返回，不抛出异常
          */
         flyToAdvanced(options: FlyToOptions): void;
+        /**
+         * 配置更新回调
+         * 当调用 viewer.config() 更新配置时，会触发此方法
+         */
+        onConfig(conf: ViewerOptions): void;
         /**
          * 飞行到指定点，自动计算相机位置
          * @param center 目标点的经纬度坐标
@@ -5966,6 +6050,42 @@ declare class Map extends Map_base {
         private _disposeMaterial;
     }
 
+    declare const ViewerBase: {
+        new (...args: any[]): {
+            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[]): {
+            [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): ClassOptions | /*elided*/ any;
+            onConfig(_conf: ClassOptions): void;
+            _visitInitHooks(proto: {
+                _initHooks: any;
+            }): void;
+        };
+        mergeOptions(options: ClassOptions): /*elided*/ any & {
+            new (): EventDispatcher<ViewerEventMap>;
+        };
+        addInitHook(fn: Function | string, ...args: any[]): /*elided*/ any & {
+            new (): EventDispatcher<ViewerEventMap>;
+        };
+        include(...sources: any[]): /*elided*/ any & {
+            new (): EventDispatcher<ViewerEventMap>;
+        };
+    } & {
+        new (): EventDispatcher<ViewerEventMap>;
+    };
+
     /**
      * Viewer事件映射接口
      * @extends Object3DEventMap
@@ -5987,6 +6107,8 @@ declare class Map extends Map_base {
         stencil?: boolean;
         /** 是否使用对数深度缓冲区，默认为true */
         logarithmicDepthBuffer?: boolean;
+        /** 是否可拖拽平移，默认为 true */
+        draggable?: boolean;
         /** 天空盒配置 */
         skybox?: {
             /** 天空盒图片路径 */