← Back to branch summary

~ubuntu-branches/ubuntu/karmic/libimage-exiftool-perl/karmic

« back to all changes in this revision

Viewing changes to lib/Image/ExifTool.pod

  • Committer: Bazaar Package Importer
  • Author(s): Mari Wang
  • Date: 2008-02-04 20:32:53 UTC
  • mfrom: (1.1.5 upstream)
  • Revision ID: james.westby@ubuntu.com-20080204203253-mpbal8trlfe1fz5d
Tags: 7.00-1
http://bugs.debian.org/456430
http://bugs.debian.org/435589
http://bugs.debian.org/436100
* Upload of new production release (Closes: #456430)
* Added Recommends: libcompress-zlib-perl (Closes: #435589)
* Package now includes iptc2xmp.args and xmp2iptc.args, they are put
  into /usr/share/libimage-exiftool/ (Closes: #436100)
* Updated standards-version (3.7.2 -> 3.7.3). No changes needed.
* Lots of updates and bugfixes compared to last debian version
  (6.90).  See the Changes file for details
* Upload sponsored by Petter Reinholdtsen

Show diffs side-by-side

added added

removed removed

Lines of Context:
lib/Image/ExifTool.pod
65
65
 
66
66
                File Types                 |    Meta Information
67
67
  ---------------------------------------  |  --------------------
68
 
  ACR   r       M4A   r       PS    r/w    |  EXIF           r/w/c
69
 
  AI    r       MEF   r       PSD   r/w    |  GPS            r/w/c
70
 
  AIFF  r       MIE   r/w/c   QTIF  r      |  IPTC           r/w/c
71
 
  APE   r       MIFF  r       RA    r      |  XMP            r/w/c
72
 
  ARW   r       MNG   r/w     RAF   r      |  MakerNotes     r/w/c
73
 
  ASF   r       MOS   r/w     RAM   r      |  Photoshop IRB  r/w/c
74
 
  AVI   r       MOV   r       RAW   r/w    |  ICC Profile    r/w/c
75
 
  BMP   r       MP3   r       RIFF  r      |  MIE            r/w/c
76
 
  CR2   r/w     MP4   r       RM    r      |  JFIF           r/w/c
77
 
  CRW   r/w     MPC   r       SR2   r      |  CIFF           r/w
78
 
  DCM   r       MPG   r       SRF   r      |  AFCP           r/w
79
 
  DNG   r/w     MRW   r/w     SWF   r      |  DICOM          r
80
 
  DOC   r       NEF   r/w     THM   r/w    |  FlashPix       r
81
 
  EPS   r/w     OGG   r       TIFF  r/w    |  GeoTIFF        r
82
 
  ERF   r/w     ORF   r/w     VRD   r/w    |  PrintIM        r
83
 
  FLAC  r       PBM   r/w     WAV   r      |  ID3            r
84
 
  FPX   r       PDF   r       WDP   r/w    |  Kodak Meta     r
85
 
  GIF   r/w     PEF   r/w     WMA   r      |  Ricoh RMETA    r
86
 
  HTML  r       PGM   r/w     WMV   r      |  Picture Info   r
87
 
  ICC   r/w/c   PICT  r       X3F   r      |  Adobe APP14    r
88
 
  JNG   r/w     PNG   r/w     XLS   r      |  APE            r
89
 
  JP2   r       PPM   r/w     XMP   r/w/c  |  Vorbis         r
90
 
  JPEG  r/w     PPT   r                    |  (and more)
 
68
  ACR   r       JP2   r/w     PPT   r      |  EXIF           r/w/c
 
69
  AI    r       JPEG  r/w     PS    r/w    |  GPS            r/w/c
 
70
  AIFF  r       K25   r       PSD   r/w    |  IPTC           r/w/c
 
71
  APE   r       M4A   r       QTIF  r      |  XMP            r/w/c
 
72
  ARW   r       MEF   r/w     RA    r      |  MakerNotes     r/w/c
 
73
  ASF   r       MIE   r/w/c   RAF   r      |  Photoshop IRB  r/w/c
 
74
  AVI   r       MIFF  r       RAM   r      |  ICC Profile    r/w/c
 
75
  BMP   r       MNG   r/w     RAW   r/w    |  MIE            r/w/c
 
76
  BTF   r       MOS   r/w     RIFF  r      |  JFIF           r/w/c
 
77
  CR2   r/w     MOV   r       RM    r      |  Ducky APP12    r/w/c
 
78
  CRW   r/w     MP3   r       SR2   r      |  CIFF           r/w
 
79
  CS1   r/w     MP4   r       SRF   r      |  AFCP           r/w
 
80
  DCM   r       MPC   r       SWF   r      |  DICOM          r
 
81
  DCR   r       MPG   r       THM   r/w    |  Flash          r
 
82
  DNG   r/w     MRW   r/w     TIFF  r/w    |  FlashPix       r
 
83
  DOC   r       NEF   r/w     VRD   r/w/c  |  GeoTIFF        r
 
84
  EPS   r/w     OGG   r       WAV   r      |  PrintIM        r
 
85
  ERF   r/w     ORF   r/w     WDP   r/w    |  ID3            r
 
86
  FLAC  r       PBM   r/w     WMA   r      |  Kodak Meta     r
 
87
  FLV   r       PDF   r       WMV   r      |  Ricoh RMETA    r
 
88
  FPX   r       PEF   r/w     X3F   r      |  Picture Info   r
 
89
  GIF   r/w     PGM   r/w     XLS   r      |  Adobe APP14    r
 
90
  HTML  r       PICT  r       XMP   r/w/c  |  APE            r
 
91
  ICC   r/w/c   PNG   r/w                  |  Vorbis         r
 
92
  JNG   r/w     PPM   r/w                  |  (and more)
91
93
 
92
94
=head1 CONFIGURATION
93
95
 
331
333
EXIF information already exists, the existing order is maintained.  Valid
332
334
values are 'MM', 'II' and undef.  If ByteOrder is not defined (the default),
333
335
then the maker note byte order is used (if they are being copied), otherwise
334
 
big-endian ('MM') order is assumed.
 
336
big-endian ('MM') order is assumed.  This can also be set via the
 
337
ExifByteOrder tag, but the ByteOrder option takes precedence if both are
 
338
set.
335
339
 
336
340
=item Charset
337
341
 
346
350
 
347
351
=item Compact
348
352
 
349
 
Write compact output.  Default is 0.  The XMP specification suggests that
350
 
the data be padded with blanks to allow in-place editing.  By setting this
351
 
flag, 2kB is saved for files with XMP data.
 
353
Flag to write compact output.  Default is 0.  The XMP specification suggests
 
354
that the data be padded with blanks to allow in-place editing.  By setting
 
355
this flag, 2kB is saved for files with XMP data.
352
356
 
353
357
=item Composite
354
358
 
356
360
 
357
361
=item Compress
358
362
 
359
 
Write new values in compressed format if possible.  Has no effect unless
360
 
Compress::Zlib is installed.  Default is 0.
 
363
Flag to write new values in compressed format if possible.  Has no effect
 
364
unless Compress::Zlib is installed.  Default is 0.
361
365
 
362
366
=item CoordFormat
363
367
 
386
390
 
387
391
=item Exclude
388
392
 
389
 
Exclude specified tags from tags extracted from an image. The option value
 
393
Exclude specified tags from tags extracted from an image.  The option value
390
394
is either a tag name or reference to a list of tag names to exclude.  The
391
 
case of tag names is not significant. This option is ignored for
 
395
case of tag names is not significant.  This option is ignored for
392
396
specifically requested tags.  Tags may also be excluded by preceeding their
393
397
name with a '-' in the arguments to L</ImageInfo>.
394
398
 
396
400
 
397
401
Flag to increase speed of extracting information from JPEG images.  With
398
402
this option set, ExifTool will not scan to the end of a JPEG image to check
399
 
for an AFCP, CanonVRD, FotoStation, PhotoMechanic or PreviewImage trailer.
400
 
Default 0.
 
403
for an AFCP, CanonVRD, FotoStation, PhotoMechanic, MIE or PreviewImage
 
404
trailer.  Also, when combined with the ScanForXMP option, prevents scanning
 
405
for XMP in recognized file types.  Default 0.
401
406
 
402
407
=item FixBase
403
408
 
430
435
 
431
436
=item IgnoreMinorErrors
432
437
 
433
 
Causes minor errors to be downgraded to warnings, and minor warnings to be
434
 
ignored.  This option is provided mainly to allow writing of files when
435
 
minor errors occur, but also allows thumbnail and preview images to be
436
 
extracted even if they don't have a recognizable header.  Minor
437
 
errors/warnings are denoted by '[minor]' at the start of the message.
 
438
Flag to ignore minor errors.  Causes minor errors to be downgraded to
 
439
warnings, and minor warnings to be ignored.  This option is provided mainly
 
440
to allow writing of files when minor errors occur, but also allows thumbnail
 
441
and preview images to be extracted even if they don't have a recognizable
 
442
header.  Minor errors/warnings are denoted by '[minor]' at the start of the
 
443
message.
438
444
 
439
445
=item List
440
446
 
443
449
 
444
450
=item MakerNotes
445
451
 
446
 
Flag to cause MakerNotes and other writable subdirectories (such as PrintIM)
447
 
to be extracted as a data block.  Normally when the MakerNotes are extracted
448
 
they are rebuilt to include data outside the boundaries of the original
449
 
maker note data block, but a value of 2 disables this feature.  Possible
450
 
values are:
 
452
Option to extract MakerNotes and other writable subdirectories (such as
 
453
PrintIM) as a data block.  Normally when the MakerNotes are extracted they
 
454
are rebuilt to include data outside the boundaries of the original maker
 
455
note data block, but a value of 2 disables this feature.  Possible values
 
456
are:
451
457
 
452
458
  0 - Do not extract writable subdirectories [default]
453
459
  1 - Extract and rebuild maker notes into self-contained block
464
470
Flag to enable automatic print conversion.  Also enables inverse
465
471
print conversion for writing.  Default is 1.
466
472
 
 
473
=item ScanForXMP
 
474
 
 
475
Flag for scan all files (even unrecognized formats) for XMP information
 
476
unless XMP was already found in the file.  When combined with the FastScan
 
477
option, only unrecognized file types are scanned for XMP.  Default is 0.
 
478
 
467
479
=item Sort
468
480
 
469
481
Specifies order to sort tags in returned list:
892
904
=item Protected
893
905
 
894
906
Bit mask for tag protection levels to write.  Bit 0x01 allows writing of
895
 
'unsafe' tags.  Bit 0x02 allows writing of 'protected' tags, and should only
896
 
be used internally by ExifTool.  See
 
907
'unsafe' tags (ie. tags not copied automatically via
 
908
L</SetNewValuesFromFile>).  Bit 0x02 allows writing of 'protected' tags, and
 
909
should only be used internally by ExifTool.  See
897
910
L<Image::ExifTool::TagNames|Image::ExifTool::TagNames>, for a list of tag
898
911
names indicating 'unsafe' and 'protected' tags.  Default is 0.
899
912
 
991
1004
 
992
1005
=item Notes:
993
1006
 
994
 
The PrintConv option applies to this routine, but it should normally be left
 
1007
The PrintConv option applies to this routine, but it normally should be left
995
1008
on to provide more reliable transfer of information between groups.
996
1009
 
997
1010
If a preview image exists, it is not copied.  The preview image must be
1437
1450
 
1438
1451
=item Family 0 (Information Type):
1439
1452
 
1440
 
AFCP, AIFF, APE, APP12, APP14, APP15, APP5, APP6, APP8, ASF, BMP, CanonVRD,
1441
 
Composite, DICOM, DNG, EXIF, ExifTool, FLAC, File, Flash, FlashPix,
1442
 
FotoStation, GeoTiff, HTML, ICC_Profile, ID3, IPTC, JFIF, JPEG, Jpeg2000,
1443
 
Leaf, MIE, MIFF, MNG, MPC, MPEG, MakerNotes, Meta, PDF, PICT, PNG,
1444
 
PhotoMechanic, Photoshop, PostScript, PrintIM, QuickTime, RIFF, Real,
 
1453
AFCP, AIFF, APE, APP12, APP13, APP14, APP15, APP5, APP6, APP8, ASF, BMP,
 
1454
CanonVRD, Composite, DICOM, DNG, Ducky, EXIF, ExifTool, FLAC, File, Flash,
 
1455
FlashPix, FotoStation, GeoTiff, HTML, ICC_Profile, ID3, IPTC, JFIF, JPEG,
 
1456
Jpeg2000, Leaf, MIE, MIFF, MNG, MPC, MPEG, MakerNotes, Meta, PDF, PICT, PNG,
 
1457
PhotoMechanic, Photoshop, PostScript, PrintIM, QuickTime, RAF, RIFF, Real,
1445
1458
SigmaRaw, Vorbis, XMP
1446
1459
 
1447
1460
=item Family 1 (Specific Location):
1448
1461
 
1449
 
AFCP, AIFF, APE, ASF, Adobe, BMP, Canon, CanonCustom, CanonRaw, CanonVRD,
1450
 
Casio, Composite, DICOM, DNG, Ducky, EPPIM, ExifIFD, ExifTool, FLAC, File,
1451
 
Flash, FlashPix, FotoStation, FujiFilm, GPS, GeoTiff, GlobParamIFD,
1452
 
GraphConv, HP, HTML, HTML-dc, HTML-ncc, HTML-prod, HTML-vw96, HTTP-equiv,
1453
 
ICC-chrm, ICC-clrt, ICC-header, ICC-meas, ICC-view, ICC_Profile, ID3, ID3v1,
1454
 
ID3v2_2, ID3v2_3, ID3v2_4, IFD0, IFD1, IPTC, InteropIFD, JFIF, JPEG, JVC,
1455
 
Jpeg2000, Kodak, KodakBordersIFD, KodakEffectsIFD, KyoceraRaw, Leaf,
1456
 
LeafSubIFD, MAC, MIE-Audio, MIE-Camera, MIE-Doc, MIE-Extender, MIE-Flash,
1457
 
MIE-GPS, MIE-Geo, MIE-Image, MIE-Lens, MIE-Main, MIE-MakerNotes, MIE-Meta,
1458
 
MIE-Orient, MIE-Preview, MIE-Thumbnail, MIE-UTM, MIE-Unknown, MIE-Video,
1459
 
MIFF, MNG, MPC, MPEG, MakerNotes, MakerUnknown, MetaIFD, Minolta,
 
1462
AFCP, AIFF, APE, ASF, Adobe, AdobeCM, BMP, Canon, CanonCustom, CanonRaw,
 
1463
CanonVRD, Casio, Composite, DICOM, DNG, Ducky, EPPIM, ExifIFD, ExifTool,
 
1464
FLAC, File, Flash, FlashPix, FotoStation, FujiFilm, GPS, GeoTiff,
 
1465
GlobParamIFD, GraphConv, HP, HTML, HTML-dc, HTML-ncc, HTML-prod, HTML-vw96,
 
1466
HTTP-equiv, ICC-chrm, ICC-clrt, ICC-header, ICC-meas, ICC-view, ICC_Profile,
 
1467
ID3, ID3v1, ID3v2_2, ID3v2_3, ID3v2_4, IFD0, IFD1, IPTC, InteropIFD, JFIF,
 
1468
JPEG, JVC, Jpeg2000, Kodak, KodakBordersIFD, KodakEffectsIFD, KyoceraRaw,
 
1469
Leaf, LeafSubIFD, MAC, MIE-Audio, MIE-Camera, MIE-Doc, MIE-Extender,
 
1470
MIE-Flash, MIE-GPS, MIE-Geo, MIE-Image, MIE-Lens, MIE-Main, MIE-MakerNotes,
 
1471
MIE-Meta, MIE-Orient, MIE-Preview, MIE-Thumbnail, MIE-UTM, MIE-Unknown,
 
1472
MIE-Video, MIFF, MNG, MPC, MPEG, MakerNotes, MakerUnknown, MetaIFD, Minolta,
1460
1473
MinoltaRaw, Nikon, NikonCapture, NikonPreview, NikonScan, Olympus, PDF,
1461
1474
PICT, PNG, Panasonic, Pentax, PhotoMechanic, Photoshop, PictureInfo,
1462
 
PostScript, PrintIM, QuickTime, RIFF, RMETA, Real, Real-CONT, Real-MDPR,
1463
 
Real-PROP, Real-RA3, Real-RA4, Real-RA5, Real-RJMD, Ricoh, SPIFF, SR2, SRF#,
1464
 
Sanyo, Sigma, SigmaRaw, Sony, SubIFD, Track#, Vorbis, XMP, XMP-PixelLive,
1465
 
XMP-aux, XMP-cc, XMP-crs, XMP-dc, XMP-dex, XMP-exif, XMP-iptcCore, XMP-lr,
1466
 
XMP-microsoft, XMP-pdf, XMP-photomech, XMP-photoshop, XMP-tiff, XMP-xmp,
1467
 
XMP-xmpBJ, XMP-xmpDM, XMP-xmpMM, XMP-xmpPLUS, XMP-xmpRights, XMP-xmpTPg
 
1475
PostScript, PrintIM, QuickTime, RAF, RAF2, RIFF, RMETA, Real, Real-CONT,
 
1476
Real-MDPR, Real-PROP, Real-RA3, Real-RA4, Real-RA5, Real-RJMD, Ricoh, SPIFF,
 
1477
SR2, SRF#, Sanyo, Sigma, SigmaRaw, Sony, SubIFD, Track#, Vorbis, XMP,
 
1478
XMP-DICOM, XMP-PixelLive, XMP-aux, XMP-cc, XMP-crs, XMP-dc, XMP-dex,
 
1479
XMP-exif, XMP-iptcCore, XMP-lr, XMP-mediapro, XMP-microsoft, XMP-pdf,
 
1480
XMP-photomech, XMP-photoshop, XMP-tiff, XMP-xmp, XMP-xmpBJ, XMP-xmpDM,
 
1481
XMP-xmpMM, XMP-xmpPLUS, XMP-xmpRights, XMP-xmpTPg
1468
1482
 
1469
1483
=item Family 2 (Category):
1470
1484