NebOS UI fonts
==============

The window manager, ngui applications and the browser use the fixed-point
TrueType engine in ufont.c / ufont_ttf.c.  The kernel boot console keeps the
built-in 8x8 font; the terminal, editor and text fields keep the 8x16 bitmap
font for their cell grids.

Files
-----

  sans.ttf      Arimo Regular, Latin-1 + common punctuation
  sans-b.ttf    Arimo Bold
  sans-i.ttf    Arimo Italic
  sans-bi.ttf   Arimo BoldItalic
  mono.ttf      Liberation Mono Regular (browser <pre>/<code>)
  emoji.ttf     Noto Emoji monochrome subset (common emoji, cmap 12)
  emoji-unicodes.txt
                the curated codepoints used to generate emoji.ttf

The Arimo faces are Copyright 2020 The Arimo Project Authors and are
distributed under the Apache License 2.0 (see LICENSE-Apache-2.0).  Liberation
Mono is copyright (c) 2012 Red Hat, Inc. with Reserved Font Name Liberation
and is distributed under the SIL Open Font License 1.1 (see LICENSE-OFL).
Noto Emoji is Copyright 2013 Google Inc. and is distributed under the SIL
Open Font License 1.1; emoji.ttf contains a curated subset of the monochrome
Noto Emoji face.  The subsets remove unused glyphs and OpenType layout
features and keep the files small enough for the rootfs pack.

The emoji subset is limited to glyphs that fit the fixed-point rasterizer
(256 points / 16 contours per glyph) and to common single-codepoint emoji;
ZWJ sequences, flags and color glyphs are not supported.  The list is in
fonts/emoji-unicodes.txt.

Regenerating
------------

Install fonttools (`python3 -m pip install fonttools`) and run:

  make fonts

or manually:

  pyftsubset /usr/share/fonts/croscore/Arimo-Regular.ttf \
    --unicodes='U+0020-00FF,U+20AC,U+2013-2014,U+2018-2019,U+201C-201D,U+2022,U+2026,U+00A0' \
    --layout-features='' --output-file=fonts/sans.ttf

The emoji subset is regenerated from a monochrome Noto Emoji TTF (for
example the Google Fonts `Noto Emoji` regular face) with:

  pyftsubset NotoEmoji.ttf --unicodes-file=fonts/emoji-unicodes.txt \
    --layout-features='' --output-file=fonts/emoji.ttf

The checked-in files are the canonical build inputs; a normal `make` does not
need fonttools or the original system fonts.  Do not edit the generated TTFs
by hand.
