@xingm/vmap-cesium-toolbar 0.0.7-alpha.1 → 0.0.7-alpha.2

package/dist/libs/CesiumMapMark.d.ts

@@ -0,0 +1,202 @@
+import { CesiumOverlayService } from './CesiumOverlayService';
+import { default as DrawHelper } from './CesiumMapDraw';
+import { DrawOptions } from './drawHelper/BaseDraw';
+import { LngLatPosition } from '../utils/overlayUtils';
+import * as Cesium from "cesium";
+export type CesiumMapDrawType = "point" | "polyline" | "polygon" | "rectangle" | "circle";
+export type CesiumMapWorkAreaType = "polygon" | "circle" | "rectangle";
+export type CesiumMapWorkAreaKind = "work" | "noFly";
+export interface CesiumMapMarkToolbarPosition {
+    left?: number | string;
+    right?: number | string;
+    top?: number | string;
+    bottom?: number | string;
+}
+export interface CesiumMapDrawResult {
+    drawType: CesiumMapDrawType;
+    positions: LngLatPosition[];
+    cartesian3Positions: Cesium.Cartesian3[];
+    position?: LngLatPosition;
+    entity: Cesium.Entity | null;
+    length?: number;
+    area?: number;
+    radius?: number;
+    color?: string;
+}
+export interface CesiumMapWorkAreaDrawResult extends Omit<CesiumMapDrawResult, "drawType"> {
+    drawType: CesiumMapWorkAreaType;
+    areaType: CesiumMapWorkAreaKind;
+}
+export interface CesiumMapMarkOptions extends DrawOptions {
+    pointWidth?: number;
+    pointHeight?: number;
+    continuous?: boolean;
+    showPolylineLengthLabel?: boolean;
+    showToolbar?: boolean;
+    toolbarClassName?: string;
+    toolbarPosition?: CesiumMapMarkToolbarPosition;
+    buttonSize?: number;
+    buttonSpacing?: number;
+    zIndex?: number;
+    defaultColor?: string;
+    colors?: Partial<Record<CesiumMapDrawType, string>>;
+    overlayServiceOptions?: ConstructorParameters<typeof CesiumOverlayService>[1];
+    buttons?: CesiumMapMarkButtonConfig[];
+}
+export interface CesiumMapMarkCallbacks {
+    onDrawStart?: (drawType: CesiumMapDrawType) => void;
+    onDrawEnd?: (result: CesiumMapDrawResult) => void;
+    onWorkAreaDrawEnd?: (result: CesiumMapWorkAreaDrawResult) => void;
+    onClear?: () => void;
+    onDelete?: (entity: Cesium.Entity) => void;
+    onEditChange?: (entity: Cesium.Entity) => void;
+    onEditEnd?: (result: CesiumMapDrawResult) => void;
+    onColorChange?: (color: string, drawType?: CesiumMapDrawType) => void;
+    onError?: (error: Error) => void;
+}
+export interface CesiumMapMarkExportItem {
+    id?: string;
+    drawType: CesiumMapDrawType;
+    positions: LngLatPosition[];
+    position?: LngLatPosition;
+    length?: number;
+    area?: number;
+    radius?: number;
+    color?: string;
+    entity: Cesium.Entity;
+}
+export interface CesiumMapMarkButtonConfig {
+    id: CesiumMapDrawType;
+    title?: string;
+    text?: string;
+    icon?: string | HTMLElement | false;
+    color?: string;
+    borderColor?: string;
+    backgroundColor?: string;
+    activeBackgroundColor?: string;
+    callback?: (mark: CesiumMapMark, drawType: CesiumMapDrawType) => void;
+}
+export declare class CesiumMapMark {
+    private viewer;
+    private map?;
+    private container?;
+    private options;
+    private callbacks;
+    private drawHelper;
+    private overlayService;
+    private pointHandler;
+    private editClickHandler;
+    private editModeEnabled;
+    private editOptions?;
+    private originalRequestRenderMode;
+    private currentEditingEntity;
+    private lastEditedEntity;
+    private pointEditDragging;
+    private pointEditDraggingEntity;
+    private pointEditMarkerEntity;
+    private pointEditCameraBackup;
+    private activeTool;
+    private workAreaMode;
+    private workAreaType;
+    private workAreaKind;
+    private readonly entityTypeMap;
+    private readonly pointEntities;
+    private readonly toolColors;
+    private toolbarElement;
+    private readonly toolbarButtons;
+    private colorPanelElement;
+    private hoveredColorTool;
+    private colorPanelCloseTimer;
+    constructor(viewer: Cesium.Viewer, container?: HTMLElement, options?: CesiumMapMarkOptions, callbacks?: CesiumMapMarkCallbacks, map?: unknown);
+    constructor(viewer: Cesium.Viewer, map?: unknown, container?: HTMLElement, options?: CesiumMapMarkOptions, callbacks?: CesiumMapMarkCallbacks);
+    getViewer(): Cesium.Viewer;
+    getMap(): unknown;
+    getContainer(): HTMLElement | undefined;
+    getDrawHelper(): DrawHelper;
+    getOverlayService(): CesiumOverlayService;
+    getActiveTool(): CesiumMapDrawType | null;
+    getToolbarElement(): HTMLElement | null;
+    setCallbacks(callbacks: CesiumMapMarkCallbacks): void;
+    updateCallbacks(callbacks: Partial<CesiumMapMarkCallbacks>): void;
+    updateOptions(options: Partial<CesiumMapMarkOptions>): void;
+    startDrawTool(drawType: CesiumMapDrawType, options?: DrawOptions): void;
+    startDrawing(drawType: CesiumMapDrawType, options?: DrawOptions): void;
+    drawPoint(options?: DrawOptions): void;
+    drawPolyline(options?: DrawOptions): void;
+    drawPolygon(options?: DrawOptions): void;
+    drawRectangle(options?: DrawOptions): void;
+    drawCircle(options?: DrawOptions): void;
+    startWorkAreaDraw(drawType: CesiumMapWorkAreaType, areaType?: CesiumMapWorkAreaKind, options?: DrawOptions): void;
+    stopDraw(): void;
+    cancelDrawing(): void;
+    clearAll(): void;
+    deleteEntity(entity: Cesium.Entity | null | undefined): void;
+    removeEntity(entity: Cesium.Entity | null | undefined): void;
+    setColor(drawType: CesiumMapDrawType, color: string): void;
+    getColor(drawType: CesiumMapDrawType): string;
+    enableEdit(options?: Parameters<CesiumOverlayService["setOverlayEditMode"]>[1]): void;
+    disableEdit(): CesiumMapDrawResult | null;
+    startEdit(entityOrId: Cesium.Entity | string, options?: Parameters<CesiumOverlayService["startOverlayEdit"]>[1]): boolean;
+    stopEdit(): CesiumMapDrawResult | null;
+    getEntities(): Cesium.Entity[];
+    exportData(): CesiumMapMarkExportItem[];
+    handleSceneModeChanged(): void;
+    destroy(): void;
+    private setupDrawHelperCallbacks;
+    private startDrawHelper;
+    private createToolbar;
+    private rebuildToolbar;
+    private destroyToolbar;
+    private resolveButtonConfigs;
+    private createToolbarButton;
+    private formatCssPixel;
+    private applyToolbarStyle;
+    private applyButtonStyle;
+    private applyButtonContentColor;
+    private showColorPanel;
+    private renderColorPanel;
+    private applyColorPanelStyle;
+    private applyColorItemStyle;
+    private positionColorPanel;
+    private scheduleColorPanelClose;
+    private clearColorPanelCloseTimer;
+    private destroyColorPanel;
+    private updateToolbarActiveState;
+    private createEditableOverlayEntity;
+    private removeOriginalDrawEntity;
+    private startPointDrawing;
+    private installEditClickHandler;
+    private destroyEditClickHandler;
+    private showPointEditMarker;
+    private updatePointEditMarkerPosition;
+    private removePointEditMarker;
+    private pickPointEditEntity;
+    private isPointEditHit;
+    private getScreenDistance;
+    private pickPointEditPosition;
+    private pickDrawEntity;
+    private resolvePickedEntity;
+    private enableContinuousRenderForEdit;
+    private restoreRequestRenderModeAfterEdit;
+    private lockCameraForPointEdit;
+    private restoreCameraAfterPointEdit;
+    private emitEditEnd;
+    private buildDrawOptions;
+    private createWorkAreaOptions;
+    private buildDrawResult;
+    private buildWorkAreaDrawResult;
+    private getLngLatPositions;
+    private getCartesian3Positions;
+    private getRectangleLngLatPositions;
+    private calculateCartesianLength;
+    private resolveEntityDrawType;
+    private pickPosition;
+    private trackEntity;
+    private applyCircleStroke;
+    private resolveCesiumColor;
+    private normalizeColorKey;
+    private createInitialColors;
+    private normalizeConstructorArgs;
+    private emitError;
+}
+export default CesiumMapMark;

