Blame man/dwebp.1

Packit 9c6abc
.\"                                      Hey, EMACS: -*- nroff -*-
Packit 9c6abc
.TH DWEBP 1 "June 23, 2016"
Packit 9c6abc
.SH NAME
Packit 9c6abc
dwebp \- decompress a WebP file to an image file
Packit 9c6abc
.SH SYNOPSIS
Packit 9c6abc
.B dwebp
Packit 9c6abc
.RI [ options ] " input_file.webp
Packit 9c6abc
.br
Packit 9c6abc
.SH DESCRIPTION
Packit 9c6abc
This manual page documents the
Packit 9c6abc
.B dwebp
Packit 9c6abc
command.
Packit 9c6abc
.PP
Packit 9c6abc
\fBdwebp\fP decompresses WebP files into PNG, PAM, PPM or PGM images.
Packit 9c6abc
.SH OPTIONS
Packit 9c6abc
The basic options are:
Packit 9c6abc
.TP
Packit 9c6abc
.B \-h
Packit 9c6abc
Print usage summary.
Packit 9c6abc
.TP
Packit 9c6abc
.B \-version
Packit 9c6abc
Print the version number (as major.minor.revision) and exit.
Packit 9c6abc
.TP
Packit 9c6abc
.BI \-o " string
Packit 9c6abc
Specify the name of the output file (as PNG format by default).
Packit 9c6abc
Using "-" as output name will direct output to 'stdout'.
Packit 9c6abc
.TP
Packit 9c6abc
.BI \-\- " string
Packit 9c6abc
Explicitly specify the input file. This option is useful if the input
Packit 9c6abc
file starts with an '\-' for instance. This option must appear \fBlast\fP.
Packit 9c6abc
Any other options afterward will be ignored. If the input file is "\-",
Packit 9c6abc
the data will be read from \fIstdin\fP instead of a file.
Packit 9c6abc
.TP
Packit 9c6abc
.B \-bmp
Packit 9c6abc
Change the output format to uncompressed BMP.
Packit 9c6abc
.TP
Packit 9c6abc
.B \-tiff
Packit 9c6abc
Change the output format to uncompressed TIFF.
Packit 9c6abc
.TP
Packit 9c6abc
.B \-pam
Packit 9c6abc
Change the output format to PAM (retains alpha).
Packit 9c6abc
.TP
Packit 9c6abc
.B \-ppm
Packit 9c6abc
Change the output format to PPM (discards alpha).
Packit 9c6abc
.TP
Packit 9c6abc
.B \-pgm
Packit 9c6abc
Change the output format to PGM. The output consists of luma/chroma
Packit 9c6abc
samples instead of RGB, using the IMC4 layout. This option is mainly
Packit 9c6abc
for verification and debugging purposes.
Packit 9c6abc
.TP
Packit 9c6abc
.B \-yuv
Packit 9c6abc
Change the output format to raw YUV. The output consists of
Packit 9c6abc
luma/chroma-U/chroma-V samples instead of RGB, saved sequentially as
Packit 9c6abc
individual planes. This option is mainly for verification and debugging
Packit 9c6abc
purposes.
Packit 9c6abc
.TP
Packit 9c6abc
.B \-nofancy
Packit 9c6abc
Don't use the fancy upscaler for YUV420. This may lead to jaggy
Packit 9c6abc
edges (especially the red ones), but should be faster.
Packit 9c6abc
.TP
Packit 9c6abc
.B \-nofilter
Packit 9c6abc
Don't use the in-loop filtering process even if it is required by
Packit 9c6abc
the bitstream. This may produce visible blocks on the non-compliant output,
Packit 9c6abc
but it will make the decoding faster.
Packit 9c6abc
.TP
Packit 9c6abc
.BI \-dither " strength
Packit 9c6abc
Specify a dithering \fBstrength\fP between 0 and 100. Dithering is a
Packit 9c6abc
post-processing effect applied to chroma components in lossy compression.
Packit 9c6abc
It helps by smoothing gradients and avoiding banding artifacts.
Packit 9c6abc
.TP
Packit 9c6abc
.BI \-alpha_dither
Packit 9c6abc
If the compressed file contains a transparency plane that was quantized
Packit 9c6abc
during compression, this flag will allow dithering the reconstructed plane
Packit 9c6abc
in order to generate smoother transparency gradients.
Packit 9c6abc
.TP
Packit 9c6abc
.B \-nodither
Packit 9c6abc
Disable all dithering (default).
Packit 9c6abc
.TP
Packit 9c6abc
.B \-mt
Packit 9c6abc
Use multi-threading for decoding, if possible.
Packit 9c6abc
.TP
Packit 9c6abc
.BI \-crop " x_position y_position width height
Packit 9c6abc
Crop the decoded picture to a rectangle with top-left corner at coordinates
Packit 9c6abc
(\fBx_position\fP, \fBy_position\fP) and size \fBwidth\fP x \fBheight\fP.
Packit 9c6abc
This cropping area must be fully contained within the source rectangle.
Packit 9c6abc
The top-left corner will be snapped to even coordinates if needed.
Packit 9c6abc
This option is meant to reduce the memory needed for cropping large images.
Packit 9c6abc
Note: the cropping is applied \fIbefore\fP any scaling.
Packit 9c6abc
.TP
Packit 9c6abc
.B \-flip
Packit 9c6abc
Flip decoded image vertically (can be useful for OpenGL textures for instance).
Packit 9c6abc
.TP
Packit 9c6abc
\fB\-resize\fR, \fB\-scale\fI width height\fR
Packit 9c6abc
Rescale the decoded picture to dimension \fBwidth\fP x \fBheight\fP. This
Packit 9c6abc
option is mostly intended to reducing the memory needed to decode large images,
Packit 9c6abc
when only a small version is needed (thumbnail, preview, etc.). Note: scaling
Packit 9c6abc
is applied \fIafter\fP cropping.
Packit 9c6abc
If either (but not both) of the \fBwidth\fP or \fBheight\fP parameters is 0,
Packit 9c6abc
the value will be calculated preserving the aspect-ratio.
Packit 9c6abc
.TP
Packit 9c6abc
.B \-quiet
Packit 9c6abc
Do not print anything.
Packit 9c6abc
.TP
Packit 9c6abc
.B \-v
Packit 9c6abc
Print extra information (decoding time in particular).
Packit 9c6abc
.TP
Packit 9c6abc
.B \-noasm
Packit 9c6abc
Disable all assembly optimizations.
Packit 9c6abc
Packit 9c6abc
.SH BUGS
Packit 9c6abc
Please report all bugs to the issue tracker:
Packit 9c6abc
https://bugs.chromium.org/p/webp
Packit 9c6abc
.br
Packit 9c6abc
Patches welcome! See this page to get started:
Packit 9c6abc
http://www.webmproject.org/code/contribute/submitting-patches/
Packit 9c6abc
Packit 9c6abc
.SH EXAMPLES
Packit 9c6abc
dwebp picture.webp \-o output.png
Packit 9c6abc
.br
Packit 9c6abc
dwebp picture.webp \-ppm \-o output.ppm
Packit 9c6abc
.br
Packit 9c6abc
dwebp \-o output.ppm \-\- \-\-\-picture.webp
Packit 9c6abc
.br
Packit 9c6abc
cat picture.webp | dwebp \-o \- \-\- \- > output.ppm
Packit 9c6abc
Packit 9c6abc
.SH AUTHORS
Packit 9c6abc
\fBdwebp\fP is a part of libwebp and was written by the WebP team.
Packit 9c6abc
.br
Packit 9c6abc
The latest source tree is available at
Packit 9c6abc
https://chromium.googlesource.com/webm/libwebp
Packit 9c6abc
.PP
Packit 9c6abc
This manual page was written by Pascal Massimino <pascal.massimino@gmail.com>,
Packit 9c6abc
for the Debian project (and may be used by others).
Packit 9c6abc
Packit 9c6abc
.SH SEE ALSO
Packit 9c6abc
.BR cwebp (1),
Packit 9c6abc
.BR gif2webp (1),
Packit 9c6abc
.BR webpmux (1)
Packit 9c6abc
.br
Packit 9c6abc
Please refer to http://developers.google.com/speed/webp/ for additional
Packit 9c6abc
information.
Packit 9c6abc
.SS Output file format details
Packit 9c6abc
PAM: http://netpbm.sourceforge.net/doc/pam.html
Packit 9c6abc
.br
Packit 9c6abc
PGM: http://netpbm.sourceforge.net/doc/pgm.html
Packit 9c6abc
.br
Packit 9c6abc
PPM: http://netpbm.sourceforge.net/doc/ppm.html
Packit 9c6abc
.br
Packit 9c6abc
PNG: http://www.libpng.org/pub/png/png-sitemap.html#info