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

package/dist/libs/overlay/MapPolygon.d.ts

@@ -0,0 +1,70 @@
+import { Viewer, Entity, Color, HeightReference } from '../../../node_modules/cesium';
+import { OverlayPosition } from './types';
+import * as Cesium from "cesium";
+/**
+ * Polygon 选项
+ */
+export interface PolygonOptions {
+    positions: OverlayPosition[];
+    material?: Cesium.MaterialProperty | Color | string;
+    outline?: boolean;
+    outlineColor?: Color | string;
+    outlineWidth?: number;
+    heightReference?: HeightReference;
+    extrudedHeight?: number;
+    onClick?: (entity: Entity) => void;
+    id?: string;
+}
+/**
+ * Polygon 工具类
+ */
+export declare class MapPolygon {
+    private viewer;
+    private entities;
+    constructor(viewer: Viewer);
+    /**
+     * 转换位置为 Cartesian3
+     */
+    private convertPosition;
+    /**
+     * 转换颜色
+     */
+    private resolveColor;
+    /**
+     * 解析材质
+     */
+    private resolveMaterial;
+    /**
+     * 计算二维多边形方向（正值为 CCW）
+     */
+    private polygonArea2D;
+    /**
+     * 向内偏移二维多边形顶点（线偏移 + 邻边相交）。厚度单位：米。
+     * 对复杂凹形可能產生伪影，更适合凸多边形或温和凹形。
+     */
+    private offsetPolygon2DInward;
+    /**
+     * 计算内偏移后的 3D 顶点：使用切平面近似进行 2D 偏移再投回椭球，并统一高度。
+     */
+    private computeInnerOffsetPositions;
+    /**
+     * 为多边形顶点统一高度（含微小抬升）
+     */
+    private elevatePositions;
+    /**
+     * 添加 Polygon（多边形）
+     */
+    add(options: PolygonOptions): Entity;
+    /**
+     * 更新 Polygon 位置
+     */
+    updatePositions(entity: Entity, positions: OverlayPosition[]): void;
+    /**
+     * 更新 Polygon 样式
+     */
+    updateStyle(entity: Entity, options: Partial<Pick<PolygonOptions, 'material' | 'outline' | 'outlineColor' | 'outlineWidth'>>): void;
+    /**
+     * 移除 Polygon（通过实体或实体 id）
+     */
+    remove(entityOrId: Entity | string): boolean;
+}

package/dist/libs/overlay/MapPolyline.d.ts

@@ -0,0 +1,50 @@
+import { Viewer, Entity, Color } from '../../../node_modules/cesium';
+import { OverlayPosition } from './types';
+import * as Cesium from "cesium";
+/**
+ * Polyline 选项
+ */
+export interface PolylineOptions {
+    positions: OverlayPosition[];
+    width?: number;
+    material?: Cesium.MaterialProperty | Color | string;
+    clampToGround?: boolean;
+    onClick?: (entity: Entity) => void;
+    id?: string;
+}
+/**
+ * Polyline 工具类
+ */
+export declare class MapPolyline {
+    private viewer;
+    private entities;
+    constructor(viewer: Viewer);
+    /**
+     * 转换位置为 Cartesian3
+     */
+    private convertPosition;
+    /**
+     * 转换颜色
+     */
+    private resolveColor;
+    /**
+     * 解析材质
+     */
+    private resolveMaterial;
+    /**
+     * 添加 Polyline（折线）
+     */
+    add(options: PolylineOptions): Entity;
+    /**
+     * 更新 Polyline 位置
+     */
+    updatePositions(entity: Entity, positions: OverlayPosition[]): void;
+    /**
+     * 更新 Polyline 样式
+     */
+    updateStyle(entity: Entity, options: Partial<Pick<PolylineOptions, 'width' | 'material'>>): void;
+    /**
+     * 移除 Polyline（通过实体或实体 id）
+     */
+    remove(entityOrId: Entity | string): boolean;
+}

package/dist/libs/overlay/MapRectangle.d.ts

