@jorgmoritz/gis-manager 0.1.29 → 0.1.31

package/dist/index.d.cts

@@ -780,6 +780,156 @@ 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;
@@ -1638,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;
     /**
      * 获取当前选中对象。
@@ -1668,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>;
 
@@ -2050,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 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 PathToSinoflyOptions, type PhotoBillboardItem, type PhotoBillboardLayerOptions, type PhotoBillboardResult, type PolygonDrawingOptions, type PolygonEditingSession, PolygonEditor, type PreviousViewChange, 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, 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 { 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 };

package/dist/index.d.ts

@@ -780,6 +780,156 @@ 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;
@@ -1638,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;
     /**
      * 获取当前选中对象。
@@ -1668,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>;
 
@@ -2050,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 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 PathToSinoflyOptions, type PhotoBillboardItem, type PhotoBillboardLayerOptions, type PhotoBillboardResult, type PolygonDrawingOptions, type PolygonEditingSession, PolygonEditor, type PreviousViewChange, 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, 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 { 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 };