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.
Possible values depend on the codecs enabled at build time (see --help or --version for the available codecs). Default is auto-selected from the available codecs.
- Possible values are:
- •
-
aom
- •
-
dav1d
- •
-
libgav1
- -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, where the first frame has index 0, or `all' to decode all frames. (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⟩\c