@jorgmoritz/gis-manager 0.1.31 → 0.1.33

package/dist/index.d.ts

@@ -780,156 +780,6 @@ declare function renderFlightPathPreview(CesiumNS: typeof Cesium, viewer: Cesium
     controller: FlightPathPreviewController;
 };
 
-/**
- * 飞行预览控制器
- *
- * 功能：
- * - 飞机沿航线飞行动画（循环播放）
- * - 第一人称镜头预览窗口
- * - 轨迹高亮（已飞过/未飞过航段）
- * - 预览模式下禁用交互
- */
-
-/** 播放状态 */
-type FlightPreviewState = 'playing' | 'paused' | 'stopped';
-/** 轨迹高亮配置 */
-interface TrackHighlightOptions {
-    /** 是否启用，默认 true */
-    enabled?: boolean;
-    /** 已飞过航段颜色 */
-    traveledColor?: Cesium.Color;
-    /** 未飞过航段颜色 */
-    remainingColor?: Cesium.Color;
-    /** 已飞过航段宽度 */
-    traveledWidth?: number;
-    /** 未飞过航段宽度 */
-    remainingWidth?: number;
-}
-/** 飞行预览选项 */
-interface FlightPreviewOptions {
-    /** 航线数据 */
-    waylineData: SinoflyWaylineData;
-    /** 飞行速度 (m/s)，默认 10 */
-    speed?: number;
-    /** 是否循环播放，默认 true */
-    loop?: boolean;
-    /** 预览窗口容器 */
-    previewContainer?: HTMLElement;
-    /** 是否显示视锥体，默认 true */
-    showFrustum?: boolean;
-    /** 轨迹高亮配置 */
-    trackHighlight?: TrackHighlightOptions;
-    /** 数据源图层 */
-    layer?: Cesium.CustomDataSource;
-}
-/** 进度变化事件 */
-interface ProgressChangeEvent {
-    /** 当前进度 (0-1) */
-    progress: number;
-    /** 当前位置 */
-    position: Cesium.Cartesian3;
-    /** 当前航点索引 */
-    waypointIndex: number;
-    /** 当前姿态 */
-    pose: {
-        heading: number;
-        pitch: number;
-        roll: number;
-    };
-}
-/** 状态变化事件 */
-interface StateChangeEvent {
-    state: FlightPreviewState;
-}
-/**
- * 飞行预览控制器
- */
-declare class FlightPreviewController {
-    private CesiumNS;
-    private viewer;
-    private options;
-    private state;
-    private destroyed;
-    private speed;
-    private loop;
-    private showFrustum;
-    private trackHighlightOptions;
-    private waypoints;
-    private totalDistance;
-    private currentDistance;
-    private animationFrameId?;
-    private lastFrameTime?;
-    private layer?;
-    private droneEntity?;
-    private frustum?;
-    private pathPreview?;
-    private traveledPathEntity?;
-    private remainingPathEntity?;
-    onStateChange: Emitter<StateChangeEvent>;
-    onProgressChange: Emitter<ProgressChangeEvent>;
-    constructor(CesiumNS: typeof Cesium, viewer: Cesium.Viewer, options: FlightPreviewOptions);
-    /** 开始预览 */
-    start(): void;
-    /** 暂停 */
-    pause(): void;
-    /** 继续 */
-    resume(): void;
-    /** 停止并重置 */
-    stop(): void;
-    /** 跳转到指定进度 (0-1) */
-    seek(progress: number): void;
-    /** 设置速度 */
-    setSpeed(speed: number): void;
-    /** 获取当前状态 */
-    getState(): FlightPreviewState;
-    /** 获取当前进度 (0-1) */
-    getProgress(): number;
-    /** 获取当前航点索引 */
-    getCurrentWaypointIndex(): number;
-    /** 销毁 */
-    destroy(): void;
-    /** 初始化图层 */
-    private initLayer;
-    /** 解析航线数据 */
-    private parseWaylineData;
-    /** 初始化可视化组件 */
-    private initVisualization;
-    /** 初始化无人机模型 */
-    private initDroneModel;
-    /** 应用模型偏移 */
-    private applyModelOffset;
-    /** 初始化视锥体 */
-    private initFrustum;
-    /** 初始化轨迹高亮 */
-    private initTrackHighlight;
-    /** 初始化预览窗口 */
-    private initPathPreview;
-    /** 启动动画循环 */
-    private startAnimationLoop;
-    /** 停止动画循环 */
-    private stopAnimationLoop;
-    /** 查找当前所在航段 */
-    private findCurrentSegment;
-    /** 获取当前姿态 */
-    private getCurrentPose;
-    /** 位置插值 */
-    private interpolatePosition;
-    /** 角度插值（处理 0-360 环绕） */
-    private interpolateAngle;
-    /** 线性插值 */
-    private lerp;
-    /** 获取已飞过的位置数组 */
-    private getTraveledPositions;
-    /** 获取未飞过的位置数组 */
-    private getRemainingPositions;
-    /** 更新可视化 */
-    private updateVisualization;
-    /** 设置状态 */
-    private setState;
-    /** 销毁可视化组件 */
-    private destroyVisualization;
-}
-
 type PathSample = {
     time: Cesium.JulianDate | Date | string | number;
     lon: number;
@@ -1298,6 +1148,7 @@ declare class PolygonEditor {
     private insertPreviewHandle?;
     private keydownHandler?;
     private originalPolygonNames;
+    private doubleClickZoomDisabled;
     constructor(CesiumNS: typeof Cesium, viewer: Viewer$1);
     /**
      * 根据图层名称获取颜色配置
@@ -1355,6 +1206,16 @@ declare class PolygonEditor {
      * 销毁事件处理器
      */
     private destroyHandler;
+    /**
+     * 禁用 Cesium 默认的双击缩放行为
+     * 在绘制/编辑过程中调用，防止双击导致相机乱飞
+     */
+    private disableDoubleClickZoom;
+    /**
+     * 恢复 Cesium 默认的双击缩放行为
+     * 在绘制/编辑结束后调用
+     */
+    private restoreDoubleClickZoom;
     /**
      * 完成编辑/绘制的通用清理逻辑
      */
@@ -1788,26 +1649,20 @@ interface PreviousViewChange {
     current?: CameraView;
     previous?: CameraView;
 }
-interface FlightPreviewChange {
-    previewing: boolean;
-}
 /**
  * Lightweight state manager for common UI states:
  * - selection (arbitrary payload)
  * - editing (boolean + optional target)
  * - previous camera view (for simple back navigation)
- * - flight preview mode (locks interaction)
  */
 declare class StateManager<TSelection = unknown, TEditingTarget = unknown> {
     private selected?;
     private editing;
     private editingTarget?;
     private previousView?;
-    private flightPreviewing;
     readonly onSelectionChange: Emitter<SelectionChange<TSelection>>;
     readonly onEditingChange: Emitter<EditingChange<TEditingTarget>>;
     readonly onPreviousViewChange: Emitter<PreviousViewChange>;
-    readonly onFlightPreviewChange: Emitter<FlightPreviewChange>;
     setSelected(next?: TSelection): void;
     /**
      * 获取当前选中对象。
@@ -1824,22 +1679,6 @@ declare class StateManager<TSelection = unknown, TEditingTarget = unknown> {
     getEditingTarget(): TEditingTarget | undefined;
     setPreviousCameraView(view?: CameraView): void;
     getPreviousCameraView(): CameraView | undefined;
-    /**
-     * 开始飞行预览模式（锁定交互）
-     */
-    startFlightPreview(): void;
-    /**
-     * 停止飞行预览模式（恢复交互）
-     */
-    stopFlightPreview(): void;
-    /**
-     * 检查是否处于飞行预览模式
-     */
-    isFlightPreviewing(): boolean;
-    /**
-     * 检查当前是否允许交互（非编辑模式且非飞行预览模式）
-     */
-    isInteractionAllowed(): boolean;
 }
 declare const globalState: StateManager<any, any>;
 
@@ -2218,8 +2057,116 @@ interface PathToSinoflyOptions {
  */
 declare function convertPathToSinofly(data: PathEditingSaveResult, options: PathToSinoflyOptions): SinoflyWaylineData;
 
+/**
+ * 单个航段安全检测结果
+ */
+interface SegmentSafetyResult {
+    /** 起点索引 */
+    fromIndex: number;
+    /** 终点索引 */
+    toIndex: number;
+    /** 地形距离是否安全 */
+    isTerrainSafe: boolean;
+    /** 点云距离是否安全 */
+    isPointCloudSafe: boolean;
+    /** 航点间距是否安全 */
+    isDistanceSafe: boolean;
+    /** 是否安全（综合判断） */
+    isSafe: boolean;
+    /** 与地形最小距离（米） */
+    minTerrainDistance: number;
+    /** 与点云最小距离（米） */
+    minPointCloudDistance: number;
+    /** 航段长度（米） */
+    segmentLength: number;
+    /** 危险点列表 */
+    dangerPoints: Cesium.Cartesian3[];
+}
+/**
+ * 完整路径安全检测结果
+ */
+interface PathSafetyCheckResult {
+    /** 是否全部安全 */
+    allSafe: boolean;
+    /** 所有航段结果 */
+    segments: SegmentSafetyResult[];
+    /** 不安全的航段 */
+    unsafeSegments: SegmentSafetyResult[];
+    /** 地形安全距离阈值 */
+    terrainSafetyDistance: number;
+    /** 点云安全距离阈值 */
+    pointCloudSafetyDistance: number;
+    /** 航点间最小距离阈值 */
+    minWaypointDistance: number;
+}
+/**
+ * 安全检测选项
+ */
+interface PathSafetyCheckOptions {
+    /**
+     * 统一安全距离（米），同时设置地形和点云安全距离，默认 20
+     * 如果单独设置了 terrainSafetyDistance 或 pointCloudSafetyDistance，会覆盖此值
+     */
+    safetyDistance?: number;
+    /** 地形安全距离（米），航线与地形的最小距离，默认使用 safetyDistance */
+    terrainSafetyDistance?: number;
+    /** 点云安全距离（米），航线与点云的最小距离，默认使用 safetyDistance */
+    pointCloudSafetyDistance?: number;
+    /** 航点间最小距离（米），相邻航点之间的最小距离，默认 0（不检测） */
+    minWaypointDistance?: number;
+    /** 采样间隔（米），每隔多少米采样一次，默认 5 */
+    sampleInterval?: number;
+}
+/**
+ * 航线安全检测器
+ * 检测航线与点云/地形之间的安全距离
+ */
+declare class PathSafetyChecker {
+    private CesiumNS;
+    private viewer;
+    constructor(CesiumNS: typeof Cesium, viewer: Cesium.Viewer);
+    /**
+     * 检测整条路径的安全性
+     * @param positions 航点位置数组
+     * @param options 检测选项
+     */
+    checkPath(positions: Cesium.Cartesian3[], options?: PathSafetyCheckOptions): PathSafetyCheckResult;
+    /**
+     * 检测单个航段的安全性
+     * 支持多方向检测（上下左右前后6方向）和按间隔采样
+     */
+    private checkSegment;
+    /**
+     * 可视化危险点（用于调试）
+     */
+    visualizeDangerPoints(result: PathSafetyCheckResult, layer: Cesium.CustomDataSource): Cesium.Entity[];
+    /**
+     * 清除危险点可视化
+     */
+    clearDangerPoints(layer: Cesium.CustomDataSource): void;
+    /**
+     * 沿航线创建3D安全管道可视化（使用 Cylinder）
+     * 每个航段创建一个水平圆柱体，圆柱轴心与航线重合
+     * @param positions 航点位置数组
+     * @param layer 实体图层
+     * @param options 可视化选项
+     */
+    visualizeSafetyTube(positions: Cesium.Cartesian3[], layer: Cesium.CustomDataSource, options?: {
+        /** 管道半径（米），即安全距离，默认 20 */
+        radius?: number;
+        /** 颜色，默认黄色半透明 */
+        color?: Cesium.Color;
+        /** 跳过第一段，默认 true */
+        skipFirstSegment?: boolean;
+    }): Cesium.Entity[];
+    /**
+     * 清除安全管道可视化
+     */
+    clearSafetyTube(layer: Cesium.CustomDataSource): void;
+}
+
 declare const placeholder: {
     ready: boolean;
 };
 
-export { CZMLManager, type CameraDestinationInput, CameraEventBus, type CameraFOVChangeEvent, CameraFOVController, type CameraFlyOptions, type CameraInitOptions, CameraManager, type CameraOrientation, type CameraPoseChangeEvent, type CameraSetViewOptions, type CameraView, type CesiumAssetsOptions, type ConvertedWaylineData, type ConvertedWaypointData, type CursorPoseChangeEvent, type CzmlExportOptions, type CzmlImportOptions, type EditingChange, Emitter, type FOVChangeEvent, type FOVControllerOptions, type FlightPathPreviewController, type FlightPreviewChange, FlightPreviewController, type FlightPreviewOptions, type FlightPreviewState, type FlyToOptions, FrustumPyramid, type FrustumPyramidOptions, type FrustumShapeChangeEvent, type ImageryOptions, type ImageryProviderKind, type InitOptions, type LayerEvents, type LayerHandle, LayerManager, type LayerType, type Listener, type LonLatHeight, type Orientation, type PathEditingSaveResult, type PathOptions, type PathToSinoflyOptions, type PhotoBillboardItem, type PhotoBillboardLayerOptions, type PhotoBillboardResult, type PolygonDrawingOptions, type PolygonEditingSession, PolygonEditor, type PreviousViewChange, type ProgressChangeEvent, type QuickEditOptions, type RenderFlightPathOptions, type RenderFlightPathPreviewOptions, SceneManager, type SceneOptions, type SelectionChange, type SelectionResult, type SelectionSession, Selector, type ShapeLineProps, type ShapePointProps, type ShapePolygonProps, type SinoflyAdapterOptions, type SinoflyWaylineData, type SinoflyWaypointInfo, type StateChangeEvent, StateManager, type TerrainKind, type TerrainOptions, type Toggle2D3DContext, type Toggle2D3DOptions, type TrackHighlightOptions, type VersionInfo, assertCesiumAssetsConfigured, configureCesiumAssets, configureCesiumIonToken, convertPathToSinofly, convertSinoflyWayline, convertSinoflyWaylines, ensureCesiumIonToken, getCesiumBaseUrl, getCesiumIonToken, globalCameraEventBus, globalState, placeholder, renderFlightPath, renderFlightPathPreview, toggle2D3D, version, versionInfo };
+export { CZMLManager, type CameraDestinationInput, CameraEventBus, type CameraFOVChangeEvent, CameraFOVController, type CameraFlyOptions, type CameraInitOptions, CameraManager, type CameraOrientation, type CameraPoseChangeEvent, type CameraSetViewOptions, type CameraView, type CesiumAssetsOptions, type ConvertedWaylineData, type ConvertedWaypointData, type CursorPoseChangeEvent, type CzmlExportOptions, type CzmlImportOptions, type EditingChange, Emitter, type FOVChangeEvent, type FOVControllerOptions, type FlightPathPreviewController, type FlyToOptions, FrustumPyramid, type FrustumPyramidOptions, type FrustumShapeChangeEvent, type ImageryOptions, type ImageryProviderKind, type InitOptions, type LayerEvents, type LayerHandle, LayerManager, type LayerType, type Listener, type LonLatHeight, type Orientation, type PathEditingSaveResult, type PathOptions, type PathSafetyCheckOptions, type PathSafetyCheckResult, PathSafetyChecker, type PathToSinoflyOptions, type PhotoBillboardItem, type PhotoBillboardLayerOptions, type PhotoBillboardResult, type PolygonDrawingOptions, type PolygonEditingSession, PolygonEditor, type PreviousViewChange, type QuickEditOptions, type RenderFlightPathOptions, type RenderFlightPathPreviewOptions, SceneManager, type SceneOptions, type SegmentSafetyResult, type SelectionChange, type SelectionResult, type SelectionSession, Selector, type ShapeLineProps, type ShapePointProps, type ShapePolygonProps, type SinoflyAdapterOptions, type SinoflyWaylineData, type SinoflyWaypointInfo, StateManager, type TerrainKind, type TerrainOptions, type Toggle2D3DContext, type Toggle2D3DOptions, type VersionInfo, assertCesiumAssetsConfigured, configureCesiumAssets, configureCesiumIonToken, convertPathToSinofly, convertSinoflyWayline, convertSinoflyWaylines, ensureCesiumIonToken, getCesiumBaseUrl, getCesiumIonToken, globalCameraEventBus, globalState, placeholder, renderFlightPath, renderFlightPathPreview, toggle2D3D, version, versionInfo };