@xingm/vmap-cesium-toolbar 0.0.1-beta.6 → 0.0.1-beta.7

package/dist/libs/CesiumMapConfig.d.ts

@@ -0,0 +1,13 @@
+import { Viewer } from '../../node_modules/cesium';
+import { default as DrawHelper } from './CesiumMapHelper';
+import { MapType, ToolbarConfig, SearchCallback, MeasurementCallback, ZoomCallback } from './CesiumMapModel';
+export interface CesiumMapConfig {
+    viewer?: Viewer;
+    drawHelper?: DrawHelper;
+    toolbar?: ToolbarConfig;
+    search?: SearchCallback;
+    measurement?: MeasurementCallback;
+    zoom?: ZoomCallback;
+    mapTypes?: MapType[];
+}
+export declare const TDTMapTypes: MapType[];

package/dist/libs/CesiumMapHelper.d.ts

@@ -0,0 +1,180 @@
+import * as Cesium from "cesium";
+/**
+ * Cesium 绘图辅助工具类
+ * 支持绘制点、线、多边形、矩形，并提供编辑和删除功能
+ * 适用于 Cesium 1.132.0
+ */
+declare class DrawHelper {
+    private viewer;
+    private scene;
+    private entities;
+    private frustumPrimitives;
+    private drawMode;
+    private isDrawing;
+    private tempPositions;
+    private tempEntities;
+    private tempLabelEntities;
+    private finishedEntities;
+    private finishedLabelEntities;
+    private finishedPointEntities;
+    private publicEntities;
+    private _doubleClickPending;
+    private screenSpaceEventHandler;
+    private onDrawStartCallback;
+    private onDrawEndCallback;
+    private onEntityRemovedCallback;
+    private offsetHeight;
+    /**
+     * 构造函数
+     * @param viewer Cesium Viewer 实例
+     */
+    constructor(viewer: Cesium.Viewer);
+    /**
+     * 根据场景模式更新偏移高度
+     */
+    private updateOffsetHeight;
+    /**
+     * 开始绘制线条
+     */
+    startDrawingLine(): void;
+    /**
+     * 开始绘制多边形（仅边线）
+     */
+    startDrawingPolygon(): void;
+    /**
+     * 开始绘制矩形
+     */
+    startDrawingRectangle(): void;
+    /**
+     * 内部统一的开始绘制方法
+     * @param mode 绘制模式
+     */
+    private startDrawing;
+    /**
+     * 激活屏幕空间事件处理器
+     */
+    private activateDrawingHandlers;
+    /**
+     * 拾取地形或椭球体上的位置
+     * @param windowPosition 屏幕坐标
+     * @returns 世界坐标 Cartesian3 或 null
+     */
+    private pickGlobePosition;
+    /**
+     * 添加一个点到临时位置数组并创建点实体
+     * @param position 世界坐标
+     */
+    private addPoint;
+    /**
+     * 删除最后一个添加的点及其相关的临时实体
+     */
+    private removeLastPoint;
+    /**
+     * 重新创建剩余的点实体和绘制实体
+     * 用于右键删除点后的重建
+     */
+    private recreateRemainingEntities;
+    /**
+     * 更新预览线/面
+     * @param currentMousePosition 当前鼠标位置世界坐标
+     */
+    private updatePreview;
+    /**
+     * 核心方法：根据当前点序列更新或创建临时的线/面实体
+     * @param previewPoint 可选的预览点，用于显示动态效果
+     */
+    private updateDrawingEntity;
+    /**
+     * 完成当前绘制操作
+     */
+    private finishDrawing;
+    /**
+     * 内部方法：重置绘图状态和清理临时数据
+     * @param resetMode 是否重置绘图模式和状态标志
+     */
+    private endDrawingInternal;
+    /**
+     * 公共方法：结束当前绘制（如果正在进行）
+     */
+    endDrawing(): void;
+    /**
+     * 销毁事件处理器
+     */
+    private deactivateDrawingHandlers;
+    /**
+     * 清除所有已绘制的实体
+     */
+    clearAll(): void;
+    /**
+     * 清除所有实体（包括未跟踪的实体）
+     * 这是一个更彻底的清理方法，会清除场景中的所有实体
+     */
+    clearAllEntities(): void;
+    /**
+     * 强制清除所有点实体
+     * 用于解决点实体无法删除的问题
+     */
+    clearAllPoints(): void;
+    /**
+     * 删除一个指定的已完成实体
+     * @param entity 要删除的实体
+     */
+    removeEntity(entity: Cesium.Entity): void;
+    /**
+     * 获取所有已完成的实体
+     * @returns 实体数组
+     */
+    getFinishedEntities(): Cesium.Entity[];
+    private calculateRectangle;
+    private calculateRectangleArea;
+    private calculatePolygonArea;
+    private calculatePolygonCenter;
+    /**
+     * 设置开始绘制时的回调函数
+     * @param callback 回调函数
+     */
+    onDrawStart(callback: () => void): void;
+    /**
+     * 设置结束绘制时的回调函数
+     * @param callback 回调函数，参数为完成的实体或null
+     */
+    onDrawEnd(callback: (entity: Cesium.Entity | null) => void): void;
+    /**
+     * 设置实体被移除时的回调函数
+     * @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;
+    /**
+     * 销毁工具，清理所有事件监听器
+     */
+    destroy(): void;
+}
+export default DrawHelper;