@@ -0,0 +1,56 @@
+import { Viewer, Entity, Color, HeightReference } from '../../../node_modules/cesium';
+import * as Cesium from "cesium";
+/**
+ * Rectangle 选项
+ */
+export interface RectangleOptions {
+    coordinates: Cesium.Rectangle;
+    material?: Cesium.MaterialProperty | Color | string;
+    outline?: boolean;
+    outlineColor?: Color | string;
+    outlineWidth?: number;
+    heightReference?: HeightReference;
+    extrudedHeight?: number;
+    onClick?: (entity: Entity) => void;
+    id?: string;
+}
+/**
+ * Rectangle 工具类
+ */
+export declare class MapRectangle {
+    private viewer;
+    private entities;
+    constructor(viewer: Viewer);
+    /**
+     * 转换颜色
+     */
+    private resolveColor;
+    /**
+     * 解析材质
+     */
+    private resolveMaterial;
+    /**
+     * 将 Rectangle 转为四点多边形顶点（按西南→东南→东北→西北顺序）
+     */
+    private rectangleToPositions;
+    /**
+     * 按米单位向内收缩矩形边界，返回新的 Rectangle
+     */
+    private shrinkRectangle;
+    /**
+     * 添加 Rectangle（矩形）
+     */
+    add(options: RectangleOptions): Entity;
+    /**
+     * 更新 Rectangle 坐标
+     */
+    updateCoordinates(entity: Entity, coordinates: Cesium.Rectangle): void;
+    /**
+     * 更新 Rectangle 样式
+     */
+    updateStyle(entity: Entity, options: Partial<Pick<RectangleOptions, 'material' | 'outline' | 'outlineColor' | 'outlineWidth'>>): void;
+    /**
+     * 移除 Rectangle（通过实体或实体 id）
+     */
+    remove(entityOrId: Entity | string): boolean;
+}

package/dist/libs/overlay/MapRing.d.ts

@@ -0,0 +1,95 @@
+import { Viewer, Entity, Color } from '../../../node_modules/cesium';
+import { OverlayPosition } from './types';
+/**
+ * Ring（边缘发光圆环）选项
+ */
+export interface RingOptions {
+    /** 中心点（经纬度/高度 或 Cartesian3） */
+    position: OverlayPosition;
+    /** 半径（米） */
+    radius: number;
+    /** 边缘发光颜色 */
+    color?: Color | string;
+    /** 是否绘制内层线（默认 true）。关闭可去掉“白色芯子” */
+    showInnerLine?: boolean;
+    /** 实线颜色 */
+    lineColor?: Color | string;
+    /** 内层线型：实线/虚线（默认 solid） */
+    lineStyle?: "solid" | "dashed";
+    /** 虚线材质方案：stripe(默认) / dash */
+    lineMaterialMode?: "stripe" | "dash";
+    /** stripe 模式：条纹重复次数（默认 32） */
+    stripeRepeat?: number;
+    /** 虚线长度（像素，默认 16） */
+    dashLength?: number;
+    /** 虚线模式（16bit pattern，可选） */
+    dashPattern?: number;
+    /** 虚线间隙颜色（默认透明） */
+    gapColor?: Color | string;
+    /** 线宽（像素） */
+    width?: number;
+    /** 外层发光线宽（像素）。优先于 width */
+    glowWidth?: number;
+    /** 内层实线线宽（像素）。不传则使用自动计算 */
+    lineWidth?: number;
+    /** 发光强度（0-1），越大越“亮/粗” */
+    glowPower?: number;
+    /** 是否贴地（默认 true） */
+    clampToGround?: boolean;
+    /** 圆环分段数（默认 128），越大越圆滑 */
+    segments?: number;
+    /** 覆盖物点击回调 */
+    onClick?: (entity: Entity) => void;
+    id?: string;
+}
+/**
+ * Ring 工具类：使用 polyline + PolylineGlowMaterialProperty 实现发光圆环
+ */
+export declare class MapRing {
+    private viewer;
+    private entities;
+    constructor(viewer: Viewer);
+    /**
+     * 转换位置为 Cartesian3
+     */
+    private convertPosition;
+    /**
+     * 转换颜色
+     */
+    private resolveColor;
+    private resolveLineMaterial;
+    private resolveGlowMaterial;
+    private getInnerWidth;
+    private addInnerEntity;
+    private removeInnerEntity;
+    private rebuildRingPositions;
+    /**
+     * 生成近似圆顶点（Cartesian3 数组）。segments 越大越平滑。
+     * 这里沿用 MapCircle 的大圆航线近似，保证在经纬度空间更稳定。
+     */
+    private generateCirclePositions;
+    /**
+     * 添加 Ring（边缘发光圆环）
+     */
+    add(options: RingOptions): Entity;
+    /**
+     * 更新 Ring 中心
+     */
+    updatePosition(entity: Entity, position: OverlayPosition): void;
+    /**
+     * 更新 Ring 半径
+     */
+    updateRadius(entity: Entity, radius: number): void;
+    /**
+     * 更新 Ring 样式
+     */
+    updateStyle(entity: Entity, options: Partial<Pick<RingOptions, "color" | "showInnerLine" | "lineColor" | "lineStyle" | "lineMaterialMode" | "stripeRepeat" | "dashLength" | "dashPattern" | "gapColor" | "width" | "glowWidth" | "lineWidth" | "glowPower" | "clampToGround" | "segments">>): void;
+    /**
+     * 显示/隐藏 Ring
+     */
+    setVisible(entity: Entity, visible: boolean): void;
+    /**
+     * 移除 Ring（通过实体或实体 id）
+     */
+    remove(entityOrId: Entity | string): boolean;
+}