package/dist/libs/CesiumMapModel.d.ts

@@ -0,0 +1,180 @@
+import { Cartesian3, Cartographic, Color } from '../../node_modules/cesium';
+import { I18nLike } from '../libs/i18n';
+import * as Cesium from 'cesium';
+export interface ToolbarConfig {
+    position?: 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
+    buttonSize?: number;
+    buttonSpacing?: number;
+    backgroundColor?: string;
+    borderColor?: string;
+    borderRadius?: number;
+    borderWidth?: number;
+    boxShadow?: string;
+    zIndex?: number;
+    buttons?: CustomButtonConfig[];
+    useI18n?: boolean;
+    i18n?: I18nLike;
+    /** 天地图 token（工具栏默认搜索、图层切换使用） */
+    TD_Token?: string;
+    /** 天地图 sk（工具栏默认搜索、图层切换使用） */
+    TD_SK?: string;
+    /** 天地图 token 别名 */
+    token?: string;
+    /** 天地图 sk 别名 */
+    sk?: string;
+}
+export interface ButtonConfig {
+    sort?: number;
+    id: string;
+    icon: string;
+    title: string;
+    titleKey?: string;
+    size?: number;
+    color?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    borderStyle?: string;
+    hoverColor?: string;
+    activeColor?: string;
+    backgroundColor?: string;
+    callback?: () => void;
+    activeIcon?: string | HTMLElement;
+}
+export interface CustomButtonConfig {
+    id: string;
+    icon: string | HTMLElement | false;
+    title: string;
+    titleKey?: string;
+    enabled?: boolean;
+    visible?: boolean;
+    size?: number;
+    color?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    borderStyle?: string;
+    padding?: string;
+    hoverColor?: string;
+    activeColor?: string;
+    backgroundColor?: string;
+    sort?: number;
+    activeIcon?: string | HTMLElement | false;
+    callback?: () => void;
+    onClick?: (buttonId: string, buttonElement: HTMLElement) => void;
+}
+export interface SearchCallback {
+    onSearch?: (query: string) => Promise<SearchResult[]>;
+    onSelect?: (result: SearchResult) => void;
+    onSearchInput?: (query: string, container: HTMLElement) => void;
+    onSearchResults?: (results: SearchResult[], container: HTMLElement) => void;
+}
+export interface SearchResult {
+    name: string;
+    address: string;
+    longitude: number;
+    latitude: number;
+    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?: (beforeHeight: number, afterHeight: number, currentLevel: number) => void;
+    onZoomOut?: (beforeHeight: number, afterHeight: number, currentLevel: number) => void;
+}
+export interface MapType {
+    id: string;
+    name: string;
+    nameKey?: string;
+    /** 选中态左上角“路网”文案（可选，未配置时走 i18n 默认 key） */
+    placeNameLabel?: string;
+    /** 选中态左上角“路网”文案 i18n key（可选） */
+    placeNameLabelKey?: string;
+    /** 是否强制始终显示路网层（不受 placeName 开关影响） */
+    forcePlaceName?: boolean;
+    thumbnail: string;
+    provider: (token: string, sk?: string) => Cesium.ImageryProvider[];
+    terrainProvider?: (token: string, sk?: string) => Cesium.TerrainProvider | null;
+    geoWTFS?: (token: string, viewer: Cesium.Viewer, sk?: string) => any | null;
+}
+export interface MapToolsConfig {
+    containerId: string;
+    viewerOptions?: Cesium.Viewer.ConstructorOptions;
+    mapCenter?: {
+        longitude: number;
+        latitude: number;
+        height: number;
+        pitch?: number;
+        heading?: number;
+    };
+    zoomLevels?: number[];
+    defaultZoom?: number;
+}
+/**
+ * 点位绘制选项
+ */
+export interface PointOptions {
+    pixelSize?: number;
+    color?: Color;
+    outlineColor?: Color;
+    outlineWidth?: number;
+    showLabel?: boolean;
+    labelText?: string;
+    onClick?: (position: Cartesian3, cartographic: Cartographic) => void;
+}
+/**
+ * 线条绘制选项
+ */
+export interface LineOptions {
+    width?: number;
+    material?: Cesium.MaterialProperty | Color;
+    showDistance?: boolean;
+    dashPattern?: number;
+    onClick?: (positions: Cartesian3[], distance: number) => void;
+}
+/**
+ * 多边形绘制选项
+ */
+export interface PolygonOptions {
+    material?: Cesium.MaterialProperty | Color;
+    outline?: boolean;
+    outlineColor?: Color;
+    outlineWidth?: number;
+    showArea?: boolean;
+    dashPattern?: number;
+    onClick?: (positions: Cartesian3[], area: number) => void;
+}
+export interface OverlayOptions {
+    position: Cartesian3;
+    type: 'point' | 'label' | 'billboard' | 'model' | 'cylinder';
+    point?: {
+        pixelSize?: number;
+        color?: Color;
+        outlineColor?: Color;
+        outlineWidth?: number;
+    };
+    label?: {
+        text: string;
+        font?: string;
+        fillColor?: Color;
+        outlineColor?: Color;
+        outlineWidth?: number;
+    };
+    billboard?: {
+        image: string;
+        scale?: number;
+    };
+    model?: {
+        uri: string;
+        scale?: number;
+    };
+    cylinder?: {
+        length: number;
+        topRadius: number;
+        bottomRadius: number;
+        material?: Color;
+    };
+}
+export * as Cesium from '../../node_modules/cesium';

