piecemaker 0.4.7

Create jigsaw puzzle pieces from an image

The Jigsaw Piece Maker

A jigsaw puzzle pieces generator that levels the playing field.

Currently in use by Puzzle Massive to create puzzles with 5000+ pieces.

It creates jigsaw puzzle pieces in multiple formats: svg, jpg, and png. The number and size of pieces are set by passing the script different options. It takes a while to run if doing a lot of pieces. Extra JSON files are created with details on size of pieces and adjacent pieces information which is commonly used when verifying that two pieces can join together.

Try out by running the piecemaker.sh script that will prompt for necessary options and run piecemaker inside a docker container. It will use the files in the examples directory by default.

# Build and run using docker
./piecemaker.sh

Installing

Requires:

Python Packages:

• Pillow
• pixsaw
• beautifulsoup4
• svgwrite
• lxml
• glue (Only partially included in piecemaker source)

Other Software needed:

• potrace

If on ubuntu or other debian based distro

apt-get --yes install libspatialindex6
apt-get --yes install optipng
apt-get --yes install python3-pil
apt-get --yes install potrace libffi-dev libxml2-dev python3-lxml python3-xcffib
apt-get --yes install librsvg2-bin
apt-get --yes install python3-pip

Install with pip in editable mode for developing and use virtualenv to isolate python dependencies

python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade --upgrade-strategy eager -e .

Usage

See the script.py for more. Not everything has been implemented. Use this example command to create 100 randomly generated jigsaw puzzle pieces from test.jpg image. This assumes that the 'test' directory is empty since that is where it will be placing all the generated files. The test.jpg is the source image that will be used when creating the pieces. It is not modified.

piecemaker --dir test  --number-of-pieces 100 test.jpg

Docker Usage

A Dockerfile also can be used to build an image and run it.

./update-dep.sh
DOCKER_BUILDKIT=1 docker build -t piecemaker:latest .

mkdir -p out/tmp
cp test.jpg out/
rm -rf out/tmp/*

docker run -it --rm \
    --mount type=bind,src=$(pwd)/out,dst=/out \
    piecemaker:latest \
    piecemaker --dir /out/tmp --number-of-pieces 100 /out/test.jpg

Contributing

Please contact me or create an issue.

Any submitted changes to this project require the commits to be signed off with the git command option '--signoff'. This ensures that the committer has the rights to submit the changes under the project's license and agrees to the Developer Certificate of Origin.

License

GNU Lesser General Public License v3.0

Maintenance

Where possible, an upkeep comment has been added to various parts of the source code. These are known areas that will require updates over time to reduce software rot. The upkeep comment follows this pattern to make it easier for commands like grep to find these comments.

Example UPKEEP comment has at least a 'due:' or 'label:' or 'interval:' value surrounded by double quotes (").

Example-> # UPKEEP due: "2022-12-14" label: "an example upkeep label" interval: "+4 months"