package/dist/libs/CesiumMapLoader.d.ts

@@ -0,0 +1,53 @@
+import { Terrain, TerrainProvider, Viewer as CesiumViewer } from '../../node_modules/cesium';
+import * as Cesium from 'cesium';
+interface InitOptions {
+    terrain?: Terrain;
+    terrainProvider?: TerrainProvider;
+    mapType?: string;
+    imageryProvider?: Cesium.UrlTemplateImageryProvider;
+    imageryLayers?: Cesium.ImageryLayerCollection;
+    terrainShadows?: Cesium.ShadowMode;
+    contextOptions?: Cesium.ContextOptions;
+    scene3DOnly?: boolean;
+    selectionIndicator?: boolean;
+    navigationHelpButton?: boolean;
+    fullscreenButton?: boolean;
+    geocoder?: boolean;
+    homeButton?: boolean;
+    infoBox?: boolean;
+    vrButton?: boolean;
+    sceneModePicker?: boolean;
+    timeline?: boolean;
+    animation?: boolean;
+    baseLayerPicker?: boolean;
+    navigationInstructionsInitiallyVisible?: boolean;
+    clock?: Cesium.Clock;
+    sceneMode?: Cesium.SceneMode;
+    screenSpaceEventHandler?: Cesium.ScreenSpaceEventHandler;
+    useDefaultRenderLoop?: boolean;
+    targetFrameRate?: number;
+    showRenderLoopErrors?: boolean;
+    automaticallyTrackDataSourceClocks?: boolean;
+    dataSources?: Cesium.DataSourceCollection;
+    creationTime?: number;
+    useBrowserRecommendedResolution?: boolean;
+    resolutionScale?: number;
+    orderIndependentTransparency?: boolean;
+    shadows?: boolean;
+    terrainExaggeration?: number;
+    maximumScreenSpaceError?: number;
+    maximumNumberOfLoadedTiles?: number;
+    token?: string;
+}
+interface MapCenter {
+    latitude: number;
+    longitude: number;
+    height: number;
+    pitch?: number;
+    heading?: number;
+}
+export declare function initCesium(containerId: string, options: InitOptions, mapCenter?: MapCenter): Promise<{
+    viewer: CesiumViewer;
+    initialCenter: MapCenter;
+}>;
+export {};

package/dist/libs/CesiumMapModel.d.ts

