| .\" Hey, EMACS: -*- nroff -*- |
| .TH IMG2WEBP 1 "April 3, 2018" |
| .SH NAME |
| img2webp \- create animated WebP file from a sequence of input images. |
| .SH SYNOPSIS |
| .B img2webp |
| [file_level_options] [files] [per_frame_options...] |
| .br |
| .B img2webp argument_file_name |
| .br |
| .SH DESCRIPTION |
| This manual page documents the |
| .B img2webp |
| command. |
| .PP |
| \fBimg2webp\fP compresses a sequence of images using the animated WebP format. |
| Input images can either be PNG, JPEG, TIFF or WebP. |
| If a single file name (not starting with the character '\-') is supplied as |
| the argument, the command line argument are actually tokenized from this file. |
| This allows for easy scripting or using large number of arguments. |
| .SH FILE-LEVEL OPTIONS |
| The file-level options are applied at the beginning of the compression process, |
| before the input frames are read. |
| .TP |
| .BI \-o " string |
| Specify the name of the output WebP file. |
| .TP |
| .BI \-min_size |
| Encode images to achieve smallest size. This disables key frame insertion and |
| picks the parameters resulting in smallest output for each frame. It uses |
| lossless compression by default, but can be combined with \-q, \-m, \-lossy or |
| \-mixed options. |
| .TP |
| .BI \-kmin " int |
| .TP |
| .BI \-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. |
| .br |
| .B \-mixed |
| Mixed compression mode: optimize compression of the image by picking either |
| lossy or lossless compression for each frame heuristically. This global |
| option disables the local option \fB-lossy\fP and \fB-lossless\fP . |
| .TP |
| .BI \-loop " int |
| Specifies the number of times the animation should loop. Using '0' |
| means 'loop indefinitely'. |
| .TP |
| .BI \-v |
| Be more verbose. |
| .TP |
| .B \-h, \-help |
| A short usage summary. |
| .TP |
| .B \-version |
| Print the version numbers of the relevant libraries used. |
| |
| .SH PER-FRAME OPTIONS |
| The per-frame options are applied for the images following as arguments in the |
| command line. They can be modified any number of times preceding each particular |
| input image. |
| .TP |
| .BI \-d " int |
| Specify the image duration in milliseconds. |
| .TP |
| .B \-lossless, \-lossy |
| Compress the next image(s) using lossless or lossy compression mode. The |
| default mode is lossless. |
| .TP |
| .BI \-q " float |
| Specify the compression factor between 0 and 100. The default is 75. |
| .TP |
| .BI \-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. |
| |
| .SH EXAMPLE |
| img2webp -loop 2 in0.png -lossy in1.jpg -d 80 in2.tiff -o out.webp |
| .br |
| |
| .SH BUGS |
| Please report all bugs to the issue tracker: |
| https://bugs.chromium.org/p/webp |
| .br |
| Patches welcome! See this page to get started: |
| http://www.webmproject.org/code/contribute/submitting\-patches/ |
| |
| .SH AUTHORS |
| \fBimg2webp\fP is a part of libwebp and was written by the WebP team. |
| .br |
| The latest source tree is available at |
| https://chromium.googlesource.com/webm/libwebp |
| .PP |
| This manual page was written by Pascal Massimino <pascal.massimino@gmail.com>, |
| for the Debian project (and may be used by others). |
| |
| .SH SEE ALSO |
| .BR webpmux (1), |
| .BR gif2webp (1) |
| .br |
| Please refer to http://developers.google.com/speed/webp/ for additional |
| information. |
