### Metashape Python API 2.1.1 版本详解
#### 一、概述
在Metashape软件中，Python脚本编程是一项强大的功能，它允许用户通过编写Python脚本来自动化处理工作流程中的各种任务。Metashape的Python API为用户提供了与项目数据进行交互的接口，并可以执行多种复杂的操作。
##### 1.1 Python 脚本编程在 Metashape Professional 中的介绍
Metashape Professional 使用 Python 3.8 作为其脚本引擎。该API正在不断发展和完善中，并将在未来的Metashape版本中得到进一步扩展。值得注意的是，Python脚本支持仅限于Metashape Professional版，而非免费或标准版。
Python命令和脚本可以在Metashape中通过以下几种方式执行：
1. **控制台面板**：直接在Metashape的“控制台”面板中执行，就像在标准Python控制台一样。
2. **工具菜单**：从“工具”菜单中选择“运行脚本...”命令来执行。
3. **命令行**：使用“-r”参数并通过命令行传递脚本路径作为参数来执行。
通过Python脚本，用户可以访问以下Metashape功能：
- 打开、保存或创建Metashape项目。
- 添加或移除数据块(chunk)、相机、标记(marker)。
- 添加或修改相机校准、地面控制数据、地理投影和坐标系。
- 执行处理步骤（如照片对齐、构建密集云、构建网格、贴图、模型简化等）。
- 导出处理结果（模型、贴图、正射影像、DEM等）。
- 访问生成模型的数据、点云、图像等。
- 启动和控制网络处理任务。
#### 二、应用模块
Metashape模块提供了核心处理功能的访问权限，包括对项目数据的检查和操作支持。该模块的主要组件是`Document`类，它代表一个Metashape项目。如果需要，可以同时创建多个`Document`实例。此外，可以通过`Metashape.app.document`属性访问当前打开的项目。
下面是一个示例代码，演示了如何在现有项目上执行主要处理步骤并保存结果：
```python
import Metashape
# 获取当前项目
doc = Metashape.app.document
# 打开项目
project_path = "path/to/project.psx"
doc.open(project_path)
# 添加图片
photo_paths = ["path/to/image1.jpg", "path/to/image2.jpg"]
chunk = doc.addChunk()
for photo_path in photo_paths:
chunk.addPhotos([photo_path])
# 执行对齐照片
chunk.matchPhotos(accuracy=Metashape.HighAccuracy, preselection=True)
chunk.alignCameras()
# 构建密集云
chunk.buildDenseCloud()
# 保存项目
doc.save()
```
### 三、Python API 变更日志
#### 2.1.1版本更新说明
在2.1.1版本中，Metashape的Python API进行了多项改进和优化，包括但不限于：
- **性能提升**：针对密集云构建和网格构建等功能进行了优化，显著提高了处理速度。
- **新功能**：
- 新增了`buildOrthomosaic()`方法，用于构建正射影像。
- 支持更多格式的图像和模型导入导出。
- **错误修复**：
- 修复了在某些情况下无法正确加载特定格式图像的问题。
- 解决了网络处理任务中的一些稳定性问题。
### 四、Python 模块索引
除了上述内容外，Metashape还提供了详细的Python模块索引，涵盖了所有可用的类、函数和方法。这包括但不限于`Document`类、`Chunk`类、`Photo`类等，以及各种处理方法，如`buildDenseCloud()`、`buildModel()`等。这些文档对于深入理解和利用Metashape的Python API至关重要。
Metashape的Python API 2.1.1版本提供了一个强大而灵活的工具集，可以帮助用户实现复杂的数据处理任务，并且不断通过新的版本更新增加更多实用的功能和改进。无论是自动化工作流还是定制化开发，Metashape的Python API都是值得深入学习和探索的强大工具。
