@xingm/vmap-cesium-toolbar 0.0.2-alpha.7 → 0.0.2-alpha.9

package/dist/hooks/useDrawHelper.d.ts

@@ -8,11 +8,12 @@ import * as Cesium from "cesium";
 export declare function useDrawHelper(viewer: Ref<Cesium.Viewer | undefined>, message: Ref<string>): {
     drawHelper: Ref<{
         handleSceneModeChanged: () => void;
-        startDrawingLine: (options?: import('..').DrawOptions) => void;
-        startDrawingPolygon: (options?: import('..').DrawOptions) => void;
-        startDrawingRectangle: (options?: import('..').DrawOptions) => void;
-        startDrawingCircle: (options?: import('..').DrawOptions) => void;
+        startDrawingLine: (options?: import('../libs/drawHelper').DrawOptions) => void;
+        startDrawingPolygon: (options?: import('../libs/drawHelper').DrawOptions) => void;
+        startDrawingRectangle: (options?: import('../libs/drawHelper').DrawOptions) => void;
+        startDrawingCircle: (options?: import('../libs/drawHelper').DrawOptions) => void;
         endDrawing: () => void;
+        cancelDrawing: () => void;
         clearAll: () => void;
         clearAllEntities: () => void;
         clearAllPoints: () => void;
@@ -30,11 +31,12 @@ export declare function useDrawHelper(viewer: Ref<Cesium.Viewer | undefined>, me
         destroy: () => void;
     } | null, DrawHelper | {
         handleSceneModeChanged: () => void;
-        startDrawingLine: (options?: import('..').DrawOptions) => void;
-        startDrawingPolygon: (options?: import('..').DrawOptions) => void;
-        startDrawingRectangle: (options?: import('..').DrawOptions) => void;
-        startDrawingCircle: (options?: import('..').DrawOptions) => void;
+        startDrawingLine: (options?: import('../libs/drawHelper').DrawOptions) => void;
+        startDrawingPolygon: (options?: import('../libs/drawHelper').DrawOptions) => void;
+        startDrawingRectangle: (options?: import('../libs/drawHelper').DrawOptions) => void;
+        startDrawingCircle: (options?: import('../libs/drawHelper').DrawOptions) => void;
         endDrawing: () => void;
+        cancelDrawing: () => void;
         clearAll: () => void;
         clearAllEntities: () => void;
         clearAllPoints: () => void;

package/dist/hooks/useHeatmapHelper.d.ts

@@ -0,0 +1,28 @@
+import { Ref } from 'vue';
+import { default as CesiumHeatmapLayer, HeatPoint, HeatmapOptions, HeatmapGradient } from '../libs/CesiumHeatmapLayer';
+import * as Cesium from "cesium";
+/**
+ * 热力图相关的辅助逻辑
+ */
+export declare function useHeatmapHelper(viewer: Ref<Cesium.Viewer | undefined>): {
+    heatmapLayer: Ref<{
+        setData: (points: HeatPoint[]) => void;
+        setGradient: (gradient: HeatmapGradient) => void;
+        setOpacity: (opacity: number) => void;
+        setVisible: (visible: boolean) => void;
+        destroy: () => void;
+    } | null, CesiumHeatmapLayer | {
+        setData: (points: HeatPoint[]) => void;
+        setGradient: (gradient: HeatmapGradient) => void;
+        setOpacity: (opacity: number) => void;
+        setVisible: (visible: boolean) => void;
+        destroy: () => void;
+    } | null>;
+    visible: Ref<boolean, boolean>;
+    initHeatmap: (options?: HeatmapOptions) => void;
+    updateHeatmapData: (points: HeatPoint[]) => void;
+    setHeatmapVisible: (v: boolean) => void;
+    setHeatmapOpacity: (alpha: number) => void;
+    setHeatmapGradient: (gradient: HeatmapGradient) => void;
+    destroyHeatmap: () => void;
+};

package/dist/hooks/useOverlayHelper.d.ts

@@ -74,6 +74,14 @@ export declare function useOverlayHelper(viewer: Ref<Cesium.Viewer | undefined>,
             updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').CircleOptions, "material" | "outline" | "outlineColor" | "outlineWidth">>) => void;
             remove: (entityOrId: Entity | string) => boolean;
         };
+        readonly ring: {
+            add: (options: import('../libs/overlay').RingOptions) => Entity;
+            updatePosition: (entity: Entity, position: import('../libs/overlay').OverlayPosition) => void;
+            updateRadius: (entity: Entity, radius: number) => void;
+            updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').RingOptions, "color" | "showInnerLine" | "lineColor" | "lineStyle" | "lineMaterialMode" | "stripeRepeat" | "dashLength" | "dashPattern" | "gapColor" | "width" | "glowWidth" | "lineWidth" | "glowPower" | "clampToGround" | "segments">>) => void;
+            setVisible: (entity: Entity, visible: boolean) => void;
+            remove: (entityOrId: Entity | string) => boolean;
+        };
         addMarker: (options: import('../libs/overlay').MarkerOptions) => Entity;
         addLabel: (options: import('../libs/overlay').LabelOptions) => Entity;
         addIcon: (options: import('../libs/overlay').IconOptions) => Entity;
@@ -83,6 +91,7 @@ export declare function useOverlayHelper(viewer: Ref<Cesium.Viewer | undefined>,
         addPolygon: (options: import('../libs/overlay').PolygonOptions) => Entity;
         addRectangle: (options: import('../libs/overlay').RectangleOptions) => Entity;
         addCircle: (options: import('../libs/overlay').CircleOptions) => Entity;
+        addRing: (options: import('../libs/overlay').RingOptions) => Entity;
         getOverlay: (id: string) => Entity | undefined;
         removeOverlay: (id: string) => boolean;
         removeAllOverlays: () => void;
@@ -157,6 +166,14 @@ export declare function useOverlayHelper(viewer: Ref<Cesium.Viewer | undefined>,
             updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').CircleOptions, "material" | "outline" | "outlineColor" | "outlineWidth">>) => void;
             remove: (entityOrId: Entity | string) => boolean;
         };
+        readonly ring: {
+            add: (options: import('../libs/overlay').RingOptions) => Entity;
+            updatePosition: (entity: Entity, position: import('../libs/overlay').OverlayPosition) => void;
+            updateRadius: (entity: Entity, radius: number) => void;
+            updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').RingOptions, "color" | "showInnerLine" | "lineColor" | "lineStyle" | "lineMaterialMode" | "stripeRepeat" | "dashLength" | "dashPattern" | "gapColor" | "width" | "glowWidth" | "lineWidth" | "glowPower" | "clampToGround" | "segments">>) => void;
+            setVisible: (entity: Entity, visible: boolean) => void;
+            remove: (entityOrId: Entity | string) => boolean;
+        };
         addMarker: (options: import('../libs/overlay').MarkerOptions) => Entity;
         addLabel: (options: import('../libs/overlay').LabelOptions) => Entity;
         addIcon: (options: import('../libs/overlay').IconOptions) => Entity;
@@ -166,6 +183,7 @@ export declare function useOverlayHelper(viewer: Ref<Cesium.Viewer | undefined>,
         addPolygon: (options: import('../libs/overlay').PolygonOptions) => Entity;
         addRectangle: (options: import('../libs/overlay').RectangleOptions) => Entity;
         addCircle: (options: import('../libs/overlay').CircleOptions) => Entity;
+        addRing: (options: import('../libs/overlay').RingOptions) => Entity;
         getOverlay: (id: string) => Entity | undefined;
         removeOverlay: (id: string) => boolean;
         removeAllOverlays: () => void;
@@ -185,6 +203,7 @@ export declare function useOverlayHelper(viewer: Ref<Cesium.Viewer | undefined>,
     addLine: () => void;
     addArea: () => void;
     addCircle: () => void;
+    addRing: () => void;
     addPolygon: () => void;
     addRectangle: () => void;
     addInfoWindow: () => void;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 // VMap Cesium Toolbar Plugin Type Definitions
 
 import type * as Cesium from 'cesium';
-import type { Viewer, Cartesian3, Cartographic, Entity, Cartesian2, Color } from 'cesium';
+import type { Viewer, Cartesian3, Entity, Color } from 'cesium';
 
 // 工具栏配置接口（与 CesiumMapModel.ts 保持一致）
 export interface ToolbarConfig {
@@ -195,6 +195,7 @@ export interface InitOptions {
   terrainExaggeration?: number;
   maximumScreenSpaceError?: number;
   maximumNumberOfLoadedTiles?: number;
+  requestRenderMode?: boolean;
   token?: string;
   cesiumToken?: string;
   success?: () => void;
@@ -261,6 +262,35 @@ export declare class CesiumMapToolbar {
 // 覆盖物位置类型（与 overlay/types.ts 保持一致）
 export type OverlayPosition = Cartesian3 | [number, number] | [number, number, number];
 
+// 覆盖物扩展实体类型（与 libs/overlay/types.ts 保持一致）
+export interface OverlayEntity extends Entity {
+  _onClick?: (entity: Entity) => void;
+  _overlayType?: string;
+  _infoWindow?: HTMLElement;
+  _borderEntity?: Entity;
+  _innerEntity?: Entity;
+  _isThickOutline?: boolean;
+  _outlineWidth?: number;
+  _isRing?: boolean;
+  _ringThickness?: number;
+  _ringSegments?: number;
+  _ringGlowPower?: number;
+  _ringLineColor?: Color | string;
+  _ringLineStyle?: 'solid' | 'dashed';
+  _ringLineMaterialMode?: 'stripe' | 'dash';
+  _ringStripeRepeat?: number;
+  _ringDashLength?: number;
+  _ringDashPattern?: number;
+  _ringGapColor?: Color | string;
+  _ringShowInnerLine?: boolean;
+  _fillMaterial?: Cesium.MaterialProperty | Color | string;
+  _ringHeightEpsilon?: number;
+  _centerCartographic?: Cesium.Cartographic;
+  _outerRadius?: number;
+  _innerRadius?: number;
+  _outerRectangle?: Cesium.Rectangle;
+}
+
 export type PositionOffset =
   | 'top'
   | 'bottom'
@@ -420,6 +450,46 @@ export interface CircleOptions {
   id?: string;
 }
 
+export interface RingOptions {
+  /** 中心点（经纬度/高度 或 Cartesian3） */
+  position: OverlayPosition;
+  /** 半径（米） */
+  radius: number;
+  /** 边缘发光颜色 */
+  color?: any | string;
+  /** 是否绘制内层线（默认 true）。关闭可去掉“白色芯子” */
+  showInnerLine?: boolean;
+  /** 内层线颜色 */
+  lineColor?: any | string;
+  /** 内层线型：实线/虚线（默认 solid） */
+  lineStyle?: 'solid' | 'dashed';
+  /** 虚线材质方案：stripe(默认) / dash */
+  lineMaterialMode?: 'stripe' | 'dash';
+  /** stripe 模式：条纹重复次数（默认 32） */
+  stripeRepeat?: number;
+  /** 虚线长度（像素，默认 16） */
+  dashLength?: number;
+  /** 虚线模式（16bit pattern，可选） */
+  dashPattern?: number;
+  /** 虚线间隙颜色（默认透明） */
+  gapColor?: any | string;
+  /** 线宽（像素） */
+  width?: number;
+  /** 外层发光线宽（像素）。优先于 width */
+  glowWidth?: number;
+  /** 内层线宽（像素）。不传则使用自动计算 */
+  lineWidth?: number;
+  /** 发光强度（0-1），越大越“亮/粗” */
+  glowPower?: number;
+  /** 是否贴地（默认 true） */
+  clampToGround?: boolean;
+  /** 圆环分段数（默认 128），越大越圆滑 */
+  segments?: number;
+  /** 覆盖物点击回调 */
+  onClick?: (entity: Entity) => void;
+  id?: string;
+}
+
 export declare class CesiumOverlayService {
   constructor(viewer: Viewer);
   addMarker(options: any): any; // 返回 Cesium.Entity
@@ -431,6 +501,7 @@ export declare class CesiumOverlayService {
   addPolygon(options: any): any; // 返回 Cesium.Entity
   addRectangle(options: any): any; // 返回 Cesium.Entity
   addCircle(options: any): any; // 返回 Cesium.Entity
+  addRing(options: RingOptions): any; // 返回 Cesium.Entity
   getOverlay(id: string): any | undefined; // 返回 Cesium.Entity | undefined
   removeOverlay(id: string): boolean;
   removeAllOverlays(): void;
@@ -513,6 +584,38 @@ export declare class MapCircle {
   updateStyle(entity: Entity, options: Partial<Pick<CircleOptions, 'material' | 'outline' | 'outlineColor' | 'outlineWidth'>>): void;
 }
 
+export declare class MapRing {
+  constructor(viewer: Viewer);
+  add(options: RingOptions): Entity;
+  updatePosition(entity: Entity, position: OverlayPosition): void;
+  updateRadius(entity: Entity, radius: number): void;
+  updateStyle(
+    entity: Entity,
+    options: Partial<
+      Pick<
+        RingOptions,
+        | 'color'
+        | 'showInnerLine'
+        | 'lineColor'
+        | 'lineStyle'
+        | 'lineMaterialMode'
+        | 'stripeRepeat'
+        | 'dashLength'
+        | 'dashPattern'
+        | 'gapColor'
+        | 'width'
+        | 'glowWidth'
+        | 'lineWidth'
+        | 'glowPower'
+        | 'clampToGround'
+        | 'segments'
+      >
+    >
+  ): void;
+  setVisible(entity: Entity, visible: boolean): void;
+  remove(entityOrId: Entity | string): boolean;
+}
+
 // toolbar: 相机控制器及服务（与工具栏相关类保持一致）
 export interface MapInitialCenter {
   longitude: number;
@@ -607,7 +710,7 @@ export interface DrawResult {
 
 export interface DrawCallbacks {
   onDrawStart?: () => void;
-  onDrawEnd?: (entity: Entity | null) => void;
+  onDrawEnd?: (entity: Entity | null, result: DrawResult) => void;
   onEntityRemoved?: (entity: Entity) => void;
   onMeasureComplete?: (result: DrawResult) => void;
 }