← Back to branch summary

~ubuntu-branches/ubuntu/precise/exiv2/precise

« back to all changes in this revision

Viewing changes to src/exiv2.1

  • Committer: Bazaar Package Importer
  • Author(s): Anthony Mercatante
  • Date: 2006-12-07 18:40:10 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20061207184010-0ouu8v0dr8nznob9
Tags: 0.12-0ubuntu1
New upstream release

Show diffs side-by-side

added added

removed removed

Lines of Context:
src/exiv2.1
1
1
.\"                                      Hey, EMACS: -*- nroff -*-
2
 
.\" @(#) $Id: exiv2.1 793 2006-05-23 11:25:15Z cgilles $
 
2
.\" @(#) $Id: exiv2.1 983 2006-11-16 14:42:38Z ahuggel $
3
3
.\" First parameter, NAME, should be all caps
4
4
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
5
5
.\" other parameters are allowed: see man(7), man(1)
6
 
.TH EXIV2 1 "April 23rd, 2006"
 
6
.TH EXIV2 1 "November 16th, 2006"
7
7
.\" Please adjust this date whenever revising the manpage.
8
8
.\"
9
9
.\" Some roff macros, for reference:
17
17
.\" .sp <n>    insert n+1 empty lines
18
18
.\" for manpage-specific macros, see man(7)
19
19
.SH NAME
20
 
exiv2 \- EXIF/IPTC metadata manipulation tool
 
20
exiv2 \- Exif/IPTC metadata manipulation tool
21
21
.SH SYNOPSIS
22
22
.B exiv2
23
23
[\fIoptions\fP] [\fIaction\fP] \fIfile\fP ...
28
28
.\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
29
29
.\" respectively.
30
30
.B exiv2
31
 
is a program to read and write EXIF/IPTC metadata. Supported image
32
 
formats are JPEG, Canon CRW and Canon THM.  Read-only support is
33
 
currently available for TIFF format and includes TIFF-based RAW
34
 
formats such as Nikon NEF, Canon CR2, Sony SR2, Pentax PEF, 
35
 
Adobe DNG and Minolta MRW.
 
31
is a program to read and write Exif and IPTC image metadata and image
 
32
comments. Supported image formats are JPEG, Canon CRW and Canon THM.
 
33
Read-only support is currently available for PNG and TIFF format and
 
34
includes TIFF-based RAW formats such as Nikon NEF, Canon CR2, Sony
 
35
SR2, Sony ARW, Pentax PEF, Adobe DNG and Minolta MRW.
36
36
.SH ACTIONS
37
 
The \fIaction\fP argument is only required if it is not clear which
38
 
action is implied.
 
37
The \fIaction\fP argument is only required if it is not clear from the
 
38
\fIoptions\fP which action is implied.
39
39
.TP
40
40
.B pr | print
41
41
Print image metadata. This is the default action, i.e., the command
42
 
\fIexiv2 image.jpg\fP will print a summary of the image EXIF metadata.
 
42
\fIexiv2 image.jpg\fP will print a summary of the image Exif metadata.
43
43
.TP
44
44
.B ex | extract
45
45
Extract metadata to *.exv and thumbnail image files.
54
54
Delete image metadata from the files.
55
55
.TP
56
56
.B ad | adjust
57
 
Adjust EXIF timestamps by the given time. Requires option \fB\-a\fP
 
57
Adjust Exif timestamps by the given time. Requires option \fB\-a\fP
58
58
\fItime\fP.
59
59
.TP
60
60
.B mo | modify
61
 
Apply commands to modify (add, set, delete) the EXIF/IPTC metadata of image
 
61
Apply commands to modify (add, set, delete) the Exif/IPTC metadata of image
62
62
files. Requires option \fB\-c\fP, \fB\-m\fP or \fB\-M\fP.
63
63
.TP
64
64
.B mv | rename
65
 
Rename files and/or set file timestamps according to the EXIF create
 
65
Rename files and/or set file timestamps according to the Exif create
66
66
timestamp. The filename format can be set with \fB\-r\fP \fIfmt\fP,
67
67
timestamp options are \fB\-t\fP and \fB\-T\fP.
68
68
.TP
93
93
options.
94
94
.TP
95
95
.B \-t
96
 
Set the file timestamp according to the EXIF create timestamp in
 
96
Set the file timestamp according to the Exif create timestamp in
97
97
addition to renaming the file (overrides \fB\-k\fP). This option is
98
98
only used with the 'rename' action.
99
99
.TP
100
100
.B \-T
101
 
Only set the file timestamp according to the EXIF create timestamp, do
 
101
Only set the file timestamp according to the Exif create timestamp, do
102
102
not rename the file (overrides \fB\-k\fP). This option is only used
103
 
