Home

honey the codewitch

GFX

GFX is a feature rich, cross platform graphics library geared for IoT devices. Unlike many graphics libraries, GFX is not tied intrinsically to the devices it can operate with - you can provide drivers for it, or use one of the many available drivers for common devices. GFX is equally suited for TFT/LCD, OLED and e-paper displays. Some notable features of GFX include Truetype font support, Win 3.1 FON support, JPG support, an X11 color palette, alpha blending, arbitrary binary pixel formats and color models, automatic conversion between them, and automatic color matching for paletted/indexed color displays.

GFX is copyright (C) 2021-2022 by honey the codewitch. GFX is licensed under the MIT license.

---

Get started using GFX by including the appropriate header:

#include <gfx.hpp> // for GCC C++17

or

#include <gfx_cpp14.hpp> // for GCC C++14

---

Contents

1. Pixels
   • 1.1 Declaring common pixels
   • 1.2 Channels
   • 1.3 Colors
   • 1.4 Color models
   • 1.5 The alpha channel
   • 1.6 Indexed pixels
   • 1.7 Declaring custom pixels
   • 1.8 Converting pixels
   • 1.9 Metadata
2. Draw targets
   • 2.1 Sources and destinations
   • 2.2 Bitmaps
     • 2.2.1 Standard bitmaps
     • 2.2.2 Const bitmaps
     • 2.2.3 Large bitmaps
   • 2.3 Drivers
   • 2.4 Viewports
   • 2.5 Sprites
   • 2.6 Custom
     • 2.6.1 Common members
     • 2.6.2 Capabilities
     • 2.6.3 Draw source members
     • 2.6.4 Draw destination members
     • 2.6.5 Initialization
3. Images
4. Fonts
   • 4.1 Truetype/Opentype Vector
     • 4.1.1 Layout
     • 4.1.2 Storage considerations
     • 4.1.3 Performance considerations
   • 4.2 Win 3.1 Raster
     • 4.2.1 Layout
     • 4.2.2 Storage considerations
     • 4.2.3 Performance considerations
5. Drawing
   • 5.1 Basic drawing elements
   • 5.2 Bitmaps and draw Sources
   • 5.3 Text
   • 5.4 Images
   • 5.5 Sprites
   • 5.6 Alpha blending
     • 5.6.1 Performance considerations
     • 5.6.2 Draw target considerations
   • 5.7 Suspend and resume
6. Positioning
   • 6.1 Points
   • 6.2 Sizes
   • 6.3 Rectangles
   • 6.4 Paths
7. Streams
8. Performance
   • 8.1 Blting
   • 8.2 Copying
   • 8.3 Batching
   • 8.4 RLE transmission
   • 8.5 Asynchronous drawing
9. Tools
   • 9.1 Bingen
   • 9.2 Fontgen