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

package/dist/libs/CesiumHeatmapLayer.d.ts

@@ -20,6 +20,10 @@ export interface HeatmapOptions {
     height?: number;
     /** 单个点的影响半径（像素） */
     radius?: number;
+    /** 低强度提升（伽马矫正），< 1 可增强边缘，默认 0.7 */
+    gamma?: number;
+    /** 最小可见 alpha（0~1），用于避免外圈完全消失，默认 0.03 */
+    minAlpha?: number;
     /** 最小/最大值，用于归一化 value，如果不传则自动根据数据计算 */
     minValue?: number;
     maxValue?: number;
@@ -47,6 +51,7 @@ export default class CesiumHeatmapLayer {
     private viewer;
     private imageryLayer;
     private rectangle;
+    private fullDataRectangle;
     private canvas;
     private ctx;
     private options;

package/dist/libs/CesiumMapToolbar.d.ts

@@ -1,4 +1,9 @@
 import { Viewer } from '../../node_modules/cesium';
+import { CesiumMapController } from './toolBar/CesiumMapController';
+import { MeasurementService } from './toolBar/MeasurementService';
+import { SearchService } from './toolBar/MapSearchService';
+import { MapLayersService } from './toolBar/MapLayersService';
+import { NotFlyZonesService } from './toolBar/NotFlyZonesService';
 import { MapType, ToolbarConfig, SearchCallback, MeasurementCallback, ZoomCallback, CustomButtonConfig } from './CesiumMapModel';
 /**
  * Cesium地图工具栏类
@@ -15,6 +20,8 @@ export declare class CesiumMapToolbar {
     private notFlyZonesService;
     private measurementCallback?;
     private zoomCallback?;
+    private fullscreenCallback?;
+    private resetLocationCallback?;
     private initialCenter?;
     private currentMapType;
     TD_Token: string;
@@ -30,12 +37,42 @@ export declare class CesiumMapToolbar {
         search?: SearchCallback;
         measurement?: MeasurementCallback;
         zoom?: ZoomCallback;
+        fullscreen?: (isFullscreen: boolean) => void;
+        resetLocation?: () => void;
     }, initialCenter?: {
         longitude: number;
         latitude: number;
         height: number;
     });
+    /**
+     * searchService 对外暴露的获取搜索服务方法
+     */
+    getSearchService(): SearchService;
+    /**
+     * notFlyZonesService 对外暴露的获取禁飞区服务方法
+     */
+    getNotFlyZonesService(): NotFlyZonesService;
+    /**
+     * measurementService 对外暴露的获取测量服务方法
+     */
+    getMeasurementService(): MeasurementService;
+    /**
+     * cesmapController 对外暴露的获取地图控制器方法
+     */
+    getCesiumMapCtrl(): CesiumMapController;
+    /**
+     * mapLayersService 对外暴露的获取图层服务方法
+     */
+    getMapLayersService(): MapLayersService;
+    /**
+     * 设置地图类型配置
+     * @param mapTypes
+     */
     setMapTypes(mapTypes: MapType[]): void;
+    /**
+     * 设置天地图密钥
+     * @param TD_Token
+     */
     setTDToken(TD_Token: string): void;
     /**
      * 设置初始中心点
@@ -69,7 +106,13 @@ export declare class CesiumMapToolbar {
     /**
      * 获取所有按钮配置（包括默认按钮和自定义按钮），并添加 sort 值
      */
-    private getAllButtonsWithSort;
+    private resolveIcon;
+    /**
+     * 获取按钮配置（已排序，包含默认按钮兜底）
+     * - 未传 buttons：使用默认按钮
+     * - 传了 buttons：按传入按钮列表渲染，并用默认按钮补齐缺省字段
+     */
+    private getButtonConfigs;
     /**
      * 重新构建工具栏按钮
      */
@@ -86,10 +129,6 @@ export declare class CesiumMapToolbar {
      * 创建工具栏
      */
     private createToolbar;
-    /**
-     * 获取按钮配置（已排序）
-     */
-    private getButtonConfigs;
     /**
      * 创建按钮
      */

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

@@ -43,6 +43,13 @@ export interface CircleOptions {
         fillAlpha?: number;
     };
     onClick?: (entity: Entity) => void;
+    /**
+     * Primitive 模式分层渲染 key。
+     * - 相同 layerKey 的 circle 会被合并到同一个批次中（更高性能）
+     * - 不同 layerKey 会进入不同的“图层空间”，并按首次出现顺序确定上下层
+     * - 只对 primitive 生效；entity 模式忽略
+     */
+    layerKey?: string;
     id?: string;
 }
 /**
@@ -52,9 +59,13 @@ 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;
     private addPrimitiveCircle;

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

@@ -36,6 +36,13 @@ export interface PolygonOptions {
         fillAlpha?: number;
     };
     onClick?: (entity: Entity) => void;
+    /**
+     * Primitive 模式分层渲染 key。
+     * - 相同 layerKey 的 polygon 会被合并到同一个批次中（更高性能）
+     * - 不同 layerKey 会进入不同的“图层空间”，并按首次出现顺序确定上下层
+     * - 只对 primitive 生效；entity 模式忽略
+     */
+    layerKey?: string;
     id?: string;
 }
 /**
@@ -45,8 +52,12 @@ export declare class MapPolygon {
     private viewer;
     private entities;
     private primitiveBatch;
+    private primitiveLayerStack;
+    private primitiveBatchesByLayer;
     constructor(viewer: Viewer);
     private getPrimitiveBatch;
+    private getLayeredPrimitiveBatch;
+    private getPrimitiveBatchForOverlay;
     private resolveMaterialColor;
     private canUsePrimitive;
     private addPrimitivePolygon;

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

@@ -36,6 +36,13 @@ export interface RectangleOptions {
         fillAlpha?: number;
     };
     onClick?: (entity: Entity) => void;
+    /**
+     * Primitive 模式分层渲染 key。
+     * - 相同 layerKey 的 rectangle 会被合并到同一个批次中（更高性能）
+     * - 不同 layerKey 会进入不同的“图层空间”，并按首次出现顺序确定上下层
+     * - 只对 primitive 生效；entity 模式忽略
+     */
+    layerKey?: string;
     id?: string;
 }
 /**
@@ -45,8 +52,12 @@ export declare class MapRectangle {
     private viewer;
     private entities;
     private primitiveBatch;
+    private primitiveLayerStack;
+    private primitiveBatchesByLayer;
     constructor(viewer: Viewer);
     private getPrimitiveBatch;
+    private getLayeredPrimitiveBatch;
+    private getPrimitiveBatchForOverlay;
     private resolveMaterialColor;
     private canUsePrimitive;
     private addPrimitiveRectangle;

package/dist/libs/overlay/primitives/CirclePrimitiveBatch.d.ts

@@ -6,14 +6,20 @@ export interface CirclePrimitiveParts {
 }
 export declare class CirclePrimitiveBatch {
     private viewer;
-    private collection;
+    private ringCollection;
+    private fillCollection;
+    private ownsCollections;
+    private ownedRootCollection;
     private ringPrimitive;
     private fillPrimitive;
     private records;
     private rebuildScheduled;
     private colorApplyScheduled;
     private pendingColorApplyIds;
-    constructor(viewer: Viewer);
+    constructor(viewer: Viewer, options?: {
+        ringCollection?: Cesium.PrimitiveCollection;
+        fillCollection?: Cesium.PrimitiveCollection;
+    });
     destroy(): void;
     has(circleId: string): boolean;
     upsertGeometry(args: {

package/dist/libs/overlay/primitives/CirclePrimitiveLayerStack.d.ts

@@ -0,0 +1,24 @@
+import { Viewer } from '../../../../node_modules/cesium';
+import * as Cesium from 'cesium';
+export interface CirclePrimitiveLayerCollections {
+    fillCollection: Cesium.PrimitiveCollection;
+    ringCollection: Cesium.PrimitiveCollection;
+}
+/**
+ * Maintains a stable, ordered layer stack for Circle primitive rendering.
+ *
+ * Rendering order:
+ * - all fill layers (bottom -> top)
+ * - all ring layers (bottom -> top)
+ *
+ * This ensures boundaries (rings) remain visible even when multiple translucent fills overlap.
+ */
+export declare class CirclePrimitiveLayerStack {
+    private viewer;
+    private fillsRoot;
+    private ringsRoot;
+    private layers;
+    constructor(viewer: Viewer);
+    getLayerCollections(layerKey: string): CirclePrimitiveLayerCollections;
+    destroy(): void;
+}

