The Adafruit GFX library with Unicode support #Adafruit @Adafruit @josecastillo

On Adafruit Show and Tell Wednesday, Joey Castillo demonstrated a fork of the widely used Adafruit GFX library with Unicode characters.

Hi there, Joey here! I shared the Unicode fork of the GFX library at tonight’s show and tell. Thanks for the positive feedback! It was great to show some of my work, and to see what members of the community are building. Here’s the link to the repository:

https://github.com/joeycastillo/Adafruit-GFX-Library

It’s mostly a drop-in replacement for the main GFX library; the only breaking change is that it removes the ability to setFont to a graphic font. Other than that, the interface is identical, with a couple of new methods for displaying code points and UTF-8 strings.

I hope that the community finds it useful, and hope to be back on the show and tell in the coming weeks to share progress on this universal text reader project!

From GitHub: This fork of the Adafruit GFX Library aims to support the seamless display of text in all the languages of the world. It achieves this by replacing the standard 5×7 font with the GNU Unifont, an 8×16 (in some cases 16×16) pixel font that includes glyphs for every Unicode code point in the basic multilingual plane (BMP). It also removes all support for graphic fonts.

This should function as a drop-in replacement for the Adafruit GFX Library, as long as you’re not using graphic fonts. You can display a Unicode code point by calling display.writeCodepoint(c), where c represents the Unicode code point (not its UTF-8 or UTF-16 representation). You can display a UTF-8 encoded string with the display.printUTF8(s) and display.printlnUTF8(s) methods; I’ve included a Very Strict UTF-8 Decoder that will turn well-formed UTF-8 into code points suitable for display with writeCodepoint.

Two e-ink displays, one OLED, a TFT and a memory LCD displaying a variety of Unicode examples: Hello World in ten languages; a series of icons and symbols; a handful of mathematical formulas; and a chapter of the Tao Te Ching in Chinese.

See GitHub for extensive details.

Will this new capability help you use graphical displays? Let us know in the comments below.


Adafruit publishes a wide range of writing and video content, including interviews and reporting on the maker market and the wider technology world. Our standards page is intended as a guide to best practices that Adafruit uses, as well as an outline of the ethical standards Adafruit aspires to. While Adafruit is not an independent journalistic institution, Adafruit strives to be a fair, informative, and positive voice within the community – check it out here: adafruit.com/editorialstandards

Join Adafruit on Mastodon

Adafruit is on Mastodon, join in! adafruit.com/mastodon

Stop breadboarding and soldering – start making immediately! Adafruit’s Circuit Playground is jam-packed with LEDs, sensors, buttons, alligator clip pads and more. Build projects with Circuit Playground in a few minutes with the drag-and-drop MakeCode programming site, learn computer science using the CS Discoveries class on code.org, jump into CircuitPython to learn Python and hardware together, TinyGO, or even use the Arduino IDE. Circuit Playground Express is the newest and best Circuit Playground board, with support for CircuitPython, MakeCode, and Arduino. It has a powerful processor, 10 NeoPixels, mini speaker, InfraRed receive and transmit, two buttons, a switch, 14 alligator clip pads, and lots of sensors: capacitive touch, IR proximity, temperature, light, motion and sound. A whole wide world of electronics and coding is waiting for you, and it fits in the palm of your hand.

Have an amazing project to share? The Electronics Show and Tell is every Wednesday at 7pm ET! To join, head over to YouTube and check out the show’s live chat – we’ll post the link there.

Join us every Wednesday night at 8pm ET for Ask an Engineer!

Join over 36,000+ makers on Adafruit’s Discord channels and be part of the community! http://adafru.it/discord

CircuitPython – The easiest way to program microcontrollers – CircuitPython.org


Maker Business — “Packaging” chips in the US

Wearables — Enclosures help fight body humidity in costumes

Electronics — Transformers: More than meets the eye!

Python for Microcontrollers — Python on Microcontrollers Newsletter: Silicon Labs introduces CircuitPython support, and more! #CircuitPython #Python #micropython @ThePSF @Raspberry_Pi

Adafruit IoT Monthly — Guardian Robot, Weather-wise Umbrella Stand, and more!

Microsoft MakeCode — MakeCode Thank You!

EYE on NPI — Maxim’s Himalaya uSLIC Step-Down Power Module #EyeOnNPI @maximintegrated @digikey

New Products – Adafruit Industries – Makers, hackers, artists, designers and engineers! — #NewProds 7/19/23 Feat. Adafruit Matrix Portal S3 CircuitPython Powered Internet Display!

Get the only spam-free daily newsletter about wearables, running a "maker business", electronic tips and more! Subscribe at AdafruitDaily.com !



No Comments

No comments yet.

Sorry, the comment form is closed at this time.