Fontforge color font plugin

FontForge_plugin for color fonts

OpenType color font is the technology used for emoji chiefly, and less frequently some fun fonts. There are several protocols and their support varies browser to browser.

Fontforge supports none but with other open-source tools color fonts can be created. This plugin provides frontend to such tools.

This plugin uses these programs as backend:

• fonttools
• scour SVG optimizer
• blackrenderer converts COLR to SVG
• svglib
• nanoemoji converts SVGs to COLR

This module requires Python 3.10 or later.

Install

pip3 install fontforge_color_font

Make sure Fontforge Python module is usable

In interactive mode of Python, run:

import fontforge

If it raises ModuleNotFoundError exception, install Fontforge first. If installed, make sure the build option set that the Python module gets also installed. If already so, Python interpreter does not recognize the module path where the required module.

export PYTHONPATH=/path/to/fontforge/python/module:$PYTHONPATH

Usage

Interactive usage

As a Fontforge plugin, fontforge_color_font adds 'Color Font' submenu to 'Tools' menu which is dedicated for plugins.

• Color Font
  • Open color font...
  • Export color font...
  • Import SVG as color font glyph...
  • Export SVG color font glyph...
  • Delete SVG color font glyph

Open color font

Shows a dialog to open a color font. COLR (both COLRv0 and COLRv1) and SVG tables are supported.

If the font has both COLR and SVG tables, which one to read will be asked.

Export color font

Shows a dialog where you can set output file name and other options.

• COLR table: None, Version 0, or 1
  • Select “None” not to include the table.
  • Version 1 supports gradients while version 0 does not.
• SVG table: None, Uncompressed, or Compressed
  • Select “None” not to include the table.
• Some browsers support SVG table but other browsers support COLR table. Including both can support as many environments as possible.

Import SVG as color font glyph

Reads an SVG document and stores into glyph metadata.

This menu is available both in font view and in (spline) glyph view. In glyph view, select an SVG document. Nominal width should match with glyph advance width, nominal height with hhea ascender plus absolute value of hhea descender. In font view and if single glyph is selected, does the same thing as in glyph view. If multiple glyphs are selected, select a directory. SVG documents must be named same as glyph name except:

• uppercase letters other than code points (uniXXXX, uXXXXX, or u10XXXX): to work with case-insensitive file systems, an underscore must precede
• underscore itself: another underscore must precede for disambiguation
• same name as DOS/Windows reserved file names

For color glyph definitions, some SVG capability is prohibited. See Microsoft Typography site for details.

SVG data is stored in glyph.persistent['SVG']. If there is already non-dict glyph.persistent, it is deleted without warning.

Export SVG color font glyph

Exports SVG stored in glyph.persistent['SVG'].

This menu is available both in font view and in (spline) glyph view. Behaves similarly to “Import SVG as color font glyph” menu.

Delete SVG color font glyph

Deletes color glyph SVG.

This menu is available both in font view and in (spline) glyph view. Behaves similarly to “Import SVG as color font glyph” menu.

Hooks

This plugin installs new/open font hooks which does:

• sets font generation hooks to output color glyphs if exist
  • Currently exports with COLRv1 and SVG.
  • If font.persistent is a dict and there is VF key, won't export SVG table. This is because variable fonts do not support SVG table, but this plugin do not support variable color font.
• loads color glyph data if available
  • If you load a color font from the ordinary ‘load’ menu, COLR table is preferred over SVG .

Script usage

As a Python module, in addition to fontforge module, scripting to export variable fonts from SFD projects will be possible.

import fontforge
import fontforge_color_font

# Open color font
font = fontforge_color_font.loadColorFont('MyColorFont.sfd')
font = fontforge_color_font.loadColorFont('MyColorFont.sfd', colrPreferred=False)

# Import SVG
fontforge_color_font.loadSvg(glyph, 'glyph.svg')

# Export SVG
fontforge_color_font.exportSvg(glyph, 'glyph.svg')
fontforge_color_font.exportSvg(glyph, 'glyph.svg', lambda x: x.replace('glyph', '_glyph'))

try:
    fontforge_color_font.exportSvg(glyph, 'glyph.svg')
except NoColorGlyphError:
    pass

# Delete SVG
fontforge_color_font.deleteSvg(glyph)

# Check if color glyph table exists
result = fontforge_color_font.hasColrTable(font)
result = fontforge_color_font.hasSvgTable(font)

# Check if color glyph SVG is stored
result = fontforge_color_font.svgIsRegistered(glyph)

# Export color font
fontforge_color_font.exportColorFont(font, 'MyColorFont.ttf', colr=1, svg=0)
fontforge_color_font.exportColorFont(font, 'MyColorFont.ttf', colr=1, svg=0, flags=('no-mac-names', 'opentype'))