recordingPen

Pen recording operations that can be accessed or replayed.

fontTools.pens.recordingPen.replayRecording(recording, pen)[source]

Replay a recording, as produced by RecordingPen or DecomposingRecordingPen, to a pen.

Note that recording does not have to be produced by those pens. It can be any iterable of tuples of method name and tuple-of-arguments. Likewise, pen can be any objects receiving those method calls.

class fontTools.pens.recordingPen.RecordingPen[source]

Pen recording operations that can be accessed or replayed.

The recording can be accessed as pen.value; or replayed using pen.replay(otherPen).

from fontTools.ttLib import TTFont from fontTools.pens.recordingPen import RecordingPen

glyph_name = ‘dollar’ font_path = ‘MyFont.otf’

font = TTFont(font_path) glyphset = font.getGlyphSet() glyph = glyphset[glyph_name]

pen = RecordingPen() glyph.draw(pen) print(pen.value)

addComponent(glyphName, transformation)[source]
closePath()[source]
curveTo(*points)[source]
endPath()[source]
lineTo(p1)[source]
moveTo(p0)[source]
qCurveTo(*points)[source]
replay(pen)[source]
class fontTools.pens.recordingPen.DecomposingRecordingPen(glyphSet)[source]

Same as RecordingPen, except that it doesn’t keep components as references, but draws them decomposed as regular contours.

The constructor takes a single ‘glyphSet’ positional argument, a dictionary of glyph objects (i.e. with a ‘draw’ method) keyed by thir name.

>>> class SimpleGlyph(object):
...     def draw(self, pen):
...         pen.moveTo((0, 0))
...         pen.curveTo((1, 1), (2, 2), (3, 3))
...         pen.closePath()
>>> class CompositeGlyph(object):
...     def draw(self, pen):
...         pen.addComponent('a', (1, 0, 0, 1, -1, 1))
>>> glyphSet = {'a': SimpleGlyph(), 'b': CompositeGlyph()}
>>> for name, glyph in sorted(glyphSet.items()):
...     pen = DecomposingRecordingPen(glyphSet)
...     glyph.draw(pen)
...     print("{}: {}".format(name, pen.value))
a: [('moveTo', ((0, 0),)), ('curveTo', ((1, 1), (2, 2), (3, 3))), ('closePath', ())]
b: [('moveTo', ((-1, 1),)), ('curveTo', ((0, 2), (1, 3), (2, 4))), ('closePath', ())]
skipMissingComponents = False