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 |
#79 in Rendering
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 fortext_image!
)font
: Path to the font file (required fortext_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
~11MB
~213K SLoC