rpgpawns: Convert any image to a paper-cut pawn for board games and tabletop RPGs

rpgpawns converts any image into a printable paper-cut pawn suitable for board games and tabletop RPGs such as Dungeons & Dragons and Pathfinder.

Given an input image, rpgpawns will:

1. Scale it to fit standard Pathfinder pawn sizes (28x48mm for medium pawns)

2. Duplicate the image along its top edge with a vertical mirror, so it can be folded to create a double-sided pawn.

3. Add white padding and a border for easy cutting.

4. Arrange one or more pawns, or multiple copies of the same pawn, on a A4 page, ready for printing.

Quick start

Online

You can run rpgpawns in your web browser. Just select your image(s), tweak the settings as desired, and generate the PDF file.

Command line

rpgpawns goblin.png knight.jpg:2 -o pawns.pdf

This reads goblin.png and knight.jpg, processes each into a pawn (with knight.jpg duplicated twice), arranges them on A4 pages, and writes the result to pawns.pdf.

Python API

from PIL import Image
from rpgpawns import make_pawn, make_collage

goblin = make_pawn(Image.open("goblin.png"))
knight = make_pawn(Image.open("knight.jpg"))

pages = make_collage([goblin, knight, knight])
pages[0].save(
    "pawns.pdf",
    dpi=(300, 300),
    save_all=True,
    append_images=pages[1:],
)

Pawn sizes

rpgpawns implements standard Pathfinder pawn sizes:

Size	Base (mm)	Height (mm)	Print Height (mm)
small	20	28	78
medium	28	48	118
large	48	63	148
huge	75	99	220

Print height is the image height once folded, plus a 11mm label to stick the the pawn into a clip, everything mirrored on the tall side.

• Installation
  • Required dependencies
  • Installing with conda
  • Installing with pip
  • Minimum dependency versions
• Command-line interface
  • Synopsis
  • Positional arguments
  • Options
  • Examples
• API Reference
  • Pawn sizes
    • PawnSize
      • PawnSize.HUGE
      • PawnSize.LARGE
      • PawnSize.MEDIUM
      • PawnSize.SMALL
    • PAWN_SPECS
  • Pawn creation
    • make_pawn()
  • Collage
    • make_collage()
  • Utility
    • mm_to_px()
  • Constants
    • DPI
    • MIN_PADDING_MM
    • COLLAGE_SPACING_MM
• Development Guidelines
  • Reporting issues
  • Deploying a development environment
  • Test
  • Code Formatting
  • Documentation
• What’s New
  • v0.1.0 (unreleased)

License

This software is available under the open source Apache License.