Join GitHub today
GitHub is home to over 20 million developers working together to host and review code, manage projects, and build software together.
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.