summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJorgen Grahn <grahn+debian@snipabacken.dyndns.org>2009-01-09 00:52:09 +0100
committerChristoph Brill <egore911@egore911.de>2009-01-09 00:52:09 +0100
commitd3bd68a9f32c3c5f1f9f08dbf8171a6b241f3b5f (patch)
tree74b43b576f36311a50f7cf054bad00c415d14dfd
parentcb2273c41cf995cf1e32f62e1a7f2aea8e6fde4b (diff)
[PATCH] 204_jpegtran_man.dpatch
improves readability of jpegtran man page
-rw-r--r--jpegtran.126
1 files changed, 14 insertions, 12 deletions
diff --git a/jpegtran.1 b/jpegtran.1
index 4e5b33c..56ca709 100644
--- a/jpegtran.1
+++ b/jpegtran.1
@@ -91,12 +91,12 @@ Transpose image (across UL-to-LR axis).
.TP
.B \-transverse
Transverse transpose (across UR-to-LL axis).
-.PP
+.IP
The transpose transformation has no restrictions regarding image dimensions.
The other transformations operate rather oddly if the image dimensions are not
a multiple of the iMCU size (usually 8 or 16 pixels), because they can only
transform complete blocks of DCT coefficient data in the desired way.
-.PP
+.IP
.BR jpegtran 's
default behavior when transforming an odd-size image is designed
to preserve exact reversibility and mathematical consistency of the
@@ -108,7 +108,7 @@ able to flip all columns. The other transforms can be built up as sequences
of transpose and flip operations; for consistency, their actions on edge
pixels are defined to be the same as the end result of the corresponding
transpose-and-flip sequence.
-.PP
+.IP
For practical use, you may prefer to discard any untransformable edge pixels
rather than having a strange-looking strip along the right and/or bottom edges
of a transformed image. To do this, add the
@@ -117,7 +117,7 @@ switch:
.TP
.B \-trim
Drop non-transformable edge blocks.
-.PP
+.IP
Obviously, a transformation with
.B \-trim
is not reversible, so strictly speaking
@@ -130,7 +130,7 @@ trims only the bottom edge, but
followed by
.B \-rot 180 -trim
trims both edges.
-.PP
+.IP
If you are only interested by perfect transformation, add the
.B \-perfect
switch:
@@ -138,8 +138,9 @@ switch:
.B \-perfect
Fails with an error if the transformation is not perfect. For example
you may want to do
-.TP
+.IP
.B (jpegtran \-rot 90 -perfect foo.jpg || djpeg foo.jpg| pnmflip \-r90 | cjpeg)
+.IP
to do a perfect rotation if available or an approximated one if
not.
.PP
@@ -151,25 +152,24 @@ does not hold for the given crop parameters, we silently move the upper left
corner up and/or left to make it so, simultaneously increasing the region
dimensions to keep the lower right crop corner unchanged. (Thus, the
output image covers at least the requested region, but may cover more.)
-
+.IP
Note:
.B \-perfect
and
.B lossless-crop
are enhancements from http://sylvana.net/jpegcrop/ that may not be available on
non-Debian systems.
-
+.PP
The image can be losslessly cropped by giving the switch:
.TP
.B \-crop WxH+X+Y
Crop to a rectangular subarea of width W, height H starting at point X,Y.
.PP
-.PP
Another not-strictly-lossless transformation switch is:
.TP
.B \-grayscale
Force grayscale output.
-.PP
+.IP
This option discards the chrominance channels if the input image is YCbCr
(ie, a standard color JPEG), resulting in a grayscale JPEG file. The
luminance channel is preserved exactly, so this is a better method of reducing
@@ -193,9 +193,11 @@ but discards any other inessential data.
.TP
.B \-copy all
Copy all extra markers. This setting preserves miscellaneous markers
-found in the source file, such as JFIF thumbnails and Photoshop settings.
+found in the source file, such as
+Exif data,
+JFIF thumbnails and Photoshop settings.
In some files these extra markers can be sizable.
-.PP
+.IP
The default behavior is
.BR "\-copy comments" .
(Note: in IJG releases v6 and v6a,