2 unstable releases

0.5.0-rc0 Apr 7, 2024
0.4.0 Nov 16, 2023

#8 in #jpeg-xl-decoder

Download history 79/week @ 2024-12-27 99/week @ 2025-01-03 174/week @ 2025-01-10 187/week @ 2025-01-17 160/week @ 2025-01-24 188/week @ 2025-01-31 195/week @ 2025-02-07 196/week @ 2025-02-14 188/week @ 2025-02-21 227/week @ 2025-02-28 152/week @ 2025-03-07 316/week @ 2025-03-14 273/week @ 2025-03-21 237/week @ 2025-03-28 197/week @ 2025-04-04 267/week @ 2025-04-11

1,011 downloads per month
Used in 8 crates (3 directly)

MIT OR Apache-2.0 OR Zlib

175KB
3K SLoC

Zune-jpegxl

Support for encoding jpeg xl images in pure rust

This currently features a small POC encoder for JPEG-XL format based on the POC over at the libjxl crate

It supports the following features

  • lossless compression

  • up to 16 bits of depth

  • Up to 4 channels for images

  • Non supported features -> Palette support

Currently, it's fast with slightly worse compression when compared png for non-photo content and much better for other situations.

The library is also fully safe

Features

  • std: Enables linking against the standard library
  • threads: Enables using the standard library threading capabilities, this feature requires the std feature to work (threading doesn't exist in no-std), if the above feature isn't enabled this is a no-op
  • log: Enables use of log to report on encoding configs and status

Both features are enabled by default.

16 bit data

  • 16 bit data should be reinterpreted as 2 u8's in native endian,

Example

  • Encode a 2x2 8 bit image
use zune_core::bit_depth::BitDepth;
use zune_core::colorspace::ColorSpace;
use zune_core::options::EncoderOptions;
use zune_jpegxl::JxlSimpleEncoder;
use zune_jpegxl::JxlEncodeErrors;
// encode a 2x2 image

fn main()->Result<(),JxlEncodeErrors>{
    let mut encoder = JxlSimpleEncoder::new(&[0,0,0,0],EncoderOptions::new(2,2,ColorSpace::Luma,BitDepth::Eight));
let mut write_to = vec![];
    encoder.encode(&mut write_to)?;
    Ok(())
}
  • Encode a 2x2 16 bit image
use zune_core::bit_depth::BitDepth;
use zune_core::colorspace::ColorSpace;
use zune_core::options::EncoderOptions;
use zune_jpegxl::JxlSimpleEncoder;
use zune_jpegxl::JxlEncodeErrors;
// encode a 2x2 image

fn main()->Result<(),JxlEncodeErrors>{
    // convert a 16 bit input to 8 bit native endian output, each two bytes represent one sample
    let sixteen_bit = [0,u16::MAX,0,u16::MAX].iter().flat_map(|x| x.to_ne_bytes()).collect::<Vec<u8>>();
    let mut encoder = JxlSimpleEncoder::new(&sixteen_bit,EncoderOptions::new(2,2,ColorSpace::Luma,BitDepth::Sixteen));
    let mut write_to = vec![];
    encoder.encode(&mut write_to)?;
    Ok(())
}

zune-jpegxl

A simple jpeg-xl encoder

This features a simple jpeg-xl lossless encoder with the following features

  • Lossless encoding
  • 8 bit and 16 bit support
  • Grayscale and RGB{A} encoding
  • Threading capabilities

Usage

First add the latest into your cargo toml

By cargo add

cargo add zune-jpegxl

Or adding directly to your Cargo.toml

zune-jpegxl = "0.4"

Then use the JxlSimpleEncoder struct to encode an image

use zune_core::bit_depth::BitDepth;
use zune_core::options::EncoderOptions;
use zune_jpegxl::JxlSimpleEncoder;
// this example won't work
fn main()->Result<(),JxlEncodeErrors> {
    let mut encoder = JxlSimpleEncoder::new(&[255,0,255,0], EncoderOptions::new(2,2,co));
    encoder.encode().unwrap();
}

Dependencies