/ACeP-600x448-8-colour-epaper-display-tools

Windows batch image processing tools for Waveshare 7/8 colour 600x-448 ePaper display using imagemagick

Primary LanguageC

Some tools for processing images for use with the 7/8 colour ACeP and 4.2in black/white/red Waveshare displays (Windows)

ProcessACeP

ProcessACeP uses imagemagick to process any image into an 8 colour dithered png, then into an ACeP file (raw 2px/byte format) for the ACeP colour epaper display. The palette provided to imagemagick is my best guess, and I think produces fairly good results (see how the black/white and colour gradients are reproduced on the display).

Note that the output image is rotated 90 degrees, since the program is intended for input images that are portrait rather than landscape format, and the ACeP display's native bitmaps are landscape format.

Copy the template/tools folder into the another folder, and place your images (any size/format supported by imagemagick) into a subfolder called "source" in the same folder. Then run ProcessACeP.exe. ProcessACeP.exe will output another file, processACeP.bat, which contains all of the commands to process the source images into ACeP files. Captions for Saint's feast days will be added from the file en-1962.txt if the filename of the source image is of the form -, eg. 14-9.jpg would be 14th September.

Support for 4.2in black/white/red display with modified GxEPD display driver

The programs can also be used to dither black/white/red images in 8 shades of red and black, as supported by the modified GxEPD display driver used with the Lectionary project (https://github.com/plishman/Catholic-Lectionary-on-ESP8266/tree/master/libraries/GxEPD/GxGDEW042Z15).

Sample black/white/ dithering output

Input

Output

Actual display

Sample black/white/red dithering output

Input

Output

Actual display

makeACeP

Turns any common image file format (png, jpg, gif etc) into a 600x448 pixel raw binary, in the native pixel format of the Waveshare ACeP display. Based on the program "converter" (https://github.com/cnlohr/epaper_projects/tree/master/atmega168pb_waveshare_color/tools/converter)

ACePView

ACePView views ACeP files and outputs a png copy to the same directory. Use as a sanity check to make sure that the result of processing with ProcessACeP worked.

Sample output

Monochrome gradient (may show moire patterns in Github due to scaling, not present in fullsize image)

Input

Output

Actual display

Colour gradient

Input

Output

Actual display

Real image

Source image (input)

Actual display