Apply CVE-2023-4863 patch
[platform/upstream/libwebp.git] / man / vwebp.1
1 .\"                                      Hey, EMACS: -*- nroff -*-
2 .TH VWEBP 1 "June 5, 2019"
3 .SH NAME
4 vwebp \- decompress a WebP file and display it in a window
5 .SH SYNOPSIS
6 .B vwebp
7 .RI [ options ] " input_file.webp
8 .br
9 .SH DESCRIPTION
10 This manual page documents the
11 .B vwebp
12 command.
13 .PP
14 \fBvwebp\fP decompresses a WebP file and displays it in a window using OpenGL.
15 .SH OPTIONS
16 .TP
17 .B \-h
18 Print usage summary.
19 .TP
20 .B \-version
21 Print version number and exit.
22 .TP
23 .B \-noicc
24 Don't use the ICC profile if present.
25 .TP
26 .B \-nofancy
27 Don't use the fancy YUV420 upscaler.
28 .TP
29 .B \-nofilter
30 Disable in-loop filtering.
31 .TP
32 .BI \-dither " strength
33 Specify a dithering \fBstrength\fP between 0 and 100. Dithering is a
34 post-processing effect applied to chroma components in lossy compression.
35 It helps by smoothing gradients and avoiding banding artifacts. Default: 50.
36 .TP
37 .BI \-noalphadither
38 By default, quantized transparency planes are dithered during decompression,
39 to smooth the gradients. This flag will prevent this dithering.
40 .TP
41 .B \-usebgcolor
42 Fill transparent areas with the bitstream's own background color instead of
43 checkerboard only. Default is white for non-animated images.
44 .TP
45 .B \-mt
46 Use multi-threading for decoding, if possible.
47 .TP
48 .B \-info
49 Display image information on top of the decoded image.
50 .TP
51 .BI \-\- " string
52 Explicitly specify the input file. This option is useful if the input
53 file starts with an '\-' for instance. This option must appear \fBlast\fP.
54 Any other options afterward will be ignored. If the input file is "\-",
55 the data will be read from \fIstdin\fP instead of a file.
56 .TP
57
58 .SH KEYBOARD SHORTCUTS
59 .TP
60 .B 'c'
61 Toggle use of color profile.
62 .TP
63 .B 'b'
64 Toggle display of background color.
65 .TP
66 .B 'i'
67 Overlay file information.
68 .TP
69 .B 'd'
70 Disable blending and disposal process, for debugging purposes.
71 .TP
72 .B 'q' / 'Q' / ESC
73 Quit.
74
75 .SH BUGS
76 Please report all bugs to the issue tracker:
77 https://bugs.chromium.org/p/webp
78 .br
79 Patches welcome! See this page to get started:
80 http://www.webmproject.org/code/contribute/submitting-patches/
81
82 .SH EXAMPLES
83 vwebp picture.webp
84 .br
85 vwebp picture.webp -mt -dither 0
86 .br
87 vwebp \-\- \-\-\-picture.webp
88
89 .SH AUTHORS
90 \fBvwebp\fP is a part of libwebp and was written by the WebP team.
91 .br
92 The latest source tree is available at
93 https://chromium.googlesource.com/webm/libwebp
94 .PP
95 This manual page was written for the Debian project (and may be used by others).
96
97 .SH SEE ALSO
98 .BR dwebp (1)
99 .br
100 Please refer to http://developers.google.com/speed/webp/ for additional
101 information.