Lib.rs

Advanced ASCII Art Generator

Usage: rascii [OPTIONS] <FILENAME>

Arguments:
  <FILENAME>  Path to the image

Options:
  -w, --width <WIDTH>      Width of the output image. Defaults to 128 if width and height are not specified
  -H, --height <HEIGHT>    Height of the output image, if not specified, it will be calculated to keep the aspect ratio
  -c, --color              Whether to use colors in the output image
  -i, --invert             Inverts the weights of the characters. Useful for white backgrounds
  -C, --charset <CHARSET>  Characters used to render the image, from transparent to opaque. Built-in charsets: block, emoji, default, russian, slight [default: default]
  -h, --help               Print help
  -V, --version            Print version

特性

• 作为crate可用： RASCII提供了一个非常简单的API，允许您在不使用系统shell的情况下从您的程序中使用RASCII。

• 彩色ASCII艺术生成： RASCII使用ANSI颜色代码生成彩色ASCII艺术。

  注意： 您的终端模拟器必须支持truecolor（别担心，几乎所有的现代终端模拟器都支持）。

• 高效的彩色输出： RASCII永远不会重复已经激活的ANSI颜色代码。

  这在具有少量交替颜色的图像中效果显著，输出大小最多可减少约1800%。哇！

• 自定义尺寸： RASCII允许您为输出ASCII艺术提供自定义尺寸，同时保持纵横比（除非同时提供两个尺寸）。

• 自定义字符集： RASCII允许您使用自定义字符集生成ASCII艺术。

  注意： 给定的字符集必须从透明到不透明。

• 包含大量预定义字符集。

安装CLI

通过Cargo

注意： 这是安装RASCII CLI的推荐方式。

警告： 您必须在~/.cargo/bin/中将PATH添加到您的环境中才能直接运行rascii。

cargo install rascii_art

手动

警告： 此安装方法不建议使用，并且仅适用于GNU/Linux或其他POSIX兼容系统！

git clone https://github.com/KoBruhh/RASCII && cd RASCII
chmod +x install.sh
./install.sh

使用crate

您可以使用rascii_art crate将RASCII添加到您的项目中，并在Rust中使用它，而不是使用不可靠的系统shell调用RASCII。

为此，运行cargo add rascii_art将RASCII添加到您的Cargo项目中。

以下是一个示例代码

use rascii_art::{
    render_to,
    RenderOptions,
};
                                                            
fn main() {
    let mut buffer = String::new();
                                                            
    render_to(
        r"/path/to/image.png",
        &mut buffer,
        &RenderOptions::new()
            .width(100)
            .colored(true)
            .charset(&[".", ",", "-", "*", "£", "$", "#"]),
    )
    .unwrap();
}

展示

日文字符集

表情字符集

注意： 表情字符集不能保证您的输出颜色与图像颜色匹配，这只是与Ferris发生的巧合。

中文字符集

块字符集

自定义ASCII字符集

您可以使用--charset（或-C）命令行选项来指定生成某些ASCII艺术时使用的自定义字符集。

此选项的值必须从透明到不透明，如下所示：

rascii --charset " ░▒▓█" --color ferris.png

请注意，与上述字符集类似的字符集作为内置的block名称提供。

Amogus

贡献者

星历史