John Louis del Rosario committed 187b21b

added readme

  • Participants
  • Parent commits a9998cf

Comments (0)

Files changed (2)


Empty file removed.

File README.markdown

+# Requirements
+- Python Imaging Library
+# Usage
+## Prepare the image pool
+1. Collect a ton of images (2000 is a good number) for your image pool and place them in a directory (e.g. `tiles/`). Make sure they are the same size and w/h ratio\*.
+2. Run `$ python tiles/` to create the tiles database.
+*\* use `` to "weed" out images with different ratios (`$ python tiles_dir desired_width desired_height weeded_tiles_dir`)
+This will put all images not matching `desired_width` and `desired_height` into `weeded_tiles_dir` so you can fix them later on and re-add them into the image pool.  *
+## Creating the mosaic
+After running ``, you can now create mosaics.
+    $ python [options] source_image output_image tiles_dir
+### options
+- `-p RATIO`: Ratio between the tile size and subdivisions of the image. Set to higher numbers for finer details. Use whole numbers only. e.g. A RATIO of 4 would place 4 tiles into 1 subdivision of the image. Default is 1.
+- `-m METHOD, --method=METHOD`: Traversing method. (`inside-out` or `top-down`) Determines where to start traversing the source image. 
+- `-r --repeat`: Allow repeating of tiles
+- `-n --norepeat`: Do not allow repeating of tiles [default]
+- `-t THRESHOLD, --threshold=THRESHOLD`: Threshold value for comparing colors. Default is 0.
+- `-v --verbose`: Verbose output.
+- `-x XSTART, --xStart=XSTART`: X position of where to start matching. For `inside-out` method only. 
+- `-y YSTART, --yStart=YSTART`: Y position of where to start matching. For `inside-out` method only.