fonttools 4.60.2__cp311-cp311-win32.whl

fontTools/pens/svgPathPen.py

@@ -0,0 +1,310 @@
+from typing import Callable
+from fontTools.pens.basePen import BasePen
+
+
+def pointToString(pt, ntos=str):
+    return " ".join(ntos(i) for i in pt)
+
+
+class SVGPathPen(BasePen):
+    """Pen to draw SVG path d commands.
+
+    Args:
+        glyphSet: a dictionary of drawable glyph objects keyed by name
+            used to resolve component references in composite glyphs.
+        ntos: a callable that takes a number and returns a string, to
+            customize how numbers are formatted (default: str).
+
+    :Example:
+        .. code-block::
+
+            >>> pen = SVGPathPen(None)
+            >>> pen.moveTo((0, 0))
+            >>> pen.lineTo((1, 1))
+            >>> pen.curveTo((2, 2), (3, 3), (4, 4))
+            >>> pen.closePath()
+            >>> pen.getCommands()
+            'M0 0 1 1C2 2 3 3 4 4Z'
+
+    Note:
+        Fonts have a coordinate system where Y grows up, whereas in SVG,
+        Y grows down.  As such, rendering path data from this pen in
+        SVG typically results in upside-down glyphs.  You can fix this
+        by wrapping the data from this pen in an SVG group element with
+        transform, or wrap this pen in a transform pen.  For example:
+        .. code-block:: python
+
+            spen = svgPathPen.SVGPathPen(glyphset)
+            pen= TransformPen(spen , (1, 0, 0, -1, 0, 0))
+            glyphset[glyphname].draw(pen)
+            print(tpen.getCommands())
+    """
+
+    def __init__(self, glyphSet, ntos: Callable[[float], str] = str):
+        BasePen.__init__(self, glyphSet)
+        self._commands = []
+        self._lastCommand = None
+        self._lastX = None
+        self._lastY = None
+        self._ntos = ntos
+
+    def _handleAnchor(self):
+        """
+        >>> pen = SVGPathPen(None)
+        >>> pen.moveTo((0, 0))
+        >>> pen.moveTo((10, 10))
+        >>> pen._commands
+        ['M10 10']
+        """
+        if self._lastCommand == "M":
+            self._commands.pop(-1)
+
+    def _moveTo(self, pt):
+        """
+        >>> pen = SVGPathPen(None)
+        >>> pen.moveTo((0, 0))
+        >>> pen._commands
+        ['M0 0']
+
+        >>> pen = SVGPathPen(None)
+        >>> pen.moveTo((10, 0))
+        >>> pen._commands
+        ['M10 0']
+
+        >>> pen = SVGPathPen(None)
+        >>> pen.moveTo((0, 10))
+        >>> pen._commands
+        ['M0 10']
+        """
+        self._handleAnchor()
+        t = "M%s" % (pointToString(pt, self._ntos))
+        self._commands.append(t)
+        self._lastCommand = "M"
+        self._lastX, self._lastY = pt
+
+    def _lineTo(self, pt):
+        """
+        # duplicate point
+        >>> pen = SVGPathPen(None)
+        >>> pen.moveTo((10, 10))
+        >>> pen.lineTo((10, 10))
+        >>> pen._commands
+        ['M10 10']
+
+        # vertical line
+        >>> pen = SVGPathPen(None)
+        >>> pen.moveTo((10, 10))
+        >>> pen.lineTo((10, 0))
+        >>> pen._commands
+        ['M10 10', 'V0']
+
+        # horizontal line
+        >>> pen = SVGPathPen(None)
+        >>> pen.moveTo((10, 10))
+        >>> pen.lineTo((0, 10))
+        >>> pen._commands
+        ['M10 10', 'H0']
+
+        # basic
+        >>> pen = SVGPathPen(None)
+        >>> pen.lineTo((70, 80))
+        >>> pen._commands
+        ['L70 80']
+
+        # basic following a moveto
+        >>> pen = SVGPathPen(None)
+        >>> pen.moveTo((0, 0))
+        >>> pen.lineTo((10, 10))
+        >>> pen._commands
+        ['M0 0', ' 10 10']
+        """
+        x, y = pt
+        # duplicate point
+        if x == self._lastX and y == self._lastY:
+            return
+        # vertical line
+        elif x == self._lastX:
+            cmd = "V"
+            pts = self._ntos(y)
+        # horizontal line
+        elif y == self._lastY:
+            cmd = "H"
+            pts = self._ntos(x)
+        # previous was a moveto
+        elif self._lastCommand == "M":
+            cmd = None
+            pts = " " + pointToString(pt, self._ntos)
+        # basic
+        else:
+            cmd = "L"
+            pts = pointToString(pt, self._ntos)
+        # write the string
+        t = ""
+        if cmd:
+            t += cmd
+            self._lastCommand = cmd
+        t += pts
+        self._commands.append(t)
+        # store for future reference
+        self._lastX, self._lastY = pt
+
+    def _curveToOne(self, pt1, pt2, pt3):
+        """
+        >>> pen = SVGPathPen(None)
+        >>> pen.curveTo((10, 20), (30, 40), (50, 60))
+        >>> pen._commands
+        ['C10 20 30 40 50 60']
+        """
+        t = "C"
+        t += pointToString(pt1, self._ntos) + " "
+        t += pointToString(pt2, self._ntos) + " "
+        t += pointToString(pt3, self._ntos)
+        self._commands.append(t)
+        self._lastCommand = "C"
+        self._lastX, self._lastY = pt3
+
+    def _qCurveToOne(self, pt1, pt2):
+        """
+        >>> pen = SVGPathPen(None)
+        >>> pen.qCurveTo((10, 20), (30, 40))
+        >>> pen._commands
+        ['Q10 20 30 40']
+        >>> from fontTools.misc.roundTools import otRound
+        >>> pen = SVGPathPen(None, ntos=lambda v: str(otRound(v)))
+        >>> pen.qCurveTo((3, 3), (7, 5), (11, 4))
+        >>> pen._commands
+        ['Q3 3 5 4', 'Q7 5 11 4']
+        """
+        assert pt2 is not None
+        t = "Q"
+        t += pointToString(pt1, self._ntos) + " "
+        t += pointToString(pt2, self._ntos)
+        self._commands.append(t)
+        self._lastCommand = "Q"
+        self._lastX, self._lastY = pt2
+
+    def _closePath(self):
+        """
+        >>> pen = SVGPathPen(None)
+        >>> pen.closePath()
+        >>> pen._commands
+        ['Z']
+        """
+        self._commands.append("Z")
+        self._lastCommand = "Z"
+        self._lastX = self._lastY = None
+
+    def _endPath(self):
+        """
+        >>> pen = SVGPathPen(None)
+        >>> pen.endPath()
+        >>> pen._commands
+        []
+        """
+        self._lastCommand = None
+        self._lastX = self._lastY = None
+
+    def getCommands(self):
+        return "".join(self._commands)
+
+
+def main(args=None):
+    """Generate per-character SVG from font and text"""
+
+    if args is None:
+        import sys
+
+        args = sys.argv[1:]
+
+    from fontTools.ttLib import TTFont
+    import argparse
+
+    parser = argparse.ArgumentParser(
+        "fonttools pens.svgPathPen", description="Generate SVG from text"
+    )
+    parser.add_argument("font", metavar="font.ttf", help="Font file.")
+    parser.add_argument("text", metavar="text", nargs="?", help="Text string.")
+    parser.add_argument(
+        "-y",
+        metavar="<number>",
+        help="Face index into a collection to open. Zero based.",
+    )
+    parser.add_argument(
+        "--glyphs",
+        metavar="whitespace-separated list of glyph names",
+        type=str,
+        help="Glyphs to show. Exclusive with text option",
+    )
+    parser.add_argument(
+        "--variations",
+        metavar="AXIS=LOC",
+        default="",
+        help="List of space separated locations. A location consist in "
+        "the name of a variation axis, followed by '=' and a number. E.g.: "
+        "wght=700 wdth=80. The default is the location of the base master.",
+    )
+
+    options = parser.parse_args(args)
+
+    fontNumber = int(options.y) if options.y is not None else 0
+
+    font = TTFont(options.font, fontNumber=fontNumber)
+    text = options.text
+    glyphs = options.glyphs
+
+    location = {}
+    for tag_v in options.variations.split():
+        fields = tag_v.split("=")
+        tag = fields[0].strip()
+        v = float(fields[1])
+        location[tag] = v
+
+    hhea = font["hhea"]
+    ascent, descent = hhea.ascent, hhea.descent
+
+    glyphset = font.getGlyphSet(location=location)
+    cmap = font["cmap"].getBestCmap()
+
+    if glyphs is not None and text is not None:
+        raise ValueError("Options --glyphs and --text are exclusive")
+
+    if glyphs is None:
+        glyphs = " ".join(cmap[ord(u)] for u in text)
+
+    glyphs = glyphs.split()
+
+    s = ""
+    width = 0
+    for g in glyphs:
+        glyph = glyphset[g]
+
+        pen = SVGPathPen(glyphset)
+        glyph.draw(pen)
+        commands = pen.getCommands()
+
+        s += '<g transform="translate(%d %d) scale(1 -1)"><path d="%s"/></g>\n' % (
+            width,
+            ascent,
+            commands,
+        )
+
+        width += glyph.width
+
+    print('<?xml version="1.0" encoding="UTF-8"?>')
+    print(
+        '<svg width="%d" height="%d" xmlns="http://www.w3.org/2000/svg">'
+        % (width, ascent - descent)
+    )
+    print(s, end="")
+    print("</svg>")
+
+
+if __name__ == "__main__":
+    import sys
+
+    if len(sys.argv) == 1:
+        import doctest
+
+        sys.exit(doctest.testmod().failed)
+
+    sys.exit(main())

