Initial Blockminers printer

2026-05-30 16:54:49 +00:00
commit 47748f3897
261 changed files with 3992 additions and 0 deletions
@@ -0,0 +1,45 @@
+# Blockminers Printer
+
+Render printable Blockminers cards and boards from the source assets in `data/`.
+
+This project was written with AI assistance and reviewed/iterated by the project maintainer.
+
+## Requirements
+
+Python 3.10 or newer and Pillow are required.
+
+```bash
+python3 -m pip install Pillow
+```
+
+## Usage
+
+Run the interactive builder:
+
+```bash
+python3 build_printable.py
+```
+
+Run with defaults:
+
+```bash
+python3 build_printable.py --yes
+```
+
+The final PDF is written to `print/`. Temporary rendered images are written to `print/temp/`.
+
+## Supported Flags
+
+- `--yes`: use default settings without interactive prompts.
+- `--dpi {300,600}`: set output resolution. Default: `300`.
+- `--paper {a3,a4,legal,letter,tabloid}`: choose paper size. Default: `a3`.
+- `--card-size SIZE`: choose card size. Use `bridge`, `mini-euro`, `poker`, `tarot`, or a custom size like `70.0x120.0` in millimeters. Default: `poker`.
+- `--crop`: crop black borders from cards. Default: off.
+- `--no-gamma`: disable print-brightening gamma correction. Default: gamma correction on.
+- `--render-only`: render card and board PNGs, but skip page PNGs and PDF creation. Default: off.
+- `--output NAME`: write the PDF as `print/NAME`; `.pdf` is added if missing. Default filename: `blockminers_printable.pdf`.
+- `--rent-raised N`: print `N` copies of `Rent raised` and matching backs. Default: `3`.
+- `--keep-temp`: keep `print/temp/` after PDF creation. Default: delete temp files after PDF creation.
+- `--starter-colors {separate,same}`: use separate starter badge colors or one repeated color per starter deck. Default: `separate`.
+
+Use `--help` to see the same options from the command line.