mirror of
https://github.com/MCKero6423/uv-k5-v3-emulator.git
synced 2026-10-02 03:15:36 +00:00
Extract LCD unpacking and PNG encoding into a module
Lifted from tools/screenshot.py so the web UI cannot drift from the CLI screenshotter. Verified unpack() is identical to the original across 200 randomised trials, and the PNG IHDR matches byte for byte. encode_png() returns bytes instead of writing a file, and drops to zlib level 6: at streaming rates the CPU saving beats the last few bytes on loopback.
This commit is contained in:
1 parent
59ca82403f
commit
1906e110f1
2 files changed
+140
No files matched your search
@@ -0,0 +1,58 @@
|
||||
#!/usr/bin/env python3
|
||||
"""LCD framebuffer decoding for the UV-K5 emulator.
|
||||
|
||||
The firmware keeps the display in gStatusLine (page 0) and gFrameBuffer
|
||||
(pages 1-7), one byte per column, 8 vertical pixels per byte, LSB at the top --
|
||||
the layout the ST7565 expects. Extracted from tools/screenshot.py so the web UI
|
||||
and the CLI screenshotter cannot drift apart.
|
||||
"""
|
||||
import struct
|
||||
import zlib
|
||||
|
||||
LCD_WIDTH = 128
|
||||
STATUS_ROWS = 1
|
||||
FRAME_ROWS = 7
|
||||
TOTAL_ROWS = STATUS_ROWS + FRAME_ROWS # 8 pages of 8 pixels = 64 lines
|
||||
LCD_HEIGHT = TOTAL_ROWS * 8
|
||||
FRAME_BYTES = FRAME_ROWS * LCD_WIDTH
|
||||
STATUS_BYTES = LCD_WIDTH
|
||||
|
||||
|
||||
def unpack(status: bytes, frame: bytes) -> list[list[int]]:
|
||||
"""Column-major, LSB-at-top bytes -> a row-major pixel grid."""
|
||||
pixels = [[0] * LCD_WIDTH for _ in range(LCD_HEIGHT)]
|
||||
for page in range(TOTAL_ROWS):
|
||||
src = status if page == 0 else frame[(page - 1) * LCD_WIDTH:page * LCD_WIDTH]
|
||||
for col in range(LCD_WIDTH):
|
||||
byte = src[col]
|
||||
for bit in range(8):
|
||||
if byte & (1 << bit):
|
||||
pixels[page * 8 + bit][col] = 1
|
||||
return pixels
|
||||
|
||||
|
||||
def encode_png(pixels, scale: int = 4) -> bytes:
|
||||
"""1-bit greyscale PNG, no third-party dependency.
|
||||
|
||||
Compression level 6 rather than 9: at streaming rates the CPU saving matters
|
||||
more than the last few bytes on loopback.
|
||||
"""
|
||||
width, height = LCD_WIDTH * scale, LCD_HEIGHT * scale
|
||||
raw = bytearray()
|
||||
for row in pixels:
|
||||
line = bytearray()
|
||||
for value in row:
|
||||
# Radio LCD is dark-on-light: 0 -> white, 1 -> black.
|
||||
line.extend([0x00 if value else 0xFF] * scale)
|
||||
for _ in range(scale):
|
||||
raw.append(0) # filter type 0
|
||||
raw.extend(line)
|
||||
|
||||
def chunk(tag: bytes, payload: bytes) -> bytes:
|
||||
return (struct.pack(">I", len(payload)) + tag + payload
|
||||
+ struct.pack(">I", zlib.crc32(tag + payload) & 0xFFFFFFFF))
|
||||
|
||||
return (b"\x89PNG\r\n\x1a\n"
|
||||
+ chunk(b"IHDR", struct.pack(">IIBBBBB", width, height, 8, 0, 0, 0, 0))
|
||||
+ chunk(b"IDAT", zlib.compress(bytes(raw), 6))
|
||||
+ chunk(b"IEND", b""))
|
||||
Reference in new issue
Block a user