package/dist/libs/overlay/MapSVG.d.ts

@@ -0,0 +1,63 @@
+import { Viewer, Entity, Color, HeightReference, VerticalOrigin, HorizontalOrigin } from '../../../node_modules/cesium';
+import { OverlayPosition } from './types';
+import * as Cesium from "cesium";
+/**
+ * SVG 选项
+ */
+export interface SvgOptions {
+    position: OverlayPosition;
+    svg: string;
+    width?: number;
+    height?: number;
+    scale?: number;
+    rotation?: number;
+    pixelOffset?: Cesium.Cartesian2;
+    eyeOffset?: Cesium.Cartesian3;
+    horizontalOrigin?: HorizontalOrigin;
+    verticalOrigin?: VerticalOrigin;
+    heightReference?: HeightReference;
+    disableDepthTestDistance?: number;
+    color?: Color | string;
+    onClick?: (entity: Entity) => void;
+    id?: string;
+}
+/**
+ * SVG 工具类
+ */
+export declare class MapSVG {
+    private viewer;
+    private entities;
+    constructor(viewer: Viewer);
+    /**
+     * 转换位置为 Cartesian3
+     */
+    private convertPosition;
+    /**
+     * 转换颜色
+     */
+    private resolveColor;
+    /**
+     * 将 SVG 字符串转换为 data URL
+     */
+    private svgToDataUrl;
+    /**
+     * 添加 SVG（使用 Billboard）
+     */
+    add(options: SvgOptions): Entity;
+    /**
+     * 更新 SVG 位置
+     */
+    updatePosition(entity: Entity, position: OverlayPosition): void;
+    /**
+     * 更新 SVG 内容
+     */
+    updateSvg(entity: Entity, svg: string): void;
+    /**
+     * 更新 SVG 样式
+     */
+    updateStyle(entity: Entity, options: Partial<Pick<SvgOptions, 'scale' | 'rotation' | 'color'>>): void;
+    /**
+     * 移除 SVG（通过实体或实体 id）
+     */
+    remove(entityOrId: Entity | string): boolean;
+}

package/dist/libs/overlay/index.d.ts

@@ -0,0 +1,22 @@
+export { CesiumOverlayService } from '../CesiumOverlayService';
+export { MapMarker } from './MapMarker';
+export { MapLabel } from './MapLabel';
+export { MapIcon } from './MapIcon';
+export { MapSVG } from './MapSVG';
+export { MapInfoWindow } from './MapInfoWindow';
+export { MapPolyline } from './MapPolyline';
+export { MapPolygon } from './MapPolygon';
+export { MapRectangle } from './MapRectangle';
+export { MapCircle } from './MapCircle';
+export { MapRing } from './MapRing';
+export type { OverlayPosition } from './types';
+export type { MarkerOptions } from './MapMarker';
+export type { LabelOptions } from './MapLabel';
+export type { IconOptions } from './MapIcon';
+export type { SvgOptions } from './MapSVG';
+export type { InfoWindowOptions } from './MapInfoWindow';
+export type { PolylineOptions } from './MapPolyline';
+export type { PolygonOptions } from './MapPolygon';
+export type { RectangleOptions } from './MapRectangle';
+export type { CircleOptions } from './MapCircle';
+export type { RingOptions } from './MapRing';

