@xingm/vmap-cesium-toolbar 0.0.5 → 1.0.0

package/dist/core/entities/Circle.d.ts

@@ -0,0 +1,102 @@
+import { Viewer, Color, MaterialProperty, HeightReference } from '../../../node_modules/cesium';
+import { BaseOverlay, BaseOverlayOptions, OverlayPosition } from './BaseOverlay';
+/**
+ * Circle 配置选项
+ */
+export interface CircleOptions extends BaseOverlayOptions {
+    /** 圆心位置 */
+    position: OverlayPosition;
+    /** 半径（米） */
+    radius: number;
+    /** 填充材质 */
+    material?: MaterialProperty | Color | string;
+    /** 是否显示边框（默认 true） */
+    outline?: boolean;
+    /** 边框颜色 */
+    outlineColor?: Color | string;
+    /** 边框宽度（默认 1） */
+    outlineWidth?: number;
+    /** 是否贴地（默认 true） */
+    clampToGround?: boolean;
+    /** 贴地抬高量（米，clampToGround=true 时生效） */
+    groundHeightEpsilon?: number;
+    /** 高度参考 */
+    heightReference?: HeightReference;
+    /** 拉伸高度 */
+    extrudedHeight?: number;
+    /** 兼容旧版渲染模式配置 */
+    renderMode?: 'auto' | 'entity' | 'primitive';
+    /** 兼容旧版圆周分段数 */
+    segments?: number;
+}
+/**
+ * Circle 圆形类
+ *
+ * 用于在地图上创建圆形区域，支持自定义填充、边框和贴地属性。
+ * 使用 Cesium Ellipse 实现。
+ *
+ * @example
+ * ```typescript
+ * const circle = new Circle(viewer, {
+ *   position: [120.1, 30.2],
+ *   radius: 1000,
+ *   material: 'rgba(255, 0, 0, 0.3)',
+ *   outline: true,
+ *   outlineColor: '#FF0000'
+ * });
+ * viewer.entities.add(circle.getEntity());
+ * ```
+ */
+export declare class Circle extends BaseOverlay {
+    private circleOptions;
+    private innerEntity?;
+    constructor(viewer: Viewer, options: CircleOptions);
+    /**
+     * 创建粗边框圆形（环形）
+     */
+    private createThickCircle;
+    /**
+     * 创建 EllipseGraphics 对象
+     */
+    private createEllipseGraphics;
+    /**
+     * 生成近似圆（多边形）顶点
+     */
+    private generateCirclePositions;
+    /**
+     * 解析材质
+     */
+    private resolveMaterial;
+    /**
+     * 解析颜色值
+     */
+    private resolveColor;
+    /**
+     * 更新 Circle 配置
+     */
+    update(options: Partial<CircleOptions>): void;
+    /**
+     * 更新几何形状（位置和半径）
+     */
+    private updateGeometry;
+    /**
+     * 更新位置
+     */
+    setPosition(position: OverlayPosition): void;
+    /**
+     * 更新半径
+     */
+    setRadius(radius: number): void;
+    /**
+     * 获取位置（经纬度）
+     */
+    getPosition(): [number, number] | null;
+    /**
+     * 获取半径
+     */
+    getRadius(): number;
+    /**
+     * 从场景中移除圆形
+     */
+    remove(): void;
+}

package/dist/core/entities/Icon.d.ts

