@xingm/vmap-cesium-toolbar 0.0.1 → 0.0.2-alpha.2

package/dist/libs/{CesiumMapHelper.d.ts → CesiumMapDraw.d.ts}

@@ -1,3 +1,4 @@
+import { DrawOptions } from './drawHelper';
 import * as Cesium from "cesium";
 /**
  * Cesium 绘图辅助工具类
@@ -19,19 +20,28 @@ declare class DrawHelper {
     private finishedPointEntities;
     private publicEntities;
     private _doubleClickPending;
-    private currentLineEntity;
-    private currentSegmentLabels;
-    private currentTotalLabel;
+    private drawLine;
+    private drawPolygon;
+    private drawRectangle;
+    private drawCircle;
+    private currentDrawer;
     private screenSpaceEventHandler;
+    private entityClickHandler;
     private onDrawStartCallback;
     private onDrawEndCallback;
     private onEntityRemovedCallback;
+    private onMeasureCompleteCallback;
     private offsetHeight;
+    private originalDepthTestAgainstTerrain;
     /**
      * 构造函数
      * @param viewer Cesium Viewer 实例
      */
     constructor(viewer: Cesium.Viewer);
+    /**
+     * 外部调用：在场景模式（2D/3D）切换后，更新偏移高度并重算已完成实体
+     */
+    handleSceneModeChanged(): void;
     /**
      * 根据场景模式更新偏移高度
      */