package/dist/libs/overlay/types.d.ts

@@ -0,0 +1,41 @@
+import { Cartesian3, Entity, Color, MaterialProperty, Rectangle, Cartographic } from '../../../node_modules/cesium';
+/**
+ * 覆盖物位置类型
+ */
+export type OverlayPosition = Cartesian3 | [number, number] | [number, number, number];
+/**
+ * 覆盖物扩展实体类型
+ * 用于在 Cesium.Entity 上挂载覆盖物相关的元数据
+ */
+export interface OverlayEntity extends Entity {
+    /** 覆盖物点击回调（由各 Map* 工具类设置） */
+    _onClick?: (entity: Entity) => void;
+    /** 覆盖物类型标识（用于 CesiumOverlayService 做差异化更新/删除） */
+    _overlayType?: string;
+    /** 信息窗口根 DOM（由 MapInfoWindow / CesiumOverlayService 使用） */
+    _infoWindow?: HTMLElement;
+    /** 复合图形的内层实体或边框实体等关联引用 */
+    _borderEntity?: Entity;
+    _innerEntity?: Entity;
+    /** 粗边框 / 环形等形状相关元数据 */
+    _isThickOutline?: boolean;
+    _outlineWidth?: number;
+    _isRing?: boolean;
+    _ringThickness?: number;
+    _ringSegments?: number;
+    _ringGlowPower?: number;
+    _ringLineColor?: Color | string;
+    _ringLineStyle?: 'solid' | 'dashed';
+    _ringLineMaterialMode?: 'stripe' | 'dash';
+    _ringStripeRepeat?: number;
+    _ringDashLength?: number;
+    _ringDashPattern?: number;
+    _ringGapColor?: Color | string;
+    _ringShowInnerLine?: boolean;
+    _fillMaterial?: MaterialProperty | Color | string;
+    _ringHeightEpsilon?: number;
+    _centerCartographic?: Cartographic;
+    _outerRadius?: number;
+    _innerRadius?: number;
+    _outerRectangle?: Rectangle;
+}

package/dist/libs/toolBar/CesiumMapController.d.ts

@@ -0,0 +1,78 @@
+import { Viewer } from '../../../node_modules/cesium';
+import { MapType, ZoomCallback } from '../CesiumMapModel';
+interface MapInitialCenter {
+    longitude: number;
+    latitude: number;
+    height: number;
+}
+interface CesiumMapControllerOptions {
+    initialCenter?: MapInitialCenter;
+    /** 当前可用的地图类型列表（由外部维护），用于读取 maximumLevel 等配置 */
+    getMapTypes?: () => MapType[];
+    /** 获取当前底图类型 id（由外部维护） */
+    getCurrentMapTypeId?: () => string;
+    /** 获取当前天地图 token（用于从 provider 读取 maximumLevel 时保持行为一致） */
+    getToken?: () => string;
+    /** 缩放回调（来自 Toolbar 的 ZoomCallback） */
+    zoomCallback?: ZoomCallback;
+    /** 场景模式切换后回调（例如通知 DrawHelper 重新计算偏移） */
+    onSceneModeChanged?: () => void;
+}
+/**
+ * 负责地图相机控制、缩放层级和 2D/3D 切换等逻辑的控制器
+ * 与 UI（工具栏）解耦，避免 Cesium 细节散落在各处。
+ */
+export declare class CesiumMapController {
+    private viewer;
+    private initialCenter?;
+    private getMapTypes?;
+    private getCurrentMapTypeId?;
+    private getToken?;
+    private zoomCallback?;
+    private onSceneModeChanged?;
+    constructor(viewer: Viewer, options?: CesiumMapControllerOptions);
+    /**
+     * 监听相机缩放，限制层级范围到 [1, 18]，并参考当前底图的 maximumLevel
+     */
+    setupCameraZoomLimitListener(): void;
+    /**
+     * 获取当前地图层级（1-18）
+     */
+    getCurrentZoomLevel(): number;
+    /**
+     * 设置地图层级
+     * @param zoomLevel 目标层级（1-18）
+     */
+    setZoomLevel(zoomLevel: number): void;
+    /** 放大 */
+    zoomIn(): void;
+    /** 缩小 */
+    zoomOut(): void;
+    /**
+     * 2D/3D 切换
+     */
+    toggle2D3D(buttonElement: HTMLElement): void;
+    /**
+     * 复位到初始位置
+     */
+    resetLocation(): void;
+    setInitialCenter(center: MapInitialCenter): void;
+    getInitialCenter(): MapInitialCenter | undefined;
+    /**
+     * 切换全屏
+     */
+    toggleFullscreen(): void;
+    /**
+     * 检查是否处于全屏状态
+     */
+    isFullscreen(): boolean;
+    /**
+     * 进入全屏
+     */
+    enterFullscreen(): void;
+    /**
+     * 退出全屏
+     */
+    exitFullscreen(): void;
+}
+export {};

