94a8377b3e
+ make img2webp tool use the text-file parsing option too. Change-Id: I1976e651bbe8b4701abceba89e054b4fb3c35696
103 lines
3.2 KiB
Groff
103 lines
3.2 KiB
Groff
.\" Hey, EMACS: -*- nroff -*-
|
|
.TH IMG2WEBP 1 "February 7, 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.
|
|
|
|
.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.
|