# Collage

This package builds collages using images downloaded from
the internet. It makes a set of tiles from the images, which
are matched against the images and used to cover images which match well.

The images which happen to be fitted most closely by the tiles
are rendered with the matching tiles. The resulting images resemble the
original images, but are made up entirely from minature versions of the
same images.

Images are fetched according to a query, optionally provided by the user.

The downloaded images are categoried by primary colour on disk.

## Instructions

Install system requirements.

    $ sudo apt-get install python build-essential python-dev python-virtualenv libjpeg-dev libfreetype6 libfreetype6-dev zlib1g-dev

On 64-bit Ubuntu, symlink the image libraries otherwise PIL won't work very well.

    $ sudo ln -s /usr/lib/`uname -i`-linux-gnu/libfreetype.so /usr/lib/
    $ sudo ln -s /usr/lib/`uname -i`-linux-gnu/libjpeg.so /usr/lib/
    $ sudo ln -s /usr/lib/`uname -i`-linux-gnu/libz.so /usr/lib/

Create and activate a new virtual Python environment.

    $ virtualenv --no-site-packages ve
    ...
    $ source ve/bin/activate
    (ve)$

Install package.

    (ve)$ pip install ~/Downloads/collage-0.1.0.tar.gz
    ...

Start creating collages.

    (ve)$ collage-create "jack nicholson"
    ...

## Bugs and Patches

Please email any bugs or patches to jabywater@gmail.com.


