1 unstable release
0.1.0 | Feb 7, 2024 |
---|
#833 in Images
28KB
470 lines
bmp8bit
Popular image libraries written in Rust do not allow color table based bmps to be saved. This small crate extends image-rs so it is able to write Dynamic Image
as 256-colors BMP.
Theoretically it can write images with custom color tables, but I never tried it. See the Usage section for further details.
Building
cargo build
Usage
If you use image-rs, usage is just:
use bmp8bit::{self, save_8bit_win};
let img: image::DynamicImage = somehow_acquired_image();
save_8bit_win(img, "out/img_8bit.bmp");
Your own raster image representation
If your have your own raster image representation implemented, you'll need to implement Colors256
trait. It has two methods:
samples
is for converting your raster image representation to bytes vector using specified color table. This vector should contain the whole image. UseColorTableSample::new
to convert your sample to color table sample and thenColorTable::convert
to acquire vector of bytes for your sample.size
just returnsDimensions
struct which describes your image width and height.
You can find reference implementation in image_rs module.
Custom color table
Theoretically, Colors256::samples
using custom color table would also generate a valid bmp image. Needs some testing. windows_color_table can be taken as an example.
License
Apache License Version 2.0
Contributing
I am not really good in Rust yet, so any issue reports, improvements, suggestions (even for code style) are appreciated.
Dependencies
~5.5MB
~70K SLoC