The console host now draws every braille cell over Terminus's dotted ones as solid 3x3 tiles, the same tiles as the PicoCalc's font build, so the map and the charts draw unbroken lines and Platform.solid_braille holds here too. Every QR code is then braille, one module a dot: the share screen fits the 14-row frame instead of being cut, a channel share with its link under it, a contact card with its link a page down. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
266 lines
12 KiB
Python
266 lines
12 KiB
Python
# SPDX-License-Identifier: Apache-2.0
|
||
"""The 6×12 bitmap font the console host draws cells in.
|
||
|
||
Terminus at 12 pixels is the base: it is the PicoCalc's base too, so the two handhelds
|
||
read alike, and at 1,356 glyphs it covers everything MeshTerm draws on this platform but a
|
||
handful of its own marks. The host is not a kernel console, so nothing caps the glyph count
|
||
at 512 — no donor slots, no folding braille away. MeshTerm's marks are drawn over the base
|
||
from the same pixel art the PicoCalc's font build uses (:data:`MARKS`), so ``★``, ``❯``,
|
||
``⚿`` and the rest look the same on both devices; and so is its braille (:data:`BRAILLE`),
|
||
solid tiles where Terminus draws the dots apart.
|
||
|
||
Terminus is licensed under the SIL Open Font License, so it is never shipped inside
|
||
MeshTerm: the host loads it from a BDF file on the machine (:func:`find_font`). On the
|
||
desktop, ``scripts/cardputer/fetch-terminus.py`` puts the two 12-pixel BDFs, with their
|
||
licence, where :func:`find_font` looks.
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
import os
|
||
from dataclasses import dataclass
|
||
from pathlib import Path
|
||
|
||
from ..core.config import default_config_dir
|
||
|
||
#: The cell, in pixels.
|
||
CELL_W = 6
|
||
CELL_H = 12
|
||
|
||
#: The file names :func:`find_font` looks for: regular, then bold.
|
||
REGULAR_BDF = "ter-u12n.bdf"
|
||
BOLD_BDF = "ter-u12b.bdf"
|
||
|
||
#: Where a font lives when ``MESHTERM_HOST_FONTS`` names no other directory.
|
||
FONT_ENV = "MESHTERM_HOST_FONTS"
|
||
|
||
|
||
def _art(rows: list[str]) -> bytes:
|
||
"""Pixel art (``#`` lit) as one byte per row, the leftmost pixel the high bit."""
|
||
return bytes(sum(0x80 >> x for x, ch in enumerate(row) if ch == "#") for row in rows)
|
||
|
||
|
||
#: MeshTerm's own marks, drawn over the base font. The same pixel art as the PicoCalc's
|
||
#: font build (``scripts/picocalc/calculinux-console-font-6x12.sh``, ``MARKS``), so a mark
|
||
#: means one picture on every handheld.
|
||
# fmt: off
|
||
MARKS: dict[int, bytes] = {
|
||
0x25CF: _art([ # BLACK CIRCLE -- node / unread
|
||
"......", "......", "..##..", ".####.", "######", "######",
|
||
"######", "######", ".####.", "..##..", "......", "......"]),
|
||
0x25C9: _art([ # FISHEYE -- sensor
|
||
"......", "......", "..##..", ".####.", "##..##", "#.##.#",
|
||
"#.##.#", "##..##", ".####.", "..##..", "......", "......"]),
|
||
0x2605: _art([ # BLACK STAR -- you / best
|
||
"......", "..##..", "..##..", "######", ".####.", "..##..",
|
||
".####.", "##..##", "#....#", "......", "......", "......"]),
|
||
0x2014: _art([ # EM DASH -- title separator, full width
|
||
"......", "......", "......", "......", "......", "######",
|
||
"######", "......", "......", "......", "......", "......"]),
|
||
0x2713: _art([ # CHECK MARK -- ok
|
||
"......", "......", "......", ".....#", "....#.", "...#..",
|
||
"#.#...", ".#....", "......", "......", "......", "......"]),
|
||
0x2717: _art([ # BALLOT X -- error
|
||
"......", "......", "......", "#....#", ".#..#.", "..##..",
|
||
"..##..", ".#..#.", "#....#", "......", "......", "......"]),
|
||
0x25B6: _art([ # RIGHT-POINTING TRIANGLE -- run / play
|
||
"......", "#.....", "##....", "###...", "####..", "#####.",
|
||
"#####.", "####..", "###...", "##....", "#.....", "......"]),
|
||
0x276F: _art([ # HEAVY RIGHT ANGLE QUOTE -- the list selection cursor
|
||
"......", "##....", ".##...", "..##..", "...##.", "....##",
|
||
"....##", "...##.", "..##..", ".##...", "##....", "......"]),
|
||
0x25B8: _art([ # SMALL RIGHT-POINTING TRIANGLE -- grabbed/reorder cursor
|
||
"......", "......", "......", ".#....", ".##...", ".###..",
|
||
".###..", ".##...", ".#....", "......", "......", "......"]),
|
||
0x2026: _art([ # HORIZONTAL ELLIPSIS -- "opens further prompts", truncation
|
||
"......", "......", "......", "......", "......", "......",
|
||
"......", "......", "#.#.#.", "#.#.#.", "......", "......"]),
|
||
0x26A0: _art([ # WARNING SIGN -- the warn status mark
|
||
"......", "..##..", ".#..#.", ".#..#.", "#....#", "#.##.#",
|
||
"#.##.#", "#....#", "#.##.#", "######", "......", "......"]),
|
||
0x232B: _art([ # ERASE TO THE LEFT -- the backspace key in footer hints
|
||
"......", "......", "......", "..####", ".#...#", ".##.##",
|
||
"#..#.#", ".##.##", ".#...#", "..####", "......", "......"]),
|
||
0x21E7: _art([ # UPWARDS WHITE ARROW -- the shift key in footer hints
|
||
"......", "......", "..##..", ".#..#.", "#....#", "##..##",
|
||
".#..#.", ".#..#.", ".#..#.", ".####.", "......", "......"]),
|
||
0x2699: _art([ # GEAR -- parameter/config
|
||
"......", "......", "..##..", ".####.", "######", "##..##",
|
||
"##..##", "######", ".####.", "..##..", "......", "......"]),
|
||
0x21BB: _art([ # CLOCKWISE OPEN CIRCLE ARROW -- re-read/refresh
|
||
"......", "....#.", ".#####", "#...#.", "#.....", "#.....",
|
||
"#.....", "#....#", ".####.", "......", "......", "......"]),
|
||
0x25F7: _art([ # WHITE CIRCLE UPPER RIGHT QUADRANT -- the clock face (sync/time)
|
||
"......", "......", ".####.", "#..#.#", "#..#.#", "#..###",
|
||
"#....#", "#....#", ".####.", "......", "......", "......"]),
|
||
0x2316: _art([ # POSITION INDICATOR -- the crosshair (trace/map position)
|
||
"......", "..##..", "..##..", "......", "......", "#.##.#",
|
||
"#.##.#", "......", "......", "..##..", "..##..", "......"]),
|
||
0x26BF: _art([ # SQUARED KEY (drawn as a padlock) -- private channel
|
||
"......", "......", ".####.", ".#..#.", "######", "######",
|
||
"##..##", "##..##", "######", "######", "......", "......"]),
|
||
}
|
||
# fmt: on
|
||
|
||
#: Which byte bit lights which pixel columns, and which pixel rows, for each braille dot:
|
||
#: two columns of three pixels and four rows of three, tiling the whole cell.
|
||
_BRAILLE_COLS = (0xE0, 0x1C)
|
||
_BRAILLE_ROWS = ((0, 1, 2), (3, 4, 5), (6, 7, 8), (9, 10, 11))
|
||
|
||
#: Dot bit per (column, row) within a braille cell — the Unicode standard layout.
|
||
_BRAILLE_DOTS = ((0x01, 0x02, 0x04, 0x40), (0x08, 0x10, 0x20, 0x80))
|
||
|
||
|
||
def _braille(value: int) -> bytes:
|
||
"""The braille cell whose low byte is ``value``, each dot a solid 3×3 tile."""
|
||
rows = [0] * CELL_H
|
||
for col, bits in enumerate(_BRAILLE_DOTS):
|
||
for row, bit in enumerate(bits):
|
||
if value & bit:
|
||
for y in _BRAILLE_ROWS[row]:
|
||
rows[y] |= _BRAILLE_COLS[col]
|
||
return bytes(rows)
|
||
|
||
|
||
#: Every braille cell, drawn over the base font as solid tiles with no gap between dots or
|
||
#: between neighbouring cells — the same tiles as the PicoCalc's font build
|
||
#: (``scripts/picocalc/calculinux-console-font-6x12.sh``, ``BANDS12``). MeshTerm never sets
|
||
#: braille to be read: every braille cell is pixels, a chart, the map, a QR code, and a
|
||
#: dotted one breaks every line it draws into beads.
|
||
BRAILLE: dict[int, bytes] = {0x2800 + value: _braille(value) for value in range(256)}
|
||
|
||
#: Codepoints drawn as another's glyph, as the PicoCalc's font aliases them.
|
||
ALIASES: dict[int, int] = {
|
||
0x22EF: 0x2026, # midline ellipsis -> the ellipsis mark
|
||
}
|
||
|
||
#: What a character the font has no glyph for is drawn as: a hollow box, so a gap in the
|
||
#: font is visible rather than silently blank.
|
||
MISSING = _art(
|
||
["......", "#####.", "#...#.", "#...#.", "#...#.", "#...#."]
|
||
+ ["#...#.", "#...#.", "#...#.", "#####.", "......", "......"]
|
||
)
|
||
|
||
|
||
def load_bdf(path: Path) -> dict[int, bytes]:
|
||
"""The glyphs of a BDF font sized to the 6×12 cell, by codepoint.
|
||
|
||
Each glyph is one byte per pixel row, the leftmost pixel the high bit, placed in the
|
||
cell by its bounding box against the font's ascent — so a glyph narrower or shorter
|
||
than the cell sits where the font's designer put it.
|
||
|
||
Raises:
|
||
OSError: The file can't be read.
|
||
ValueError: It isn't a BDF font.
|
||
"""
|
||
glyphs: dict[int, bytes] = {}
|
||
ascent = CELL_H - 2
|
||
encoding = -1
|
||
box = (CELL_W, CELL_H, 0, -2)
|
||
bitmap: list[int] | None = None
|
||
with path.open(encoding="latin-1") as handle:
|
||
first = handle.readline()
|
||
if not first.startswith("STARTFONT"):
|
||
raise ValueError(f"{path} is not a BDF font")
|
||
for raw in handle:
|
||
words = raw.split()
|
||
if not words:
|
||
continue
|
||
key = words[0]
|
||
if bitmap is not None:
|
||
if key == "ENDCHAR":
|
||
glyphs[encoding] = _place(bitmap, box, ascent)
|
||
bitmap = None
|
||
else:
|
||
bitmap.append(int(key, 16))
|
||
elif key == "FONT_ASCENT":
|
||
ascent = int(words[1])
|
||
elif key == "ENCODING":
|
||
encoding = int(words[1])
|
||
elif key == "BBX":
|
||
box = (int(words[1]), int(words[2]), int(words[3]), int(words[4]))
|
||
elif key == "BITMAP":
|
||
bitmap = []
|
||
glyphs.pop(-1, None)
|
||
return glyphs
|
||
|
||
|
||
def _place(bitmap: list[int], box: tuple[int, int, int, int], ascent: int) -> bytes:
|
||
"""One glyph's BDF rows, set into the 6×12 cell."""
|
||
width, height, x_off, y_off = box
|
||
row_bits = max(8, (width + 7) // 8 * 8)
|
||
top = ascent - (y_off + height)
|
||
rows = [0] * CELL_H
|
||
for index, bits in enumerate(bitmap[:height]):
|
||
y = top + index
|
||
if 0 <= y < CELL_H:
|
||
# Left-align the row in its byte, then shift right by the glyph's x offset.
|
||
value = bits >> (row_bits - 8) if row_bits > 8 else bits
|
||
rows[y] = (value >> max(0, x_off)) & 0xFF
|
||
return bytes(rows)
|
||
|
||
|
||
@dataclass(frozen=True, slots=True)
|
||
class Font:
|
||
"""A regular and a bold face, each a codepoint → 12-byte glyph table."""
|
||
|
||
regular: dict[int, bytes]
|
||
bold: dict[int, bytes]
|
||
|
||
def glyph(self, char: str, *, bold: bool = False) -> bytes:
|
||
"""The glyph for ``char`` (its first codepoint), or :data:`MISSING`."""
|
||
if not char:
|
||
return bytes(CELL_H)
|
||
code = ord(char[0])
|
||
code = ALIASES.get(code, code)
|
||
table = self.bold if bold else self.regular
|
||
found = table.get(code)
|
||
if found is None and bold:
|
||
found = self.regular.get(code)
|
||
return MISSING if found is None else found
|
||
|
||
def has(self, code: int) -> bool:
|
||
"""Whether the font draws codepoint ``code`` with a glyph of its own."""
|
||
return ALIASES.get(code, code) in self.regular
|
||
|
||
|
||
def build_font(regular: dict[int, bytes], bold: dict[int, bytes] | None = None) -> Font:
|
||
"""A :class:`Font` from base glyph tables, with MeshTerm's marks and braille over both.
|
||
|
||
A missing bold face reuses the regular one, emboldened by a one-pixel smear — all but
|
||
the braille, which is pixels rather than letters, so bold has no weight to add to it
|
||
and the smear would only close the seam between a cell's two columns.
|
||
"""
|
||
regular = {**regular, **MARKS, **BRAILLE}
|
||
if bold is None:
|
||
bold = {code: bytes(row | row >> 1 for row in rows) for code, rows in regular.items()}
|
||
bold.update(BRAILLE)
|
||
else:
|
||
bold = {**bold, **MARKS, **BRAILLE}
|
||
return Font(regular=regular, bold=bold)
|
||
|
||
|
||
def font_dir() -> Path:
|
||
"""Where :func:`find_font` looks: ``$MESHTERM_HOST_FONTS``, else ``fonts`` in the config dir."""
|
||
override = os.environ.get(FONT_ENV, "").strip()
|
||
return Path(override) if override else default_config_dir() / "fonts"
|
||
|
||
|
||
def find_font() -> Font:
|
||
"""Load the host font from :func:`font_dir`.
|
||
|
||
Raises:
|
||
FileNotFoundError: There is no regular face there, with how to fetch one.
|
||
"""
|
||
directory = font_dir()
|
||
regular_path = directory / REGULAR_BDF
|
||
if not regular_path.is_file():
|
||
raise FileNotFoundError(
|
||
f"no {REGULAR_BDF} in {directory} -- fetch Terminus with "
|
||
"`python scripts/cardputer/fetch-terminus.py` (or set "
|
||
f"{FONT_ENV} to a directory holding it)"
|
||
)
|
||
bold_path = directory / BOLD_BDF
|
||
bold = load_bdf(bold_path) if bold_path.is_file() else None
|
||
return build_font(load_bdf(regular_path), bold)
|