← Back to branch summary

~ubuntu-branches/ubuntu/natty/libjpeg6b/natty

« back to all changes in this revision

Viewing changes to jpegtran.1

  • Committer: Bazaar Package Importer
  • Author(s): Bill Allombert
  • Date: 2007-08-16 22:59:21 UTC
  • Revision ID: james.westby@ubuntu.com-20070816225921-vk7fsapj4mxi5v9f
Tags: 6b-14
* The "Lino" release.
* exifautotran:
  - fix typo in manpage. closes: #376371, thanks Reuben Thomas.
  - preserve file mode. closes: #383379, thanks Vincent Arkesteijn.
* debian/control, debian/rules, debian/compat:
  + switch to debhelper v5
  + add libjpeg-dbg debugging package.
* debian/rules: remove - before "make clean" rules.
* Add patch 204_jpegtran_man to improve readability of manpage.
  closes: #437453. Thanks Jorgen Grahn.
* jpegexiforient.1: Apply patch from Jorgen Grahn to improve formatting.
  closes: #437446.

Show diffs side-by-side

added added

removed removed

Lines of Context:
jpegtran.1
91
91
.TP
92
92
.B \-transverse
93
93
Transverse transpose (across UR-to-LL axis).
94
 
.PP
 
94
.IP
95
95
The transpose transformation has no restrictions regarding image dimensions.
96
96
The other transformations operate rather oddly if the image dimensions are not
97
97
a multiple of the iMCU size (usually 8 or 16 pixels), because they can only
98
98
transform complete blocks of DCT coefficient data in the desired way.
99
 
.PP
 
99
.IP
100
100
.BR jpegtran 's
101
101
default behavior when transforming an odd-size image is designed
102
102
to preserve exact reversibility and mathematical consistency of the
108
108
of transpose and flip operations; for consistency, their actions on edge
109
109
pixels are defined to be the same as the end result of the corresponding
110
110
transpose-and-flip sequence.
111
 
.PP
 
111
.IP
112
112
For practical use, you may prefer to discard any untransformable edge pixels
113
113
rather than having a strange-looking strip along the right and/or bottom edges
114
114
of a transformed image.  To do this, add the
117
117
.TP
118
118
.B \-trim
119
119
Drop non-transformable edge blocks.
120
 
.PP
 
120
.IP
121
121
Obviously, a transformation with
122
122
.B \-trim
123
123
is not reversible, so strictly speaking
130
130
followed by
131
131
.B \-rot 180 -trim
132
132
trims both edges.
133
 
.PP
 
133
.IP
134
134
If you are only interested by perfect transformation, add the
135
135
.B \-perfect
136
136
switch:
138
138
.B \-perfect
139
139
Fails with an error if the transformation is not perfect. For example
140
140
you may want to do
141
 
.TP
 
141
.IP
142
142
.B (jpegtran \-rot 90 -perfect foo.jpg || djpeg foo.jpg| pnmflip \-r90 | cjpeg)
 
143
.IP
143
144
to do a perfect rotation if available or an approximated one if
144
145
not.
145
146
.PP
151
152
corner up and/or left to make it so, simultaneously increasing the region
152
153
dimensions to keep the lower right crop corner unchanged.  (Thus, the
153
154
output image covers at least the requested region, but may cover more.)
154
 
 
 
155
.IP
155
156
Note: 
156
157
.B \-perfect
157
158
and
158
159
.B lossless-crop
159
160
are enhancements from http://sylvana.net/jpegcrop/ that may not be available on
160
161
non-Debian systems.
161
 
 
 
162
.PP
162
163
The image can be losslessly cropped by giving the switch:
163
164
.TP
164
165
.B \-crop WxH+X+Y
165
166
Crop to a rectangular subarea of width W, height H starting at point X,Y.
166
167
.PP
167
 
.PP
168
168
Another not-strictly-lossless transformation switch is:
169
169
.TP
170
170
.B \-grayscale
171
171
Force grayscale output.
172
 
.PP
 
172
.IP
173
173
This option discards the chrominance channels if the input image is YCbCr
174
174
(ie, a standard color JPEG), resulting in a grayscale JPEG file.  The
175
175
luminance channel is preserved exactly, so this is a better method of reducing
193
193
.TP
194
194
.B \-copy all
195
195
Copy all extra markers.  This setting preserves miscellaneous markers
196
 
found in the source file, such as JFIF thumbnails and Photoshop settings.
 
196
found in the source file, such as
 
197
Exif data,
 
198
JFIF thumbnails and Photoshop settings.
197
199
In some files these extra markers can be sizable.
198
 
.PP
 
200
.IP
199
201
The default behavior is
200
202
.BR "\-copy comments" .
201
203
(Note: in IJG releases v6 and v6a,