mirror of
https://github.com/tangerineturtle1/NX2navi.git
synced 2026-11-16 09:39:58 -04:00
The launcher's home screen has a Customize Launcher row. Color Scheme steps through six schemes (Kokiri Forest, the colours so far, Death Mountain, Zora's Domain, Gerudo Valley, Temple of Time and Shadow Temple): each is the first scheme with its woods, accents, backdrop and glow turned to other hues, so all keep the same light and dark steps and the same text. Background takes a picture file, cuts it to the window's shape and keeps a fitted copy in data/background.npy; Background Dimming darkens it and the panels turn a little see-through over it. Animations (on by default) make the cursor glide between rows, a new screen slide in, sparks drift over the backdrop and Navi bob in the title band; they move by the time that passed and stand still while the window is hidden. Sounds are short chimes made from sine tones, off until the player picks a loudness. Redrawing in another scheme takes about a third of a second: the blurred masks and the noise, which no colour changes, are kept, and compositing onto a solid picture is a plain mix. The selftest's screen capture passed window handles as plain ints, which failed for a handle above 2^31 and left some screens without their picture; its calls are typed now. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
219 lines
9.5 KiB
Python
219 lines
9.5 KiB
Python
"""The player's own background picture (Customize Launcher): read a picture file into a numpy array, fit it to the
|
|
window's shape and keep that copy in data/background.npy, so the launcher shows it without the file it came from.
|
|
|
|
Pillow reads the file where the launcher's Python has it (a release's does: tools/requirements-launcher.txt), turned
|
|
the way its EXIF data says. Without Pillow (a checkout's Python may lack it), GDI+ reads it on Windows (PNG, JPEG,
|
|
BMP, GIF, TIFF) and Tk elsewhere (PNG, GIF; the pixels come over as a PPM file). The kept copy is 8-bit RGB at
|
|
KEEP_W x KEEP_H, 1.6 times the window's logical size: enough for a display scaled to 200 %, and five megabytes on
|
|
disk.
|
|
"""
|
|
import ctypes
|
|
import os
|
|
import tempfile
|
|
from pathlib import Path
|
|
|
|
import numpy as np
|
|
|
|
KEEP_W, KEEP_H = 1600, 1024 # the window's 1000 x 640 times 1.6
|
|
MAX_SIDE, MAX_PIXELS = 16384, 120_000_000
|
|
try:
|
|
from PIL import Image, ImageOps
|
|
except ImportError:
|
|
Image = None
|
|
# the file types the dialog offers: what the reader in use takes (load)
|
|
TYPES = ('.png', '.jpg', '.jpeg', '.webp', '.bmp', '.gif', '.tif', '.tiff') if Image else ('.png', '.jpg', '.jpeg', '.bmp', '.gif', '.tif', '.tiff') if os.name == 'nt' else ('.png', '.gif')
|
|
|
|
|
|
class PictureError(Exception):
|
|
"""The file is no picture this PC can read; the text is for the player."""
|
|
|
|
|
|
def _too_large(path, w, h):
|
|
return PictureError(f'{Path(path).name} is {w} x {h} pixels; the background takes up to {MAX_SIDE} pixels a side '
|
|
f'and {MAX_PIXELS // 1_000_000} megapixels.')
|
|
|
|
|
|
def _load_pillow(path):
|
|
"""The picture as an H x W x 3 uint8 array, read by Pillow and turned upright (a phone's photo says in its EXIF
|
|
data which way is up)."""
|
|
try:
|
|
with Image.open(path) as im:
|
|
w, h = im.size
|
|
if not w or not h or w > MAX_SIDE or h > MAX_SIDE or w * h > MAX_PIXELS:
|
|
raise _too_large(path, w, h)
|
|
return np.asarray(ImageOps.exif_transpose(im).convert('RGB')).copy()
|
|
except PictureError:
|
|
raise
|
|
except Exception as e: # Pillow raises its own errors, OSError and SyntaxError for files it cannot read
|
|
raise PictureError(f'{Path(path).name} is not a picture the launcher can read: {e}') from None
|
|
|
|
|
|
def _load_gdiplus(path):
|
|
"""The picture as an H x W x 3 uint8 array, read by GDI+ (part of Windows)."""
|
|
from ctypes import wintypes
|
|
|
|
class StartupInput(ctypes.Structure):
|
|
_fields_ = [('GdiplusVersion', ctypes.c_uint32), ('DebugEventCallback', ctypes.c_void_p),
|
|
('SuppressBackgroundThread', wintypes.BOOL), ('SuppressExternalCodecs', wintypes.BOOL)]
|
|
|
|
class BitmapData(ctypes.Structure):
|
|
_fields_ = [('Width', ctypes.c_uint), ('Height', ctypes.c_uint), ('Stride', ctypes.c_int),
|
|
('PixelFormat', ctypes.c_int), ('Scan0', ctypes.c_void_p), ('Reserved', ctypes.c_void_p)]
|
|
|
|
g = ctypes.WinDLL('gdiplus')
|
|
vp, pvp = ctypes.c_void_p, ctypes.POINTER(ctypes.c_void_p)
|
|
g.GdiplusStartup.argtypes = [pvp, ctypes.POINTER(StartupInput), vp]
|
|
g.GdiplusShutdown.argtypes = [vp]
|
|
g.GdipCreateBitmapFromFile.argtypes = [ctypes.c_wchar_p, pvp]
|
|
g.GdipGetImageWidth.argtypes = g.GdipGetImageHeight.argtypes = [vp, ctypes.POINTER(ctypes.c_uint)]
|
|
g.GdipBitmapLockBits.argtypes = [vp, ctypes.POINTER(ctypes.c_int * 4), ctypes.c_uint, ctypes.c_int,
|
|
ctypes.POINTER(BitmapData)]
|
|
g.GdipBitmapUnlockBits.argtypes = [vp, ctypes.POINTER(BitmapData)]
|
|
g.GdipDisposeImage.argtypes = [vp]
|
|
token = vp()
|
|
if g.GdiplusStartup(ctypes.byref(token), ctypes.byref(StartupInput(1, None, 0, 0)), None):
|
|
raise PictureError('Windows could not start its picture reader (GDI+).')
|
|
bmp = vp()
|
|
try:
|
|
if g.GdipCreateBitmapFromFile(str(path), ctypes.byref(bmp)) or not bmp:
|
|
raise PictureError(f'{Path(path).name} is not a picture Windows can read (PNG, JPEG, BMP, GIF or TIFF).')
|
|
w, h = ctypes.c_uint(), ctypes.c_uint()
|
|
g.GdipGetImageWidth(bmp, ctypes.byref(w))
|
|
g.GdipGetImageHeight(bmp, ctypes.byref(h))
|
|
w, h = w.value, h.value
|
|
if not w or not h or w > MAX_SIDE or h > MAX_SIDE or w * h > MAX_PIXELS:
|
|
raise _too_large(path, w, h)
|
|
data = BitmapData()
|
|
rect = (ctypes.c_int * 4)(0, 0, w, h)
|
|
# ImageLockModeRead, PixelFormat32bppARGB: GDI+ converts whatever the file holds
|
|
if g.GdipBitmapLockBits(bmp, ctypes.byref(rect), 1, 0x26200A, ctypes.byref(data)) or not data.Scan0:
|
|
raise PictureError(f'{Path(path).name} could not be decoded.')
|
|
try:
|
|
stride = abs(data.Stride)
|
|
raw = np.frombuffer(ctypes.string_at(data.Scan0, stride * h), dtype=np.uint8).reshape(h, stride)
|
|
bgra = raw[:, :w * 4].reshape(h, w, 4)
|
|
if data.Stride < 0: # bottom-up rows
|
|
bgra = bgra[::-1]
|
|
return bgra[..., [2, 1, 0]].copy()
|
|
finally:
|
|
g.GdipBitmapUnlockBits(bmp, ctypes.byref(data))
|
|
finally:
|
|
if bmp:
|
|
g.GdipDisposeImage(bmp)
|
|
g.GdiplusShutdown(token)
|
|
|
|
|
|
def read_ppm(data):
|
|
"""A binary PPM (P6, 8 bits a channel) as an H x W x 3 uint8 array."""
|
|
fields, pos = [], 0
|
|
while len(fields) < 4: # magic, width, height, maximum: separated by white space, comments from # to line end
|
|
while data[pos:pos + 1].isspace():
|
|
pos += 1
|
|
if data[pos:pos + 1] == b'#':
|
|
pos = data.index(b'\n', pos) + 1
|
|
continue
|
|
end = pos
|
|
while end < len(data) and not data[end:end + 1].isspace():
|
|
end += 1
|
|
fields.append(data[pos:end])
|
|
pos = end
|
|
if fields[0] != b'P6' or int(fields[3]) != 255:
|
|
raise PictureError('not an 8-bit binary PPM')
|
|
w, h = int(fields[1]), int(fields[2])
|
|
return np.frombuffer(data, dtype=np.uint8, count=w * h * 3, offset=pos + 1).reshape(h, w, 3).copy()
|
|
|
|
|
|
def _load_tk(path, master):
|
|
"""The picture read by Tk (PNG, GIF) and written out as a PPM, which is three bytes a pixel after a short header."""
|
|
import tkinter as tk
|
|
try:
|
|
photo = tk.PhotoImage(master=master, file=str(path))
|
|
except tk.TclError:
|
|
raise PictureError(f'{Path(path).name} is not a PNG or GIF picture.') from None
|
|
w, h = photo.width(), photo.height()
|
|
if not w or not h or w > MAX_SIDE or h > MAX_SIDE or w * h > MAX_PIXELS:
|
|
raise _too_large(path, w, h)
|
|
fd, tmp = tempfile.mkstemp(suffix='.ppm')
|
|
os.close(fd)
|
|
try:
|
|
photo.write(tmp, format='ppm')
|
|
return read_ppm(Path(tmp).read_bytes())
|
|
finally:
|
|
os.unlink(tmp)
|
|
|
|
|
|
def load(path, master=None):
|
|
"""The picture file as an H x W x 3 uint8 array. master: a Tk window, needed where Tk reads the file."""
|
|
if not Path(path).is_file():
|
|
raise PictureError(f'{path} is not there.')
|
|
if Image:
|
|
return _load_pillow(path)
|
|
if os.name == 'nt':
|
|
try:
|
|
return _load_gdiplus(path)
|
|
except OSError as e: # no gdiplus.dll: Tk's own reader
|
|
if master is None:
|
|
raise PictureError(f'{Path(path).name} could not be read: {e}') from None
|
|
return _load_tk(path, master)
|
|
|
|
|
|
def resize(img, w, h):
|
|
"""img (H x W x 3) at w x h: whole pixels averaged first where it shrinks to less than half, then a bilinear
|
|
interpolation. Returns float32 when it interpolates."""
|
|
H, W = img.shape[:2]
|
|
k = min(H // h, W // w)
|
|
if k >= 2: # average k x k blocks, so a much larger picture does not alias
|
|
img = img[:H // k * k, :W // k * k].reshape(H // k, k, W // k, k, 3).mean(axis=(1, 3), dtype=np.float32)
|
|
H, W = img.shape[:2]
|
|
if (H, W) == (h, w):
|
|
return img
|
|
ys = (np.arange(h, dtype=np.float32) + 0.5) * H / h - 0.5
|
|
xs = (np.arange(w, dtype=np.float32) + 0.5) * W / w - 0.5
|
|
y0 = np.clip(np.floor(ys).astype(int), 0, H - 1)
|
|
x0 = np.clip(np.floor(xs).astype(int), 0, W - 1)
|
|
y1, x1 = np.minimum(y0 + 1, H - 1), np.minimum(x0 + 1, W - 1)
|
|
fy = np.clip(ys - y0, 0, 1)[:, None, None]
|
|
fx = np.clip(xs - x0, 0, 1)[None, :, None]
|
|
a = img.astype(np.float32)
|
|
top = a[y0][:, x0] * (1 - fx) + a[y0][:, x1] * fx
|
|
bot = a[y1][:, x0] * (1 - fx) + a[y1][:, x1] * fx
|
|
return top * (1 - fy) + bot * fy
|
|
|
|
|
|
def cover(img, w, h):
|
|
"""img cut to the shape w : h around its middle and resized to w x h, so it fills the window with nothing
|
|
stretched; uint8."""
|
|
H, W = img.shape[:2]
|
|
if W * h > H * w: # wider than the window: cut the sides
|
|
cw = max(1, round(H * w / h))
|
|
x = (W - cw) // 2
|
|
img = img[:, x:x + cw]
|
|
else: # taller: cut top and bottom
|
|
ch = max(1, round(W * h / w))
|
|
y = (H - ch) // 2
|
|
img = img[y:y + ch]
|
|
out = resize(img, w, h)
|
|
return np.clip(np.rint(out), 0, 255).astype(np.uint8)
|
|
|
|
|
|
def keep(path, store, master=None):
|
|
"""Reads the picture at path, fits it to the window's shape and writes it to store (data/background.npy)."""
|
|
fitted = cover(load(path, master), KEEP_W, KEEP_H)
|
|
store = Path(store)
|
|
tmp = store.with_name(store.name + '.tmp')
|
|
with open(tmp, 'wb') as f:
|
|
np.save(f, fitted, allow_pickle=False)
|
|
os.replace(tmp, store)
|
|
return fitted
|
|
|
|
|
|
def kept(store, w, h):
|
|
"""The kept background at w x h as float32 in 0..1, or None when there is none (or it is not what keep wrote)."""
|
|
try:
|
|
a = np.load(store, allow_pickle=False)
|
|
except (OSError, ValueError):
|
|
return None
|
|
if a.dtype != np.uint8 or a.ndim != 3 or a.shape[2] != 3 or a.shape[0] < 8 or a.shape[1] < 8:
|
|
return None
|
|
return np.clip(resize(a, w, h).astype(np.float32) / 255.0, 0, 1)
|