ImageIO HEIF/AVIF plugin

Requirements

libheif version 1.16+ must be installed on the target system.

Known installations methods

• Homebrew (Mac & Linux): brew install libheif
• apt (Linux): apt-get install libheif-dev

Features

• Decode HEIF and AVIF images
• Encode HEIF and AVIF images

Limitations

• Decoding
  • HEIC and AVIF animations are not supported. A single image is returned.
  • Not implemented yet:
    • Color profiles
    • EXIF and XMP metadata
    • Thumbnails
• Encoding
  • animations are not supported. A single image is written.
  • Not implemented yet:
    • Color profiles
    • EXIF and XMP metadata
    • Thumbnails

Encoding parameters

In order to configure the encoding, you will need to use a HeifWriteParam:

HeifWriteParam param = (HeifWriteParam) writer.getDefaultWriteParam();
// you need to check the available compression types, and choose the one you want
String compressionType = param.getCompressionTypes()[0];

param.setCompressionMode(ImageWriteParam.MODE_EXPLICIT);
param.setCompressionType(compressionType);

// lossless
param.setLossless(true);

// lossy
param.setLossless(false);
param.setCompressionQuality(0.75F);

Implementation notes

The panama package bindings were generated using:

• jextract 22
• from the https://github.com/strukturag/libheif repository, version 1.16.0
• based on the heif.f header file