libheif-rs

Safe wrapper around the libheif-sys crate for parsing heif/heic files.

CHANGELOG

System dependencies

• libheif-dev >= 1.14.2

Examples

Read HEIF file

```rust use libheif_rs::{Channel, RgbChroma, ColorSpace, HeifContext, Result, ItemId};

fn main() -> Result<()> { let ctx = HeifContext::readfromfile("./data/test.heic")?; let handle = ctx.primaryimagehandle()?; asserteq!(handle.width(), 3024); asserteq!(handle.height(), 4032);

// Get Exif
let mut meta_ids: Vec<ItemId> = vec![0; 1];
let count = handle.metadata_block_ids(&mut meta_ids, b"Exif");
assert_eq!(count, 1);
let exif: Vec<u8> = handle.metadata(meta_ids[0])?;

// Decode the image
let image = handle.decode(ColorSpace::Rgb(RgbChroma::Rgb), None)?;
assert_eq!(image.color_space(), Some(ColorSpace::Rgb(RgbChroma::Rgb)));
assert_eq!(image.width(), 3024);
assert_eq!(image.height(), 4032);

// Scale the image
let small_img = image.scale(1024, 800, None)?;
assert_eq!(small_img.width(), 1024);
assert_eq!(small_img.height(), 800);

// Get "pixels"
let planes = small_img.planes();
let interleaved_plane = planes.interleaved.unwrap();
assert_eq!(interleaved_plane.width, 1024);
assert_eq!(interleaved_plane.height, 800);
assert!(!interleaved_plane.data.is_empty());
assert!(interleaved_plane.stride > 0);

Ok(())

} ```

Write HEIF file

```rust use tempfile::NamedTempFile; use libheif_rs::{ Channel, RgbChroma, ColorSpace, CompressionFormat, EncoderQuality, HeifContext, Image, Result };

fn main() -> Result<()> { let width = 640; let height = 480;

let mut image = Image::new(width, height, ColorSpace::Rgb(RgbChroma::C444))?;

image.create_plane(Channel::R, width, height, 8)?;
image.create_plane(Channel::G, width, height, 8)?;
image.create_plane(Channel::B, width, height, 8)?;

let planes = image.planes_mut();
let plane_r = planes.r.unwrap();
let stride = plane_r.stride;

let data_r = plane_r.data;
let data_g = planes.g.unwrap().data;
let data_b = planes.b.unwrap().data;

// Fill data of planes by some "pixels"
for y in 0..height {
    let mut row_start = stride * y as usize;
    for x in 0..width {
        let color = (x * y) as u32;
        data_r[row_start] = ((color & 0x00_ff_00_00) >> 16) as u8;
        data_g[row_start] = ((color & 0x00_00_ff_00) >> 8) as u8;
        data_b[row_start] = (color & 0x00_00_00_ff) as u8;
        row_start += 1;
    }
}

// Encode image and save it into file.
let mut context = HeifContext::new()?;
let mut encoder = context.encoder_for_format(CompressionFormat::Hevc)?;
encoder.set_quality(EncoderQuality::LossLess)?;
context.encode_image(&image, &mut encoder, None)?;

let tmp_file = NamedTempFile::new().unwrap();
context.write_to_file(tmp_file.path().to_str().unwrap())?;

Ok(())

} ```