@@ -0,0 +1,86 @@
+import { Viewer, Color, HeightReference, VerticalOrigin, HorizontalOrigin } from '../../../node_modules/cesium';
+import { BaseOverlay, BaseOverlayOptions, OverlayPosition } from './BaseOverlay';
+import * as Cesium from 'cesium';
+/**
+ * Icon 配置选项
+ */
+export interface IconOptions extends BaseOverlayOptions {
+    /** 图片 URL 或 base64 */
+    image: string;
+    /** 宽度（像素） */
+    width?: number;
+    /** 高度（像素） */
+    height?: number;
+    /** 缩放比例（默认 1.0） */
+    scale?: number;
+    /** 旋转角度（弧度） */
+    rotation?: number;
+    /** 像素偏移 */
+    pixelOffset?: Cesium.Cartesian2;
+    /** 视线偏移 */
+    eyeOffset?: Cesium.Cartesian3;
+    /** 水平原点（默认 CENTER） */
+    horizontalOrigin?: HorizontalOrigin;
+    /** 垂直原点（默认 BOTTOM） */
+    verticalOrigin?: VerticalOrigin;
+    /** 高度参考（默认 NONE） */
+    heightReference?: HeightReference;
+    /** 禁用深度测试距离 */
+    disableDepthTestDistance?: number;
+    /** 颜色（可用于着色） */
+    color?: Color | string;
+}
+/**
+ * Icon 图标类
+ *
+ * 用于在地图上创建图标标记，使用 Billboard 实现。
+ * 支持自定义图片、大小、旋转、颜色等样式。
+ *
+ * @example
+ * ```typescript
+ * const icon = new Icon(viewer, {
+ *   position: [120.1, 30.2],
+ *   image: '/images/marker.png',
+ *   width: 32,
+ *   height: 32,
+ *   onClick: (entity) => console.log('Icon clicked')
+ * });
+ * viewer.entities.add(icon.getEntity());
+ * ```
+ */
+export declare class Icon extends BaseOverlay {
+    private iconOptions;
+    constructor(viewer: Viewer, options: IconOptions);
+    /**
+     * 创建 BillboardGraphics 对象
+     */
+    private createBillboardGraphics;
+    /**
+     * 解析颜色值
+     */
+    private resolveColor;
+    /**
+     * 更新 Icon 配置
+     */
+    update(options: Partial<IconOptions>): void;
+    /**
+     * 更新位置
+     */
+    setPosition(position: OverlayPosition): void;
+    /**
+     * 更新图片
+     */
+    setImage(image: string): void;
+    /**
+     * 获取图片 URL
+     */
+    getImage(): string;
+    /**
+     * 获取位置（经纬度）
+     */
+    getPosition(): [number, number] | null;
+    /**
+     * 获取图标样式
+     */
+    getStyle(): Partial<IconOptions>;
+}

package/dist/core/entities/InfoWindow.d.ts

@@ -0,0 +1,116 @@
+import { Viewer, Entity } from '../../../node_modules/cesium';
+import { BaseOverlay, BaseOverlayOptions, OverlayPosition } from './BaseOverlay';
+import * as Cesium from 'cesium';
+/**
+ * InfoWindow 配置选项
+ */
+export interface InfoWindowOptions extends BaseOverlayOptions {
+    /** 内容（HTML 字符串或 DOM 元素） */
+    content: string | HTMLElement;
+    /** 宽度（像素） */
+    width?: number;
+    /** 高度（像素） */
+    height?: number;
+    /** 像素偏移 */
+    pixelOffset?: Cesium.Cartesian2;
+    /** 是否显示（默认 true） */
+    show?: boolean;
+    /** 是否可关闭 */
+    closable?: boolean;
+    /** 关闭回调 */
+    onClose?: (entity: Entity) => void;
+    /** 背景颜色 */
+    backgroundColor?: string;
+    /** 文字颜色 */
+    color?: string;
+    /** 字体 */
+    font?: string;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: Partial<CSSStyleDeclaration>;
+    /** 是否显示箭头（默认 false） */
+    showArrow?: boolean;
+    /** 箭头大小（像素，默认 8） */
+    arrowSize?: number;
+    /** 位置偏移方向（默认 'top'） */
+    positionOffset?: 'top' | 'bottom' | 'left' | 'right';
+    /** 兼容旧版箭头锚点像素 */
+    anchorPixel?: number;
+    /** 兼容旧版箭头尾部间距 */
+    tailGap?: number;
+    /** 兼容旧版位置刷新间隔 */
+    updateInterval?: number;
+    /** 兼容旧版视野外自动隐藏配置 */
+    hideWhenOutOfView?: boolean;
+}
+/**
+ * InfoWindow 信息窗口类
+ *
+ * 用于在地图上创建 HTML 信息窗口，支持自定义内容、样式和位置。
+ *
+ * @example
+ * ```typescript
+ * const infoWindow = new InfoWindow(viewer, {
+ *   position: [120.1, 30.2],
+ *   content: '<h3>杭州市</h3><p>浙江省省会</p>',
+ *   width: 200,
+ *   closable: true
+ * });
+ * viewer.entities.add(infoWindow.getEntity());
+ * ```
+ */
+export declare class InfoWindow extends BaseOverlay {
+    private infoOptions;
+    private container;
+    private internalData?;
+    constructor(viewer: Viewer, options: InfoWindowOptions, container?: HTMLElement);
+    /**
+     * 合并选项与默认值
+     */
+    private mergeOptions;
+    /**
+     * 创建 DOM 元素
+     */
+    private createDomElement;
+    /**
+     * 设置监听器
+     */
+    private setupListeners;
+    /**
+     * 将世界坐标转换为相对于 container 的 CSS 像素坐标
+     */
+    private getContainerPixelPosition;
+    /**
+     * 更新 DOM 位置
+     */
+    private updateDomPosition;
+    /**
+     * 更新 InfoWindow 配置
+     */
+    update(options: Partial<InfoWindowOptions>): void;
+    /**
+     * 更新位置
+     */
+    setPosition(position: OverlayPosition): void;
+    /**
+     * 更新内容
+     */
+    setContent(content: string | HTMLElement): void;
+    /**
+     * 显示
+     */
+    show(): void;
+    /**
+     * 隐藏
+     */
+    hide(): void;
+    /**
+     * 从场景中移除信息窗口
+     */
+    remove(): void;
+    /**
+     * 获取位置（经纬度）
+     */
+    getPosition(): [number, number] | null;
+}

