16个版本 (重大更新)
| 0.22.1 | 2023年9月16日 |
|---|---|
| 0.22.0 | 2023年4月22日 |
| 0.21.0 | 2023年1月19日 |
| 0.20.2 | 2022年12月12日 |
| 0.10.0 | 2019年9月28日 |
#7 in #sic
每月137次下载
在 7 crate 中使用
25KB
93 行
sic 图像 cli
从命令行转换图像和执行图像操作。
sic (sic图像cli) 是 image crate 的前端。除了由image crate提供的图像操作外，还包括一些额外的有用操作，如diff。通过编译时启用 imageproc-ops 特性，可以启用 imageproc crate提供的操作。我们打算在未来的版本中提供更广泛的支持。 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 -<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扩展名的图像转换为 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 度。 |
| 反转 | 反转 |
反转图像中的颜色。 |
| 叠加 | 叠加<path> <uint> <uint> |
将来自提供的参数路径加载的图像叠加到输入图像上（在某个位置）。 |
| 调整大小 | 调整大小<uint> <uint> |
将图像调整到 x by 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--应用-操作"反转"
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--应用-操作"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--应用-操作"旋转180度；水平翻转；设置采样滤波器为最近邻；调整大小为75x80；色调旋转75度"
or
sic-iin.png-o out.png--旋转180度--翻转-水平--sampling-最近邻滤波器--调整大小75 80 --hue-rotate75
关于图像操作的其它资源
有关可用选项和标志的更多信息，请运行sic --help。
许可证
根据您的要求，许可方式为以下之一
- Apache License，版本2.0，（LICENSE-APACHE 或 http://apache.ac.cn/licenses/LICENSE-2.0）
- MIT许可证（LICENSE-MIT 或 http://opensource.org/licenses/MIT）
任选其一。
贡献
除非您明确表示，否则根据Apache-2.0许可证定义的，您有意提交以包含在作品中的任何贡献，都将如上双许可，不附加任何额外条款或条件。
建议、问题、错误
如果您有建议、问题或发现了错误，请随时提交一个issue 📬。
🎸 🎺 🎻 🎷
依赖项
14MB
~179K SLoC