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