Skip to content

jkenlooper/pixsaw

develop
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Pixsaw

Cuts an image up into multiple pieces by following pixel lines that contrast with targetted piece color. Inspired by scissors, but more flexible with the drawback of possibly losing some pixels in the process.

Installing

Requires:

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

$ python3 -m venv .
$ source ./bin/activate
$ pip install -e .

Usage

Running the pixsaw.py script will show some help. It basically needs a path to a directory to store the generated files, an image that shows where to cut, and the image that should be cut into pieces.

Example:

$ mkdir tmp-small-puzzle-example
$ pixsaw --dir tmp-small-puzzle-example --lines examples/small-puzzle-lines.png examples/320px-White_Spoon_Osteospermum.jpg

The puzzle lines:

https://github.com/jkenlooper/pixsaw/raw/master/examples/small-puzzle-lines.png

The image:

https://github.com/jkenlooper/pixsaw/raw/master/examples/320px-White_Spoon_Osteospermum.jpg

Image from: http://en.wikipedia.org/wiki/File:White_Spoon_Osteospermum.JPG

The output (combined into one file with glue to better show it):

https://github.com/jkenlooper/pixsaw/raw/master/examples/pieces-combined-with-glue.png

About

Cut a picture into pieces by cutting along pixel lines

Resources

License

LGPL-3.0, GPL-3.0 licenses found

Licenses found

LGPL-3.0
COPYING.LESSER
GPL-3.0
COPYING

Stars

Watchers

Forks

Packages

No packages published

Languages