Git Product home page Git Product logo

aremmell / exostra Goto Github PK

View Code? Open in Web Editor NEW
0.0 1.0 0.0 453 KB

A single-header compositing window manager written in C++17, designed for small touch screens and Arduino IDE/PlatformIO/ESP-IDF.

License: MIT License

C++ 98.05% CMake 0.26% Shell 1.69%
arduino-library compositing-manager gui-library platformio-arduino platformio-library single-header-library window-manager touch-display esp-idf-lib

exostra's Introduction

Exostra

License REUSE status Security Rating Maintainability Rating Reliability Rating

A single-header C++17 (20 when the toolchains catch up) compositing window manager designed specifically for use with small touch displays, such as the kind you might utilize while building an IoT project.

Currently, Exostra1 is designed to be consumed by an Arduino/PlatformIO/ESP-IDF project as a library dependency, and has support for the following low-level graphics libraries/interfaces:

Notable features

  • Single-header implementation (C++17)
  • Only draws pixels that must be redrawn and will be visible; rendering is extremely fast: with several top-level windows and many widgets, I am getting ~50 microsecond average rendering times (on an Unexpected Maker ProS3 connected to an Adafruit HX8357D via EYESPI)!
  • Uses templates to abstract the low-level graphics library away, allowing the underlying graphics library to be swapped out with 1-2 lines of changes.
  • Themeable. A default theme is under development along with the library, but themeing is extremely simple through the use of inheritance/virtual functions and templates.
  • Automatically adapts the scale and spacing of windows/widgets based on the display size and resolution.
  • Screensaver! I've added the ability for a screensaver to appear after a given amount of time with no user interaction in order to a) conserve power, and b) to prevent burn-in on certain displays. Right now it's just a blank screen, but maybe I'll add some graphics later on.

Current progress

  1. WIP/not ready for production use. I have only written the basic window classes like button, label, progress bar, prompt (message box), checkbox, etc. as of now, but stay tuned!
  2. Limitations (some to be resolved, some perhaps not):
  • Only supports 16-bit RGB 565 color mode (I will be adding 24-bit RGB support as well as translation from 24-bit to 16-bit)
  • Requires a not-insignificant amount of heap memory, as each top-level window is paired with a 16bpp off-screen buffer which is shared with all descendants of the window. Using these off-screen buffers allows Exostra to copy the raw pixel data directly to the display hardware with zero flickering. Depending on the resolution of display and number of top-level windows, these buffers may consume several hundred KiB of heap memory. I am considering providing alternate modes, such as one that reuses a single screen-sized off-screen buffer for all windows, which will be much slower to render, but use less resources. Another possibility is direct rendering to the display hardware, which will result in flickering/noticeable delays, but could allow Exostra to run on boards it could otherwise not run on.
  • Only processes tap events. I have not gotten to swiping/multi-touch gestures yet.

I will upload a sample video in the weeks to come, as I have more useful features to show off.

Footnotes

  1. Exostra (n): A relatively obscure Latin term which means "theatrical machine" or "revealing the inside of a house to spectators." (Charles Beard, “Cassell’s Latin Dictionary”, 1892)

exostra's People

Contributors

aremmell avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.