darktable命令行工具darktable-cli使用指南

darktable命令行工具darktable-cli使用指南

darktable darktable is an open source photography workflow application and raw developer 项目地址: https://gitcode.com/gh_mirrors/da/darktable

概述

darktable是一款专业的开源摄影工作流程应用程序，支持Linux、Mac OS X等多种Unix-like系统。作为其图形界面版本的补充，darktable-cli提供了命令行接口，允许用户通过终端命令批量处理图片导出任务，特别适合自动化工作流和服务器环境使用。

基本用法

darktable-cli的基本命令格式如下：

darktable-cli 输入文件 [XMP文件] 输出文件 [选项] [--core <darktable选项>]

其中：

• 输入文件：需要处理的原始图像文件（如RAW格式）
• XMP文件（可选）：包含图像处理历史的XMP侧车文件
• 输出文件：导出后的目标文件，格式由文件扩展名决定

核心参数详解

图像尺寸控制

1. --width：限制导出图像的最大宽度（像素）
2. --height：限制导出图像的最大高度（像素）
3. --upscale：是否允许放大图像（默认false）

图像质量设置

1. --hq：是否使用高质量重采样（默认true）
2. --bpp：设置导出图像的位深度（注意：当前版本需通过特殊方式设置）

特殊功能

1. --export_masks：是否将遮罩导出为图层（需格式支持）
2. --style：应用指定样式处理图像
3. --style-overwrite：用样式覆盖现有处理历史（而非追加）

调试与信息

1. --verbose：启用详细输出模式
2. --help：显示帮助信息
3. --version：显示版本信息

高级技巧

1. 位深度设置：由于--bpp参数当前版本不完全支持，可通过以下方式设置：

   --core --conf plugins/imageio/format/png/bpp=16
   

2. 多实例运行：使用--apply-custom-presets false可避免多个实例间的配置冲突

3. 文件名变量：输出文件名支持darktable导出模块的所有变量

典型应用场景

1. 批量导出：结合shell脚本实现大批量图片的自动化处理
2. 服务器处理：在无图形界面的服务器环境中处理图片
3. 样式应用：快速将特定样式应用于多张图片
4. 尺寸标准化：确保导出的图片符合特定尺寸要求

注意事项

1. 当使用--style参数时，必须同时指定darktable配置目录
2. 输出格式由文件扩展名自动确定，请确保使用支持的格式
3. 在不指定XMP文件时，程序会自动搜索与输入文件关联的XMP文件

darktable-cli作为darktable的命令行伴侣，为专业摄影师和开发者提供了更灵活的图像处理方式，特别适合需要自动化或批量处理的工作场景。通过合理组合各种参数，可以实现复杂而精确的图像导出需求。

darktable darktable is an open source photography workflow application and raw developer 项目地址: https://gitcode.com/gh_mirrors/da/darktable