Free games for graphing calculators: NumWorks, TI-Nspire CX, Casio fx-CG50 and soon TI-84 Plus CE. Balatro, Celeste, Hollow Knight, Minecraft and more.
C calculatorcalculator-gamescasiochesscrossy-roaddrive-madfx-cg50gamesgeometry-dashgraphing-calculatorndlessnumworksnumworks-appsnumworks-calculatornumworks-gamenumworks-gamestetristi-84-plus-ceti-nspire
#!/usr/bin/env python3
"""The README's pictures, all with the same rounded corners (a radius of 6% of their width; outside it they're
transparent, so they sit right on GitHub's light and dark pages).
- docs/media/readme/thumb_<id>.png: each game's thumbnail at 320 x 240 (from docs/media/thumb_<id>.png, left as it
is, or the screenshot it was made from). The games in NumPlay.nwa by default (games.json: not "xl", "default" not
false) get a blue ring.
- The README's GIFs and other pictures in docs/media (the gallery, the real-calculator clips, the launcher, NumPlay
Studio's picture): rounded where they are. Those already rounded are left alone, so it can run again any time.
Usage: tools/readme_images.py (from anywhere; needs Pillow, ImageMagick's magick and gifsicle)"""
import json
import os
import re
import subprocess
import sys
import tempfile
from PIL import Image, ImageChops, ImageDraw, ImageStat
ROOT = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..")
MEDIA = os.path.join(ROOT, "docs", "media")
OUT = os.path.join(MEDIA, "readme")
RING = (10, 132, 255, 255) # NumPlay Studio's blue
def radius(w):
return max(4, round(w * 0.06))
def mask(w, h):
m = Image.new("L", (w, h), 0)
ImageDraw.Draw(m).rounded_rectangle((0, 0, w - 1, h - 1), radius(w), fill=255)
return m
def rounded(path):
"""already rounded: its top left corner is transparent"""
im = Image.open(path).convert("RGBA")
return im.getpixel((0, 0))[3] == 0
def source(gid):
"""the thumbnail at 320 x 240: the game's own screenshot when the thumbnail is that screenshot made smaller,
else the thumbnail made twice as big"""
t = Image.open(os.path.join(MEDIA, f"thumb_{gid}.png")).convert("RGBA")
shot = os.path.join(ROOT, "games", gid, "docs", "shot.png")
if os.path.exists(shot):
s = Image.open(shot).convert("RGBA")
if s.size == (320, 240):
d = ImageChops.difference(t.convert("RGB"), s.convert("RGB").resize(t.size, Image.BOX))
if sum(ImageStat.Stat(d).mean) / 3 < 6:
return s
return t.resize((t.width * 2, t.height * 2), Image.LANCZOS)
def thumb(gid, ring):
im = source(gid)
w, h = im.size
if ring:
d = ImageDraw.Draw(im)
t = max(3, round(w / 40))
d.rounded_rectangle((0, 0, w - 1, h - 1), radius(w), outline=RING, width=t)
im.putalpha(Image.composite(im.getchannel("A"), Image.new("L", im.size, 0), mask(w, h)))
im.save(os.path.join(OUT, f"thumb_{gid}.png"), optimize=True)
def round_png(path):
src = Image.open(path)
im = src.convert("RGBA")
w, h = im.size
im.putalpha(Image.composite(im.getchannel("A"), Image.new("L", im.size, 0), mask(w, h)))
if src.mode == "P": # (a palette picture stays one: 256 colours, transparency included)
im = im.quantize(256, method=Image.Quantize.FASTOCTREE)
im.save(path, optimize=True)
def round_gif(path):
w, h = Image.open(path).size
with tempfile.TemporaryDirectory() as d:
m, a = os.path.join(d, "mask.png"), os.path.join(d, "a.gif")
mk = Image.new("RGBA", (w, h), (255, 255, 255, 0))
mk.putalpha(mask(w, h))
mk.save(m)
subprocess.run(["magick", path, "-coalesce", "null:", m, "-alpha", "set", "-compose", "DstIn",
"-layers", "composite", "-layers", "OptimizePlus", a], check=True)
subprocess.run(["gifsicle", "-O3", a, "-o", path], check=True)
def main():
os.makedirs(OUT, exist_ok=True)
games = {g["id"]: g for g in json.load(open(os.path.join(ROOT, "games", "games.json")))}
readme = open(os.path.join(ROOT, "README.md")).read()
for gid, g in games.items():
if os.path.exists(os.path.join(MEDIA, f"thumb_{gid}.png")):
thumb(gid, not g.get("xl") and g.get("default", True))
for name in sorted(set(re.findall(r'src="docs/media/((?:gallery/)?[A-Za-z0-9_.-]+\.(?:gif|png))"', readme))):
path = os.path.join(MEDIA, name)
if name.startswith("thumb_") or name == "icon.png" or not os.path.exists(path) or rounded(path):
continue
(round_gif if name.endswith(".gif") else round_png)(path)
print("rounded", name)
if __name__ == "__main__":
sys.exit(main())