Python调用MeshLab快照功能：meshlabserver/pymeshlab实现obj文件截图

环境要求 #

需安装2022.2及以上版本的PyMeshLab，低于该版本的PyMeshLab未公开快照接口，meshlabserver本身也不支持内置快照导出功能。
安装命令：
pip install pymeshlab>=2022.2

基础实现代码 #

import pymeshlab

# 初始化网格集合实例
ms = pymeshlab.MeshSet()

# 加载目标OBJ模型
ms.load_new_mesh("path/to/your/model.obj")

# 可选：调整渲染参数，包括着色模式、背景色等
# 示例：切换为带光照的平滑着色模式
ms.apply_filter("compute_normals_for_point_sets", smoothiter=3)

# 导出快照
ms.save_snapshot(
    filename="path/to/output/snapshot.png",
    resolution=[1920, 1080],
    transparent_background=False
)

固定视角导出方案 #

如果需要导出特定视角的快照，手动在代码中调整相机参数效率较低，可按以下步骤操作：

1. 打开MeshLab桌面端，导入目标OBJ模型
2. 调整到需要的视角、着色效果、显示配置
3. 将当前场景保存为MeshLab项目文件（后缀为.mlp）
4. 在代码中直接加载该项目文件，再导出快照即可，无需额外配置参数：

import pymeshlab

ms = pymeshlab.MeshSet()
ms.load_project("path/to/your/preset.mlp")
ms.save_snapshot("path/to/output.png", resolution=[3840, 2160])

常见异常排查 #

• 导出快照为全黑：基本为相机视口未包含模型导致，优先使用上述预存项目文件的方案解决，无需手动计算相机矩阵。
• 接口不存在：检查PyMeshLab版本，确认是否≥2022.2，低版本请升级后再使用。

内容的提问来源于stack exchange，提问作者ziwenjie