drone-camera 0.0.0-stage → 0.1.0

package/lib/drone-control.d.ts

@@ -0,0 +1,188 @@
+/**
+ * 渲染器无关的「飞行控制」抽象层。
+ *
+ * 库里所有 UI 模块(控制面板 / 航线面板 / 鹰眼图)都只依赖这一层接口,不依赖具体引擎实现,
+ * 于是同一套面板既能挂在 three.js 的 DroneFly 上,也能挂在 Cesium 之类的其他渲染器上
+ * (见 demo 的 Cesium 适配器)。
+ *
+ * 为什么必须显式抽出接口:DroneFly 含 private 成员,按 TypeScript 的类兼容规则,
+ * 只要目标类型带 private/protected,就只有同一条继承链上的对象才能赋值给它 ——
+ * 外部渲染器的控制器无论长得多像,都无法"伪装"成 DroneFly。
+ * 因此把「面板真正用到的那部分能力」提成公开接口,由各渲染器各自实现。
+ *
+ * 约定:接口只描述能力,不描述实现 —— 实现方自行决定真值来自 three 场景还是地理坐标系。
+ */
+import type { CameraMode, PhotoShot } from './drone-fly';
+import type { CaptureCameraState, CaptureViewOverride } from './drone-capture';
+import type { ChecklistItem, DroneSim, DroneSnapshot, FlightMode, FlightPhase, MissionConfig, MissionExport, MissionExportFormat, MissionWaypoint, StickState } from './drone-sim';
+import type { MissionEditState } from './mission-editor';
+/**
+ * 航点的地理坐标(经纬高,WGS84 椭球),由支持地理坐标系的后端(如 Cesium)提供。
+ *
+ * 与航点列表里的本地米坐标(x 东 / z 南 / altitude AGL,相对返航点)是同一位置的两种表示:
+ * 经纬高是同一位置在地球上的绝对坐标(海拔 = 地形高度 + AGL),面板可切换显示哪种。
+ */
+export interface WaypointGeo {
+    /** 经度(度) */
+    lon: number;
+    /** 纬度(度) */
+    lat: number;
+    /** 海拔(米,绝对高程 = 地形 + AGL) */
+    height: number;
+}
+/**
+ * 控制面板 / 航线面板 / 鹰眼图所需的最小飞行控制能力集。
+ *
+ * `DroneFly`(three.js 实现)与各渲染器适配器均实现本接口;面板只读真值、只调方法,
+ * 不触碰任何引擎对象,所以换渲染器时面板一行都不用改。
+ */
+export interface DronePanelHost {
+    /** 飞行内核:面板直接读取 gimbalPitch / photoCount / recordSeconds / stick 等真值 */
+    readonly sim: DroneSim;
+    /** 当前飞行阶段(自检 / 待机 / 起飞 / 悬停 / 返航 / 降落 ...) */
+    readonly phase: FlightPhase;
+    /** 是否已离地 */
+    readonly airborne: boolean;
+    /** 当前飞行挡位 */
+    readonly flightMode: FlightMode;
+    /** 相对起飞点的高度(米,AGL) */
+    readonly altitude: number;
+    /** 起飞前检查项(面板据此禁用起飞按钮并列出阻塞项) */
+    readonly preflightChecks: ChecklistItem[];
+    /** 机臂是否处于收拢状态 */
+    readonly armsFolded: boolean;
+    /** 是否正在录像 */
+    readonly isRecording: boolean;
+    /** 当前视角模式(orbit / follow / fpv) */
+    readonly cameraMode: CameraMode;
+    /** 上电(走自检 → 预热 → 待机) */
+    powerOn(): void;
+    /** 起飞 */
+    takeOff(): boolean;
+    /** 降落 */
+    land(): boolean;
+    /** 一键返航 */
+    returnHome(reason?: string): boolean;
+    /** 写入摇杆连续量(面板摇杆与键盘都走这里) */
+    setStick(stick: Partial<StickState>): void;
+    /** 切换飞行挡位 */
+    setMode(mode: FlightMode): void;
+    /** 展开 / 收拢机臂 */
+    setArmsFolded(folded: boolean): void;
+    /** 切换视角模式 */
+    setCameraMode(mode: CameraMode): void;
+    /** 设置云台俯仰角(度) */
+    setGimbalPitch(pitch: number): void;
+    /** 视角复位 */
+    resetCamera(): void;
+    /** 直接把无人机移动到目标位置(本地坐标 / 绝对姿态) */
+    flyTo(target: {
+        x?: number;
+        y?: number;
+        z?: number;
+        heading?: number;
+        pitch?: number;
+        roll?: number;
+    }): void;
+    /** 设定镜头/云台变焦倍数(1~4x) */
+    zoomTo(zoom: number): void;
+    /** 拍一张照片(取景位由实现方决定) */
+    requestPhoto(): Promise<PhotoShot | null>;
+    /**
+     * 取景相机(云台镜头)的位姿与内参快照 —— 与采集服务同源;未就绪返回 null。
+     * 全景拍摄要用它把每张照片的取景方位写进元数据。
+     */
+    getCaptureCamera(): CaptureCameraState | null;
+    /**
+     * 设置取景**俯仰**覆盖(全景分层用):俯仰替代云台俯仰;传 `null` 复位。
+     * 只影响取景相机,不动机体与飞控。
+     *
+     * 没有水平偏航是有意的 —— 全景的水平覆盖靠 `spinBodyTo` 转机体(云台 Pan 行程不够)。
+     */
+    setCaptureView(override: CaptureViewOverride | null): void;
+    /** 让机体原地自转到绝对方位角(度,罗盘角);`null` 停止自转。全景水平网格靠它 */
+    spinBodyTo(headingDeg: number | null): void;
+    /** 机体当前方位角(度,罗盘角) */
+    getBodyHeading(): number;
+    /** 开始录像 */
+    startRecording(): boolean;
+    /** 结束录像并返回产物 */
+    stopRecording(): Promise<Blob | null>;
+}
+/**
+ * 航线规划面板(MissionPanel)所需的最小飞行控制能力集。
+ *
+ * 与 `DronePanelHost` 同一设计:`DroneFly`(three 实现)与 `CesiumDroneAdapter`
+ * (Cesium 实现)都满足本接口,面板只读真值、只调方法,换渲染器时一行都不用改。
+ *
+ * 覆盖四类能力:
+ * - 执行控制:开始 / 暂停 / 继续 / 停止(语义全部由 DroneSim 内核定义,与后端无关);
+ * - 航点与参数:整表下发、单点更新、增删、参数修改、恢复默认;
+ * - 序列化:导出数据与 JSON / CSV 文本(实现下沉在 drone-sim,两后端共用);
+ * - 场景内编辑:编辑开关、选中、显隐、框住航线 —— 面板只展示结果,
+ *   「当前是否可编辑」由实现方判定(three 版=观察者视角且任务未执行)。
+ */
+export interface MissionPanelHost {
+    /** 飞行内核:面板直接读取 mission / missionConfig / homePosition 等真值 */
+    readonly sim: DroneSim;
+    /** 是否处于观察者(自由)视角 —— 场景内编辑的前置条件 */
+    readonly isOrbitView: boolean;
+    /** 全量真值快照(位置/姿态/电池/云台/任务…,面板据此渲染) */
+    getSnapshot(): DroneSnapshot;
+    /** 启动航线任务(地面时先自动起飞,到 1.2 米后自动接上航线) */
+    startMission(): boolean;
+    /** 暂停执行中的航线(原地悬停,可再续飞) */
+    pauseMission(reason?: string): boolean;
+    /** 续飞被暂停的航线 */
+    resumeMission(): boolean;
+    /** 中止航线并留在原地悬停 */
+    stopMission(reason?: string): boolean;
+    /** 下发航点列表(执行中会被拒绝,与真机"上传后不可改"一致) */
+    setMission(waypoints: Array<Partial<MissionWaypoint>>): boolean;
+    /** 改航线参数(速度/航向模式/过点方式/完成动作/循环) */
+    setMissionConfig(patch: Partial<MissionConfig>): void;
+    /** 航线参数与航点恢复出厂默认 */
+    resetMissionToDefault(): void;
+    /** 原位更新一个航点(场景拖拽每帧调用);返回夹紧后的航点,越界时 null */
+    updateMissionWaypoint(index: number, patch: Partial<MissionWaypoint>): MissionWaypoint | null;
+    /** 场景编辑:按索引删除一个航点 */
+    deleteMissionWaypoint(index: number): boolean;
+    /** 场景编辑:以飞机当前位置新增一个航点(高度取飞机当前高度) */
+    addMissionWaypointAtDrone(): number;
+    /** 把当前航线整理成可序列化的导出数据 */
+    getMissionExport(): MissionExport;
+    /** 导出航线文本(`json` 完整存档 / `csv` 纯航点表) */
+    exportMission(format?: MissionExportFormat): string;
+    /** 场景内编辑状态(开关/是否激活/选中/悬停/拖拽中) */
+    getMissionEditState(): MissionEditState;
+    /** 场景内编辑开关(开启仍需"当前确实可编辑"才生效) */
+    setMissionEditEnabled(enabled: boolean): void;
+    /** 场景内编辑开关当前是否开着 */
+    isMissionEditEnabled(): boolean;
+    /** 当前选中的航点索引(无选中 -1) */
+    getMissionSelected(): number;
+    /** 同步选中航点(列表与场景双向联动) */
+    setMissionSelected(index: number): void;
+    /** 航点标记显隐(不影响任务执行) */
+    setMissionWaypointsVisible(visible: boolean): void;
+    isMissionWaypointsVisible(): boolean;
+    /** 航线折线显隐 */
+    setMissionPathVisible(visible: boolean): void;
+    isMissionPathVisible(): boolean;
+    /** 把视角拉到"一眼看全整条航线"的位置;成功返回 true */
+    frameMission(): boolean;
+    /**
+     * 后端是否支持地理坐标(经纬高)。Cesium 等地理渲染器返回 true,three 等本地米坐标系返回 false。
+     * 面板据此决定是否显示"经纬度 / XYZ"坐标切换开关。
+     */
+    supportsGeoCoordinates(): boolean;
+    /** 取某航点的地理坐标(经纬高);不支持或越界返回 null */
+    getWaypointGeo(index: number): WaypointGeo | null;
+    /**
+     * 用地理坐标原地改写一个航点(经纬高 → 本地米坐标的逆向换算由实现方完成)。
+     * Cesium 后端可写;three 等本地米坐标系无地理锚点,返回 false(面板仅在 geo 模式且
+     * supportsGeoCoordinates() 为 true 时才调用,故 three 不会走到这里)。
+     */
+    setWaypointGeo(index: number, geo: WaypointGeo): boolean;
+}
+//# sourceMappingURL=drone-control.d.ts.map

