← Back to branch summary

~ubuntu-branches/ubuntu/quantal/libjpeg6b/quantal

« back to all changes in this revision

Viewing changes to jpegtran.1

  • Committer: Bazaar Package Importer
  • Author(s): Bill Allombert
  • Date: 2010-06-29 13:55:42 UTC
  • mfrom: (4.1.4 sid)
  • Revision ID: james.westby@ubuntu.com-20100629135542-u2ux634ovmawtrog
Tags: 6b1-1
* New upstream release
  - libjpeg62 has now versionned symbols.
  - Updated build system that use current libtool.
  - Full source code for the build system.
* debian/copyright: add 6b1 upstream download URL.
* debian/control:
  - libjpeg62-dev: Provides libjpeg-dev since the transition has been
    postponed.
  - Remove now useless dependency on libtool and sharutils
  - Bump Standards-Version to 3.9.0.
* Get rid of dpatch system. Patches were only relevant to libjpeg-progs
  which is not build from this package anymore.
* Move to new source format 3.0 (quilt). Patches applied:
  - use-autotools-dev: Use autotools-dev version of config.sub/.guess.
  - extern_C-jpeglib.h: Wrap jpeglib.h with extern "C" {} if __cplusplus 
    is defined.
* debian/rules:
  - Adjust for new build system and new patch system.
* debian/shlibs: add (>=6b1) to avoid linker warnings with libjpeg6b.

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
 
.IP
 
94
.PP
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
 
.IP
 
99
.PP
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
 
.IP
 
111
.PP
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
 
.IP
 
120
.PP
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
 
.IP
134
 
If you are only interested by perfect transformation, add the
135
 
.B \-perfect
136
 
switch:
137
 
.TP
138
 
.B \-perfect
139
 
Fails with an error if the transformation is not perfect. For example
140
 
you may want to do
141
 
.IP
142
 
.B (jpegtran \-rot 90 -perfect foo.jpg || djpeg foo.jpg| pnmflip \-r90 | cjpeg)
143
 
.IP
144
 
to do a perfect rotation if available or an approximated one if
145
 
not.
146
 
.PP
147
 
We also offer a lossless-crop option, which discards data outside a given
148
 
image region but losslessly preserves what is inside.  Like the rotate and
149
 
flip transforms, lossless crop is restricted by the JPEG format: the upper
150
 
left corner of the selected region must fall on an iMCU boundary.  If this
151
 
does not hold for the given crop parameters, we silently move the upper left
152
 
corner up and/or left to make it so, simultaneously increasing the region
153
 
dimensions to keep the lower right crop corner unchanged.  (Thus, the
154
 
output image covers at least the requested region, but may cover more.)
155
 
.IP
156
 
Note: 
157
 
.B \-perfect
158
 
and
159
 
.B lossless-crop
160
 
are enhancements from http://sylvana.net/jpegcrop/ that may not be available on
161
 
non-Debian systems.
162
 
.PP
163
 
The image can be losslessly cropped by giving the switch:
164
 
.TP
165
 
.B \-crop WxH+X+Y
166
 
Crop to a rectangular subarea of width W, height H starting at point X,Y.
167
133
.PP
168
134
Another not-strictly-lossless transformation switch is:
169
135
.TP
170
136
.B \-grayscale
171
137
Force grayscale output.
172
 
.IP
 
138
.PP
173
139
This option discards the chrominance channels if the input image is YCbCr
174
140
(ie, a standard color JPEG), resulting in a grayscale JPEG file.  The
175
141
luminance channel is preserved exactly, so this is a better method of reducing
193
159
.TP
194
160
.B \-copy all
195
161
Copy all extra markers.  This setting preserves miscellaneous markers
196
 
found in the source file, such as
197
 
Exif data,
198
 
JFIF thumbnails and Photoshop settings.
 
162
found in the source file, such as JFIF thumbnails and Photoshop settings.
199
163
In some files these extra markers can be sizable.
200
 
.IP
 
164
.PP
201
165
The default behavior is
202
166
.BR "\-copy comments" .
203
167
(Note: in IJG releases v6 and v6a,
267
231
.PP
268
232
The transform options can't transform odd-size images perfectly.  Use
269
233
.B \-trim
270
 
or
271
 
.B \-perfect
272
 
if you don't like the results.
 
234
if you don't like the results without it.
273
235
.PP
274
236
The entire image is read into memory and then written out again, even in
275
237
cases where this isn't really necessary.  Expect swapping on large images,