zephyr/samples/display/cfb_custom_font
Marc Herbert 2cd51a33ce samples: make find_package(Zephyr...) REQUIRED
This provides a better error message when building with CMake and
forgetting ZEPHYR_BASE or not registering Zephyr in the CMake package
registry. See parent commit for more details (split from parent for
better readability).

Signed-off-by: Marc Herbert <marc.herbert@intel.com>
2020-05-29 10:47:25 +02:00
..
boards drivers: ssd1673: rename driver to ssd16xx 2019-07-04 07:27:09 -04:00
fonts samples: display: add sample for demonstrating custom CFB font 2018-11-28 11:46:00 +01:00
src drivers: ssd1673: rename driver to ssd16xx 2019-07-04 07:27:09 -04:00
CMakeLists.txt samples: make find_package(Zephyr...) REQUIRED 2020-05-29 10:47:25 +02:00
prj.conf samples: display: add sample for demonstrating custom CFB font 2018-11-28 11:46:00 +01:00
README.rst drivers: ssd1673: rename driver to ssd16xx 2019-07-04 07:27:09 -04:00
sample.yaml drivers: ssd1673: rename driver to ssd16xx 2019-07-04 07:27:09 -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 SSD16XX display controller
  on the reel_board.


Example building for the reel_board with SSD16XX display support:

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