@xingm/vmap-cesium-toolbar 0.0.1-beta.9 → 0.0.2-alpha.1

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";
+}

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

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

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

@@ -0,0 +1,5 @@
+export { BaseDraw, type DrawResult, type DrawCallbacks, type DrawOptions } from './BaseDraw';
+export { DrawLine } from './DrawLine';
+export { DrawPolygon } from './DrawPolgon';
+export { DrawRectangle } from './DrawRectangle';
+export { DrawCircle } from './DrawCircle';

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

@@ -0,0 +1,54 @@
+import { Viewer, Entity, Color, HeightReference } from '../../../node_modules/cesium';
+import { OverlayPosition } from './types';
+import * as Cesium from "cesium";
+/**
+ * Circle 选项
+ */
+export interface CircleOptions {
+    position: OverlayPosition;
+    radius: number;
+    material?: Cesium.MaterialProperty | Color | string;
+    outline?: boolean;
+    outlineColor?: Color | string;
+    outlineWidth?: number;
+    heightReference?: HeightReference;
+    extrudedHeight?: number;
+    onClick?: (entity: Entity) => void;
+    id?: string;
+}
+/**
+ * Circle 工具类
+ */
+export declare class MapCircle {
+    private viewer;
+    private entities;
+    constructor(viewer: Viewer);
+    /**
+     * 转换位置为 Cartesian3
+     */
+    private convertPosition;
+    /**
+     * 转换颜色
+     */
+    private resolveColor;
+    /**
+     * 解析材质
+     */
+    private resolveMaterial;
+    /**
+     * 添加 Circle（圆形）
+     */
+    add(options: CircleOptions): Entity;
+    /**
+     * 更新 Circle 位置
+     */
+    updatePosition(entity: Entity, position: OverlayPosition): void;
+    /**
+     * 更新 Circle 半径
+     */
+    updateRadius(entity: Entity, radius: number): void;
+    /**
+     * 更新 Circle 样式
+     */
+    updateStyle(entity: Entity, options: Partial<Pick<CircleOptions, 'material' | 'outline' | 'outlineColor' | 'outlineWidth'>>): void;
+}

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

@@ -0,0 +1,55 @@
+import { Viewer, Entity, Color, HeightReference, VerticalOrigin, HorizontalOrigin } from '../../../node_modules/cesium';
+import { OverlayPosition } from './types';
+import * as Cesium from "cesium";
+/**
+ * Icon 选项
+ */
+export interface IconOptions {
+    position: OverlayPosition;
+    image: 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;
+}
+/**
+ * Icon 工具类
+ */
+export declare class MapIcon {
+    private viewer;
+    private entities;
+    constructor(viewer: Viewer);
+    /**
+     * 转换位置为 Cartesian3
+     */
+    private convertPosition;
+    /**
+     * 转换颜色
+     */
+    private resolveColor;
+    /**
+     * 添加 Icon（图标，使用 Billboard）
+     */
+    add(options: IconOptions): Entity;
+    /**
+     * 更新 Icon 位置
+     */
+    updatePosition(entity: Entity, position: OverlayPosition): void;
+    /**
+     * 更新 Icon 图片
+     */
+    updateImage(entity: Entity, image: string): void;
+    /**
+     * 更新 Icon 样式
+     */
+    updateStyle(entity: Entity, options: Partial<Pick<IconOptions, 'scale' | 'rotation' | 'color'>>): void;
+}

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

@@ -0,0 +1,73 @@
+import { Viewer, Entity } from '../../../node_modules/cesium';
+import { OverlayPosition } from './types';
+import * as Cesium from 'cesium';
+export interface InfoWindowOptions {
+    position: OverlayPosition;
+    content: string | HTMLElement;
+    width?: number;
+    height?: number;
+    pixelOffset?: Cesium.Cartesian2;
+    show?: boolean;
+    onClick?: (entity: Entity) => void;
+    id?: string;
+    closable?: boolean;
+    onClose?: (entity: Entity) => void;
+    backgroundColor?: string;
+    color?: string;
+    font?: string;
+    hideWhenOutOfView?: boolean;
+}
+/**
+ * 面向 Cesium 的 HTML 信息窗口管理器
+ * 要求 container 为 position: relative 的 DOM 容器（通常与 viewer.canvas 同级或包裹）
+ */
+export declare class MapInfoWindow {
+    private viewer;
+    private container;
+    private entityMap;
+    private currentTopZIndex;
+    constructor(viewer: Viewer, container: HTMLElement);
+    private convertPosition;
+    /**
+     * 将世界坐标转换为相对于 container 的 CSS 像素坐标
+     */
+    private getContainerPixelPosition;
+    /**
+     * 更新单个 infoWindow 的显示状态和位置
+     */
+    private updateDomPosition;
+    /**
+     * 创建 DOM 元素
+     */
+    private createDomElement;
+    /**
+     * 将指定 InfoWindow 置于最前
+     */
+    bringToFront(entity: Entity): void;
+    /**
+     * 添加信息窗口
+     */
+    add(options: InfoWindowOptions): Entity;
+    /**
+     * 更新位置
+     */
+    updatePosition(entity: Entity, position: OverlayPosition): void;
+    /**
+     * 更新内容
+     */
+    updateContent(entity: Entity, content: string | HTMLElement): void;
+    /**
+     * 显示/隐藏
+     */
+    setVisible(entity: Entity, visible: boolean): void;
+    show(entity: Entity): void;
+    hide(entity: Entity): void;
+    /**
+     * 移除信息窗口（清理 DOM + 监听器 + 实体）
+     */
+    remove(entity: Entity): void;
+    /**
+     * 销毁整个管理器（清理所有 infoWindow）
+     */
+    destroy(): void;
+}

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

