OS Manuals

/opt/chainguard/gftools/bin/gftools-avar2-to-avar1

Google Fonts Tools: build, fix, check and package fonts for the Google Fonts library

From gftools 0.10.8-r0 (os), captured 2026-11-05 by running gftools-avar2-to-avar1 --help (exit 0). permalink

usage: gftools-avar2-to-avar1 [-h] [-m MAPPING] [-o OUT] [--tolerance TOLERANCE]
                              [--max-rounds MAX_ROUNDS] [--max-masters MAX_MASTERS]
                              [--samples SAMPLES] [--cross-samples CROSS_SAMPLES] [--axes AXES]
                              [--grid GRID] [--grid-cuts GRID_CUTS] [--refine-at LOC]
                              [--refine-crossings] [--crossing-min CROSSING_MIN]
                              [--max-refine MAX_REFINE] [--no-refine-guards] [--no-verify]
                              font_path

Flatten an avar2 variable font into an avar1 variable font.

positional arguments:
  font_path             Path to the variable font file

options:
  -h, --help            show this help message and exit
  -m, --mapping MAPPING
                        Path to avar1 yaml mapping
  -o, --out OUT
  --tolerance TOLERANCE
                        Max acceptable outline error in font units; refine by inserting knots and
                        rebuilding until met (default: report only, no refinement)
  --max-rounds MAX_ROUNDS
                        Max refinement rounds when --tolerance is given (default: 5)
  --max-masters MAX_MASTERS
                        Abort if more than this many masters would be needed (default: 300)
  --samples SAMPLES     Max cell midpoints to verify per round (default: 64)
  --cross-samples CROSS_SAMPLES
                        Random cross-group locations to verify (default: 8)
  --axes AXES           Comma-separated axis tags to keep in the output font; the rest are pinned
                        at their defaults (default: keep all axes)
  --grid GRID           Comma-separated axis tags; add masters at the full tensor product of these
                        axes' knots for better accuracy between them. A tag may carry a master
                        count, tag:N, to use exactly N knots on that axis (always the default and
                        extremes; fewer than the font has picks evenly from its knots, more
                        bisects the largest gaps), or a slash list of user positions,
                        tag:300/400/700, to put masters exactly there (default and extremes are
                        added if missing). E.g. --grid opsz:3,wdth:5,wght:9 gives 135 grid masters
  --grid-cuts GRID_CUTS
                        With --grid: also insert this many evenly spaced masters between adjacent
                        knots on each grid axis given without a count (default: 0)
  --refine-at LOC       Refine the built font at this location, given in user coordinates of the
                        output font, e.g. wght=352,wdth=25,opsz=9 (repeatable). A local master
                        with an explicit tent is appended, exact there and unchanged outside the
                        surrounding cells
  --refine-crossings    With --grid: refine wherever an output axis crosses its default or an
                        intermediate master between two grid knots, since gvar changes slope
                        there. A parametric font can have hundreds; see --max-refine
  --crossing-min CROSSING_MIN
                        Minimum normalized travel of the output axis on both sides of a crossing
                        for it to be refined (default: 0.1)
  --max-refine MAX_REFINE
                        Refine at most this many locations, strongest crossings first (default: no
                        limit)
  --no-refine-guards    Do not add guard masters at the neighbouring knots of axes a refinement
                        location sits at the default of; the correction then applies along the
                        whole of those axes
  --no-verify           Skip comparing the output against the original
Options (17)
OptionDescriptionSource
-h, --helpshow this help message and exithelp
-m, --mapping MAPPINGPath to avar1 yaml mappinghelp
-o, --out OUThelp
--tolerance TOLERANCEMax acceptable outline error in font units;help
--max-rounds MAX_ROUNDSMax refinement rounds when --tolerance is given (default: 5)help
--max-masters MAX_MASTERSAbort if more than this many masters would be needed (default: 300)help
--samples SAMPLESMax cell midpoints to verify per round (default: 64)help
--cross-samples CROSS_SAMPLESRandom cross-group locations to verify (default: 8)help
--axes AXESComma-separated axis tags to keep in the output font;help
--grid GRIDComma-separated axis tags;help
--grid-cuts GRID_CUTSWith --grid: also insert this many evenly spaced masters between adjacent knots on each grid axis given without a count (default: 0)help
--refine-at LOCRefine the built font at this location, given in user coordinates of the output font, e.g. wght=352,wdth=25,opsz=9 (repeatable).help
--refine-crossingsWith --grid: refine wherever an output axis crosses its default or an intermediate master between two grid knots, since gvar changes slope there.help
--crossing-min CROSSING_MINMinimum normalized travel of the output axis on both sides of a crossing for it to be refined (default: 0.1)help
--max-refine MAX_REFINERefine at most this many locations, strongest crossings first (default: no limit)help
--no-refine-guardsDo not add guard masters at the neighbouring knots of axes a refinement location sits at the default of;help
--no-verifySkip comparing the output against the originalhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.