sFONT begrijpen: bitmap-lettertypen voor embedded displays

22-01-2026

Als u ooit heeft gewerkt met STM32-microcontrollers en hun BSP-bibliotheken, bent u waarschijnlijk de sFONT-structuur tegengekomen. Het is een eenvoudige, efficiënte manier om bitmap-lettertypen op te slaan voor LCD-displays. Maar deze lettertypen aanmaken of aanpassen? Dat betekent meestal handmatig door hex-arrays spitten of op zoek gaan naar obscure desktop-tools.

Wij bouwden een browser-gebaseerde editor om dit makkelijker te maken.


Wat is sFONT?

Embedded Display

Van STM32 LCD’s tot Waveshare e-paper: sFONT is overal

Het sFONT-formaat is ontstaan in het Board Support Package (BSP) van STMicroelectronics voor hun display-drivers. Het is een eenvoudig bitmap-lettertypeformaat, ontworpen voor systemen met beperkte resources waar elke byte telt.

Het formaat is inmiddels verder verspreid dan alleen STM32. Waveshare gebruikt dezelfde structuur voor hun populaire e-paper display-bibliotheken, waardoor het een de facto standaard is geworden voor embedded bitmap-lettertypen op meerdere platformen.

Een lettertype in dit formaat bestaat uit twee delen:

  1. Een byte-array met de pixeldata voor elk karakter
  2. Een sFONT-struct die alles samenbrengt
const uint8_t MyFont_Table[] = {
    // @0 ' ' (7 pixels wide)
    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
    // @12 '!' (7 pixels wide)
    0x00, 0x10, 0x10, 0x10, 0x10, 0x10, 0x00, 0x00, 0x10, 0x00, 0x00, 0x00,
    // ... meer karakters
};

sFONT MyFont = {
    MyFont_Table,
    7,  /* Width */
    12, /* Height */
};

Elk karakter wordt opgeslagen als een reeks bytes, rij voor rij, met pixels gepakt vanaf de meest significante bit. De standaard karakterset loopt van ASCII 32 (spatie) tot en met 126 (tilde).


Waarom bitmap-lettertypen nog steeds relevant zijn

Embedded Display Close-up

Elke pixel onder uw controle

In een tijdperk van schaalbare vectorlettertypen, waarom zou iemand bitmaps gebruiken? Voor embedded systemen zijn de redenen overtuigend:

  1. Voorspelbaar geheugengebruik: Een 7x12 lettertype met 95 karakters gebruikt precies 1140 bytes. Geen verrassingen, geen runtime-allocaties.

  2. Snelle rendering: Een karakter tekenen is gewoon bytes kopiëren naar een framebuffer. Geen glyph-rasterisatie, geen anti-aliasing berekeningen.

  3. Perfecte pixelcontrole: Op een 128x64 OLED wilt u precies weten welke pixels oplichten. Vectorlettertypen zien er op kleine formaten vaak wazig uit na rasterisatie.

  4. Geen dependencies: Het lettertype is gewoon een C-array. Geen font-parsing bibliotheken, geen filesystem-toegang, geen heap.


Het probleem met bewerken

Hier wordt het frustrerend. De STM32Cube-pakketten bevatten verschillende kant-en-klare lettertypen, maar wat als u:

Uw opties zijn beperkt. U kunt naar hex-waarden staren en proberen bits te visualiseren, of u kunt zoeken naar desktop font-editors die al dan niet in het juiste formaat exporteren.

Hex Editing

Handmatig hex-waarden bewerken is foutgevoelig


Een betere manier

Wij bouwden de sFONT Generator om precies dit probleem op te lossen. Het is een visuele editor die volledig in uw browser draait.

Pixels direct tekenen

Klik of sleep op het raster om pixels aan of uit te zetten. De interface toont precies wat er op uw display gerenderd zal worden, op de exacte afmetingen die u opgeeft.

sFONT Editor Interface

De pixel-grid editor met live C-code preview

Live code generatie

Terwijl u bewerkt, wordt de C-code in real-time bijgewerkt. U kunt de hex-bytes zien veranderen en verifiëren dat de visuele commentaren overeenkomen met uw bedoelingen.

