www.FabGL.com - 2019-2022 by Fabrizio Di Vittorio (fdivi.nosp@m.tto2.nosp@m.013@g.nosp@m.mail.nosp@m..com)
FabGL is mainly a Graphics Library for ESP32. It implements several display drivers (for direct VGA output and for I2C and SPI LCD drivers).
FabGL can also get input from a PS/2 Keyboard and a Mouse. ULP core handles PS/2 ports communications, leaving main CPU cores free to perform other tasks.
FabGL also implements: an Audio Engine, a Graphical User Interface (GUI), a Game Engine and an ANSI/VT Terminal.
This library works with ESP32 revision 1 and upper.
VGA output requires a digital to analog converter (DAC): it can be done by three 270 Ohm resistors to have 8 colors, or by 6 resistors to have 64 colors.
There are several fixed and variable width fonts embedded.
Unlimited number of sprites are supported. However big sprites and a large amount of them reduces the frame rate and could generate flickering.
When there is enough memory (on low resolutions like 320x200), it is possible to allocate two screen buffers, so to implement double buffering.
In this case primitives are always drawn on the back buffer.
Except for double buffering or when explicitly disabled, all drawings are performed on vertical retracing (using VGA driver), so no flickering is visible.
If the queue of primitives to draw is not processed before the vertical retracing ends, then it is interrupted and continued at next retracing.
There is a graphical user interface (GUI) with overlapping windows and mouse handling and a lot of widgets (buttons, editboxes, checkboxes, comboboxes, listboxes, etc..).
Finally, there is a sound engine, with multiple channels mixed to a mono output. Each channel can generate sine waveforms, square, etc... or custom sampled data.
Audio output, like VGA output, is generated using DMA. CPU just mixes audio channels and prepares waveforms.
Main classes of FabGL library:
- fabgl::VGAController, device driver for VGA bitmapped output
- fabgl::VGA2Controller, device driver for VGA 2 colors bitmapped output (low RAM requirements, CPU intensive)
- fabgl::VGA4Controller, device driver for VGA 4 colors bitmapped output (low RAM requirements, CPU intensive)
- fabgl::VGA8Controller, device driver for VGA 8 colors bitmapped output (low RAM requirements, CPU intensive)
- fabgl::VGA16Controller, device driver for VGA 16 colors bitmapped output (low RAM requirements, CPU intensive)
- fabgl::VGATextController, device driver for VGA textual output (low RAM requirements, CPU intensive)
- fabgl::SSD1306Controller, device driver for SSD1306 based OLED displays
- fabgl::ST7789Controller, device driver for ST7789 based TFT displays
- fabgl::ILI9341Controller, device driver for ILI9341 based TFT displays
- fabgl::Canvas, that provides a set of drawing primitives (lines, rectangles, text...)
- fabgl::Terminal, that emulates an ANSI/VT100/VT102/etc and up terminal (look at vttest score)
- fabgl::Keyboard, that controls a PS2 keyboard and translates scancodes to virtual keys or ASCII/ANSI codes
- fabgl::Mouse, that controls a PS2 mouse
- fabgl::Scene abstract class that handles sprites, timings and collision detection
- fabgl::uiApp base class to build Graphical User Interface applications
- fabgl::SoundGenerator to generate sound and music
- fabgl::InputBox to generate simple UI wizards
Devices emulation classes:
- fabgl::Z80, Zilog Z80 CPU emulator
- fabgl::i8080, Intel 8080 CPU emulator
- fabgl::MOS6502, MOS 6502 CPU emulator
- fabgl::VIA6522, VIA 6522 emulator
Other classes:
- fabgl::I2C, thread safe I2C (Wire) class
- fabgl::DS3231, Real Time Clock driver which uses the thread safe fabgl::I2C library
- fabgl::MCP23S17, 16 bit SPI port expander
See VGA output for VGA connection sample schema.
See PS/2 ports for PS/2 connections sample schema.
See Configuring Audio port for audio connection sample schema.
Created by Fabrizio Di Vittorio (fdivi.nosp@m.tto2.nosp@m.013@g.nosp@m.mail.nosp@m..com) - http://www.fabgl.com Copyright (c) 2019-2022 Fabrizio Di Vittorio. All rights reserved.
- Please contact fdivi.nosp@m.tto2.nosp@m.013@g.nosp@m.mail.nosp@m..com if you need a commercial license.
- This library and related software is available under GPL v3.
FabGL is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
FabGL is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with FabGL. If not, see http://www.gnu.org/licenses/.
