|
|
"""
|
|
|
Define all configuration options that can affect the working of fontTools
|
|
|
modules. E.g. optimization levels of varLib IUP, otlLib GPOS compression level,
|
|
|
etc. If this file gets too big, split it into smaller files per-module.
|
|
|
|
|
|
An instance of the Config class can be attached to a TTFont object, so that
|
|
|
the various modules can access their configuration options from it.
|
|
|
"""
|
|
|
|
|
|
from textwrap import dedent
|
|
|
|
|
|
from fontTools.misc.configTools import *
|
|
|
|
|
|
|
|
|
class Config(AbstractConfig):
|
|
|
options = Options()
|
|
|
|
|
|
|
|
|
OPTIONS = Config.options
|
|
|
|
|
|
|
|
|
Config.register_option(
|
|
|
name="fontTools.otlLib.optimize.gpos:COMPRESSION_LEVEL",
|
|
|
help=dedent(
|
|
|
"""\
|
|
|
GPOS Lookup type 2 (PairPos) compression level:
|
|
|
0 = do not attempt to compact PairPos lookups;
|
|
|
1 to 8 = create at most 1 to 8 new subtables for each existing
|
|
|
subtable, provided that it would yield a 50%% file size saving;
|
|
|
9 = create as many new subtables as needed to yield a file size saving.
|
|
|
Default: 0.
|
|
|
|
|
|
This compaction aims to save file size, by splitting large class
|
|
|
kerning subtables (Format 2) that contain many zero values into
|
|
|
smaller and denser subtables. It's a trade-off between the overhead
|
|
|
of several subtables versus the sparseness of one big subtable.
|
|
|
|
|
|
See the pull request: https://github.com/fonttools/fonttools/pull/2326
|
|
|
"""
|
|
|
),
|
|
|
default=0,
|
|
|
parse=int,
|
|
|
validate=lambda v: v in range(10),
|
|
|
)
|
|
|
|
|
|
Config.register_option(
|
|
|
name="fontTools.ttLib.tables.otBase:USE_HARFBUZZ_REPACKER",
|
|
|
help=dedent(
|
|
|
"""\
|
|
|
FontTools tries to use the HarfBuzz Repacker to serialize GPOS/GSUB tables
|
|
|
if the uharfbuzz python bindings are importable, otherwise falls back to its
|
|
|
slower, less efficient serializer. Set to False to always use the latter.
|
|
|
Set to True to explicitly request the HarfBuzz Repacker (will raise an
|
|
|
error if uharfbuzz cannot be imported).
|
|
|
"""
|
|
|
),
|
|
|
default=None,
|
|
|
parse=Option.parse_optional_bool,
|
|
|
validate=Option.validate_optional_bool,
|
|
|
)
|
|
|
|
|
|
Config.register_option(
|
|
|
name="fontTools.otlLib.builder:WRITE_GPOS7",
|
|
|
help=dedent(
|
|
|
"""\
|
|
|
macOS before 13.2 didn’t support GPOS LookupType 7 (non-chaining
|
|
|
ContextPos lookups), so FontTools.otlLib.builder disables a file size
|
|
|
optimisation that would use LookupType 7 instead of 8 when there is no
|
|
|
chaining (no prefix or suffix). Set to True to enable the optimization.
|
|
|
"""
|
|
|
),
|
|
|
default=False,
|
|
|
parse=Option.parse_optional_bool,
|
|
|
validate=Option.validate_optional_bool,
|
|
|
)
|
|
|
|
|
|
Config.register_option(
|
|
|
name="fontTools.ttLib:OPTIMIZE_FONT_SPEED",
|
|
|
help=dedent(
|
|
|
"""\
|
|
|
Enable optimizations that prioritize speed over file size. This
|
|
|
mainly affects how glyf table and gvar / VARC tables are compiled.
|
|
|
The produced fonts will be larger, but rendering performance will
|
|
|
be improved with HarfBuzz and other text layout engines.
|
|
|
"""
|
|
|
),
|
|
|
default=False,
|
|
|
parse=Option.parse_optional_bool,
|
|
|
validate=Option.validate_optional_bool,
|
|
|
)
|