with the 'rename' action.
 
103
with the 'rename' action. Note: On Windows you may have to set the TZ
 
104
environment variable for this option to work correctly.
104
105
.TP
105
106
.B \-f
106
107
Do not prompt before overwriting existing files (force overwrite).
117
118
.B \-p \fImode\fP
118
119
Print mode for the 'print' action. Possible modes are:
119
120
.br
120
 
s : print a summary of the EXIF metadata (the default)
121
 
.br
122
 
t : interpreted (translated) EXIF data (shortcut for -Pkyct) 
123
 
.br
124
 
v : plain EXIF data values (shortcut for -Pxgnycv)
125
 
.br
126
 
h : hexdump of the EXIF data (shortcut for -Pxgnycsh)
 
121
s : print a summary of the Exif metadata (the default)
 
122
.br
 
123
t : interpreted (translated) Exif data (shortcut for -Pkyct) 
 
124
.br
 
125
v : plain Exif data values (shortcut for -Pxgnycv)
 
126
.br
 
127
h : hexdump of the Exif data (shortcut for -Pxgnycsh)
127
128
.br
128
129
i : IPTC data values
129
130
.br
160
161
.br
161
162
a : all supported metadata (the default)
162
163
.br
163
 
e : EXIF section
 
164
e : Exif section
164
165
.br
165
 
t : EXIF thumbnail only
 
166
t : Exif thumbnail only
166
167
.br
167
168
i : IPTC data
168
169
.br
169
170
c : JPEG comment
170
171
.TP
171
172
.B \-i \fItgt\fP
172
 
Insert target(s) for the 'insert' action. Possible targets are the same as
173
 
those for the \fB\-d\fP option. Only JPEG thumbnails can be inserted, they
174
 
need to be named \fIfile\fP\-thumb.jpg.
 
173
Insert target(s) for the 'insert' action. Possible targets are the
 
174
same as those for the \fB\-d\fP option. Only JPEG thumbnails can be
 
175
inserted (not TIFF thumbnails), they need to be named
 
176
\fIfile\fP\-thumb.jpg.
175
177
.TP
176
178
.B \-e \fItgt\fP
177
 
Extract target(s) for the 'extract' action. Possible targets the same as
178
 
those for the \fB\-d\fP option.
 
179
Extract target(s) for the 'extract' action. Possible targets are the same 
 
180
as those for the \fB\-d\fP option.
179
181
.TP
180
182
.B \-r \fIfmt\fP
181
183
Filename format for the 'rename' action. The format string follows
182
 
\fBstrftime\fP(3). Default filename format is %Y%m%d_%H%M%S.
 
184
\fBstrftime\fP(3) and supports the following keywords:
 
185
.br
 
186
:basename:   - original filename without extension
 
187
.br
 
188
:dirname:    - name of the directory holding the original file
 
189
.br
 
190
:parentname: - name of parent directory
 
191
.br
 
192
Default filename format is %Y%m%d_%H%M%S.
183
193
.TP
184
194
.B \-c \fItxt\fP
185
 
Jpeg comment string to set in the image ('modify' action).
 
195
JPEG comment string to set in the image ('modify' action).
186
196
.TP
187
197
.B \-m \fIfile\fP
188
198
Command file for the 'modify' action.
211
221
.sp 1
212
222
Note the quotes. Multiple \fB\-m\fP and \fB\-M\fP options can be combined.
213
223
.sp 1
214
 
When writing EXIF/IPTC metadata, 
 
224
When writing Exif/IPTC metadata, 
215
225
.B exiv2 
216
226
enforces only a correct
217
227
metadata structure. It is possible to write tags with types and values
218
 
different from those specified in the standards, duplicate EXIF tags,
 
228
different from those specified in the standards, duplicate Exif tags,
219
229
undefined tags, or incomplete metadata. While 
220
230
.B exiv2 
221
231
is able to read
234
244
.TP
235
245
.B add
236
246
Add a tag (unless \fIkey\fP is a non\-repeatable IPTC key; nothing
237
 
prevents you from adding duplicate EXIF tags).
 
247
prevents you from adding duplicate Exif tags).
238
248
.TP
239
249
.B del
240
 
Delete a tag (requires only a \fIkey\fP).
 
250
Delete all occurrences of a tag (requires only a \fIkey\fP).
241
251
.TP
242
252
.I key
243
 
Exiv2 EXIF or IPTC key.
 
253
Exiv2 Exif or IPTC key.
244
254
.TP
245
255
.I type
246
256
.B Byte | Ascii | Short | Long | Rational | Undefined | SShort | SLong | SRational | Comment
247
 
for EXIF keys, and
 
