This command line utility and Python library merges together two UFO source format fonts into a single file. It can be used to include glyphs from one font into another font. It takes care of handling:
lib
entriesTo merge the glyphs of font-b.ufo
into font-a.ufo
and save as merged.ufo
:
$ ufomerge --output merged.ufo font-a.ufo font-b.ufo
To include particular glyphs:
$ ufomerge --output merged.ufo --glyphs alpha,beta,gamma font-a.ufo font-b.ufo
To include glyphs referencing particular Unicode codepoints:
$ ufomerge --output merged.ufo --unicodes 0x03B1,0x03B2,0x03B3 font-a.ufo font-b.ufo
Other useful command line parameters:
-G
/--glyphs-file
: Read the glyphs from a file containing one glyph per line.-U
/--codepoints-file
: Read the Unicode codepoints from a file containing one codepoint per line.-x
/--exclude-glyphs
: Stop the given glyphs from being included.-v
/--verbose
: Be noisier.What to do about existing glyphs:
--skip-existing
(the default): If a glyph from font-b
already exists in font-a
, nothing happens.--replace-existing
: If a glyph from font-b
already exists in font-a
, the new glyph replaces the old one.What do to about OpenType layout (features.fea
). Suppose there is a rule sub A B by C;
, and the incoming glyphs are A
and B
:
--subset-layout
(the default): the rule is dropped, because C
is not part of the target glyphset. The ligature stops working.--layout-closure
: C
is added to the target glyphset and merged into font-a
so the ligature continues to work.--ignore-layout
: No layout rules are copied from font-b
at all.ufomerge
provides two functions, merge_ufos
and subset_ufo
. Both take ufoLib2.Font
objects, and are documented in their docstrings.
This software is licensed under the Apache license. See LICENSE.