sic 图像命令行工具

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

sic (sic 图像命令行工具) 是 image crate 的前端。除了 image crate 提供的图像操作外，还包括一些额外的有用操作，如 diff。可以通过编译时使用 imageproc-ops 功能来启用 imageproc crate 提供的操作。我们打算在未来的版本中提供更广泛的 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就不会将通配符模式扩展为文件列表。2) 当使用通配符模式时，我们的输出（--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--draw-text"<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--应用-操作"flip-horizontal"
or
sic-iin.png-o out.png--翻转-水平

垂直翻转 示例
sic-iin.png-o out.png--应用-操作"flip-vertical"
or
sic-iin.png-o out.png--翻转-垂直

灰度 示例
sic-iin.png-o out.png--应用-操作"grayscale"
or
sic-iin.png-o out.png--grayscale

水平渐变 示例
sic-iin.png-o out.png--应用-操作"horizontal-gradient rgba(255, 0, 0, 255) rgba(0, 0, 255, 255)"
or
sic-iin.png-o out.png--水平-渐变"rgba(255, 0, 0, 255)" "rgba(0, 0, 255, 255)"

色调旋转 示例
sic-iin.png-o out.png--应用-操作"hue-rotate -90"
or
sic-iin.png-o out.png--色调-旋转-90

反转 示例
sic-iin.png-o out.png--应用-操作"反转"
or
sic-iin.png-o out.png--反转

覆盖 示例
sic-iin.png-o out.png--应用-操作"overlay 'image.png' 10 10"
or
sic-iin.png-o out.png--叠加"image.png" 10 10

调整大小 示例
sic-iin.png-o out.png--应用-操作"resize 100 100"
or
sic-iin.png-o out.png--调整大小100 100

调整大小 并保持 宽高比 示例
sic-iin.png-o out.png--应用-操作"set preserve-aspect-ratio true; resize 100 100"
or
sic-iin.png-o out.png--preserve-纵横比-比率true --调整大小100 100

调整大小 并使用 自定义采样滤波器（默认为 'lanczos3'）示例
sic-iin.png-o out.png--应用-操作"设置采样滤波器三角形；调整大小为100x100"
or
sic-iin.png-o out.png--采样-滤波器三角形--调整大小100 100

旋转90度示例
sic-iin.png-o out.png--应用-操作"旋转90度"
or
sic-iin.png-o out.png--旋转90度

旋转180度示例
sic-iin.png-o out.png--应用-操作"旋转180度"
or
sic-iin.png-o out.png--旋转180度

旋转270度示例
sic-iin.png-o out.png--应用-操作"旋转270度"
or
sic-iin.png-o out.png--旋转270度

阈值示例
sic-iin.png-o out.png--应用-操作"阈值"
or
sic-iin.png-o out.png--阈值

非锐化示例
sic-iin.png-o out.png--应用-操作"非锐化 -0.7 1"
or
sic-iin.png-o out.png--非锐化-0.7 1

垂直梯度示例
sic-iin.png-o out.png--应用-操作"垂直渐变 rgba(255, 0, 0, 255) rgba(0, 0, 255, 255)"
or
sic-iin.png-o out.png--垂直-渐变"rgba(255, 0, 0, 255)" "rgba(0, 0, 255, 255)"

包含多个从左到右应用图像操作的示例
sic-iin.png-o out.png--应用-操作"旋转180度；水平翻转；设置采样滤波器最近邻；调整大小为75x80；色调旋转75度"
or
sic-iin.png-o out.png--旋转180度--翻转-水平--采样-滤波器最近邻--调整大小75 80 --色调-旋转75

有关图像操作的其它资源

要获取有关可用选项和标志的更多信息，请运行sic --help。

许可

根据您的选择，许可协议为以下之一

• Apache License, Version 2.0, (LICENSE-APACHE 或 http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT 或 http://opensource.org/licenses/MIT)

。

贡献

除非您明确声明，否则任何根据Apache-2.0许可定义的、有意提交以包含在作品中的贡献，都将如上双许可，不附加任何额外条款或条件。

建议、问题、错误

如果您有建议、问题或发现了错误，请随时提交一个问题 📬。

🎸 🎺 🎻 🎷