257
for Exif keys, and
248
258
.br
249
259
.B String | Date | Time | Short | Undefined
250
260
for IPTC keys.
254
264
.TP
255
265
.I value
256
266
The remaining text on the line is the value. It can optionally be
257
 
enclosed in double quotes ("\fIvalue\fP").
 
267
enclosed in single quotes ('\fIvalue\fP') or double quotes ("\fIvalue\fP").
258
268
.sp 1
259
 
The format of EXIF \fBComment\fP values includes an optional charset
 
269
The format of Exif \fBComment\fP values includes an optional charset
260
270
specification at the beginning:
261
271
.sp 1
262
272
.B   [charset=Ascii|Jis|Unicode|Undefined ]\fIcomment\fP
265
275
is used by default if the value doesn't start with a charset
266
276
definition.
267
277
.sp 1
268
 
The format for IPTC \fBDate\fP values is YYYY\-MM\-DD (year, month, day)
 
278
The format for IPTC \fBDate\fP values is YYYY\-MM\-DD (year, month, day),
269
279
that for IPTC \fBTime\fP values is HH:MM:SS+|\-HH:MM, where HH:MM:SS
270
280
refers to local hour, minute and seconds and +|\-HH:MM refers to hours
271
281
and minutes ahead or behind Universal Coordinated Time (+|\- means
276
286
.SH EXAMPLES
277
287
.TP
278
288
exiv2 *.jpg
279
 
Prints a summary of the EXIF information for all JPEG files in the directory.
 
289
Prints a summary of the Exif information for all JPEG files in the directory.
280
290
.TP
281
291
exiv2 -pi image.jpg
282
292
Prints the IPTC metadata of the image.
283
293
.TP
284
 
exiv2 rename image.jpg
285
 
Renames image.jpg (taken on 13\-Nov\-05 at 22:58:31) to 20051113_225831.jpg
 
294
exiv2 rename img_1234.jpg
 
295
Renames img_1234.jpg (taken on 13\-Nov\-05 at 22:58:31) to 20051113_225831.jpg
 
296
.TP
 
297
exiv2 -r':basename:_%Y%m' rename img_1234.jpg
 
298
Renames img_1234.jpg to img_1234_200511.jpg
286
299
.TP
287
300
exiv2 ex img1.jpg img2.jpg
288
301
Extracts metadata from the two files into files img1.exv and img2.exv.
289
302
.TP
290
303
exiv2 \-et img1.jpg img2.jpg
291
 
Extracts the EXIF thumbnails from the two files into img1\-thumb.jpg
 
304
Extracts the Exif thumbnails from the two files into img1\-thumb.jpg
292
305
and img2\-thumb.jpg.
293
306
.TP
294
307
exiv2 \-it img1.jpg img2.jpg
296
309
to img2.jpg.
297
310
.TP
298
311
.nf
299
 
exiv2 \-M"set Exif.Photo.UserComment charset=Ascii New EXIF comment" image.jpg
 
312
exiv2 \-M"set Exif.Photo.UserComment charset=Ascii New Exif comment" image.jpg
300
313
.fi
301
 
Sets the EXIF comment to an ASCII string.
 
314
Sets the Exif comment to an ASCII string.
302
315
.TP
303
316
.nf
304
317
exiv2 \-M"set Exif.GPSInfo.GPSLatitude 4/1 15/1 33/1" \\
305
318
\-M"set Exif.GPSInfo.GPSLatitudeRef N" image.jpg
306
319
.fi
307
320
Sets the latitude to 4 degrees, 15 minutes and 33 seconds north. The
308
 
EXIF standard stipulates that the GPSLatitude tag consists of three
 
321
Exif standard stipulates that the GPSLatitude tag consists of three
309
322
Rational numbers for the degrees, minutes and seconds of the latitude
310
323
and GPSLatitudeRef contains either 'N' or 'S' for north or south
311
324
latitude respectively.
 
325
.TP
 
326
.nf
 
327
exiv2 insert -l/tmp -S.CRW /data/*.JPG
 
328
.fi
 
329
Copy all metadata from CRW files in the /tmp directory to JPG files
 
330
with corresponding basenames in the /data directory. Note that this
 
331
copies metadata as is, without any modifications to adapt it to the
 
332
requirements of the target format. Some tags copied like this may not
 
333
make sense in the target image.
312
334
.SH SEE ALSO
313
335
.TP
314
336
.I http://www.exiv2.org/sample.html#modify
316
338
.TP
317
339
.I http://www.exiv2.org/metadata.html
318
340
Taglists with \fIkey\fP and default \fItype\fP values.
319
 
.SH AUTHOR
 
341
.SH AUTHORS
320
342
.B exiv2 
321
343
was written by Andreas HUGGEL <ahuggel@gmx.net>.
322
344
.PP