# Change Log

Translations: [简体中文](CHANGELOG_zh.md)

# v3.3.2

#### sketch:

* fix: Fix the bug that GlobalImageOptions resizeSize does not take effect
* improve: Now the metadata information and data cached by http download and result are regarded as the same cache entity, and will be cleared together when cleared.

#### sketch-compose:

* fix: Fix the bug that AsyncImage cannot display images when the height of LazyColumn is wrapContentHeight [#194](https://github.com/panpf/sketch/issues/194)

# v3.3.1

#### sketch:

* fix: Fix the bug that ResizeDrawable and ResizeAnimatableDrawable should use the size of bounds as
  dstSize
* fix: Fixed a bug where HurlStack made an error when encountering no Content-Length field in the
  response, causing image loading to fail. [#193](https://github.com/panpf/sketch/issues/193)
* fix: Fixed the bug that the bottomLeft and bottomRight parameters of the (Float, Float, Float,
  Float) constructor of RoundCornersTransformation are in the wrong order

#### sketch-compose:

* fix: Fix the bug where AsyncImage resizeSize changes to the last image size when loading the image
  again
* improve: Use PainterElement instead of ContentPainterModifier to improve AsyncImage performance

# v3.3.0 stable

#### sketch:

* Request:
    * change: With the help of View.findViewTreeLifecycleOwner() and LocalLifecycleOwner.current
      API, the latest Lifecycle can now be automatically obtained, and there is no need to actively
      set the Lifecycle.
    * change: The `enqueue()` and `execute()` methods of DisplayRequest, LoadRequest, and
      DownloadRequest are now extended functions, requiring the import of dependencies
    * new: Add addListener(), removeListener(), addProgressListener(), removeProgressListener()
      methods for DisplayRequest.Builder, DisplayRequest.Builder, DisplayRequest.Builder
    * new: DisplayRequest adds the allowSetNullDrawable(Boolean) method, which can set whether to
      allow null Drawables to be set to ImageView or AsyncImagePainter
    * new: ImageRequest and ImageOptions add `uriEmpty()` method for more convenient configuration
      of uri empty state image
* execute:
    * improve: Now after onStart check uri is empty
* cache:
    * change: Upgrading Result LruDiskCache internalVersion will clear all old caches
* decode:
    * improve: Improved calculation of inSampleSize on API 16, and now uses 2 times the target size
      as the maximum bitmap size when the opengl texture size cannot be obtained
* resize:
    * new: Precision adds `SMALLER_SIZE` enum value
    * new: Adds LongImageDecider(), PrecisionDecider(Precision), ScaleDecider(Scale), SizeResolver(
      Size) functions
* StateImage:
    * fix: Fixed a bug where other images may be displayed unexpectedly when uri is empty
    * fix: Fix the bug of request interruption when StateImage fails to obtain Drawable
    * change: A null placeholder or error drawable is now no longer set to an ImageView by default
    * deprecated: Deprecate all overloaded constructors of IconStateImage and replace them with the
      IconStateImage() function
    * new: IconStateImage adds iconSize attribute to support adjusting the size of the icon
    * new: Added IconStateImage() function, specifically used to create IconStateImage
    * new: Added AnimatableIconStateImage class for displaying dynamic placeholder
* log:
    * change: Logger no longer outputs thread names by default. You need to manually
      set `Logger.showThreadName = true` to output thread names.
    * improve: Built-in exceptions no longer print stack information
* http:
    * change: No longer intercept download requests with 'Transfer-Encoding' is 'chunked'
    * improve: HttpUriFetcher now also verifies that readLength and contentLength are the same when
      disabling disk caching, and throws an exception if they are not
* other:
    * new: Split out the `sketch-core` module to provide basic functionality
    * new: SketchSingleton adds the `setSketch()` method, which is used to set up a singleton
      instance of Sketch

#### sketch-zoom:

* deprecated：The `sketch-zoom` module and its `SketchZoomImageView` component are deprecated. Please
  use the `SketchZoomImageView` component from the https://github.com/panpf/zoomimage library
  instead.

#### sketch-extensions

* remove: SketchImageView and SketchZoomImageView remove submitRequest method
* remove: Remove the `sketch_src` xml attribute of SketchImageView
* change: ApkIconBitmapDecoder and AppIconUriFetcher's IMAGE_MIME_TYPE changed from 'image/appicon'
  to 'image/png'
* deprecated: The `sketch-extensions` module is deprecated and kept for now, now it only depends on
  the `sketch-extensions-view` module
* improve: Improve ProgressDrawable
* new: Split out the `sketch-extensions-core` module to provide basic functionality
* new: Added `sketch-extensions-view` and `sketch-extensions-compose` modules to provide extension
  functions for view and compose respectively
* new: Provide MimeType logo, DataFrom logo, and progress indicator functions for compose
* new: SketchImageView adds a new requestState attribute, which can use flow to monitor the status,
  results and progress of the request.
* new: The constructor of RingProgressDrawable adds backgroundColor parameter

#### sketch-compose:

> [!CAUTION]
> If you have the following two situations when using AsyncImage, AsyncImagePainter, or
> SubcomposeAsyncImage, then you need to modify your code:
> * using their onState parameter
> * Using the listener, progressListener, and target properties of DisplayRequest

* change: Refactor
  AsyncImage, AsyncImagePainter, SubcomposeAsyncImage, add a `state: AsyncImageState` parameter to
  them, through AsyncImageState can observe image loading state and results and restart loading
* change: A null placeholder or error painter is now no longer set to AsyncImagePainter by default
* improve: To improve performance, mark DisplayRequest and Sketch as @Stable and overloaded
  composable functions as @NonRestartableComposable
* new: AsyncImage and SubcomposeAsyncImage add `clipToBounds:Boolean = true` parameter
* new: AsyncImage, SubcomposeAsyncImage, AsyncImagePainter added a sketch parameter version that
  supports configuration
* new: Split out the `sketch-compose-core` module to provide basic functionality

#### sketch-gif:

> [!CAUTION]
> If you use the gif-related classes or functions of the `sketch` module, now you need to
> additionally depend on the `sketch-gif` module

* deprecated: Deprecated `sketch-gif-movie` module, retained for now, now it only depends
  on `sketch-gif` module
* new: Add the `sketch-gif` module and move the gif-related code in the `sketch-gif-movie`
  and `sketch` modules to this module

#### other:

* depend: Upgrade kotlin 1.9.0, kotlinx coroutines 1.7.3, compose 1.5.0, lifecycle 2.6.1

# v3.3.0-rc02

#### sketch:

* improve: Improved calculation of inSampleSize on API 16, and now uses 2 times the target size as
  the maximum bitmap size when the opengl texture size cannot be obtained
* change: Upgrading Result LruDiskCache internalVersion will clear all old caches
* change: Logger no longer outputs thread names by default. You need to manually
  set `Logger.showThreadName = true` to output thread names.

# v3.3.0-rc01

#### sketch:

* new: IconStateImage adds iconSize attribute to support adjusting the size of the icon
* new: Added IconStateImage() function, specifically used to create IconStateImage
* new: Added AnimatableIconStateImage class for displaying dynamic placeholder
* deprecated: Deprecate all overloaded constructors of IconStateImage and replace them with the
  IconStateImage() function

#### sketch-extensions:

* new: The constructor of RingProgressDrawable adds backgroundColor parameter

# v3.3.0-beta06

#### sketch:

* change: A null placeholder or error drawable is now no longer set to an ImageView by default
* new: DisplayRequest adds the allowSetNullDrawable(Boolean) method, which can set whether to allow
  null Drawables to be set to ImageView or AsyncImagePainter

#### sketch-compose:

* change: A null placeholder or error painter is now no longer set to AsyncImagePainter by default

# v3.3.0-beta05

#### sketch

* fix: Fix the bug of request interruption when StateImage fails to obtain Drawable
* new: Add addListener(), removeListener(), addProgressListener(), removeProgressListener() methods
  for DisplayRequest.Builder, DisplayRequest.Builder, DisplayRequest.Builder

#### sketch-compose:

> [!CAUTION]
> If you have the following two situations when using AsyncImage, AsyncImagePainter, or
> SubcomposeAsyncImage, then you need to modify your code:
> * using their onState parameter
> * Using the listener, progressListener, and target properties of DisplayRequest

* change: Refactor
  AsyncImage, AsyncImagePainter, SubcomposeAsyncImage, add a `state: AsyncImageState` parameter to
  them, through AsyncImageState can observe image loading state and results and restart loading
* improve: To improve performance, mark DisplayRequest and Sketch as @Stable and overloaded
  composable functions as @NonRestartableComposable

#### sketch-extensions:

* deprecated: The `sketch-extensions` module is deprecated and kept for now, now it only depends on
  the `sketch-extensions-view` module
* improve: Improve ProgressDrawable
* new: Added `sketch-extensions-view` and `sketch-extensions-compose` modules to provide extension
  functions for view and compose respectively
* new: Provide MimeType logo, DataFrom logo, and progress indicator functions for compose
* new: SketchImageView adds a new requestState attribute, which can use flow to monitor the status,
  results and progress of the request.

#### sketch-gif:

> [!CAUTION]
> If you use the gif-related classes or functions of the `sketch` module, now you need to
> additionally depend on the `sketch-gif` module

* deprecated: Deprecated `sketch-gif-movie` module, retained for now, now it only depends
  on `sketch-gif` module
* new: Add the `sketch-gif` module and move the gif-related code in the `sketch-gif-movie`
  and `sketch` modules to this module

# v3.3.0-beta04

* fix: Fixed a bug introduced from version 3.3.0-beta02 onwards where all disk cache was lost when
  an app was accidentally killed
* improve: HttpUriFetcher now also verifies that readLength and contentLength are the same when
  disabling disk caching, and throws an exception if they are not

# v3.3.0-beta03

> [!CAUTION]
> This version has a serious bug, please upgrade to the new version as soon as possible

* fix: Fixed a crash bug when Bitmap.config is null
* fix: Fixed a bug where ViewLifecycleResolver was introduced from version 3.3.0-beta01 onwards and
  caused memory leaks
* fix: Fixed a bug where ViewLifecycleResolver, introduced from version 3.3.0-beta01, would hang
  permanently when encountering a view that was dropped without attaching

# v3.3.0-beta02

> [!CAUTION]
> This version has a serious bug, please upgrade to the new version as soon as possible

#### sketch:

* new: Adds LongImageDecider(), PrecisionDecider(Precision), ScaleDecider(Scale), SizeResolver(Size)
  functions

#### sketch-compose:

* change: The `noClipContent` parameter of AsyncImage and SubcomposeAsyncImage is changed
  to `clipToBounds:Boolean = true`

# v3.3.0-beta01

> [!CAUTION]
> This version has a serious bug, please upgrade to the new version as soon as possible

#### sketch:

* fix: Fixed a bug where other images may be displayed unexpectedly when uri is empty
* remove: SketchImageView and SketchZoomImageView remove submitRequest method
* remove: Remove the `sketch_src` xml attribute of SketchImageView
* change: With the help of View.findViewTreeLifecycleOwner() and LocalLifecycleOwner.current API,
  the latest Lifecycle can now be automatically obtained, and there is no need to actively set the
  Lifecycle.
* change: No longer intercept download requests with 'Transfer-Encoding' is 'chunked'
* change: The `enqueue()` and `execute()` methods of DisplayRequest, LoadRequest, and
  DownloadRequest are now extended functions, requiring the import of dependencies
* improve: Built-in exceptions no longer print stack information
* improve: Now after onStart check uri is empty
* new: Precision adds `SMALLER_SIZE` enum value
* new: ImageRequest and ImageOptions add `uriEmpty()` method for more convenient configuration of
  uri empty state image
* new: Split out the `sketch-core` module to provide basic functionality
* new: SketchSingleton adds the `setSketch()` method, which is used to set up a singleton instance
  of Sketch

#### sketch-zoom:

* deprecated：The `sketch-zoom` module and its `SketchZoomImageView` component are deprecated. Please
  use the `SketchZoomImageView` component from the https://github.com/panpf/zoomimage library
  instead.

#### sketch-extensions

* change: ApkIconBitmapDecoder and AppIconUriFetcher's IMAGE_MIME_TYPE changed from 'image/appicon'
  to 'image/png'
* new: Split out the `sketch-extensions-core` module to provide basic functionality

#### sketch-compose:

* improve: Synchronize coil-compose-base updates as of 2023/11/21
* new: AsyncImage and SubcomposeAsyncImage add `noClipContent` parameter
* new: AsyncImage, SubcomposeAsyncImage, AsyncImagePainter added a sketch parameter version that
  supports configuration
* new: Split out the `sketch-compose-core` module to provide basic functionality

#### other:

* depend: Upgrade kotlin 1.9.0, kotlinx coroutines 1.7.3, compose 1.5.0, lifecycle 2.6.1

# v3.2.5

#### sketch-compose

* fix: Fixed an issue where CrossfadePainter's computeIntrinsicSize calculation logic bug caused an
  exception to be displayed on the Image component
* improve: Remove some internal restrictions for the rememberAsyncImagePainter() function

# v3.2.4

#### sketch

* fix: Fixed a bug where SVGBitmapDecoder did not enlarge images based on resize
* fix: Fixed a bug where DrawableBitmapDecoder did not enlarge images based on resize

#### sketch-compose

* fix: Fixed a bug where AsyncImage() crashed when placeholder and error were not set and the image
  failed to load [#184](https://github.com/panpf/sketch/issues/184)

# v3.2.3

#### sketch

* fix: SketchCountBitmapDrawable is no longer returned when MemoryCachePolicy is WRITE_ONLY
* fix: Now if DisplayTarget does not support display counting, the memory cache will not be able to
  be used, avoiding the Bitmap recycle exception thrown by this

# v3.2.2

#### sketch

* fix: Fixed the bug that webp images with animated markers but not animated image could not use
  resize,
  Transformation, BitmapDecodeInterceptor and other functions

# v3.2.1

#### sketch

* fix: Fixing child thread exceptions may not catch bugs that cause your app to
  crash [#176](https://github.com/panpf/sketch/issues/176)
* fix: When the merged() method of ImageOptions has its own componentRegistry as null and other’s
  componentRegistry is not null, the returned componentRegistry is still null
* fix: Fixed an issue where AnimatableDrawable could not be played when used as a placeholder when
  resizeApplyToDrawable was turned on
* improve: ResourceUriFetcher now returns ResourceDataSource for raw resources
* improve: Sketch now changes all ImageView references to weak references, avoid false positives by
  LeakCanary
* change: Redesign ErrorStateImage
* change: 'exception: SketchException' for ImageResult.Error was changed to 'throwable: Throwable'
  and UnknownException was removed
* change: Remove HttpStack.getResponse() method suspend modifier
* change: BitmapDecoder, DrawableDecoder, Fetcher, BitmapDecodeInterceptor,
  DrawableDecodeInterceptor, RequestInterceptor return results wrapped in Result
* improve: Compatible with still images encoded using WebP Animated panpf Moments
  ago [#179](https://github.com/panpf/sketch/issues/179)
* improve: Improved memory caching, now all BitmapDrawable is converted to SketchCountBitmapDrawable
  in MemoryCacheRequestInterceptor and cached in memory, so all BitmapDecoders can return
  BitmapDrawable directly
* improve: IOException is no longer thrown when deleting disk cache files fails
* new: Size added Empty constant

#### sketch-zoom

* fix: Fixed a bug where SketchZoomImageView's auto-pause feature based on lifecycle could cause
  subsampling exceptions
* fix: Fixed a bug where subsampling could not work after scaling exceeded the maximum scale
* fix: Fixed a bug where the SketchZoomImageView.location() method crashed when Logger.level was
  VERBOSE
* improve: Subsampling can now be turned on when the aspect ratio differs by 0.50f

#### sketch-extensions

* improve: Use WeakReference to improve RingProgressDrawable and avoid false positives by LeakCanary

#### sketch-compose

* improve: AsyncImagePainter no longer converts BitmapDrawable and ColorDrawable to BitmapPainter
  and ColorPainter
* improve: Improve AsyncImage(), rememberAsyncImagePainter(), SubcomposeAsyncImage()

# v3.2.1-rc03

#### sketch

* improve: ResourceUriFetcher now returns ResourceDataSource for raw resources
* fix: Try again to fix the HttpUriFetcher.IOException exception that can't be
  caught [#176](https://github.com/panpf/sketch/issues/176)

# v3.2.1-rc02

#### sketch

* new: Size added Empty constant
* improve: Sketch now changes all ImageView references to weak references, avoid false positives by
  LeakCanary

#### sketch-zoom

* fix: Fixed a bug where SketchZoomImageView's auto-pause feature based on lifecycle could cause
  subsampling exceptions
* fix: Fixed a bug where subsampling could not work after scaling exceeded the maximum scale
* improve: Subsampling can now be turned on when the aspect ratio differs by 0.50f

#### sketch-extensions

* improve: Use WeakReference to improve RingProgressDrawable and avoid false positives by LeakCanary

# v3.2.1-rc01

### sketch

* change: Redesign ErrorStateImage

#### sketch-compose

* improve: AsyncImagePainter no longer converts BitmapDrawable and ColorDrawable to BitmapPainter
  and ColorPainter
* improve: Improve AsyncImage(), rememberAsyncImagePainter(), SubcomposeAsyncImage()

# v3.2.1-beta03

### sketch

* change: 'exception: SketchException' for ImageResult.Error was changed to 'throwable: Throwable'
  and UnknownException was removed
* improve: Compatible with still images encoded using WebP Animated panpf Moments
  ago [#179](https://github.com/panpf/sketch/issues/179)
* improve: Improved memory caching, now all BitmapDrawable is converted to SketchCountBitmapDrawable
  in MemoryCacheRequestInterceptor and cached in memory, so all BitmapDecoders can return
  BitmapDrawable directly

# v3.2.1-beta02

### sketch

* fix: Again try fixing child thread exceptions may not catch bugs that cause your app to
  crash [#176](https://github.com/panpf/sketch/issues/176)
* fix: When the merged() method of ImageOptions has its own componentRegistry as null and other’s
  componentRegistry is not null, the returned componentRegistry is still null
* fix: Fixed an issue where AnimatableDrawable could not be played when used as a placeholder when
  resizeApplyToDrawable was turned on
* change: Remove HttpStack.getResponse() method suspend modifier
* change: BitmapDecoder, DrawableDecoder, Fetcher, BitmapDecodeInterceptor,
  DrawableDecodeInterceptor, RequestInterceptor return results wrapped in Result
* improve: IOException is no longer thrown when deleting disk cache files fails

# v3.2.1-beta01

### sketch

* fix: Fixing child thread exceptions may not catch bugs that cause your app to
  crash [#176](https://github.com/panpf/sketch/issues/176)

# v3.2.0 stable

### sketch

* change: The DataSource's newInputStream() and file() methods are now split into
  BasedStreamDataSource and BasedFileDataSource
* new: Added supportAnimatedGif(), supportAnimatedWebp(), supportAnimatedHeif() for configuring gif
  in a more understandable way

### sketch-compose

* fix: Fixed a bug where the AsyncImage function was not compatible with compose version 1.3.1
* improve: Deprecate imageUri plus configBlock version of AsyncImage, add only the imageUri version
  instead
* upgrade: Upgrade compose 1.3.1

### sketch-extensions

* change: The deprecated AppIconBitmapDecoder does not need to be configured anymore
* new: Added supportAppIcon() for configuring app icons in a more understandable way
* new: Added supportApkIcon() for configuring apk icons in a more understandable way

### sketch-gif-koral

* new: Added supportKoralGif() for configuring gif in a more understandable way

### sketch-gif-movie

* new: Added supportMovieGif() for configuring gif in a more understandable way

### sketch-svg

* new: Added supportSvg() for configuring svg in a more understandable way

### sketch-video

* new: Added supportVideoFrame() for configuring video frame in a more understandable way

### sketch-video-ffmpeg

* new: Added supportFFmpegVideoFrame() for configuring video frame in a more understandable way

### other

* improve: Improved implementation of the equals method, which now always returns false when
  compared to subclasses
* upgrade: Upgrade compile sdk to 33
* upgrade: Upgrade androidx activity 1.6.1, annotation 1.5.0, appcompat 1.6.0, compose animation and
  ui 1.3.3, core 1.9.0, exifinterface 1.3.5, fragment 1.5.5

# v3.2.0-beta02

* upgrade: Upgrade androidx activity 1.6.1, annotation 1.5.0, appcompat 1.6.0, compose animation and
  ui 1.3.3, core 1.9.0, exifinterface 1.3.5, fragment 1.5.5

# v3.2.0-beta01

### sketch

* change: The DataSource's newInputStream() and file() methods are now split into
  BasedStreamDataSource and BasedFileDataSource
* new: Added supportAnimatedGif(), supportAnimatedWebp(), supportAnimatedHeif() for configuring gif
  in a more understandable way

### sketch-compose

* fix: Fixed a bug where the AsyncImage function was not compatible with compose version 1.3.1
* improve: Deprecate imageUri plus configBlock version of AsyncImage, add only the imageUri version
  instead
* upgrade: Upgrade compose 1.3.1

### sketch-extensions

* change: The deprecated AppIconBitmapDecoder does not need to be configured anymore
* new: Added supportAppIcon() for configuring app icons in a more understandable way
* new: Added supportApkIcon() for configuring apk icons in a more understandable way

### sketch-gif-koral

* new: Added supportKoralGif() for configuring gif in a more understandable way

### sketch-gif-movie

* new: Added supportMovieGif() for configuring gif in a more understandable way

### sketch-svg

* new: Added supportSvg() for configuring svg in a more understandable way

### sketch-video

* new: Added supportVideoFrame() for configuring video frame in a more understandable way

### sketch-video-ffmpeg

* new: Added supportFFmpegVideoFrame() for configuring video frame in a more understandable way

### other

* improve: Improved implementation of the equals method, which now always returns false when
  compared to subclasses
* upgrade: Upgrade compile sdk to 33

# v3.1.0 stable

### sketch

BitmapPool:

* fix: Fixed the bug that the put method of LruBitmapPool failed to put the second bitmap when
  encountering a bitmap with the same size and config but not the same instance
* improve: Improve LruBitmapPool

Decode:

* fix: Fixed BitmapPool will still be accessed when disallowReuseBitmap is true
* improve: Improve freeBitmap performance and reduce main thread lag
* new: BitmapDecodeInterceptor, DrawableDecodeInterceptor support sorting

Drawable:

* improve: Improve ScaledAnimatedImageDrawable

HTTP:

* change: Add the suspend keyword to the getResponse() method of HttpStack #167
* new: HurlStack and OkHttpStack now support enabling protocols such as TLS 1.1 and 1.2

MemoryCache:

* change: MemoryCache now stores MemoryCache.Value
* change: MemoryCache adds keys() method

DiskCache:

* fix: Fixed bug where process names could not be correctly obtained in APi 17 and later
* fix: Fixed a bug where the GET method of LruDiskCache throws NullPointException
* improve: LruDiskCache will now automatically delete cache records of lost files

Request:

* fix: Fixed a bug where equals to ImageRequest and their newRequest() result in false
* fix: Fixed a bug in RequestInterceptor where modifying SizeResolver does not take effect
* fix: Fixed the bug that the newRequest method of ImageRequest would nest one more layer of
  listener and progressListener every time it called
* improve: Improve the request key and cacheKey
* new: RequestInterceptor support sorting

Resize:

* remove: Remove fixedPrecision(), longImageClipPrecision(), fixedScale(), longImageScale()
  functions
* change: To refactor the Resize
* change: Simplification resize() overloading method of ImageOptions and ImageRequest
* change: resize precision default changed to always LESS_PIXELS
* change: ResizeDrawable now uses Size and Scale directly
* improve: LongImageScaleDecider construction parameters now have default values

StateImage:

* change: Now getDrawable for the placeholder and error StateImage is null and no longer calls
  setImageDrawable for the ImageView
* new: Added ThumbnailMemoryCacheStateImage #166
* new: Now the final state Drawable implements the SketchStateDrawable interface

Other:

* remove: Remove BitmapInfo
* improve: Reduce w-level logs to avoid performance impact due to logs
* improve: Improve Equals and hashCode
* improve: Improve the code
* improve: Improve the log

### sketch-compose

* fix: Fixed bug where AsyncImage and SubcomposeAsyncImage would cause constant recomposition
* fix: Fixed AsyncImage and AsyncImagePainter always change resize precision to EXACTLY bug
* fix: Fixed bug that AsyncImagePainter did not inherit CrossfadeTransition.Factory.fadeStart
  property
* fix: Fixed bug where AsyncImagePainter would ignore nested Drawables when updating display count
* improve: AsyncImage now uses dedicated DisplayTarget, SizeResolver, ScaleDecider
* build: Upgraded appcompanist to 0.25.1

### sketch-extensions

* change: Replace PauseLoadWhenScrollingDisplayInterceptor with
  PauseLoadWhenScrollingDrawableDecodeInterceptor, And remove pauseLoadWhenScrollingError()

### sketch-gif-movie

* improve: Improve MovieDrawable

### sketch-gif-koral

* improve: Improve GifDrawableDrawableDecoder
* improve: To unify various Gif Drawable logic MovieDrawable no longer uses BitmapPool

### sketch-zoom

* improve: Improve SketchZoomImageView scroll bar style
* fix: Fixed the bug that SketchZoomImageView will still access MemoryCache when the read or write
  of memoryCachePolicy is not ENABLED
* fix: Fixed a bug where SketchZoomImageView would also trigger subsampling when encountering a
  state image
* fix: Fixed a bug where SketchZoomImageView might sometimes sample tiles not loading
* fix: Fixed the bug that when SketchZoomImageView is nested in ViewPager, it cannot return the
  swipe event to ViewPager when it reaches the edge and then swipes
* change: Refactor Scales. Scales rename to ScaleState，SketchImageView's scalesFactory property
  rename to scaleStateFactory
* improve: Improve zoom

### other

* build: compileSdk upgraded to 32
* build: Upgrade android build plugin 7.3.1 and kotlin 1.7.20

# v3.1.0-rc02

### sketch

* fix: Fixed bug where process names could not be correctly obtained in APi 17 and later
* improve: To unify various Gif Drawable logic MovieDrawable no longer uses BitmapPool
* new: RequestInterceptor, BitmapDecodeInterceptor, DrawableDecodeInterceptor support sorting
* new: HurlStack and OkHttpStack now support enabling protocols such as TLS 1.1 and 1.2

### sketch-zoom

* fix: Fixed a bug that caused SketchZoomImageView to run out of memory when swiping quickly
* improve: Improve SketchZoomImageView scroll bar style

# v3.1.0-rc01

### sketch

* fix: Fixed bug where requestKey did not decode
* fix: Fixed a bug where the GET method of LruDiskCache throws NullPointException
* change: To refactor the Resize
* change: ResizeDrawable now uses Size and Scale directly

# v3.1.0-beta04

### sketch

Request:

* fix: Fixed a bug where equals to ImageRequest and their newRequest() result in false
* fix: Fixed a bug in RequestInterceptor where modifying SizeResolver does not take effect
* fix: Fixed the bug that the newRequest method of ImageRequest would nest one more layer of
  listener and progressListener every time it called
* improve: Improve the request key and cacheKey

Resize:

* change: Simplification resize() overloading method of ImageOptions and ImageRequest
* change: resize precision default changed to always LESS_PIXELS

DiskCache:

* improve: LruDiskCache will now automatically delete cache records of lost files

StateImage:

* change: Now getDrawable for the placeholder and error StateImage is null and no longer calls
  setImageDrawable for the ImageView

Other:

* improve: LongImageScaleDecider construction parameters now have default values
* improve: Reduce w-level logs to avoid performance impact due to logs
* improve: Improve ScaledAnimatedImageDrawable
* improve: Improve Equals and hashCode
* improve: Improve the code
* improve: Improve the log

### sketch-extensions

* change: Replace PauseLoadWhenScrollingDisplayInterceptor with
  PauseLoadWhenScrollingDrawableDecodeInterceptor, And remove pauseLoadWhenScrollingError()

### sketch-compose

* fix: Fixed bug where AsyncImage and SubcomposeAsyncImage would cause constant recomposition
* fix: Fixed AsyncImage and AsyncImagePainter always change resize precision to EXACTLY bug
* fix: Fixed bug that AsyncImagePainter did not inherit CrossfadeTransition.Factory.fadeStart
  property
* fix: Fixed bug where AsyncImagePainter would ignore nested Drawables when updating display count
* improve: AsyncImage now uses dedicated DisplayTarget, SizeResolver, ScaleDecider

### sketch-gif-movie

* improve: Improve MovieDrawable

### sketch-gif-koral

* improve: Improve GifDrawableDrawableDecoder

# v3.1.0-beta03

### sketch

* fix: Fixed BitmapPool will still be accessed when disallowReuseBitmap is true
* remove: Remove fixedPrecision(), longImageClipPrecision(), fixedScale(), longImageScale()
  functions
* remove: Remove BitmapInfo
* improve: Improve freeBitmap performance and reduce main thread lag
* new: Now the final state Drawable implements the SketchStateDrawable interface

### sketch-zoom

* fix: Fixed the bug that SketchZoomImageView will still access MemoryCache when the read or write
  of memoryCachePolicy is not ENABLED
* fix: Fixed a bug where SketchZoomImageView would also trigger subsampling when encountering a
  state image

# v3.1.0-beta02

### sketch

* improve: Improve LruBitmapPool
* fix: Fixed the bug that the put method of LruBitmapPool failed to put the second bitmap when
  encountering a bitmap with the same size and config but not the same instance

### sketch-zoom

* bug: Fixed a bug where SketchZoomImageView might sometimes sample tiles not loading
* bug: Fixed the bug that when SketchZoomImageView is nested in ViewPager, it cannot return the
  swipe event to ViewPager when it reaches the edge and then swipes
* change: Refactor Scales. Scales rename to ScaleState，SketchImageView's scalesFactory property
  rename to scaleStateFactory
* improve: Improve zoom

# v3.1.0-beta01

### sketch

* change: MemoryCache now stores MemoryCache.Value
* change: MemoryCache adds keys() method
* change: Add the suspend keyword to the getResponse() method of HttpStack #167
* new: Added InexactlyMemoryCacheStateImage #166

### sketch-zoom

* improve: Improve zoom

# v3.0.0 stable

New version, new beginning

* change: maven groupId changed to `io.github.panpf.sketch3`, so version 2.\* will not prompt to
  upgrade
* change: Changed the package name to `com.github.panpf.sketch` so it won't conflict with the 2.\*
  version
* change: Based on kotlin coroutine rewrite, API and function implementation are all changed, just
  use a new library
* improve: It is no longer required to use SketchImageView, any ImageView and its subclasses can,
  combined with custom Target can support any View
* improve: The Zoom function is split into independent modules that can be independently relied on,
  and the large image sampling function is refactored and multi-threaded decoding is faster.
* improve: The gif module now directly depends on the [android-gif-drawable] library and no longer
  needs to be modified twice, and can be upgraded by itself
* new: Added support for SVG
* new: Added support for Jetpack Compose
* new: Support for request and decode interceptors
* new: Refer to [coil] v2.2.0 version and combine it with the original functions of sketch. Compared
  with [coil], there are the following differences:
    * Sketch supports minimum API 16, while [coil] only supports API 21 minimum
    * Sketch supports bitmap multiplexing, but [coil] does not
    * Sketch supports finer adjustment of image size
    * Sketch clearly distinguishes between display, load, and download requests
    * Sketch provides a picture zoom display component and supports large picture sampling

# v3.0.0-rc10

### sketch

* fix: Fixed the bug that the transformedList of the DrawableDecodeResult returned by
  DefaultDrawableDecoder was always null
* change: RequestInterceptor, BitmapDecodeInterceptor and DrawableDecodeInterceptor add key
  attribute
* improve: Improve HttpUriFetcher
* new: Added 'extras: Map<String, String>' property to DisplayResult and LoadResult to facilitate
  passing more information during decoding or transform stage
* new: ImageRequest and ImageOptions supports ComponentRegistry, you can configure components that
  only work on the current ImageRequest

# v3.0.0-rc09

### sketch

* fix: Fixed the bug that BitmapResultCacheDecodeInterceptor may cause multiple writes to the cache
  when the same image is loaded multiple times
* improve: BlurTransformation now actively recycles intermediate bitmaps

# v3.0.0-rc08

### sketch

* fix: Fixed the bug that BlurTransformation put input Bitmap to BitmapPool causing exception
* improve: Logger now outputs thread name
* improve: The log level for DepthException errors is now WARNING
* improve: LruBitmapPool intercepts repeated put the same bitmap
* improve: The history of the Bitmap can now be obtained from the log
* improve: Added ImageInvalidException to specifically represent invalid image file exceptions

# v3.0.0-rc07

### sketch

* rename: ImageView.result rename to ImageView.displayResult
* rename: ImageView.dispose() rename to ImageView.disposeDisplay()
* new: Size adds isSameAspectRatio extension function
* fix: No longer use getRunningAppProcesses() method to avoid failure of privacy audit

### sketch-zoom

* improve: Improve reset log of SketchZoomImageView

# v3.0.0-rc06

### sketch

* change: The DataSource.file() method removes the suspend tag
* improve: Remove url escape characters in ImageRequest key and cacheKey

### sketch-zoom

* fix: Fixed the bug that the tile and preview image of SketchZoomImageView are misplaced

# v3.0.0-rc05

### sketch

* fix: Fixed the bug that BitmapResultCacheDecodeInterceptor still writes Bitmap to the result cache
  when BitmapDecodeResult.transformedList is empty
* improve: Improve toString of FixedScaleDecider and FixedPrecisionDecider

# v3.0.0-rc04

### sketch

* rename: transition rename to transitionFactory
* rename: Resize's precision and scale rename to precisionDecider and scaleDecider
* improve: Manually close ImageDecoder
* improve: Improved Parameters
* improve: CircleCropTransformation now defaults to get scale from ImageRequest.resizeScaleDecider
* new: CrossfadeTransition now supports setting fadeStart

### sketch-video/sketch-video-ffmpeg

* rename: videoFramePercentDuration rename to videoFramePercent
* improve: Improve exception information for VideoFrameBitmapDecoder and
  FFmpegVideoFrameBitmapDecoder

### sketch-svg

* new: Support setting custom CSS rules for SVG

### sketch-compose

* improve: Improve AsyncImage based on coil v2.1.0

# v3.0.0-rc03

### sketch

* fix: Fixed the bug that the callback of the sub-drawables of CrossfadeDrawable, IconDrawable,
  ScaledAnimatedImageDrawable would be lost, causing the sub-animation Drawable to fail to play
* change: CrossfadeDrawable default duration changed from 100ms to 200ms
* new: Added 'exist(): Boolean' method to BitmapPool and DiskCache

### sketch-extensions

* improve: Improved animation of RingProgressDrawable

### other:

upgrade: Upgrade the latest version of kotlin and androidx library

# v3.0.0-rc02

### sketch

* change: RequestInterceptor is now executed on the main thread and Target.start() is now executed
  after checking the memory cache
* change: BitmapPool remove setInBitmap(), setInBitmapForRegion(), free
* improve: MemoryCache no longer needs edit lock

### sketch-zoom

* fix: Fixed the bug that SketchZoomImageView location() is not as expected
* fix: Fixed the bug that the center point pans when SketchZoomImageView zooms with one finger
  up [#160](https://github.com/panpf/sketch/issues/160)
* improve: SketchZoomImageView translate image during scale
* improve: Improve SketchZoomImageView

### sketch-gif-koral

* improve: 'sketch-gif-koral' no longer depends on 'sketch-gif-movie'

# v3.0.0-rc01

### sketch

Cache:

* fix: Fixed the bug that LruBitmapPool does not support RGBA_F16
* change: Now the download cache directory name is 'download', and the result cache directory name
  is 'result'
* change: LruMemoryCache.put() now intercepts larger bitmaps
* rename: downloadDiskCache rename to downloadCache, resultDiskCache rename to resultCache,
  DISK_CACHE rename to DOWNLOAD_CACHE, RESULT_DISK_CACHE rename to RESULT_CACHE
* improve: Improve disk cache

Request:

* fix: Fixed the bug that the bitmap cannot be placed in the BitmapPool without using CountBitmap
  when the memory cache is disabled
* change: Now RequestInterceptor runs in worker thread, and Target.onStart() is executed before
  RequestInterceptor
* change: Remove Transformed and JsonSerializable
* change: Refactor DownloadData
* change: imageExifOrientation property merged into ImageInfo
* new: Restore Sketch.globalImageOptions, because now placeholder is used before request interceptor

Decoder:

* fix: Fixed BaseAnimatedImageDrawableDecoder registration callback is crash bug
* fix: Fixed the bug that Bitmap read from Result cache is always immutable

### sketch-extensions

* rename: SketchImageView's registerListener(), unregisterListener(), registerProgressListener(),
  unregisterProgressListener() rename to registerDisplayListener(), unregisterDisplayListener(),
  registerDisplayProgressListener(), unregisterDisplayProgress

# v3.0.0-beta06

### sketch

Decoder:

* fix: Fixed the bug that XmlDrawableBitmapDecoder do not support bitmapConfig

Sketch:

* remove: Remove Sketch.globalImageOptions
* remove: Removed Sketch.longImageDecider and can now specify LongImageDecider when creating
  LongImageScaleDecider, LongImageClipPrecisionDecider, LongImageReadModeDecider

ImageRequest:

* change: ImageRequest.Builder.global() rename to default()
* change: The type of the error property of ImageOptions and ImageRequest is changed to
  ErrorStateImage

Other:

* fix: Fixed ImageOptions bug that error is still null when stateImage is null and configBlock is
  not null
* improve: DepthException no longer prints stack information

### sketch-extensions

* fix: Fixed a bug where the click to ignore cellular data saving feature did not work
* fix: Fixed the bug that ApkIconBitmapDecoder, AppIconBitmapDecoder do not support bitmapConfig

### sketch-zoom

* new: SketchZoomImageView added touchPointToDrawablePoint method

# v3.0.0-beta05

### sketch

Decoder:

* fix: Fixed the bug that XmlDrawableBitmapDecoder does not support loading vector resources from
  other packages in versions below 7.0
* improve: Replace ResourcesCompat with AppCompatResources

Logger:

* rename: Logger's construction parameter _level is rename to level

* fix: Fixed the bug of abnormal transparency of placeholder drawable

DataSource:

* remove: DataSource remove newFileDescriptor method

DiskCache:

* change: Sketch.diskCache split into downloadDiskCache and resultDiskCache
* change: Change the version attribute of LruDiskCache to appVersion and add the internalVersion
  attribute

ImageRequest:

* new: Add enqueue() and execute() methods for DisplayRequest, DownloadRequest, LoadRequest

Fetcher:

* new: Added newResourceUri(String, String) and newResourceUri(Int) function
* new: Added newResourceUri(String, String) and newResourceUri(Int) function
* new: Added newFileUri(File) function

SketchImageView:

* new: SketchImageView added registerListener(), unregisterListener(), registerProgressListener(),
  unregisterProgressListener() method

Transformation:

* new: Added BlurTransformation and MaskTransformation

Transition:

* new: CrossfadeTransition.Factory added alwaysUse property

StateImage:

* new: Added CurrentStateImage

### sketch-zoom

* fix: Fixed a bug where SketchZoomImageView would cause ViewPager to fail to slide
* change: Now move ZoomAbility's functional methods into SketchZoomImageView

# v3.0.0-beta04

Resize:

* fix: Fixed the bug that the final image content is wrong when precision is LESS_PIXELS and the
  image size is smaller than the resize size

# v3.0.0-beta03

Target:

* rename: ViewTarget rename to ViewDisplayTarget
* new: Added RemoteViewsDisplayTarget to display image to RemoteViews

DiskCache:

* fix: Fixed the bug that the contentType disk cache does not take effect

MemoryCache:

* log: Improved log for LruMemoryCache and LruDiskCache

ViewAbility:

* new: ViewAbility support onSaveInstanceState() and onRestoreInstanceState()

Other:

* fix: Fixed the bug that the ResizeAnimatableDrawable stop() method does not take effect
* remove: DepthException removes the depth property, UriInvalidException removes the uri property
* remove: SketchException no longer contains ImageRequest
* remove: SketchException no longer contains ImageRequest
* change: The message of UnknownException cannot be null
* improve: Improve the code

Docs:

* docs: Improve docs

Build:

* build: Improve build
* build: Add project icon for IntelliJ project list

# v3.0.0-beta02

* fix: Fixed the bug that the length() method of AssetDataSource and ResourceDataSource crashed in
  versions below KITKAT
* remove: Remove BlurTransformation
* change: In order to be compatible with the bug of webp in JELLY_BEAN_M3 and below versions, the
  imageType is no longer checked after decoding the Image boundary information
* change: DiskCache implements the Closeable interface and close it when Sketch shutdown
* new: ImageOptions and ImageRequest add resize(Resize?) method
* new: SketchDrawable adds requestCacheKey property

# v3.0.0-beta01

### sketch

ImageRequest:

* fix: Fixed the bug that the cacheKey of ImageRequest always contains the parameter whose cacheKey
  is null
* improve: Improve the return result of ImageRequest's newKey() and newCacheKey() methods
* new: DisplayResult, DisplayData, LoadResult, LoadData increased imageExifOrientation and
  transformedList properties

Decode:

* fix: InSampledTransformed is not added when the decoded Bitmap is not shrunk
* improve: Use BufferedInputStream when decoding to improve decoding speed

HTTP:

* fix: Fixed the bug of deduplication in the addExtraHeaders() method of HurlStack.Builder

StateImage:

* rename: newErrorStateImage() rename to ErrorStateImage()

AnimatedImage:

* change: repeatCount() , animationStartCallback(), animationEndCallback(), animatedTransformation()
  extension methods are changed to extension properties

### sketch-extensions

* rename: showMimeTypeLogoWithResId() rename to showMimeTypeLogoWithRes()
* rename: ArcProgressDrawable rename to SectorProgressDrawable
* improve: RingProgressDrawable and SectorProgressDrawable constructor parameters now have default
  values

### sketch-viewability

* improve: Improve ViewAbility

### sketch-okhttp

* fix: Fixed the bug of deduplication in the addExtraHeaders() method of OkHttpStack.Builder

### sketch-video

* change: videoFrameMicros(), videoFramePercentDuration(), videoFrameOption() extension methods are
  changed to extension properties

# v3.0.0-alpha04

### sketch

ImageRequest:

* fix: Fixed the bug that GlobalLifecycle does not adapt to LifecycleEventObserver, causing the
  request to fail when the target is not ViewTarget
* remove: Remove lowQualityBitmapConfig() and highQualityBitmapConfig()
* remove: Remove the downloadDiskCacheKey property of ImageRequest
* remove: Remove MIDDEN_QUALITY
* remove: DisplayRequest, DownloadRequest, LoadRequest, ImageOptions remove Builder top-level
  creation functions
* rename: errorImage rename to error
* rename: placeholderImage rename to placeholder
* rename: disabledAnimatedImage rename to disallowAnimatedImage
* rename: disabledReuseBitmap rename to disallowReuseBitmap
* rename: RequestDepth rename to Depth
* rename: LOW_QUALITY rename to LowQuality, HIGH_QUALITY rename to HighQuality
* rename: downloadDiskCachePolicy rename to downloadCachePolicy, bitmapResultDiskCachePolicy rename
* rename: The resizeSize(SizeResolver) method of ImageRequest and ImageOptions has been renamed to
  resizeSizeResolver(SizeResolver)
* rename: The merge() method of HttpHeaders and Parameters has been renamed to merged()
  to resultCachePolicy, bitmapMemoryCachePolicy rename to memoryCachePolicy
* change: depthFrom moved to 'sketch-extensions' module
* change: ImageRequest no longer holds Sketch
* change: ScreenSizeResolver rename to DisplaySizeResolver
* change: DisplayRequest(String?, ImageView, (DisplayRequest.Builder.() -> Unit)) method signature
  changed to DisplayRequest(ImageView, String?, (DisplayRequest.Builder.() -> Unit))
* change: Refactor ImageRequest and ImageOptions resize
* change: Now GenericViewTarget updates drawable on errors even if errorDrawable is null
* improve: All ImageResult implementations are now data classes
* improve: ImageRequest uses ImageOptions to store property
* new: HttpHeaders added newHttpHeaders(), Parameters added newParameters()
* new: ImageRequest adds newMemoryCacheKey(), newResultCacheDataKey(), newResultCacheMetaKey()
  extension methods
* new: Added isNotEmpty() extension method to HttpHeaders and ImageOptions

Sketch:

* remove: Remove static ComponentRegistry.new()
* rename: ComponentRegistry.new() rename to newRegistry()
* change: addRequestInterceptor(), addBitmapDecodeInterceptor(), addDrawableDecodeInterceptor() from
  Sketch moved to ComponentRegistry
* new: Sketch added shutdown() method

Decoder:

* fix: Fixed the bug of samplingSizeForRegion() returning wrong result in api 24 and 25
* fix: Fixed the bug that the returned Bitmap has the wrong size when the difference between the
  resize and the original image's number of pixels does not exceed 10% and the precision is
  LESS_PIXELS
* fix: Fixed bug that resizePrecision is 'EXACTLY' when resizeSize is not set
* fix: Fixed HARDWARE crash when setting inBitmap
* move: ImageFormat move to 'com.github.panpf.sketch.decode.internal' package
* rename: calculateSamplingSize() rename to samplingSize(), calculateSamplingSizeForRegion() rename
* removes: BitmapPool's get() method removes the operator
* change: ImageFormat.valueOfMimeType() change to mimeTypeToImageFormat()
* change: DecodeInterceptor is split into BitmapDecodeInterceptor and DrawableDecodeInterceptor
* change: RequestExtras and CountDrawablePendingManager merged into RequestContext
* change: No longer scales resize by 10% when calculating inSampleSize
* change: precision is LESS_PIXELS must not use BitmapRegionDecoder
* improve: ApkIconBitmapDecoder and AppIconBitmapDecoder now supported bitmapConfig panpf 23 minutes
  ago
* improve: Improve the decision rule of DrawableDecoder.Factory
* improve: Improved DefaultDrawableDecoder to samplingSizeForRegion()
* new: Added Bitmap.Config.isAndSupportHardware()

Transformation:

* fix: Fixed the bug that if the Bitmap of the transformation result is not new, the current Bitmap
  is incorrectly reclaimed, causing a crash
* improve: Improve Transformation

Cache:

* fix: Fixed a crash bug when adding an existing cache to LruMemoryCache
* improve: Improve logging for CountBitmap and LruBitmap
* improve: Clear enough space before put
* improve: Improve LruBitmapPool's setInBitmap() and setInBitmapForRegion()
* new: MemoryCache adds exist(String) method

Fetcher:

* rename: FetchResult.from rename to dataFrom

Transition:

* move: TransitionTarget's view property moved to Transition.Factory.create() method

other:

* improve: Added equals and hashCode implementations
* comment: Add code comments

### sketch-gif-koral

* fix: Fixed the bug that the transformedList of DrawableDecodeResult returned by
  GifDrawableDrawableDecoder was always null

### sketch-zoom

* fix: Fixed the bug that some pictures could not use the large block picture function
* fix: Fixed a crash bug when the preview image ratio was inconsistent with the original image ratio

# v3.0.0-alpha03

### sketch

* fix: Fixed a bug where GifDrawable would not automatically pause due to the
  ViewTargetRequestDelegate.start() method incorrectly removing the observation of Lifecycle
* change: Now as long as resizeSize or resizeSizeResolver is set, the default Precision is EXACTLY
* change: RequestManagerUtils merged into SketchUtils
* change: Now DefaultLongImageDecider is split into smallRatioMultiple and bigRatioMultiple
* change: Change SketchConfigurator to SketchFactory
* change: Now key components such as DataSource, BitmapDecoder, DrawableDecoder, Fetcher, HttpStack,
  RequestInterceptor, StateImage, Transformation, DecodeInterceptor will use Sketch carried by
  ImageRequest
* change: Now you need to pass Resources when creating SketchBitmapDrawable
* new: Now the ImageRequest will only be executed if the Lifecycle reaches the Started state
* new: Added a series of displayImage overloaded methods for ImageView, such as displayImage(Int),
  displayImage(Uri), displayImage(File), displayAssetImage(String), etc.

### sketch-zoom

* fix: Fixed a bug where Tiles didn't reset when View size changed
* fix: Fixed a bug that SketchZoomImageView zoomed abnormally when not SketchDrawable
* fix: Fixed a crash bug in Zoomer's rotateTo() method
* fix: Fixed the bug that SketchZoomImageView always intercepts touch events when no Drawable is
  set, causing ViewPager to fail to slide left and right
* change: ZoomAbility 's zoomScale, baseZoomScale, supportZoomScale, fullZoomScale, fillZoomScale,
  originZoomScale, minZoomScale, maxZoomScale and doubleClickZoomScales properties renamed to scale,
  baseScale, supportScale, fullScale, fillScale, originScale, minScale, maxScale and stepScales
* improve: Tiles are now not enabled when the current zoom is less than or equal to the minimum zoom
* improve: Improve Zoomer's code
* improve: ZoomAbility now listens to Lifecycle's ON_START and ON_STOP events instead to pause and
  resume Tiles
* improve: ZoomAbility will get the lifecycle from the priority ImageRequest

### sketch-gif-koral

* upgrade: Upgrade to version 1.2.15 of the android-gif-drawable library

# v3.0.0-alpha02

### sketch

* fix: Fixed bug that AnimatedImageDrawable doesn't support scaling via bounds
* fix: Fixed a bug with incorrect transparency when using VectorDrawable as state image
* change: All implementations of DisplayTarget now do not continue to set when the error Drawable is
  empty
* change: Scale.KEEP_ASPECT_RATIO renamed to SAME_ASPECT_RATIO
* improve: CrossfadeDrawable now reverts to using the maximum size of the start and end Drawable as
  intrinsic width and height
* improve: ColorResStateImage is merged into ColorStateImage, DrawableResStateImage is merged into
  DrawableStateImage
* improve: The bg property of IconStateImage now supports Drawable
* improve: Access control for all utility functions is now internal
* improve: LongImageClipPrecisionDecider now uses Sketch.longImageDecider by default to determine
  long images
* new: ImageRequest and ImageOptions added resizeApplyToDrawable property IconDrawableStateImage and
  IconDrawableStateImage merged into IconStateImage
* new: Resize's scale property now supports ScaleDecider and provides a LongImageScaleDecider
  implementation

### sketch-extensions

* new: SketchImageView adds xml attribute

### sketch-zoom

* fix: Fixed a bug where the findSampleSize function might crash
* change: The readMode of SketchZoomImageView is now off by default
* improve: Change DefaultReadModeDecider to LongImageReadModeDecider, and use
  Sketch.longImageDecider by default to determine long images

### sketch-compose

* improve: Improved CrossfadePainter

# v3.0.0-alpha01

New version, new beginning

* change: maven groupId changed to `io.github.panpf.sketch3`, so version 2.\* will not prompt to
  upgrade
* change: Changed the package name to `com.github.panpf.sketch` so it won't conflict with the 2.\*
  version
* change: Based on kotlin coroutine rewrite, API and function implementation are all changed, just
  use a new library
* improve: It is no longer required to use SketchImageView, any ImageView and its subclasses can,
  combined with custom Target can support any View
* improve: The Zoom function is split into independent modules that can be independently relied on,
  and the large image sampling function is refactored and multi-threaded decoding is faster.
* improve: The gif module now directly depends on the [android-gif-drawable] library and no longer
  needs to be modified twice, and can be upgraded by itself
* new: Added support for SVG
* new: Added support for Jetpack Compose
* new: Support for request and decode interceptors
* new: Refer to [coil] v2.2.0 version and combine it with the original functions of sketch. Compared
  with [coil], there are the following differences:
    * Sketch supports minimum API 16, while [coil] only supports API 21 minimum
    * Sketch supports bitmap multiplexing, but [coil] does not
    * Sketch supports finer adjustment of image size
    * Sketch clearly distinguishes between display, load, and download requests
    * Sketch provides a picture zoom display component and supports large picture sampling

[coil]: https://github.com/coil-kt/coil

[android-gif-drawable]: https://github.com/koral--/android-gif-drawable