Python wrapper around go code to generate photomosaics

An interesting feature in Go 1.5 is build-modes flag during the build phase. It's possible to compile shared library ans use that from your python code.

This is a thin wrapper aroung go library for photomosaic generation.

This project has dependency on resize for scaling down large images: https://github.com/nfnt/resize

To install: https://github.com/nfnt/resize#installation

From the src directory

pymosaic$ go build -buildmode=c-shared -o pymosaic.so

Now copy pymosaic.so to your virtual environments site-packages.

You can read about photomosaics here: https://en.wikipedia.org/wiki/Photographic_mosaic You need a library of tile images and a target photo to generate a photomosaic.

pymosaic also includes a flickr client to download images with sepcified tag to help build your tile library.

download(flickr_tag, number, libdir, api_key)

flickr_tag(string): the images tagged with this term will be downloaded number(int): the number of images that are to be downloaded libdir(string): the output directory where the images should be downloaded api_key(string): your flickr api key

example:

>>>import pymosaic
>>>pymosaic.download("waffles", 200, "<homedir>/tiledir", "<flickr api key>")

analyze_images(libdir)

libdir(string): the path to tile image library this function takes path of the tile directory as input and returns a json string of image statistics (to be used in next step of mosaic generation

example:

>>>img_statistics = pymosaic.analyze_images("<homedir>/tiledir")

generate_mosaic(<target_image>, <mosaic_image>, <img_statistics>)

target_image(string): The path of image that you want to create mosaic out of. mosaic_image(string): the path of the mosaic image to be generated (should be .png and you need to have write permissions) img_statistics(string): image statistics json string generate in previous step (analyze_images)

example:

>>>pymosaic.generate_mosaic("/home/user/my_profile.jpg",
                           "/home/user/output.png", img_statistics)