AVIFDEC(1)		    General Commands Manual		    AVIFDEC(1)

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>

SEE ALSO
       avifenc(1)

libavif 1.3.0			  2022-04-30			    AVIFDEC(1)