package/dist/libs/overlay/primitives/PolygonPrimitiveBatch.d.ts

@@ -6,14 +6,20 @@ export interface PolygonPrimitiveParts {
 }
 export declare class PolygonPrimitiveBatch {
     private viewer;
-    private collection;
+    private fillCollection;
+    private borderCollection;
+    private ownsCollections;
+    private ownedRootCollection;
     private fillPrimitive;
     private borderPrimitive;
     private records;
     private rebuildScheduled;
     private colorApplyScheduled;
     private pendingColorApplyIds;
-    constructor(viewer: Viewer);
+    constructor(viewer: Viewer, options?: {
+        fillCollection?: Cesium.PrimitiveCollection;
+        borderCollection?: Cesium.PrimitiveCollection;
+    });
     destroy(): void;
     upsertGeometry(args: {
         polygonId: string;

package/dist/libs/overlay/primitives/PolygonPrimitiveLayerStack.d.ts

@@ -0,0 +1,24 @@
+import { Viewer } from '../../../../node_modules/cesium';
+import * as Cesium from 'cesium';
+export interface PolygonPrimitiveLayerCollections {
+    fillCollection: Cesium.PrimitiveCollection;
+    borderCollection: Cesium.PrimitiveCollection;
+}
+/**
+ * Maintains a stable, ordered layer stack for Polygon primitive rendering.
+ *
+ * Rendering order:
+ * - all fill layers (bottom -> top)
+ * - all border layers (bottom -> top)
+ *
+ * This ensures borders remain visible even when multiple translucent fills overlap.
+ */
+export declare class PolygonPrimitiveLayerStack {
+    private viewer;
+    private fillsRoot;
+    private bordersRoot;
+    private layers;
+    constructor(viewer: Viewer);
+    getLayerCollections(layerKey: string): PolygonPrimitiveLayerCollections;
+    destroy(): void;
+}

package/dist/libs/overlay/primitives/RectanglePrimitiveBatch.d.ts

@@ -6,14 +6,20 @@ export interface RectanglePrimitiveParts {
 }
 export declare class RectanglePrimitiveBatch {
     private viewer;
-    private collection;
+    private ringCollection;
+    private fillCollection;
+    private ownsCollections;
+    private ownedRootCollection;
     private ringPrimitive;
     private fillPrimitive;
     private records;
     private rebuildScheduled;
     private colorApplyScheduled;
     private pendingColorApplyIds;
-    constructor(viewer: Viewer);
+    constructor(viewer: Viewer, options?: {
+        ringCollection?: Cesium.PrimitiveCollection;
+        fillCollection?: Cesium.PrimitiveCollection;
+    });
     destroy(): void;
     upsertGeometry(args: {
         rectangleId: string;

package/dist/libs/overlay/primitives/RectanglePrimitiveLayerStack.d.ts

@@ -0,0 +1,24 @@
+import { Viewer } from '../../../../node_modules/cesium';
+import * as Cesium from 'cesium';
+export interface RectanglePrimitiveLayerCollections {
+    fillCollection: Cesium.PrimitiveCollection;
+    ringCollection: Cesium.PrimitiveCollection;
+}
+/**
+ * 为矩形 Primitive 渲染维护一个稳定的有序图层栈。
+ *
+ * 渲染顺序：
+ * - 所有填充图层（从下到上）
+ * - 所有描边图层（从下到上）
+ *
+ * 这样可以确保在存在多个半透明填充重叠时，描边仍然清晰可见。
+ */
+export declare class RectanglePrimitiveLayerStack {
+    private viewer;
+    private fillsRoot;
+    private ringsRoot;
+    private layers;
+    constructor(viewer: Viewer);
+    getLayerCollections(layerKey: string): RectanglePrimitiveLayerCollections;
+    destroy(): void;
+}

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

@@ -106,6 +106,8 @@ export interface OverlayEntity extends Entity {
     _innerRadius?: number;
     _outerRectangle?: Rectangle;
     /** primitive circle: 内部使用的纯色缓存（用于高亮恢复） */
+    /** primitive layer key: 用于分层批处理路由 */
+    _primitiveLayerKey?: string;
     _primitiveRingBaseColor?: Color;
     _primitiveFillBaseColor?: Color;
     /** primitive polygon/rectangle: 边框纯色缓存（用于高亮恢复） */

package/dist/libs/toolBar/CesiumMapController.d.ts

@@ -17,6 +17,10 @@ interface CesiumMapControllerOptions {
     zoomCallback?: ZoomCallback;
     /** 场景模式切换后回调（例如通知 DrawHelper 重新计算偏移） */
     onSceneModeChanged?: () => void;
+    /** 全屏切换回调 */
+    fullscreenCallback?: (isFullscreen: boolean) => void;
+    /** 复位位置回调 */
+    resetLocationCallback?: () => void;
 }
 /**
  * 负责地图相机控制、缩放层级和 2D/3D 切换等逻辑的控制器
@@ -30,6 +34,8 @@ export declare class CesiumMapController {
     private getToken?;
     private zoomCallback?;
     private onSceneModeChanged?;
+    private fullscreenCallback?;
+    private resetLocationCallback?;
     constructor(viewer: Viewer, options?: CesiumMapControllerOptions);
     /**
      * 监听相机缩放，限制层级范围到 [1, 18]，并参考当前底图的 maximumLevel

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xingm/vmap-cesium-toolbar",
-  "version": "0.0.2-alpha.14",
+  "version": "0.0.2-alpha.16",
   "description": "A powerful Cesium map toolbar plugin with drawing, measurement, and interaction features",
   "type": "module",
   "main": "index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xingm/vmap-cesium-toolbar",
-  "version": "0.0.2-alpha.14",
+  "version": "0.0.2-alpha.16",
   "description": "A powerful Cesium map toolbar plugin with drawing, measurement, and interaction features",
   "type": "module",
   "main": "dist/index.js",
@@ -25,6 +25,9 @@
     "build": "vite build --mode lib",
     "build:dts": "vue-tsc -p tsconfig.dts.json",
     "build:plugin": "node scripts/build-plugin.js",
+    "docs:dev": "vitepress dev doc",
+    "docs:build": "vitepress build doc",
+    "docs:preview": "vitepress preview doc",
     "generate:file-list": "node scripts/generate-file-list.js",
     "preview": "vite preview",
     "type-check": "vue-tsc --noEmit"
@@ -41,6 +44,7 @@
     "@vitejs/plugin-vue": "^6.0.1",
     "rollup-plugin-dts": "^6.1.0",
     "vite": "^7.1.2",
+    "vitepress": "^1.6.4",
     "vite-plugin-cesium": "^1.2.23",
     "vite-plugin-dts": "^4.5.4",
     "vite-plugin-static-copy": "^3.1.2",