Multi-byte fonts: GB2312, Big5, Shift-JIS, KS C 5601, UTF-8
Font Creator output decoded (lead/trail ranges and gaps in the header, map codes = bytes as little-endian u16 or Unicode code points) and round-tripped byte for byte; from_ttf(chars=) builds them; the renderer splits text like the simulator (any byte >= 0x81 starts a pair, missing characters advance one space) -- pixel-exact for all five encodings. Intelligent glyph data is 8-byte aligned (was 4). CLI add-font --chars/--chars-file, MCP chars. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
c102157ac2
commit
0138a0ba56
11 files changed
+137
-26
No files matched your search
+26
-5
@@ -266,12 +266,12 @@ Character map: 10 bytes per character: u16 code, u8 glyph advance width, u8 extr
|
||||
left, u8 extra columns on the right (glyphs that overhang, e.g. `j`, `f`, `W`; the stored glyph is
|
||||
advance + left + right wide and drawn starting `left` px before the pen position),
|
||||
u24 glyph offset (relative to the map start), u16 glyph length. In Intelligent projects the glyph
|
||||
data starts 4-byte aligned (zero padding after the map); Basic fonts have no padding.
|
||||
data starts at a multiple of 8 from the map start (zero padding after the map); Basic fonts have no padding.
|
||||
|
||||
Glyph: mode byte (0x01 = black/white), then run-length codes over the pixels in the same order
|
||||
as pictures for the project's display direction (runs continue across rows/columns): at 90° column
|
||||
by column, bottom to top; at 0° row by row. When an Intelligent project is compiled, the Editor
|
||||
converts a 90° font to the project direction; our encoder reproduces that conversion byte for byte.
|
||||
as pictures for the project's display direction (runs continue across rows/columns): at 90° column
|
||||
by column, bottom to top; at 0° row by row. When an Intelligent project is compiled, the Editor
|
||||
converts a 90° font to the project direction; our encoder reproduces that conversion byte for byte.
|
||||
|
||||
| Code | Meaning |
|
||||
|---|---|
|
||||
@@ -286,7 +286,28 @@ converts a 90
|
||||
The Editor encodes greedily (transparent run + 1..4 ink if possible, else the 3+3-bit form, else a
|
||||
plain run); our encoder reproduces a 224-glyph Editor font byte for byte. The v3/v5 write-ups in
|
||||
github.com/hagronnestad/nextion-font-editor were a useful starting point; v6 differs (scan order,
|
||||
B/W codes `10`/`11`). **OPEN**: multi-byte encodings, the remaining unknown header bytes.
|
||||
B/W codes `10`/`11`). **OPEN**: the remaining unknown header bytes (0x1F, 0x20).
|
||||
|
||||
Multi-byte fonts (Font Creator "Specified character" range; verified for GB2312, Big5, Shift-JIS,
|
||||
KS C 5601 and UTF-8, round-trip byte-identical, rendered pixel-exact in the simulator):
|
||||
|
||||
| Header | Meaning | GB2312 | Big5 | Shift-JIS | KS C 5601 | UTF-8 |
|
||||
|---|---|---|---|---|---|---|
|
||||
| 1, 2 | end of the first trail-byte range, trail codes skipped after it | FF 00 | 7E 22 | 7E 01 | FF 00 | FF 00 |
|
||||
| 4 | encoding (main.HMI numbering) | 2 | 16 | 23 | 15 | 24 |
|
||||
| 5 | 2 = multi-byte (0 for single-byte fonts) | 2 | 2 | 2 | 2 | 2 |
|
||||
| 6 | width (0 for multi-byte) | 0 | 0 | 0 | 0 | 0 |
|
||||
| 8, 9 | lead-byte range | A1 F7 | A0 F9 | 81 EF | A1 C8 | FF FF |
|
||||
| 10, 11 | trail-byte range | A1 FE | 40 FE | 40 FC | A1 FE | 00 FF |
|
||||
| 0x1C, 0x1D | end of the first lead range, lead codes skipped | FF 00 | FF 00 | 9F 40 | FF 00 | FF 00 |
|
||||
| 0x20 | ? | 4 | 5 | 5 | 4 | 5 |
|
||||
|
||||
Map codes: double-byte encodings store the character's two bytes as a little-endian u16 (GB2312
|
||||
中 = bytes D6 D0 -> 0xD0D6); UTF-8 fonts store the Unicode code point. The map is sorted by
|
||||
code. The display splits text into characters by taking every byte >= 0x81 together with the
|
||||
next byte (not limited to header 8-9: KS C hanja leads above C8 still pair; Shift-JIS half-width
|
||||
katakana pair up as well, so they cannot be shown); a character without a glyph advances by the
|
||||
width of the space glyph.
|
||||
|
||||
## 6. Not yet covered
|
||||
|
||||
|
||||
Reference in new issue
Block a user