CHANGELOG.md

Change Log

Translations: 简体中文

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

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
• 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

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
• 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
• 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

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
• 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
• 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

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
• 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