package/dist/libs/CesiumMapToolbar.d.ts

@@ -0,0 +1,231 @@
+import { Viewer } from '../../node_modules/cesium';
+import { CesiumMapController } from './toolBar/CesiumMapController';
+import { MeasurementService } from './toolBar/MeasurementService';
+import { SearchService } from './toolBar/MapSearchService';
+import { MapLayersService } from './toolBar/MapLayersService';
+import { NotFlyZonesService } from './toolBar/NotFlyZonesService';
+import { MapType, ToolbarConfig, SearchCallback, MeasurementCallback, ZoomCallback, CustomButtonConfig } from './CesiumMapModel';
+/**
+ * Cesium地图工具栏类
+ * 提供搜索、测量、2D/3D切换、图层切换、定位、缩放、全屏等功能
+ */
+export declare class CesiumMapToolbar {
+    private viewer;
+    private drawHelper;
+    private container;
+    private toolbarElement;
+    private config;
+    private searchService;
+    private mapLayersService;
+    private notFlyZonesService;
+    private measurementCallback?;
+    private zoomCallback?;
+    private fullscreenCallback?;
+    private resetLocationCallback?;
+    private initialCenter?;
+    private currentMapType;
+    TD_Token: string;
+    TD_SK: string;
+    mapTypes: MapType[];
+    private isNoFlyZoneChecked;
+    private currentGeoWTFS;
+    private measurementService;
+    private unsubscribeI18n?;
+    private i18n;
+    private useI18n;
+    readonly measurement: {
+        getMeasureMode: () => "none" | "distance" | "area";
+    };
+    private mapController;
+    constructor(viewer: Viewer, container: HTMLElement, config?: ToolbarConfig, callbacks?: {
+        search?: SearchCallback;
+        measurement?: MeasurementCallback;
+        zoom?: ZoomCallback;
+        fullscreen?: (isFullscreen: boolean) => void;
+        resetLocation?: () => void;
+    }, initialCenter?: {
+        longitude: number;
+        latitude: number;
+        height: number;
+    });
+    /**
+     * searchService 对外暴露的获取搜索服务方法
+     */
+    getSearchService(): SearchService;
+    /**
+     * notFlyZonesService 对外暴露的获取禁飞区服务方法
+     */
+    getNotFlyZonesService(): NotFlyZonesService;
+    /**
+     * measurementService 对外暴露的获取测量服务方法
+     */
+    getMeasurementService(): MeasurementService;
+    /**
+     * cesmapController 对外暴露的获取地图控制器方法
+     */
+    getCesiumMapCtrl(): CesiumMapController;
+    /**
+     * mapLayersService 对外暴露的获取图层服务方法
+     */
+    getMapLayersService(): MapLayersService;
+    /**
+     * 设置地图类型配置
+     * @param mapTypes
+     */
+    setMapTypes(mapTypes: MapType[]): void;
+    /**
+     * 设置天地图密钥
+     * @param TD_Token
+     */
+    setTDToken(TD_Token: string): void;
+    /**
+     * 设置天地图 sk
+     * @param TD_SK
+     */
+    setTDSK(TD_SK: string): void;
+    /**
+     * 设置天地图认证参数
+     * @param TD_Token
+     * @param TD_SK
+     */
+    setTDTAuth(TD_Token: string, TD_SK?: string): void;
+    /**
+     * 设置初始中心点
+     */
+    setInitialCenter(center: {
+        longitude: number;
+        latitude: number;
+        height: number;
+    }): void;
+    /**
+     * 获取初始中心点
+     */
+    getInitialCenter(): {
+        longitude: number;
+        latitude: number;
+        height: number;
+    } | undefined;
+    /**
+     * 复位到初始位置（公共方法）
+     */
+    resetToInitialLocation(): void;
+    /**
+     * 更新按钮配置
+     */
+    updateButtonConfig(buttonId: string, config: Partial<CustomButtonConfig>): void;
+    /**
+     * 添加自定义按钮
+     * @param config 按钮配置，支持 sort 参数控制插入位置
+     */
+    addCustomButton(config: CustomButtonConfig): void;
+    /**
+     * 获取所有按钮配置（包括默认按钮和自定义按钮），并添加 sort 值
+     */
+    private resolveIcon;
+    /**
+     * 获取按钮配置（已排序，包含默认按钮兜底）
+     * - 未传 buttons：使用默认按钮
+     * - 传了 buttons：按传入按钮列表渲染，并用默认按钮补齐缺省字段
+     */
+    private getButtonConfigs;
+    /**
+     * 重新构建工具栏按钮
+     */
+    private rebuildToolbarButtons;
+    /**
+     * 移除按钮
+     */
+    removeButton(buttonId: string): void;
+    /**
+     * 获取按钮元素
+     */
+    private setupDrawHelperCallbacks;
+    /**
+     * 创建工具栏
+     */
+    private createToolbar;
+    /**
+     * 创建按钮
+     */
+    private createButton;
+    /**
+     * 设置按钮图标
+     */
+    private setButtonIcon;
+    /**
+     * 判断是否为图片路径
+     */
+    private isImagePath;
+    /**
+     * 加载图片图标
+     */
+    private loadImageIcon;
+    /**
+     * 设置默认图标（当图片加载失败时）
+     */
+    private setDefaultIcon;
+    /**
+     * 设置按钮事件
+     */
+    private setupButtonEvents;
+    /**
+     * 按钮鼠标离开时关闭菜单
+     */
+    private closeMenuOnButtonLeave;
+    /**
+     * 关闭搜索框
+     */
+    private closeSearchContainer;
+    /**
+     * 处理按钮点击
+     */
+    private handleButtonClick;
+    /**
+     * 切换测量功能
+     */
+    private toggleMeasurement;
+    /**
+     * 处理测量操作
+     */
+    private handleMeasurementAction;
+    /**
+     * 切换2D/3D视图
+     */
+    private toggle2D3D;
+    /**
+     * 复位到初始位置
+     */
+    private resetLocation;
+    /**
+     * 放大
+     */
+    private zoomIn;
+    /**
+     * 缩小
+     */
+    private zoomOut;
+    /**
+     * 加载并显示机场禁飞区
+     * @deprecated 使用 NotFlyZonesService.showNoFlyZones 代替
+     */
+    showNoFlyZones(): Promise<void>;
+    /**
+     * 隐藏机场禁飞区
+     * @deprecated 使用 NotFlyZonesService.hideNoFlyZones 代替
+     */
+    hideNoFlyZones(): void;
+    /**
+     * 切换机场禁飞区显示状态
+     * @deprecated 使用 NotFlyZonesService.toggleNoFlyZones 代替
+     */
+    toggleNoFlyZones(): Promise<void>;
+    /**
+     * 获取禁飞区显示状态
+     * @deprecated 使用 NotFlyZonesService.getNoFlyZoneVisible 代替
+     */
+    getNoFlyZoneVisible(): boolean;
+    /**
+     * 销毁工具栏
+     */
+    destroy(): void;
+}