package/dist/core/entities/Label.d.ts

@@ -0,0 +1,92 @@
+import { Viewer, Color, HeightReference, LabelStyle, VerticalOrigin, HorizontalOrigin } from '../../../node_modules/cesium';
+import { BaseOverlay, BaseOverlayOptions, OverlayPosition } from './BaseOverlay';
+import * as Cesium from 'cesium';
+/**
+ * Label 配置选项
+ */
+export interface LabelOptions extends BaseOverlayOptions {
+    /** 文本内容 */
+    text: string;
+    /** 字体（默认 '14px sans-serif'） */
+    font?: string;
+    /** 填充颜色（默认白色） */
+    fillColor?: Color | string;
+    /** 描边颜色（默认黑色） */
+    outlineColor?: Color | string;
+    /** 描边宽度（默认 2） */
+    outlineWidth?: number;
+    /** 标签样式（默认 FILL_AND_OUTLINE） */
+    style?: LabelStyle;
+    /** 像素偏移 */
+    pixelOffset?: Cesium.Cartesian2;
+    /** 视线偏移 */
+    eyeOffset?: Cesium.Cartesian3;
+    /** 水平原点（默认 CENTER） */
+    horizontalOrigin?: HorizontalOrigin;
+    /** 垂直原点（默认 BOTTOM） */
+    verticalOrigin?: VerticalOrigin;
+    /** 高度参考（默认 NONE） */
+    heightReference?: HeightReference;
+    /** 缩放比例（默认 1.0） */
+    scale?: number;
+    /** 显示背景（默认 false） */
+    showBackground?: boolean;
+    /** 背景颜色 */
+    backgroundColor?: Color | string;
+    /** 背景内边距 */
+    backgroundPadding?: Cesium.Cartesian2;
+    /** 禁用深度测试距离 */
+    disableDepthTestDistance?: number;
+}
+/**
+ * Label 文本标签类
+ *
+ * 用于在地图上创建文本标签，支持自定义字体、颜色、背景等样式。
+ *
+ * @example
+ * ```typescript
+ * const label = new Label(viewer, {
+ *   position: [120.1, 30.2],
+ *   text: '杭州市',
+ *   font: 'bold 16px sans-serif',
+ *   fillColor: '#FFFFFF'
+ * });
+ * viewer.entities.add(label.getEntity());
+ * ```
+ */
+export declare class Label extends BaseOverlay {
+    private labelOptions;
+    constructor(viewer: Viewer, options: LabelOptions);
+    /**
+     * 创建 LabelGraphics 对象
+     */
+    private createLabelGraphics;
+    /**
+     * 解析颜色值
+     */
+    private resolveColor;
+    /**
+     * 更新 Label 配置
+     */
+    update(options: Partial<LabelOptions>): void;
+    /**
+     * 更新位置
+     */
+    setPosition(position: OverlayPosition): void;
+    /**
+     * 更新文本
+     */
+    setText(text: string): void;
+    /**
+     * 获取文本内容
+     */
+    getText(): string;
+    /**
+     * 获取位置（经纬度）
+     */
+    getPosition(): [number, number] | null;
+    /**
+     * 获取标签样式
+     */
+    getStyle(): Partial<LabelOptions>;
+}

