README.md

Atkinstache

Atkinstache is a TileStache provider for generating stylized black and white
halftone, or "dithered", map tiles using another tileset as its input. The
halftone effect is accomplished using Bill Atkinson's original dithering
algorithm created for the first Apple Macintosh computers.

Typically you would use satellite imagery but there's nothing to stop you from
using a different source.

How to

It exposes a single provider named atkinstache.dithering.Provider and you
invoke it in your TileStache config like this:

If the skip_on_checksum flag is true then the contents of each new tile (from
the source_layer provider) will be MD5 hashed and compared to the checksum
value. If the two match the tile will not be dithered. You might want to do this
for tile sets that send a unique tile for those areas that lack coverage.

Other stuff

By default Atkinstache will use a pure Python implementation of the dithering
algorithm to filter images. If the C-based atk Python implimentation is
installed the package will use that instead.