我明白你现在卡在自定义深度图导入Metashape后没法正常用的问题上，确实官方脚本的细节有时候没说透，我来帮你梳理下可能的问题点和解决办法：

问题1：深度图显示异常&部分图片对齐失败 #

这些问题基本都是因为导入的深度图不符合Metashape的严格要求，你可以从这几个方向排查：

• 单位&坐标系必须精准匹配：官方脚本明确要求深度图是相机坐标系下的绝对Z值（也就是相机镜头朝向的Z轴，单位要和你Metashape项目的单位一致，比如米）。你用Python预处理的时候，有没有把第三方工具生成的深度值转换成这个标准？如果是相对值、单位不统一，或者坐标系搞反了，Metashape根本没法正确计算相机姿态，对齐自然失败，显示也会乱。
• 文件名&分辨率完全一致：彩色图（JPEG）和深度图（TIFF）必须是完全一样的文件名（只是后缀不同，比如IMG_001.jpg对应IMG_001.tif），而且宽高像素数必须丝毫不差——哪怕差1个像素，Metashape都会认为两者不匹配，导致深度图映射错误，对齐时姿态飘了。你可以用Python的PIL或者OpenCV快速检查下两组图的分辨率：

  from PIL import Image
  color_img = Image.open("你的彩色图路径")
  depth_img = Image.open("你的深度图路径")
  print(color_img.size, depth_img.size)  # 必须输出完全一样的数值
  

• 深度值的映射方向别搞反：Metashape原生生成的深度图，是离相机越近的地方Z值越小，你自己预处理的时候有没有把Z值的逻辑搞反？比如把远的地方存成0，近的地方存成最大值，那Metashape读出来的深度是完全反的，显示会异常，对齐肯定失败。

问题2：无法复用导入的深度图生成点云 #

这是最核心的问题，官方脚本没说透的操作细节在这里：

• 首先得让Metashape“认可”你的深度图：导入后，在照片视图里点击工具栏的「显示深度图」按钮，确认每张成功对齐的图片都能显示正常的深度图（没有全黑、全白或者异常色块）。如果某张图的深度图显示异常，那Metashape肯定不会用它。
• 生成点云时必须手动指定用现有深度图：默认的「生成点云」按钮会自动触发重新计算深度图，你得改参数：

  打开工作流程 > 生成点云，在弹出的设置对话框里，找到「深度图来源」这个选项，选择现有深度图（而不是默认的「重新计算」）。如果这个选项是灰色的，说明你的深度图不满足要求——要么是图片没对齐，要么是深度值格式不对，要么是相机姿态没优化。

• 对齐后务必优化相机姿态：导入深度图并成功对齐图片后，一定要跑一次工作流程 > 优化相机，把所有参数（焦距、畸变、相机位置）都勾选上。这一步会让Metashape把你的深度图和相机的内外参数做校准，确保深度图的坐标系和相机姿态完全匹配，之后生成点云时才会优先用你的深度图。

额外的预处理小提示 #

你用的官方脚本会把导入的图存到preprocessed文件夹，你可以检查下这里的TIFF图：

• 必须是单通道32位浮点TIFF：如果你的Python预处理把深度图存成了8位灰度（0-255），那深度值会被严重截断（比如真实深度是0-10米，存成8位的话精度会丢失到厘米级甚至更差），Metashape读出来的深度就不准了。建议用Python的OpenCV存成32位浮点TIFF：

  import cv2
  # 假设depth_data是你预处理后的浮点型深度数组（相机坐标系下的Z值）
  cv2.imwrite("你的深度图路径.tif", depth_data, [cv2.IMWRITE_TIFF_COMPRESSION, 1])
  

完整的正确操作流程 #

1. 预处理深度图：转成相机坐标系下的绝对Z值（单位和项目一致），保存为单通道32位浮点TIFF，确保和对应彩色图的分辨率、文件名完全匹配。
2. 用官方脚本导入深度图和彩色图，在照片视图里检查每张图的深度图显示正常。
3. 对齐图片，删掉对齐失败的图（回头检查这些图的深度图问题），然后跑一次「优化相机姿态」。
4. 生成点云时，在设置里选择「深度图来源：现有深度图」，点击生成——这时候Metashape就会用你导入的深度图，而不是重新生成了。

内容来源于stack exchange