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.