This project allows simple widget-based construction and rendering of a GUI on an Arduino Giga with an attached Giga Display Shield. It could easily be extended to other displays, but the first and foremost target is the aforementioned.

This project is a WIP, but at this point it should be stable enough for use in other projects.

Requirements

The "Arduino Community Edition" VS Code extension, if uploading with VS Code.
The following Arduino libraries are required:
- Arduino_GigaDisplayTouch
- Arduino_GigaDisplay_GFX
The following Arduino libraries are optional, but recommended. They are enabled by default, but you can disable whichever formats you don't want to support by editing src/ui/core/renderable/image_file/<FILE_FORMAT>.hpp.
- JPEGDEC - Provides support for rendering JPG-encoded data.
- PNGdec - Provides support for rendering PNG-encoded data.

Features

Build a GUI in a way that makes sense, without having to worry about rendering details.
Efficient UI rendering (only re-render the smallest area of the screen we can get away with)
Not a CPU hog (by default, each call to ui::render() blocks until the target framerate is achieved).
Support for timed callbacks (ui::setTimeout).
A tool to package a project containing XML, CSS, CPP and image files into a single ino file.
Image support for a wide range of formats:
- JPEG
- PNG
  - Single-bit transparency.
  - Only non-interlaced PNG images are supported. Interlaced PNG will not render correctly!
- BMP
- And other custom bitmap formats which are both faster to decode than JPEG or PNG, and more efficient to store than BMP. See tools/image_to_cpp.py.
  - Like with PNG, single-bit transparency is supported.
Define arbitrary pixel shaders that can be applied to any image or geometric shape, regardless of format.

An emulator is available to test sketches and for rapid prototyping of this library. See my Arduino emulation project.

If that's installed, you can emulate a sketch or xml file by running:

emulate your_sketch.ino

The documentation is automatically generated with Doxygen.

Be sure and check out the examples for some simple UI examples.