ttGlyphPen

class fontTools.pens.ttGlyphPen.TTGlyphPen(glyphSet: Dict[str, Any] | None = None, handleOverflowingTransforms: bool = True, outputImpliedClosingLine: bool = False)

Pen used for drawing to a TrueType glyph.

This pen can be used to construct or modify glyphs in a TrueType format font. After using the pen to draw, use the .glyph() method to retrieve a Glyph object representing the glyph.

addComponent(baseGlyphName: str, transformation: Tuple[float, float, float, float, float, float], identifier: str | None = None, **kwargs: Any) → None

Add a sub glyph.

addVarComponent(glyphName: str, transformation: DecomposedTransform, location: Dict[str, float]) → None

Add a VarComponent sub glyph. The ‘transformation’ argument must be a DecomposedTransform from the fontTools.misc.transform module, and the ‘location’ argument must be a dictionary mapping axis tags to their locations.

closePath() → None

Close the current sub path. You must call either pen.closePath() or pen.endPath() after each sub path.

curveTo(*points) → None

Draw a cubic bezier with an arbitrary number of control points.

The last point specified is on-curve, all others are off-curve (control) points. If the number of control points is > 2, the segment is split into multiple bezier segments. This works like this:

Let n be the number of control points (which is the number of arguments to this call minus 1). If n==2, a plain vanilla cubic bezier is drawn. If n==1, we fall back to a quadratic segment and if n==0 we draw a straight line. It gets interesting when n>2: n-1 PostScript-style cubic segments will be drawn as if it were one curve. See decomposeSuperBezierSegment().

The conversion algorithm used for n>2 is inspired by NURB splines, and is conceptually equivalent to the TrueType “implied points” principle. See also decomposeQuadraticSegment().

drawMethod = 'draw'

endPath() → None

End the current sub path, but don’t close it. You must call either pen.closePath() or pen.endPath() after each sub path.

glyph(componentFlags: int = 4, dropImpliedOnCurves: bool = False, *, round: ~typing.Callable[[float], int] = <function otRound>) → Glyph

Returns a Glyph object representing the glyph.

Parameters:

• componentFlags – Flags to use for component glyphs. (default: 0x04)

• dropImpliedOnCurves – Whether to remove implied-oncurve points. (default: False)

init() → None

lineTo(pt: Tuple[float, float]) → None

Draw a straight line from the current point to ‘pt’.

property log

moveTo(pt: Tuple[float, float]) → None

Begin a new sub path, set the current point to ‘pt’. You must end each sub path with a call to pen.closePath() or pen.endPath().

qCurveTo(*points) → None

Draw a whole string of quadratic curve segments.

The last point specified is on-curve, all others are off-curve points.

This method implements TrueType-style curves, breaking up curves using ‘implied points’: between each two consequtive off-curve points, there is one implied point exactly in the middle between them. See also decomposeQuadraticSegment().

The last argument (normally the on-curve point) may be None. This is to support contours that have NO on-curve points (a rarely seen feature of TrueType outlines).

transformPen

alias of TransformPen

class fontTools.pens.ttGlyphPen.TTGlyphPointPen(glyphSet: Dict[str, Any] | None, handleOverflowingTransforms: bool = True)

Point pen used for drawing to a TrueType glyph.

This pen can be used to construct or modify glyphs in a TrueType format font. After using the pen to draw, use the .glyph() method to retrieve a Glyph object representing the glyph.

addComponent(baseGlyphName: str, transformation: Tuple[float, float, float, float, float, float], identifier: str | None = None, **kwargs: Any) → None

Add a sub glyph.

addPoint(pt: Tuple[float, float], segmentType: str | None = None, smooth: bool = False, name: str | None = None, identifier: str | None = None, **kwargs: Any) → None

Add a point to the current sub path.

addVarComponent(glyphName: str, transformation: DecomposedTransform, location: Dict[str, float], identifier: str | None = None, **kwargs: Any) → None

Add a VarComponent sub glyph. The ‘transformation’ argument must be a DecomposedTransform from the fontTools.misc.transform module, and the ‘location’ argument must be a dictionary mapping axis tags to their locations.

beginPath(identifier: str | None = None, **kwargs: Any) → None

Start a new sub path.

drawMethod = 'drawPoints'

endPath() → None

End the current sub path.

glyph(componentFlags: int = 4, dropImpliedOnCurves: bool = False, *, round: ~typing.Callable[[float], int] = <function otRound>) → Glyph

Returns a Glyph object representing the glyph.

Parameters:

• componentFlags – Flags to use for component glyphs. (default: 0x04)

• dropImpliedOnCurves – Whether to remove implied-oncurve points. (default: False)

init() → None

property log

transformPen

alias of TransformPointPen