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