Fetching latest commit…
Cannot retrieve the latest commit at this time
|Failed to load latest commit information.|
Pandamonkium Productions present ____ __ ___ / __ \__ __/ |/ /___ _____ / /_/ / / / / /|_/ / __ \/ ___/ / ____/ /_/ / / / / /_/ (__ ) /_/ \__, /_/ /_/\____/____/ /____/ 0.5 -- ideamonk and yuvipanda #hackers-india Purpose - PyMos is a Python module that helps you generate a mosaic poster of an image using a desired collection of thumbnails. Some sample images can be seen here * http://www.flickr.com/photos/ideamonk/4020798966/sizes/m/ * http://www.flickr.com/photos/ideamonk/4026969049/sizes/l/ * http://www.flickr.com/photos/ideamonk/4064596012/ Dependencies - * argparse met by setuptools * PIL 1.1.6+ manual Usage - 1. As a command-line tool pymos [-h] [-z ZOOM] [-ts THUMBSIZE] [-f FUZZFACTOR] [-v] [-nc] input output collection Creates mosaics of a collection of images to closely match a target image positional arguments: input Input file output Output file collection Directory holding images to be mosaiced optional arguments: -h, --help show this help message and exit -z ZOOM, --zoom ZOOM Zoom Level (20) -ts THUMBSIZE, --thumbsize THUMBSIZE Size of the thumbnails (60) -f FUZZFACTOR, --fuzzfactor FUZZFACTOR Amount of randomness in ouput (0) -v, --verbose Show verbose output -nc, --new-colormap Regenerate color map Notes: * Input files can be any standard image file supported by PIL (Python Imaging Library) 1.1.6+ * a collection is just any folder that has many small images to build up the mosaic * ZOOM is the number of times input file is enlarged to make the output file. Eg if input file is 800x600, a zoom of 10 would give you 8000x6000 * THUMBSIZE is the size of small pieces that would compose the output image. * A colormap is generated and stored for a collection (directory) in order to save time in regeneration. If you add new images to a collection, you can fire pymos with -nc option to generate a new colormap which would include the newly added images. * How to make a collection of images ? Well its upto you. We just saved some random thumnails from flickr. You could use twitter API as well to fetch display pics of your friends and make a mosaic using your followers :) 2. As a library - Example #1 Storing to a file from pymos.core import build_mosaic build_mosaic( input_path="foo.jpg", output_path="bar.png", collection_path="/tmp/apples", zoom=20, thumb_size=100, new_colormap=False ) Example #1 Getting back an image from pymos.core import build_mosaic foo = build_mosaic( input_path="foo.jpg", output_path=None, # notice the None here collection_path="/tmp/apples", zoom=20, thumb_size=100, new_colormap=False ) foo.show() Feedback - Did PyMos fail over something? Do let us know. Do you wish to report a big? a feedback perhaps? Why don't you raise an issue on project page - http://github.com/ideamonk/PyMos/issues Or do you wish to make changes to suit it to your needs? Fork it baby - http://github.com/ideamonk/PyMos Loo into AUTHORS for mailing us.