-
Notifications
You must be signed in to change notification settings - Fork 20
/
fontio.py
124 lines (96 loc) · 3.79 KB
/
fontio.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
# SPDX-FileCopyrightText: 2020 Melissa LeBlanc-Williams for Adafruit Industries
#
# SPDX-License-Identifier: MIT
"""
`fontio`
================================================================================
fontio for Blinka
**Software and Dependencies:**
* Adafruit Blinka:
https://github.com/adafruit/Adafruit_Blinka/releases
* Author(s): Melissa LeBlanc-Williams
"""
from typing import Union, Tuple, Optional
from PIL import ImageFont
from displayio import Bitmap
try:
from typing import Protocol
except ImportError:
from typing_extensions import Protocol
__version__ = "0.0.0+auto.0"
__repo__ = "https://github.com/adafruit/Adafruit_Blinka_displayio.git"
class FontProtocol(Protocol):
"""A protocol shared by `BuiltinFont` and classes in ``adafruit_bitmap_font``"""
def get_bounding_box(self) -> Union[Tuple[int, int], Tuple[int, int, int, int]]:
"""Retrieve the maximum bounding box of any glyph in the font.
The four element version is ``(width, height, x_offset, y_offset)``.
The two element version is ``(width, height)``, in which
``x_offset`` and ``y_offset`` are assumed to be zero.
"""
def get_glyph(self, codepoint: int) -> Optional["Glyph"]:
"""Retrieve the Glyph for a given code point
If the code point is not present in the font, `None` is returned.
"""
class BuiltinFont:
"""Simulate a font built into CircuitPython"""
def __init__(self):
self._font = ImageFont.load_default()
self._generate_bitmap(0x20, 0x7E)
def _generate_bitmap(self, start_range, end_range):
char_width, char_height = self.get_bounding_box()
self._bitmap = Bitmap(
char_width * (end_range - start_range + 1), char_height, 2
)
for character in range(start_range, end_range + 1):
ascii_char = chr(character)
ascii_mask = self._font.getmask(ascii_char, mode="1")
for y in range(char_height):
for x in range(char_width):
color = ascii_mask.getpixel((x, y))
character_position = character - start_range
self._bitmap[character_position * char_width + x, y] = (
1 if color else 0
)
def get_bounding_box(self):
"""Returns the maximum bounds of all glyphs in the font in
a tuple of two values: width, height.
"""
return self._font.getsize("M")
def get_glyph(self, codepoint):
"""Returns a `fontio.Glyph` for the given codepoint or None if no glyph is available."""
if 0x20 <= codepoint <= 0x7E:
glyph_index = codepoint - 0x20
else:
return None
bounding_box = self._font.getsize(chr(codepoint))
width, height = bounding_box
return Glyph(
bitmap=self._bitmap,
tile_index=glyph_index,
width=width,
height=height,
dx=0,
dy=0,
shift_x=width,
shift_y=0,
)
@property
def bitmap(self):
"""Bitmap containing all font glyphs starting with ASCII and followed by unicode. Use
`get_glyph` in most cases. This is useful for use with `displayio.TileGrid` and
`terminalio.Terminal`.
"""
return self._bitmap
# pylint: disable=too-few-public-methods, invalid-name, too-many-arguments
class Glyph:
"""Storage of glyph info"""
def __init__(self, bitmap, tile_index, width, height, dx, dy, shift_x, shift_y):
self.bitmap = bitmap
self.width = width
self.height = height
self.dx = dx
self.dy = dy
self.shift_x = shift_x
self.shift_y = shift_y
self.tile_index = tile_index
# pylint: enable=too-few-public-methods, invalid-name, too-many-arguments