1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
.TH EXIFTRAN 1 "(c) 2002-2012 Gerd Hoffmann" "EXIFTRAN 2.09" "Transform digital camera jpeg images"
\#
\#
.SH NAME
exiftran - transform digital camera jpeg images
\#
\#
.SH SYNOPSIS
.TP
\fBexiftran\fP [\fIoptions\fP] \fIfile1 file2 ... fileN\fP
.TP
\fBexiftran\fP -i [\fItransform options\fP] [\fIothers options\fP] \fIfile1 file2 ... fileN\fP
.TP
\fBexiftran\fP -o \fIoutputfile\fP [\fItransform options\fP] [\fIother options\fP] \fIinputfile\fP
.TP
\fBexiftran\fP -d \fIfile1 file2 ... fileN\fP > \fIexifinfo\fP
\#
\#
.SH DESCRIPTION
.BR Exiftran
is a command line utility to transform digital camera \fIjpeg\fP images. It can do lossless
rotations like
.BR "jpegtran" "(1),"
but unlike
.BR "jpegtran" "(1)"
it cares about the \fIEXIF\fP data: It can rotate images automatically by
checking the exif orientation tag; it updates the exif informations if needed
(image dimension, orientation); it also rotates the exif thumbnail. It can
process multiple images at once.
\#
\#
.SH "TRANSFORM OPTIONS"
.TP
.B -a
Automatic (using exif orientation tag).
.TP
.B -9
Rotate by 90 degrees clockwise.
.TP
.B -1
Rotate by 180 degrees clockwise.
.TP
.B -2
Rotate by 270 degrees clockwise.
.TP
.B -f
Mirror image vertically (top / bottom).
.TP
.B -F
Mirror image horizontally (left to right).
.TP
.B -t
Transpose (across UL-to-LR corner).
.TP
.B -T
Transverse (across UR-to-LL corner).
.TP
.B -nt
Don't transform exif thumbnail.
.TP
.B -ni
Don't transform jpeg image. You might need this or the \fB-nt\fP option to fixup
things in case you transformed the image with some utility which ignores the
exif thumbnail. Just generating a new thumbnail with \fB-g\fP is another way to
fix it.
.TP
.B -no
Don't update the orientation tag. By default
.BR exiftran
sets the orientation to "1" (no transformation needed) to avoid other exif-aware
applications try to rotate the already-rotated image again.
.TP
.B -np
Don't pare lost edges. By default
.BR exiftran
don't preserve image size of the images that do not meet a
multiple of 8 pixels. He prefers to cut a strip of a few pixels rather than
offering a damaged image. Use this option if you want them all the same.
\#
\#
.SH "OTHER OPTIONS"
.TP
.B -h
Print a short help text.
.TP
.B -d
Dump exif data for the file(s).
.TP
.BI "-c" "\ text"
Set jpeg comment tag to \fItext\fP.
.TP
.B -g
(re)generate exif thumbnail.
.TP
.BI "-o" "\ file"
Specify output \fIfile\fP. Only one input file is allowed in this mode.
.TP
.B -i
Enable in-place editing of the images.
.BR Exiftran
allows multiple input files then. You must specify either this option or a
output file with \fB-o\fP for all operations which modify the image (i.e.
everything but \fB-d\fP right now).
.TP
.B -b
Create a backup file when doing in-place editing (imply \fB-i\fP).
.TP
.B -p
Preserve timestamps (atime + mtime) when doing in-place editing (imply \fB-i\fP).
\#
\#
.SH EXAMPLES
Autorotate all jpeg files in the current directory:
.P
.in +4n
\fIexiftran\ -ai\ *.jpeg\fP
.in
\#
\#
.SH "SEE ALSO"
.BR exif (1),
.BR exiftags (1),
.BR jpegtran (1)
\#
\#
.SH AUTHOR
Gerd Hoffmann
.BR <gerd@kraxel.org>
\#
\#
.SH COPYRIGHT
Copyright (c) 2002-2012 Gerd Hoffmann <gerd@kraxel.org>
.P
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.
.P
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.
.P
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave,
Cambridge, MA 02139, USA.
|
