@xingm/vmap-cesium-toolbar 0.0.5 → 1.0.0

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

@@ -0,0 +1,99 @@
+import { Viewer, Color, MaterialProperty, HeightReference } from '../../../node_modules/cesium';
+import { BaseOverlay, BaseOverlayOptions } from './BaseOverlay';
+import * as Cesium from 'cesium';
+/**
+ * Rectangle 配置选项
+ */
+export interface RectangleOptions extends BaseOverlayOptions {
+    /** 矩形坐标范围 */
+    coordinates: Cesium.Rectangle;
+    /** 填充材质 */
+    material?: MaterialProperty | Color | string;
+    /** 是否显示边框（默认 true） */
+    outline?: boolean;
+    /** 边框颜色 */
+    outlineColor?: Color | string;
+    /** 边框宽度（默认 1） */
+    outlineWidth?: number;
+    /** 是否贴地（默认 true） */
+    clampToGround?: boolean;
+    /** 贴地抬高量（米，clampToGround=true 时生效） */
+    groundHeightEpsilon?: number;
+    /** 基准高度（米，clampToGround=false 时有效） */
+    height?: number;
+    /** 高度参考 */
+    heightReference?: HeightReference;
+    /** 拉伸高度 */
+    extrudedHeight?: number;
+    /** 兼容旧版渲染模式配置 */
+    renderMode?: 'auto' | 'entity' | 'primitive';
+}
+/**
+ * Rectangle 矩形类
+ *
+ * 用于在地图上创建矩形区域，支持自定义填充、边框和贴地属性。
+ *
+ * @example
+ * ```typescript
+ * const rectangle = new Rectangle(viewer, {
+ *   coordinates: Cesium.Rectangle.fromDegrees(120, 30, 121, 31),
+ *   material: 'rgba(0, 255, 0, 0.3)',
+ *   outline: true,
+ *   outlineColor: '#00FF00'
+ * });
+ * viewer.entities.add(rectangle.getEntity());
+ * ```
+ */
+export declare class Rectangle extends BaseOverlay {
+    private rectangleOptions;
+    private innerEntity?;
+    constructor(viewer: Viewer, options: RectangleOptions);
+    /**
+     * 创建粗边框矩形（环形）
+     */
+    private createThickRectangle;
+    /**
+     * 创建 RectangleGraphics 对象
+     */
+    private createRectangleGraphics;
+    /**
+     * 将 Rectangle 转为四点多边形顶点
+     */
+    private rectangleToPositions;
+    /**
+     * 按米单位向内收缩矩形边界
+     */
+    private shrinkRectangle;
+    /**
+     * 解析材质
+     */
+    private resolveMaterial;
+    /**
+     * 解析颜色值
+     */
+    private resolveColor;
+    /**
+     * 更新 Rectangle 配置
+     */
+    update(options: Partial<RectangleOptions>): void;
+    /**
+     * 更新坐标
+     */
+    setCoordinates(coordinates: Cesium.Rectangle): void;
+    /**
+     * 更新坐标（内部方法）
+     */
+    private updateCoordinates;
+    /**
+     * 获取矩形坐标
+     */
+    getCoordinates(): Cesium.Rectangle | null;
+    /**
+     * 获取矩形样式
+     */
+    getStyle(): Partial<RectangleOptions>;
+    /**
+     * 从场景中移除矩形
+     */
+    remove(): void;
+}

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

