Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / subsampling-scale-image-view / c68d6421912d8e28c0a3b406756556fe733f3ca3
commitc68d6421912d8e28c0a3b406756556fe733f3ca3[log] [tgz]
authorDavid Morrissey <davemorrissey@gmail.com>Wed May 28 22:26:56 2014 +0100
committerDavid Morrissey <davemorrissey@gmail.com>Wed May 28 22:26:56 2014 +0100
treef3decc9eb6dd6453ad53ca8d5ff7f69d8cb6d1d7
parent9d2fd61a9ea770e6816de061f8ff08809bc88fae [diff]
Implemented onMeasure so using wrap_content will result in the view's aspect ratio matching that of the image it's displaying.
1 file changed
tree: f3decc9eb6dd6453ad53ca8d5ff7f69d8cb6d1d7
  1. library/
  2. sample/
  3. .gitignore
  4. LICENSE
  5. README.md
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
  • Dynamically swapping image
  • Dynamically rotating image (0, 90, 180, 270)
  • Optional automatic rotation of image based on EXIF
  • Can be easily extended to add overlays
  • Tiles over 2048px are avoided to support hardware acceleration
  • Compatible with OnClickListener and OnLongClickListener
  • Works within a ViewPager

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.
  • This view does not extend ImageView so attributes including android:tint, android:scaleType and android:src are not supported.
  • Images stored in assets cannot be rotated based on EXIF. This shouldn't be a problem as you'll know the orientation of your files.