darktable中精准裁剪与旋转校正需五步：一、启用裁剪与旋转模块；二、手动微调角度校正水平线；三、按比例约束裁剪并启用九宫格辅助；四、用ashift模块处理透视变形；五、批量应用参数至多张照片。

如果您在darktable中打开一张照片，发现构图松散、地平线倾斜或主体位置不佳，则很可能是图像缺少精准的裁剪与旋转校正。以下是解决此问题的步骤：

一、启用并激活裁剪与旋转模块

该模块是暗房视图（Darkroom）中实现二次构图与方向校正的基础工具，集成于右侧面板“基本调整”分类下，支持非破坏性实时预览。其底层由src/views/darkroom.c中的cropping.exposer结构体驱动，并与旋转像素模块（rotatepixels.c）协同工作，确保裁剪框随旋转参数动态更新。

1、确保当前处于暗房视图（Darkroom），而非图库（Lighttable）或导出（Export）界面。

2、在右侧面板中展开「基本调整」区域，找到并点击「裁剪与旋转」模块标题以展开参数面板。

3、点击工具栏中剪刀形状图标（或直接按快捷键C）激活裁剪工具，此时图像四周将出现可拖动的边界手柄。

二、手动旋转校正水平线

该方法适用于存在明显参考线（如海平面、建筑基线、道路边缘）的照片，通过角度微调恢复视觉平衡，避免依赖自动检测可能产生的偏差。旋转参数以度为单位存储于dt_iop_rotatepixels_params_t.angle结构体中，支持-180°至+180°范围输入。

1、在「裁剪与旋转」模块中，找到「角度」滑块，将其拖动至初步对齐水平参考线的位置。

2、若需更高精度，点击滑块右侧的数值输入框，手动输入小数角度（例如-1.7或0.3）。

3、勾选「自动应用旋转」选项，使后续裁剪操作自动适配已设定的旋转角度，防止黑边残留。

三、按比例约束进行专业裁剪

锁定比例可防止构图失衡，尤其适用于印刷输出或平台发布等有固定尺寸要求的场景。darktable内置12种常用比例（含1:1、4:3、3:2、16:9），亦支持自定义宽高比输入，所有比例逻辑均通过modify_roi_out函数在输出区域计算中强制执行。

1、激活裁剪工具后，在顶部工具栏的比例下拉框中选择目标比例（例如风景照选16:9，人像照选4:3）。

2、按住Shift键拖动任意角落手柄，强制保持所选比例不变。

3、将裁剪框整体平移，使主体对齐九宫格交叉点（右键点击图像可启用该辅助线）。

四、使用ashift模块实现高精度几何校正

当普通旋转无法解决透视变形（如建筑物后倾、镜头畸变导致的线条弯曲）时，ashift模块提供基于单应性矩阵的透视变换能力，其核心参数包括旋转、垂直/水平镜头位移及剪切，全部通过OpenCL内核加速运算。

1、在右侧面板中找到并启用「旋转和透视」（ashift）模块。

2、点击「自动结构检测」按钮，软件将识别图像中潜在的水平与垂直结构线。

3、若自动结果不理想，切换至「手动绘制线条」模式，沿真实水平线（如地平线）绘制至少两条参考线。

4、调整「rotation」滑块完成主方向校正，再微调「lensshift_v」与「lensshift_h」消除透视倾斜。

五、批量应用裁剪与旋转设置

针对多张同场景拍摄的照片（如旅行连拍、产品静物组），可一次性同步应用已调校的裁剪与旋转参数，避免重复操作。该功能依托darktable的样式（style）系统与非破坏性元数据存储机制，所有参数均写入XMP侧车文件，不修改原始RAW。

1、在图库（Lighttable）视图中，按住Ctrl（Windows/Linux）或Cmd（macOS）键，多选需统一处理的照片。

2、右键点击任一选中缩略图，选择「应用样式」→「新建样式」。

3、在弹出窗口中勾选「裁剪与旋转」及「旋转和透视」模块，点击「创建」。

4、确认后，所有选中照片将立即应用相同构图与方向参数，并保留在各自历史堆栈中供单独调整。