SD WebImage Files

See all tickets marked for the 5.21.0 release

Features

HDR Decoding

• Supports HDR decoding on Apple ImageIO coder (avif/heic/jpeg-xl, etc) [#3778]
• • Note: Defaults to always use SDR, if you want HDR decoding, pass SDWebImageContextDecodeToHDR: @(YES) to context option. Pay attention even decoded CGImage is HDR ready, full rendering require display hardware support and per-image-view level control, it's recommended to read WWDC23 and use proper API to check for current display headroom to turn on HDR.
• • Note: Apple ImageIO coder requires macOS 14/iOS 17+ for HDR decoding. For lower firmware you can consider AVIF/HEIF/JPEG-XL third-party codec

HDR Encoding

• Supports HDR encoding on Apple ImageIO coder [#3799]
• • Note: Defaults to always use SDR, if you want HDR dencoding, pass SDImageCoderEncodeToHDR: @(SDImageHDRTypeISOHDR) for ISO HDR encoding. And SDImageHDRTypeISOGainMap for ISO Gain Map based HDR encoding (like JPEG for compatibility)
• • Note: Apple ImageIO coder requires macOS 15/iOS 18+ for HDR encoding. For lower firmware you can consider AVIF/HEIF/JPEG-XL third-party codec

Transformer

• Allows user to directly customize preserveImageMetadata for our built-in transformers [#3796]

UI Category

• Change the default callback queue policy to SafeAsyncMainThread, don't need main queue check at all [#3797]
• • Note: This should make sd_setImageWithURL related UI API to work on case like UICollectionViewDiffableDataSource , which is running on main thread but not main queue.

Fixes

• fix: sd_colorAtPoint/sd_colorsWithRect should early return when pixel format is not supported [#3798]
• • Note: In history this may return a wrong color for RGB10/RGB16 pixel format. Now it just return nil, which may supported in the future.