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
	      input file starts	with an	'-' for	instance. This option must ap-
	      pear 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 op-
	      tion adjusts pixel values	to help	compressibility, but has mini-
	      mal  impact on the visual	quality. It triggers lossless compres-
	      sion mode	automatically. The range is 0 (maximum	preprocessing)
	      to  100  (no  preprocessing,  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 conver-
	      sion.

       -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 en-
	      ables faster compression speed, but produces a larger file. Max-
	      imum compression 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
	      quality 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	inspecting additional encoding possibilities  and  de-
	      cide on the quality gain.	 Lower value can result	is faster pro-
	      cessing  time  at	the expense of larger file size	and lower com-
	      pression quality.

       -min_size
	      Encode image to achieve smallest size. This disables  key	 frame
	      insertion	and picks the dispose method resulting in the smallest
	      output  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 values are in the	range 3	to 30. Default	values
	      are  kmin	 = 9, kmax = 17	for lossless compression and kmin = 3,
	      kmax = 5 for lossy compression.
	      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  per-
	      formance.	 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
	      automatically.

       -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  de-
	      fault is xmp.

       -f int For  lossy encoding only (specified by the -lossy	option). Spec-
	      ify the strength of the deblocking filter, between 0 (no filter-
	      ing) and 100 (maximum filtering).	 A value of 0  will  turn  off
	      any  filtering.  Higher  value will increase the strength	of the
	      filtering	process	applied	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.webmpro-
       ject.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	 addi-
       tional 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+14.3.quarterly>

home | help