15 个版本 (重大更新)
| 0.22.1 | 2023 年 9 月 16 日 |
|---|---|
| 0.22.0 | 2023 年 4 月 22 日 |
| 0.21.0 | 2023 年 1 月 19 日 |
| 0.20.1 | 2022 年 12 月 12 日 |
| 0.10.0 | 2019 年 9 月 28 日 |
#355 in 图像
每月 27 次下载
在 5 个crate中使用（直接使用3个）
87KB
1K SLoC
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 版本构建，但也可能与其他旧版本兼容。
使用包管理器
Homebrew
🍺 MacOS 上的 Homebrew
brew tap tgotwig/sic
brew install tgotwig/sic/sic
🍺 Linux 上的 Homebrew
brew tap tgotwig/linux-sic
brew install tgotwig/linux-sic/sic
emerge
gentoo Linux 通过 GURU Overlay
emerge -av media-gfx/sic
用法
转换图像
将图像从一个格式转换为另一个格式，例如从 PNG 转换为 JPG。
- 命令：
sic --input <input> --output <output> - 缩写：
sic -i <input> -o <output> - 示例：
sic -.png -.jpg
如果您想显式设置图像输出格式，可以通过提供 --output-format <format> 参数来实现。否则，sic 将尝试从输出文件扩展名推断格式。
--help 可以用来查看支持的图像输出格式的完整列表。包括：
AVIF，BMP，OpenExr，Farbfeld，GIF，ICO，JPEG，PNG，PNM（PAM，PBM，PGM和PPM），QOITGA，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扩展名的图像转换为 BMPsic--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 | 描述 |
|---|---|---|
| 模糊 | 模糊<fp> |
对图像执行高斯模糊 (更多信息)。小于 0.0 的参数将使用 1.0 代替。 |
| brighten | brighten<int> |
创建图像的明亮版本。 |
| contrast | contrast<fp> |
调整图像的对比度。 |
| crop | crop<uint> <uint> <uint> <uint> |
语法：crop <lx> <ly> <rx> <ry>，其中 lx 是从 0 开始的左上角 x 像素坐标，ly 是从 0 开始的左上角 y 像素坐标，rx 是右下角的 x 像素坐标，ry 是右下角的 y 像素坐标。rx 和 ry 应分别大于 lx 和 ly。 |
| diff | diff<path> |
将输入图像与参数图像进行比较，以显示哪些像素是相同的（白色）、不同的（红色）或不属于任何图像（透明）。 |
| draw-text ^2 | draw-text<string> <nv:coord> <nv:rgba> <nv:size> <nv:font> |
在图像上方绘制文本（注意：alpha 混合尚不支持）。 |
| filter3x3 | filter3x3<fp9x> |
应用一个 3x3 卷积滤波器。 |
| flip horizontal | flip-horizontal |
沿水平轴翻转图像。 |
| flip vertical | flip-vertical |
沿垂直轴翻转图像。 |
| gray scale | grayscale |
将每个像素转换为仅包含光强度的值。减少颜色空间以包含仅包含灰度单色值。 |
| horizontal gradient | 水平-gradient<nv:rgba> <nv:rgba> |
从左到右使用水平渐变填充和混合图像。 |
| hue rotate | hue-rotate<int> |
旋转色调，参数以度为单位。旋转 <int>%360 度。 |
| invert | invert |
反转图像的颜色。 |
| overlay | overlay<path> <uint> <uint> |
将加载自提供的参数路径的图像叠加到输入图像（在某个位置）上。 |
| 调整大小 | 调整大小<uint> <uint> |
将图像调整到x x y像素大小。可以放大和缩小。除非被覆盖，否则使用lanczos3采样滤波器。在sic v0.11之前，默认采样滤波器是gaussian。 |
| > | 设置保留-长宽比-比例<布尔值> |
在调整大小时启用保留长宽比。 |
| > | 设置采样-滤波器<值> |
在调整大小时使用<value>采样滤波器。选项有catmullrom、gaussian、lanczos3、nearest、triangle。 |
| 旋转90度 | 旋转90度 |
将图像旋转90度。 |
| 旋转180度 | 旋转180度 |
将图像旋转180度。 |
| 旋转270度 | 旋转270度 |
将图像旋转270度。 |
| 阈值 | 阈值 |
对图像应用自动阈值。 |
| 非锐化 | 非锐化<fp> <int> |
对图像应用非锐化掩码。第一个参数定义图像应该被模糊的程度，第二个参数定义一个阈值。如果原始图像和模糊图像之间的差异至少达到阈值，它们将相互减去。可用于锐化图像。 |
| 垂直渐变 | 垂直-gradient<nv:rgba> <nv:rgba> |
从上到下用垂直渐变填充和混合图像。 |
^1 _表中的语法适用于图像脚本，也可以在通过CLI参数使用图像操作时作为参考_
^2 draw-text仅在编译了imageproc-ops功能时可用
图像操作修饰符
对于某些操作，可以通过设置操作修饰符来调整它们的行为。这些修饰符可以被覆盖，也可以被重置（到默认行为）。
| 环境操作 | 语法 | 描述 |
|---|---|---|
| 设置环境选项 | 设置<选项> [<参数0..n>] |
启用对操作的修饰符使用。任何使用修饰符值的操作都将使用设置的修饰符值而不是默认值。可以通过再次调用set来覆盖同一操作和修饰符指定符。 |
| 取消设置环境选项 | 删除<选项> |
重置修饰符值。任何查看此修饰符值的操作都将使用默认值。 |
图例:
<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--水平-gradient"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--hue-rotate-90
反转示例
sic-iin.png-o out.png--应用-操作"invert"
or
sic-iin.png-o out.png--invert
叠加示例
sic-iin.png-o out.png--应用-操作"overlay 'image.png' 10 10"
or
sic-iin.png-o out.png--overlay"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--应用-操作"set sampling-filter triangle; resize 100 100"
or
sic-iin.png-o out.png--sampling-filter triangle--调整大小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--应用-操作"unsharpen -0.7 1"
or
sic-iin.png-o out.png--非锐化-0.7 1
垂直渐变示例
sic-iin.png-o out.png--应用-操作"vertical-gradient rgba(255, 0, 0, 255) rgba(0, 0, 255, 255)"
or
sic-iin.png-o out.png--垂直-gradient"rgba(255, 0, 0, 255)" "rgba(0, 0, 255, 255)"
具有多个图像操作并从左到右应用的示例
sic-iin.png-o out.png--应用-操作"rotate180; flip-horizontal; set sampling-filter nearest; resize 75 80; hue-rotate 75"
or
sic-iin.png-o out.png--旋转180度--翻转-水平--sampling-filter nearest--调整大小75 80 --hue-rotate75
关于图像操作的其它资源
有关可用选项和标志的更多信息，请运行sic --help。
许可证
许可协议为以下之一
- Apache许可证版本2.0，（LICENSE-APACHE 或 http://www.apache.org/licenses/LICENSE-2.0）
- MIT许可证（LICENSE-MIT 或 http://opensource.org/licenses/MIT）
由您选择。
贡献
除非您明确声明，否则根据Apache-2.0许可证定义，您有意提交以包含在作品中的任何贡献，将按上述方式双重许可，不附加任何额外条款或条件。
建议、问题、错误
如果您有任何建议、问题或发现错误，请随时打开一个问题 📬 =)
🎸 🎺 🎻 🎷
依赖项
~21MB
~153K SLoC