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

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

@@ -0,0 +1,35 @@
+import { Cartesian3 } from '../../../node_modules/cesium';
+import { BaseDraw, DrawResult, DrawOptions } from './BaseDraw';
+/**
+ * 画多边形绘制类
+ */
+export declare class DrawPolygon extends BaseDraw {
+    private currentPolygonEntity;
+    private currentBorderEntity;
+    /**
+     * 结束绘制但未生成最终结果（例如点数不足/自相交被拦截）时的统一清理。
+     * 目标：不留下临时实体/状态副作用（尤其是 depthTestAgainstTerrain）。
+     */
+    private abortFinishCleanup;
+    /**
+     * 开始绘制
+     */
+    startDrawing(options?: DrawOptions): void;
+    /**
+     * 更新绘制实体（预览）
+     */
+    updateDrawingEntity(previewPoint?: Cartesian3): void;
+    /**
+     * 完成绘制
+     */
+    finishDrawing(): DrawResult | null;
+    /**
+     * 清理所有绘制相关的实体
+     */
+    clear(): void;
+    /**
+     * 获取绘制类型
+     */
+    getDrawType(): "line" | "polygon" | "rectangle" | "circle";
+    addPoint(position: Cartesian3): void;
+}

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,6 @@
+export { BaseDraw, type DrawResult, type DrawCallbacks, type DrawOptions, type DrawEntity, toggleSelectedStyle } from './BaseDraw';
+export { DrawLine } from './DrawLine';
+export { DrawPolygon } from './DrawPolgon';
+export { DrawRectangle } from './DrawRectangle';
+export { DrawCircle } from './DrawCircle';
+export { DrawHintHelper } from './DrawHint';

package/dist/libs/i18n/en-US.d.ts

@@ -0,0 +1,69 @@
+declare const enUS: {
+    locale: string;
+    toolbar: {
+        search: string;
+        measure: string;
+        view2d3d: string;
+        layers: string;
+        location: string;
+        zoom_in: string;
+        zoom_out: string;
+        fullscreen: string;
+    };
+    measurement: {
+        start: string;
+        distance_done: string;
+        area_done: string;
+        cleared: string;
+        menu: {
+            area: string;
+            distance: string;
+            clear: string;
+        };
+    };
+    search: {
+        placeholder: string;
+        failed: string;
+        no_results: string;
+    };
+    layers: {
+        title: string;
+        overlay_title: string;
+        overlay: {
+            airport: string;
+        };
+        map_type: {
+            place_name: string;
+        };
+    };
+    map_type: {
+        normal: string;
+        "3d": string;
+        imagery: string;
+        terrain: string;
+    };
+    no_fly: {
+        description: string;
+    };
+    draw: {
+        hint: {
+            circle_start: string;
+            circle_radius: string;
+            rectangle_start: string;
+            rectangle_end: string;
+            finish_or_undo: string;
+            polygon_start: string;
+            polygon_add: string;
+            polygon_continue: string;
+            line_start: string;
+            line_add: string;
+            line_continue: string;
+            polygon_no_intersection: string;
+        };
+        label: {
+            total_length: string;
+            area: string;
+        };
+    };
+};
+export default enUS;

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

@@ -0,0 +1,25 @@
+type Locale = "zh-CN" | "en-US" | (string & {});
+type I18nDict = Record<string, any>;
+interface I18nLike {
+    getLocale(): Locale;
+    setLocale(locale: Locale, options?: {
+        persist?: boolean;
+    }): void;
+    t(key: string, params?: Record<string, any>, localeOverride?: Locale): string;
+    onLocaleChange(cb: (locale: Locale) => void): () => void;
+    bindElement(el: HTMLElement, key: string, attr?: "text" | "title" | "placeholder", params?: Record<string, any>): void;
+    updateElement(el: HTMLElement): void;
+    updateTree(root: HTMLElement): void;
+    addMessages?(locale: Locale, dict: I18nDict, options?: {
+        merge?: boolean;
+    }): void;
+    setFallbackLocale?(locale: Locale): void;
+    configure?(options: {
+        persist?: boolean;
+        useStoredLocale?: boolean;
+        fallbackLocale?: Locale;
+        locale?: Locale;
+    }): void;
+}
+export declare const i18n: I18nLike;
+export type { Locale, I18nLike };

package/dist/libs/i18n/zh-CN.d.ts

