SuperAPI AI 工具集

convert-image-to-jpg

通用与其它

查看项目

更新于 10-16 02:30

技能介绍

用途:把本地单张图片或目录树中的常见栅格图片统一转换为 .jpg,并按需写入目标 DPI 元数据(默认 96)。目录输入时递归处理,并在输出树中保留相对子目录结构。

主要能力:支持批量与单文件转换;可转换 .jpg 和 .jpeg 输入以统一命名或重写 DPI;默认 JPG 质量 95;对 GIF、TIFF 等多帧格式仅取第一帧或首页;当两个源文件映射到同一目标 .jpg 时会拒绝该次含糊转换;可通过 --extra-extension 添加额外扫描后缀。

必要用法:使用 scripts/convert_to_jpg.py,仅依赖 Python 标准库,不安装额外 Python 包。优先使用已安装的 magick,缺省时回退到 macOS sips;两者都不存在时应停止并报告缺失依赖。示例:

python3 scripts/convert_to_jpg.py --input-path /path/to/image.heic --output-path /path/to/output.jpg

python3 scripts/convert_to_jpg.py --input-path /path/to/input-images --output-path /path/to/output-images --dpi 300

加 --overwrite 可替换已有输出;加 --dry-run 仅预览转换计划而不写文件。主要参数:--input-path、--output-path(无 .jpg/.jpeg 后缀时按目录处理)、--dpi、--quality(1 至 100)、--backend(auto、magick 或 sips)、--extra-extension、--overwrite、--dry-run、--limit。

适用场景:需要把一批图片(含 HEIC 等格式)转为 JPG,并统一 DPI 或命名。限制:依赖 magick 或 macOS sips 之一;不支持多帧格式的全帧导出;不提供除 JPG 外的输出格式;具体支持的后端与平台细节以实际环境为准。