API 概览
本章节提供 MipMapEngine SDK 的完整 API 参考文档,包括所有可用接口、参数说明和使用示例。
开始之前
如果您还未安装 SDK,请先查看安装指南Windows或安装指南Linux。
MipMapEngine SDK 提供了多种接口来满足不同的使用场景:
📚 接口分类
| 接口 | 功能 | Type | 适用场景 |
|---|---|---|---|
| ReconstructFull【推荐】 | 全流程重建 | 0 | 快速启动,自动处理,参数配置简单,详见ReconstructFull接口详解 |
| ReconstructAT | 空中三角测量 | 1 | 精细控制,专业用户,详见ReconstructAT详解 |
| Reconstruct3D | 三维重建 | 2 | 从空三结果生成模型,详见Reconstruct3D详解 |
| OptimizeAT | 控制点优化 | 3 | 使用控制点提高精度,详见OptimizeAT详解 |
| DivideTiles | 分块处理 | 4 | 大规模数据分块重建,详见DivideTiles详解 |
📚 >>> 深入了解 ReconstructFull 接口
📝 接口调用方式
1. 命令行调用
SDK 支持直接通过命令行调用各个引擎,通过控制 Type 来控制接口使用:
# 通用格式
reconstruct_full_engine --reconstruct_type <type_number> --task_json <config_task_file.json>
# 示例:调用 ReconstructFull(Type=0)
reconstruct_full_engine --reconstruct_type 0 --task_json config_task.json
🎯 选择合适的接口
| 如果您... | 推荐使用 | 原因 |
|---|---|---|
| 初次使用 SDK | ReconstructFull,详见ReconstructFull接口详解 | 自动处理,简单上手,适合大部分任务 |
| 需要使用控制点优化重建 | ReconstructAT/OptimizeAT/Reconstruct3D | 支持控制点优化 |
| 规则分块处理超大数据 | ReconstructAT/DivideTiles/Reconstruct3D | 支持自定义分块处理 |
📖 JSON 配置文件
所有接口都使用 JSON 格式的配置文件,基本结构:
{
"working_dir": "string", // 必需:工作目录
"gdal_folder": "string", // 必需:GDAL 数据目录
// ... 其他参数根据接口而定
}
更详细的介绍参考API手册。
错误处理
所有接口返回整数错误码:
0: 成功非0: 各种错误情况
详见错误码参考错误码。
🚀 下一步
- 📚 深入了解 ReconstructFull 接口API手册
提示:大多数用户使用 ReconstructFull 就能满足需求。只有在需要精细控制时才使用其他接口。