fontTools/pens/t2CharStringPen.py

@@ -0,0 +1,88 @@
+# Copyright (c) 2009 Type Supply LLC
+# Author: Tal Leming
+
+from __future__ import annotations
+
+from typing import Any, Dict, List, Tuple
+
+from fontTools.cffLib.specializer import commandsToProgram, specializeCommands
+from fontTools.misc.psCharStrings import T2CharString
+from fontTools.misc.roundTools import otRound, roundFunc
+from fontTools.pens.basePen import BasePen
+
+
+class T2CharStringPen(BasePen):
+    """Pen to draw Type 2 CharStrings.
+
+    The 'roundTolerance' argument controls the rounding of point coordinates.
+    It is defined as the maximum absolute difference between the original
+    float and the rounded integer value.
+    The default tolerance of 0.5 means that all floats are rounded to integer;
+    a value of 0 disables rounding; values in between will only round floats
+    which are close to their integral part within the tolerated range.
+    """
+
+    def __init__(
+        self,
+        width: float | None,
+        glyphSet: Dict[str, Any] | None,
+        roundTolerance: float = 0.5,
+        CFF2: bool = False,
+    ) -> None:
+        super(T2CharStringPen, self).__init__(glyphSet)
+        self.round = roundFunc(roundTolerance)
+        self._CFF2 = CFF2
+        self._width = width
+        self._commands: List[Tuple[str | bytes, List[float]]] = []
+        self._p0 = (0, 0)
+
+    def _p(self, pt: Tuple[float, float]) -> List[float]:
+        p0 = self._p0
+        pt = self._p0 = (self.round(pt[0]), self.round(pt[1]))
+        return [pt[0] - p0[0], pt[1] - p0[1]]
+
+    def _moveTo(self, pt: Tuple[float, float]) -> None:
+        self._commands.append(("rmoveto", self._p(pt)))
+
+    def _lineTo(self, pt: Tuple[float, float]) -> None:
+        self._commands.append(("rlineto", self._p(pt)))
+
+    def _curveToOne(
+        self,
+        pt1: Tuple[float, float],
+        pt2: Tuple[float, float],
+        pt3: Tuple[float, float],
+    ) -> None:
+        _p = self._p
+        self._commands.append(("rrcurveto", _p(pt1) + _p(pt2) + _p(pt3)))
+
+    def _closePath(self) -> None:
+        pass
+
+    def _endPath(self) -> None:
+        pass
+
+    def getCharString(
+        self,
+        private: Dict | None = None,
+        globalSubrs: List | None = None,
+        optimize: bool = True,
+    ) -> T2CharString:
+        commands = self._commands
+        if optimize:
+            maxstack = 48 if not self._CFF2 else 513
+            commands = specializeCommands(
+                commands, generalizeFirst=False, maxstack=maxstack
+            )
+        program = commandsToProgram(commands)
+        if self._width is not None:
+            assert (
+                not self._CFF2
+            ), "CFF2 does not allow encoding glyph width in CharString."
+            program.insert(0, otRound(self._width))
+        if not self._CFF2:
+            program.append("endchar")
+        charString = T2CharString(
+            program=program, private=private, globalSubrs=globalSubrs
+        )
+        return charString

