| 291 |
291 |
.TP
|
| 292 |
292 |
.B \-p \fImode\fP
|
| 293 |
293 |
Print mode for the 'print' action. Possible modes are:
|
| 294 |
|
.br
|
| 295 |
|
s : print a summary of the Exif metadata (the default)
|
| 296 |
|
.br
|
| 297 |
|
a : print Exif, IPTC and XMP metadata (shortcut for \-Pkyct)
|
| 298 |
|
.br
|
| 299 |
|
t : interpreted (translated) Exif tags (\-PEkyct)
|
| 300 |
|
.br
|
| 301 |
|
v : plain Exif tag values (\-PExgnycv)
|
| 302 |
|
.br
|
| 303 |
|
h : hexdump of the Exif data (\-PExgnycsh)
|
| 304 |
|
.br
|
| 305 |
|
i : IPTC datasets (\-PIkyct)
|
| 306 |
|
.br
|
| 307 |
|
x : XMP properties (\-PXkyct)
|
| 308 |
|
.br
|
| 309 |
|
c : JPEG comment
|
| 310 |
|
.br
|
| 311 |
|
p : list available image previews, sorted by preview image size in pixels
|
| 312 |
|
.br
|
| 313 |
|
S : print image structure information (jpg, png and tiff only)
|
| 314 |
|
.br
|
| 315 |
|
X : print "raw" XMP (jpg, png and tiff only)
|
|
294 |
.TS
|
|
295 |
l l.
|
|
296 |
s print a summary of the Exif metadata (the default)
|
|
297 |
a print Exif, IPTC and XMP metadata (shortcut for \-Pkyct)
|
|
298 |
t interpreted (translated) Exif tags (\-PEkyct)
|
|
299 |
v plain Exif tag values (\-PExgnycv)
|
|
300 |
h hexdump of the Exif data (\-PExgnycsh)
|
|
301 |
i IPTC datasets (\-PIkyct)
|
|
302 |
x XMP properties (\-PXkyct)
|
|
303 |
c JPEG comment
|
|
304 |
p list available image previews, sorted by preview image size in pixels
|
|
305 |
S print image structure information (jpg, png and tiff only)
|
|
306 |
X print "raw" XMP (jpg, png and tiff only)
|
|
307 |
.TE
|
| 316 |
308 |
.TP
|
| 317 |
309 |
.B \-P \fIflgs\fP
|
| 318 |
310 |
Print flags for fine control of the tag list ('print' action). Allows
|
| 319 |
311 |
control of the type of metadata as well as data columns included in
|
| 320 |
312 |
the print output. Valid flags are:
|
| 321 |
|
.br
|
| 322 |
|
E : include Exif tags in the list
|
| 323 |
|
.br
|
| 324 |
|
I : IPTC datasets
|
| 325 |
|
.br
|
| 326 |
|
X : XMP properties
|
| 327 |
|
.br
|
| 328 |
|
x : print a column with the tag number
|
| 329 |
|
.br
|
| 330 |
|
g : group name
|
| 331 |
|
.br
|
| 332 |
|
k : key
|
| 333 |
|
.br
|
| 334 |
|
l : tag label
|
| 335 |
|
.br
|
| 336 |
|
n : tag name
|
| 337 |
|
.br
|
| 338 |
|
y : type
|
| 339 |
|
.br
|
| 340 |
|
c : number of components (count)
|
| 341 |
|
.br
|
| 342 |
|
s : size in bytes
|
| 343 |
|
.br
|
| 344 |
|
v : plain data value
|
| 345 |
|
.br
|
| 346 |
|
t : interpreted (translated) data
|
| 347 |
|
.br
|
| 348 |
|
h : hexdump of the data
|
|
313 |
.TS
|
|
314 |
l l.
|
|
315 |
E include Exif tags in the list
|
|
316 |
I IPTC datasets
|
|
317 |
X XMP properties
|
|
318 |
x print a column with the tag number
|
|
319 |
g group name
|
|
320 |
k key
|
|
321 |
l tag label
|
|
322 |
n tag name
|
|
323 |
y type
|
|
324 |
c number of components (count)
|
|
325 |
s size in bytes
|
|
326 |
v plain data value
|
|
327 |
t interpreted (translated) data
|
|
328 |
h hexdump of the data
|
|
329 |
.TE
|
| 349 |
330 |
.TP
|
| 350 |
331 |
.B \-d \fItgt\fP
|
| 351 |
332 |
Delete target(s) for the 'delete' action. Possible targets are:
|
| 352 |
|
.br
|
| 353 |
|
a : all supported metadata (the default)
|
| 354 |
|
.br
|
| 355 |
|
e : Exif section
|
| 356 |
|
.br
|
| 357 |
|
t : Exif thumbnail only
|
| 358 |
|
.br
|
| 359 |
|
i : IPTC data
|
| 360 |
|
.br
|
| 361 |
|
x : XMP packet
|
| 362 |
|
.br
|
| 363 |
|
c : JPEG comment
|
|
333 |
.TS
|
|
334 |
l l.
|
|
335 |
a all supported metadata (the default)
|
|
336 |
e Exif section
|
|
337 |
t Exif thumbnail only
|
|
338 |
i IPTC data
|
|
339 |
x XMP packet
|
|
340 |
c JPEG comment
|
|
341 |
.TE
|
| 364 |
342 |
.TP
|
| 365 |
343 |
.B \-i \fItgt\fP
|
| 366 |
344 |
Insert target(s) for the 'insert' action. Possible targets are the
|
| ... | ... | |
| 399 |
377 |
.B \-r \fIfmt\fP
|
| 400 |
378 |
Filename format for the 'rename' action. The format string follows
|
| 401 |
379 |
\fBstrftime\fP(3) and supports the following keywords:
|
| 402 |
|
.br
|
| 403 |
|
:basename: - original filename without extension
|
| 404 |
|
.br
|
| 405 |
|
:dirname: - name of the directory holding the original file
|
| 406 |
|
.br
|
| 407 |
|
:parentname: - name of parent directory
|
| 408 |
|
.br
|
|
380 |
.TS
|
|
381 |
l l.
|
|
382 |
:basename: original filename without extension
|
|
383 |
:dirname: name of the directory holding the original file
|
|
384 |
:parentname: name of parent directory
|
|
385 |
.TE
|
| 409 |
386 |
Default filename format is %Y%m%d_%H%M%S.
|
| 410 |
387 |
.TP
|
| 411 |
388 |
.B \-c \fItxt\fP
|
| ... | ... | |
| 510 |
487 |
definition.
|
| 511 |
488 |
.sp 1
|
| 512 |
489 |
The format for an IPTC \fBDate\fP value is:
|
| 513 |
|
.br
|
|
490 |
.RS
|
| 514 |
491 |
YYYY\-MM\-DD (year, month, day)
|
| 515 |
|
.sp 1
|
|
492 |
.RE
|
| 516 |
493 |
The format for an IPTC \fBTime\fP value is:
|
| 517 |
|
.br
|
|
494 |
.RS
|
| 518 |
495 |
HH:MM:SS (hours, minutes, seconds)
|
| 519 |
|
.br
|
|
496 |
.RE
|
| 520 |
497 |
and may optionally be followed by:
|
| 521 |
|
.br
|
|
498 |
.RS
|
| 522 |
499 |
\-HH:MM or +HH:MM (hours, minutes ahead/behind UTC)
|
| 523 |
|
.sp 1
|
|
500 |
.RE
|
| 524 |
501 |
The format of \fBRational\fP (and \fBSRational\fP) is one of:
|
| 525 |
|
.br
|
| 526 |
|
integer
|
| 527 |
|
.br
|
| 528 |
|
integer-numerator/integer-denominator
|
| 529 |
|
.br
|
| 530 |
|
Fnumber
|
| 531 |
|
.br
|
| 532 |
|
fnumber
|
| 533 |
|
.sp 1
|
|
502 |
.RS
|
|
503 |
.IP
|
|
504 |
integer
|
|
505 |
.IP
|
|
506 |
integer-numerator/integer-denominator
|
|
507 |
.IP
|
|
508 |
Fnumber
|
|
509 |
.IP
|
|
510 |
fnumber
|
|
511 |
.RE
|
| 534 |
512 |
Rational Examples:
|
| 535 |
|
.br
|
| 536 |
|
exiv2 "-Mset Exif.Photo.MaxApertureValue 557429/62500" X.jpg
|
| 537 |
|
.br
|
| 538 |
|
exiv2 "-Mset Exif.Photo.MaxApertureValue F5.6" X.jpg
|
|
513 |
.RS
|
|
514 |
.nf
|
|
515 |
exiv2 "-Mset Exif.Photo.MaxApertureValue 557429/62500" X.jpg
|
|
516 |
exiv2 "-Mset Exif.Photo.MaxApertureValue F5.6" X.jpg
|
|
517 |
.fi
|
|
518 |
.RE
|
| 539 |
519 |
.sp 1
|
| 540 |
520 |
The Rational format Fnumber (or fnumber) is for the convenience of setting aperture values. Aperture values
|
| 541 |
521 |
are stored in Exif is an \fBAPEX\fP value which can be evaluated by the expression:
|
| 542 |
522 |
.sp 1
|
| 543 |
|
apex-value = log(Fnumber) * 2.0 / log(2.0)
|
| 544 |
|
.br
|
| 545 |
|
Fnumber = exp(apex-value * log(2.0) / 2.0)
|
|
523 |
.RS
|
|
524 |
.nf
|
|
525 |
apex-value = log(Fnumber) * 2.0 / log(2.0)
|
|
526 |
Fnumber = exp(apex-value * log(2.0) / 2.0)
|
|
527 |
.fi
|
|
528 |
.RE
|
| 546 |
529 |
.sp 1
|
| 547 |
530 |
The Rational format Fnumber is valid for any \fBRational\fP, even when the key is not an Aperture.
|
| 548 |
531 |
More information about \fBAPEX\fP value is available from: http://en.wikipedia.org/wiki/APEX_system
|
| 549 |
532 |
.sp 1
|
| 550 |
533 |
The format of XMP \fBLangAlt\fP values includes an optional language qualifier:
|
| 551 |
|
.br
|
| 552 |
|
.B lang="\fIlanguage-code\fP\fI" text\fP
|
|
534 |
.RS
|
|
535 |
.nf
|
|
536 |
.B lang="\fIlanguage-code\fP\fI" text\fP
|
|
537 |
.fi
|
|
538 |
.RE
|
| 553 |
539 |
.sp
|
| 554 |
540 |
lang="x-default" is used if the value doesn't start with a language qualifier.
|
| 555 |
541 |
.sp 1
|
|
542 |
.RS
|
|
543 |
.nf
|
| 556 |
544 |
exiv2 -M'set Xmp.dc.title lang="de-DE" Euros' X.jpg
|
| 557 |
|
.br
|
| 558 |
545 |
exiv2 -M'set Xmp.dc.title lang="en-GB" Pounds' X.jpg
|
| 559 |
|
.br
|
| 560 |
546 |
exiv2 -M'set Xmp.dc.title lang="en-US" In God We Trust' X.jpg
|
| 561 |
|
.br
|
| 562 |
547 |
exiv2 -M'set Xmp.dc.title All others pay cash' X.jpg
|
|
548 |
.fi
|
|
549 |
.RE
|
| 563 |
550 |
.sp 1
|
| 564 |
551 |
To remove a language specification, set the value to '' (empty string)
|
| 565 |
|
.br
|
| 566 |
|
exiv2 -M'set Xmp.dc.title lang="en-US"' X.jpg
|
| 567 |
|
.sp 1
|
|
552 |
.RS
|
|
553 |
.nf
|
|
554 |
exiv2 -M'set Xmp.dc.title lang="en-US"' X.jpg
|
|
555 |
.fi
|
|
556 |
.RE
|
| 568 |
557 |
To remove all language specifications, delete the key:
|
| 569 |
|
.br
|
| 570 |
|
exiv2 -M'del Xmp.dc.title' X.jpg
|
| 571 |
|
.TP
|
|
558 |
.RS
|
|
559 |
.nf
|
|
560 |
exiv2 -M'del Xmp.dc.title' X.jpg
|
|
561 |
.fi
|
|
562 |
.RE
|
| 572 |
563 |
To register additional XMP namespaces, combine the command with:
|
| 573 |
|
.TP
|
|
564 |
.RS
|
| 574 |
565 |
.nf
|
| 575 |
566 |
\fBreg\fP \fIprefix\fP \fInamespace\fP
|
| 576 |
567 |
.fi
|
|
568 |
.RE
|
| 577 |
569 |
.SS Command file format
|
| 578 |
570 |
Empty lines and lines starting with \fB#\fP in a command file are
|
| 579 |
571 |
ignored (comments). Remaining lines are commands as described above.
|
| ... | ... | |
| 614 |
606 |
format. The inserted XMP properties include those in the "IPTC Core"
|
| 615 |
607 |
XMP schema.
|
| 616 |
608 |
.TP
|
| 617 |
|
.nf
|
| 618 |
609 |
exiv2 \-M"set Exif.Photo.UserComment charset=Ascii New Exif comment" image.jpg
|
| 619 |
|
.fi
|
| 620 |
610 |
Sets the Exif comment to an ASCII string.
|
| 621 |
611 |
.TP
|
| 622 |
|
.nf
|
| 623 |
|
exiv2 \-M"set Exif.GPSInfo.GPSLatitude 4/1 15/1 33/1" \\
|
| 624 |
|
\-M"set Exif.GPSInfo.GPSLatitudeRef N" image.jpg
|
| 625 |
|
.fi
|
|
612 |
exiv2 \-M"set Exif.GPSInfo.GPSLatitude 4/1 15/1 33/1" \\ \-M"set Exif.GPSInfo.GPSLatitudeRef N" image.jpg
|
| 626 |
613 |
Sets the latitude to 4 degrees, 15 minutes and 33 seconds north. The
|
| 627 |
614 |
Exif standard stipulates that the GPSLatitude tag consists of three
|
| 628 |
615 |
Rational numbers for the degrees, minutes and seconds of the latitude
|
| 629 |
616 |
and GPSLatitudeRef contains either 'N' or 'S' for north or south
|
| 630 |
617 |
latitude respectively.
|
| 631 |
618 |
.TP
|
| 632 |
|
.nf
|
| 633 |
619 |
exiv2 insert \-l/tmp -S.CRW /data/*.JPG
|
| 634 |
|
.fi
|
| 635 |
620 |
Copy all metadata from CRW files in the /tmp directory to JPG files
|
| 636 |
621 |
with corresponding basenames in the /data directory. Note that this
|
| 637 |
622 |
copies metadata as is, without any modifications to adapt it to the
|