package/lib/drone-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drone-control.d.ts","sourceRoot":"","sources":["../../src/lib/drone-camera/drone-control.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAC9E,OAAO,KAAK,EACV,aAAa,EACb,QAAQ,EACR,aAAa,EACb,UAAU,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,UAAU,EACX,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,YAAY;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAA;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,YAAY;IACZ,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,aAAa;IACb,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,sBAAsB;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,+BAA+B;IAC/B,QAAQ,CAAC,eAAe,EAAE,aAAa,EAAE,CAAA;IACzC,iBAAiB;IACjB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,aAAa;IACb,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,mCAAmC;IACnC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAE/B,wBAAwB;IACxB,OAAO,IAAI,IAAI,CAAA;IACf,SAAS;IACT,OAAO,IAAI,OAAO,CAAA;IAClB,SAAS;IACT,IAAI,IAAI,OAAO,CAAA;IACf,WAAW;IACX,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACpC,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAA;IAC1C,aAAa;IACb,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAA;IAC/B,gBAAgB;IAChB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;IACpC,aAAa;IACb,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAA;IACrC,iBAAiB;IACjB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,WAAW;IACX,WAAW,IAAI,IAAI,CAAA;IACnB,iCAAiC;IACjC,KAAK,CAAC,MAAM,EAAE;QACZ,CAAC,CAAC,EAAE,MAAM,CAAA;QACV,CAAC,CAAC,EAAE,MAAM,CAAA;QACV,CAAC,CAAC,EAAE,MAAM,CAAA;QACV,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,GAAG,IAAI,CAAA;IACR,wBAAwB;IACxB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,uBAAuB;IACvB,YAAY,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IACzC;;;OAGG;IACH,gBAAgB,IAAI,kBAAkB,GAAG,IAAI,CAAA;IAC7C;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,GAAG,IAAI,CAAA;IAC1D,gDAAgD;IAChD,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IAC3C,qBAAqB;IACrB,cAAc,IAAI,MAAM,CAAA;IACxB,WAAW;IACX,cAAc,IAAI,OAAO,CAAA;IACzB,gBAAgB;IAChB,aAAa,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAA;CACtC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAA;IACtB,kCAAkC;IAClC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,qCAAqC;IACrC,WAAW,IAAI,aAAa,CAAA;IAE5B,sCAAsC;IACtC,YAAY,IAAI,OAAO,CAAA;IACvB,0BAA0B;IAC1B,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACtC,eAAe;IACf,aAAa,IAAI,OAAO,CAAA;IACxB,kBAAkB;IAClB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IAErC,oCAAoC;IACpC,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,GAAG,OAAO,CAAA;IAC/D,kCAAkC;IAClC,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAA;IACrD,oBAAoB;IACpB,qBAAqB,IAAI,IAAI,CAAA;IAC7B,2CAA2C;IAC3C,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,GAAG,IAAI,CAAA;IAC7F,qBAAqB;IACrB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IAC7C,oCAAoC;IACpC,yBAAyB,IAAI,MAAM,CAAA;IAEnC,wBAAwB;IACxB,gBAAgB,IAAI,aAAa,CAAA;IACjC,uCAAuC;IACvC,aAAa,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAAA;IAEnD,iCAAiC;IACjC,mBAAmB,IAAI,gBAAgB,CAAA;IACvC,gCAAgC;IAChC,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IAC7C,oBAAoB;IACpB,oBAAoB,IAAI,OAAO,CAAA;IAC/B,wBAAwB;IACxB,kBAAkB,IAAI,MAAM,CAAA;IAC5B,wBAAwB;IACxB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,sBAAsB;IACtB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IAClD,yBAAyB,IAAI,OAAO,CAAA;IACpC,aAAa;IACb,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IAC7C,oBAAoB,IAAI,OAAO,CAAA;IAC/B,mCAAmC;IACnC,YAAY,IAAI,OAAO,CAAA;IAEvB;;;OAGG;IACH,sBAAsB,IAAI,OAAO,CAAA;IACjC,mCAAmC;IACnC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAA;IACjD;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAA;CACzD"}