@@ -0,0 +1,114 @@
+import { Viewer, Color } from '../../../node_modules/cesium';
+import { BaseOverlay, BaseOverlayOptions, OverlayPosition } from './BaseOverlay';
+/**
+ * Ring 配置选项
+ */
+export interface RingOptions extends BaseOverlayOptions {
+    /** 中心点位置 */
+    position: OverlayPosition;
+    /** 半径（米） */
+    radius: number;
+    /** 发光颜色 */
+    color?: Color | string;
+    /** 是否显示内层线（默认 true） */
+    showInnerLine?: boolean;
+    /** 内层线颜色 */
+    lineColor?: Color | string;
+    /** 内层线型（默认 'solid'） */
+    lineStyle?: 'solid' | 'dashed';
+    /** 虚线材质模式（默认 'stripe'） */
+    lineMaterialMode?: 'stripe' | 'dash';
+    /** 条纹重复次数（默认 32） */
+    stripeRepeat?: number;
+    /** 虚线长度（默认 16） */
+    dashLength?: number;
+    /** 虚线模式（16bit pattern） */
+    dashPattern?: number;
+    /** 间隙颜色 */
+    gapColor?: Color | string;
+    /** 外环宽度（默认 8） */
+    width?: number;
+    /** 兼容旧版边线宽度配置 */
+    lineWidth?: number;
+    /** 发光强度（0-1，默认 0.25） */
+    glowPower?: number;
+    /** 是否贴地（默认 true） */
+    clampToGround?: boolean;
+    /** 贴地抬高量（米） */
+    groundHeightEpsilon?: number;
+    /** 圆环分段数（默认 128） */
+    segments?: number;
+    /** 兼容旧版发光宽度配置 */
+    glowWidth?: number;
+}
+/**
+ * Ring 发光圆环类
+ *
+ * 用于在地图上创建边缘发光的圆环效果。
+ * 使用 PolylineGlowMaterialProperty 实现发光效果。
+ *
+ * @example
+ * ```typescript
+ * const ring = new Ring(viewer, {
+ *   position: [120.1, 30.2],
+ *   radius: 1000,
+ *   color: '#00FFFF',
+ *   glowPower: 0.5,
+ *   width: 10
+ * });
+ * viewer.entities.add(ring.getEntity());
+ * ```
+ */
+export declare class Ring extends BaseOverlay {
+    private ringOptions;
+    private innerEntity?;
+    constructor(viewer: Viewer, options: RingOptions);
+    /**
+     * 创建发光圆环
+     */
+    private createRing;
+    /**
+     * 创建内层线材质
+     */
+    private createLineMaterial;
+    /**
+     * 生成近似圆顶点
+     */
+    private generateCirclePositions;
+    /**
+     * 解析颜色值
+     */
+    private resolveColor;
+    /**
+     * 更新 Ring 配置
+     */
+    update(options: Partial<RingOptions>): void;
+    /**
+     * 重建内层线
+     */
+    private rebuildInnerLine;
+    /**
+     * 更新几何形状
+     */
+    private updateGeometry;
+    /**
+     * 更新位置
+     */
+    setPosition(position: OverlayPosition): void;
+    /**
+     * 更新半径
+     */
+    setRadius(radius: number): void;
+    /**
+     * 获取位置（经纬度）
+     */
+    getPosition(): [number, number] | null;
+    /**
+     * 获取半径
+     */
+    getRadius(): number;
+    /**
+     * 从场景中移除圆环
+     */
+    remove(): void;
+}

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

@@ -0,0 +1,89 @@
+import { Viewer, Color, HeightReference, VerticalOrigin, HorizontalOrigin } from '../../../node_modules/cesium';
+import { BaseOverlay, BaseOverlayOptions, OverlayPosition } from './BaseOverlay';
+import * as Cesium from 'cesium';
+/**
+ * SVG 配置选项
+ */
+export interface SvgOptions extends BaseOverlayOptions {
+    /** SVG 字符串 */
+    svg: 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;
+}
+/**
+ * SVG 图标类
+ *
+ * 用于在地图上创建 SVG 图标标记，使用 Billboard 实现。
+ * 支持自定义 SVG 内容、大小、旋转、颜色等样式。
+ *
+ * @example
+ * ```typescript
+ * const svg = new SVG(viewer, {
+ *   position: [120.1, 30.2],
+ *   svg: '<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32"><circle cx="16" cy="16" r="14" fill="red"/></svg>',
+ *   width: 32,
+ *   height: 32
+ * });
+ * viewer.entities.add(svg.getEntity());
+ * ```
+ */
+export declare class SVG extends BaseOverlay {
+    private svgOptions;
+    constructor(viewer: Viewer, options: SvgOptions);
+    /**
+     * 将 SVG 字符串转换为 data URL
+     */
+    private svgToDataUrl;
+    /**
+     * 创建 BillboardGraphics 对象
+     */
+    private createBillboardGraphics;
+    /**
+     * 解析颜色值
+     */
+    private resolveColor;
+    /**
+     * 更新 SVG 配置
+     */
+    update(options: Partial<SvgOptions>): void;
+    /**
+     * 更新位置
+     */
+    setPosition(position: OverlayPosition): void;
+    /**
+     * 更新 SVG 内容
+     */
+    setSvg(svg: string): void;
+    /**
+     * 获取 SVG 字符串
+     */
+    getSvg(): string;
+    /**
+     * 获取位置（经纬度）
+     */
+    getPosition(): [number, number] | null;
+    /**
+     * 获取 SVG 样式
+     */
+    getStyle(): Partial<SvgOptions>;
+}

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

