rasciify

rasciify was design to transform images into ASCII art. It was developed in Rust, where you can provide image to generate RGB, grayscale, or text-based artwork within any rust program.

Table of Contents

1. Description
2. Installation
3. Usage
4. Change Logs

Description

This project rasciify allows you to easily generate ASCII art within a rust program by providing an image. It provides a simple and easy-to-use interface for performing various ASCII art generation, by providing an image, you can choose to obtain the generated ASCII art in the form of RGB image, grayscale image or text.

If you need further modification, you can also choose to obtain it in the form of String or ImageBuffer. Check here to learn more.

Installation

To add rasciify to be use in a rust program

cargo add rasciify

Usage

To check out how to use rasciify, check the docs here

Change Logs

v0.2.2

Released: 2025-03-09

• No additional features added.
• Some Refactoring to reduce the params need for function call.
• Breaking API changes (if you are updating to v0.2.2 from previous release):
  • image_to_image
  • grayscale_to_ascii_img
  • rgb_to_rgb_ascii_img
  • gif_to_gif
  • rgb_gif_to_ascii_rgb_gif
  • rgb_gif_to_ascii_grayscale_gif
  • process_frames_to_ascii_rgba_img
  • process_frames_to_ascii_grayscale_img

v0.2.1

Released: 2025-03-08

• Optimized Gif related Processing.
• Add handling if user input a number of columns that is larger than the image width. We will default that back to 1/4 of the image width.

v0.2.0

Released: 2025-03-02
Add new supported character set.

• Bar
• Chinese Simplified
• Chinese Traditional

Add new feature to turn GIF into GIF of ascii art in both rgb and grayscale

v0.1.2

Released: 2025-02-17
Modify the font files to only include supports for character used.
Bundle the font assets into the crate.

v0.1.1

Released: 2025-02-15
A fix to path where build.rs save the pulled font assets and the path used to load the font assets.

v0.1.0

Released: 2025-02-15
Initial crate Publish.
This includes operation like:

• image to text based ASCII art
• image to RGB image ASCII art
• image to grayscale image ASCII art