sic图像命令行工具

从命令行转换图像和执行图像操作。

sic (sic图像命令行工具) 是 image包 的前端。除了image包提供的图像操作外，还包括一些额外的有用操作，如diff。通过使用 imageproc-ops 功能，可以启用imageproc包提供的操作。我们打算在未来的版本中提供对imageproc操作的更广泛支持。sic支持对静态和动画图像的操作。

安装

使用cargo安装

• 运行 cargo install sic

预构建的二进制文件

• 从 发行版 中下载。

从源码构建

• 设置rust和cargo（例如使用rustup）
• 克隆此仓库：git clone https://github.com/foresterre/sic.git && cd sic
• 构建发行版：cargo build --release

sic通常针对最新的稳定Rust版本进行构建，但也可能支持旧版本。

使用包管理器

brew tap tgotwig/sic
brew install tgotwig/sic/sic

brew tap tgotwig/linux-sic
brew install tgotwig/linux-sic/sic

emerge -av media-gfx/sic

使用方法

转换图像

将图像从一种格式转换为另一种格式，例如从PNG转换为JPG。

• 命令： sic --input <input> --output <output>
• 缩写： sic -<input> -<output>
• 示例： sic -.png -.jpg
  

如果您想明确设置图像输出格式，可以通过提供 --output-format <format> 参数来实现。否则，sic 将尝试从输出文件扩展名推断格式。

--help 可以用来查看支持的完整图像输出格式列表。包括

• AVIF，BMP，OpenExr，Farbfeld，GIF，ICO，JPEG，PNG，PNM (PAM，PBM，PGM 和 PPM)，QOI TGA，TIFF 和 WebP。

可选地，可以使用 --jpeg-encoding-quality <value> 设置 JPEG 质量。值应在 1-100 范围内（默认为 80）。格式为 PNM（具有 PBM、PGM 和 PPM 的一种子类型）的文件默认使用二进制编码（PNM P4、P5 和 P6 分别）。要使用 ascii 编码，可以提供以下标志：--pnm-encoding-ascii。

转换或对一组图像应用操作

对于您有一个包含多个（数百个）图像的目录，您想将其转换为不同的格式，或者可能想对其应用某些图像操作的情况，sic 提供了内置的 glob 模式匹配。此模式可以通过提供 --glob-input 和 --glob-output 选项而不是 --input 和 --output 来使用。

示例

• 要将图像目录从 PNG 转换为 JPG，可以运行 sic 并提供以下参数
  
  • sic--glob-input"*.png" --glob-output output_dir--output-format jpg"
• 将所有具有 jpg、jpeg 和 png 扩展名的图像转换为 BMP
  • sic--glob-input"*.{jpg, jpeg, png}" --glob-output output_dir--output-format bmp
• 将文件夹中的所有图像浮雕化（假设它只包含受支持的图像文件，没有文件夹）
  • sic--glob-input"*" --glob-output embossed_output--filter3x3-1 -1 0 -1 1 1 0 1 1

一些值得注意的事项：1) 我们在输入参数周围使用引号（"），这样我们的 shell 就不会将 glob 模式扩展为文件列表。2) 当使用 glob 模式时，我们的输出（--glob-output）应该是一个文件夹而不是一个文件。3) 我们需要明确使用 --output-format 指定输出格式，除非我们正在处理我们想要保留的已知扩展名。

输出图像将按与所有输入文件的第一共同目录镜像的目录结构放置在输出文件夹中。如果输出目录不存在，则将创建它们。

图像操作

在 sic 中，您可以使用图像操作来操作图像。图像操作可以直接从 CLI 使用，也可以通过 sic 的 图像脚本 使用。

注意：操作按从左到右的顺序应用，通常不具有交换律。当通过CLI选项和标志应用图像操作时，这可能会特别令人惊讶。

📜 图像脚本

使用此方法，请使用 --apply-operations "<operations>" (缩写：-x) CLI参数，并给出语句告诉sic对图像应应用哪些操作，例如
sic-i 输入.jpg-o 输出.jpg--应用-操作"水平翻转; 模糊 10; 调整大小 250 250"
当提供多个图像操作时，应使用分隔符;来分隔每个操作语句。

✏️ CLI 操作

通过直接提供CLI图像操作参数，如--blur和--crop，来使用此方法。
如果我们使用CLI操作方法，之前显示的示例变为
sic-i 输入.png-o 输出.jpg--翻转-水平--模糊10 --调整大小250 250

可用图像操作

^1 _表中的语法适用于图像脚本，但也可以在通过 CLI 参数使用图像操作时作为参考_
^2 draw-text 仅在编译了 imageproc-ops 功能时可用

图像操作修饰符

对于某些操作，可以通过设置操作修饰符来调整其行为。这些修饰符可以被覆盖，并且也可以被重置（到默认行为）。

图例:

<byte>：一个 8 位无符号整数（范围在 0-255 之间的正数
<uint>：一个 32 位无符号整数（正数
<int>：一个 32 位有符号整数（正数或负数
<fp>：一个 32 位浮点数（实数
<fp9x>：9 个后续的 32 位浮点数
<path>：一个有效的路径，该路径可以从您的当前平台访问到图像（路径应被引号包围，即 " 或 ')
<string>：一个有效的 Unicode 字符串

<nv:coord>：表示坐标（左上角为(0, 0)）的命名值，语法为 coord(<uint>, <uint>)
<nv:rgba>：表示 RGBA 颜色的命名值，语法为：rgba(<byte>, <byte>, <byte>, <byte>)
<nv:size>：表示字体大小的命名值，语法为：size(<fp>)
<nv:font>：表示 (TrueType) 字体文件位置的命名值，语法为：font(<path>)

示例

模糊 示例
sic-iin.png-o out.png--应用-操作"blur 1.3;"
or
sic-iin.png-o out.png--模糊1.3

亮化 示例
sic-iin.png-o out.png--应用-操作"brighten 2;"
or
sic-iin.png-o out.png--brighten2

对比度 示例
sic-iin.png-o out.png--应用-操作"contrast 0.7;"
or
sic-iin.png-o out.png--contrast0.7

裁剪 示例
sic-iin.png-o out.png--应用-操作"crop 0 0 10 10;"
or
sic-iin.png-o out.png--crop0 0 10 10

差异 示例
sic-i a.png-o diff_between_a_and_b.png--应用-操作"diff 'b.png'"
or
sic-i a.png-o diff_between_a_and_b.png--diff b.png

a	b	output

带有动画图像

a	b	output

绘制文本 示例（需要构建功能 imageproc-ops）
sic-iin.png-o out.png--应用-操作"draw-text '<3' coord(10, 2) rgba(255, 0, 0, 255) size(14) font('./Lato-Regular.ttf')"
or
sic-iin.png-o out.png--水平-模糊"<3" "coord(10, 2)" "rgba(255, 0, 0, 255)" "size(14)" "font('Lato-Regular.ttf')"

input	output

3x3 筛选器 示例
sic-iin.png-o out.png--应用-操作"filter3x3 -1 -1 0 -1 0 1 0 1 1"
or
sic-iin.png-o out.png--filter3x3-1 -1 0 -1 0 1 0 1 1

水平翻转 示例
sic-iin.png-o out.png--应用-操作"调整图像的对比度。"
or
sic-iin.png-o out.png--翻转-水平

垂直翻转 示例
sic-iin.png-o out.png--应用-操作"语法：crop <lx> <ly> <rx> <ry>"
or
sic-iin.png-o out.png--翻转-垂直