classes.c16_glyph_inspector

12class TTGlyph(TypedDict):
13    """A simplified representation of a TrueType glyph for inspection purposes. This is not a full implementation of a TTGlyph but includes key properties."""
14
15    name: str
16    width: int
17    height: int | None
18    lsb: int
19    tsb: int | None
20    draw: Callable
21    recalcBounds: bool
22    glyphSet: Any  # fontTools glyph set object (private type in practice)

25def setFill(color=(0,)):
26    drawBot.fill(*color)
27    drawBot.stroke(None)

30def setStroke(width=0.5, pattern: graphics.LinePattern = "solid"):
31    DLineStyle(
32        strokeWidth=width,
33        strokeColor=(0,),
34        lineDash=5 if pattern == "dashed" else None,
35        lineCap="butt",
36        clearFill=True,
37    ).apply()

 40class ShowBeziersPen(BasePen):
 41    upscale = lambda self, value: value / self.scale
 42
 43    def __init__(
 44        self,
 45        glyphSet: TTGlyph,
 46        anchorSize: float,
 47        handleSize: float,
 48        glyphStroke: float,
 49        handleStroke: float,
 50        scale: float = 1,
 51    ):
 52        super().__init__(glyphSet)
 53        self.prevPt = None
 54        self.scale = scale
 55        self.anchorSize = anchorSize
 56        self.handleSize = handleSize
 57        self.glyphStroke = glyphStroke
 58        self.handleStroke = handleStroke
 59
 60    @property
 61    def _anchorSize(self):
 62        return self.upscale(self.anchorSize)
 63
 64    @property
 65    def _handleSize(self):
 66        return self.upscale(self.handleSize)
 67
 68    def _drawAnchor(self, pt):
 69        setFill()
 70        x, y = pt
 71        drawBot.rect(
 72            x - self._anchorSize / 2,
 73            y - self._anchorSize / 2,
 74            self._anchorSize,
 75            self._anchorSize,
 76        )
 77
 78    def _drawHandle(self, pt):
 79        setFill()
 80        x, y = pt
 81        drawBot.oval(
 82            x - self._handleSize / 2,
 83            y - self._handleSize / 2,
 84            self._handleSize,
 85            self._handleSize,
 86        )
 87
 88    def _moveTo(self, pt):
 89        self._drawAnchor(pt)
 90        self.prevPt = pt
 91
 92    def _lineTo(self, pt):
 93        self._drawAnchor(pt)
 94        self.prevPt = pt
 95
 96    def _curveToOne(self, pt1, pt2, pt3):
 97        # Handle lines
 98        setStroke(self.upscale(self.handleStroke))
 99        drawBot.line(pt1, self.prevPt)
100        drawBot.line(pt2, pt3)
101
102        [self._drawHandle(pt) for pt in [pt1, pt2]]
103        self._drawAnchor(pt3)
104        self.prevPt = pt3
105
106    # Custom method to render the glyph with both outline and bezier handles
107    def render(self, glyph: TTGlyph):
108        with drawBot.savedState():
109            drawBot.scale(self.scale)
110
111            # Draw glyph outline first
112            setStroke(self.upscale(self.glyphStroke))
113            glyphPath = drawBot.BezierPath(glyphSet=glyph)
114            glyph.draw(glyphPath)
115            drawBot.drawPath(glyphPath)
116
117            # Draw bezier handles on top
118            glyph.draw(self)

121class KGlyphInspector:
122    TTGlyph = TTGlyph  # Expose type alias as a class attribute for external use
123
124    """Inspect and draw font glyphs in DrawBot at a target point size."""
125
126    def __init__(self, fontPath: str, fontSize: int):
127        """Load a font and prepare glyph access for the requested size.
128
129        Args:
130            fontPath: Absolute path to a font file.
131            fontSize: Target drawing size in points.
132
133        Notes:
134            `self.scale` converts glyph-space units (UPM) to page-space points.
135        """
136        self.fontFile = TTFont(fontPath)
137
138        self.scale = float(fontSize / self.fontFile["head"].unitsPerEm)
139
140        self._cmap = self.fontFile.getBestCmap()
141        self._glyphSet = self.fontFile.getGlyphSet()
142
143    def getGlyphs(self, text: str) -> list[TTGlyph]:
144        """Return glyph objects for each character in a text string.
145
146        Args:
147            text: Text to convert into ordered glyphs.
148
149        Returns:
150            Glyph list in the same order as the input text.
151
152        Raises:
153            KeyError: If a character is missing from the font cmap.
154        """
155        try:
156            chars = list(text)
157            glyphNames = [self._cmap[ord(char)] for char in chars]
158            return [self._glyphSet[name] for name in glyphNames]
159        except KeyError as e:
160            logger.error(f"Character '{e.args[0]}' not found in font's cmap.")
161            raise
162
163    def calcGlyphBounds(self, glyph: TTGlyph) -> tuple[int, int, int, int]:
164        """Measure raw glyph bounds in glyph-space units.
165
166        Useful when you need geometric extents for alignment or debugging.
167        """
168        boundsPen = BoundsPen(glyph)
169        glyph.draw(boundsPen)
170        return boundsPen.bounds
171
172    def drawGlyph(self, glyph: TTGlyph):
173        """Draw a filled glyph outline using the inspector's scale."""
174        with drawBot.savedState():
175            drawBot.scale(self.scale)
176            glyphPath = drawBot.BezierPath(glyphSet=glyph)
177            glyph.draw(glyphPath)
178            drawBot.drawPath(glyphPath)
179
180    def drawGlyphBeziers(
181        self,
182        glyph: TTGlyph,
183        anchorSize: float = 5,
184        handleSize: float = 5,
185        glyphStroke: float = 1,
186        handleStroke: float = 0.5,
187    ):
188        """Draw glyph outline plus bezier anchors/handles for inspection.
189
190        Args:
191            glyph: Glyph object from `getGlyphs`.
192            anchorSize: Anchor marker size in page points.
193            handleSize: Handle marker size in page points.
194            glyphStroke: Outline stroke width in page points.
195            handleStroke: Handle line stroke width in page points.
196        """
197        beziersPen = ShowBeziersPen(
198            glyph,
199            anchorSize=anchorSize,
200            handleSize=handleSize,
201            glyphStroke=glyphStroke,
202            handleStroke=handleStroke,
203            scale=self.scale,
204        )
205        beziersPen.render(glyph)

12class TTGlyph(TypedDict):
13    """A simplified representation of a TrueType glyph for inspection purposes. This is not a full implementation of a TTGlyph but includes key properties."""
14
15    name: str
16    width: int
17    height: int | None
18    lsb: int
19    tsb: int | None
20    draw: Callable
21    recalcBounds: bool
22    glyphSet: Any  # fontTools glyph set object (private type in practice)