README.rst
1.. _cfb_custom_fonts:
2
3Custom Fonts
4############
5
6Overview
7********
8A simple example showing how to generate Character Framebuffer (CFB)
9font headers automatically at build time.
10
11This example generates a font with font elements for 6 sided dice from
12a PNG image, and then uses the generated header (``cfb_font_dice.h``)
13to show the font elements on the display of a supported board.
14
15The source code for this sample application can be found at:
16:zephyr_file:`samples/subsys/display/cfb_custom_font`.
17
18Building and Running
19********************
20
21There are different configuration files in the cfb_custom_font
22directory:
23
24- :file:`prj.conf`
25 Generic config file, normally you should use this.
26
27- :file:`boards/reel_board.conf`
28 This overlay config enables support for SSD16XX display controller
29 on the reel_board.
30
31
32Example building for the reel_board with SSD16XX display support:
33
34.. zephyr-app-commands::
35 :zephyr-app: samples/subsys/display/cfb_custom_font
36 :host-os: unix
37 :board: reel_board
38 :goals: flash
39 :compact:
40
