diff options
Diffstat (limited to 'exiftran.man')
| -rw-r--r-- | exiftran.man | 148 |
1 files changed, 90 insertions, 58 deletions
diff --git a/exiftran.man b/exiftran.man index 4f3efde..4249d44 100644 --- a/exiftran.man +++ b/exiftran.man @@ -1,106 +1,138 @@ -.TH exiftran 1 "(c) 2003,04 Gerd Knorr" +.TH EXIFTRAN 1 "(c) 2002-2012 Gerd Knorr" "EXIFTRAN 2.08" "Transform digital camera jpeg images" +\# +\# .SH NAME exiftran - transform digital camera jpeg images +\# +\# .SH SYNOPSIS -.B exiftran [ options ] file(s) +.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 -.B exiftran -is a command line utility to transform digital image jpeg images. It -can do lossless rotations like jpegtran, but unlike jpegtran it cares -about the EXIF data: It can rotate images automatically by checking -the exif orientation tag, it updates the exif informaton if needed -(image dimension, orientation), it also rotates the exif thumbnail. -It can process multiple images at once. -.SH TRANSFORM OPTIONS +.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) +Automatic (using exif orientation tag). .TP .B -9 -rotate by 90 degrees +Rotate by 90 degrees clockwise. .TP .B -1 -rotate by 180 degrees +Rotate by 180 degrees clockwise. .TP .B -2 -rotate by 270 degrees +Rotate by 270 degrees clockwise. .TP .B -f -flip vertical +Mirror image vertically (top / bottom). .TP .B -F -flip horizontal +Mirror image horizontally (left to right). .TP .B -t -transpose +Transpose (across UL-to-LR corner). .TP .B -T -transverse +Transverse (across UR-to-LL corner). .TP .B -nt -Don't rotate exif thumbnail. +Don't transform exif thumbnail. .TP .B -ni -Don't rotate jpeg image. You might need this or or the -nt option to -fixup things in case you rotated the image with some utility which -ignores the exif thumbnail. Just generating a new thumbnail with -g is -another way to fix it. +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 exiftran sets the -orientation to "1" (no transformation needed) to avoid other -exif-aware applications try to rotate the already-rotated image -again. -.SH OTHER OPTIONS +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. +\# +\# +.SH "OTHER OPTIONS" .TP .B -h -print a short help text +Print a short help text. .TP .B -d Dump exif data for the file(s). .TP -.B -c <text> -Set jpeg comment tag to <text>. +.BI "-c" "\ text" +Set jpeg comment tag to \fItext\fP. .TP .B -g -(re)generate EXIF thumbnail. +(re)generate exif thumbnail. .TP -.B -o <file> -Specify output file. Only one input file is allowed in this mode. +.BI "-o" "\ file" +Specify output \fIfile\fP. Only one input file is allowed in this mode. .TP .B -i -Enable inplace editing of the images. Exiftran allows multiple input -files then. You must specify either this option or a output file with --o for all operations which modify the image (i.e. everything but -d -right now). +Enable inplace 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 inplace editing. +Create a backup file when doing inplace editing (imply \fB-i\fP). .TP .B -p -Preserve timestamps (atime + mtime) when doing inplace editing. +Preserve timestamps (atime + mtime) when doing inplace editing (imply \fB-i\fP). +\# +\# .SH EXAMPLES Autorotate all jpeg files in the current directory: -.nf - exiftran -ai *.jpeg -.fi -.SH SEE ALSO -jpegtran(1), exif(1) +.P +.in +4n + \fIexiftran\ -ai\ *.jpeg\fP +.in +\# +\# +.SH "SEE ALSO" +.BR exif (1), +.BR exiftags (1), +.BR jpegtran (1) +\# +\# .SH AUTHOR -Gerd Knorr <kraxel@bytesex.org> +Gerd Knorr +.BR <kraxel@bytesex.org> +\# +\# .SH COPYRIGHT -Copyright (C) 2002 Gerd Knorr <kraxel@bytesex.org> +Copyright (c) 2002-2012 Gerd Knorr <kraxel@bytesex.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. +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. +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. +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. |