Pillow-heif

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

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](https://github.com/strukturag/libde265/releases/tag/v1.0.15)
- libheif updated from `1.17.5` to `1.17.6`. [changelog](https://github.com/strukturag/libheif/releases/tag/v1.17.6)

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](https://github.com/strukturag/libde265/releases/tag/v1.0.13)

Fixed

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

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

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.

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](https://github.com/strukturag/libde265/releases/tag/v1.0.12)
- `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 the numpy array.