Overview


Image Reformer is a utility that converts images into C code for use with MSP430 Graphics Library.    

Why Convert?

Most images are 24 Bits Per Pixel and over 1000 by 1000 pixels.  Most MCU displays are 1, 2, 4 or 8 bits per pixel and sizes range from 96x96 to QVGA (320x240).  So in order to display the image a color and probably a size conversion is usually needed.  Additionally, in order to save image decode time on a low powered MCU, converting the image to C code makes sense for faster display.

Supported Image Input Formats

Image Format
jpeg
gif
png
bmp
tif

Conversion Output Formats

Supported Conversion Formats
Color Depth, Max Colors,Compressed, Un-Compressed
1 bit per pixel2Yes RLE4Yes
2 bits per pixel4Yes RLE4Yes
4 bits per pixel16Yes RLE4Yes
8 bits per pixel256Yes RLE8Yes


Converting An Image


From the Image Reformer main screen press the Open Image Icon or File->Open.  This will bring up all the available image files in your root directory.  Navigate to the location of the image to load and double click or select and press "Open".

load Image

Types of Conversion

Select the pixel depth conversion and size of the image to generate based on the display parameters you are using.

conversion buttons

Compression

Compressed images will use less memory to display and generally display faster but will require a bit more processing.   Depending on the requirements compression is available.  For 1,2,4 bits per pixel RLE4 compression is used.  For 8 bits per pixel, RLE8 is used.  

Generating Output

The final step in converting an image is generating the .c file with the image data for inclusion by Graphics Library.   Press the generate button and you will be prompted for a file to save under.  This file is based on the input image name with a ".c" extension.   In general this file should not need any editing and can be loaded as-is by Graphics Library.