dany/libwebp
1
0
Fork 0
mirror of https://github.com/webmproject/libwebp.git synced 2025-04-03 15:36:50 +02:00
Code Issues Actions Packages Projects Releases Wiki Activity

man/cwebp.1: add note about crop/resize order

Browse Source 
+ normalize help text in [cd]webp

Bug: webp:561
Change-Id: Id92ec4228d4933cd033b2bf68a43192532cef483
This commit is contained in:
James Zern 2022-03-17 10:29:02 -07:00
parent f0e9351cce
commit 34bb332ca1
4 changed files with 12 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
doc/tools.md
View File

@ -64,7 +64,7 @@ Options:
-qrange <min> <max> .... specifies the permissible quality range -qrange <min> <max> .... specifies the permissible quality range
(default: 0 100) (default: 0 100)
-crop <x> <y> <w> <h> .. crop picture with the given rectangle -crop <x> <y> <w> <h> .. crop picture with the given rectangle
-resize <w> <h> ........ resize picture (after any cropping) -resize <w> <h> ........ resize picture (*after* any cropping)
-mt .................... use multi-threading if available -mt .................... use multi-threading if available
-low_memory ............ reduce memory usage (slower encoding) -low_memory ............ reduce memory usage (slower encoding)
-map <int> ............. print map of extra info -map <int> ............. print map of extra info
@ -181,7 +181,7 @@ Other options are:
-alpha_dither use alpha-plane dithering if needed -alpha_dither use alpha-plane dithering if needed
-mt .......... use multi-threading -mt .......... use multi-threading
-crop <x> <y> <w> <h> ... crop output with the given rectangle -crop <x> <y> <w> <h> ... crop output with the given rectangle
-resize <w> <h> ......... scale the output (*after* any cropping) -resize <w> <h> ......... resize output (*after* any cropping)
-flip ........ flip the output vertically -flip ........ flip the output vertically
-alpha ....... only save the alpha plane -alpha ....... only save the alpha plane
-incremental . use incremental decoding (useful for tests) -incremental . use incremental decoding (useful for tests)

2
examples/cwebp.c
View File

@ -571,7 +571,7 @@ static void HelpLong(void) {
printf(" -qrange <min> <max> .... specifies the permissible quality range\n" printf(" -qrange <min> <max> .... specifies the permissible quality range\n"
" (default: 0 100)\n"); " (default: 0 100)\n");
printf(" -crop <x> <y> <w> <h> .. crop picture with the given rectangle\n"); printf(" -crop <x> <y> <w> <h> .. crop picture with the given rectangle\n");
printf(" -resize <w> <h> ........ resize picture (after any cropping)\n"); printf(" -resize <w> <h> ........ resize picture (*after* any cropping)\n");
printf(" -mt .................... use multi-threading if available\n"); printf(" -mt .................... use multi-threading if available\n");
printf(" -low_memory ............ reduce memory usage (slower encoding)\n"); printf(" -low_memory ............ reduce memory usage (slower encoding)\n");
printf(" -map <int> ............. print map of extra info\n"); printf(" -map <int> ............. print map of extra info\n");

2
examples/dwebp.c
View File

@ -96,7 +96,7 @@ static void Help(void) {
" -alpha_dither use alpha-plane dithering if needed\n" " -alpha_dither use alpha-plane dithering if needed\n"
" -mt .......... use multi-threading\n" " -mt .......... use multi-threading\n"
" -crop <x> <y> <w> <h> ... crop output with the given rectangle\n" " -crop <x> <y> <w> <h> ... crop output with the given rectangle\n"
" -resize <w> <h> ......... scale the output (*after* any cropping)\n" " -resize <w> <h> ......... resize output (*after* any cropping)\n"
" -flip ........ flip the output vertically\n" " -flip ........ flip the output vertically\n"
" -alpha ....... only save the alpha plane\n" " -alpha ....... only save the alpha plane\n"
" -incremental . use incremental decoding (useful for tests)\n" " -incremental . use incremental decoding (useful for tests)\n"

14
man/cwebp.1
View File

@ -1,5 +1,5 @@
.\" Hey, EMACS: -*- nroff -*- .\" Hey, EMACS: -*- nroff -*-
.TH CWEBP 1 "November 17, 2021" .TH CWEBP 1 "March 17, 2022"
.SH NAME .SH NAME
cwebp \- compress an image file to a WebP file cwebp \- compress an image file to a WebP file
.SH SYNOPSIS .SH SYNOPSIS
@ -90,15 +90,17 @@ additional encoding possibilities and decide on the quality gain.
Lower value can result in faster processing time at the expense of Lower value can result in faster processing time at the expense of
larger file size and lower compression quality. larger file size and lower compression quality.
.TP .TP
.BI \-resize " width height
Resize the source to a rectangle with size \fBwidth\fP x \fBheight\fP.
If either (but not both) of the \fBwidth\fP or \fBheight\fP parameters is 0,
the value will be calculated preserving the aspect\-ratio.
.TP
.BI \-crop " x_position y_position width height .BI \-crop " x_position y_position width height
Crop the source to a rectangle with top\-left corner at coordinates Crop the source to a rectangle with top\-left corner at coordinates
(\fBx_position\fP, \fBy_position\fP) and size \fBwidth\fP x \fBheight\fP. (\fBx_position\fP, \fBy_position\fP) and size \fBwidth\fP x \fBheight\fP.
This cropping area must be fully contained within the source rectangle. This cropping area must be fully contained within the source rectangle.
Note: the cropping is applied \fIbefore\fP any scaling.
.TP
.BI \-resize " width height
Resize the source to a rectangle with size \fBwidth\fP x \fBheight\fP.
If either (but not both) of the \fBwidth\fP or \fBheight\fP parameters is 0,
the value will be calculated preserving the aspect\-ratio. Note: scaling
is applied \fIafter\fP cropping.
.TP .TP
.B \-mt .B \-mt
Use multi\-threading for encoding, if possible. Use multi\-threading for encoding, if possible.