@@ -0,0 +1,154 @@
+import { Cartesian3, Cartographic, Color } from '../../node_modules/cesium';
+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[];
+}
+export interface ButtonConfig {
+    id: string;
+    icon: string;
+    title: 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;
+    enabled?: boolean;
+    visible?: boolean;
+    size?: number;
+    color?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    borderStyle?: string;
+    padding?: string;
+    hoverColor?: string;
+    activeColor?: string;
+    backgroundColor?: string;
+    activeIcon?: string | HTMLElement | false;
+    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 {
+    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;
+}
+export interface MapType {
+    id: string;
+    name: string;
+    thumbnail: string;
+    provider: (token: string) => Cesium.ImageryProvider[];
+}
+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,180 @@
+import { Viewer } from '../../node_modules/cesium';
+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 searchCallback?;
+    private measurementCallback?;
+    private zoomCallback?;
+    private initialCenter?;
+    private isFullscreen;
+    private currentMapType;
+    TD_Token: string;
+    mapTypes: MapType[];
+    constructor(viewer: Viewer, container: HTMLElement, config?: ToolbarConfig, callbacks?: {
+        search?: SearchCallback;
+        measurement?: MeasurementCallback;
+        zoom?: ZoomCallback;
+    }, initialCenter?: {
+        longitude: number;
+        latitude: number;
+        height: number;
+    });
+    setMapTypes(mapTypes: MapType[]): void;
+    setTDToken(TD_Token: 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;
+    /**
+     * 添加自定义按钮
+     */
+    addCustomButton(config: CustomButtonConfig): void;
+    /**
+     * 移除按钮
+     */
+    removeButton(buttonId: string): void;
+    /**
+     * 获取按钮元素
+     */
+    getButtonElement(buttonId: string): HTMLElement | null;
+    /**
+     * 设置绘图助手回调
+     */
+    private setupDrawHelperCallbacks;
+    /**
+     * 计算多边形面积
+     */
+    private calculatePolygonArea;
+    /**
+     * 创建工具栏
+     */
+    private createToolbar;
+    /**
+     * 获取按钮配置
+     */
+    private getButtonConfigs;
+    /**
+     * 创建按钮
+     */
+    private createButton;
+    /**
+     * 设置按钮图标
+     */
+    private setButtonIcon;
+    /**
+     * 判断是否为图片路径
+     */
+    private isImagePath;
+    /**
+     * 加载图片图标
+     */
+    private loadImageIcon;
+    /**
+     * 设置默认图标（当图片加载失败时）
+     */
+    private setDefaultIcon;
+    /**
+     * 设置按钮事件
+     */
+    private setupButtonEvents;
+    /**
+     * 按钮鼠标离开时关闭菜单
+     */
+    private closeMenuOnButtonLeave;
+    /**
+     * 处理按钮点击
+     */
+    private handleButtonClick;
+    /**
+     * 切换搜索功能
+     */
+    private toggleSearch;
+    /**
+     * 显示搜索结果
+     */
+    private displaySearchResults;
+    /**
+     * 选择搜索结果
+     */
+    private selectSearchResult;
+    /**
+     * 默认搜索逻辑
+     */
+    private performDefaultSearch;
+    /**
+     * 切换测量功能
+     */
+    private toggleMeasurement;
+    /**
+     * 处理测量操作
+     */
+    private handleMeasurementAction;
+    /**
+     * 切换2D/3D视图
+     */
+    private toggle2D3D;
+    /**
+     * 切换图层
+     */
+    private toggleLayers;
+    /**
+     * 切换地图类型
+     */
+    private switchMapType;
+    /**
+     * 复位到初始位置
+     */
+    private resetLocation;
+    /**
+     * 放大
+     */
+    private zoomIn;
+    /**
+     * 缩小
+     */
+    private zoomOut;
+    /**
+     * 切换全屏
+     */
+    private toggleFullscreen;
+    /**
+     * 进入全屏
+     */
+    private enterFullscreen;
+    /**
+     * 退出全屏
+     */
+    private exitFullscreen;
+    /**
+     * 销毁工具栏
+     */
+    destroy(): void;
+}

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xingm/vmap-cesium-toolbar",
-  "version": "0.0.1-beta.5",
+  "version": "0.0.1-beta.7",
   "description": "A powerful Cesium map toolbar plugin with drawing, measurement, and interaction features",
   "type": "module",
   "main": "index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xingm/vmap-cesium-toolbar",
-  "version": "0.0.1-beta.6",
+  "version": "0.0.1-beta.7",
   "description": "A powerful Cesium map toolbar plugin with drawing, measurement, and interaction features",
   "type": "module",
   "main": "dist/index.js",
@@ -41,6 +41,7 @@
     "rollup-plugin-dts": "^6.1.0",
     "vite": "^7.1.2",
     "vite-plugin-cesium": "^1.2.23",
+    "vite-plugin-dts": "^4.5.4",
     "vite-plugin-static-copy": "^3.1.2",
     "vue-tsc": "^3.0.5"
   },