Thu Sep 22 07:03:57 UTC 2022 - Enrico Belleri <idesmi@protonmail.com>
- Update to 0.7.0:
- Added:
- decoder API:
* ability to decode the content of metadata boxes: JXL_DEC_BOX, JXL_DEC_BOX_NEED_MORE_OUTPUT, JxlDecoderSetBoxBuffer, JxlDecoderGetBoxType, JxlDecoderGetBoxSizeRaw and JxlDecoderSetDecompressBoxes.
* ability to mark the input is finished: JxlDecoderCloseInput.
* ability to request updates on different progressive events using JxlDecoderSetProgressiveDetail; currently supported events are kDC, kLastPasses and kPasses.
* 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.
* new function JxlDecoderSetUnpremultiplyAlpha to set preference for getting an associated alpha channel with premultiplied or unpremultiplied colors.
* field added to JxlFrameHeader: a JxlLayerInfo struct that contains crop dimensions and offsets and blending information for the non-coalesced case.
* new function JxlDecoderGetExtraChannelBlendInfo to get the blending information for extra channels in the non-coalesced case.
* new function JxlDecoderSetMultithreadedImageOutCallback, allowing output callbacks to receive more information about the number of threads on which they are running.
* new function JxlDecoderSkipCurrentFrame to skip processing the current frame after a progressive detail is reached.
* new function JxlDecoderGetIntendedDownsamplingRatio to get the intended downsampling ratio of progressive steps, based on the information in the frame header.
* new function JxlDecoderSetRenderSpotcolors to allow disabling rendering of spot colors.
* 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.
* added ability to set several encoder options / extra fields to frames using JxlEncoderSetFrameName, JxlEncoderFrameSettingsSetOption, JxlEncoderFrameSettingsSetFloatOption.
* added ability to check required codestream compatibility level and force specified using JxlEncoderGetRequiredCodestreamLevel and JxlEncoderSetCodestreamLevel.
* added ability to force emitting box-based container format using JxlEncoderUseContainer.
* 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.
* ability to encode arbitrary extra channels: JxlEncoderInitExtraChannelInfo, JxlEncoderSetExtraChannelInfo, JxlEncoderSetExtraChannelName and JxlEncoderSetExtraChannelBuffer.
* ability to plug custom CMS implementation using JxlEncoderSetCms(JxlEncoder* enc, JxlCmsInterface cms) encoder API: added JxlEncoderGetError to retrieve last encoder error.
* add two fields to JXLBasicInfo: intrinsic_xsize and intrinsic_ysize to signal the intrinsic size.
- Changed:
* decoder API: using JxlDecoderCloseInput at the end of all input is required when using JXL_DEC_BOX, and is now also encouraged in other cases, but not required in those other cases for backwards
compatibility.
* encoder API: JxlEncoderCloseInput now closes both frames and boxes input.
* CLI: cjxl and djxl have been reimplemented on the base of public decoder and encoder API; dropped dependency on gflags for argument parsing.
- Deprecated:
- decoder API:
* JXL_DEC_EXTENSIONS event: use JXL_DEC_BASIC_INFO
* pixel types JXL_TYPE_BOOLEAN and JXL_TYPE_UINT32: consider using JXL_TYPE_UINT8 and JXL_TYPE_FLOAT correspondingly.
* pixel format parameter for JxlDecoderGetColorAsEncodedProfile and JxlDecoderGetICCProfileSize: pass NULL.
* JxlDecoderDefaultPixelFormat
- encoder API:
* JxlEncoderOptions: use JxlEncoderFrameSettings instead.
* JxlEncoderOptionsCreate: use JxlEncoderFrameSettingsCreate instead.
* JxlEncoderOptionsSetDistance: use JxlEncoderSetFrameDistance instead.
* JxlEncoderOptionsSetLossless: use JxlEncoderSetFrameLossless instead.
* JxlEncoderOptionsSetEffort: use JxlEncoderFrameSettingsSetOption(frame_settings, JXL_ENC_FRAME_SETTING_EFFORT, effort) instead.
* JxlEncoderOptionsSetDecodingSpeed: use JxlEncoderFrameSettingsSetOption(frame_settings, JXL_ENC_FRAME_SETTING_DECODING_SPEED, tier) instead.
* deprecated JXL_ENC_NOT_SUPPORTED, the encoder returns JXL_ENC_ERROR instead and there is no need to handle JXL_ENC_NOT_SUPPORTED.
* pixel types JXL_TYPE_BOOLEAN and JXL_TYPE_UINT32: consider using JXL_TYPE_UINT8 and JXL_TYPE_FLOAT correspondingly.
