dwebp(1) - f37

1DWEBP(1)                    General Commands Manual                   DWEBP(1)
2
3
4

NAME

6       dwebp - decompress a WebP file to an image file
7

SYNOPSIS

9       dwebp [options] input_file.webp
10

DESCRIPTION

12       This manual page documents the dwebp command.
13
14       dwebp  decompresses WebP files into PNG, PAM, PPM or PGM images.  Note:
15       Animated WebP files are not supported.
16

OPTIONS

18       The basic options are:
19
20       -h     Print usage summary.
21
22       -version
23              Print the version number (as major.minor.revision) and exit.
24
25       -o string
26              Specify the name of the output file (as PNG format by  default).
27              Using "-" as output name will direct output to 'stdout'.
28
29       -- string
30              Explicitly  specify the input file. This option is useful if the
31              input file starts with an '-' for instance. This option must ap‐
32              pear  last.  Any other options afterward will be ignored. If the
33              input file is "-", the data will be read from stdin instead of a
34              file.
35
36       -bmp   Change the output format to uncompressed BMP.
37
38       -tiff  Change the output format to uncompressed TIFF.
39
40       -pam   Change the output format to PAM (retains alpha).
41
42       -ppm   Change the output format to PPM (discards alpha).
43
44       -pgm   Change  the  output  format  to  PGM.  The  output  consists  of
45              luma/chroma samples instead of RGB, using the IMC4 layout.  This
46              option is mainly for verification and debugging purposes.
47
48       -yuv   Change  the  output  format  to  raw YUV. The output consists of
49              luma/chroma-U/chroma-V samples instead  of  RGB,  saved  sequen‐
50              tially as individual planes. This option is mainly for verifica‐
51              tion and debugging purposes.
52
53       -nofancy
54              Don't use the fancy upscaler for YUV420. This may lead to  jaggy
55              edges (especially the red ones), but should be faster.
56
57       -nofilter
58              Don't  use  the in-loop filtering process even if it is required
59              by the bitstream. This may produce visible blocks  on  the  non-
60              compliant output, but it will make the decoding faster.
61
62       -dither strength
63              Specify  a  dithering strength between 0 and 100. Dithering is a
64              post-processing effect applied to  chroma  components  in  lossy
65              compression.  It helps by smoothing gradients and avoiding band‐
66              ing artifacts.
67
68       -alpha_dither
69              If the compressed file contains a transparency  plane  that  was
70              quantized during compression, this flag will allow dithering the
71              reconstructed plane in order to generate  smoother  transparency
72              gradients.
73
74       -nodither
75              Disable all dithering (default).
76
77       -mt    Use multi-threading for decoding, if possible.
78
79       -crop x_position y_position width height
80              Crop  the decoded picture to a rectangle with top-left corner at
81              coordinates (x_position, y_position) and size  width  x  height.
82              This  cropping  area  must  be fully contained within the source
83              rectangle.  The top-left corner will be snapped to even  coordi‐
84              nates  if  needed.   This  option  is meant to reduce the memory
85              needed for cropping large images.  Note: the cropping is applied
86              before any scaling.
87
88       -flip  Flip decoded image vertically (can be useful for OpenGL textures
89              for instance).
90
91       -resize, -scale width height
92              Rescale the decoded picture to dimension width  x  height.  This
93              option  is  mostly intended to reducing the memory needed to de‐
94              code large images, when only a small version is  needed  (thumb‐
95              nail,  preview,  etc.). Note: scaling is applied after cropping.
96              If either (but not both) of the width or height parameters is 0,
97              the value will be calculated preserving the aspect-ratio.
98
99       -quiet Do not print anything.
100
101       -v     Print extra information (decoding time in particular).
102
103       -noasm Disable all assembly optimizations.
104
105

BUGS

107       Please     report     all     bugs     to     the     issue    tracker:
108       https://bugs.chromium.org/p/webp
109       Patches welcome! See this page  to  get  started:  https://www.webmpro‐
110       ject.org/code/contribute/submitting-patches/
111
112

EXAMPLES

114       dwebp picture.webp -o output.png
115       dwebp picture.webp -ppm -o output.ppm
116       dwebp -o output.ppm -- ---picture.webp
117       cat picture.webp | dwebp -o - -- - > output.ppm
118
119

AUTHORS

121       dwebp is a part of libwebp and was written by the WebP team.
122       The   latest  source  tree  is  available  at  https://chromium.google‐
123       source.com/webm/libwebp
124
125       This  manual  page  was  written  by  Pascal   Massimino   <pascal.mas‐
126       simino@gmail.com>, for the Debian project (and may be used by others).
127
128