A command line tool for preparing bitmap images intended to be displayed on 2/3/4 color e-paper panels. The input is a JPEG (baseline) or Windows BMP file (any color depth), and the output is a C array of unsigned chars and is written as 1 or 2 separate bit planes depending on the desired output type.
Why did you write it?
My existing tool (image_to_c) is similar in that it generates C arrays to compile image data directly into a project. This project is different in that it does color matching and bit plane preparations specifically for e-paper displays. For example, in Black/White/Red EPDs, the black/white pixels are stored on memory plane 0 and the Red pixels are stored on memory plane 1. When you specify --BWR as the output type, the input image's pixels will be matched against B/W/R and 2 memory planes of output will be generated. The image data can full the full resolution of the target e-paper or be an icon/sprite. In the image below, A 96x256 BWR image is drawn in 4 positions.
NEW
- It can now read baseline JPEG images as well as Windows BMP
- It now has a Floyd Steinberg dither option
The code is C99 and can be compiled on any POSIX compliant system (Linux/MacOS/Windows).
example:
./epd_image --BWR --DITHER sample.jpg out.h
The above will generate black/white/red 2-plane output and write it to out.h
To make use of the image data, I added a new function to my OneBitDisplay library. See the code snippet below.
This code is what drew the 4 Bart images in the photo above:
If you find this code useful, please consider sending a donation or becoming a Github sponsor.