package/lib/drone-engine.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 引擎装配层 —— 用 `engine` 字段选择渲染后端,一处配置换整套渲染实现。
+ *
+ * 库里有两套完整的飞行控制器,都实现同一个 `DronePanelHost` 接口:
+ *
+ *   engine: 'three'  → DroneFly            three.js + WebGPURenderer 的飞行沙盒
+ *   engine: 'cesium' → CesiumDroneAdapter  地球(ENU/ECEF)坐标系下的飞行
+ *
+ * 两者的差别只在"真值怎么变成画面":飞行内核都是同一个 DroneSim,控制面板 /
+ * 航线面板 / 鹰眼图 / 键盘控制完全不区分后端。所以选后端这件事只该发生一次 ——
+ * 就在本工厂里,调用方拿到实例后只管用,不需要知道下面挂的是谁。
+ *
+ * ```ts
+ * // three(自带场景)
+ * const drone = await createDroneControl({
+ *   engine: 'three', scene, camera, renderer, controls, modelUrl: '/models/dji_mini4_pro.glb',
+ * })
+ *
+ * // Cesium(先确保 /Cesium/Cesium.js 已就绪)
+ * await loadCesiumScript('/Cesium/Cesium.js')
+ * const drone = await createDroneControl({ engine: 'cesium', viewer, lon: 116.391, lat: 39.906 })
+ *
+ * // 之后再靠判别字段访问引擎特有成员
+ * if (drone.engine === 'three') drone.setGimbalStabilization('physical')
+ * ```
+ *
+ * `engine` 缺省为 `'three'`(与历史 API 一致:`new DroneFly(...)` + `initialize()`)。
+ */
+import type * as THREE from 'three';
+import type { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
+import type { WebGPURenderer } from 'three/webgpu';
+import type { DronePanelHost } from './drone-control';
+import { DroneFly, type DroneFlyInitializeOptions } from './drone-fly';
+import { CesiumDroneAdapter, type CesiumDroneOptions } from './drone-cesium';
+/** 渲染后端标识 */
+export type DroneEngine = 'three' | 'cesium';
+/**
+ * three 后端参数:场景四件套 + `DroneFly.initialize()` 的全部选项
+ * (modelUrl / obstacles)。
+ */
+export interface ThreeDroneEngineOptions extends DroneFlyInitializeOptions {
+    /** 后端标识;缺省 'three' */
+    engine?: 'three';
+    scene: THREE.Scene<THREE.Object3DEventMap>;
+    camera: THREE.PerspectiveCamera;
+    renderer: WebGPURenderer;
+    controls?: OrbitControls<THREE.Camera> | null;
+}
+/** Cesium 后端参数:本质就是 CesiumDroneOptions,只多一个必需的 engine 判别字段 */
+export interface CesiumDroneEngineOptions extends CesiumDroneOptions {
+    engine: 'cesium';
+}
+/** `createDroneControl()` 的参数(判别联合) */
+export type DroneControlOptions = ThreeDroneEngineOptions | CesiumDroneEngineOptions;
+/**
+ * 引擎无关的控制器句柄 —— 两套实现都满足。
+ *
+ * 它是 `DronePanelHost`(面板 / 航线面板 / 鹰眼图真正依赖的那 22 项能力)
+ * 加上一个 `engine` 判别字段,于是:
+ * - 只做通用控制时,写 `(drone: DroneEngineHost) => void` 就够了,不必写联合类型;
+ * - 需要引擎特有成员时,再用 `engine` 收窄到具体类。
+ */
+export interface DroneEngineHost extends DronePanelHost {
+    readonly engine: DroneEngine;
+}
+/** 按 `engine` 装配并初始化:three 走 DroneFly.initialize,Cesium 走 CesiumDroneAdapter.start */
+export declare function createDroneControl(options: ThreeDroneEngineOptions): Promise<DroneFly>;
+export declare function createDroneControl(options: CesiumDroneEngineOptions): Promise<CesiumDroneAdapter>;
+export declare function createDroneControl(options: DroneControlOptions): Promise<DroneEngineHost>;
+//# sourceMappingURL=drone-engine.d.ts.map

package/lib/drone-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drone-engine.d.ts","sourceRoot":"","sources":["../../src/lib/drone-camera/drone-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAA;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAA;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,KAAK,yBAAyB,EAAE,MAAM,aAAa,CAAA;AACtE,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAE5E,aAAa;AACb,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE5C;;;GAGG;AACH,MAAM,WAAW,uBAAwB,SAAQ,yBAAyB;IACxE,sBAAsB;IACtB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAA;IAC1C,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAA;IAC/B,QAAQ,EAAE,cAAc,CAAA;IACxB,QAAQ,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;CAC9C;AAED,8DAA8D;AAC9D,MAAM,WAAW,wBAAyB,SAAQ,kBAAkB;IAClE,MAAM,EAAE,QAAQ,CAAA;CACjB;AAED,uCAAuC;AACvC,MAAM,MAAM,mBAAmB,GAAG,uBAAuB,GAAG,wBAAwB,CAAA;AAEpF;;;;;;;GAOG;AACH,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC7B;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;AACvF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;AAClG,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA"}

package/lib/drone-exif.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 零依赖 JPEG EXIF / GPS 解析器。
+ *
+ * 用途:真实无人机照片导入时,把「拍摄时间 / 机型 / 焦距 / 图像尺寸 / GPS 经纬高」
+ * 从文件里读出来,填进统一的 `CapturedImage.metadata`(见 drone-capture)。
+ *
+ * 为什么自己写而不引三方库:本库除 `three` 外不接受运行时依赖(见 lib/index.ts 的设计约定),
+ * 而 V1 只需要 JPEG 的 EXIF 基本项 —— 一个 APP1/TIFF 顺序读就够了,不值得为它挂一个包。
+ *
+ * 覆盖范围(够用即止,不做全谱):
+ * - 只认 JPEG(SOI 0xFFD8 → APP1 0xFFE1 "Exif\0\0" → TIFF),PNG / HEIC 一律返回 null;
+ * - IFD0:Make / Model / Orientation / DateTime / ExifIFD 指针 / GPSIFD 指针;
+ * - Exif IFD:曝光时间 / 光圈 / ISO / 原始拍摄时间 / 焦距 / 35mm 等效焦距 / 像素宽高;
+ * - GPS IFD:纬度(度分秒 + N/S)/ 经度(度分秒 + E/W)/ 海拔(含海平面下标志);
+ * - 字节序 II(小端)/ MM(大端)都支持;值内联(≤4 字节)与偏移两种存放方式都处理。
+ *
+ * 解析策略是**尽力而为、绝不抛错**:任何一段越界或类型不认识都只记进 `warnings` 并跳过,
+ * 已经读到的字段原样保留 —— 因为「元数据缺失」本身就是需要展示给用户的信息,
+ * 不该因为某个 tag 坏了就让整张照片导入失败。
+ */
+/** EXIF GPS 信息(已转成十进制度) */
+export interface ExifGps {
+    /** 十进制度,北纬为正 */
+    latitude?: number;
+    /** 十进制度,东经为正 */
+    longitude?: number;
+    /** 海拔(米);altitudeRef = 1 表示海平面以下,此处已取负 */
+    altitude?: number;
+    /** 原始海拔标志:0 = 海平面以上,1 = 海平面以下 */
+    altitudeRef?: number;
+}
+/** EXIF 解析结果(字段全部可选 —— 缺失就是缺失,不填默认值) */
+export interface ExifData {
+    make?: string;
+    model?: string;
+    lensModel?: string;
+    /** 原始拍摄时间(相机本地时间,无时区),格式 `YYYY-MM-DDTHH:MM:SS` */
+    dateTimeOriginal?: string;
+    /** 文件修改时间(EXIF DateTime) */
+    dateTime?: string;
+    /** 拍照方向(1~8,见 EXIF 规范;1 = 正常) */
+    orientation?: number;
+    focalLengthMm?: number;
+    /** 35mm 等效焦距 —— 换算内参的关键字段 */
+    focalLength35mm?: number;
+    exposureTimeSeconds?: number;
+    fNumber?: number;
+    isoSpeed?: number;
+    /** 图像宽高(EXIF 里记录的原始像素尺寸) */
+    pixelXDimension?: number;
+    pixelYDimension?: number;
+    gps?: ExifGps;
+    /** 解析过程中的异常/缺失说明(诊断用) */
+    warnings: string[];
+}
+/**
+ * 解析 JPEG 的 EXIF 段。
+ *
+ * @returns 解析结果;不是 JPEG / 没有 EXIF 段 / 结构不可识别时返回 `null`。
+ */
+export declare function parseJpegExif(bytes: Uint8Array): ExifData | null;
+/** 从 Blob / File 读前若干字节解析 EXIF(只取头部,不必读整张图) */
+export declare function readJpegExif(file: Blob, maxBytes?: number): Promise<ExifData | null>;
+//# sourceMappingURL=drone-exif.d.ts.map

package/lib/drone-exif.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drone-exif.d.ts","sourceRoot":"","sources":["../../src/lib/drone-camera/drone-exif.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,2BAA2B;AAC3B,MAAM,WAAW,OAAO;IACtB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wCAAwC;AACxC,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,6BAA6B;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4BAA4B;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,yBAAyB;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AA6RD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI,CAkChE;AAED,+CAA+C;AAC/C,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,SAAa,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAa9F"}