@@ -0,0 +1,69 @@
+declare const zhCN: {
+    locale: string;
+    toolbar: {
+        search: string;
+        measure: string;
+        view2d3d: string;
+        layers: string;
+        location: string;
+        zoom_in: string;
+        zoom_out: string;
+        fullscreen: string;
+    };
+    measurement: {
+        start: string;
+        distance_done: string;
+        area_done: string;
+        cleared: string;
+        menu: {
+            area: string;
+            distance: string;
+            clear: string;
+        };
+    };
+    search: {
+        placeholder: string;
+        failed: string;
+        no_results: string;
+    };
+    layers: {
+        title: string;
+        overlay_title: string;
+        overlay: {
+            airport: string;
+        };
+        map_type: {
+            place_name: string;
+        };
+    };
+    map_type: {
+        normal: string;
+        "3d": string;
+        imagery: string;
+        terrain: string;
+    };
+    no_fly: {
+        description: string;
+    };
+    draw: {
+        hint: {
+            circle_start: string;
+            circle_radius: string;
+            rectangle_start: string;
+            rectangle_end: string;
+            finish_or_undo: string;
+            polygon_start: string;
+            polygon_add: string;
+            polygon_continue: string;
+            line_start: string;
+            line_add: string;
+            line_continue: string;
+            polygon_no_intersection: string;
+        };
+        label: {
+            total_length: string;
+            area: string;
+        };
+    };
+};
+export default zhCN;

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

@@ -0,0 +1,130 @@
+import { Viewer, Entity, Color, HeightReference } from '../../../node_modules/cesium';
+import { OverlayPosition, OverlayEntity } from './types';
+import * as Cesium from "cesium";
+/**
+ * Circle 选项
+ */
+export interface CircleOptions {
+    position: OverlayPosition;
+    radius: number;
+    /**
+     * 渲染模式：
+     * - auto：自动选择（默认；当前实现等同于 entity）
+     * - entity：使用 Cesium Entity
+     * - primitive：使用 Cesium Primitive（为大批量静态覆盖物预留）
+     */
+    renderMode?: 'auto' | 'entity' | 'primitive';
+    material?: Cesium.MaterialProperty | Color | string;
+    outline?: boolean;
+    outlineColor?: Color | string;
+    outlineWidth?: number;
+    /**
+     * 粗边框（outlineWidth>1）模式下用于近似圆的分段数，越大越圆滑但更耗性能。
+     * 默认 256。
+     */
+    segments?: number;
+    /**
+     * 是否贴地（默认：在粗边框模式下为 true）。
+     * - true：填充与边框都贴地。
+     * - false：填充与边框都使用 position 高度悬空。
+     */
+    clampToGround?: boolean;
+    /** 贴地抬高量（米，clampToGround=true 时生效） */
+    groundHeightEpsilon?: number;
+    heightReference?: HeightReference;
+    extrudedHeight?: number;
+    heightEpsilon?: number;
+    /** 点击该覆盖物时是否高亮显示（默认 false）。支持传入自定义颜色等参数 */
+    clickHighlight?: boolean | {
+        color?: Color | string;
+        fillAlpha?: number;
+    };
+    /** 鼠标移入该覆盖物时是否高亮显示（默认 false）。支持传入自定义颜色等参数 */
+    hoverHighlight?: boolean | {
+        color?: Color | string;
+        fillAlpha?: number;
+    };
+    onClick?: (entity: Entity) => void;
+    /**
+     * Primitive 模式分层渲染 key。
+     * - 相同 layerKey 的 circle 会被合并到同一个批次中（更高性能）
+     * - 不同 layerKey 会进入不同的“图层空间”，并按首次出现顺序确定上下层
+     * - 只对 primitive 生效；entity 模式忽略
+     */
+    layerKey?: string;
+    id?: string;
+}
+/**
+ * Circle 工具类
+ */
+export declare class MapCircle {
+    private viewer;
+    private entities;
+    private primitiveBatch;
+    private primitiveLayerStack;
+    private primitiveBatchesByLayer;
+    private static bearingTableCache;
+    constructor(viewer: Viewer);
+    private getPrimitiveBatch;
+    private getLayeredPrimitiveBatch;
+    private getPrimitiveBatchForOverlay;
+    private resolveMaterialColor;
+    private canUsePrimitive;
+    /**
+     * 添加一个基础的圆形图元
+     * @param options 圆形配置选项
+     * @returns 返回创建的实体对象
+     */
+    private addPrimitiveCircle;
+    /**
+     * 转换位置为 Cartesian3
+     */
+    private convertPosition;
+    /**
+     * 转换颜色
+     */
+    private resolveColor;
+    /**
+     * 解析材质
+     */
+    private resolveMaterial;
+    /**
+     * 添加 Circle（圆形）
+     */
+    add(options: CircleOptions): Entity;
+    /**
+     * 生成近似圆（多边形）顶点，返回 Cartesian3 数组。
+     * 使用大圆航线公式，segments 越大越平滑。
+     */
+    private generateCirclePositions;
+    /**
+     * 获取方位角查找表，用于存储正弦和余弦值
+     * @param segments 分段数量，用于确定查找表的精度
+     * @returns 返回一个包含正弦和余弦数组的对象
+     */
+    private getBearingTable;
+    /**
+     * 粗边框模式的默认分段数：平衡“圆滑程度/性能”。
+     * 用户如果传了 options.segments，则完全尊重用户设置。
+     */
+    private getDefaultSegmentsForRadius;
+    /**
+     * 更新 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;
+    /**
+     * 移除 Circle（通过实体或实体 id）
+     */
+    remove(entityOrId: Entity | string): boolean;
+    setPrimitiveVisible(entity: Entity, visible: boolean): void;
+    applyPrimitiveHighlight(entity: OverlayEntity, hlColor: Cesium.Color, fillAlpha: number): void;
+    restorePrimitiveHighlight(entity: OverlayEntity): void;
+}

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