fontTools/pens/teePen.py

@@ -0,0 +1,55 @@
+"""Pen multiplexing drawing to one or more pens."""
+
+from fontTools.pens.basePen import AbstractPen
+
+
+__all__ = ["TeePen"]
+
+
+class TeePen(AbstractPen):
+    """Pen multiplexing drawing to one or more pens.
+
+    Use either as TeePen(pen1, pen2, ...) or TeePen(iterableOfPens)."""
+
+    def __init__(self, *pens):
+        if len(pens) == 1:
+            pens = pens[0]
+        self.pens = pens
+
+    def moveTo(self, p0):
+        for pen in self.pens:
+            pen.moveTo(p0)
+
+    def lineTo(self, p1):
+        for pen in self.pens:
+            pen.lineTo(p1)
+
+    def qCurveTo(self, *points):
+        for pen in self.pens:
+            pen.qCurveTo(*points)
+
+    def curveTo(self, *points):
+        for pen in self.pens:
+            pen.curveTo(*points)
+
+    def closePath(self):
+        for pen in self.pens:
+            pen.closePath()
+
+    def endPath(self):
+        for pen in self.pens:
+            pen.endPath()
+
+    def addComponent(self, glyphName, transformation):
+        for pen in self.pens:
+            pen.addComponent(glyphName, transformation)
+
+
+if __name__ == "__main__":
+    from fontTools.pens.basePen import _TestPen
+
+    pen = TeePen(_TestPen(), _TestPen())
+    pen.moveTo((0, 0))
+    pen.lineTo((0, 100))
+    pen.curveTo((50, 75), (60, 50), (50, 25))
+    pen.closePath()