@@ -0,0 +1,27 @@
+/**
+ * 覆盖物实体模块入口
+ *
+ * @packageDocumentation
+ */
+export { BaseOverlay } from './BaseOverlay';
+export type { OverlayPosition, BaseOverlayOptions, OverlayClickHighlightOptions, OverlayHoverHighlightOptions, OverlayEntity, } from './BaseOverlay';
+export { Marker } from './Marker';
+export type { MarkerOptions } from './Marker';
+export { Label } from './Label';
+export type { LabelOptions } from './Label';
+export { Icon } from './Icon';
+export type { IconOptions } from './Icon';
+export { SVG } from './SVG';
+export type { SvgOptions } from './SVG';
+export { InfoWindow } from './InfoWindow';
+export type { InfoWindowOptions } from './InfoWindow';
+export { Polyline } from './Polyline';
+export type { PolylineOptions } from './Polyline';
+export { Polygon } from './Polygon';
+export type { PolygonOptions } from './Polygon';
+export { Rectangle } from './Rectangle';
+export type { RectangleOptions } from './Rectangle';
+export { Circle } from './Circle';
+export type { CircleOptions } from './Circle';
+export { Ring } from './Ring';
+export type { RingOptions } from './Ring';

package/dist/core/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 核心模块入口文件
+ * 导出所有核心类型、常量和类
+ */
+export * from './types';
+export * from './constants';
+export { MapPlugin, createMapPlugin } from './MapPlugin';
+import * as Cesium from 'cesium';
+export { Cesium };
+/**
+ * 核心模块版本信息
+ */
+export declare const VERSION = "1.0.0";
+/**
+ * 核心模块描述
+ */
+export declare const DESCRIPTION = "VMap Cesium Tool \u6838\u5FC3\u6A21\u5757 - \u63D0\u4F9B\u5730\u56FE\u63D2\u4EF6\u7684\u57FA\u7840\u7C7B\u578B\u3001\u5E38\u91CF\u548C\u6838\u5FC3\u7C7B";
+/**
+ * 默认导出核心模块
+ */
+declare const coreModule: {
+    VERSION: string;
+    DESCRIPTION: string;
+};
+export default coreModule;

package/dist/core/layers/BaiduMapLayer.d.ts

@@ -0,0 +1,37 @@
+import { BaiduLayerConfig } from '../types';
+import { MapLayer } from './MapLayer';
+import * as Cesium from 'cesium';
+/**
+ * 百度地图影像图层配置
+ */
+export declare const createBaiduImageryConfig: (token?: string) => Cesium.ImageryProvider[];
+/**
+ * 百度地图图层类
+ * 支持普通、卫星、地形三种类型的百度地图图层
+ */
+export declare class BaiduMapLayer extends MapLayer {
+    private config;
+    /**
+     * 构造函数
+     * @param viewer Cesium Viewer 实例
+     * @param config 百度地图图层配置
+     */
+    constructor(viewer: Cesium.Viewer, config: BaiduLayerConfig);
+    /**
+     * 获取影像提供者数组
+     */
+    protected getProviders(): Cesium.ImageryProvider[];
+    /**
+     * 添加图层到 Viewer
+     */
+    addToViewer(): void;
+    /**
+     * 更新图层配置
+     * @param config 新的百度地图图层配置
+     */
+    updateConfig(config: Partial<BaiduLayerConfig>): void;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): BaiduLayerConfig;
+}

package/dist/core/layers/CustomMapLayer.d.ts

