https://github.com/kornelski/avif-parse

AVIF parser for extracting AV1 payload from image files. Supports alpha channel association. Fork of Firefox's MP4 parser.
https://github.com/kornelski/avif-parse

avif avif-decoder

Last synced: 2 months ago
JSON representation

AVIF parser for extracting AV1 payload from image files. Supports alpha channel association. Fork of Firefox's MP4 parser.

• Host: GitHub
• URL: https://github.com/kornelski/avif-parse
• Owner: kornelski
• License: mpl-2.0
• Created: 2020-08-26T14:24:03.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2022-01-25T01:04:51.000Z (almost 3 years ago)
• Last Synced: 2024-05-09T14:54:56.135Z (8 months ago)
• Topics: avif, avif-decoder
• Language: Rust
• Homepage: https://lib.rs/avif-parse
• Size: 4.04 MB
• Stars: 8
• Watchers: 4
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# AVIF file structure parser (demuxer)

Get AV1 payload and the alpha channel metadata out of AVIF image files.

This is a minimal ISOBMFF/MIAF and AV1 OBU parser. It is a fork of Mozilla's MP4 parser used in Firefox, so it's designed to be robust and safely handle untrusted data. This crate is written entirely in safe Rust code.

The parser is compatible with files supported by libavif, Chrome 85 and Firefox 81a. It parses all files in [the AOM test suite](https://github.com/AOMediaCodec/av1-avif).

[API documentation](https://docs.rs/avif-parse/)

This crate doesn't include an AV1 decoder. To display the pixels you will additionally need [dav1d](https://code.videolan.org/videolan/dav1d) or [libaom](https://lib.rs/libaom-sys) ([full decoder example](https://gitlab.com/kornelski/aom-decode)).

## Usage from Rust

It takes `io::Read`, so you can use any readable input, such as a byte slice (`vec.as_slice()`), or a `File` wrapped in `BufReader`, etc.

```rust

let data = read_avif(&mut slice)?;

av1_decode(&data.primary_item)?;

if let Some(alpha) = &data.alpha_item {

    av1_decode(alpha)?;

}

if data.premultiplied_alpha {

    // after decoding, remember to divide R,G,B values by A

}

```

## Usage from C

Install Rust 1.68 or later, preferably via [rustup](https://rustup.rs), and run:

```bash

cargo build --release

```

It will build `./target/release/libavif_parse.a` (or `avif_parse.lib` on Windows). Link it with your project.

Cargo supports cross-compilation, so you can easily build it for other platforms (e.g. [iOS](https://lib.rs/crates/cargo-xcode)).

```c

#include "avif_parse.h"

avif_data_t data = avif_parse(file_data, file_length);

if (data) {

    av1_decode(data.primary_data, data.primary_size);

    if (data.alpha_data) {

        av1_decode(data.alpha_data, data.alpha_size);

    }

    if (data.premultiplied_alpha) {

        // after decoding, remember to divide R,G,B values by A

    }

}

avif_data_free(data);

```