Metashape 2.0.1 Python API 指南

"Agisoft Metashape 2.0.1 的 Python 用户手册提供了关于使用 Python 脚本在 Metashape Professional 中进行自动化处理的详细参考。该 API 正在不断发展中，预计未来版本会有更多扩展。注意，Python 脚本功能仅适用于 Metashape Professional 版本，并且它基于 Python 3.8 作为脚本引擎。用户可以通过多种方式执行 Python 命令和脚本：在 Metashape 的 'Console' 面板中作为标准 Python 控制台使用、通过 'Tools' 菜单的 'Runscript' 命令或在命令行中使用 '-r' 参数指定脚本路径。Python 脚本可以访问 Metashape 的多种功能，包括打开/保存/创建项目、添加/删除块、相机和标记，以及处理相机标定、地面控制数据和地理坐标等。" 在 Agisoft Metashape 2.0.1 中，Python 脚本被用来增强用户对三维建模流程的自动化控制。这个软件主要用于摄影测量，即通过分析照片来重建三维模型。Python API 是其自动化核心，允许用户定制工作流程，提高效率。 1. **Python scripting in Metashape Professional**： - Python 脚本支持是 Metashape Professional 的一个特色，它提供了一个强大的工具，让用户能够利用编程能力自动化复杂的建模任务。 - API 目前处于开发阶段，意味着随着时间的推移，更多的功能将被添加到后续版本中。 2. **Python版本**： - Metashape Professional 使用的是 Python 3.8，这保证了与现代 Python 语言特性的兼容性。 3. **执行 Python 命令和脚本**： - 在 'Console' 面板内，用户可以直接输入 Python 代码，就像使用标准的 Python 控制台一样。 - 'Tools' 菜单的 'Runscript' 命令允许用户运行预先编写好的 Python 脚本文件。 - 通过命令行接口，用户可以指定 `-r` 参数，结合脚本文件路径，实现脚本的非交互式运行。 4. **可用功能**： - **项目管理**：Python 脚本可以打开、保存或创建新的 Metashape 项目。 - **数据操作**：可以添加或移除图像块（chunks）、相机模型和地标（markers）。 - **相机标定**：支持添加和修改相机的标定参数，这对于确保模型的精确度至关重要。 - **地理信息处理**：可以处理地面控制数据，分配地理坐标，使模型与真实世界的位置对应。 5. **应用模块**： - Metashape 提供的应用模块可能包括照片导入、自动匹配、稠密点云生成、纹理映射、几何优化等，所有这些都可以通过 Python API 进行控制。 6. **API Change Log**： - 'Python API Change Log' 部分详细记录了自上一版本以来 API 的更改和改进，这对于跟踪更新和解决兼容性问题很有帮助。 7. **Python Module Index**： - 这部分包含对 Metashape Python 模块的索引，方便用户查找和引用特定的功能或类。 通过这个手册，用户能够深入了解如何使用 Python 脚本与 Metashape Professional 的内部机制进行交互，从而实现从数据预处理到最终模型生成的全面自动化。无论是批量处理大量照片还是优化特定工作流程，Python API 都提供了巨大的潜力。