@@ -0,0 +1,59 @@
+import { Viewer, Entity, Color, HeightReference, LabelStyle, VerticalOrigin, HorizontalOrigin } from '../../../node_modules/cesium';
+import { OverlayPosition } from './types';
+import * as Cesium from "cesium";
+/**
+ * Label 选项
+ */
+export interface LabelOptions {
+    position: OverlayPosition;
+    text: string;
+    font?: string;
+    fillColor?: Color | string;
+    outlineColor?: Color | string;
+    outlineWidth?: number;
+    style?: LabelStyle;
+    pixelOffset?: Cesium.Cartesian2;
+    eyeOffset?: Cesium.Cartesian3;
+    horizontalOrigin?: HorizontalOrigin;
+    verticalOrigin?: VerticalOrigin;
+    heightReference?: HeightReference;
+    scale?: number;
+    showBackground?: boolean;
+    backgroundColor?: Color | string;
+    backgroundPadding?: Cesium.Cartesian2;
+    disableDepthTestDistance?: number;
+    onClick?: (entity: Entity) => void;
+    id?: string;
+}
+/**
+ * Label 工具类
+ */
+export declare class MapLabel {
+    private viewer;
+    private entities;
+    constructor(viewer: Viewer);
+    /**
+     * 转换位置为 Cartesian3
+     */
+    private convertPosition;
+    /**
+     * 转换颜色
+     */
+    private resolveColor;
+    /**
+     * 添加 Label（文本标签）
+     */
+    add(options: LabelOptions): Entity;
+    /**
+     * 更新 Label 位置
+     */
+    updatePosition(entity: Entity, position: OverlayPosition): void;
+    /**
+     * 更新 Label 文本
+     */
+    updateText(entity: Entity, text: string): void;
+    /**
+     * 更新 Label 样式
+     */
+    updateStyle(entity: Entity, options: Partial<Pick<LabelOptions, 'fillColor' | 'outlineColor' | 'outlineWidth' | 'font' | 'scale'>>): void;
+}

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

@@ -0,0 +1,46 @@
+import { Viewer, Entity, Color, HeightReference } from '../../../node_modules/cesium';
+import { OverlayPosition } from './types';
+import * as Cesium from "cesium";
+/**
+ * Marker 选项
+ */
+export interface MarkerOptions {
+    position: OverlayPosition;
+    pixelSize?: number;
+    color?: Color | string;
+    outlineColor?: Color | string;
+    outlineWidth?: number;
+    heightReference?: HeightReference;
+    scaleByDistance?: Cesium.NearFarScalar;
+    disableDepthTestDistance?: number;
+    onClick?: (entity: Entity) => void;
+    id?: string;
+}
+/**
+ * Marker 工具类
+ */
+export declare class MapMarker {
+    private viewer;
+    private entities;
+    constructor(viewer: Viewer);
+    /**
+     * 转换位置为 Cartesian3
+     */
+    private convertPosition;
+    /**
+     * 转换颜色
+     */
+    private resolveColor;
+    /**
+     * 添加 Marker（点标记）
+     */
+    add(options: MarkerOptions): Entity;
+    /**
+     * 更新 Marker 位置
+     */
+    updatePosition(entity: Entity, position: OverlayPosition): void;
+    /**
+     * 更新 Marker 样式
+     */
+    updateStyle(entity: Entity, options: Partial<Pick<MarkerOptions, 'color' | 'outlineColor' | 'outlineWidth' | 'pixelSize'>>): void;
+}

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

@@ -0,0 +1,49 @@
+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;
+    /**
+     * 添加 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;
+}

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

@@ -0,0 +1,46 @@
+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;
+}

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

@@ -0,0 +1,44 @@
+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（矩形）
+     */
+    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;
+}

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

@@ -0,0 +1,59 @@
+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;
+}

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

@@ -0,0 +1,20 @@
+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 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';

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

@@ -0,0 +1,5 @@
+import { Cartesian3 } from '../../../node_modules/cesium';
+/**
+ * 覆盖物位置类型
+ */
+export type OverlayPosition = Cartesian3 | [number, number] | [number, number, number];

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 {};