fonttools 4.59.2__cp314-cp314-win_amd64.whl → 4.60.1__cp314-cp314-win_amd64.whl

fontTools/varLib/avar/__main__.py

@@ -0,0 +1,72 @@
+import logging
+
+log = logging.getLogger("fontTools.varLib.avar")
+
+
+def main(args=None):
+    from fontTools.ttLib import TTFont
+    from fontTools.misc.cliTools import makeOutputFileName
+    from fontTools import configLogger
+    import argparse
+    import sys
+
+    print(
+        "WARNING: This script is deprecated. Use `fonttools varLib.avar.build` "
+        "or `fonttools varLib.avar.unbuild` instead.\n",
+        file=sys.stderr,
+    )
+
+    if args is None:
+        args = sys.argv[1:]
+
+    parser = argparse.ArgumentParser(
+        "fonttools varLib.avar",
+        description="Add `avar` table from designspace file to variable font.",
+    )
+    parser.add_argument("font", metavar="varfont.ttf", help="Variable-font file.")
+    parser.add_argument(
+        "designspace",
+        metavar="family.designspace",
+        help="Designspace file.",
+        nargs="?",
+        default=None,
+    )
+    parser.add_argument(
+        "-o",
+        "--output-file",
+        type=str,
+        help="Output font file name.",
+    )
+    parser.add_argument(
+        "-v", "--verbose", action="store_true", help="Run more verbosely."
+    )
+
+    options = parser.parse_args(args)
+
+    configLogger(level=("INFO" if options.verbose else "WARNING"))
+
+    font = TTFont(options.font)
+
+    if options.designspace is None:
+        from .unbuild import unbuild
+
+        unbuild(font)
+        return 0
+
+    from .build import build
+
+    build(font, options.designspace)
+
+    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())

fontTools/varLib/avar/build.py

@@ -0,0 +1,79 @@
+from fontTools.varLib import _add_fvar, _add_avar, load_designspace
+from fontTools.ttLib import newTable
+import logging
+
+log = logging.getLogger("fontTools.varLib.avar")
+
+
+def build(font, designspace_file):
+    ds = load_designspace(designspace_file, require_sources=False)
+
+    if not "fvar" in font:
+        # if "name" not in font:
+        font["name"] = newTable("name")
+        _add_fvar(font, ds.axes, ds.instances)
+
+    axisTags = [a.axisTag for a in font["fvar"].axes]
+
+    if "avar" in font:
+        log.warning("avar table already present, overwriting.")
+        del font["avar"]
+
+    _add_avar(font, ds.axes, ds.axisMappings, axisTags)
+
+
+def main(args=None):
+    """Add `avar` table from designspace file to variable font."""
+
+    from fontTools.ttLib import TTFont
+    from fontTools.misc.cliTools import makeOutputFileName
+    from fontTools import configLogger
+    import argparse
+
+    if args is None:
+        import sys
+
+        args = sys.argv[1:]
+
+    parser = argparse.ArgumentParser(
+        "fonttools varLib.avar.build",
+        description="Add `avar` table from designspace file to variable font.",
+    )
+    parser.add_argument("font", metavar="varfont.ttf", help="Variable-font file.")
+    parser.add_argument(
+        "designspace",
+        metavar="family.designspace",
+        help="Designspace file.",
+        default=None,
+    )
+    parser.add_argument(
+        "-o",
+        "--output-file",
+        type=str,
+        help="Output font file name.",
+    )
+    parser.add_argument(
+        "-v", "--verbose", action="store_true", help="Run more verbosely."
+    )
+
+    options = parser.parse_args(args)
+
+    configLogger(level=("INFO" if options.verbose else "WARNING"))
+
+    font = TTFont(options.font)
+
+    build(font, options.designspace)
+
+    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())

fontTools/varLib/avar/map.py

@@ -0,0 +1,108 @@
+from fontTools.varLib.models import normalizeValue
+
+
+def _denormalize(v, triplet):
+    if v >= 0:
+        return triplet[1] + v * (triplet[2] - triplet[1])
+    else:
+        return triplet[1] + v * (triplet[1] - triplet[0])
+
+
+def map(
+    font, location, *, inputNormalized=False, outputNormalized=False, dropZeroes=False
+):
+    if "fvar" not in font:
+        return None
+
+    fvar = font["fvar"]
+    axes = {a.axisTag: (a.minValue, a.defaultValue, a.maxValue) for a in fvar.axes}
+
+    if not inputNormalized:
+        location = {
+            tag: normalizeValue(value, axes[tag]) for tag, value in location.items()
+        }
+
+    if "avar" in font:
+        location = font["avar"].renormalizeLocation(location, font, dropZeroes)
+
+    if not outputNormalized:
+        location = {
+            tag: _denormalize(value, axes[tag]) for tag, value in location.items()
+        }
+
+    return location
+
+
+def main(args=None):
+    """Map variation coordinates through the `avar` table."""
+
+    from fontTools.ttLib import TTFont
+    import argparse
+
+    if args is None:
+        import sys
+
+        args = sys.argv[1:]
+
+    parser = argparse.ArgumentParser(
+        "fonttools varLib.avar.map",
+        description="Map variation coordinates through the `avar` table.",
+    )
+    parser.add_argument("font", metavar="varfont.ttf", help="Variable-font file.")
+    parser.add_argument(
+        "coords",
+        metavar="[AXIS=value...]",
+        help="Coordinates to map, e.g. 'wght=700 wdth=75'.",
+        nargs="*",
+        default=None,
+    )
+    parser.add_argument(
+        "-f", action="store_true", help="Do not omit axes at default location."
+    )
+    parser.add_argument(
+        "-i", action="store_true", help="Input coordinates are normalized (-1..1)."
+    )
+    parser.add_argument(
+        "-o", action="store_true", help="Output coordinates as normalized (-1..1)."
+    )
+
+    options = parser.parse_args(args)
+
+    if not options.coords:
+        parser.error(
+            "No coordinates provided. Please specify at least one axis coordinate (e.g., wght=500)"
+        )
+
+    if options.font.endswith(".designspace"):
+        from .build import build
+
+        font = TTFont()
+        build(font, options.font)
+    else:
+        font = TTFont(options.font)
+        if "fvar" not in font:
+            parser.error(f"Font '{options.font}' does not contain an 'fvar' table.")
+
+    location = {
+        tag: float(value) for tag, value in (item.split("=") for item in options.coords)
+    }
+
+    mapped = map(
+        font,
+        location,
+        inputNormalized=options.i,
+        outputNormalized=options.o,
+        dropZeroes=not options.f,
+    )
+    assert mapped is not None
+
+    for tag in mapped:
+        v = mapped[tag]
+        v = int(v) if v == int(v) else v
+        print(f"{tag}={v:g}")
+
+
+if __name__ == "__main__":
+    import sys
+
+    sys.exit(main())