PictureSharp.Jxl 0.8.16

PictureSharp.Jxl

JPEG XL for PictureSharp, in pure C# with no native dependencies. Requires .NET 10+ and PictureSharp 0.9.1+.

Install from NuGet:

dotnet add package PictureSharp.Jxl

Usage

Register the format once, then load and save .jxl files like any other image:

using PictureSharp;
using PictureSharp.Formats.Jxl;

ImageConfiguration.Default = ImageConfiguration.Default.ToBuilder().AddFormat(new JxlFormat()).Build();

using var image = Image.Load("photo.jxl", new DecoderOptions { ApplyExifOrientation = true });
image.Mutate(x => x.Resize(1600, 0));
image.SaveAsJxl("small.jxl");

Loading keeps the ICC profile, EXIF and XMP; saving writes them back. Saving is lossy at distance 1.0 like cjxl by default; new JxlEncoderOptions { Quality = 100 } (or Distance = 0) saves losslessly. Image.EditMetadata changes the metadata without touching the frames.

To preserve an existing JPEG exactly, use the separate transcoder without loading its pixels:

JxlTranscoder.FromJpeg("original.jpg", "archived.jxl");
JxlTranscoder.ToJpeg("archived.jxl", "restored.jpg"); // byte-identical to original.jpg
// Stream and buffer overloads are also available, e.g. FromJpeg(jpegStream, jxlStream).

Keep 16-bit samples

using Image scan = Image.Load("scan.png", new DecoderOptions { PreserveBitDepth = true });
scan.SaveAsJxl("scan.jxl", new JxlEncoderOptions { Distance = 0 });

This preserves every 16-bit sample, including alpha. Default loading returns 8-bit pixels; enable PreserveBitDepth when reading the result too.

Support

Not supported yet: images with float samples or CMYK need a float pixel type and colour management for CMYK profiles in PictureSharp itself, so decoding them throws NotSupportedException; transcoding RGB JPEGs.

Format limits: CMYK, arithmetic-coded and 12-bit JPEGs cannot be stored as JPEG XL reconstruction data (libjxl rejects them too).

Output matches djxl (libjxl 0.12.0): lossless exactly, lossy within 1 of 255, and files written here decode the same way with djxl.

CI runs on Linux, including a Native AOT build.

Guides: decoding · encoding · JPEG transcoding · metadata · architecture · release notes

Performance

• SIMD: AVX2/FMA and SSE4.1 kernels with a scalar fallback; all paths produce identical output.
• Native AOT: publish with -p:IlcInstructionSet=x86-64-v3 (or native) to get the AVX2/FMA kernels; the default target uses SSE4.1 only.
• Threads: decoding, encoding and JPEG transcoding run independent groups in parallel. Set MaxDegreeOfParallelism (-1 = all cores, the default; 1 = single-threaded) on DecoderOptions, JxlEncoderOptions or JxlTranscoderOptions. The output does not depend on it.
• Encoding effort: lower Effort is faster; lossless efforts 1–3 are several times faster than 7.
• Memory: a 12 MP image needs about 180 MiB (JPEG-recompressed decode) to 860 MiB (lossless encode) at its peak, including the 48 MB output or input image.

Measurements: speed.

License

MIT. Ported libjxl sources are listed in THIRD-PARTY-NOTICES.txt.

Build

dotnet build -c Release
dotnet test -c Release
dotnet pack src/PictureSharp.Jxl -c Release --no-build -o artifacts
bash scripts/verify-package-consumer.sh