NAME¶

avifdec - decompress an AVIF file to an image file

SYNOPSIS¶

avifdec [options] input.avif output.[jpg|jpeg|png|y4m]

avifdec --info input.avif

DESCRIPTION¶

avifdec decompresses an AVIF file to an image file. Output format can be either JPEG, PNG or YUV4MPEG2 (Y4M).

OPTIONS¶

-h, --help

Show syntax help.

-V, --version

Show the version number.

-j, --jobs J

Number of jobs (worker threads), or `all' to potentially use as many cores as possible. (Default: all).

-c, --codec C

Codec to use.

-d, --depth D

Output depth, either 8 or 16. (PNG only; For y4m, depth is retained, and JPEG is always 8bpc).

-q, --quality Q

Output quality in 0..100. (JPEG only, default: 90).

--png-compress L

PNG compression level in 0..9 (PNG only; 0=none, 9=max). Defaults to libpng’s builtin default.

-u, --upsampling U

Chroma upsampling (for 420/422). One of `automatic' (default), `fastest', `best', `nearest', or `bilinear'.

-r, --raw-color

Output raw RGB values instead of multiplying by alpha when saving to opaque formats (JPEG only; not applicable to y4m).

--index I

When decoding an image sequence or progressive image, specify which frame index to decode (Default: 0).

--progressive

Enable progressive AVIF processing. If a progressive image is encountered and --progressive is passed, avifdec will use --index to choose which layer to decode (in progressive order).

--no-strict

Disable strict decoding, which disables strict validation checks and errors.

-i, --info

Decode all frames and display all image information instead of saving to disk.

--icc FILENAME

Provide an ICC profile payload (implies --ignore-icc).

--ignore-icc

If the input file contains an embedded ICC profile, ignore it (no-op if absent).

--size-limit C

Maximum image size (in total pixels) that should be tolerated. (Default: 268435456).

--dimension-limit C

Maximum image dimension (width or height) that should be tolerated. Set to 0 to ignore. (Default: 32768).

--

Signal the end of options. Everything after this is interpreted as file names.

EXAMPLES¶

Decompress an AVIF file to a PNG file:

$ avifdec input.avif output.png

REPORTING BUGS¶

Bugs can be reported on GitHub at:

https://github.com/AOMediaCodec/libavif/issues

SEE ALSO¶

avifenc(1)