@@ -0,0 +1,43 @@
+import { CustomLayerConfig } from '../types';
+import { MapLayer } from './MapLayer';
+import * as Cesium from 'cesium';
+/**
+ * 自定义地图图层类
+ * 支持用户自定义的影像提供者数组
+ */
+export declare class CustomMapLayer extends MapLayer {
+    private config;
+    /**
+     * 构造函数
+     * @param viewer Cesium Viewer 实例
+     * @param config 自定义图层配置
+     */
+    constructor(viewer: Cesium.Viewer, config: CustomLayerConfig);
+    /**
+     * 获取影像提供者数组
+     */
+    protected getProviders(): Cesium.ImageryProvider[];
+    /**
+     * 添加图层到 Viewer
+     */
+    addToViewer(): void;
+    /**
+     * 更新图层配置
+     * @param config 新的自定义图层配置
+     */
+    updateConfig(config: Partial<CustomLayerConfig>): void;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): CustomLayerConfig;
+    /**
+     * 添加单个影像提供者
+     * @param provider 影像提供者
+     */
+    addProvider(provider: Cesium.ImageryProvider): void;
+    /**
+     * 移除指定索引的影像提供者
+     * @param index 提供者索引
+     */
+    removeProvider(index: number): void;
+}

package/dist/core/layers/GaodeMapLayer.d.ts

@@ -0,0 +1,41 @@
+import { GaodeLayerConfig } from '../types';
+import { MapLayer } from './MapLayer';
+import * as Cesium from 'cesium';
+/**
+ * 高德地图影像图层配置（带注记）
+ */
+export declare const createGaodeImageryConfig: (token?: string) => Cesium.ImageryProvider[];
+/**
+ * 高德地图矢量图层配置
+ */
+export declare const createGaodeVectorConfig: (token?: string) => Cesium.ImageryProvider[];
+/**
+ * 高德地图图层类
+ * 支持矢量和卫星两种类型的高德地图图层
+ */
+export declare class GaodeMapLayer extends MapLayer {
+    private config;
+    /**
+     * 构造函数
+     * @param viewer Cesium Viewer 实例
+     * @param config 高德地图图层配置
+     */
+    constructor(viewer: Cesium.Viewer, config: GaodeLayerConfig);
+    /**
+     * 获取影像提供者数组
+     */
+    protected getProviders(): Cesium.ImageryProvider[];
+    /**
+     * 添加图层到 Viewer
+     */
+    addToViewer(): void;
+    /**
+     * 更新图层配置
+     * @param config 新的高德地图图层配置
+     */
+    updateConfig(config: Partial<GaodeLayerConfig>): void;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): GaodeLayerConfig;
+}

package/dist/core/layers/HeatmapLayer.d.ts

