diff options
| -rw-r--r-- | exiftran.c | 24 | ||||
| -rw-r--r-- | exiftran.man | 148 | ||||
| -rw-r--r-- | exiftran.man.fr | 146 |
3 files changed, 249 insertions, 69 deletions
@@ -1,5 +1,7 @@ /* + * Transform digital camera jpeg images * + * (c) 2002-2012 Gerd Hoffmann <kraxel@bytesex.org> */ #include <stdio.h> @@ -82,30 +84,30 @@ usage(FILE *fp, char *name) "\n" "transform options:\n" " -a automatic (using exif orientation tag)\n" - " -9 rotate by 90 degrees\n" - " -1 rotate by 180 degrees\n" - " -2 rotate by 270 degrees\n" - " -f flip vertical\n" - " -F flip horizontal\n" - " -t transpose\n" - " -T transverse\n" + " -9 rotate by 90 degrees clockwise\n" + " -1 rotate by 180 degrees clockwise\n" + " -2 rotate by 270 degrees clockwise\n" + " -f mirror image vertically (top / bottom)\n" + " -F mirror image horizontally (left to right)\n" + " -t transpose (across UL-to-LR corner)\n" + " -T transverse (across UR-to-LL corner)\n" "\n" " -nt don't rotate exif thumbnail\n" " -ni don't rotate jpeg image\n" " -no don't update the orientation tag\n" "\n" "other options:\n" - " -h print this text\n" + " -h print this help text\n" " -d dump exif data\n" " -c <text> create/update comment\n" " -g (re)generate thumbnail\n" " -o <file> output file\n" " -i change files inplace\n" - " -b create a backup file (with -i)\n" - " -p preserve timestamps (with -i)\n" + " -b create a backup file (with -i)\n" + " -p preserve timestamps (with -i)\n" "\n" "-- \n" - "Gerd Hoffmann <kraxel@bytesex.org> [SUSE Labs]\n", + "(c) 2002-2012 Gerd Hoffmann <kraxel@bytesex.org> [SUSE Labs]\n", name); } 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. diff --git a/exiftran.man.fr b/exiftran.man.fr new file mode 100644 index 0000000..fc52ceb --- /dev/null +++ b/exiftran.man.fr @@ -0,0 +1,146 @@ +.TH EXIFTRAN 1 "(c) 2002-2012 Gerd Knorr" "EXIFTRAN 2.08" "Transformation d'images jpeg d'appareil photo numérique" +\# +\# +.SH NOM +exiftran - transformation d'images jpeg d'appareil photo numérique +\# +\# +.SH SYNOPSIS +.TP +\fBexiftran\fP [\fIoptions\fP] \fIfile1 file2 ... fileN\fP +.TP +\fBexiftran\fP -i [\fItransformation options\fP] [\fIautres options\fP] \fIfile1 file2 ... fileN\fP +.TP +\fBexiftran\fP -o \fIfichiersortie\fP [\fItransformation options\fP] [\fIautres options\fP] \fIfichierentree\fP +.TP +\fBexiftran\fP -d \fIfile1 file2 ... fileN\fP > \fIexifinfo\fP +\# +\# +.SH DESCRIPTION +.BR Exiftran +est un utilitaire en ligne de commande pour transformer des images \fIjpeg\fP +d'appareil photo numérique. Il peut faire des rotations sans perte de données +comme +.BR "jpegtran" "(1)," +mais au contraire de +.BR "jpegtran" "(1)" +il tient compte des données \fIEXIF\fP : il peut pivoter les images +automatiquement en vérifiant la propriété exif d'orientation ; il met à jour +les informations exif si nécessaire (dimension de l'image, orientation) ; il +pivote aussi la miniature exif. Il peut traiter plusieurs images en une seule +opération. +\# +\# +.SH "OPTIONS DE TRANSFORMATION" +.TP +.B -a +Automatique (utilise la propriété d'orientation exif). +.TP +.B -9 +Rotation de 90 degrés dans le sens des aiguilles d'une montre. +.TP +.B -1 +Rotation de 180 degrés dans le sens des aiguilles d'une montre. +.TP +.B -2 +Rotation de 270 degrés dans le sens des aiguilles d'une montre. +.TP +.B -f +Rotation d'axe horizontal (haut / bas). +.TP +.B -F +Rotation d'axe vertical (gauche / droite). +.TP +.B -t +Rotation d'axe oblique (sommets HG et BD). +.TP +.B -T +Rotation d'axe oblique (sommets HD et BG). +.TP +.B -nt +Ne pas transformer la miniature exif. +.TP +.B -ni +Ne pas transformer l'image jpeg. Vous pourriez avoir besoin de ceci ou de +l'option \fB-nt\fP pour faire des corrections dans le cas où vous avez +transformé une image avec des utilitaires qui ignorent la miniature exif. +Mettre à jour la miniature seule avec \fB-g\fP est une autre solution. +.TP +.B -no +Ne pas mettre à jour la propriété d'orientation. Par défaut +.BR exiftran +positionne l'orientation à "1" (aucune transformation nécessaire) pour +empêcher d'autres logiciels de manipulation des données exif d'essayer de +pivoter l'image qui l'est déjà. +\# +\# +.SH "AUTRES OPTIONS" +.TP +.B -h +Afficher un court message d'aide. +.TP +.B -d +Extraire les données exif du ou des fichiers. +.TP +.BI "-c" "\ texte" +Enregistrer un \fItexte\fP dans la propriété commentaire. +.TP +.B -g +Refabriquer la miniature exif. +.TP +.BI "-o" "\ fichier" +Indiquer le \fIfichier\fP de sortie. Ce mode n'autorise qu'un seul fichier en entrée. +.TP +.B -i +Activer la modification directe des images. +.BR Exiftran +accepte plusieurs fichiers en entrée. Vous devez indiquer cette option ou +un fichier de sortie avec \fB-o\fP pour toutes les opérations qui modifient +l'image (c-à-d toutes sauf \fB-d\fP évidemment). +.TP +.B -b +Créer un fichier de sauvegarde lors des modifications directes (implique \fB-i\fP). +.TP +.B -p +Préserver l'horodatage (atime + mtime) lors des modifications directes (implique \fB-i\fP). +\# +\# +.SH EXEMPLES +Rotation automatique de tous les fichiers jpeg du répertoire courant : +.P +.in +4n + \fIexiftran\ -ai\ *.jpeg\fP +.in +\# +\# +.SH "VOIR AUSSI" +.BR exif (1), +.BR exiftags (1), +.BR jpegtran (1) +\# +\# +.SH TRADUCTEUR +Stéphane Aulery +.BR <lkppo@free.fr> +\# +\# +.SH AUTEUR +Gerd Knorr +.BR <kraxel@bytesex.org> +\# +\# +.SH COPYRIGHT +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. +.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. |