@jorgmoritz/gis-manager 0.1.36 → 0.1.38

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as Cesium from 'cesium';
-export { V as VertexDetailInfo, b as VertexDragMoveInfo, a as VertexOperationInfo, c as WaypointBatchUpdate, W as WaypointUpdateData } from './VertexDetailInfo-Cz9y16HG.js';
+export { V as VertexDetailInfo, b as VertexDragMoveInfo, a as VertexOperationInfo, c as WaypointBatchUpdate, W as WaypointUpdateData } from './VertexDetailInfo-DYr1P_fe.js';
 
 interface InitOptions {
     appName?: string;
@@ -440,6 +440,12 @@ interface SinoflyWaypointInfo {
     createTime?: string;
     modifyUserId?: string;
     modifyTime?: string;
+    /** 🆕 椭球高度（WGS84 椭球面以上的高度，米） */
+    ellipsoidHeight?: number;
+    /** 🆕 相对高度（根据 altitudeMode 计算：海拔高度或相对地形高度，米） */
+    relativeHeight?: number;
+    /** 🆕 是否使用全局默认高度（true: 高度=defaultAltitude, false: 高度=实际计算值） */
+    useGlobalHeight?: boolean;
 }
 /**
  * Sinofly 航线路数据结构接口
@@ -485,6 +491,8 @@ interface ConvertedWaypointData {
     roll: number;
     fov: number;
     index: number;
+    /** 🆕 是否使用全局默认高度（true: 高度=defaultAltitude, false: 高度=实际计算值） */
+    useGlobalHeight?: boolean;
 }
 /**
  * 转换后的航线路数据格式
@@ -506,8 +514,8 @@ interface ConvertedWaylineData {
         subarrayId?: number;
         stationName?: string;
         subarrayName?: string;
-        takeOffSecurityHeight?: number;
-        hasTakeOffRefPoint?: boolean;
+        /** 爬升高度（基础高度偏移） */
+        climbHeight?: number;
         [key: string]: any;
     };
 }
@@ -653,24 +661,17 @@ interface RenderFlightPathOptions {
         color?: Cesium.Color;
         material?: Cesium.MaterialProperty | Cesium.Color;
     };
-    hasHiddenClimb?: boolean;
     altitudeMode?: string;
     climbHeight?: number;
 }
 /**
- * 回显飞航路线：显示完整飞航路线、航点编号和起始点箭头
+ * 回显飞航路线：显示完整飞航路线和航点编号
  *
  * 接收 Sinofly 航线路数据，自动转换为本库格式并渲染显示。
  *
  * 航点逻辑说明：
- * - index 0: 起始点（起飞点），显示起始箭头（仅当有 takeOffRefPoint 时）
- * - index 1: 隐藏转折点（隐藏爬升点），不显示标签（仅当有 takeOffRefPoint 时）
- * - index 2: 第一个航线点，标记为 "S"
- * - index 3+: 后续航线点，标记为 2, 3, 4...
- *
- * 如果没有 takeOffRefPoint，则：
  * - index 0: 第一个航线点，标记为 "S"
- * - index 1+: 后续航线点，标记为 2, 3, 4...
+ * - index 1+: 后续航线点，标记为 1, 2, 3...
  *
  * @param CesiumNS Cesium 命名空间
  * @param viewer Cesium Viewer 实例
@@ -683,8 +684,6 @@ interface RenderFlightPathOptions {
  * const sinoflyData = {
  *   waylineId: "12345",
  *   waylineName: "测试航线",
- *   takeOffSecurityHeight: 50,
- *   takeOffRefPoint: '{"longitude": 116.4074, "latitude": 39.9042, "height": 100}',
  *   waypointInfo: [
  *     {
  *       index: 0,
@@ -707,21 +706,6 @@ interface RenderFlightPathOptions {
  *   layer: myLayer,
  *   style: { width: 8, color: Cesium.Color.GREEN }
  * });
- *
- * // 自定义样式
- * const entity = renderFlightPath(Cesium, viewer, {
- *   data: sinoflyData,
- *   id: 'my-flight-path',
- *   name: '自定义航线名称',
- *   style: {
- *     width: 10,
- *     material: new Cesium.PolylineOutlineMaterialProperty({
- *       color: Cesium.Color.BLUE,
- *       outlineColor: Cesium.Color.WHITE,
- *       outlineWidth: 2
- *     })
- *   }
- * });
  * ```
  */
 declare function renderFlightPath(CesiumNS: typeof Cesium, viewer: Cesium.Viewer, options: RenderFlightPathOptions): Entity$1;