package/dist/core/entities/Marker.d.ts

@@ -0,0 +1,66 @@
+import { Viewer, Color, HeightReference } from '../../../node_modules/cesium';
+import { BaseOverlay, BaseOverlayOptions, OverlayPosition } from './BaseOverlay';
+import * as Cesium from 'cesium';
+/**
+ * Marker 配置选项
+ */
+export interface MarkerOptions extends BaseOverlayOptions {
+    /** 点像素大小（默认 10） */
+    pixelSize?: number;
+    /** 填充颜色（默认红色） */
+    color?: Color | string;
+    /** 描边颜色（默认白色） */
+    outlineColor?: Color | string;
+    /** 描边宽度（默认 2） */
+    outlineWidth?: number;
+    /** 高度参考（默认 NONE） */
+    heightReference?: HeightReference;
+    /** 根据距离缩放 */
+    scaleByDistance?: Cesium.NearFarScalar;
+    /** 禁用深度测试距离 */
+    disableDepthTestDistance?: number;
+}
+/**
+ * Marker 点标记类
+ *
+ * 用于在地图上创建一个点标记，支持自定义颜色、大小、描边等样式。
+ *
+ * @example
+ * ```typescript
+ * const marker = new Marker(viewer, {
+ *   position: [120.1, 30.2],
+ *   pixelSize: 12,
+ *   color: '#FF0000',
+ *   onClick: (entity) => console.log('Marker clicked')
+ * });
+ * viewer.entities.add(marker.getEntity());
+ * ```
+ */
+export declare class Marker extends BaseOverlay {
+    private markerOptions;
+    constructor(viewer: Viewer, options: MarkerOptions);
+    /**
+     * 创建 PointGraphics 对象
+     */
+    private createPointGraphics;
+    /**
+     * 解析颜色值
+     */
+    private resolveColor;
+    /**
+     * 更新 Marker 配置
+     */
+    update(options: Partial<MarkerOptions>): void;
+    /**
+     * 更新位置
+     */
+    setPosition(position: OverlayPosition): void;
+    /**
+     * 获取位置（经纬度）
+     */
+    getPosition(): [number, number] | null;
+    /**
+     * 获取点样式
+     */
+    getStyle(): Partial<MarkerOptions>;
+}

package/dist/core/entities/Polygon.d.ts