@@ -0,0 +1,69 @@
+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;
+    /** 点击该覆盖物时是否高亮显示（默认 false）。支持传入自定义颜色等参数 */
+    clickHighlight?: boolean | {
+        color?: Color | string;
+        fillAlpha?: number;
+    };
+    /** 鼠标移入该覆盖物时是否高亮显示（默认 false）。支持传入自定义颜色等参数 */
+    hoverHighlight?: boolean | {
+        color?: Color | string;
+        fillAlpha?: number;
+    };
+    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;
+    /**
+     * 移除 Icon（通过实体或实体 id）
+     */
+    remove(entityOrId: Entity | string): boolean;
+}

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

@@ -0,0 +1,100 @@
+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;
+    className?: string;
+    style?: Partial<CSSStyleDeclaration>;
+    showArrow?: boolean;
+    arrowSize?: number;
+    positionOffset?: 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'left-top' | 'left-bottom' | 'right-top' | 'right-bottom';
+    hideWhenOutOfView?: boolean;
+    anchorHeight?: number;
+    anchorPixel?: number;
+    tailGap?: number;
+    updateInterval?: number;
+}
+/**
+ * 面向 Cesium 的 HTML 信息窗口管理器
+ * 要求 container 为 position: relative 的 DOM 容器（通常与 viewer.canvas 同级或包裹）
+ */
+export declare class MapInfoWindow {
+    private viewer;
+    private container;
+    private entityMap;
+    private currentTopZIndex;
+    private defaultUpdateInterval;
+    private isCameraMoving;
+    private cameraMoveStartListener?;
+    private cameraMoveEndListener?;
+    /**
+     * 合并用户传入的 InfoWindowOptions 与默认值，提升入参灵活性。
+     * 注意：必填项 position / content 由调用方提供，不在默认值内。
+     */
+    private mergeOptions;
+    constructor(viewer: Viewer, container: HTMLElement);
+    /**
+     * 设置默认的位置更新间隔（毫秒）：当 InfoWindow 未指定 `updateInterval` 时使用。
+     * 0 表示每帧更新。
+     */
+    setDefaultUpdateInterval(ms: number): void;
+    /**
+     * 强制立即更新（重新计算位置）所有已管理的信息窗。
+     */
+    forceUpdateAll(): void;
+    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,73 @@
+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;
+    /** 点击该覆盖物时是否高亮显示（默认 false）。支持传入自定义颜色等参数 */
+    clickHighlight?: boolean | {
+        color?: Color | string;
+        fillAlpha?: number;
+    };
+    /** 鼠标移入该覆盖物时是否高亮显示（默认 false）。支持传入自定义颜色等参数 */
+    hoverHighlight?: boolean | {
+        color?: Color | string;
+        fillAlpha?: 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;
+    /**
+     * 移除 Label（通过实体或实体 id）
+     */
+    remove(entityOrId: Entity | string): boolean;
+}

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

@@ -0,0 +1,60 @@
+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;
+    /** 点击该覆盖物时是否高亮显示（默认 false）。支持传入自定义颜色等参数 */
+    clickHighlight?: boolean | {
+        color?: Color | string;
+        fillAlpha?: number;
+    };
+    /** 鼠标移入该覆盖物时是否高亮显示（默认 false）。支持传入自定义颜色等参数 */
+    hoverHighlight?: boolean | {
+        color?: Color | string;
+        fillAlpha?: 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;
+    /**
+     * 移除 Marker（通过实体或实体 id）
+     */
+    remove(entityOrId: Entity | string): boolean;
+}