fontTools/pens/transformPen.py

@@ -0,0 +1,115 @@
+from fontTools.pens.filterPen import FilterPen, FilterPointPen
+
+
+__all__ = ["TransformPen", "TransformPointPen"]
+
+
+class TransformPen(FilterPen):
+    """Pen that transforms all coordinates using a Affine transformation,
+    and passes them to another pen.
+    """
+
+    def __init__(self, outPen, transformation):
+        """The 'outPen' argument is another pen object. It will receive the
+        transformed coordinates. The 'transformation' argument can either
+        be a six-tuple, or a fontTools.misc.transform.Transform object.
+        """
+        super(TransformPen, self).__init__(outPen)
+        if not hasattr(transformation, "transformPoint"):
+            from fontTools.misc.transform import Transform
+
+            transformation = Transform(*transformation)
+        self._transformation = transformation
+        self._transformPoint = transformation.transformPoint
+        self._stack = []
+
+    def moveTo(self, pt):
+        self._outPen.moveTo(self._transformPoint(pt))
+
+    def lineTo(self, pt):
+        self._outPen.lineTo(self._transformPoint(pt))
+
+    def curveTo(self, *points):
+        self._outPen.curveTo(*self._transformPoints(points))
+
+    def qCurveTo(self, *points):
+        if points[-1] is None:
+            points = self._transformPoints(points[:-1]) + [None]
+        else:
+            points = self._transformPoints(points)
+        self._outPen.qCurveTo(*points)
+
+    def _transformPoints(self, points):
+        transformPoint = self._transformPoint
+        return [transformPoint(pt) for pt in points]
+
+    def closePath(self):
+        self._outPen.closePath()
+
+    def endPath(self):
+        self._outPen.endPath()
+
+    def addComponent(self, glyphName, transformation):
+        transformation = self._transformation.transform(transformation)
+        self._outPen.addComponent(glyphName, transformation)
+
+
+class TransformPointPen(FilterPointPen):
+    """PointPen that transforms all coordinates using a Affine transformation,
+    and passes them to another PointPen.
+
+    For example::
+
+        >>> from fontTools.pens.recordingPen import RecordingPointPen
+        >>> rec = RecordingPointPen()
+        >>> pen = TransformPointPen(rec, (2, 0, 0, 2, -10, 5))
+        >>> v = iter(rec.value)
+        >>> pen.beginPath(identifier="contour-0")
+        >>> next(v)
+        ('beginPath', (), {'identifier': 'contour-0'})
+
+        >>> pen.addPoint((100, 100), "line")
+        >>> next(v)
+        ('addPoint', ((190, 205), 'line', False, None), {})
+
+        >>> pen.endPath()
+        >>> next(v)
+        ('endPath', (), {})
+
+        >>> pen.addComponent("a", (1, 0, 0, 1, -10, 5), identifier="component-0")
+        >>> next(v)
+        ('addComponent', ('a', <Transform [2 0 0 2 -30 15]>), {'identifier': 'component-0'})
+    """
+
+    def __init__(self, outPointPen, transformation):
+        """The 'outPointPen' argument is another point pen object.
+        It will receive the transformed coordinates.
+        The 'transformation' argument can either be a six-tuple, or a
+        fontTools.misc.transform.Transform object.
+        """
+        super().__init__(outPointPen)
+        if not hasattr(transformation, "transformPoint"):
+            from fontTools.misc.transform import Transform
+
+            transformation = Transform(*transformation)
+        self._transformation = transformation
+        self._transformPoint = transformation.transformPoint
+
+    def addPoint(self, pt, segmentType=None, smooth=False, name=None, **kwargs):
+        self._outPen.addPoint(
+            self._transformPoint(pt), segmentType, smooth, name, **kwargs
+        )
+
+    def addComponent(self, baseGlyphName, transformation, **kwargs):
+        transformation = self._transformation.transform(transformation)
+        self._outPen.addComponent(baseGlyphName, transformation, **kwargs)
+
+
+if __name__ == "__main__":
+    from fontTools.pens.basePen import _TestPen
+
+    pen = TransformPen(_TestPen(None), (2, 0, 0.5, 2, -10, 0))
+    pen.moveTo((0, 0))
+    pen.lineTo((0, 100))
+    pen.curveTo((50, 75), (60, 50), (50, 25), (0, 0))
+    pen.closePath()