@@ -0,0 +1,118 @@
+import * as Cesium from 'cesium';
+/**
+ * 热力点数据
+ */
+export interface HeatPoint {
+    /** 经度（度） */
+    lon: number;
+    /** 纬度（度） */
+    lat: number;
+    /** 强度值 */
+    value: number;
+}
+/**
+ * 热力图渐变配置
+ */
+export interface HeatmapGradient {
+    [stop: number]: string;
+}
+/**
+ * 热力图选项
+ */
+export interface HeatmapOptions {
+    /** Canvas 宽度（默认 512） */
+    width?: number;
+    /** Canvas 高度（默认 512） */
+    height?: number;
+    /** 渲染模式：heat=热力渐变，discrete=分段纯色 */
+    mode?: 'heat' | 'discrete';
+    /** 点影响半径（像素，默认 30） */
+    radius?: number;
+    /** 伽马校正值（默认 0.7） */
+    gamma?: number;
+    /** 最小透明度（默认 0.03） */
+    minAlpha?: number;
+    /** 最小值（用于归一化） */
+    minValue?: number;
+    /** 最大值（用于归一化） */
+    maxValue?: number;
+    /** 全局不透明度（0-1） */
+    opacity?: number;
+    /** 颜色梯度 */
+    gradient?: HeatmapGradient;
+    /** 离散模式阈值数组 */
+    discreteThresholds?: number[];
+    /** 离散模式颜色数组 */
+    discreteColors?: string[];
+    /** 重叠处理方式：max=取高分段，last=后绘制覆盖 */
+    discreteOverlap?: 'max' | 'last';
+}
+/**
+ * Cesium 热力图图层
+ *
+ * 使用离屏 Canvas 渲染热力图，通过 SingleTileImageryProvider 叠加到地球。
+ *
+ * @example
+ * ```typescript
+ * const heatmap = new HeatmapLayer(viewer, {
+ *   radius: 30,
+ *   gradient: {
+ *     0.0: '#0000ff',
+ *     0.5: '#00ffff',
+ *     1.0: '#ff0000'
+ *   }
+ * });
+ * heatmap.setData([
+ *   { lon: 120.1, lat: 30.2, value: 50 },
+ *   { lon: 120.2, lat: 30.3, value: 80 }
+ * ]);
+ * ```
+ */
+export declare class HeatmapLayer {
+    private viewer;
+    private imageryLayer;
+    private rectangle;
+    private fullDataRectangle;
+    private canvas;
+    private ctx;
+    private options;
+    private data;
+    private gradientLUT;
+    constructor(viewer: Cesium.Viewer, options?: HeatmapOptions);
+    /**
+     * 解析颜色为 RGBA
+     */
+    private parseColorToRGBA;
+    /**
+     * 构建颜色查找表
+     */
+    private buildGradientLUT;
+    /**
+     * 设置热力图数据
+     */
+    setData(points: HeatPoint[]): void;
+    /**
+     * 渲染热力图
+     */
+    private renderHeatmap;
+    /**
+     * 更新影像图层
+     */
+    private updateImageryLayer;
+    /**
+     * 设置透明度
+     */
+    setOpacity(opacity: number): void;
+    /**
+     * 设置可见性
+     */
+    setVisible(visible: boolean): void;
+    /**
+     * 清除图层
+     */
+    clearLayer(): void;
+    /**
+     * 销毁图层
+     */
+    destroy(): void;
+}

package/dist/core/layers/MapLayer.d.ts

@@ -0,0 +1,37 @@
+import * as Cesium from 'cesium';
+/**
+ * 地图图层基类
+ * 提供统一的图层管理接口
+ */
+export declare abstract class MapLayer {
+    protected viewer: Cesium.Viewer;
+    protected imageryLayers: Cesium.ImageryLayer[];
+    /**
+     * 构造函数
+     * @param viewer Cesium Viewer 实例
+     */
+    constructor(viewer: Cesium.Viewer);
+    /**
+     * 添加图层到 Viewer
+     * 子类必须实现此方法
+     */
+    abstract addToViewer(): void;
+    /**
+     * 从 Viewer 移除图层
+     */
+    removeFromViewer(): void;
+    /**
+     * 获取图层提供者数组
+     * 子类必须实现此方法
+     */
+    protected abstract getProviders(): Cesium.ImageryProvider[];
+    /**
+     * 添加影像图层到 Viewer
+     * @param providers 影像提供者数组
+     */
+    protected addImageryProviders(providers: Cesium.ImageryProvider[]): void;
+    /**
+     * 检查图层是否已添加到 Viewer
+     */
+    isAdded(): boolean;
+}

package/dist/core/layers/OSMMapLayer.d.ts

@@ -0,0 +1,37 @@
+import { OSMLayerConfig } from '../types';
+import { MapLayer } from './MapLayer';
+import * as Cesium from 'cesium';
+/**
+ * OSM 标准图层配置
+ */
+export declare const createOSMConfig: () => Cesium.ImageryProvider[];
+/**
+ * OpenStreetMap 图层类
+ * 支持标准 OSM 瓦片图层
+ */
+export declare class OSMMapLayer extends MapLayer {
+    private config;
+    /**
+     * 构造函数
+     * @param viewer Cesium Viewer 实例
+     * @param config OSM 图层配置
+     */
+    constructor(viewer: Cesium.Viewer, config?: OSMLayerConfig);
+    /**
+     * 获取影像提供者数组
+     */
+    protected getProviders(): Cesium.ImageryProvider[];
+    /**
+     * 添加图层到 Viewer
+     */
+    addToViewer(): void;
+    /**
+     * 更新图层配置
+     * @param config 新的 OSM 图层配置
+     */
+    updateConfig(config: Partial<OSMLayerConfig>): void;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): OSMLayerConfig;
+}