package/dist/libs/toolBar/MapLayersService.d.ts

@@ -0,0 +1,67 @@
+import { Viewer } from '../../../node_modules/cesium';
+import { MapType } from '../CesiumMapModel';
+/**
+ * 图层服务配置接口
+ */
+export interface MapLayersServiceConfig {
+    mapTypes: MapType[];
+    currentMapType: string;
+    token: string;
+    isNoFlyZoneChecked: boolean;
+    isNoFlyZoneVisible: boolean;
+    onMapTypeChange?: (mapTypeId: string) => void;
+    onNoFlyZoneToggle?: (isChecked: boolean) => void;
+    onShowNoFlyZones?: () => Promise<void> | void;
+}
+/**
+ * 图层服务类
+ * 负责处理地图图层切换相关的所有逻辑
+ */
+export declare class MapLayersService {
+    private viewer;
+    private toolbarElement;
+    private config;
+    private currentGeoWTFS;
+    constructor(viewer: Viewer, toolbarElement: HTMLElement, config: MapLayersServiceConfig);
+    /**
+     * 更新配置
+     */
+    updateConfig(config: Partial<MapLayersServiceConfig>): void;
+    adjustMenuPosition: (menu: HTMLElement) => void;
+    /**
+     * 切换图层菜单
+     */
+    toggleLayers(buttonElement: HTMLElement): void;
+    /**
+     * 创建地图类型部分
+     */
+    private createMapTypeSection;
+    /**
+     * 创建地图类型项
+     */
+    private createMapTypeItem;
+    /**
+     * 创建叠加图层部分
+     */
+    private createOverlaySection;
+    /**
+     * 创建叠加图层项
+     */
+    private createOverlayItem;
+    /**
+     * 切换地图类型
+     */
+    switchMapType(mapTypeId: string): void;
+    /**
+     * 获取当前地图类型
+     */
+    getCurrentMapType(): string;
+    /**
+     * 关闭图层菜单
+     */
+    closeLayersMenu(): void;
+    /**
+     * 销毁图层服务
+     */
+    destroy(): void;
+}

package/dist/libs/toolBar/MapSearchService.d.ts

@@ -0,0 +1,41 @@
+import { Viewer } from '../../../node_modules/cesium';
+import { SearchResult, SearchCallback } from '../CesiumMapModel';
+/**
+ * 搜索服务类
+ * 负责处理地图搜索相关的所有逻辑
+ */
+export declare class SearchService {
+    private viewer;
+    private toolbarElement;
+    private searchCallback?;
+    private searchContainer;
+    constructor(viewer: Viewer, toolbarElement: HTMLElement, searchCallback?: SearchCallback);
+    /**
+     * 设置搜索回调
+     */
+    setSearchCallback(callback: SearchCallback): void;
+    /**
+     * 切换搜索功能
+     */
+    toggleSearch(buttonElement: HTMLElement): void;
+    /**
+     * 执行默认搜索（使用天地图 API）
+     */
+    private performDefaultSearch;
+    /**
+     * 显示搜索结果
+     */
+    displaySearchResults(results: SearchResult[], container: HTMLElement): void;
+    /**
+     * 选择搜索结果
+     */
+    selectSearchResult(result: SearchResult): void;
+    /**
+     * 关闭搜索框
+     */
+    closeSearchContainer(): void;
+    /**
+     * 销毁搜索服务
+     */
+    destroy(): void;
+}

