@jorgmoritz/gis-manager 0.1.28 → 0.1.30

package/dist/index.d.ts

@@ -635,6 +635,7 @@ declare function convertSinoflyWaylines(dataList: SinoflyWaylineData[], options:
     waylineId?: number | string;
 }>;
 
+type Entity$1 = Cesium.Entity;
 /**
  * 回显飞航路线的选项类型
  */
@@ -656,6 +657,278 @@ interface RenderFlightPathOptions {
     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...
+ *
+ * @param CesiumNS Cesium 命名空间
+ * @param viewer Cesium Viewer 实例
+ * @param options 回显选项，包含 Sinofly 数据和配置
+ * @returns 创建的 polyline 实体
+ *
+ * @example
+ * ```typescript
+ * // 基本用法
+ * const sinoflyData = {
+ *   waylineId: "12345",
+ *   waylineName: "测试航线",
+ *   takeOffSecurityHeight: 50,
+ *   takeOffRefPoint: '{"longitude": 116.4074, "latitude": 39.9042, "height": 100}',
+ *   waypointInfo: [
+ *     {
+ *       index: 0,
+ *       latitude: "39.9045",
+ *       longitude: "116.4078",
+ *       altitude: "150.0",
+ *       action: '[{"rotateYaw": {"aircraftHeading": 45}, "gimbalRotate": {"gimbalPitchRotateAngle": -10}}]'
+ *     },
+ *     // ... 更多航点
+ *   ]
+ * };
+ *
+ * const entity = renderFlightPath(Cesium, viewer, {
+ *   data: sinoflyData,
+ *   adapterOptions: {
+ *     parseActionForPose: true,
+ *     defaultHeading: 0,
+ *     defaultPitch: -10
+ *   },
+ *   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;
+/**
+ * 预览模式渲染选项（扩展基础选项）
+ */
+interface RenderFlightPathPreviewOptions extends RenderFlightPathOptions {
+    /** 航点点击回调 */
+    onWaypointClick?: (index: number, waypointData: any) => void;
+    /** 初始选中的航点索引 */
+    initialSelectedIndex?: number;
+}
+/**
+ * 预览模式控制器接口
+ */
+interface FlightPathPreviewController {
+    /** 设置选中的航点（高亮显示）*/
+    setSelectedWaypoint: (index: number | null) => void;
+    /** 获取当前选中的航点索引 */
+    getSelectedWaypoint: () => number | null;
+    /** 销毁控制器（移除事件监听等）*/
+    destroy: () => void;
+}
+/**
+ * 预览模式渲染飞航路线：支持航点点击高亮
+ *
+ * 与 renderFlightPath 不同，此函数返回一个控制器对象，支持：
+ * - 航点点击事件回调
+ * - 程序化设置选中航点（高亮显示）
+ * - 列表与地图双向联动
+ *
+ * @param CesiumNS Cesium 命名空间
+ * @param viewer Cesium Viewer 实例
+ * @param options 预览选项
+ * @returns 包含实体和控制器的对象
+ *
+ * @example
+ * ```typescript
+ * const { entity, controller } = renderFlightPathPreview(Cesium, viewer, {
+ *   data: sinoflyData,
+ *   onWaypointClick: (index, waypoint) => {
+ *     console.log('点击了航点', index, waypoint);
+ *   },
+ *   initialSelectedIndex: 0
+ * });
+ *
+ * // 程序化设置选中航点
+ * controller.setSelectedWaypoint(2);
+ *
+ * // 销毁
+ * controller.destroy();
+ * ```
+ */
+declare function renderFlightPathPreview(CesiumNS: typeof Cesium, viewer: Cesium.Viewer, options: RenderFlightPathPreviewOptions): {
+    entity: Entity$1;
+    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;
@@ -741,6 +1014,21 @@ declare class CZMLManager {
      * ```
      */
     renderFlightPath(options: RenderFlightPathOptions): Entity;
+    /**
+     * 预览模式渲染飞航路线：支持航点点击高亮
+     *
+     * 与 renderFlightPath 不同，此方法返回一个控制器对象，支持：
+     * - 航点点击事件回调
+     * - 程序化设置选中航点（高亮显示）
+     * - 列表与地图双向联动
+     *
+     * @param options 预览选项
+     * @returns 包含实体和控制器的对象
+     */
+    renderFlightPathPreview(options: RenderFlightPathPreviewOptions): {
+        entity: Entity;
+        controller: FlightPathPreviewController;
+    };
     addPathSample(entityOrId: Entity | string, sample: PathSample): void;
     addPathSamples(entityOrId: Entity | string, samples: PathSample[]): void;
     setPathSamples(entityOrId: Entity | string, samples: PathSample[]): void;
@@ -1500,20 +1788,26 @@ 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;
     /**
      * 获取当前选中对象。
@@ -1530,6 +1824,22 @@ 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>;
 
@@ -1912,4 +2222,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 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 QuickEditOptions, SceneManager, type SceneOptions, 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, 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 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 };