README.md

subsampling-scale-image-view
============================

A custom ImageView for Android with pinch to zoom and subsampled tiles to support large images. While zooming in, the
low resolution, full size base layer is overlaid with smaller tiles in the best resolution for the current scale, and
tiles are loaded and discarded during panning to avoid holding too much bitmap data in memory.

Ideal for use in image gallery apps where the size of the images may be large enough to require subsampling, and where
pinch to zoom is required to view the high resolution detail.

Tested with images up to 20000x13000px, but such large images are unusably slow to render.

Supports:
* Display of images of any size
* Pinch to zoom
* Panning while zooming
* One finger pan with momentum
* Can be easily extended to add overlays
* Tiles over 2048px are avoided to support hardware acceleration

Limitations:
* Requires SDK 10 (Gingerbread).
* BitmapRegionDecoder does not support decoding an image from resources - the image file needs to be in assets or external storage.
* Very wide or tall images may still cause out of memory errors because each tile has same w:h ratio as the source image. Fixing this should be fairly easy if required.
* Does not support changing the image after one is loaded. This is another fairly simple change.
* This view does not extend ImageView so attributes including android:tint, android:scaleType and android:src are not supported.