package/dist/libs/toolBar/MapToolBarConfig.d.ts

@@ -0,0 +1,3 @@
+import { ButtonConfig } from '../CesiumMapModel';
+export declare const defaultButtonSorts: Record<string, number>;
+export declare const defaultButtons: ButtonConfig[];

package/dist/libs/toolBar/MeasurementService.d.ts

@@ -0,0 +1,16 @@
+import { Viewer } from '../../../node_modules/cesium';
+import { default as DrawHelper } from '../CesiumMapDraw';
+import { MeasurementCallback } from '../CesiumMapModel';
+export type MeasureMode = 'none' | 'distance' | 'area';
+export declare class MeasurementService {
+    private viewer;
+    private drawHelper;
+    private measurementCallback?;
+    private currentMode;
+    constructor(viewer: Viewer, drawHelper: DrawHelper, measurementCallback?: MeasurementCallback);
+    getMeasureMode(): MeasureMode;
+    setupDrawHelperCallbacks(): void;
+    startAreaMeasurement(): void;
+    startDistanceMeasurement(): void;
+    clearMeasurements(): void;
+}

package/dist/libs/toolBar/NotFlyZonesService.d.ts

@@ -0,0 +1,46 @@
+import { Viewer } from '../../../node_modules/cesium';
+/**
+ * 禁飞区服务配置接口
+ */
+export interface NotFlyZonesServiceConfig {
+    extrudedHeight?: number;
+    autoLoad?: boolean;
+}
+/**
+ * 禁飞区服务类
+ * 负责处理机场禁飞区相关的所有逻辑
+ */
+export declare class NotFlyZonesService {
+    private viewer;
+    private noFlyZoneEntities;
+    private isNoFlyZoneVisible;
+    private isNoFlyZoneLoading;
+    private readonly extrudedHeight;
+    constructor(viewer: Viewer, config?: NotFlyZonesServiceConfig);
+    /**
+     * 加载并显示机场禁飞区
+     */
+    showNoFlyZones(): Promise<void>;
+    /**
+     * 隐藏机场禁飞区
+     */
+    hideNoFlyZones(): void;
+    /**
+     * 切换机场禁飞区显示状态
+     */
+    toggleNoFlyZones(): Promise<void>;
+    /**
+     * 获取禁飞区显示状态
+     */
+    getNoFlyZoneVisible(): boolean;
+    /**
+     * 创建禁飞区多边形配置选项
+     * @param positions - 多边形的顶点坐标数组，使用笛卡尔坐标系
+     * @returns 返回一个包含多边形图形配置选项的对象
+     */
+    private createNoFlyZonePolygonOptions;
+    /**
+     * 销毁禁飞区服务
+     */
+    destroy(): void;
+}

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xingm/vmap-cesium-toolbar",
-  "version": "0.0.1-beta.10",
+  "version": "0.0.2-alpha.10",
   "description": "A powerful Cesium map toolbar plugin with drawing, measurement, and interaction features",
   "type": "module",
   "main": "index.js",
@@ -32,14 +32,14 @@
     "vue3",
     "typescript"
   ],
-  "author": "Your Name",
+  "author": "pengxueyou",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/your-username/vmap-cesium-toolbar.git"
+    "url": "git+https://github.com/benxueyou/vmap-cesium-toolbar.git"
   },
   "bugs": {
-    "url": "https://github.com/your-username/vmap-cesium-toolbar/issues"
+    "url": "https://github.com/benxueyou/vmap-cesium-toolbar/issues"
   },
-  "homepage": "https://github.com/your-username/vmap-cesium-toolbar#readme"
+  "homepage": "https://github.com/benxueyou/vmap-cesium-toolbar#readme"
 }