Files
Johan Sandoval 38b5213138
Mirror to Gitea / mirror (push) Skipped
Replace Openverse images, fix blank space and spacing on mobile
- Swap every photo for Unsplash photos and Pixabay stickers/clipart,
  credited in IMAGE_CREDITS.md and /credits; regenerate effect images
- Reveal animations never hide on-screen content and have a failsafe, so
  sections can no longer stay blank on phones
- Tighter section and footer spacing on mobile; drop the unlabeled status
  dot on mobile and the blog's fake loading bar
- Cover moves from the all-green poster to the board's mixed palette
- New boombox, spray can and headphones stickers
2026-10-08 19:08:34 +00:00

350 lines
14 KiB
Python

#!/usr/bin/env python3
"""
Bake print / retro effects into photos so the site gets a grungy, hand-made
look without running heavy filters on visitors' phones.
python3 tools/fx.py # regenerate everything in RECIPES
python3 tools/fx.py motorcycle # only recipes whose source matches
Sources: src/assets/photos/<name>.jpg|png Output: src/assets/fx/<name>-<effect>.webp
Needs: pip install pillow numpy
"""
import sys
from pathlib import Path
import numpy as np
from PIL import Image, ImageChops, ImageEnhance, ImageFilter, ImageOps
ROOT = Path(__file__).resolve().parent.parent
SRC = ROOT / 'src/assets/photos'
OUT = ROOT / 'src/assets/fx'
RNG = np.random.default_rng(7)
# 24-colour palette for pixel art: site palette + CTA line colours + naturals.
PALETTE = np.array([
(20, 20, 18), (58, 52, 44), (108, 75, 52), (163, 150, 122), (210, 205, 190), (243, 236, 217), (255, 255, 255),
(198, 12, 48), (249, 70, 28), (255, 150, 60), (249, 227, 0), (200, 224, 52),
(140, 198, 63), (76, 154, 42), (0, 155, 58), (15, 93, 61), (30, 60, 40),
(120, 190, 230), (0, 161, 222), (29, 63, 216), (20, 30, 80), (82, 35, 152), (226, 126, 166), (130, 40, 60),
], dtype=np.float32)
BAYER4 = (np.array([[0, 8, 2, 10], [12, 4, 14, 6], [3, 11, 1, 9], [15, 7, 13, 5]], dtype=np.float32) + 0.5) / 16 - 0.5
def load(name: str) -> Image.Image:
for ext in ('.webp', '.jpg', '.png'):
p = SRC / f'{name}{ext}'
if p.exists():
im = Image.open(p)
if im.mode in ('RGBA', 'LA', 'P'): # transparent art: flatten onto white paper
im = im.convert('RGBA')
bg = Image.new('RGBA', im.size, (255, 255, 255, 255))
return Image.alpha_composite(bg, im).convert('RGB')
return im.convert('RGB')
raise FileNotFoundError(name)
def fit(img: Image.Image, width: int) -> Image.Image:
if img.width <= width:
return img
return img.resize((width, round(img.height * width / img.width)), Image.LANCZOS)
# ---------- grunge layers ----------
def grain(img: Image.Image, amount=18) -> Image.Image:
a = np.asarray(img, dtype=np.float32)
n = RNG.normal(0, amount, a.shape[:2])[..., None]
return Image.fromarray(np.clip(a + n, 0, 255).astype(np.uint8))
def dust(img: Image.Image, specks=900, scratches=14) -> Image.Image:
a = np.asarray(img, dtype=np.float32).copy()
h, w = a.shape[:2]
ys, xs = RNG.integers(0, h, specks), RNG.integers(0, w, specks)
vals = RNG.choice([235.0, 18.0], specks, p=[0.6, 0.4])
for y, x, v in zip(ys, xs, vals):
r = int(RNG.integers(0, 2))
a[max(0, y - r):y + r + 1, max(0, x - r):x + r + 1] = v
for _ in range(scratches):
x = int(RNG.integers(0, w))
y0 = int(RNG.integers(0, h // 2))
length = int(RNG.integers(h // 6, h))
drift = RNG.normal(0, 0.15)
for i in range(length):
yy, xx = y0 + i, int(x + drift * i)
if 0 <= yy < h and 0 <= xx < w:
a[yy, xx] = a[yy, xx] * 0.4 + 235 * 0.6
return Image.fromarray(np.clip(a, 0, 255).astype(np.uint8))
def vignette(img: Image.Image, strength=0.55) -> Image.Image:
w, h = img.size
y, x = np.ogrid[-1:1:h * 1j, -1:1:w * 1j]
mask = 1 - strength * np.clip(np.sqrt(x * x + y * y) - 0.35, 0, 1) ** 1.4
a = np.asarray(img, dtype=np.float32) * mask[..., None]
return Image.fromarray(np.clip(a, 0, 255).astype(np.uint8))
def paper(img: Image.Image, tint=(243, 236, 217), mix=0.12) -> Image.Image:
tex = Image.open(SRC / 'paper-crumpled.webp').convert('L').resize(img.size)
tex = ImageOps.autocontrast(tex).convert('RGB')
out = ImageChops.multiply(img, tex)
return Image.blend(out, Image.new('RGB', img.size, tint), mix)
# ---------- looks ----------
def toon(img, levels=6, ink=2):
"""Cel shading: flatten colours, then trace dark ink outlines."""
base = img.filter(ImageFilter.MedianFilter(5)).filter(ImageFilter.MedianFilter(5))
base = ImageEnhance.Color(base).enhance(1.45)
flat = base.quantize(colors=levels * 3, method=Image.Quantize.MEDIANCUT, dither=Image.Dither.NONE).convert('RGB')
g = img.convert('L').filter(ImageFilter.GaussianBlur(1.4))
edges = g.filter(ImageFilter.FIND_EDGES)
edges = edges.point(lambda v: 255 if v > 18 else 0)
if ink > 1:
edges = edges.filter(ImageFilter.MaxFilter(ink * 2 - 1))
inkc = Image.new('RGB', img.size, (20, 18, 22))
out = Image.composite(inkc, flat, edges)
return grain(out, 10)
def pixel(img, width=128, scale=1, spread=36):
"""Pixel art: shrink and ordered-dither to the palette. Saved at true size;
the site scales it up with image-rendering: pixelated (any img named *-pixel)."""
small = img.resize((width, round(img.height * width / img.width)), Image.BOX)
small = ImageEnhance.Color(small).enhance(1.3)
a = np.asarray(small, dtype=np.float32)
h, w = a.shape[:2]
t = np.tile(BAYER4, (h // 4 + 1, w // 4 + 1))[:h, :w][..., None]
a = a + t * spread
d = ((a[:, :, None, :] - PALETTE[None, None]) ** 2).sum(-1)
q = PALETTE[d.argmin(-1)].astype(np.uint8)
out = Image.fromarray(q).resize((w * scale, h * scale), Image.NEAREST)
return out
def xerox(img):
"""Photocopy: crushed contrast, toner speckle, paper texture."""
g = ImageOps.autocontrast(img.convert('L'), cutoff=4)
g = ImageEnhance.Contrast(g).enhance(2.2)
a = np.asarray(g, dtype=np.float32)
a = a + RNG.normal(0, 28, a.shape)
a = np.where(a > 128, 238, 22).astype(np.uint8)
out = Image.fromarray(a).filter(ImageFilter.MedianFilter(3)).convert('RGB')
out = dust(out, specks=1600, scratches=6)
return paper(out, mix=0.08)
def riso(img, ink_a=(226, 60, 120), ink_b=(29, 63, 216), offset=(7, 4)):
"""Two-colour risograph with misregistration and grain."""
g = ImageOps.autocontrast(img.convert('L'), cutoff=2)
inv = ImageOps.invert(g)
a = np.asarray(inv, dtype=np.float32) / 255
paper_c = np.array((246, 239, 222), dtype=np.float32)
def layer(dens, ink):
ink = np.array(ink, dtype=np.float32)
return paper_c * (1 - dens[..., None]) + ink * dens[..., None]
dens_a = np.clip(a * 1.15 - 0.05, 0, 1)
dens_b = np.clip((a - 0.45) * 1.8, 0, 1)
la = layer(dens_a, ink_a)
lb = layer(np.roll(np.roll(dens_b, offset[1], 0), offset[0], 1), ink_b)
out = (la / 255) * (lb / 255) * 255
out = Image.fromarray(np.clip(out, 0, 255).astype(np.uint8))
return dust(grain(out, 14), specks=500, scratches=0)
def vintage(img):
"""Faded 90s print: lifted blacks, warm cast, light leak, vignette, dust."""
a = np.asarray(ImageEnhance.Color(img).enhance(0.8), dtype=np.float32)
a = a * 0.82 + 30
a[..., 0] *= 1.06
a[..., 2] *= 0.88
h, w = a.shape[:2]
y, x = np.ogrid[0:h, 0:w]
leak = np.exp(-(((x - w * 0.95) / (w * 0.35)) ** 2 + ((y - h * 0.1) / (h * 0.5)) ** 2))
a = a + leak[..., None] * np.array([110, 45, 0])
out = Image.fromarray(np.clip(a, 0, 255).astype(np.uint8))
return dust(vignette(grain(out, 16), 0.6), specks=700, scratches=10)
# ---------- poster / comic / terminal looks ----------
def _halftone_mask(density, cell=7, angle=45):
"""Return a boolean ink mask: round dots whose size follows density (0..1)."""
h, w = density.shape
y, x = np.mgrid[0:h, 0:w].astype(np.float32)
a = np.deg2rad(angle)
u = x * np.cos(a) + y * np.sin(a)
v = -x * np.sin(a) + y * np.cos(a)
fu = (u / cell) % 1 - 0.5
fv = (v / cell) % 1 - 0.5
dist = np.sqrt(fu * fu + fv * fv)
radius = np.sqrt(np.clip(density, 0, 1)) * 0.62
return dist < radius
def _ink_edges(img, thresh=22, thick=3):
g = img.convert('L').filter(ImageFilter.GaussianBlur(1.2))
e = g.filter(ImageFilter.FIND_EDGES).point(lambda v: 255 if v > thresh else 0)
if thick > 1:
e = e.filter(ImageFilter.MaxFilter(thick | 1))
return np.asarray(e) > 0
def creases(img, folds=((0.5, 'v'), (0.33, 'h'), (0.66, 'h')), strength=0.18):
"""Paper fold lines: a bright ridge next to a dark valley."""
a = np.asarray(img, dtype=np.float32).copy()
h, w = a.shape[:2]
for pos, d in folds:
if d == 'v':
c = int(w * pos)
for off, k in ((-2, 1 + strength), (-1, 1 + strength * 0.6), (1, 1 - strength), (2, 1 - strength * 0.6)):
if 0 <= c + off < w:
a[:, c + off] *= k
else:
c = int(h * pos)
for off, k in ((-2, 1 + strength), (-1, 1 + strength * 0.6), (1, 1 - strength), (2, 1 - strength * 0.6)):
if 0 <= c + off < h:
a[c + off, :] *= k
return Image.fromarray(np.clip(a, 0, 255).astype(np.uint8))
def jsr(img, ink=(46, 92, 44), paper=(226, 233, 150), cell=6, outline=True):
"""Two-tone street poster: one ink on coloured stock, halftone mid-tones,
solid shadows, ink outlines, fold creases, speckle and wear."""
g = ImageOps.autocontrast(img.convert('L'), cutoff=2)
g = ImageEnhance.Contrast(g).enhance(1.25)
g = ImageEnhance.Brightness(g).enhance(1.12)
d = 1 - np.asarray(g, dtype=np.float32) / 255
ink_mask = _halftone_mask(np.clip((d - 0.28) / 0.55, 0, 1) ** 1.2, cell=cell)
ink_mask |= d > 0.84
if outline:
ink_mask |= _ink_edges(img, thresh=26, thick=3)
# speckle: lost ink and stray ink, like a worn print
noise = RNG.random(d.shape)
ink_mask = (ink_mask & (noise > 0.035)) | (noise < 0.004)
paper_c, ink_c = np.array(paper, np.float32), np.array(ink, np.float32)
out = np.where(ink_mask[..., None], ink_c, paper_c)
out = Image.fromarray(out.astype(np.uint8)).filter(ImageFilter.GaussianBlur(0.35))
out = paper_tex(out, 0.5)
out = creases(out)
return grain(out, 9)
def paper_tex(img, amount=0.5):
tex = Image.open(SRC / 'paper-crumpled.webp').convert('L').resize(img.size)
tex = ImageOps.autocontrast(tex)
t = np.asarray(tex, dtype=np.float32) / 255
t = 1 - (1 - t) * amount
a = np.asarray(img, dtype=np.float32) * t[..., None]
return Image.fromarray(np.clip(a, 0, 255).astype(np.uint8))
def popart(img, colors=((230, 40, 45), (255, 214, 0), (0, 160, 220), (250, 245, 230)), cell=8):
"""Comic pop-art: flat colour zones, Ben-Day dots, heavy black outlines."""
base = img.filter(ImageFilter.MedianFilter(5))
base = ImageEnhance.Color(base).enhance(1.6)
pal = np.array(colors, dtype=np.float32)
a = np.asarray(base, dtype=np.float32)
idx = ((a[:, :, None, :] - pal[None, None]) ** 2).sum(-1).argmin(-1)
flat = pal[idx]
lum = np.asarray(img.convert('L'), dtype=np.float32) / 255
dots = _halftone_mask(np.clip((0.75 - lum) * 1.4, 0, 1), cell=cell, angle=15)
flat = np.where(dots[..., None], flat * 0.55, flat)
flat = np.where((lum < 0.16)[..., None], 20, flat)
edges = _ink_edges(img, thresh=20, thick=5)
flat = np.where(edges[..., None], 18, flat)
return grain(Image.fromarray(np.clip(flat, 0, 255).astype(np.uint8)), 6)
ASCII_RAMP = ' .:-=+*#%@'
def ascii_art(img, cols=72, fg=(120, 255, 160), bg=(6, 14, 9), font_px=14, ramp=ASCII_RAMP, color=False):
"""Redraw the photo as monospaced characters (terminal style)."""
from PIL import ImageDraw, ImageFont
font = None
for f in ('/usr/share/fonts/truetype/liberation/LiberationMono-Bold.ttf',
'/Library/Fonts/Menlo.ttc', '/System/Library/Fonts/Menlo.ttc', 'C:/Windows/Fonts/consolab.ttf'):
if Path(f).exists():
font = ImageFont.truetype(f, font_px)
break
font = font or ImageFont.load_default(size=font_px)
cw = font.getbbox('M')[2]
ch = int(font_px * 1.15)
rows = max(1, int(cols * img.height / img.width * cw / ch))
small = ImageOps.autocontrast(img.resize((cols, rows), Image.BOX), cutoff=2)
small = ImageEnhance.Contrast(small).enhance(1.4)
lum = np.asarray(small.convert('L'), dtype=np.float32) / 255
rgb = np.asarray(small, dtype=np.uint8)
out = Image.new('RGB', (cols * cw, rows * ch), bg)
draw = ImageDraw.Draw(out)
n = len(ramp) - 1
if sum(bg) > 382: # light paper: dark ink should mark the dark areas
lum = 1 - lum
for r in range(rows):
for c in range(cols):
v = lum[r, c]
char = ramp[int(v * n)]
if char != ' ':
col = tuple(int(x) for x in rgb[r, c]) if color else fg
draw.text((c * cw, r * ch), char, font=font, fill=col)
return out
LOOKS = {'toon': toon, 'pixel': pixel, 'xerox': xerox, 'riso': riso, 'vintage': vintage,
'jsr': jsr, 'popart': popart, 'ascii': ascii_art}
# (source, look, width, kwargs)
RECIPES = [
('motorcycle', 'toon', 1200, {}),
('motorcycle', 'pixel', 1200, {'width': 150}),
('cassette', 'vintage', 900, {}),
('guitar-strat', 'riso', 900, {}),
('guitar-hollow', 'toon', 900, {}),
('computers-pile', 'pixel', 900, {'width': 120}),
('computers-room', 'xerox', 900, {}),
('tv', 'vintage', 800, {}),
('synth', 'vintage', 900, {}),
('daisies', 'toon', 1200, {'levels': 7}),
('daisies', 'pixel', 1200, {'width': 160}),
('grass-top', 'pixel', 700, {'width': 96}),
('server-rack', 'toon', 800, {}),
('botanical', 'riso', 700, {'ink_a': (240, 90, 40), 'ink_b': (0, 155, 58)}),
('lily', 'pixel', 800, {'width': 110}),
('hibiscus', 'toon', 1000, {}),
('subway-platform', 'vintage', 1000, {}),
('pedalboard', 'riso', 1000, {'ink_a': (226, 126, 166), 'ink_b': (20, 20, 18)}),
('cloud', 'xerox', 700, {}),
# street-poster set (stand-ins until the new stock photos are sourced)
('motorcycle', 'jsr', 1100, {}),
('guitar-strat', 'jsr', 900, {'ink': (30, 60, 140), 'paper': (240, 228, 200)}),
('subway-platform', 'popart', 900, {}),
('guitar-strat', 'popart', 900, {}),
('synth', 'jsr', 900, {'ink': (150, 30, 40), 'paper': (245, 222, 180)}),
('cassette', 'ascii', 900, {}),
('tv', 'ascii', 800, {'fg': (46, 92, 44), 'bg': (226, 233, 150)}),
]
def main():
OUT.mkdir(parents=True, exist_ok=True)
only = sys.argv[1:]
for src, look, width, kw in RECIPES:
if only and src not in only:
continue
img = fit(load(src), width)
out = LOOKS[look](img, **kw)
path = OUT / f'{src}-{look}.webp'
if look == 'pixel':
out.save(path, 'WEBP', lossless=True)
else:
out.save(path, 'WEBP', quality=84, method=6)
print(f'{path.relative_to(ROOT)} {out.size[0]}x{out.size[1]} {path.stat().st_size // 1024} KB')
if __name__ == '__main__':
main()