Bestaande lettertypen importeren

Heeft u al een sFONT in uw codebase? Plak de C-code in de editor, klik op “Sync from Code,” en de tool zal de hex-bytes parsen en de visuele representatie reconstrueren. Nu kunt u individuele karakters aanpassen en de bijgewerkte code exporteren.

Import Feature

Importeer bestaande lettertype-code en bewerk visueel

Configureerbare afmetingen

Een 5x8 lettertype nodig voor een kleine OLED? Een 16x24 lettertype voor een grotere TFT? Stel elke breedte en hoogte in tot 64 pixels. De tool handelt de byte-packing automatisch af.


Hoe het formaat werkt

Het begrijpen van de byte-layout helpt bij het debuggen van display-problemen. Zo wordt een karakter gecodeerd:

Voor een 7-pixel-breed lettertype neemt elke rij 1 byte in beslag (aangezien 7 bits in 8 passen). De pixels worden MSB-first gepakt:

Pixel posities:   0 1 2 3 4 5 6 (ongebruikt)
Bit posities:     7 6 5 4 3 2 1 0

Voorbeeld rij met pixels op posities 1 en 4:
Binair: 0 1 0 0 1 0 0 0 = 0x48

Voor bredere lettertypen (9-16 pixels) neemt elke rij 2 bytes in beslag. De tool handelt al deze berekeningen af, zodat u zich kunt focussen op het visuele ontwerp.


Verder dan tekst: gekleurde iconen maken

Hier is een truc die niet voor de hand ligt uit het formaat: u kunt sFONT-glyphs gebruiken om meerkleurige graphics te maken op displays die kleur ondersteunen.

De techniek is simpel. In plaats van één icoon te ontwerpen, splitst u het op in lagen, één voor elke kleur. Sla elke laag op als een apart karakter in uw lettertype. Render ze vervolgens op dezelfde positie, elk in een andere kleur.

Layered Icon Technique

Drie monochrome lagen combineren tot één gekleurd icoon

Bijvoorbeeld, een batterij-indicator kan bestaan uit:

// Render een gekleurd batterij-icoon op positie (x, y)
LCD_SetTextColor(WHITE);
LCD_DisplayChar(x, y, 'A');  // Omtrek

LCD_SetTextColor(GREEN);
LCD_DisplayChar(x, y, 'B');  // Vulling

if (battery_low) {
    LCD_SetTextColor(RED);
    LCD_DisplayChar(x, y, 'C');  // Waarschuwing
}

Deze aanpak houdt de geheugenvoetafdruk klein terwijl u kleurrijke, pixel-perfecte iconen krijgt. De sFONT Generator maakt het makkelijk om deze lagen visueel te ontwerpen: maak gewoon elke laag als een apart karakter en lijn ze op het oog uit.


Praktische tips

Begin met een bestaand lettertype. De tool laadt met een standaard 7x12 lettertype. Gebruik dit als basis en pas karakters aan waar nodig in plaats van vanaf nul te beginnen.

Test op echte hardware. Wat er perfect uitziet in de browser kan contrastproblemen hebben op uw daadwerkelijke display. Houd uw development board bij de hand.

Denk na over karakterbreedte. sFONT gebruikt fixed-width karakters. Als u vooral cijfers weergeeft, bespaart een smaller lettertype schermruimte.

Sla uw werk op. De tool slaat automatisch op in de local storage van uw browser, maar exporteer uw C-code regelmatig. Local storage kan gewist worden door browser-opruimtools.


Probeer het zelf

Of u nu een aangepast lettertype vanaf nul maakt of de standaard lettertypen van STM aanpast om beter bij uw display te passen, de sFONT Generator maakt het proces visueel en direct.


Hulp nodig bij display-integratie?

Als u werkt aan een embedded display-project en problemen ondervindt met lettertypen, graphics of driver-integratie, kunnen wij helpen. We hebben gewerkt met alles van kleine OLED’s tot industriële TFT-panelen.

📧 Neem contact met ons op via altug@alsoft.nl

⚙️ Bekijk onze andere Tools