@@ -0,0 +1,93 @@
+import { Viewer, Color, MaterialProperty, HeightReference } from '../../../node_modules/cesium';
+import { BaseOverlay, BaseOverlayOptions, OverlayPosition } from './BaseOverlay';
+/**
+ * Polygon 配置选项
+ */
+export interface PolygonOptions extends BaseOverlayOptions {
+    /** 位置数组（至少 3 个点） */
+    positions: OverlayPosition[];
+    /** 填充材质 */
+    material?: MaterialProperty | Color | string;
+    /** 是否显示边框（默认 true） */
+    outline?: boolean;
+    /** 边框颜色 */
+    outlineColor?: Color | string;
+    /** 边框宽度（默认 1） */
+    outlineWidth?: number;
+    /** 是否贴地（默认 true） */
+    clampToGround?: boolean;
+    /** 贴地抬高量（米，clampToGround=true 时生效） */
+    groundHeightEpsilon?: number;
+    /** 高度参考 */
+    heightReference?: HeightReference;
+    /** 拉伸高度 */
+    extrudedHeight?: number;
+    /** 兼容旧版渲染模式配置 */
+    renderMode?: 'auto' | 'entity' | 'primitive';
+}
+/**
+ * Polygon 多边形类
+ *
+ * 用于在地图上创建多边形，支持自定义填充、边框和贴地属性。
+ *
+ * @example
+ * ```typescript
+ * const polygon = new Polygon(viewer, {
+ *   positions: [
+ *     [120.1, 30.2],
+ *     [120.2, 30.3],
+ *     [120.3, 30.25]
+ *   ],
+ *   material: 'rgba(255, 0, 0, 0.5)',
+ *   outline: true,
+ *   outlineColor: '#FF0000',
+ *   outlineWidth: 2
+ * });
+ * viewer.entities.add(polygon.getEntity());
+ * ```
+ */
+export declare class Polygon extends BaseOverlay {
+    private polygonOptions;
+    private borderEntity?;
+    constructor(viewer: Viewer, options: PolygonOptions);
+    /**
+     * 创建 PolygonGraphics 对象
+     */
+    private createPolygonGraphics;
+    /**
+     * 创建粗边框折线
+     */
+    private createBorderPolyline;
+    /**
+     * 解析材质
+     */
+    private resolveMaterial;
+    /**
+     * 解析颜色值
+     */
+    private resolveColor;
+    /**
+     * 抬高位置点
+     */
+    private elevatePositions;
+    /**
+     * 更新 Polygon 配置
+     */
+    update(options: Partial<PolygonOptions>): void;
+    /**
+     * 更新位置
+     */
+    setPositions(positions: OverlayPosition[]): void;
+    /**
+     * 获取位置数组（经纬度）
+     */
+    getPositions(): [number, number][];
+    /**
+     * 获取多边形样式
+     */
+    getStyle(): Partial<PolygonOptions>;
+    /**
+     * 从场景中移除多边形
+     */
+    remove(): void;
+}

package/dist/core/entities/Polyline.d.ts

@@ -0,0 +1,72 @@
+import { Viewer, Color, MaterialProperty } from '../../../node_modules/cesium';
+import { BaseOverlay, BaseOverlayOptions, OverlayPosition } from './BaseOverlay';
+/**
+ * Polyline 配置选项
+ */
+export interface PolylineOptions extends BaseOverlayOptions {
+    /** 位置数组（至少 2 个点） */
+    positions: OverlayPosition[];
+    /** 线宽（默认 2） */
+    width?: number;
+    /** 材质（颜色、字符串或 MaterialProperty） */
+    material?: MaterialProperty | Color | string;
+    /** 是否贴地（默认 false） */
+    clampToGround?: boolean;
+    /** 贴地抬高量（米，clampToGround=true 时生效） */
+    groundHeightEpsilon?: number;
+}
+/**
+ * Polyline 折线类
+ *
+ * 用于在地图上创建折线，支持自定义宽度、材质和贴地属性。
+ *
+ * @example
+ * ```typescript
+ * const polyline = new Polyline(viewer, {
+ *   positions: [
+ *     [120.1, 30.2],
+ *     [120.2, 30.3],
+ *     [120.3, 30.4]
+ *   ],
+ *   width: 4,
+ *   material: '#FF0000'
+ * });
+ * viewer.entities.add(polyline.getEntity());
+ * ```
+ */
+export declare class Polyline extends BaseOverlay {
+    private polylineOptions;
+    constructor(viewer: Viewer, options: PolylineOptions);
+    /**
+     * 创建 PolylineGraphics 对象
+     */
+    private createPolylineGraphics;
+    /**
+     * 解析材质
+     */
+    private resolveMaterial;
+    /**
+     * 解析颜色值
+     */
+    private resolveColor;
+    /**
+     * 抬高位置点
+     */
+    private elevatePositions;
+    /**
+     * 更新 Polyline 配置
+     */
+    update(options: Partial<PolylineOptions>): void;
+    /**
+     * 更新位置
+     */
+    setPositions(positions: OverlayPosition[]): void;
+    /**
+     * 获取位置数组（经纬度）
+     */
+    getPositions(): [number, number][];
+    /**
+     * 获取折线样式
+     */
+    getStyle(): Partial<PolylineOptions>;
+}