#image #convert-images #proc-macro

nightly macro text-image

A proc-macro to generate raw image from text and a font file, for embedded-graphics

4 releases

0.2.0 Sep 21, 2024
0.1.2 Nov 29, 2023
0.1.1 Nov 28, 2023
0.1.0 Nov 28, 2023

#82 in Rendering

Download history 176/week @ 2024-09-17 21/week @ 2024-09-24 17/week @ 2024-10-01

214 downloads per month

MIT/Apache

21KB
448 lines

text-image

A Rust macro crate for converting text and images to various image formats, primarily for use with embedded graphics systems.

Features

  • Convert text to grayscale images with customizable options
  • Convert color images to monochrome (1-bit) images
  • Convert color images to 4-color (2-bit) images
  • Convert images to grayscale with adjustable bit depth (1, 2, 4, or 8-bit)

Usage

Add this to your Cargo.toml:

[dependencies]
text-image = "0.1.0"

Text to Image

Convert text to a grayscale image:

use text_image::text_image;
use embedded_graphics::{image::ImageRaw, pixelcolor::Gray8};
fn main() {
    let (w, h, raw) = text_image!(
        text = "Hello, world!哈哈这样也行",
        font = "LXGWWenKaiScreen.ttf",
        font_size = 48.0,
        inverse,
        Gray4,
    );
    let raw_image = ImageRaw::<Gray8>::new(raw, w);
}

Image to Monochrome

Convert a color image to a 1-bit monochrome image:

use text_image::monochrome_image;
let (w, h, img_raw) = monochrome_image!("path/to/image.png", channel = 1);

Image to 4-color

Convert a color image to a 2-bit 4-color image:

use text_image::quadcolor_image;
let (w, h, img_raw) = quadcolor_image!("path/to/image.png");

Image to Grayscale

Convert an image to grayscale with specified bit depth:

use text_image::gray_image;
let (w, h, img_raw) = gray_image!("path/to/image.png", Gray4);

Options

  • text: The text to convert (required for text_image!)
  • font: Path to the font file (required for text_image!)
  • font_size: Font size in pixels (default: 16.0)
  • inverse: Invert the colors (optional)
  • line_spacing: Additional space between lines (optional)
  • Gray2, Gray4, Gray8: Specify the bit depth for grayscale output

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Dependencies

~10MB
~212K SLoC