必须执行五项关键预处理：统一白平衡与曝光参数、校正镜头畸变与暗角、执行多图自动对齐、导出16位线性tiff中间格式、批量同步元数据。
如果您尝试在darktable中拼接全景照片，但发现图像存在错位、曝光不均或几何畸变，则可能是由于缺乏统一的预处理步骤。以下是完成全景照片拼接前必须执行的关键预处理操作：
一、统一白平衡与基础曝光参数
多张全景素材若在不同自动白平衡或测光模式下拍摄，会导致色温与亮度不一致，严重影响后续对齐与融合效果。必须强制统一所有图像的基础色彩与明暗响应。
1、在Lighttable视图中按住Ctrl键选中全部待拼接图像。
2、右键选择“编辑所选图像”，进入暗房（darkroom）模式。
3、对其中一张代表性图像进行白平衡校正：使用吸管工具点击中性灰区域，或手动输入色温/色调值。
4、在历史记录栈右侧点击“复制”按钮，勾选“白平衡”与“曝光”模块。
5、切换至其余图像，依次点击“粘贴”，确保所有图像应用完全相同的白平衡与曝光参数。
6、关键提示：禁用自动白平衡（AWB）和矩阵测光模式，全程使用手动白平衡与手动曝光（M档）拍摄原始素材。
二、校正镜头畸变与暗角
广角镜头固有的桶形畸变和边缘照度衰减会破坏图像间的几何对应关系，导致特征点匹配失败或对齐偏移。需在拼接前完成逐帧光学矫正。
1、确保已导入对应镜头的官方Lensfun数据库（路径通常为/usr/share/lensfun/或~/.local/share/lensfun/）。
2、在暗房模块列表中启用“lens correction”模块。
3、勾选“启用畸变校正”与“启用暗角校正”。
4、确认“相机型号”与“镜头型号”下拉菜单中已正确识别设备信息。
5、若自动识别失败，手动选择最接近的镜头配置，并微调“畸变强度”滑块直至网格线呈直线。
6、重要限制：校正后务必禁用“裁剪以适配”选项，保留完整边缘像素供后续对齐算法使用。
三、执行多图自动对齐预处理
darktable内置的Automatic Alignment功能可补偿手持拍摄产生的平移、旋转与缩放偏差，为外部拼接软件（如Hugin）提供几何一致性更强的输入源。
1、保持全部图像处于暗房编辑状态，确保已同步完成白平衡与镜头校正。
2、启用“overlay”模块（位于“effect”分类下）。
3、将“alignment”参数设置为4（中心对齐），该模式适用于多数全景序列的初始配准。
4、调整“opacity”至50%，便于观察叠加后的错位区域。
5、逐一检查每张图像与首张基准图的重叠区域，若存在明显偏移，手动调节“xoffset”与“yoffset”直至十字准心对齐。
6、启用“rotate”滑块，微调角度（建议步进≤0.2°），消除旋转残差。
7、注意：此对齐仅作预处理参考，最终拼接仍需导出TIFF并交由Hugin或PTGui执行高精度缝合。
四、导出标准化中间格式
拼接引擎对输入图像的位深、色彩空间与元数据完整性有严格要求。直接导出JPEG将导致信息损失，必须生成无损、线性、嵌入配置文件的中间文件。
1、在暗房界面顶部菜单栏选择“文件 > 导出…”。
2、设置“文件格式”为TIFF（非JPEG或PNG）。
3、“位深”选择“16位整数”。
4、“色彩空间”设为“RGB (linear)”而非sRGB或Adobe RGB。
5、勾选“嵌入色彩配置文件”并指定LCMS2管理的输出配置文件（如Rec.709或ACEScg）。
6、取消勾选“压缩”与“写入XMP元数据”（避免Hugin解析异常）。
7、强制要求：所有导出文件命名须为连续数字序号（如pano_001.tiff、pano_002.tiff），不可含空格或中文。
五、批量同步元数据与拍摄信息
部分拼接软件依赖EXIF中的焦距、光圈、GPS坐标等字段进行投影模型推算。若原始RAW未携带完整元数据，需人工补全以提升缝合鲁棒性。
1、返回Lighttable视图，全选待拼接图像。
2、右键选择“元数据 > 编辑元数据”。
3、在弹出窗口中填写统一的“焦距”（单位mm）、“光圈值”（f-number）、“ISO感光度”。
4、若使用三脚架拍摄，将“GPS纬度”与“GPS经度”设为相同数值，避免地理抖动干扰。
5、点击“确定”后，darktable将向所有图像的XMP侧车文件写入一致的EXIF字段。
6、验证操作：导出单张TIFF后，用exiftool命令检查FocalLength与FNumber字段是否准确写入。