@@ -780,6 +764,128 @@ declare function renderFlightPathPreview(CesiumNS: typeof Cesium, viewer: Cesium
     controller: FlightPathPreviewController;
 };
 
+/**
+ * 飞行仿真状态
+ */
+type FlightSimulatorState = 'idle' | 'playing' | 'paused' | 'stopped';
+/**
+ * 飞行仿真状态变化事件
+ */
+interface FlightSimulatorStateChangeEvent {
+    state: FlightSimulatorState;
+    progress?: number;
+}
+/**
+ * 飞行仿真控制器接口
+ */
+interface FlightSimulatorController {
+    /** 开始播放 */
+    start(): void;
+    /** 暂停 */
+    pause(): void;
+    /** 恢复播放 */
+    resume(): void;
+    /** 停止并重置 */
+    stop(): void;
+    /** 销毁并清理资源 */
+    destroy(): void;
+    /** 设置飞行速度 (m/s) */
+    setSpeed(speed: number): void;
+    /** 获取当前状态 */
+    getState(): FlightSimulatorState;
+    /** 获取当前进度 (0-1) */
+    getProgress(): number;
+    /** 状态变化事件 */
+    onStateChange: Emitter<FlightSimulatorStateChangeEvent>;
+}
+/**
+ * 航迹高亮选项
+ */
+interface TrackHighlightOptions {
+    enabled: boolean;
+    color?: Cesium.Color;
+    width?: number;
+}
+/**
+ * 飞行仿真选项
+ */
+interface FlightSimulatorOptions {
+    /** Sinofly 航线数据 */
+    waylineData: SinoflyWaylineData;
+    /** 飞行速度 (m/s)，默认 10 */
+    speed?: number;
+    /** 是否循环播放，默认 false */
+    loop?: boolean;
+    /** 是否显示视锥体，默认 true（AirplaneCursor 已内置视锥体） */
+    showFrustum?: boolean;
+    /** 航迹高亮选项 */
+    trackHighlight?: TrackHighlightOptions;
+    /** 自定义图层 */
+    layer?: Cesium.CustomDataSource;
+}
+/**
+ * 飞行仿真器
+ *
+ * 沿航线路径移动飞机模型，支持播放控制、速度调节和循环播放
+ */
+declare class FlightSimulator implements FlightSimulatorController {
+    private CesiumNS;
+    private viewer;
+    private options;
+    private state;
+    private progress;
+    private waypoints;
+    private totalDistance;
+    private currentDistance;
+    private airplaneCursor?;
+    private trackEntity?;
+    private passedTrackEntity?;
+    private animationFrameId?;
+    private lastTimestamp?;
+    readonly onStateChange: Emitter<FlightSimulatorStateChangeEvent>;
+    constructor(CesiumNS: typeof Cesium, viewer: Cesium.Viewer, options: FlightSimulatorOptions);
+    /**
+     * 初始化航点数据
+     */
+    private initWaypoints;
+    /**
+     * 创建可视化实体
+     */
+    private createEntities;
+    /**
+     * 创建航迹高亮
+     */
+    private createTrackHighlight;
+    /**
+     * 获取当前位置
+     */
+    private getCurrentPosition;
+    /**
+     * 获取当前姿态（用于更新 AirplaneCursor）
+     */
+    private getCurrentPose;
+    /**
+     * 获取已飞过的位置数组
+     */
+    private getPassedPositions;
+    /**
+     * 动画循环
+     */
+    private animate;
+    /**
+     * 设置状态并发射事件
+     */
+    private setState;
+    start(): void;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+    destroy(): void;
+    setSpeed(speed: number): void;
+    getState(): FlightSimulatorState;
+    getProgress(): number;
+}
+
 type PathSample = {
     time: Cesium.JulianDate | Date | string | number;
     lon: number;
@@ -1270,6 +1376,11 @@ declare class PolygonEditor {
             height?: number;
         }>;
     }): Cesium.Entity | null;
