Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GIF2WEBP(1)		     General Commands Manual		     GIF2WEBP(1)

NAME
     gif2webp - Convert a GIF image to WebP

SYNOPSIS
     gif2webp [options] input_file.gif -o output_file.webp

DESCRIPTION
     This manual page documents the gif2webp command.

     gif2webp converts a GIF image to a WebP image.

OPTIONS
     The basic options are:

     -o string
	    Specify  the name of the output WebP file. If omitted, gif2webp will
	    perform conversion but only report statistics.  Using "-" as  output
	    name will direct output to 'stdout'.

     -- string
	    Explicitly	specify the input file. This option is useful if the in-
	    put file starts with an '-' for instance. This  option  must  appear
	    last.   Any  other	options  afterward will be ignored. If the input
	    file is "-", the data will be read from stdin instead of a file.

     -h, -help
	    Usage information.

     -version
	    Print the version number (as major.minor.revision) and exit.

     -lossy
	    Encode the image using lossy compression.

     -mixed
	    Mixed compression mode: optimize compression of the image by picking
	    either lossy or lossless compression for each frame heuristically.

     -near_lossless int
	    Specify the level of near-lossless image preprocessing. This  option
	    adjusts pixel values to help compressibility, but has minimal impact
	    on	the  visual quality. It triggers lossless compression mode auto-
	    matically. The range is 0 (maximum preprocessing) to 100 (no prepro-
	    cessing, the default). The typical value is  around  60.  Note  that
	    lossy with -q 100 can at times yield better results.

     -sharp_yuv
	    Use  more  accurate  and sharper RGB->YUV conversion. Note that this
	    process is slower than the default 'fast' RGB->YUV conversion.

     -q float
	    Specify the compression factor for RGB channels between 0  and  100.
	    The default is 75.
	    In	case  of  lossless compression (default), a small factor enables
	    faster compression speed, but produces a larger file.  Maximum  com-
	    pression is achieved by using a value of 100.
	    In	case  of  lossy  compression (specified by the -lossy option), a
	    small factor produces a smaller file with lower quality. Best  qual-
	    ity is achieved by using a value of 100.

     -m int
	    Specify  the  compression method to use. This parameter controls the
	    trade off between encoding speed and the compressed  file  size  and
	    quality.   Possible  values  range	from 0 to 6. Default value is 4.
	    When higher values are used, the encoder will spend  more  time  in-
	    specting additional encoding possibilities and decide on the quality
	    gain.   Lower  value can result is faster processing time at the ex-
	    pense of larger file size and lower compression quality.

     -min_size
	    Encode image to achieve smallest size. This disables key  frame  in-
	    sertion  and picks the dispose method resulting in the smallest out-
	    put for each frame. It uses lossless compression by default, but can
	    be combined with -q, -m, -lossy or -mixed options.

     -kmin int

     -kmax int
	    Specify the minimum and maximum  distance  between	consecutive  key
	    frames (independently decodable frames) in the output animation. The
	    tool will insert some key frames into the output animation as needed
	    so that this criteria is satisfied.
	    A  'kmax' value of 0 will turn off insertion of key frames. A 'kmax'
	    value of 1 will result in all frames being key frames. 'kmin'  value
	    is not taken into account in both these special cases.  Typical val-
	    ues are in the range 3 to 30. Default values are kmin = 9, kmax = 17
	    for  lossless  compression and kmin = 3, kmax = 5 for lossy compres-
	    sion.
	    These two options are relevant only for animated images  with  large
	    number of frames (>50).
	    When  lower  values  are  used, more frames will be converted to key
	    frames. This may lead to smaller number of frames required to decode
	    a frame on average, thereby improving the decoding performance.  But
	    this may lead to slightly bigger file sizes.  Higher values may lead
	    to worse decoding performance, but smaller file sizes.
	    Some restrictions:
	    (i) kmin < kmax,
	    (ii) kmin >= kmax / 2 + 1 and
	    (iii) kmax - kmin <= 30.
	    If	any of these restrictions are not met, they will be enforced au-
	    tomatically.

     -metadata string
	    A comma separated list of metadata to copy from  the  input  to  the
	    output  if present.  Valid values: all, none, icc, xmp.  The default
	    is xmp.

     -f int
	    For lossy encoding only (specified by the  -lossy  option).  Specify
	    the  strength of the deblocking filter, between 0 (no filtering) and
	    100 (maximum filtering).  A value of 0 will turn off any  filtering.
	    Higher value will increase the strength of the filtering process ap-
	    plied  after decoding the picture. The higher the value the smoother
	    the picture will appear. Typical values are usually in the range  of
	    20 to 50.

     -mt    Use multi-threading for encoding, if possible.

     -loop_compatibility
	    If	enabled, handle the loop information in a compatible fashion for
	    Chrome version prior to M62 (inclusive) and Firefox.

     -v     Print extra information.

     -quiet
	    Do not print anything.

EXIT STATUS
     If there were no problems during execution, gif2webp exits with  the  value
     of the C constant EXIT_SUCCESS. This is usually zero.

     If  an  error  occurs,  gif2webp  exits  with  the  value of the C constant
     EXIT_FAILURE. This is usually one.

EXAMPLES
     gif2webp picture.gif -o picture.webp
     gif2webp -q 70 picture.gif -o picture.webp
     gif2webp -lossy -m 3 picture.gif -o picture_lossy.webp
     gif2webp -lossy -f 50 picture.gif -o picture.webp
     gif2webp -q 70 -o picture.webp -- ---picture.gif
     cat picture.gif | gif2webp -o - -- - > output.webp

AUTHORS
     gif2webp is a part of libwebp and was written by the WebP team.
     The  latest  source   tree   is   available   at	https://chromium.google-
     source.com/webm/libwebp

     This  manual  page was written by Urvang Joshi <urvang@google.com>, for the
     Debian project (and may be used by others).

REPORTING BUGS
     Please report all bugs to the issue tracker: https://issues.webmproject.org
     Patches  welcome!	See  this  page  to  get  started:  https://www.webmpro-
     ject.org/code/contribute/submitting-patches/

SEE ALSO
     cwebp(1), dwebp(1), webpmux(1)
     Please  refer  to	https://developers.google.com/speed/webp/ for additional
     information.

				November 4, 2024		     GIF2WEBP(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gif2webp&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help