mirror of
https://github.com/ahabhyde/miguelbridge
synced 2025-01-10 14:34:21 +01:00
565 lines
17 KiB
HTML
565 lines
17 KiB
HTML
<!-- Creator : groff version 1.21 -->
|
|
<!-- CreationDate: Mon Jul 28 19:47:26 2014 -->
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
|
|
"http://www.w3.org/TR/html4/loose.dtd">
|
|
<html>
|
|
<head>
|
|
<meta name="generator" content="groff -Thtml, see www.gnu.org">
|
|
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
|
|
<meta name="Content-Style" content="text/css">
|
|
<style type="text/css">
|
|
p { margin-top: 0; margin-bottom: 0; vertical-align: top }
|
|
pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
|
|
table { margin-top: 0; margin-bottom: 0; vertical-align: top }
|
|
h1 { text-align: center }
|
|
</style>
|
|
<title>CWEBP</title>
|
|
|
|
</head>
|
|
<body>
|
|
|
|
<h1 align="center">CWEBP</h1>
|
|
|
|
<a href="#NAME">NAME</a><br>
|
|
<a href="#SYNOPSIS">SYNOPSIS</a><br>
|
|
<a href="#DESCRIPTION">DESCRIPTION</a><br>
|
|
<a href="#OPTIONS">OPTIONS</a><br>
|
|
<a href="#ADDITIONAL OPTIONS">ADDITIONAL OPTIONS</a><br>
|
|
<a href="#BUGS">BUGS</a><br>
|
|
<a href="#EXAMPLES">EXAMPLES</a><br>
|
|
<a href="#AUTHORS">AUTHORS</a><br>
|
|
<a href="#SEE ALSO">SEE ALSO</a><br>
|
|
|
|
<hr>
|
|
|
|
|
|
<h2>NAME
|
|
<a name="NAME"></a>
|
|
</h2>
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">cwebp −
|
|
compress an image file to a WebP file</p>
|
|
|
|
<h2>SYNOPSIS
|
|
<a name="SYNOPSIS"></a>
|
|
</h2>
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em"><b>cwebp</b>
|
|
[<i>options</i>] <i>input_file −o
|
|
output_file.webp</i></p>
|
|
|
|
<h2>DESCRIPTION
|
|
<a name="DESCRIPTION"></a>
|
|
</h2>
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">This manual
|
|
page documents the <b>cwebp</b> command.</p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em"><b>cwebp</b>
|
|
compresses an image using the WebP format. Input format can
|
|
be either PNG, JPEG, TIFF, WebP or raw Y’CbCr
|
|
samples.</p>
|
|
|
|
<h2>OPTIONS
|
|
<a name="OPTIONS"></a>
|
|
</h2>
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">The basic
|
|
options are: <b><br>
|
|
−o</b> <i>string</i></p>
|
|
|
|
<p style="margin-left:22%;">Specify the name of the output
|
|
WebP file. If omitted, <b>cwebp</b> will perform compression
|
|
but only report statistics. Using "−" as
|
|
output name will direct output to ’stdout’.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−−</b>
|
|
<i>string</i></p>
|
|
|
|
<p style="margin-left:22%;">Explicitly specify the input
|
|
file. This option is useful if the input file starts with an
|
|
’−’ for instance. This option must appear
|
|
<b>last</b>. Any other options afterward will be
|
|
ignored.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−h,
|
|
−help</b></p>
|
|
|
|
<p style="margin-left:22%;">A short usage summary.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−H,
|
|
−longhelp</b></p>
|
|
|
|
<p style="margin-left:22%;">A summary of all the possible
|
|
options.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−version</b></p>
|
|
|
|
<p style="margin-left:22%;">Print the version number (as
|
|
major.minor.revision) and exit.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−q</b>
|
|
<i>float</i></p>
|
|
|
|
<p style="margin-left:22%;">Specify the compression factor
|
|
for RGB channels between 0 and 100. The default is 75.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−alpha_q</b>
|
|
<i>int</i></p>
|
|
|
|
<p style="margin-left:22%;">Specify the compression factor
|
|
for alpha compression between 0 and 100. Lossless
|
|
compression of alpha is achieved using a value of 100, while
|
|
the lower values result in a lossy compression. The default
|
|
is 100.</p>
|
|
|
|
<table width="100%" border="0" rules="none" frame="void"
|
|
cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="9%">
|
|
|
|
|
|
<p><b>−f</b> <i>int</i></p></td>
|
|
<td width="2%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p>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.</p> </td></tr>
|
|
</table>
|
|
|
|
<p style="margin-left:11%;"><b>−preset</b>
|
|
<i>string</i></p>
|
|
|
|
<p style="margin-left:22%;">Specify a set of pre-defined
|
|
parameters to suit a particular type of source material.
|
|
Possible values are: <b>default</b>, <b>photo</b>,
|
|
<b>picture</b>, <b>drawing</b>, <b>icon</b>, <b>text</b>.
|
|
Since <b>−preset</b> overwrites the other
|
|
parameters’ values (except the <b>−q</b> one),
|
|
this option should preferably appear first in the order of
|
|
the arguments.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−sns</b>
|
|
<i>int</i></p>
|
|
|
|
<p style="margin-left:22%;">Specify the amplitude of the
|
|
spatial noise shaping. Spatial noise shaping (or <b>sns</b>
|
|
for short) refers to a general collection of built-in
|
|
algorithms used to decide which area of the picture should
|
|
use relatively less bits, and where else to better transfer
|
|
these bits. The possible range goes from 0 (algorithm is
|
|
off) to 100 (the maximal effect). The default value is
|
|
80.</p>
|
|
|
|
<table width="100%" border="0" rules="none" frame="void"
|
|
cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="9%">
|
|
|
|
|
|
<p><b>−m</b> <i>int</i></p></td>
|
|
<td width="2%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p>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 in faster processing time at the expense of
|
|
larger file size and lower compression quality.</p></td></tr>
|
|
</table>
|
|
|
|
<p style="margin-left:11%;"><b>−jpeg_like</b></p>
|
|
|
|
<p style="margin-left:22%;">Change the internal parameter
|
|
mapping to better match the expected size of JPEG
|
|
compression. This flag will generally produce an output file
|
|
of similar size to its JPEG equivalent (for the same
|
|
<b>−q</b> setting), but with less visual
|
|
distortion.</p>
|
|
|
|
<table width="100%" border="0" rules="none" frame="void"
|
|
cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="4%">
|
|
|
|
|
|
<p><b>−mt</b></p></td>
|
|
<td width="7%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p>Use multi-threading for encoding, if possible. This
|
|
option is only effective when using lossy compression on a
|
|
source with a transparency channel.</p></td></tr>
|
|
</table>
|
|
|
|
<p style="margin-left:11%;"><b>−low_memory</b></p>
|
|
|
|
<p style="margin-left:22%;">Reduce memory usage of lossy
|
|
encoding by saving four times the compressed size
|
|
(typically). This will make the encoding slower and the
|
|
output slightly different in size and distortion. This flag
|
|
is only effective for methods 3 and up, and is off by
|
|
default. Note that leaving this flag off will have some side
|
|
effects on the bitstream: it forces certain bitstream
|
|
features like number of partitions (forced to 1). Note that
|
|
a more detailed report of bitstream size is printed by
|
|
<b>cwebp</b> when using this option.</p>
|
|
|
|
<table width="100%" border="0" rules="none" frame="void"
|
|
cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="4%">
|
|
|
|
|
|
<p><b>−af</b></p></td>
|
|
<td width="7%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p>Turns auto-filter on. This algorithm will spend
|
|
additional time optimizing the filtering strength to reach a
|
|
well-balanced quality.</p></td></tr>
|
|
</table>
|
|
|
|
<h2>ADDITIONAL OPTIONS
|
|
<a name="ADDITIONAL OPTIONS"></a>
|
|
</h2>
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">More advanced
|
|
options are: <b><br>
|
|
−sharpness</b> <i>int</i></p>
|
|
|
|
<p style="margin-left:22%;">Specify the sharpness of the
|
|
filtering (if used). Range is 0 (sharpest) to 7 (least
|
|
sharp). Default is 0.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−strong</b></p>
|
|
|
|
<p style="margin-left:22%;">Use strong filtering (if
|
|
filtering is being used thanks to the <b>−f</b>
|
|
option). Strong filtering is on by default.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−nostrong</b></p>
|
|
|
|
<p style="margin-left:22%;">Disable strong filtering (if
|
|
filtering is being used thanks to the <b>−f</b>
|
|
option) and use simple filtering instead.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−segments</b>
|
|
<i>int</i></p>
|
|
|
|
<p style="margin-left:22%;">Change the number of partitions
|
|
to use during the segmentation of the sns algorithm.
|
|
Segments should be in range 1 to 4. Default value is 4. This
|
|
option has no effect for methods 3 and up, unless
|
|
<b>−low_memory</b> is used.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−partition_limit</b>
|
|
<i>int</i></p>
|
|
|
|
<p style="margin-left:22%;">Degrade quality by limiting the
|
|
number of bits used by some macroblocks. Range is 0 (no
|
|
degradation, the default) to 100 (full degradation). Useful
|
|
values are usually around 30-70 for moderately large images.
|
|
In the VP8 format, the so-called control partition has a
|
|
limit of 512k and is used to store the following
|
|
information: whether the macroblock is skipped, which
|
|
segment it belongs to, whether it is coded as intra 4x4 or
|
|
intra 16x16 mode, and finally the prediction modes to use
|
|
for each of the sub-blocks. For a very large image, 512k
|
|
only leaves room to few bits per 16x16 macroblock. The
|
|
absolute minimum is 4 bits per macroblock. Skip, segment,
|
|
and mode information can use up almost all these 4 bits
|
|
(although the case is unlikely), which is problematic for
|
|
very large images. The partition_limit factor controls how
|
|
frequently the most bit-costly mode (intra 4x4) will be
|
|
used. This is useful in case the 512k limit is reached and
|
|
the following message is displayed: <i>Error code: 6
|
|
(PARTITION0_OVERFLOW: Partition #0 is too big to fit
|
|
512k)</i>. If using <b>-partition_limit</b> is not enough to
|
|
meet the 512k constraint, one should use less segments in
|
|
order to save more header bits per macroblock. See the
|
|
<b>-segments</b> option.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−size</b>
|
|
<i>int</i></p>
|
|
|
|
<p style="margin-left:22%;">Specify a target size (in
|
|
bytes) to try and reach for the compressed output.
|
|
Compressor will make several pass of partial encoding in
|
|
order to get as close as possible to this target.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−psnr</b>
|
|
<i>float</i></p>
|
|
|
|
<p style="margin-left:22%;">Specify a target PSNR (in dB)
|
|
to try and reach for the compressed output. Compressor will
|
|
make several pass of partial encoding in order to get as
|
|
close as possible to this target.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−pass</b>
|
|
<i>int</i></p>
|
|
|
|
<p style="margin-left:22%;">Set a maximum number of passes
|
|
to use during the dichotomy used by options
|
|
<b>−size</b> or <b>−psnr</b>. Maximum value is
|
|
10.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−resize</b> <i>width
|
|
height</i></p>
|
|
|
|
<p style="margin-left:22%;">Resize the source to a
|
|
rectangle with size <b>width</b> x <b>height</b>. If either
|
|
(but not both) of the <b>width</b> or <b>height</b>
|
|
parameters is 0, the value will be calculated preserving the
|
|
aspect-ratio.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−crop</b>
|
|
<i>x_position y_position width height</i></p>
|
|
|
|
<p style="margin-left:22%;">Crop the source to a rectangle
|
|
with top-left corner at coordinates (<b>x_position</b>,
|
|
<b>y_position</b>) and size <b>width</b> x <b>height</b>.
|
|
This cropping area must be fully contained within the source
|
|
rectangle.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−s</b> <i>width
|
|
height</i></p>
|
|
|
|
<p style="margin-left:22%;">Specify that the input file
|
|
actually consists of raw Y’CbCr samples following the
|
|
ITU-R BT.601 recommendation, in 4:2:0 linear format. The
|
|
luma plane has size <b>width</b> x <b>height</b>.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−map</b>
|
|
<i>int</i></p>
|
|
|
|
<p style="margin-left:22%;">Output additional ASCII-map of
|
|
encoding information. Possible map values range from 1 to 6.
|
|
This is only meant to help debugging.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−pre</b>
|
|
<i>int</i></p>
|
|
|
|
<p style="margin-left:22%;">Specify some pre-processing
|
|
steps. Using a value of ’2’ will trigger
|
|
quality-dependent pseudo-random dithering during
|
|
RGBA->YUVA conversion (lossy compression only).</p>
|
|
|
|
<p style="margin-left:11%;"><b>−alpha_filter</b>
|
|
<i>string</i></p>
|
|
|
|
<p style="margin-left:22%;">Specify the predictive
|
|
filtering method for the alpha plane. One of
|
|
’none’, ’fast’ or
|
|
’best’, in increasing complexity and slowness
|
|
order. Default is ’fast’. Internally, alpha
|
|
filtering is performed using four possible predictions
|
|
(none, horizontal, vertical, gradient). The
|
|
’best’ mode will try each mode in turn and pick
|
|
the one which gives the smaller size. The ’fast’
|
|
mode will just try to form an a-priori guess without testing
|
|
all modes.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−alpha_method</b>
|
|
<i>int</i></p>
|
|
|
|
<p style="margin-left:22%;">Specify the algorithm used for
|
|
alpha compression: 0 or 1. Algorithm 0 denotes no
|
|
compression, 1 uses WebP lossless format for compression.
|
|
The default is 1.</p>
|
|
|
|
|
|
<p style="margin-left:11%;"><b>−alpha_cleanup</b></p>
|
|
|
|
<p style="margin-left:22%;">Modify unseen RGB values under
|
|
fully transparent area, to help compressibility. The default
|
|
is off.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−blend_alpha</b>
|
|
<i>int</i></p>
|
|
|
|
<p style="margin-left:22%;">This option blends the alpha
|
|
channel (if present) with the source using the background
|
|
color specified in hexadecimal as 0xrrggbb. The alpha
|
|
channel is afterward reset to the opaque value 255.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−noalpha</b></p>
|
|
|
|
<p style="margin-left:22%;">Using this option will discard
|
|
the alpha channel.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−lossless</b></p>
|
|
|
|
<p style="margin-left:22%;">Encode the image without any
|
|
loss.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−hint</b>
|
|
<i>string</i></p>
|
|
|
|
<p style="margin-left:22%;">Specify the hint about input
|
|
image type. Possible values are: <b>photo</b>,
|
|
<b>picture</b> or <b>graph</b>.</p>
|
|
|
|
<p style="margin-left:11%;"><b>−metadata</b>
|
|
<i>string</i></p>
|
|
|
|
<p style="margin-left:22%;">A comma separated list of
|
|
metadata to copy from the input to the output if present.
|
|
Valid values: <b>all</b>, <b>none</b>, <b>exif</b>,
|
|
<b>icc</b>, <b>xmp</b>. The default is <b>none</b>.</p>
|
|
|
|
<p style="margin-left:22%; margin-top: 1em">Note: each
|
|
input format may not support all combinations.</p>
|
|
|
|
<table width="100%" border="0" rules="none" frame="void"
|
|
cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="9%">
|
|
|
|
|
|
<p><b>−noasm</b></p></td>
|
|
<td width="2%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p>Disable all assembly optimizations.</p></td></tr>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="9%">
|
|
|
|
|
|
<p><b>−v</b></p></td>
|
|
<td width="2%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p>Print extra information (encoding time in
|
|
particular).</p> </td></tr>
|
|
</table>
|
|
|
|
<p style="margin-left:11%;"><b>−print_psnr</b></p>
|
|
|
|
<p style="margin-left:22%;">Compute and report average PSNR
|
|
(Peak-Signal-To-Noise ratio).</p>
|
|
|
|
<p style="margin-left:11%;"><b>−print_ssim</b></p>
|
|
|
|
<p style="margin-left:22%;">Compute and report average SSIM
|
|
(structural similarity metric, see
|
|
http://en.wikipedia.org/wiki/SSIM for additional
|
|
details).</p>
|
|
|
|
<p style="margin-left:11%;"><b>−print_lsim</b></p>
|
|
|
|
<p style="margin-left:22%;">Compute and report local
|
|
similarity metric (sum of lowest error amongst the
|
|
collocated pixel neighbors).</p>
|
|
|
|
<p style="margin-left:11%;"><b>−progress</b></p>
|
|
|
|
<p style="margin-left:22%;">Report encoding progress in
|
|
percent.</p>
|
|
|
|
<table width="100%" border="0" rules="none" frame="void"
|
|
cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="9%">
|
|
|
|
|
|
<p><b>−quiet</b></p></td>
|
|
<td width="2%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p>Do not print anything.</p></td></tr>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="9%">
|
|
|
|
|
|
<p><b>−short</b></p></td>
|
|
<td width="2%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p>Only print brief information (output file size and PSNR)
|
|
for testing purpose.</p></td></tr>
|
|
</table>
|
|
|
|
<h2>BUGS
|
|
<a name="BUGS"></a>
|
|
</h2>
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">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/</p>
|
|
|
|
<h2>EXAMPLES
|
|
<a name="EXAMPLES"></a>
|
|
</h2>
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">cwebp −q
|
|
50 -lossless picture.png −o picture_lossless.webp <br>
|
|
cwebp −q 70 picture_with_alpha.png −o
|
|
picture_with_alpha.webp <br>
|
|
cwebp −sns 70 −f 50 −size 60000
|
|
picture.png −o picture.webp <br>
|
|
cwebp −o picture.webp −−
|
|
−−−picture.png</p>
|
|
|
|
<h2>AUTHORS
|
|
<a name="AUTHORS"></a>
|
|
</h2>
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em"><b>cwebp</b>
|
|
was written by the WebP team. <br>
|
|
The latest source tree is available at
|
|
http://www.webmproject.org/code</p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">This manual
|
|
page was written by Pascal Massimino
|
|
<pascal.massimino@gmail.com>, for the Debian project
|
|
(and may be used by others).</p>
|
|
|
|
<h2>SEE ALSO
|
|
<a name="SEE ALSO"></a>
|
|
</h2>
|
|
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em"><b>dwebp</b>(1),
|
|
<b>gif2webp</b>(1) <br>
|
|
Please refer to http://developers.google.com/speed/webp/ for
|
|
additional information.</p>
|
|
<hr>
|
|
</body>
|
|
</html>
|