#!/usr/bin/env python3
"""Render the Prime butterfly SVG as terminal-safe text art.
Usage:
uv run scripts/render-logo.py [--width 60] [--threshold 96] [--style blocks] [--svg path]
Outputs the rendered art to stdout.
Requires `cairo` on the system (brew install cairo). Uses cairosvg + pillow,
both pulled via uv's --with on each invocation so there's no committed venv.
"""
# /// script
# requires-python = ">=3.10"
# dependencies = ["cairosvg", "pillow"]
# ///
from __future__ import annotations
import argparse
import io
import os
import sys
from pathlib import Path
def render(svg_path: Path, width: int, threshold: int, style: str) -> str:
# Late imports so --help works without the deps installed.
import cairosvg
from PIL import Image
if style == "quadrants":
# Quadrant block characters encode a solid 2x2 grid. Halving the SVG's
# raster height compensates for terminal cells being roughly twice as tall
# as they are wide while retaining twice the horizontal edge resolution.
png_bytes = cairosvg.svg2png(url=str(svg_path), output_width=width * 2)
img = Image.open(io.BytesIO(png_bytes)).convert("RGBA")
bg = Image.new("RGBA", img.size, (0, 0, 0, 255))
bg.paste(img, (0, 0), img)
img = bg.convert("L").resize((width * 2, max(2, round(img.size[1] / 2))), Image.LANCZOS)
w, h = img.size
padded_h = h + (-h % 2)
if padded_h != h:
padded = Image.new("L", (w, padded_h), 0)
padded.paste(img, (0, 0))
img = padded
h = padded_h
px = img.load()
glyphs = (" ", "▘", "▝", "▀", "▖", "▌", "▞", "▛", "▗", "▚", "▐", "▜", "▄", "▙", "▟", "█")
rows = []
for y in range(0, h, 2):
row = ""
for x in range(0, w, 2):
mask = (
(1 if px[x, y] > threshold else 0)
| (2 if px[x + 1, y] > threshold else 0)
| (4 if px[x, y + 1] > threshold else 0)
| (8 if px[x + 1, y + 1] > threshold else 0)
)
row += glyphs[mask]
rows.append(row.rstrip())
elif style == "braille":
# A Braille cell is a 2 x 4 pixel grid. Terminal cells are typically twice as
# tall as they are wide, so those subpixels are approximately square and the
# SVG keeps its intended aspect without further vertical scaling.
png_bytes = cairosvg.svg2png(url=str(svg_path), output_width=width * 2)
img = Image.open(io.BytesIO(png_bytes)).convert("RGBA")
bg = Image.new("RGBA", img.size, (0, 0, 0, 255))
bg.paste(img, (0, 0), img)
img = bg.convert("L")
w, h = img.size
padded_w = w + (-w % 2)
padded_h = h + (-h % 4)
if (padded_w != w) or (padded_h != h):
padded = Image.new("L", (padded_w, padded_h), 0)
padded.paste(img, (0, 0))
img = padded
w, h = img.size
px = img.load()
dot_bits = (
(0, 0, 0),
(0, 1, 1),
(0, 2, 2),
(1, 0, 3),
(1, 1, 4),
(1, 2, 5),
(0, 3, 6),
(1, 3, 7),
)
rows = []
for y in range(0, h, 4):
row: list[str] = []
for x in range(0, w, 2):
mask = 0
for dx, dy, bit in dot_bits:
if px[x + dx, y + dy] > threshold:
mask |= 1 << bit
row.append(chr(0x2800 + mask) if mask else " ")
rows.append("".join(row).rstrip())
elif style == "dots":
# 1 pixel = 1 character cell. Compensate for terminal cells being ~2x taller than wide
# so the rendered shape keeps the original proportions.
# Use ▪ (BLACK SMALL SQUARE) so adjacent cells read as a tightly packed dot matrix —
# mid-dot · is too small and reads as "spaced out" against the cell.
png_bytes = cairosvg.svg2png(url=str(svg_path), output_width=width * 2)
img = Image.open(io.BytesIO(png_bytes)).convert("RGBA")
bg = Image.new("RGBA", img.size, (0, 0, 0, 255))
bg.paste(img, (0, 0), img)
img = bg.convert("L")
target_h = max(1, img.size[1] // 4)
img = img.resize((width, target_h), Image.LANCZOS)
px = img.load()
rows: list[str] = []
for y in range(target_h):
row = "".join("▪" if px[x, y] > threshold else " " for x in range(width))
rows.append(row.rstrip())
else:
png_bytes = cairosvg.svg2png(url=str(svg_path), output_width=width)
img = Image.open(io.BytesIO(png_bytes)).convert("RGBA")
bg = Image.new("RGBA", img.size, (0, 0, 0, 255))
bg.paste(img, (0, 0), img)
img = bg.convert("L")
w, h = img.size
if h % 2:
padded = Image.new("L", (w, h + 1), 0)
padded.paste(img, (0, 0))
img = padded
h += 1
px = img.load()
table = {(False, False): " ", (True, False): "▀", (False, True): "▄", (True, True): "█"}
rows = []
for y in range(0, h, 2):
rows.append(
"".join(
table[(px[x, y] > threshold, px[x, y + 1] > threshold)] for x in range(w)
).rstrip()
)
while rows and not rows[0].strip():
rows.pop(0)
while rows and not rows[-1].strip():
rows.pop()
if rows:
left = min(len(r) - len(r.lstrip(" ")) for r in rows if r.strip())
rows = [r[left:] for r in rows]
return "\n".join(rows)
def main() -> int:
repo_root = Path(__file__).resolve().parent.parent
default_svg = repo_root / "assets" / "brand" / "prime-butterfly.svg"
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument("--width", type=int, default=60, help="output columns (default: 60)")
parser.add_argument(
"--threshold",
type=int,
default=96,
help="luminance cutoff 0-255; raise for thinner strokes (default: 96)",
)
parser.add_argument(
"--svg", type=Path, default=default_svg, help=f"input SVG (default: {default_svg})"
)
parser.add_argument(
"--style",
choices=("blocks", "braille", "dots", "quadrants"),
default="blocks",
help="blocks = half-block; braille = 2x4 dots; dots = square matrix; quadrants = solid 2x2 cells",
)
args = parser.parse_args()
if not args.svg.exists():
print(f"svg not found: {args.svg}", file=sys.stderr)
return 1
# Set DYLD_FALLBACK_LIBRARY_PATH for homebrew cairo on Apple Silicon.
if sys.platform == "darwin" and "DYLD_FALLBACK_LIBRARY_PATH" not in os.environ:
os.environ["DYLD_FALLBACK_LIBRARY_PATH"] = "/opt/homebrew/lib:/usr/local/lib"
print(render(args.svg, args.width, args.threshold, args.style))
return 0
if __name__ == "__main__":
raise SystemExit(main())