v0.21.0

Added

• Allow specifying encoder parameters for non-primary images in image sequence. #313

Changed

• Libheif updated from 1.18.2 to 1.19.5 version. #312
• For macOS(x86_64), the minimum supported version for binary wheels has been raised from 12 to 13.

Fixed

• Error argument '-Ofast' is deprecated when building from source. #305

v0.20.0

Added

• Initial support for parsing auxiliary images. #297 Thanks to @johncf

Changed

• libheif updated from 1.18.1 to 1.18.2 version. #278
• Dropped Python 3.8 support. #293

Fixed

• More accurate error handling in the C module. #298 Thanks to @johncf
• Support for Pillow 11.0.0 #294

v0.18.0

Added

• image.info["heif"] dictionary with camera_intrinsic_matrix HEIF specific metadata. Currently only reading is supported. #271

Changed

• libheif updated from 1.17.6 to 1.18.1 version. #249
• Python 3.13.0b3 wheels added; macOS arm64 Python3.8 wheels dropped. #272

v0.17.0

Added

• Support for Pillow 10.4.0 #254

Changed

• Minimum supported Pillow version raised to 10.1.0. #251
• xmp in info dictionary is now not present if it is empty. #254

Fixed

• Processing of the images in P mode with transparency = 0. #238

v0.16.0

This release contains breaking change for monochrome images.

Added

• Monochrome images without alpha channel, will be opened in L or I;16 mode instead of RGB. #215

Changed

• convert_hdr_to_8bit value now ignores monochrome images. #215
• subsampling parameter for encoding has higher priority than chroma. #213
• Minimum required libehif version is 1.17.0. #214
• Minimum supported Pillow version raised to 9.5.0. #216

v0.15.0

Added

• libheif_info function: added encoders and decoders keys to the result, for future libheif plugins support. #189
• options.PREFERRED_ENCODER - to use encoder different from the default one. #192
• options.PREFERRED_DECODER - to use decoder different from the default one. #193

Changed

• libde265 updated from 1.0.14 to 1.0.15. changelog
• libheif updated from 1.17.5 to 1.17.6. changelog

v0.14.0

Added

• Synonym for chroma encoder parameter: subsampling(usage is the same as in Pillow JPEG). #161 #165
• Passing image_orientation value to libheif, instead of manually rotating image according to EXIF before encoding. #168
• Pillow plugin: support for images in YCbCr mode for saving without converting to RGB. #169
• Pi-Heif: Python3.12 32-bit armv7 wheels. #160

Changed

• Increased the minimum required libheif version to 1.14.1.
• Linux: When building from source, libheif and other libraries are no longer try built automatically. #158
• Libheif updated from 1.16.2 to 1.17.5 version. #166 #175
• NCLX color profile - was reworked, updated docs, see PR for more info. #171
• Minimum supported Pillow version raised to 9.2.0.
• Pi-Heif: As last libheif version requires minimum cmake>=3.16.3 dropped Debian 10 armv7 wheels. #160
• libde265 updated from 1.0.12 to 1.0.14. changelog

Fixed

• Support of libheif 1.17.x. #156
• Windows : Build from source with MinGW Python. #178

v0.13.1

Added

• Returned PyPy 3.8 wheels.

Changed

• Linux: libaom updated to 3.6.1, musllinux builds switched to musllinux_1_2 tag.

Fixed

• When building from source, the installer additionally searches for libheif using pkg-config. #128

v0.13.0

Added

• Python 3.12, PyPy 3.10 wheels.
• Depth Image read support, they are available as a list in im.info["depth_images"] #116
• options.SAVE_NCLX_PROFILE - default False to be full compatible with previous versions, but in next versions may be changed to True. #118 Thanks to @wiggin15
• Support for Pillow 10.1.0

Changed

• The license for the project itself has been changed to "BSD-3-Clause" since "Apache 2.0" is not compatible with the "x265" encoder. #111 Thanks to @mattip
• Minimum required Pillow version increased from 8.4.0 to 9.1.1
• Dropped Python 3.7 support, PyPy 3.8 wheels.
• Dropped 32-bit wheels for Pillow-Heif. Pi-Heif still have 32-bit wheels.

v0.12.0

This release is fully compatible with previous versions.

Added

• (Heif) restored lost ability after 0.9.x versions to open HDR images in 10/12 bit. #96

Changed

• libde265(HEIF decoder) updated from 1.0.11 to 1.0.12 version. changelog
• libheif updated to 1.16.2.

Fixed

• Building from source when using apt-repository ppa:strukturag/libheif
• (Heif) encode function with stride argument correctly saves image.
• (Heif) HeifFile class created with from_bytes function with stride argument respect stride value during save.
• (Heif) HeifFile class created with from_bytes function with stride argument can correctly translate to numpy array.