README.md

Fonts Readme

There are 16 fonts packaged with library. Fonts can be added or removed by user. All the Font data is in file font_data_RDL.cpp. These fonts are used by the graphics displays.

Font data table

num	Font enum name	character size XxY	ASCII range	Size in bytes
1	font_default	8x8	020-0x7E	764
2	font_sinclairS	8x8	0x20-0x7E	764
3	font_gll	8x8	0x20-0x5A , NO lowercase letters	476
4	font_pico	8x12	0x20-0x7E	1144
5	font_retro	8x16	0x20-0x7E	1524
6	font_mega	16x16	0x20-0x7E	3044
7	font_arialBold	16x16	0x20 0x7E	3044
8	font_hallfetica	16x16	0x20-0x7E	3044
9	font_orla	16x24	0x20-0x7E	4564
10	font_arialRound	16x24	0x20-0x7E	4564
11	font_groTesk	16x32	0x20-0x7A	5828
12	font_inconsola	24x32	0x20-0x7A	8740
13	font_mint	24x32	0x20 -0x7A	8740
14	font_sixteenSeg	32x48	0x2D-0x3A , 0-10 : . / - only	2692
15	font_sevenSeg	32X50	0x2D-0x3A , 0-10 : . / - only	2804
16	font_groTeskBig	32X64	0x20 - 0x5A, NO lowercase letters	15108

Font size in bytes = ((X * (Y/8)) * numberOfCharacters) + (ControlBytes)

Font class Function	Notes
writeChar	draws single character
writeCharString	draws character array
print	Polymorphic print class which will print out many data types

Adding or removing a font

1. Add/remove the Font data in font_data_RDL.cpp file
2. Add/remove the pointer to font at bottom of font_data_RDL.cpp file
3. Add/remove the associated extern pointer declaration in the font_data_RDL.hpp file
4. Add/remove the font from the enum 'display_Font_name_e' in the font_data_RDL.hpp
5. Add/remove the font enum name from the switch case in function 'setFont' in font_data_RDL.cpp
6. re-compile and re-install library.

A new ASCII font must have following font structure. First 4 bytes are control bytes followed by horizontally addressed font data.

// Example Font
// An 8 by 8 character size font starting at 
// ASCII offset 0x30 in ASCII table with 0x02 characters in font. 
// 0 and 1 , size 20 bytes, 4 Control bytes at start.
static const uint8_t FontBinaryExample[] =
{
0x08, 0x08, 0x30, 0x01,   // x-size, y-size, offset, (last character-offset : 0x31-0x30)
0x7C,0xC6,0xCE,0xD6,0xE6,0xC6,0x7C,0x00, // ASCII font data '0' : 0x30
0x18,0x38,0x18,0x18,0x18,0x18,0x7E,0x00 // ASCII font data  '1' : 0x31
};

Sources

Some of the fonts packaged with library came from rinky dink electronics

Font Images

Default

Pico

SinclairS

Retro

Arial Bold

Hallfetica

Arial Round

Orla

GroTesk

Inconsola

Mint

Sixteen Segment

Seven Segment

GroTesk Big