+    /**
+     * 辅助方法：使用地形采样创建标签
+     * 先尝试获取地形高度，如果失败则使用 heightReference
+     */
+    private createLabelWithTerrainHeight;
     /**
      * 辅助方法：从实体中提取经纬度高度数组
      * @param entity 多边形实体
@@ -1723,6 +1834,128 @@ declare class Selector {
     }): SelectionSession;
 }
 
+/**
+ * 点云拾取工具
+ * 专门用于拾取 3D 点云（Cesium3DTileset）并返回坐标和属性信息
+ */
+
+/**
+ * 点云拾取结果
+ */
+interface PointCloudPickResult {
+    /** 是否成功拾取到点云 */
+    success: boolean;
+    /** 拾取点的世界坐标（Cartesian3） */
+    position?: Cesium.Cartesian3;
+    /** 拾取点的经纬度坐标 */
+    coordinates?: {
+        longitude: number;
+        latitude: number;
+        height: number;
+    };
+    /** 拾取到的 Tileset 对象 */
+    tileset?: Cesium.Cesium3DTileset;
+    /** 拾取到的 Tile 内容 */
+    content?: Cesium.Cesium3DTileContent;
+    /** 点的特征 ID（如果有） */
+    featureId?: number;
+    /** 点的属性（如强度、分类等） */
+    properties?: Record<string, any>;
+    /** 点的颜色（如果可获取） */
+    color?: {
+        red: number;
+        green: number;
+        blue: number;
+        alpha: number;
+    };
+    /** 屏幕坐标 */
+    screenPosition?: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * 点云拾取会话
+ */
+interface PointCloudPickSession {
+    /** 停止拾取会话 */
+    stop: () => void;
+    /** 暂停拾取（不移除事件，只是不触发回调） */
+    pause: () => void;
+    /** 恢复拾取 */
+    resume: () => void;
+    /** 是否处于暂停状态 */
+    isPaused: () => boolean;
+}
+/**
+ * 点云拾取选项
+ */
+interface PointCloudPickerOptions {
+    /** 鼠标光标样式，默认 'crosshair' */
+    cursor?: string;
+    /** 是否在拾取时显示标记点，默认 true */
+    showMarker?: boolean;
+    /** 标记点颜色，默认黄色 */
+    markerColor?: Cesium.Color;
+    /** 标记点大小（像素），默认 10 */
+    markerSize?: number;
+    /** 是否只拾取点云（忽略其他实体），默认 true */
+    pointCloudOnly?: boolean;
+    /** 是否尝试获取点的属性，默认 true */
+    fetchProperties?: boolean;
+}
+/**
+ * 点云拾取工具类
+ */
+declare class PointCloudPicker {
+    private CesiumNS;
+    private viewer;
+    private handler?;
+    private markerEntity?;
+    private isPaused;
+    constructor(CesiumNS: typeof Cesium, viewer: Cesium.Viewer);
+    /**
+     * 在指定屏幕位置进行一次点云拾取
+     * @param windowPosition 屏幕坐标 { x, y }
+     * @param options 拾取选项
+     * @returns 拾取结果
+     */
+    pickAt(windowPosition: {
+        x: number;
+        y: number;
+    }, options?: {
+        fetchProperties?: boolean;
+        pointCloudOnly?: boolean;
+    }): PointCloudPickResult;
+    /**
+     * 开启点云拾取会话
+     * @param onPick 拾取回调函数
+     * @param options 拾取选项
+     * @returns 拾取会话对象
+     */
+    startPicking(onPick: (result: PointCloudPickResult) => void, options?: PointCloudPickerOptions): PointCloudPickSession;
+    /**
+     * 停止拾取会话
+     */
+    private stopPicking;
+    /**
+     * 显示标记点
+     */
+    private showMarker;
+    /**
+     * 移除标记点
+     */
+    removeMarker(): void;
+    /**
+     * 获取当前标记点位置
+     */
+    getMarkerPosition(): Cesium.Cartesian3 | undefined;
+    /**
+     * 销毁拾取器
+     */
+    destroy(): void;
+}
+
 interface FOVControllerOptions {
     /** 初始 FOV 值（度） */
     initialFOV?: number;
@@ -1947,6 +2180,13 @@ declare class FrustumPyramid {
     clear(): void;
 }
 
+/**
+ * 高度计算模式类型
+ * - absolute: 海平面高度（绝对高度）
+ * - relativeToGround: 相对地形高度
+ * - relativeToStart: 相对起飞点高度
+ */
+type AltitudeMode = 'absolute' | 'relativeToGround' | 'relativeToStart';
 /**
  * 🆕 快速编辑模式配置选项
  */
@@ -1959,6 +2199,56 @@ interface QuickEditOptions {
     altitudeMode?: 'absolute' | 'relativeToStart' | 'relativeToGround';
 }
 
+/**
+ * 地形高度查询工具
+ * 提供异步批量查询和同步回退两种方式
+ */
+/**
+ * 异步批量查询地形高度
+ * 使用 sampleTerrainMostDetailed 进行精确的地形高度查询
+ * @param CesiumNS Cesium 命名空间
+ * @param viewer Cesium Viewer 实例
+ * @param positions 需要查询的位置数组（Cartesian3）
+ * @returns 每个位置对应的地形高度数组
+ */
+declare function queryTerrainHeights(CesiumNS: typeof Cesium, viewer: Cesium.Viewer, positions: Cesium.Cartesian3[]): Promise<number[]>;
+/**
+ * 同步查询单个位置的地形高度
+ * 使用 globe.getHeight 作为回退方案
+ * @param CesiumNS Cesium 命名空间
+ * @param viewer Cesium Viewer 实例
+ * @param position 需要查询的位置（Cartesian3）
+ * @returns 地形高度（无法获取时返回 0）
+ */
+declare function queryTerrainHeightSync(CesiumNS: typeof Cesium, viewer: Cesium.Viewer, position: Cesium.Cartesian3): number;
+/**
+ * 查询单个位置的地形高度（异步）
+ * @param CesiumNS Cesium 命名空间
+ * @param viewer Cesium Viewer 实例
+ * @param position 需要查询的位置（Cartesian3）
+ * @returns 地形高度
+ */
+declare function queryTerrainHeightAsync(CesiumNS: typeof Cesium, viewer: Cesium.Viewer, position: Cesium.Cartesian3): Promise<number>;
+/**
+ * 根据高度模式计算航点的绝对高度
+ * @param CesiumNS Cesium 命名空间
+ * @param altitudeMode 高度模式
+ * @param defaultAltitude 默认高度（相对高度值）
+ * @param startPointAltitude 起飞点高度（用于 relativeToStart 模式）
+ * @param terrainHeight 地形高度（用于 relativeToGround 模式）
+ * @returns 计算后的绝对高度
+ */
+declare function calculateAbsoluteHeight(altitudeMode: 'absolute' | 'relativeToGround' | 'relativeToStart', defaultAltitude: number, startPointAltitude: number, terrainHeight: number): number;
+/**
+ * 根据高度模式计算航点的相对高度
+ * @param altitudeMode 高度模式
+ * @param absoluteHeight 绝对高度
+ * @param startPointAltitude 起飞点高度
+ * @param terrainHeight 地形高度
+ * @returns 相对高度
+ */
+declare function calculateRelativeHeight(altitudeMode: 'absolute' | 'relativeToGround' | 'relativeToStart', absoluteHeight: number, startPointAltitude: number, terrainHeight: number): number;
+
 /**
  * Path 编辑保存结果数据接口
  * 对应 pathEditing.ts 中 saveAndStop() 返回的数据结构
@@ -1966,9 +2256,6 @@ interface QuickEditOptions {
 interface PathEditingSaveResult {
     entity: Cesium.Entity;
     positions: Cesium.Cartesian3[];
-    startPoint: {
-        position: Cesium.Cartesian3;
-    };
     climbHeight?: number;
     waypointData: Array<{
         position: Cesium.Cartesian3;
@@ -1978,9 +2265,16 @@ interface PathEditingSaveResult {
         fov: number;
         index: number;
         distance: number;
+        /** 椭球高度（WGS84 椭球面以上的高度） */
+        ellipsoidHeight?: number;
+        /** 相对高度（根据 altitudeMode 计算） */
+        relativeHeight?: number;
+        /** 🆕 是否使用全局默认高度（true: 高度=defaultAltitude, false: 高度=实际计算值） */
+        useGlobalHeight?: boolean;
     }>;
     altitudeMode?: string;
-    hasHiddenClimb?: boolean;
+    /** 航线默认高度（米） */
+    defaultAltitude?: number;
 }
 /**
  * Path 到 Sinofly 转换选项
@@ -2180,4 +2474,4 @@ 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 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 };
+export { type AltitudeMode, 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, FlightSimulator, type FlightSimulatorController, type FlightSimulatorOptions, type FlightSimulatorState, type FlightSimulatorStateChangeEvent, 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 PointCloudPickResult, type PointCloudPickSession, PointCloudPicker, type PointCloudPickerOptions, 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, calculateAbsoluteHeight, calculateRelativeHeight, configureCesiumAssets, configureCesiumIonToken, convertPathToSinofly, convertSinoflyWayline, convertSinoflyWaylines, ensureCesiumIonToken, getCesiumBaseUrl, getCesiumIonToken, globalCameraEventBus, globalState, placeholder, queryTerrainHeightAsync, queryTerrainHeightSync, queryTerrainHeights, renderFlightPath, renderFlightPathPreview, toggle2D3D, version, versionInfo };