#av1 #decoder #heif #image-conversion #libaom

bin+lib avif-decode

Convert AVIF images to PNG or decompressed pixel data

5 releases (2 stable)

1.0.1 Aug 2, 2024
1.0.0 Feb 11, 2024
0.2.2 Jan 31, 2022
0.2.1 Jul 14, 2021
0.2.0 Jan 12, 2021

#687 in Images

Download history 56/week @ 2024-08-31 32/week @ 2024-09-07 78/week @ 2024-09-14 218/week @ 2024-09-21 65/week @ 2024-09-28 116/week @ 2024-10-05 85/week @ 2024-10-12 97/week @ 2024-10-19 73/week @ 2024-10-26 63/week @ 2024-11-02 62/week @ 2024-11-09 58/week @ 2024-11-16 54/week @ 2024-11-23 53/week @ 2024-11-30 58/week @ 2024-12-07 62/week @ 2024-12-14

234 downloads per month
Used in 2 crates

BSD-3-Clause

21KB
365 lines

AVIF to PNG converter

Converts AVIF images (AV1 + HEIF) to standard PNG images. It's meant to decode very accurately (using AOM, precise colorspace conversions). It is not meant to produce small PNG files. Some PNG files will be 100 times larger than the AVIF input.

It can also be used as a Rust library for decoding straight to uncompressed pixels (RGBA, etc).

Usage

avif_decode input.avif output.png

It always processes one file at a time. If output path is omitted, it'll be the same as the input, except with a .png extension. Add -f to overwrite output files.

Install from source

Requires Rust 1.75 or later and a C compiler.

cargo install avif-decode

Features

Supported AVIF features

  • 8-, 10-, and 12-bit deep images. Images are saved as 16-bit PNG when necessary.
  • RGB and many flavors of YUV color spaces in both full and "studio" range.
  • Alpha channel, in both premultiplied and uncorrelated alpha modes.
  • 4:4:4, 4:2:2, 4:2:0 chroma modes. Chroma subsampling uses box upsampling. BTW: The AVIF spec intentionally left chroma upsampling algorithm unspecified, so images using 4:2:0 or 4:2:2 modes will have decoder-dependent distortions. It's best to never use chroma subsampling modes in AVIF.

Unsupported features

  • Any form of HDR. Maybe later.
  • YCgCo color space.
  • Embedded ICC color profiles. AV1 already supports so many color spaces, it'd be rude to support an extra color conversion layer that's complex and unecessary.
  • The kitchen sink of pointless HEIF features. I'm writing an image decoder, not Photoshop.

License

New BSD

Dependencies

~21MB
~425K SLoC