CHANGELOG.md (18083B)
Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
[0.11.1] - 2024-26-11
Fixed
- Huffman lookup table size fix (#3871 - CVE-2024-11403) - Check height limit in modular trees. (#3943 - CVE-2024-11498)
[0.11.0] - 2024-09-13
Added
- Gain Map API (#3552 and #3628): JxlGainMapBundle struct and API functions
to read and write gain map bundlesJxlGainMapWriteBundle and
JxlGainMapReadBundle as well as handling compressed ICC profiles:
JxlICCProfileEncode and JxlICCProfileDecode.
- decoder API: added JXL_DEC_BOX_COMPLETE event to signal that the output
buffer for the current box has received all contents. Previously, this was
to be determined from the fact that the decoder had moved on either to
JXL_DEC_SUCCESS or to another subsequent JXL_DEC_BOX. This change is
made backward-compatible by the fact that the new event must be explicitly
subscribed to, and that JXL_DEC_SUCCESS / JXL_DEC_BOX still occur
afterwards and still imply that the previous box must be complete.
Changed / clarified
- avoiding abort in release build (#3631 and #3639)
[0.10.2] - 2024-03-08
Fixed
- bugs in (lossless) encoding (#3367, #3359 and #3386) - re-enable installation of MIME file (#3375) - bugs in streaming mode (#3379 and #3380)
[0.10.1] - 2024-02-28
Fixed
- reduce allocations (#3336 and #3339), fixing a significant speed regression present since 0.9.0 - bug in streaming encoding (#3331)
[0.10.0] - 2024-02-21
Added
- decoder API: added JxlDecoderGetBoxSizeContents for getting the size of the
content of a box without the headers.
- encoder API: implemented new api functions for streaming encoding.
Changed / clarified
- decoder/encoder API: return failure when surface allocation fail - encoder API / cjxl: updated modular effort levels to faster settings; the effort range is now 1-10, with 11 available in advanced mode.
[0.9.2] - 2024-02-07
Fixed
- bugs in the gdk-pixbuf plugin - some build issues
[0.9.1] - 2024-01-08
Fixed
- multiple build issues
[0.9.0] - 2023-12-22
Added
- encoder API: add JxlEncoderSetExtraChannelDistance to adjust the quality
of extra channels (like alpha) separately.
- encoder API: new api functions for streaming encoding:
- JxlEncoderSetOutputProcessor
- JxlEncoderFlushInput
- JxlEncoderOutputProcessor struct
- JxlEncoderSetOutputCallback
- JxlChunkedFrameInputSource struct
- JxlEncoderAddChunkedFrame
- encoder API: new options for more fine-grained control over metadata
preservation when using JxlEncoderAddJPEGFrame:
- JXL_ENC_FRAME_SETTING_JPEG_KEEP_EXIF
- JXL_ENC_FRAME_SETTING_JPEG_KEEP_XMP
- JXL_ENC_FRAME_SETTING_JPEG_KEEP_JUMBF
- encoder API: new function JxlEncoderSetUpsamplingMode to change the upsampling
method, e.g. to use nearest-neighbor upsampling for pixel art
- decoder API: implemented JxlDecoderSetOutputColorProfile and
JxlDecoderSetCms to enable decoding to desired colorspace.
- cjxl can now be used to explicitly add/update/strip Exif/XMP/JUMBF metadata using
the decoder-hints syntax, e.g. cjxl input.ppm -x exif=input.exif output.jxl
- djxl can now be used to extract Exif/XMP/JUMBF metadata
- encoder API: new function JxlEncoderDistanceFromQuality for convenience to
calculate a distance given a quality
Removed
- API: the Butteraugli API (jxl/butteraugli.h) was removed.
- encoder and decoder API: all deprecated functions were removed:
JxlDecoderDefaultPixelFormat, JxlEncoderOptionsSetLossless,
JxlEncoderOptionsSetEffort, JxlEncoderOptionsSetDecodingSpeed,
JxlEncoderOptionsSetDistance, JxlEncoderOptionsCreate, as well as
the deprecated enumerator values JXL_DEC_EXTENSIONS, JXL_ENC_NOT_SUPPORTED,
JXL_TYPE_BOOLEAN, JXL_TYPE_UINT32, and deprecated type JxlEncoderOptions.
- decoder API: the signature of JxlDecoderGetColorAsEncodedProfile,
JxlDecoderGetICCProfileSize, and JxlDecoderGetColorAsICCProfile
changed: a deprecated unused argument was removed.
Changed / clarified
- changed the name of the cjxl flag photon_noise to photon_noise_iso
- fixed how large boxes are decoded (#2958)
- fixed encoding files with unreadable patches (#3042, #3046)
[0.8.2] - 2023-06-14
Changed
- Security: Fix an integer underflow bug in patch decoding (#2551- CVE-2023-35790).
[0.8.1] - 2023-02-03
Changed
- Allow fast-lossless for 16-bit float input (#2093) - Fix bug in palette (#2120) - Security: Fix OOB read in exif.h (#2101 - CVE-2023-0645)
[0.8.0] - 2023-01-18
Added
- decoder API: new function JxlDecoderSetImageBitDepth to set the bit depth
of the output buffer.
- decoder API proposal: add JxlDecoderSetOutputColorProfile and
JxlDecoderSetCms to enable decoding to desired colorspace; NB: not
implemented yet.
- encoder API: new function JxlEncoderSetFrameBitDepth to set the bit depth
of the input buffer.
- encoder API: add an effort 10 option for lossless compression; using this
setting requires calling JxlEncoderAllowExpertOptions.
- encoder API: new JXL_ENC_FRAME_SETTING_JPEG_COMPRESS_BOXES enum value to
allow explicit control of metadata compression
Removed
- common API: removed JxlIntrinsicSizeHeader
- decoder API: removed deprecated JXL_DEC_NEED_DC_OUT_BUFFER and
JXL_DEC_DC_IMAGE events, JxlDecoderDCOutBufferSize and
JxlDecoderSetDCOutBuffer functions
Changed / clarified
- encoder API: JxlEncoderProcessOutput requires at least 32 bytes of output
space to proceed and guarantees that at least one byte will be written
[0.7] - 2022-07-21
Added
- Export version information in headers.
- decoder API: Ability to decode the content of metadata boxes:
JXL_DEC_BOX, JXL_DEC_BOX_NEED_MORE_OUTPUT, JxlDecoderSetBoxBuffer,
JxlDecoderGetBoxType, JxlDecoderGetBoxSizeRaw and
JxlDecoderSetDecompressBoxes.
- decoder API: ability to mark the input is finished: JxlDecoderCloseInput.
- decoder API: ability to request updates on different progressive events using
JxlDecoderSetProgressiveDetail; currently supported events are
kDC, kLastPasses and kPasses.
- decoder API: ability to specify desired intensity target using
JxlDecoderSetDesiredIntensityTarget
- decoder API: new function JxlDecoderSetCoalesced to allow decoding
non-coalesced (unblended) frames, e.g. layers of a composite still image
or the cropped frames of a recompressed GIF/APNG.
- decoder API: new function JxlDecoderSetUnpremultiplyAlpha to set
preference for getting an associated alpha channel with premultiplied or
unpremultiplied colors.
- decoder API: field added to JxlFrameHeader: a JxlLayerInfo struct
that contains crop dimensions and offsets and blending information for
the non-coalesced case.
- decoder API: new function JxlDecoderGetExtraChannelBlendInfo to get
the blending information for extra channels in the non-coalesced case.
- decoder API: new function JxlDecoderSetMultithreadedImageOutCallback,
allowing output callbacks to receive more information about the number of
threads on which they are running.
- decoder API: new function JxlDecoderSkipCurrentFrame to skip processing
the current frame after a progressive detail is reached.
- decoder API: new function JxlDecoderGetIntendedDownsamplingRatio to get
the intended downsampling ratio of progressive steps, based on the
information in the frame header.
- decoder API: new function JxlDecoderSetRenderSpotcolors to allow disabling
rendering of spot colors.
- decoder/encoder API: add two fields to JXLBasicInfo: intrinsic_xsize
and intrinsic_ysize to signal the intrinsic size.
- encoder API: ability to add metadata boxes, added new functions
JxlEncoderAddBox, JxlEncoderUseBoxes, JxlEncoderCloseBoxes and
JxlEncoderCloseFrames.
- encoder API: added ability to set several encoder options / extra fields to
frames using JxlEncoderSetFrameName, JxlEncoderFrameSettingsSetOption,
JxlEncoderFrameSettingsSetFloatOption.
- encoder API: added ability to check required codestream compatibility level
and force specified using JxlEncoderGetRequiredCodestreamLevel and
JxlEncoderSetCodestreamLevel.
- encoder API: added ability to force emitting box-based container format
using JxlEncoderUseContainer.
- encoder API: added ability to store JPEG metadata for lossless reconstruction
using JxlEncoderStoreJPEGMetadata
- encoder API: new functions JxlEncoderSetFrameHeader and
JxlEncoderSetExtraChannelBlendInfo to set animation
and blending parameters of the frame, and JxlEncoderInitFrameHeader and
JxlEncoderInitBlendInfo to initialize the structs to set.
- encoder API: ability to encode arbitrary extra channels:
JxlEncoderInitExtraChannelInfo, JxlEncoderSetExtraChannelInfo,
JxlEncoderSetExtraChannelName and JxlEncoderSetExtraChannelBuffer.
- encoder API: ability to plug custom CMS implementation using
JxlEncoderSetCms(JxlEncoder* enc, JxlCmsInterface cms)
- encoder API: added JxlEncoderGetError to retrieve last encoder error.
Changed
- decoder API: using
JxlDecoderCloseInputat the end of all input is required
when using JXLDECBOX, and is now also encouraged in other cases, but not required in those other cases for backwards compatibility.
- encoder API:
JxlEncoderCloseInputnow closes both frames and boxes input. - CLI:
cjxlanddjxlhave been reimplemented on the base of public decoder
and encoder API; dropped dependency on gflags for argument parsing.
Deprecated
- decoder API:
JXL_DEC_EXTENSIONSevent: useJXL_DEC_BASIC_INFO - decoder / encoder API: pixel types
JXL_TYPE_BOOLEANandJXL_TYPE_UINT32:
consider using JXL_TYPE_UINT8 and JXL_TYPE_FLOAT correspondingly.
- decoder API: pixel format parameter for
JxlDecoderGetColorAsEncodedProfile
and JxlDecoderGetICCProfileSize: pass NULL.
- decoder API:
JxlDecoderDefaultPixelFormat - encoder API:
JxlEncoderOptions: useJxlEncoderFrameSettingsinstead. - encoder API:
JxlEncoderOptionsCreate: useJxlEncoderFrameSettingsCreate
instead.
- encoder API:
JxlEncoderOptionsSetDistance: useJxlEncoderSetFrameDistance
instead.
- encoder API:
JxlEncoderOptionsSetLossless: useJxlEncoderSetFrameLossless
instead.
- encoder API:
JxlEncoderOptionsSetEffort: use
JxlEncoderFrameSettingsSetOption(frame_settings, JXL_ENC_FRAME_SETTING_EFFORT, effort)
instead.
- encoder API:
JxlEncoderOptionsSetDecodingSpeed: use
JxlEncoderFrameSettingsSetOption(frame_settings, JXL_ENC_FRAME_SETTING_DECODING_SPEED, tier)
instead.
- encoder API: deprecated
JXL_ENC_NOT_SUPPORTED, the encoder returns
JXL_ENC_ERROR instead and there is no need to handle
JXL_ENC_NOT_SUPPORTED.
[0.6.1] - 2021-10-29
Changed
- Security: Fix OOB read in splines rendering (#735 -
CVE-2021-22563)
- Security: Fix OOB copy (read/write) in out-of-order/multi-threaded decoding
(#708 - CVE-2021-22564)
- Fix segfault in djxl tool with --allow_partial_files flag (#781).
- Fix border in extra channels when using upsampling (#796)
[0.6] - 2021-10-04
Added
- API: New functions to decode extra channels:
JxlDecoderExtraChannelBufferSize and JxlDecoderSetExtraChannelBuffer.
- API: New function JxlEncoderInitBasicInfo to initialize JxlBasicInfo
(only needed when encoding). NOTE: it is now required to call this function
when using the encoder. Padding was added to the struct for forward
compatibility.
- API: Support for encoding oriented images.
- API: FLOAT16 support in the encoder API.
- Rewrite of the GDK pixbuf loader plugin. Added proper color management and
animation support.
- Rewrite of GIMP plugin. Added compression parameters dialog and switched to
using the public C API.
- Debian packages for GDK pixbuf loader (libjxl-gdk-pixbuf) and GIMP
(libjxl-gimp-plugin) plugins.
- cjxl/djxl support for stdin and stdout.
Changed
- API: Renamed the field alpha_associated in JxlExtraChannelInfo to
alpha_premultiplied, to match the corresponding name in JxlBasicInfo.
- Improved the 2x2 downscaling method in the encoder for the optional color
channel resampling for low bit rates.
- Fixed: the combination of floating point original data, XYB color encoding,
and Modular mode was broken (in both encoder and decoder). It now works.
NOTE: this can cause the current encoder to write jxl bitstreams that do
not decode with the old decoder. In particular this will happen when using
cjxl with PFM, EXR, or floating point PSD input, and a combination of XYB
and modular mode is used (which caused an encoder error before), e.g.
using options like -m -q 80 (lossy modular), -d 4.5 or --progressive_dc=1
(modular DC frame), or default lossy encoding on an image where patches
end up being used. There is no problem when using cjxl with PNG, JPEG, GIF,
APNG, PPM, PGM, PGX, or integer (8-bit or 16-bit) PSD input.
- libjxl static library now bundles skcms, fixing static linking in
downstream projects when skcms is used.
- Spline rendering performance improvements.
- Butteraugli changes for less visual masking.
[0.5] - 2021-08-02
Added
- API: New function to decode the image using a callback outputting a part of a
row per call.
- API: 16-bit float output support.
- API: JxlDecoderRewind and JxlDecoderSkipFrames functions to skip more
efficiently to earlier animation frames.
- API: JxlDecoderSetPreferredColorProfile function to choose color profile in
certain circumstances.
- encoder: Adding center_x and center_y flags for more control of the tile
order.
- New encoder speeds lightning (1) and thunder (2).
Changed
- Re-licensed the project under a BSD 3-Clause license. See the
LICENSE and PATENTS files for details.
- Full JPEG XL part 1 specification support: Implemented all the spec required
to decode files to pixels, including cases that are not used by the encoder
yet. Part 2 of the spec (container format) is final but not fully implemented
here.
- Butteraugli metric improvements. Exact numbers are different from previous
versions.
- Memory reductions during decoding.
- Reduce the size of the jxl_dec library by removing dependencies.
- A few encoding speedups.
- Clarify the security policy.
- Significant encoding improvements (~5 %) and less ringing.
- Butteraugli metric to have some less masking.
- cjxl flag --speed is deprecated and replaced by the --effort synonym.
Removed
- API for returning a downsampled DC was deprecated
(JxlDecoderDCOutBufferSize and JxlDecoderSetDCOutBuffer) and will be
removed in the next release.
[0.3.7] - 2021-03-29
Changed
- Fix a rounding issue in 8-bit decoding.
[0.3.6] - 2021-03-25
Changed
- Fix a bug that could result in the generation of invalid codestreams as well as failure to decode valid streams.
[0.3.5] - 2021-03-23
Added
- New encode-time options for faster decoding at the cost of quality. - Man pages for cjxl and djxl.
Changed
- Memory usage improvements. - Faster decoding to 8-bit output with the C API. - GIMP plugin: avoid the sRGB conversion dialog for sRGB images, do not show a console window on Windows. - Various bug fixes.
[0.3.4] - 2021-03-16
Changed
- Improved box parsing. - Improved metadata handling. - Performance and memory usage improvements.
[0.3.3] - 2021-03-05
Changed
- Performance improvements for small images. - Add a (flag-protected) non-high-precision mode with better speed. - Significantly speed up the PQ EOTF. - Allow optional HDR tone mapping in djxl (--tonemap, --displaynits). - Change the behavior of djxl -j to make it consistent with cjxl (#153). - Improve image quality. - Improve EXIF handling.
[0.3.2] - 2021-02-12
Changed
- Fix embedded ICC encoding regression #149.
[0.3.1] - 2021-02-10
Changed
- New experimental Butteraugli API (jxl/butteraugli.h).
- Encoder improvements to low quality settings.
- Bug fixes, including fuzzer-found potential security bug fixes.
- Fixed -q 100 and -d 0 not triggering lossless modes.
[0.3] - 2021-01-29
Changed
- Minor change to the Decoder C API to accommodate future work for other ways to provide input. - Future decoder C API changes will be backwards compatible. - Lots of bug fixes since the previous version.
[0.2] - 2020-12-24
Added
- JPEG XL bitstream format is frozen. Files encoded with 0.2 will be supported by future versions.
Changed
- Files encoded with previous versions are not supported.
[0.1.1] - 2020-12-01
[0.1] - 2020-11-14
Added
- Initial release of an encoder (cjxl) and decoder (djxl) that work
together as well as a benchmark tool for comparison with other codecs
(benchmark_xl).
- Note: JPEG XL format is in the final stages of standardization, minor changes
to the codestream format are still possible but we are not expecting any
changes beyond what is required by bug fixing.
- API: new decoder API in C, check the examples/ directory for its example
usage. The C API is a work in progress and likely to change both in API and
ABI in future releases.