From 79efa1d0061e47e0908aeced29ec498e9ba47204 Mon Sep 17 00:00:00 2001 From: Urvang Joshi Date: Thu, 15 Nov 2012 15:55:06 -0800 Subject: [PATCH] Add man page for gif2webp utility Change-Id: Ia4826134db4e97427ab27977af7cc358b26e2b86 --- man/Makefile.am | 3 ++ man/cwebp.1 | 3 +- man/gif2webp.1 | 96 +++++++++++++++++++++++++++++++++++++++++++++++++ man/webpmux.1 | 3 +- 4 files changed, 103 insertions(+), 2 deletions(-) create mode 100644 man/gif2webp.1 diff --git a/man/Makefile.am b/man/Makefile.am index bd243f30..4c5876f3 100644 --- a/man/Makefile.am +++ b/man/Makefile.am @@ -2,4 +2,7 @@ man_MANS = cwebp.1 dwebp.1 if WANT_MUX man_MANS += webpmux.1 endif +if BUILD_GIF2WEBP + man_MANS += gif2webp.1 +endif EXTRA_DIST = $(man_MANS) diff --git a/man/cwebp.1 b/man/cwebp.1 index 93a4ad46..b6331623 100644 --- a/man/cwebp.1 +++ b/man/cwebp.1 @@ -213,7 +213,8 @@ This manual page was written by Pascal Massimino , for the Debian project (and may be used by others). .SH SEE ALSO -.BR dwebp (1). +.BR dwebp (1), +.BR gif2webp (1). .br Please refer to http://developers.google.com/speed/webp/ for additional information. diff --git a/man/gif2webp.1 b/man/gif2webp.1 new file mode 100644 index 00000000..686b46f5 --- /dev/null +++ b/man/gif2webp.1 @@ -0,0 +1,96 @@ +.\" Hey, EMACS: -*- nroff -*- +.TH GIF2WEBP 1 "November 15, 2012" +.SH NAME +gif2webp \- Convert a GIF image to WebP +.SH SYNOPSIS +.B gif2webp +.RI [ options ] " input_file.gif \-o output_file.webp +.br +.SH DESCRIPTION +This manual page documents the +.B gif2webp +command. +.PP +\fBgif2webp\fP converts a GIF image to a WebP image. +.SH OPTIONS +The basic options are: +.TP +.B \-o string +Specify the name of the output WebP file. If omitted, \fBgif2webp\fP will +perform conversion but only report statistics. +.TP +.B \-h, \-help +Usage information. +.TP +.B \-version +Print the version number (as major.minor.revision) and exit. +.TP +.B \-lossy +Encode the image using lossy compression. +.TP +.B \-q float +Specify the compression factor for RGB channels between 0 and 100. The default +is 75. +.br +In case of lossless compression (default), a small factor enables faster +compression speed, but produces a larger file. Maximum compression is achieved +by using a value of 100. +.br +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. +.TP +.B \-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 decide on the quality gain. +Lower value can result is faster processing time at the expense of +larger file size and lower compression quality. +.TP +.B \-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 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. +.TP +.B \-v +Print extra information. +.TP +.B \-quiet +Do not print anything. + +.SH BUGS +Please report all bugs to our issue tracker: +http://code.google.com/p/webp/issues +.br +Patches welcome! See this page to get started: +http://www.webmproject.org/code/contribute/submitting-patches/ + +.SH EXAMPLES +gif2webp picture.gif \-o picture.webp +.br +gif2webp \-q 70 picture.gif \-o picture.webp +.br +gif2webp \-lossy \-m 3 picture.gif \-o picture_lossy.webp +.br +gif2webp \-lossy \-f 50 picture.gif \-o picture.webp + +.SH AUTHORS +\fBgif2webp\fP was written by the WebP team. +.br +The latest source tree is available at http://www.webmproject.org/code +.PP +This manual page was written by Urvang Joshi , for the +Debian project (and may be used by others). + +.SH SEE ALSO +.BR dwebp (1), +.BR cwebp (1), +.BR webpmux (1). +.br +Please refer to http://developers.google.com/speed/webp/ for additional +information. diff --git a/man/webpmux.1 b/man/webpmux.1 index 2e0be67b..2002ca30 100644 --- a/man/webpmux.1 +++ b/man/webpmux.1 @@ -184,7 +184,8 @@ for the Debian project (and may be used by others). .SH SEE ALSO .BR dwebp (1), -.BR cwebp (1). +.BR cwebp (1), +.BR gif2webp (1). .br Please refer to http://developers.google.com/speed/webp/ for additional information.