Files
image2cpp/README.md
T
2016-10-24 23:26:39 +02:00

19 lines
1.4 KiB
Markdown

## image2cpp ##
image2cpp is a simple tool to change images into byte arrays to use with (monochrome) displays suchs as OLEDs, like those from Adafruit or Sparkfun. While searching for a way to generate these arrays, I mostly found links to a piece of Windows software. Both the flakey results and the hassle of having to boot a virtual machine just to convert an image lead to me writing this pure html + javascript solution.
Alternatively you can also enter a byte array as input to turn it back into an image. This might be useful for debugging, or when you want to write the byte array yourself. I don't know.
### Running the tool ###
You don't need any special dependencies / internet connection; all the necessary parts sit in a single .html file. So just open this index.html page in a (recent) browser to run the tool.
Or you can use the online version at: http://javl.github.io/image2cpp/
### Example Arduino code ###
You can find a simple Arduino example sketch [over here](https://github.com/javl/image2cpp/blob/master/oled_example/oled_example.ino) in the repository.
### Screen types ###
I wrote the code with my 128x64 pixel monochrome OLED display in mind, but it should work with most similar displays. You might need to change some export settings; those are explained in the tool.
### Credit ###
Initial code by [javl](https://github.com/javl), with aditional code by [wiredolphine](https://github.com/wiredolphin). The example sketch was made by Adafruit.