fonttools 4.55.4__cp313-cp313-musllinux_1_2_aarch64.whl → 4.61.1__cp313-cp313-musllinux_1_2_aarch64.whl

fontTools/varLib/avar/plan.py

@@ -0,0 +1,1004 @@
+from fontTools.ttLib import newTable
+from fontTools.ttLib.tables._f_v_a_r import Axis as fvarAxis
+from fontTools.pens.areaPen import AreaPen
+from fontTools.pens.basePen import NullPen
+from fontTools.pens.statisticsPen import StatisticsPen
+from fontTools.varLib.models import piecewiseLinearMap, normalizeValue
+from fontTools.misc.cliTools import makeOutputFileName
+import math
+import logging
+from pprint import pformat
+
+__all__ = [
+    "planWeightAxis",
+    "planWidthAxis",
+    "planSlantAxis",
+    "planOpticalSizeAxis",
+    "planAxis",
+    "sanitizeWeight",
+    "sanitizeWidth",
+    "sanitizeSlant",
+    "measureWeight",
+    "measureWidth",
+    "measureSlant",
+    "normalizeLinear",
+    "normalizeLog",
+    "normalizeDegrees",
+    "interpolateLinear",
+    "interpolateLog",
+    "processAxis",
+    "makeDesignspaceSnippet",
+    "addEmptyAvar",
+    "main",
+]
+
+log = logging.getLogger("fontTools.varLib.avar.plan")
+
+WEIGHTS = [
+    50,
+    100,
+    150,
+    200,
+    250,
+    300,
+    350,
+    400,
+    450,
+    500,
+    550,
+    600,
+    650,
+    700,
+    750,
+    800,
+    850,
+    900,
+    950,
+]
+
+WIDTHS = [
+    25.0,
+    37.5,
+    50.0,
+    62.5,
+    75.0,
+    87.5,
+    100.0,
+    112.5,
+    125.0,
+    137.5,
+    150.0,
+    162.5,
+    175.0,
+    187.5,
+    200.0,
+]
+
+SLANTS = list(math.degrees(math.atan(d / 20.0)) for d in range(-20, 21))
+
+SIZES = [
+    5,
+    6,
+    7,
+    8,
+    9,
+    10,
+    11,
+    12,
+    14,
+    18,
+    24,
+    30,
+    36,
+    48,
+    60,
+    72,
+    96,
+    120,
+    144,
+    192,
+    240,
+    288,
+]
+
+
+SAMPLES = 8
+
+
+def normalizeLinear(value, rangeMin, rangeMax):
+    """Linearly normalize value in [rangeMin, rangeMax] to [0, 1], with extrapolation."""
+    return (value - rangeMin) / (rangeMax - rangeMin)
+
+
+def interpolateLinear(t, a, b):
+    """Linear interpolation between a and b, with t typically in [0, 1]."""
+    return a + t * (b - a)
+
+
+def normalizeLog(value, rangeMin, rangeMax):
+    """Logarithmically normalize value in [rangeMin, rangeMax] to [0, 1], with extrapolation."""
+    logMin = math.log(rangeMin)
+    logMax = math.log(rangeMax)
+    return (math.log(value) - logMin) / (logMax - logMin)
+
+
+def interpolateLog(t, a, b):
+    """Logarithmic interpolation between a and b, with t typically in [0, 1]."""
+    logA = math.log(a)
+    logB = math.log(b)
+    return math.exp(logA + t * (logB - logA))
+
+
+def normalizeDegrees(value, rangeMin, rangeMax):
+    """Angularly normalize value in [rangeMin, rangeMax] to [0, 1], with extrapolation."""
+    tanMin = math.tan(math.radians(rangeMin))
+    tanMax = math.tan(math.radians(rangeMax))
+    return (math.tan(math.radians(value)) - tanMin) / (tanMax - tanMin)
+
+
+def measureWeight(glyphset, glyphs=None):
+    """Measure the perceptual average weight of the given glyphs."""
+    if isinstance(glyphs, dict):
+        frequencies = glyphs
+    else:
+        frequencies = {g: 1 for g in glyphs}
+
+    wght_sum = wdth_sum = 0
+    for glyph_name in glyphs:
+        if frequencies is not None:
+            frequency = frequencies.get(glyph_name, 0)
+            if frequency == 0:
+                continue
+        else:
+            frequency = 1
+
+        glyph = glyphset[glyph_name]
+
+        pen = AreaPen(glyphset=glyphset)
+        glyph.draw(pen)
+
+        mult = glyph.width * frequency
+        wght_sum += mult * abs(pen.value)
+        wdth_sum += mult
+
+    return wght_sum / wdth_sum
+
+
+def measureWidth(glyphset, glyphs=None):
+    """Measure the average width of the given glyphs."""
+    if isinstance(glyphs, dict):
+        frequencies = glyphs
+    else:
+        frequencies = {g: 1 for g in glyphs}
+
+    wdth_sum = 0
+    freq_sum = 0
+    for glyph_name in glyphs:
+        if frequencies is not None:
+            frequency = frequencies.get(glyph_name, 0)
+            if frequency == 0:
+                continue
+        else:
+            frequency = 1
+
+        glyph = glyphset[glyph_name]
+
+        pen = NullPen()
+        glyph.draw(pen)
+
+        wdth_sum += glyph.width * frequency
+        freq_sum += frequency
+
+    return wdth_sum / freq_sum
+
+
+def measureSlant(glyphset, glyphs=None):
+    """Measure the perceptual average slant angle of the given glyphs."""
+    if isinstance(glyphs, dict):
+        frequencies = glyphs
+    else:
+        frequencies = {g: 1 for g in glyphs}
+
+    slnt_sum = 0
+    freq_sum = 0
+    for glyph_name in glyphs:
+        if frequencies is not None:
+            frequency = frequencies.get(glyph_name, 0)
+            if frequency == 0:
+                continue
+        else:
+            frequency = 1
+
+        glyph = glyphset[glyph_name]
+
+        pen = StatisticsPen(glyphset=glyphset)
+        glyph.draw(pen)
+
+        mult = glyph.width * frequency
+        slnt_sum += mult * pen.slant
+        freq_sum += mult
+
+    return -math.degrees(math.atan(slnt_sum / freq_sum))
+
+
+def sanitizeWidth(userTriple, designTriple, pins, measurements):
+    """Sanitize the width axis limits."""
+
+    minVal, defaultVal, maxVal = (
+        measurements[designTriple[0]],
+        measurements[designTriple[1]],
+        measurements[designTriple[2]],
+    )
+
+    calculatedMinVal = userTriple[1] * (minVal / defaultVal)
+    calculatedMaxVal = userTriple[1] * (maxVal / defaultVal)
+
+    log.info("Original width axis limits: %g:%g:%g", *userTriple)
+    log.info(
+        "Calculated width axis limits: %g:%g:%g",
+        calculatedMinVal,
+        userTriple[1],
+        calculatedMaxVal,
+    )
+
+    if (
+        abs(calculatedMinVal - userTriple[0]) / userTriple[1] > 0.05
+        or abs(calculatedMaxVal - userTriple[2]) / userTriple[1] > 0.05
+    ):
+        log.warning("Calculated width axis min/max do not match user input.")
+        log.warning(
+            "  Current width axis limits: %g:%g:%g",
+            *userTriple,
+        )
+        log.warning(
+            "  Suggested width axis limits: %g:%g:%g",
+            calculatedMinVal,
+            userTriple[1],
+            calculatedMaxVal,
+        )
+
+        return False
+
+    return True
+
+
+def sanitizeWeight(userTriple, designTriple, pins, measurements):
+    """Sanitize the weight axis limits."""
+
+    if len(set(userTriple)) < 3:
+        return True
+
+    minVal, defaultVal, maxVal = (
+        measurements[designTriple[0]],
+        measurements[designTriple[1]],
+        measurements[designTriple[2]],
+    )
+
+    logMin = math.log(minVal)
+    logDefault = math.log(defaultVal)
+    logMax = math.log(maxVal)
+
+    t = (userTriple[1] - userTriple[0]) / (userTriple[2] - userTriple[0])
+    y = math.exp(logMin + t * (logMax - logMin))
+    t = (y - minVal) / (maxVal - minVal)
+    calculatedDefaultVal = userTriple[0] + t * (userTriple[2] - userTriple[0])
+
+    log.info("Original weight axis limits: %g:%g:%g", *userTriple)
+    log.info(
+        "Calculated weight axis limits: %g:%g:%g",
+        userTriple[0],
+        calculatedDefaultVal,
+        userTriple[2],
+    )
+
+    if abs(calculatedDefaultVal - userTriple[1]) / userTriple[1] > 0.05:
+        log.warning("Calculated weight axis default does not match user input.")
+
+        log.warning(
+            "  Current weight axis limits: %g:%g:%g",
+            *userTriple,
+        )
+
+        log.warning(
+            "  Suggested weight axis limits, changing default: %g:%g:%g",
+            userTriple[0],
+            calculatedDefaultVal,
+            userTriple[2],
+        )
+
+        t = (userTriple[2] - userTriple[0]) / (userTriple[1] - userTriple[0])
+        y = math.exp(logMin + t * (logDefault - logMin))
+        t = (y - minVal) / (defaultVal - minVal)
+        calculatedMaxVal = userTriple[0] + t * (userTriple[1] - userTriple[0])
+        log.warning(
+            "  Suggested weight axis limits, changing maximum: %g:%g:%g",
+            userTriple[0],
+            userTriple[1],
+            calculatedMaxVal,
+        )
+
+        t = (userTriple[0] - userTriple[2]) / (userTriple[1] - userTriple[2])
+        y = math.exp(logMax + t * (logDefault - logMax))
+        t = (y - maxVal) / (defaultVal - maxVal)
+        calculatedMinVal = userTriple[2] + t * (userTriple[1] - userTriple[2])
+        log.warning(
+            "  Suggested weight axis limits, changing minimum: %g:%g:%g",
+            calculatedMinVal,
+            userTriple[1],
+            userTriple[2],
+        )
+
+        return False
+
+    return True
+
+
+def sanitizeSlant(userTriple, designTriple, pins, measurements):
+    """Sanitize the slant axis limits."""
+
+    log.info("Original slant axis limits: %g:%g:%g", *userTriple)
+    log.info(
+        "Calculated slant axis limits: %g:%g:%g",
+        measurements[designTriple[0]],
+        measurements[designTriple[1]],
+        measurements[designTriple[2]],
+    )
+
+    if (
+        abs(measurements[designTriple[0]] - userTriple[0]) > 1
+        or abs(measurements[designTriple[1]] - userTriple[1]) > 1
+        or abs(measurements[designTriple[2]] - userTriple[2]) > 1
+    ):
+        log.warning("Calculated slant axis min/default/max do not match user input.")
+        log.warning(
+            "  Current slant axis limits: %g:%g:%g",
+            *userTriple,
+        )
+        log.warning(
+            "  Suggested slant axis limits: %g:%g:%g",
+            measurements[designTriple[0]],
+            measurements[designTriple[1]],
+            measurements[designTriple[2]],
+        )
+
+        return False
+
+    return True
+
+
+def planAxis(
+    measureFunc,
+    normalizeFunc,
+    interpolateFunc,
+    glyphSetFunc,
+    axisTag,
+    axisLimits,
+    values,
+    samples=None,
+    glyphs=None,
+    designLimits=None,
+    pins=None,
+    sanitizeFunc=None,
+):
+    """Plan an axis.
+
+    measureFunc: callable that takes a glyphset and an optional
+    list of glyphnames, and returns the glyphset-wide measurement
+    to be used for the axis.
+
+    normalizeFunc: callable that takes a measurement and a minimum
+    and maximum, and normalizes the measurement into the range 0..1,
+    possibly extrapolating too.
+
+    interpolateFunc: callable that takes a normalized t value, and a
+    minimum and maximum, and returns the interpolated value,
+    possibly extrapolating too.
+
+    glyphSetFunc: callable that takes a variations "location" dictionary,
+    and returns a glyphset.
+
+    axisTag: the axis tag string.
+
+    axisLimits: a triple of minimum, default, and maximum values for
+    the axis. Or an `fvar` Axis object.
+
+    values: a list of output values to map for this axis.
+
+    samples: the number of samples to use when sampling. Default 8.
+
+    glyphs: a list of glyph names to use when sampling. Defaults to None,
+    which will process all glyphs.
+
+    designLimits: an optional triple of minimum, default, and maximum values
+    represenging the "design" limits for the axis. If not provided, the
+    axisLimits will be used.
+
+    pins: an optional dictionary of before/after mapping entries to pin in
+    the output.
+
+    sanitizeFunc: an optional callable to call to sanitize the axis limits.
+    """
+
+    if isinstance(axisLimits, fvarAxis):
+        axisLimits = (axisLimits.minValue, axisLimits.defaultValue, axisLimits.maxValue)
+    minValue, defaultValue, maxValue = axisLimits
+
+    if samples is None:
+        samples = SAMPLES
+    if glyphs is None:
+        glyphs = glyphSetFunc({}).keys()
+    if pins is None:
+        pins = {}
+    else:
+        pins = pins.copy()
+
+    log.info(
+        "Axis limits min %g / default %g / max %g", minValue, defaultValue, maxValue
+    )
+    triple = (minValue, defaultValue, maxValue)
+
+    if designLimits is not None:
+        log.info("Axis design-limits min %g / default %g / max %g", *designLimits)
+    else:
+        designLimits = triple
+
+    if pins:
+        log.info("Pins %s", sorted(pins.items()))
+    pins.update(
+        {
+            minValue: designLimits[0],
+            defaultValue: designLimits[1],
+            maxValue: designLimits[2],
+        }
+    )
+
+    out = {}
+    outNormalized = {}
+
+    axisMeasurements = {}
+    for value in sorted({minValue, defaultValue, maxValue} | set(pins.keys())):
+        glyphset = glyphSetFunc(location={axisTag: value})
+        designValue = pins[value]
+        axisMeasurements[designValue] = measureFunc(glyphset, glyphs)
+
+    if sanitizeFunc is not None:
+        log.info("Sanitizing axis limit values for the `%s` axis.", axisTag)
+        sanitizeFunc(triple, designLimits, pins, axisMeasurements)
+
+    log.debug("Calculated average value:\n%s", pformat(axisMeasurements))
+
+    for (rangeMin, targetMin), (rangeMax, targetMax) in zip(
+        list(sorted(pins.items()))[:-1],
+        list(sorted(pins.items()))[1:],
+    ):
+        targetValues = {w for w in values if rangeMin < w < rangeMax}
+        if not targetValues:
+            continue
+
+        normalizedMin = normalizeValue(rangeMin, triple)
+        normalizedMax = normalizeValue(rangeMax, triple)
+        normalizedTargetMin = normalizeValue(targetMin, designLimits)
+        normalizedTargetMax = normalizeValue(targetMax, designLimits)
+
+        log.info("Planning target values %s.", sorted(targetValues))
+        log.info("Sampling %u points in range %g,%g.", samples, rangeMin, rangeMax)
+        valueMeasurements = axisMeasurements.copy()
+        for sample in range(1, samples + 1):
+            value = rangeMin + (rangeMax - rangeMin) * sample / (samples + 1)
+            log.debug("Sampling value %g.", value)
+            glyphset = glyphSetFunc(location={axisTag: value})
+            designValue = piecewiseLinearMap(value, pins)
+            valueMeasurements[designValue] = measureFunc(glyphset, glyphs)
+        log.debug("Sampled average value:\n%s", pformat(valueMeasurements))
+
+        measurementValue = {}
+        for value in sorted(valueMeasurements):
+            measurementValue[valueMeasurements[value]] = value
+
+        out[rangeMin] = targetMin
+        outNormalized[normalizedMin] = normalizedTargetMin
+        for value in sorted(targetValues):
+            t = normalizeFunc(value, rangeMin, rangeMax)
+            targetMeasurement = interpolateFunc(
+                t, valueMeasurements[targetMin], valueMeasurements[targetMax]
+            )
+            targetValue = piecewiseLinearMap(targetMeasurement, measurementValue)
+            log.debug("Planned mapping value %g to %g." % (value, targetValue))
+            out[value] = targetValue
+            valueNormalized = normalizedMin + (value - rangeMin) / (
+                rangeMax - rangeMin
+            ) * (normalizedMax - normalizedMin)
+            outNormalized[valueNormalized] = normalizedTargetMin + (
+                targetValue - targetMin
+            ) / (targetMax - targetMin) * (normalizedTargetMax - normalizedTargetMin)
+        out[rangeMax] = targetMax
+        outNormalized[normalizedMax] = normalizedTargetMax
+
+    log.info("Planned mapping for the `%s` axis:\n%s", axisTag, pformat(out))
+    log.info(
+        "Planned normalized mapping for the `%s` axis:\n%s",
+        axisTag,
+        pformat(outNormalized),
+    )
+
+    if all(abs(k - v) < 0.01 for k, v in outNormalized.items()):
+        log.info("Detected identity mapping for the `%s` axis. Dropping.", axisTag)
+        out = {}
+        outNormalized = {}
+
+    return out, outNormalized
+
+
+def planWeightAxis(
+    glyphSetFunc,
+    axisLimits,
+    weights=None,
+    samples=None,
+    glyphs=None,
+    designLimits=None,
+    pins=None,
+    sanitize=False,
+):
+    """Plan a weight (`wght`) axis.
+
+    weights: A list of weight values to plan for. If None, the default
+    values are used.
+
+    This function simply calls planAxis with values=weights, and the appropriate
+    arguments. See documenation for planAxis for more information.
+    """
+
+    if weights is None:
+        weights = WEIGHTS
+
+    return planAxis(
+        measureWeight,
+        normalizeLinear,
+        interpolateLog,
+        glyphSetFunc,
+        "wght",
+        axisLimits,
+        values=weights,
+        samples=samples,
+        glyphs=glyphs,
+        designLimits=designLimits,
+        pins=pins,
+        sanitizeFunc=sanitizeWeight if sanitize else None,
+    )
+
+
+def planWidthAxis(
+    glyphSetFunc,
+    axisLimits,
+    widths=None,
+    samples=None,
+    glyphs=None,
+    designLimits=None,
+    pins=None,
+    sanitize=False,
+):
+    """Plan a width (`wdth`) axis.
+
+    widths: A list of width values (percentages) to plan for. If None, the default
+    values are used.
+
+    This function simply calls planAxis with values=widths, and the appropriate
+    arguments. See documenation for planAxis for more information.
+    """
+
+    if widths is None:
+        widths = WIDTHS
+
+    return planAxis(
+        measureWidth,
+        normalizeLinear,
+        interpolateLinear,
+        glyphSetFunc,
+        "wdth",
+        axisLimits,
+        values=widths,
+        samples=samples,
+        glyphs=glyphs,
+        designLimits=designLimits,
+        pins=pins,
+        sanitizeFunc=sanitizeWidth if sanitize else None,
+    )
+
+
+def planSlantAxis(
+    glyphSetFunc,
+    axisLimits,
+    slants=None,
+    samples=None,
+    glyphs=None,
+    designLimits=None,
+    pins=None,
+    sanitize=False,
+):
+    """Plan a slant (`slnt`) axis.
+
+    slants: A list slant angles to plan for. If None, the default
+    values are used.
+
+    This function simply calls planAxis with values=slants, and the appropriate
+    arguments. See documenation for planAxis for more information.
+    """
+
+    if slants is None:
+        slants = SLANTS
+
+    return planAxis(
+        measureSlant,
+        normalizeDegrees,
+        interpolateLinear,
+        glyphSetFunc,
+        "slnt",
+        axisLimits,
+        values=slants,
+        samples=samples,
+        glyphs=glyphs,
+        designLimits=designLimits,
+        pins=pins,
+        sanitizeFunc=sanitizeSlant if sanitize else None,
+    )
+
+
+def planOpticalSizeAxis(
+    glyphSetFunc,
+    axisLimits,
+    sizes=None,
+    samples=None,
+    glyphs=None,
+    designLimits=None,
+    pins=None,
+    sanitize=False,
+):
+    """Plan a optical-size (`opsz`) axis.
+
+    sizes: A list of optical size values to plan for. If None, the default
+    values are used.
+
+    This function simply calls planAxis with values=sizes, and the appropriate
+    arguments. See documenation for planAxis for more information.
+    """
+
+    if sizes is None:
+        sizes = SIZES
+
+    return planAxis(
+        measureWeight,
+        normalizeLog,
+        interpolateLog,
+        glyphSetFunc,
+        "opsz",
+        axisLimits,
+        values=sizes,
+        samples=samples,
+        glyphs=glyphs,
+        designLimits=designLimits,
+        pins=pins,
+    )
+
+
+def makeDesignspaceSnippet(axisTag, axisName, axisLimit, mapping):
+    """Make a designspace snippet for a single axis."""
+
+    designspaceSnippet = (
+        '    <axis tag="%s" name="%s" minimum="%g" default="%g" maximum="%g"'
+        % ((axisTag, axisName) + axisLimit)
+    )
+    if mapping:
+        designspaceSnippet += ">\n"
+    else:
+        designspaceSnippet += "/>"
+
+    for key, value in mapping.items():
+        designspaceSnippet += '      <map input="%g" output="%g"/>\n' % (key, value)
+
+    if mapping:
+        designspaceSnippet += "    </axis>"
+
+    return designspaceSnippet
+
+
+def addEmptyAvar(font):
+    """Add an empty `avar` table to the font."""
+    font["avar"] = avar = newTable("avar")
+    for axis in font["fvar"].axes:
+        avar.segments[axis.axisTag] = {}
+
+
+def processAxis(
+    font,
+    planFunc,
+    axisTag,
+    axisName,
+    values,
+    samples=None,
+    glyphs=None,
+    designLimits=None,
+    pins=None,
+    sanitize=False,
+    plot=False,
+):
+    """Process a single axis."""
+
+    axisLimits = None
+    for axis in font["fvar"].axes:
+        if axis.axisTag == axisTag:
+            axisLimits = axis
+            break
+    if axisLimits is None:
+        return ""
+    axisLimits = (axisLimits.minValue, axisLimits.defaultValue, axisLimits.maxValue)
+
+    log.info("Planning %s axis.", axisName)
+
+    if "avar" in font:
+        existingMapping = font["avar"].segments[axisTag]
+        font["avar"].segments[axisTag] = {}
+    else:
+        existingMapping = None
+
+    if values is not None and isinstance(values, str):
+        values = [float(w) for w in values.split()]
+
+    if designLimits is not None and isinstance(designLimits, str):
+        designLimits = [float(d) for d in designLimits.split(":")]
+        assert (
+            len(designLimits) == 3
+            and designLimits[0] <= designLimits[1] <= designLimits[2]
+        )
+    else:
+        designLimits = None
+
+    if pins is not None and isinstance(pins, str):
+        newPins = {}
+        for pin in pins.split():
+            before, after = pin.split(":")
+            newPins[float(before)] = float(after)
+        pins = newPins
+        del newPins
+
+    mapping, mappingNormalized = planFunc(
+        font.getGlyphSet,
+        axisLimits,
+        values,
+        samples=samples,
+        glyphs=glyphs,
+        designLimits=designLimits,
+        pins=pins,
+        sanitize=sanitize,
+    )
+
+    if plot:
+        from matplotlib import pyplot
+
+        pyplot.plot(
+            sorted(mappingNormalized),
+            [mappingNormalized[k] for k in sorted(mappingNormalized)],
+        )
+        pyplot.show()
+
+    if existingMapping is not None:
+        log.info("Existing %s mapping:\n%s", axisName, pformat(existingMapping))
+
+    if mapping:
+        if "avar" not in font:
+            addEmptyAvar(font)
+        font["avar"].segments[axisTag] = mappingNormalized
+    else:
+        if "avar" in font:
+            font["avar"].segments[axisTag] = {}
+
+    designspaceSnippet = makeDesignspaceSnippet(
+        axisTag,
+        axisName,
+        axisLimits,
+        mapping,
+    )
+    return designspaceSnippet
+
+
+def main(args=None):
+    """Plan the standard axis mappings for a variable font"""
+
+    if args is None:
+        import sys
+
+        args = sys.argv[1:]
+
+    from fontTools import configLogger
+    from fontTools.ttLib import TTFont
+    import argparse
+
+    parser = argparse.ArgumentParser(
+        "fonttools varLib.avar.plan",
+        description="Plan `avar` table for variable font",
+    )
+    parser.add_argument("font", metavar="varfont.ttf", help="Variable-font file.")
+    parser.add_argument(
+        "-o",
+        "--output-file",
+        type=str,
+        help="Output font file name.",
+    )
+    parser.add_argument(
+        "--weights", type=str, help="Space-separate list of weights to generate."
+    )
+    parser.add_argument(
+        "--widths", type=str, help="Space-separate list of widths to generate."
+    )
+    parser.add_argument(
+        "--slants", type=str, help="Space-separate list of slants to generate."
+    )
+    parser.add_argument(
+        "--sizes", type=str, help="Space-separate list of optical-sizes to generate."
+    )
+    parser.add_argument("--samples", type=int, help="Number of samples.")
+    parser.add_argument(
+        "-s", "--sanitize", action="store_true", help="Sanitize axis limits"
+    )
+    parser.add_argument(
+        "-g",
+        "--glyphs",
+        type=str,
+        help="Space-separate list of glyphs to use for sampling.",
+    )
+    parser.add_argument(
+        "--weight-design-limits",
+        type=str,
+        help="min:default:max in design units for the `wght` axis.",
+    )
+    parser.add_argument(
+        "--width-design-limits",
+        type=str,
+        help="min:default:max in design units for the `wdth` axis.",
+    )
+    parser.add_argument(
+        "--slant-design-limits",
+        type=str,
+        help="min:default:max in design units for the `slnt` axis.",
+    )
+    parser.add_argument(
+        "--optical-size-design-limits",
+        type=str,
+        help="min:default:max in design units for the `opsz` axis.",
+    )
+    parser.add_argument(
+        "--weight-pins",
+        type=str,
+        help="Space-separate list of before:after pins for the `wght` axis.",
+    )
+    parser.add_argument(
+        "--width-pins",
+        type=str,
+        help="Space-separate list of before:after pins for the `wdth` axis.",
+    )
+    parser.add_argument(
+        "--slant-pins",
+        type=str,
+        help="Space-separate list of before:after pins for the `slnt` axis.",
+    )
+    parser.add_argument(
+        "--optical-size-pins",
+        type=str,
+        help="Space-separate list of before:after pins for the `opsz` axis.",
+    )
+    parser.add_argument(
+        "-p", "--plot", action="store_true", help="Plot the resulting mapping."
+    )
+
+    logging_group = parser.add_mutually_exclusive_group(required=False)
+    logging_group.add_argument(
+        "-v", "--verbose", action="store_true", help="Run more verbosely."
+    )
+    logging_group.add_argument(
+        "-q", "--quiet", action="store_true", help="Turn verbosity off."
+    )
+
+    options = parser.parse_args(args)
+
+    configLogger(
+        level=("DEBUG" if options.verbose else "WARNING" if options.quiet else "INFO")
+    )
+
+    font = TTFont(options.font)
+    if not "fvar" in font:
+        log.error("Not a variable font.")
+        return 1
+
+    if options.glyphs is not None:
+        glyphs = options.glyphs.split()
+        if ":" in options.glyphs:
+            glyphs = {}
+            for g in options.glyphs.split():
+                if ":" in g:
+                    glyph, frequency = g.split(":")
+                    glyphs[glyph] = float(frequency)
+                else:
+                    glyphs[g] = 1.0
+    else:
+        glyphs = None
+
+    designspaceSnippets = []
+
+    designspaceSnippets.append(
+        processAxis(
+            font,
+            planWeightAxis,
+            "wght",
+            "Weight",
+            values=options.weights,
+            samples=options.samples,
+            glyphs=glyphs,
+            designLimits=options.weight_design_limits,
+            pins=options.weight_pins,
+            sanitize=options.sanitize,
+            plot=options.plot,
+        )
+    )
+    designspaceSnippets.append(
+        processAxis(
+            font,
+            planWidthAxis,
+            "wdth",
+            "Width",
+            values=options.widths,
+            samples=options.samples,
+            glyphs=glyphs,
+            designLimits=options.width_design_limits,
+            pins=options.width_pins,
+            sanitize=options.sanitize,
+            plot=options.plot,
+        )
+    )
+    designspaceSnippets.append(
+        processAxis(
+            font,
+            planSlantAxis,
+            "slnt",
+            "Slant",
+            values=options.slants,
+            samples=options.samples,
+            glyphs=glyphs,
+            designLimits=options.slant_design_limits,
+            pins=options.slant_pins,
+            sanitize=options.sanitize,
+            plot=options.plot,
+        )
+    )
+    designspaceSnippets.append(
+        processAxis(
+            font,
+            planOpticalSizeAxis,
+            "opsz",
+            "OpticalSize",
+            values=options.sizes,
+            samples=options.samples,
+            glyphs=glyphs,
+            designLimits=options.optical_size_design_limits,
+            pins=options.optical_size_pins,
+            sanitize=options.sanitize,
+            plot=options.plot,
+        )
+    )
+
+    log.info("Designspace snippet:")
+    for snippet in designspaceSnippets:
+        if snippet:
+            print(snippet)
+
+    if options.output_file is None:
+        outfile = makeOutputFileName(options.font, overWrite=True, suffix=".avar")
+    else:
+        outfile = options.output_file
+    if outfile:
+        log.info("Saving %s", outfile)
+        font.save(outfile)
+
+
+if __name__ == "__main__":
+    import sys
+
+    sys.exit(main())