Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/marcin-chwedczuk/img2h

Convert images and icons to Adafruit GFX library format.
https://github.com/marcin-chwedczuk/img2h

5110 adafruit-gfx adafruit-gfx-library adruino dithering javafx

Last synced: about 2 months ago
JSON representation

Convert images and icons to Adafruit GFX library format.

Awesome Lists containing this project

README

        

# img2h (Image to C Header)

![Build Status](https://github.com/marcin-chwedczuk/img2h/actions/workflows/ci.yaml/badge.svg)

This is a simple tool that allows you to convert
images and icons to Arduino's Adafruit GFX library format.

![Main window](docs/main-window.png)

Example images created using this app:

![Demo 1](docs/demo1.png)
![Demo 2](docs/demo2.png)
![Demo 3](docs/demo3.png)

## Download application

You can download the latest releases from repository [releases page](https://github.com/marcin-chwedczuk/img2h/releases).

### macOS

To install the application on macOS open `.dmg` file and drop the app to `/Applications` folder.
Next, you have to remove quarantine bits from the `.app` file to be able to run the app
(this is the only way to run the app without me having to pay $$$ for Apple dev account).

```
$ cd /Applications
$ sudo xattr -cr img2h.ap
$ open img2h.app
```

After this you will be able to start img2h app via Spotlight.

### Linux

Download the provided `.deb` file and install it via `dpkg`:
```
$ sudo dpkg -i img2h_1.0.0-1_amd64.deb
```
By default, the app will be installed in `/opt/img2h/`, you may need to add
it to `PATH` to use the app comfortably.

To remove the app just execute:
```
$ sudo apt remove img2h
```

### Windows

TODO

## How to build application from sources

You need JDK 16 or newer to compile and run this application.
```
# This will add module-info to dependencies that are not fully
# JPMS compliant, like e.g. Guava.
./build-modularized-version-of-dependencies.sh

./mvnw clean package
./mvnw javafx:run -pl gui
```

(OK it should work on JDK 11 too, but I am running all CI builds on JDK 16.)