zephyr/samples/display/cfb_custom_font
Anas Nashif da5f185e06 samples: add test identifier
Add unique identifier instead of just 'test' for samples.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2019-03-29 17:44:11 -04:00
..
boards
fonts
src
CMakeLists.txt cmake: Drop all in-tree usage 'set_conf_file' 2019-03-01 09:44:09 +01:00
prj.conf
README.rst doc: use :zephyr_file: where appropriate 2019-03-09 09:50:27 -05:00
sample.yaml samples: add test identifier 2019-03-29 17:44:11 -04:00

.. _cfb_custom_fonts:

Custom Fonts
############

Overview
********
A simple example showing how to generate Character Framebuffer (CFB)
font headers automatically at build time.

This example generates a font with font elements for 6 sided dice from
a PNG image, and then uses the generated header (``cfb_font_dice.h``)
to show the font elements on the display of a supported board.

The source code for this sample application can be found at:
:zephyr_file:`samples/display/cfb_custom_font`.

Building and Running
********************

There are different configuration files in the cfb_custom_font
directory:

- :file:`prj.conf`
  Generic config file, normally you should use this.

- :file:`boards/reel_board.conf`
  This overlay config enables support for SSD1673 display controller
  on the reel_board.


Example building for the reel_board with SSD1673 display support:

.. zephyr-app-commands::
   :zephyr-app: samples/display/cfb_custom_font
   :host-os: unix
   :board: reel_board
   :goals: flash
   :compact: