All Versions
Latest Version
Avg Release Cycle
99 days
Latest Release
2222 days ago

Changelog History

  • v3.10.0 Changes

    March 15, 2018

    This release contains breaking changes for Kotlin apps.

    Nullable and NonNull annotations have been added. Kotlin did not recognise some method returns as nullable, so uses of these methods without a null check will no longer compile.

    • Target SDK 27
    • #403 Nullable and NonNull annotations
    • #402 Upload sources and javadoc to Maven
  • v3.9.0 Changes

    December 02, 2017

    This release contains breaking changes. If you use a custom ImageRegionDecoder, changes may be required to make it thread safe. For full details see the migration guide.

    These changes are discussed on #120.

    • Replaced setParallelLoadingEnabled with an option to supply a custom executor - setExecutor(Executor).
    • Made AsyncTask.THREAD_POOL_EXECUTOR the default, to reduce contention with other background tasks.
    • โœ‚ Removed synchronization of ImageRegionDecoder.decodeRegion calls to allow for parallel decoding by decoders that support it.
    • Tiles are now loaded during gestures and animations instead of waiting until they end. This can be disabled with setEagerLoadingEnabled(false)
    • โž• Added experimental class SkiaPooledImageRegionDecoder which maintains a small pool of BitmapRegionDecoder instances to allow for parallel decoding when combined with a multi-threaded executor.
  • v3.8.0 Changes

    November 16, 2017
    • ๐Ÿ’ฅ Breaking change Minimum supported SDK has changed from 10 to 14. This was required to add the new EXIF support library.
    • 0๏ธโƒฃ Default behaviour change Image quality is now capped at 320dpi (approximately retina quality) instead of matching the screen's density, which results in high memory use and poor performance when displaying large images on very high density screens. The difference in quality is usually unnoticeable, especially with photos. Use setMinimumTileDpi(int) to override the default.
    • #273 #295 Added minimum scale type SCALE_TYPE_START. This displays the image filling the view width and height, and scrolled to the top left.
    • #284 Double tap is now always interpreted as zoom when zoomed out, to avoid problems when minimum and maximum scale are very close.
    • #298 Added getPanRemaining(RectF), which exposes the pan remaining in each direction, in screen pixels.
    • #329 Allow OnClickListener to work before the image has loaded.
    • #331 Added methods to convert view coordinates to source file coordinates to enable the visible area to be extracted from the source image. visibleFileRect(Rect) and viewToFileRect(Rect, Rect).
    • #344 Guard against null vFocusStart in animation.
    • ๐Ÿ‘Œ Improved debug overlay.
  • v3.7.2 Changes

    November 01, 2017

    ๐Ÿ›  Fixed gradle release script to deploy correct artifacts and returned to more recent build tool versions.

  • v3.7.1 Changes

    October 25, 2017

    ๐Ÿš€ Release 3.7.0 caused (unreproduced) problems for some developers, due to unexplained population of the AttributeSet constructor argument with unexpected values. This release reverts the changes to build tools - an attempt at a blind fix.

  • v3.7.0 Changes

    October 20, 2017
    • Forced removal of implicit permissions READ_PHONE_STATE, READ_EXTERNAL_STORAGE, WRITE_EXTERNAL_STORAGE
    • 0๏ธโƒฃ #279 Include proguard rules to stop removal of default constructors
    • ๐Ÿšš #302 Pass vertical move touch events to parent if not consumed
    • #314 Added null-check per method in onStateChangedListener
    • 0๏ธโƒฃ #349 Support for other bitmap formats (not just default RGB565)
  • v3.6.0 Changes

    November 05, 2016
    • ๐Ÿ‘ #127 If max tile dimensions have been set and dimensions are known, load base layer without waiting for onDraw. This improves ViewPager support - the next image can be eagerly loaded.
    • #148 Revised behaviour of zoom gestures as the image fills the screen for a smoother animation.
    • #171 Added a new image state listener class to allow activites to receive pan and zoom change events.
    • ๐ŸŽ #206 Allow maximum tile dimensions to be set, so performance and memory usage can be optimised when the device supports excessively large tiles.
    • ๐Ÿ‘ #211 Made double tap tolerance density aware for improved high density screen support.
    • #216 Ensure cursors are closed after exceptions.
    • ๐Ÿš€ #222 Added image event for preview released so it can be recycled.
    • #245 Avoid NPE if view has been detached from parent.
    • #253 Corrected position of tile background colour for preview image.
    • #262 Method to check whether an image has been set.
  • v3.5.0 Changes

    April 03, 2016
    • #131 Close input stream used by content resolver
    • #133 Implemented animation event listener
    • #176 Catch and wrap OutOfMemoryErrors thrown when decoding bitmaps so listeners can be notified
    • ๐Ÿ”ง #194 Configurable double tap zoom duration
  • v3.4.1 Changes

    October 13, 2015
    • ๐Ÿ›  #129 #126 Fixed EXIF rotation for single bitmaps
    • #128 Close InputStream in bitmap decoder
    • ๐Ÿ›  #130 Fixed call to onImageLoaded for single bitmaps
  • v3.4.0 Changes

    October 03, 2015

    BitmapRegionDecoder has known issues decoding some images, particularly JPEGs, which can result in images being decoded highly pixellated, grayscale, or completely garbled. BitmapFactory is unaffected by any of these bugs so is much more reliable.

    This library will now use BitmapRegionDecoder to decode the bounds of the image, and if it is smaller than the canvas maximum bitmap size, and the whole image is required at native resolution, BitmapFactory is automatically used instead. This should make the display of small to medium size images from unknown sources much more reliable. As screen densities continue to increase, BitmapFactory will be used more frequently.

    ๐Ÿ‘€ Users on devices with low resolution screens viewing large images are more likely to see the problems caused by BitmapRegionDecoder.