@jorgmoritz/gis-manager 0.1.27 → 0.1.29

package/dist/index.d.cts

@@ -635,6 +635,7 @@ declare function convertSinoflyWaylines(dataList: SinoflyWaylineData[], options:
     waylineId?: number | string;
 }>;
 
+type Entity$1 = Cesium.Entity;
 /**
  * 回显飞航路线的选项类型
  */
@@ -656,6 +657,128 @@ 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 PathSample = {
     time: Cesium.JulianDate | Date | string | number;
@@ -741,6 +864,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;
@@ -1912,4 +2050,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 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 };

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,128 @@ 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 PathSample = {
     time: Cesium.JulianDate | Date | string | number;
@@ -741,6 +864,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;
@@ -1912,4 +2050,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 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 };