WICHeifCompressionOption enumeration (wincodec.h)

Defines constants that specify High Efficiency Image Format (HEIF) compression options. Allows you to choose which compression format to use when creating a HEIF image file.

Syntax

typedef enum WICHeifCompressionOption {
  WICHeifCompressionDontCare = 0x0,
  WICHeifCompressionNone = 0x1,
  WICHeifCompressionHEVC = 0x2,
  WICHeifCompressionAV1 = 0x3,
  WICHeifCompressionJpegXL = 0x4,
  WICHeifCompressionBrotli = 0x5,
  WICHeifCompressionDeflate = 0x6,
  WICHEIFCOMPRESSIONOPTION_FORCE_DWORD
} ;

Constants

WICHeifCompressionDontCare Value: 0x0 Specifies that any compression option may be used.
WICHeifCompressionNone Value: 0x1 Specifies that no compression be used.
WICHeifCompressionHEVC Value: 0x2 Specifies that High Efficiency Video Coding (HEVC) compression be used.
WICHeifCompressionAV1 Value: 0x3 Specifies that AOMedia Video 1 (AV1) compression be used.
WICHeifCompressionJpegXL Value: 0x4 Specifies that JPEG XL should be used as the image compression format inside the HEIF file. Since JPEG XL supports both lossy and lossless compression, the Lossless compression option must also be set to VARIANT_TRUE to enable lossless encoding using JPEG XL. The CompressionQuality compression option is also available when using JPEG XL. CompressionQuality is a floating point number between 0 and 1, and the default value is 0.45. Larger values result in a smaller image size, at the expense of longer encoding time.
WICHeifCompressionBrotli Value: 0x5 Specifies that the Brotli lossless compression algorithm will be applied to the pixels. Brotli is defined in RFC 7932. Brotli generally provides a higher compression ratio than WICHeifCompressionDeflate, at the expense of being slower.
WICHeifCompressionDeflate Value: 0x6 Specifies that the Deflate lossless compression algorithm will be applied to the pixels. Defalate is defined in RFC 1951. Deflate is generally faster than Brotli, but it doesn't compress as well.
WICHEIFCOMPRESSIONOPTION_FORCE_DWORD

Requirements

Requirement	Value
Header	wincodec.h