Metadata-Version: 1.1
Name: piecemaker
Version: 0.4.0
Summary: Create jigsaw puzzle pieces from an image
Home-page: https://github.com/jkenlooper/piecemaker
Author: Jake Hickenlooper
Author-email: jake@weboftomorrow.com
License: GPL
Description: The Jigsaw Piece Maker
        ======================
        
        A jigsaw puzzle pieces generator that levels the playing field.
        
        Currently in use by `Puzzle Massive <http://puzzle.massive.xyz>`_ 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.
        
        
        Installing
        ----------
        
        Requires:
        
        Python Packages:
        
        * `Pillow <http://github.com/python-imaging/Pillow>`_
        * `pixsaw <http://github.com/jkenlooper/pixsaw>`_
        * `beautifulsoup4 <http://www.crummy.com/software/BeautifulSoup/bs4/>`_
        * `svgwrite <https://pypi.python.org/pypi/svgwrite>`_
        * lxml
        * `glue <https://github.com/jorgebastida/glue>`_
        
        Other Software needed:
        
        * `potrace <http://potrace.sourceforge.net/>`_
        * `svgo <https://github.com/svg/svgo>`_
        * `svpng <https://github.com/tylerjpeterson/svpng>`_
        
        If on ubuntu or other debian based distro::
        
            $ sudo apt-get --yes install libspatialindex6
            $ sudo apt-get --yes install optipng
            $ sudo curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -
            $ sudo apt-get install -y nodejs
            $ sudo apt-get --yes install python3-pil
            $ sudo apt-get --yes install potrace libffi-dev libxml2-dev python3-lxml python3-xcffib
            $ sudo npm install -g svgo svpng
        
        
        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
        -----
        
        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 (`mkdir test`) and
        test.jpg exist::
        
            piecemaker --dir test  --number-of-pieces 100 test.jpg
        
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Software Development :: Build Tools