@@ -39,15 +49,19 @@ declare class DrawHelper {
     /**
      * 开始绘制线条
      */
-    startDrawingLine(): void;
+    startDrawingLine(options?: DrawOptions): void;
     /**
      * 开始绘制多边形（仅边线）
      */
-    startDrawingPolygon(): void;
+    startDrawingPolygon(options?: DrawOptions): void;
     /**
      * 开始绘制矩形
      */
-    startDrawingRectangle(): void;
+    startDrawingRectangle(options?: DrawOptions): void;
+    /**
+     * 开始绘制圆形
+     */
+    startDrawingCircle(options?: DrawOptions): void;
     /**
      * 内部统一的开始绘制方法
      * @param mode 绘制模式
@@ -128,17 +142,21 @@ declare class DrawHelper {
      * @returns 实体数组
      */
     getFinishedEntities(): Cesium.Entity[];
-    private calculateRectangle;
-    private calculateRectangleArea;
-    private calculatePolygonArea;
-    private calculatePolygonCenter;
     /**
-     * 格式化距离显示
-     * 超过1000m时转换为km，保留两位小数
-     * @param distance 距离（米）
-     * @returns 格式化后的距离字符串
+     * 使用 Canvas 绘制总长文本，生成用于 billboard 的图片
      */
-    private formatDistance;
+    private createTotalLengthBillboardImage;
+    /**
+     * 使用 Canvas 绘制分段长度文本，生成用于 billboard 的图片
+     * 样式与总长保持一致，便于统一视觉
+     */
+    private createSegmentLengthBillboardImage;
+    onMeasureComplete(callback: (result: {
+        type: "line" | "polygon" | "rectangle" | "circle";
+        positions: Cesium.Cartesian3[];
+        distance?: number;
+        areaKm2?: number;
+    }) => void): void;
     /**
      * 设置开始绘制时的回调函数
      * @param callback 回调函数
@@ -154,34 +172,6 @@ declare class DrawHelper {
      * @param callback 回调函数，参数为被移除的实体
      */
     onEntityRemoved(callback: (entity: Cesium.Entity) => void): void;
-    /**
-     * 绘制监控圆形区域
-     * @param longitude 经度
-     * @param latitude 纬度
-     * @param height 高度
-     * @param radius 监控范围半径（米）
-     * @param options 可选配置
-     */
-    drawMonitoringCircle(longitude: number, latitude: number, height: number, radius: number, options?: {
-        borderColor?: string;
-        fillColor?: string;
-        borderWidth?: number;
-        name?: string;
-    }): Cesium.Entity;
-    /**
-     * 绘制垂直线条
-     * @param longitude 经度
-     * @param latitude 纬度
-     * @param height 高度
-     * @param options 可选配置
-     */
-    drawVerticalLine(longitude: number, latitude: number, height: number, options?: {
-        color?: string;
-        width?: number;
-        dashPattern?: number;
-        name?: string;
-        groundHeight?: number;
-    }): Cesium.Entity;
     /**
      * 更新所有已完成实体以适应场景模式变化
      * 当从2D切换到3D或从3D切换到2D时，需要更新实体的高度参考和位置

package/dist/libs/CesiumMapLoader.d.ts

@@ -1,4 +1,4 @@
-import { Terrain, TerrainProvider, Viewer as CesiumViewer } from '../../node_modules/cesium';
+import { Viewer as CesiumViewer, Terrain, TerrainProvider } from '../../node_modules/cesium';
 import * as Cesium from 'cesium';
 interface InitOptions {
     terrain?: Terrain;
@@ -20,6 +20,7 @@ interface InitOptions {
     timeline?: boolean;
     animation?: boolean;
     isFly?: boolean;
+    flyDuration?: number;
     baseLayerPicker?: boolean;
     navigationInstructionsInitiallyVisible?: boolean;
     clock?: Cesium.Clock;
@@ -35,10 +36,15 @@ interface InitOptions {
     resolutionScale?: number;
     orderIndependentTransparency?: boolean;
     shadows?: boolean;
+    depthTestAgainstTerrain?: boolean;
     terrainExaggeration?: number;
     maximumScreenSpaceError?: number;
     maximumNumberOfLoadedTiles?: number;
     token?: string;
+    cesiumToken?: string;
+    success?: () => void;
+    cancel?: () => void;
+    mapCenter?: MapCenter;
 }
 interface MapCenter {
     latitude: number;
@@ -47,7 +53,7 @@ interface MapCenter {
     pitch?: number;
     heading?: number;
 }
-export declare function initCesium(containerId: string, options: InitOptions, mapCenter?: MapCenter): Promise<{
+export declare function initCesium(containerId: string, options: InitOptions, mapCenterOrCesiumToken?: MapCenter | string, cesiumToken?: string): Promise<{
     viewer: CesiumViewer;
     initialCenter: MapCenter;
 }>;

package/dist/libs/CesiumMapModel.d.ts

@@ -13,6 +13,7 @@ export interface ToolbarConfig {
     buttons?: CustomButtonConfig[];
 }
 export interface ButtonConfig {
+    sort?: number;
     id: string;
     icon: string;
     title: string;
@@ -42,6 +43,7 @@ export interface CustomButtonConfig {
     hoverColor?: string;
     activeColor?: string;
     backgroundColor?: string;
+    sort?: number;
     activeIcon?: string | HTMLElement | false;
     callback?: () => void;
     onClick?: (buttonId: string, buttonElement: HTMLElement) => void;
@@ -60,13 +62,14 @@ export interface SearchResult {
     height?: number;
 }
 export interface MeasurementCallback {
+    onMeasurementStart?: (positions?: Cartesian3[]) => void;
     onDistanceComplete?: (positions: Cartesian3[], distance: number) => void;
     onAreaComplete?: (positions: Cartesian3[], area: number) => void;
     onClear?: () => void;
 }
 export interface ZoomCallback {
-    onZoomIn?: (beforeLevel: number, afterLevel: number) => void;
-    onZoomOut?: (beforeLevel: number, afterLevel: number) => void;
+    onZoomIn?: (beforeHeight: number, afterHeight: number, currentLevel: number) => void;
+    onZoomOut?: (beforeHeight: number, afterHeight: number, currentLevel: number) => void;
 }
 export interface MapType {
     id: string;

package/dist/libs/CesiumMapToolbar.d.ts

@@ -10,17 +10,22 @@ export declare class CesiumMapToolbar {
     private container;
     private toolbarElement;
     private config;
-    private searchCallback?;
+    private searchService;
+    private mapLayersService;
+    private notFlyZonesService;
     private measurementCallback?;
     private zoomCallback?;
     private initialCenter?;
-    private isFullscreen;
     private currentMapType;
     TD_Token: string;
     mapTypes: MapType[];
-    private noFlyZoneEntities;
-    private isNoFlyZoneVisible;
+    private isNoFlyZoneChecked;
     private currentGeoWTFS;
+    private measurementService;
+    readonly measurement: {
+        getMeasureMode: () => "none" | "distance" | "area";
+    };
+    private mapController;
     constructor(viewer: Viewer, container: HTMLElement, config?: ToolbarConfig, callbacks?: {
         search?: SearchCallback;
         measurement?: MeasurementCallback;
@@ -58,37 +63,31 @@ export declare class CesiumMapToolbar {
     updateButtonConfig(buttonId: string, config: Partial<CustomButtonConfig>): void;
     /**
      * 添加自定义按钮
+     * @param config 按钮配置，支持 sort 参数控制插入位置
      */
     addCustomButton(config: CustomButtonConfig): void;
     /**
-     * 移除按钮
-     */
-    removeButton(buttonId: string): void;
-    /**
-     * 获取按钮元素
+     * 获取所有按钮配置（包括默认按钮和自定义按钮），并添加 sort 值
      */
-    getButtonElement(buttonId: string): HTMLElement | null;
+    private getAllButtonsWithSort;
     /**
-     * 设置绘图助手回调
+     * 重新构建工具栏按钮
      */
-    private setupDrawHelperCallbacks;
+    private rebuildToolbarButtons;
     /**
-     * 格式化距离显示
-     * 超过1000m时转换为km，保留两位小数
-     * @param distance 距离（米）
-     * @returns 格式化后的距离字符串
+     * 移除按钮
      */
-    private formatDistance;
+    removeButton(buttonId: string): void;
     /**
-     * 计算多边形面积
+     * 获取按钮元素
      */
-    private calculatePolygonArea;
+    private setupDrawHelperCallbacks;
     /**
      * 创建工具栏
      */
     private createToolbar;
     /**
-     * 获取按钮配置
+     * 获取按钮配置（已排序）
      */
     private getButtonConfigs;
     /**
@@ -127,18 +126,6 @@ export declare class CesiumMapToolbar {
      * 处理按钮点击
      */
     private handleButtonClick;
-    /**
-     * 切换搜索功能
-     */
-    private toggleSearch;
-    /**
-     * 显示搜索结果
-     */
-    private displaySearchResults;
-    /**
-     * 选择搜索结果
-     */
-    private selectSearchResult;
     /**
      * 切换测量功能
      */
@@ -151,28 +138,10 @@ export declare class CesiumMapToolbar {
      * 切换2D/3D视图
      */
     private toggle2D3D;
-    /**
-     * 切换图层
-     */
-    private toggleLayers;
-    /**
-     * 切换地图类型
-     */
-    private switchMapType;
     /**
      * 复位到初始位置
      */
     private resetLocation;
-    /**
-     * 获取当前地图层级
-     * @returns 当前层级（1-18）
-     */
-    private getCurrentZoomLevel;
-    /**
-     * 设置地图层级
-     * @param zoomLevel 目标层级（1-18）
-     */
-    private setZoomLevel;
     /**
      * 放大
      */
@@ -181,39 +150,26 @@ export declare class CesiumMapToolbar {
      * 缩小
      */
     private zoomOut;
-    /**
-     * 切换全屏
-     */
-    private toggleFullscreen;
-    /**
-     * 进入全屏
-     */
-    private enterFullscreen;
-    /**
-     * 退出全屏
-     */
-    private exitFullscreen;
     /**
      * 加载并显示机场禁飞区
+     * @deprecated 使用 NotFlyZonesService.showNoFlyZones 代替
      */
     showNoFlyZones(): Promise<void>;
     /**
      * 隐藏机场禁飞区
+     * @deprecated 使用 NotFlyZonesService.hideNoFlyZones 代替
      */
     hideNoFlyZones(): void;
     /**
      * 切换机场禁飞区显示状态
+     * @deprecated 使用 NotFlyZonesService.toggleNoFlyZones 代替
      */
     toggleNoFlyZones(): Promise<void>;
     /**
      * 获取禁飞区显示状态
+     * @deprecated 使用 NotFlyZonesService.getNoFlyZoneVisible 代替
      */
     getNoFlyZoneVisible(): boolean;
-    /**
-     * 自动加载禁飞区（如果默认勾选）
-     * 在创建 toolbar 后自动调用
-     */
-    private autoLoadNoFlyZones;
     /**
      * 销毁工具栏
      */

package/dist/libs/CesiumOverlayService.d.ts

@@ -0,0 +1,111 @@
+import { Viewer, Entity } from '../../node_modules/cesium';
+import { MapMarker, MarkerOptions } from './overlay/MapMarker';
+import { MapLabel, LabelOptions } from './overlay/MapLabel';
+import { MapIcon, IconOptions } from './overlay/MapIcon';
+import { MapSVG, SvgOptions } from './overlay/MapSVG';
+import { MapInfoWindow, InfoWindowOptions } from './overlay/MapInfoWindow';
+import { MapPolyline, PolylineOptions } from './overlay/MapPolyline';
+import { MapPolygon, PolygonOptions } from './overlay/MapPolygon';
+import { MapRectangle, RectangleOptions } from './overlay/MapRectangle';
+import { MapCircle, CircleOptions } from './overlay/MapCircle';
+import { OverlayPosition } from './overlay/types';
+/**
+ * Cesium 覆盖物服务类
+ * 统一管理各种覆盖物工具类
+ */
+export declare class CesiumOverlayService {
+    private viewer;
+    private entities;
+    private overlayMap;
+    private infoWindowContainer;
+    readonly marker: MapMarker;
+    readonly label: MapLabel;
+    readonly icon: MapIcon;
+    readonly svg: MapSVG;
+    readonly infoWindow: MapInfoWindow;
+    readonly polyline: MapPolyline;
+    readonly polygon: MapPolygon;
+    readonly rectangle: MapRectangle;
+    readonly circle: MapCircle;
+    constructor(viewer: Viewer);
+    /**
+     * 初始化信息窗口容器
+     */
+    private initInfoWindowContainer;
+    /**
+     * 设置实体点击处理器
+     */
+    private setupEntityClickHandler;
+    /**
+     * 生成唯一ID
+     */
+    private generateId;
+    /**
+     * 添加 Marker
+     */
+    addMarker(options: MarkerOptions): Entity;
+    /**
+     * 添加 Label
+     */
+    addLabel(options: LabelOptions): Entity;
+    /**
+     * 添加 Icon
+     */
+    addIcon(options: IconOptions): Entity;
+    /**
+     * 添加 SVG
+     */
+    addSvg(options: SvgOptions): Entity;
+    /**
+     * 添加 InfoWindow
+     */
+    addInfoWindow(options: InfoWindowOptions): Entity;
+    /**
+     * 添加 Polyline
+     */
+    addPolyline(options: PolylineOptions): Entity;
+    /**
+     * 添加 Polygon
+     */
+    addPolygon(options: PolygonOptions): Entity;
+    /**
+     * 添加 Rectangle
+     */
+    addRectangle(options: RectangleOptions): Entity;
+    /**
+     * 添加 Circle
+     */
+    addCircle(options: CircleOptions): Entity;
+    /**
+     * 根据ID获取覆盖物
+     */
+    getOverlay(id: string): Entity | undefined;
+    /**
+     * 根据ID删除覆盖物
+     */
+    removeOverlay(id: string): boolean;
+    /**
+     * 删除所有覆盖物
+     */
+    removeAllOverlays(): void;
+    /**
+     * 更新覆盖物位置
+     */
+    updateOverlayPosition(id: string, position: OverlayPosition): boolean;
+    /**
+     * 显示/隐藏覆盖物
+     */
+    setOverlayVisible(id: string, visible: boolean): boolean;
+    /**
+     * 获取所有覆盖物ID
+     */
+    getAllOverlayIds(): string[];
+    /**
+     * 获取所有覆盖物
+     */
+    getAllOverlays(): Entity[];
+    /**
+     * 销毁服务，清理所有资源
+     */
+    destroy(): void;
+}

package/dist/libs/{CesiumMapConfig.d.ts → config/CesiumMapConfig.d.ts}

@@ -1,6 +1,6 @@
-import { Viewer } from '../../node_modules/cesium';
-import { default as DrawHelper } from './CesiumMapHelper';
-import { MapType, ToolbarConfig, SearchCallback, MeasurementCallback, ZoomCallback } from './CesiumMapModel';
+import { Viewer } from '../../../node_modules/cesium';
+import { default as DrawHelper } from '../CesiumMapDraw';
+import { MapType, ToolbarConfig, SearchCallback, MeasurementCallback, ZoomCallback } from '../CesiumMapModel';
 export interface CesiumMapConfig {
     viewer?: Viewer;
     drawHelper?: DrawHelper;

package/dist/libs/drawHelper/BaseDraw.d.ts

@@ -0,0 +1,116 @@
+import { Viewer, Entity, Cartesian3 } from '../../../node_modules/cesium';
+import * as Cesium from "cesium";
+/**
+ * 绘制结果接口
+ */
+export interface DrawResult {
+    entity: Entity | null;
+    type: "line" | "polygon" | "rectangle" | "circle";
+    positions: Cartesian3[];
+    distance?: number;
+    areaKm2?: number;
+}
+/**
+ * 绘制回调接口
+ */
+export interface DrawCallbacks {
+    onDrawStart?: () => void;
+    onDrawEnd?: (entity: Entity | null) => void;
+    onEntityRemoved?: (entity: Entity) => void;
+    onMeasureComplete?: (result: DrawResult) => void;
+}
+/**
+ * 绘制时可选的样式和事件回调
+ */
+export interface DrawOptions {
+    strokeColor?: Cesium.Color | string;
+    strokeWidth?: number;
+    fillColor?: Cesium.Color | string;
+    outlineColor?: Cesium.Color | string;
+    outlineWidth?: number;
+    selected?: {
+        color?: Cesium.Color | string;
+        width?: number;
+        outlineColor?: Cesium.Color | string;
+        outlineWidth?: number;
+    };
+    onClick?: (entity: Entity, type?: "line" | "polygon" | "rectangle" | "circle", positions?: Cartesian3[]) => void;
+}
+/**
+ * 基础绘制类
+ * 包含所有绘制类型的通用逻辑
+ */
+export declare abstract class BaseDraw {
+    protected viewer: Viewer;
+    protected scene: Cesium.Scene;
+    protected entities: Cesium.EntityCollection;
+    protected offsetHeight: number;
+    protected originalDepthTestAgainstTerrain: boolean | null;
+    /**
+     * 当场景启用了 requestRenderMode（手动渲染）时，绘制过程中需要关闭该模式以保证动画和交互正常。
+     * 在绘制结束或取消时应恢复为原始值。
+     */
+    protected originalRequestRenderMode: boolean | null;
+    protected callbacks: DrawCallbacks;
+    protected tempPositions: Cesium.Cartesian3[];
+    protected tempEntities: Cesium.Entity[];
+    protected tempLabelEntities: Cesium.Entity[];
+    protected finishedPointEntities: Cesium.Entity[];
+    /** 当前绘制的选项（如果有） */
+    protected drawOptions?: DrawOptions;
+    /**
+     * 将任意颜色输入解析为 Cesium.Color
+     */
+    protected resolveColor(input?: Cesium.Color | string): Cesium.Color;
+    /**
+     * 应用选中样式（可切换）
+     */
+    protected applySelectedStyleToEntity(entity: Entity): void;
+    /**
+     * 恢复原始样式
+     */
+    protected restoreOriginalStyleForEntity(entity: Entity): void;
+    abstract updateDrawingEntity(previewPoint?: Cesium.Cartesian3): void;
+    abstract startDrawing(options?: DrawOptions): void;
+    /**
+     * 抽象方法：完成绘制
+     */
+    abstract finishDrawing(): DrawResult | null;
+    /**
+     * 抽象方法：获取绘制类型
+     */
+    abstract getDrawType(): "line" | "polygon" | "rectangle" | "circle";
+    constructor(viewer: Viewer, callbacks?: DrawCallbacks);
+    /**
+     * 根据场景模式更新偏移高度
+     */
+    protected updateOffsetHeight(): void;
+    /**
+     * 拾取地形或椭球体上的位置
+     */
+    protected pickGlobePosition(windowPosition: Cesium.Cartesian2): Cesium.Cartesian3 | null;
+    /**
+     * 如果场景启用了 requestRenderMode（手动渲染），在开始绘制时临时关闭以保证动画/交互正常。
+     */
+    protected enableContinuousRenderingIfNeeded(): void;
+    /**
+     * 在绘制完成或取消时恢复 requestRenderMode 到原始状态（如果曾被修改过）。
+     */
+    protected restoreRequestRenderModeIfNeeded(): void;
+    /**
+     * 添加一个点到临时位置数组并创建点实体
+     */
+    protected addPoint(position: Cesium.Cartesian3): void;
+    /**
+     * 创建总长/面积标签图片
+     */
+    protected createTotalLengthBillboardImage(text: string): HTMLCanvasElement;
+    /**
+     * 创建分段长度标签图片
+     */
+    protected createSegmentLengthBillboardImage(text: string): HTMLCanvasElement;
+    /**
+     * 清理临时实体
+     */
+    protected clearTempEntities(): void;
+}

package/dist/libs/drawHelper/DrawCircle.d.ts

@@ -0,0 +1,25 @@
+import { Cartesian3 } from '../../../node_modules/cesium';
+import { BaseDraw, DrawResult, DrawOptions } from './BaseDraw';
+/**
+ * 画圆绘制类
+ */
+export declare class DrawCircle extends BaseDraw {
+    private currentCircleEntity;
+    private centerPosition;
+    /**
+     * 开始绘制
+     */
+    startDrawing(options?: DrawOptions): void;
+    /**
+     * 更新绘制实体（预览）
+     */
+    updateDrawingEntity(previewPoint?: Cartesian3): void;
+    /**
+     * 完成绘制
+     */
+    finishDrawing(): DrawResult | null;
+    /**
+     * 获取绘制类型
+     */
+    getDrawType(): "line" | "polygon" | "rectangle" | "circle";
+}

package/dist/libs/drawHelper/DrawLine.d.ts

@@ -0,0 +1,44 @@
+import { Cartesian3 } from '../../../node_modules/cesium';
+import { BaseDraw, DrawResult, DrawOptions } from './BaseDraw';
+/**
+ * 画线绘制类
+ */
+export declare class DrawLine extends BaseDraw {
+    private currentLineEntity;
+    private currentSegmentLabels;
+    private currentTotalLabel;
+    private currentLinePositions;
+    private isTotalLabelWarmedUp;
+    /**
+     * 开始绘制
+     */
+    startDrawing(options?: DrawOptions): void;
+    /**
+     * 更新绘制实体（预览）
+     */
+    updateDrawingEntity(previewPoint?: Cartesian3): void;
+    /**
+     * 完成绘制
+     */
+    finishDrawing(): DrawResult | null;
+    /**
+     * 获取绘制类型
+     */
+    getDrawType(): "line" | "polygon" | "rectangle" | "circle";
+    /**
+     * 清理线条实体
+     */
+    private clearLineEntity;
+    /**
+     * 更新分段标签
+     */
+    private updateSegmentLabels;
+    /**
+     * 更新总距离标签
+     */
+    private updateTotalLabel;
+    /**
+     * 总长标签预热
+     */
+    private warmupTotalLengthLabel;
+}

package/dist/libs/drawHelper/DrawPolgon.d.ts

@@ -0,0 +1,24 @@
+import { Cartesian3 } from '../../../node_modules/cesium';
+import { BaseDraw, DrawResult, DrawOptions } from './BaseDraw';
+/**
+ * 画多边形绘制类
+ */
+export declare class DrawPolygon extends BaseDraw {
+    private currentPolygonEntity;
+    /**
+     * 开始绘制
+     */
+    startDrawing(options?: DrawOptions): void;
+    /**
+     * 更新绘制实体（预览）
+     */
+    updateDrawingEntity(previewPoint?: Cartesian3): void;
+    /**
+     * 完成绘制
+     */
+    finishDrawing(): DrawResult | null;
+    /**
+     * 获取绘制类型
+     */
+    getDrawType(): "line" | "polygon" | "rectangle" | "circle";
+}