@xingm/vmap-cesium-toolbar 0.0.2-alpha.12 → 0.0.2-alpha.14

package/dist/hooks/useDrawHelper.d.ts

@@ -18,6 +18,7 @@ export declare function useDrawHelper(viewer: Ref<Cesium.Viewer | undefined>, me
         clearAllEntities: () => void;
         clearAllPoints: () => void;
         removeEntity: (entity: Cesium.Entity) => void;
+        getEntityLabelEntities: (entity: Cesium.Entity) => Cesium.Entity[];
         getFinishedEntities: () => Cesium.Entity[];
         onMeasureComplete: (callback: (result: {
             type: "line" | "polygon" | "rectangle" | "circle";
@@ -41,6 +42,7 @@ export declare function useDrawHelper(viewer: Ref<Cesium.Viewer | undefined>, me
         clearAllEntities: () => void;
         clearAllPoints: () => void;
         removeEntity: (entity: Cesium.Entity) => void;
+        getEntityLabelEntities: (entity: Cesium.Entity) => Cesium.Entity[];
         getFinishedEntities: () => Cesium.Entity[];
         onMeasureComplete: (callback: (result: {
             type: "line" | "polygon" | "rectangle" | "circle";
@@ -59,7 +61,12 @@ export declare function useDrawHelper(viewer: Ref<Cesium.Viewer | undefined>, me
     endDrawing: () => void;
     addDrawLine: () => void;
     addDrawArea: () => void;
+    addDrawAreaNoLabel: () => void;
     addDrawCircle: () => void;
+    addDrawCircleNoLabel: () => void;
     addDrawPolygon: () => void;
+    addDrawPolygonNoLabel: () => void;
+    addDrawPolygon_PointIntercept: () => void;
+    addDrawPolygon_FinishFallback: () => void;
     destroyDrawHelper: () => void;
 };

package/dist/hooks/useDynamicRing.d.ts

@@ -0,0 +1,44 @@
+import { Viewer } from '../../node_modules/cesium';
+import * as Cesium from "cesium";
+export type CleanupFn = () => void;
+export type RingDirection = "outward" | "inward";
+export type AddDynamicRingOptions = {
+    position: Cesium.Cartesian3;
+    color?: Cesium.Color;
+    width?: number;
+    height?: number;
+    scale?: number;
+    direction?: RingDirection;
+    imageSize?: number;
+    disableDepthTestDistance?: number;
+};
+export type DynamicRingInstance = {
+    billboard: Cesium.Billboard;
+    color: Cesium.Color;
+    direction: RingDirection;
+};
+export declare function getRingCanvas(size?: number): HTMLCanvasElement;
+export declare function addDynamicRing(collection: Cesium.BillboardCollection, options: AddDynamicRingOptions): DynamicRingInstance;
+export type StartDynamicRingOptions = {
+    lon: number;
+    lat: number;
+    /** 任选其一：radiusMeters / diameterMeters / widthMeters+heightMeters */
+    radiusMeters?: number;
+    diameterMeters?: number;
+    widthMeters?: number;
+    heightMeters?: number;
+    color?: Cesium.Color;
+    /** 发散方向：outward(由小到大) / inward(由大到小) */
+    direction?: RingDirection;
+    heightOffset?: number;
+    imageSize?: number;
+    disableDepthTestDistance?: number;
+    period?: number;
+    baseScale?: number;
+    scaleRange?: number;
+    baseAlpha?: number;
+};
+/**
+ * 一站式：创建光圈 + 贴地采样 + preRender 动画，并返回 cleanup
+ */
+export declare function startDynamicRing(viewer: Viewer, options: StartDynamicRingOptions): CleanupFn;

package/dist/hooks/useOverlayHelper.d.ts

@@ -1,5 +1,6 @@
 import { Ref } from 'vue';
 import { Entity } from '../../node_modules/cesium';
+import { OverlayEntity } from '../libs/overlay/types';
 import { CesiumOverlayService } from '../libs/overlay';
 import * as Cesium from "cesium";
 /**
@@ -60,12 +61,18 @@ export declare function useOverlayHelper(viewer: Ref<Cesium.Viewer | undefined>,
             updatePositions: (entity: Entity, positions: import('../libs/overlay').OverlayPosition[]) => void;
             updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').PolygonOptions, "material" | "outline" | "outlineColor" | "outlineWidth">>) => void;
             remove: (entityOrId: Entity | string) => boolean;
+            setPrimitiveVisible: (entity: Entity, visible: boolean) => void;
+            applyPrimitiveHighlight: (entity: OverlayEntity, hlColor: Cesium.Color, fillAlpha: number) => void;
+            restorePrimitiveHighlight: (entity: OverlayEntity) => void;
         };
         readonly rectangle: {
             add: (options: import('../libs/overlay').RectangleOptions) => Entity;
             updateCoordinates: (entity: Entity, coordinates: Cesium.Rectangle) => void;
             updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').RectangleOptions, "material" | "outline" | "outlineColor" | "outlineWidth">>) => void;
             remove: (entityOrId: Entity | string) => boolean;
+            setPrimitiveVisible: (entity: Entity, visible: boolean) => void;
+            applyPrimitiveHighlight: (entity: OverlayEntity, hlColor: Cesium.Color, fillAlpha: number) => void;
+            restorePrimitiveHighlight: (entity: OverlayEntity) => void;
         };
         readonly circle: {
             add: (options: import('../libs/overlay').CircleOptions) => Entity;
@@ -73,6 +80,9 @@ export declare function useOverlayHelper(viewer: Ref<Cesium.Viewer | undefined>,
             updateRadius: (entity: Entity, radius: number) => void;
             updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').CircleOptions, "material" | "outline" | "outlineColor" | "outlineWidth">>) => void;
             remove: (entityOrId: Entity | string) => boolean;
+            setPrimitiveVisible: (entity: Entity, visible: boolean) => void;
+            applyPrimitiveHighlight: (entity: OverlayEntity, hlColor: Cesium.Color, fillAlpha: number) => void;
+            restorePrimitiveHighlight: (entity: OverlayEntity) => void;
         };
         readonly ring: {
             add: (options: import('../libs/overlay').RingOptions) => Entity;
@@ -82,6 +92,8 @@ export declare function useOverlayHelper(viewer: Ref<Cesium.Viewer | undefined>,
             setVisible: (entity: Entity, visible: boolean) => void;
             remove: (entityOrId: Entity | string) => boolean;
         };
+        toggleOverlayHighlight: (entity: OverlayEntity, reason?: "click" | "hover") => void;
+        setOverlayHighlight: (entityOrId: OverlayEntity | string, enabled: boolean, reason?: "click" | "hover") => boolean;
         addMarker: (options: import('../libs/overlay').MarkerOptions) => Entity;
         addLabel: (options: import('../libs/overlay').LabelOptions) => Entity;
         addIcon: (options: import('../libs/overlay').IconOptions) => Entity;
@@ -152,12 +164,18 @@ export declare function useOverlayHelper(viewer: Ref<Cesium.Viewer | undefined>,
             updatePositions: (entity: Entity, positions: import('../libs/overlay').OverlayPosition[]) => void;
             updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').PolygonOptions, "material" | "outline" | "outlineColor" | "outlineWidth">>) => void;
             remove: (entityOrId: Entity | string) => boolean;
+            setPrimitiveVisible: (entity: Entity, visible: boolean) => void;
+            applyPrimitiveHighlight: (entity: OverlayEntity, hlColor: Cesium.Color, fillAlpha: number) => void;
+            restorePrimitiveHighlight: (entity: OverlayEntity) => void;
         };
         readonly rectangle: {
             add: (options: import('../libs/overlay').RectangleOptions) => Entity;
             updateCoordinates: (entity: Entity, coordinates: Cesium.Rectangle) => void;
             updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').RectangleOptions, "material" | "outline" | "outlineColor" | "outlineWidth">>) => void;
             remove: (entityOrId: Entity | string) => boolean;
+            setPrimitiveVisible: (entity: Entity, visible: boolean) => void;
+            applyPrimitiveHighlight: (entity: OverlayEntity, hlColor: Cesium.Color, fillAlpha: number) => void;
+            restorePrimitiveHighlight: (entity: OverlayEntity) => void;
         };
         readonly circle: {
             add: (options: import('../libs/overlay').CircleOptions) => Entity;
@@ -165,6 +183,9 @@ export declare function useOverlayHelper(viewer: Ref<Cesium.Viewer | undefined>,
             updateRadius: (entity: Entity, radius: number) => void;
             updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').CircleOptions, "material" | "outline" | "outlineColor" | "outlineWidth">>) => void;
             remove: (entityOrId: Entity | string) => boolean;
+            setPrimitiveVisible: (entity: Entity, visible: boolean) => void;
+            applyPrimitiveHighlight: (entity: OverlayEntity, hlColor: Cesium.Color, fillAlpha: number) => void;
+            restorePrimitiveHighlight: (entity: OverlayEntity) => void;
         };
         readonly ring: {
             add: (options: import('../libs/overlay').RingOptions) => Entity;
@@ -174,6 +195,8 @@ export declare function useOverlayHelper(viewer: Ref<Cesium.Viewer | undefined>,
             setVisible: (entity: Entity, visible: boolean) => void;
             remove: (entityOrId: Entity | string) => boolean;
         };
+        toggleOverlayHighlight: (entity: OverlayEntity, reason?: "click" | "hover") => void;
+        setOverlayHighlight: (entityOrId: OverlayEntity | string, enabled: boolean, reason?: "click" | "hover") => boolean;
         addMarker: (options: import('../libs/overlay').MarkerOptions) => Entity;
         addLabel: (options: import('../libs/overlay').LabelOptions) => Entity;
         addIcon: (options: import('../libs/overlay').IconOptions) => Entity;
@@ -197,16 +220,24 @@ export declare function useOverlayHelper(viewer: Ref<Cesium.Viewer | undefined>,
     addMarker: () => void;
     addMarkerWithLabel: () => void;
     addLabel: (options: any) => void;
-    addIcon: () => void;
-    addSvg: () => void;
+    addIcon: (coords?: {
+        longitude: number;
+        latitude: number;
+    }) => void;
+    addSvg: (coords?: {
+        longitude: number;
+        latitude: number;
+    }) => void;
     addPolyline: () => void;
     addLine: () => void;
     addArea: () => void;
     addCircle: () => void;
-    addRing: () => void;
+    addRing: (i?: number) => Cesium.Entity | undefined;
     addPolygon: () => void;
     addRectangle: () => void;
     addInfoWindow: () => void;
+    testSetOverlayHighlight: () => void;
+    testToggleOverlayHighlight: () => void;
     cancelMarkerMode: () => void;
     destroyOverlayService: () => void;
 };

package/dist/index.d.ts

@@ -198,6 +198,9 @@ export interface InitOptions {
   requestRenderMode?: boolean;
   token?: string;
   cesiumToken?: string;
+  orderIndependentTranslucency?: boolean // 无序半透明度,
+  fxaa?: boolean, // 启用FXAA后处理抗锯齿
+  msaaSamples?: number, // MSAA采样数（推荐4或8）,
   success?: () => void;
   cancel?: () => void;
   mapCenter?: MapCenter;
@@ -265,6 +268,11 @@ export type OverlayPosition = Cartesian3 | [number, number] | [number, number, n
 // 覆盖物扩展实体类型（与 libs/overlay/types.ts 保持一致）
 export interface OverlayEntity extends Entity {
   _onClick?: (entity: Entity) => void;
+  _clickHighlight?: boolean | { color?: any | string; fillAlpha?: number };
+  _hoverHighlight?: boolean | { color?: any | string; fillAlpha?: number };
+  _highlightEntities?: Entity[];
+  _isHighlighted?: boolean;
+  _highlightState?: { click?: boolean; hover?: boolean };
   _overlayType?: string;
   _infoWindow?: HTMLElement;
   _borderEntity?: Entity;
@@ -289,6 +297,13 @@ export interface OverlayEntity extends Entity {
   _outerRadius?: number;
   _innerRadius?: number;
   _outerRectangle?: Cesium.Rectangle;
+
+  /** primitive circle: 内部使用的纯色缓存（用于高亮恢复） */
+  _primitiveRingBaseColor?: any;
+  _primitiveFillBaseColor?: any;
+
+  /** primitive polygon/rectangle: 边框纯色缓存（用于高亮恢复） */
+  _primitiveBorderBaseColor?: any;
 }
 
 export type PositionOffset =
@@ -341,6 +356,8 @@ export interface MarkerOptions {
   heightReference?: any;
   scaleByDistance?: Cesium.NearFarScalar;
   disableDepthTestDistance?: number;
+  clickHighlight?: boolean | { color?: any | string; fillAlpha?: number };
+  hoverHighlight?: boolean | { color?: any | string; fillAlpha?: number };
   onClick?: (entity: Entity) => void;
   id?: string;
 }
@@ -363,6 +380,8 @@ export interface LabelOptions {
   backgroundColor?: any | string;
   backgroundPadding?: Cesium.Cartesian2;
   disableDepthTestDistance?: number;
+  clickHighlight?: boolean | { color?: any | string; fillAlpha?: number };
+  hoverHighlight?: boolean | { color?: any | string; fillAlpha?: number };
   onClick?: (entity: Entity) => void;
   id?: string;
 }
@@ -381,6 +400,8 @@ export interface IconOptions {
   heightReference?: any;
   disableDepthTestDistance?: number;
   color?: any | string;
+  clickHighlight?: boolean | { color?: any | string; fillAlpha?: number };
+  hoverHighlight?: boolean | { color?: any | string; fillAlpha?: number };
   onClick?: (entity: Entity) => void;
   id?: string;
 }
@@ -399,6 +420,8 @@ export interface SvgOptions {
   heightReference?: any;
   disableDepthTestDistance?: number;
   color?: any | string;
+  clickHighlight?: boolean | { color?: any | string; fillAlpha?: number };
+  hoverHighlight?: boolean | { color?: any | string; fillAlpha?: number };
   onClick?: (entity: Entity) => void;
   id?: string;
 }
@@ -408,30 +431,43 @@ export interface PolylineOptions {
   width?: number;
   material?: Cesium.MaterialProperty | any | string;
   clampToGround?: boolean;
+  clickHighlight?: boolean | { color?: any | string; fillAlpha?: number };
+  hoverHighlight?: boolean | { color?: any | string; fillAlpha?: number };
   onClick?: (entity: Entity) => void;
   id?: string;
 }
 
 export interface PolygonOptions {
   positions: OverlayPosition[];
+  /** 渲染模式：auto(默认) / entity / primitive（贴地粗边框纯色场景支持） */
+  renderMode?: 'auto' | 'entity' | 'primitive';
   material?: Cesium.MaterialProperty | any | string;
   outline?: boolean;
   outlineColor?: any | string;
   outlineWidth?: number;
+  clampToGround?: boolean;
   heightReference?: any;
   extrudedHeight?: number;
+  clickHighlight?: boolean | { color?: any | string; fillAlpha?: number };
+  hoverHighlight?: boolean | { color?: any | string; fillAlpha?: number };
   onClick?: (entity: Entity) => void;
   id?: string;
 }
 
 export interface RectangleOptions {
   coordinates: Cesium.Rectangle;
+  renderMode?: 'auto' | 'entity' | 'primitive';
   material?: Cesium.MaterialProperty | any | string;
   outline?: boolean;
   outlineColor?: any | string;
   outlineWidth?: number;
+  clampToGround?: boolean;
+  height?: number;
   heightReference?: any;
   extrudedHeight?: number;
+  heightEpsilon?: number;
+  clickHighlight?: boolean | { color?: any | string; fillAlpha?: number };
+  hoverHighlight?: boolean | { color?: any | string; fillAlpha?: number };
   onClick?: (entity: Entity) => void;
   id?: string;
 }
@@ -439,13 +475,19 @@ export interface RectangleOptions {
 export interface CircleOptions {
   position: OverlayPosition;
   radius: number;
+  /** 渲染模式：auto(默认) / entity / primitive（预留） */
+  renderMode?: 'auto' | 'entity' | 'primitive';
   material?: Cesium.MaterialProperty | any | string;
   outline?: boolean;
   outlineColor?: any | string;
   outlineWidth?: number;
+  segments?: number;
+  clampToGround?: boolean;
   heightReference?: any;
   extrudedHeight?: number;
   heightEpsilon?: number; // 高度容差，用于环形方案
+  clickHighlight?: boolean | { color?: any | string; fillAlpha?: number };
+  hoverHighlight?: boolean | { color?: any | string; fillAlpha?: number };
   onClick?: (entity: Entity) => void;
   id?: string;
 }
@@ -485,6 +527,8 @@ export interface RingOptions {
   clampToGround?: boolean;
   /** 圆环分段数（默认 128），越大越圆滑 */
   segments?: number;
+  clickHighlight?: boolean | { color?: any | string; fillAlpha?: number };
+  hoverHighlight?: boolean | { color?: any | string; fillAlpha?: number };
   /** 覆盖物点击回调 */
   onClick?: (entity: Entity) => void;
   id?: string;
@@ -492,21 +536,23 @@ export interface RingOptions {
 
 export declare class CesiumOverlayService {
   constructor(viewer: Viewer);
-  addMarker(options: any): any; // 返回 Cesium.Entity
-  addLabel(options: any): any; // 返回 Cesium.Entity
-  addIcon(options: any): any; // 返回 Cesium.Entity
-  addSvg(options: any): any; // 返回 Cesium.Entity
+  toggleOverlayHighlight(entity: any, reason?: 'click' | 'hover'): void;
+  addMarker(options: MarkerOptions): any; // 返回 Cesium.Entity
+  addLabel(options: LabelOptions): any; // 返回 Cesium.Entity
+  addIcon(options: IconOptions): any; // 返回 Cesium.Entity
+  addSvg(options: SvgOptions): any; // 返回 Cesium.Entity
   addInfoWindow(options: InfoWindowOptions): any; // 返回 Cesium.Entity
-  addPolyline(options: any): any; // 返回 Cesium.Entity
-  addPolygon(options: any): any; // 返回 Cesium.Entity
-  addRectangle(options: any): any; // 返回 Cesium.Entity
-  addCircle(options: any): any; // 返回 Cesium.Entity
+  addPolyline(options: PolylineOptions): any; // 返回 Cesium.Entity
+  addPolygon(options: PolygonOptions): any; // 返回 Cesium.Entity
+  addRectangle(options: RectangleOptions): any; // 返回 Cesium.Entity
+  addCircle(options: CircleOptions): any; // 返回 Cesium.Entity
   addRing(options: RingOptions): any; // 返回 Cesium.Entity
   getOverlay(id: string): any | undefined; // 返回 Cesium.Entity | undefined
   removeOverlay(id: string): boolean;
   removeAllOverlays(): void;
   updateOverlayPosition(id: string, position: Cartesian3 | [number, number, number?]): boolean;
   setOverlayVisible(id: string, visible: boolean): boolean;
+  setOverlayHighlight(entityOrId: any | string, enabled: boolean, reason?: 'click' | 'hover'): boolean;
   getAllOverlayIds(): string[];
   getAllOverlays(): any[]; // Cesium.Entity[]
   destroy(): void;
@@ -728,9 +774,43 @@ export interface DrawOptions {
     outlineColor?: Cesium.Color | string;
     outlineWidth?: number;
   };
+  /**
+   * 是否显示面积标签（适用于 polygon/rectangle/circle）。
+   * 默认 true；设为 false 可禁用绘制完成后自动创建的面积标签。
+   */
+  showAreaLabel?: boolean;
+  /**
+   * 多边形自相交校验：是否允许“擦边/顶点落在旧边上”等仅接触（touch）情况。
+   * - false/未设置：touch 也视为不合法
+   * - true：允许 touch，但仍不允许重叠（overlap）与真正穿越（cross）
+   */
+  selfIntersectionAllowTouch?: boolean;
+
+  /**
+   * 多边形自相交校验：当即将产生自相交时，是否仍允许继续绘制/完成绘制。
+   * - false/未设置：检测到自相交则阻止落点/阻止完成
+   * - true：检测到自相交不拦截（由业务自行承担后续面积/中心等偏差风险）
+   */
+  selfIntersectionAllowContinue?: boolean;
   onClick?: (entity: Entity, type?: 'line' | 'polygon' | 'rectangle' | 'circle', positions?: Cartesian3[]) => void;
 }
 
+/**
+ * 绘制模块扩展实体类型（用于在 Entity 上挂载绘图相关元数据）
+ */
+export interface DrawEntity extends Entity {
+  _drawType?: 'line' | 'polygon' | 'rectangle' | 'circle';
+  _drawOptions?: DrawOptions;
+  _groundPositions?: Cartesian3[];
+  _groundPosition?: Cartesian3;
+  _groundRectangle?: Cesium.Rectangle;
+  _radius?: number;
+  _borderEntity?: Entity;
+  /** 关联的测量/提示标签实体（例如面积标签） */
+  _labelEntities?: Entity[];
+  _onClick?: (entity: Entity, ...args: any[]) => void;
+}
+
 export declare class DrawHelper {
   constructor(viewer: Viewer);
   // 开始绘制（可选样式参数）
@@ -746,6 +826,8 @@ export declare class DrawHelper {
   clearAllPoints(): void;
   removeEntity(entity: Entity): void;
   getFinishedEntities(): Entity[];
+  /** 获取绘制实体关联的标签实体（例如面积标签） */
+  getEntityLabelEntities(entity: Entity): Entity[];
   // 事件回调注册
   onMeasureComplete(callback: (result: DrawResult) => void): void;
   onDrawStart(callback: () => void): void;