4 个版本

0.1.4 2024 年 1 月 4 日
0.1.2 2024 年 1 月 4 日
0.1.1 2024 年 1 月 4 日
0.1.0 2024 年 1 月 4 日

#2455命令行工具

每月 22 次下载

MIT 许可证

1MB
427

ImgCatr

Licence Crates.io version

一个基于 Rust 的命令行工具 imgcatr 用于显示图像。

running `imgcatr cat.png`

安装

Crate.io

Crate.io 安装,需要在您的计算机上安装 Cargo

cargo install imgcatr

在 MacOS 上

brew install imgcatr

用法

概述

在您的计算机的 bin 目录中安装此命令后,您可以通过以下说明直接在 CLI 中调用 imgcatr 以显示图像。

Usage: imgcatr [OPTIONS] <IMAGE>

Arguments:
  <IMAGE>  Image file to display

Options:
  -s, --size <NxM>   Image size to display [default: 138x22]
  -f, --force        Don't preserve the image's aspect ratio
  -a, --ansi <ANSI>  Force output ANSI escape [possible values: truecolor, simple-black, simple-white, ascii]
  -h, --help         Print help
  -V, --version      Print version

有一些功能可以自定义您希望如何显示图像。您可以通过以下文档了解有关此命令的更多信息。

显示格式

在准备图像后,您可以使用 -a-ansi 指定输出格式,ImgCatr 有 4 种可用的输出格式:truecolorsimple-blacksimple-whiteasciino_ansi(适用于 Windows 操作系统)。

running `imgcatr cat.png`

自定义大小

图像显示的默认大小设置为 CLI 的大小。这意味着图像的高度不会超过终端的高度。但是,您可以使用 -s-size 后跟 <NxM> 格式的输入来指定图像大小。以下是一个示例,其中图像大小设置为 100x100。

imgcatr cat.png --size 100x100

保持比例

默认情况下,图像比例保持不变。选项 -f-force 可强制程序不保持图像比例。

running `imgcatr cat.png`

注释

特别感谢

这项工作源于名为 termimage 的开源项目。在此,我要特别感谢团队。

比较

之前的工作 termimage 使用了 clap-v2 库的旧版本。imgcatr 用 clap-v4 的最新实现替换了 clap-v2,总体性能更好。此外,imgcatr 提供了新功能,用户可以显示图像的 ASCII 格式。

未来

未来工作中将有望通过更快的 API 和更多功能进行改进。

依赖关系

~6MB
~77K SLoC