← Back to branch summary

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

« back to all changes in this revision

Viewing changes to html/ExifTool.html

  • 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:
html/ExifTool.html
368
368
<tr><td>ByteOrder</td><td>The byte order for newly created EXIF segments when
369
369
    writing.  Note that if EXIF information already exists, the existing order is
370
370
    maintained.  If ByteOrder is not defined, then the order of the maker notes is
371
 
    used (if they are being copied), otherwise big-endian ('MM') order is assumed.</td>
 
371
    used (if they are being copied), otherwise big-endian ('MM') order is assumed.
 
372
    This can also be set via the ExifByteOrder tag, but the ByteOrder option takes
 
373
    precedence if both are set.</td>
372
374
    <td align='center'>'MM','II' or undef</td><td align=center>undef</td></tr>
373
375
<tr><td>Charset</td><td>Character set for converting special characters. Note
374
376
    that this option affects some types of information when reading/writing the
378
380
    <tr><td valign='top' align=center><b>UTF8</b>&nbsp;-</td><td>UTF-8 characters</td></tr>
379
381
    <tr><td valign='top' align=center><b>Latin</b>&nbsp;-</td><td>Windows Latin1 (cp1252)</td></tr>
380
382
    </table></td><td align=center>'UTF8'</td></tr>
381
 
<tr><td>Compact</td><td>Write compact output.  The XMP specification suggests that
382
 
    the data be padded with blanks to allow in-place editing.  By setting this
 
383
<tr><td>Compact</td><td>Flag to write compact output.  The XMP specification suggests
 
384
    that the data be padded with blanks to allow in-place editing.  By setting this
383
385
    flag, 2kB is saved for files with XMP data.</td>
384
386
    <td align='center'>0 or 1</td><td align=center>0</td></tr>
385
387
<tr><td>Composite</td><td>Flag to calculate Composite tags</td><td align='center'>0 or 1</td><td align=center>1</td></tr>
386
 
<tr><td>Compress</td><td>Write new values in compressed format if possible.  Has
387
 
    no effect unless Compress::Zlib is installed.</td>
 
388
<tr><td>Compress</td><td>Flag to write new values in compressed format if possible.
 
389
    Has no effect unless Compress::Zlib is installed.</td>
388
390
    <td align='center'>0 or 1</td><td align=center>0</td></tr>
389
391
<tr><td>CoordFormat</td><td>Format for GPS coordinates</td><td> Format for
390
392
    printing GPS coordinates.  This is a printf format string with specifiers
403
405
<tr><td>FastScan</td>
404
406
    <td>Flag to increase speed of extracting information from JPEG images.  With this
405
407
    option set, ExifTool will not scan to the end of a JPEG image to check for an AFCP,
406
 
    CanonVRD, FotoStation, PhotoMechanic or PreviewImage trailer.</td>
407
 
    <td>1 or 0</td>
408
 
    <td align='center'>0</td></tr>
 
408
    CanonVRD, FotoStation, PhotoMechanic, MIE or PreviewImage trailer.  Also, when
 
409
    combined with the ScanForXMP option, prevents scanning for XMP in recognized file
 
410
    types.</td>
 
411
    <td align='center'>0 or 1</td><td align='center'>0</td></tr>
409
412
<tr><td>FixBase</td>
410
413
    <td>Fix maker notes base offset.  Allows values to be extracted from maker notes
411
414
    which have been corrupted by editing with 3rd party software.</td>
433
436
    <tr><td valign='top' align=right><b><i>non-zero</i></b>&nbsp;=</td><td>Relative offsets</td></tr>
434
437
    <tr><td valign='top' align=right><b>undef</b>&nbsp;=</td><td>EXIF/TIFF offsets</td></tr>
435
438
    </table></td><td align=center>undef</td></tr>
436
 
<tr><td>IgnoreMinorErrors</td><td>Causes some minor errors to be ignored.
 
439
<tr><td>IgnoreMinorErrors</td><td>Flag to ignore minor errors.  Causes minor errors
 
440
    to be downgraded to warnings, and minor warnings to be ignored.  
437
441
    This option is provided mainly to allow writing of files when minor errors
438
442
    occur, but also allows thumbnail and preview images to be extracted even if
439
443
    they don't have a recognizable header.</td>
440
444
    <td align='center'>0 or 1</td><td align='center'>0</td></tr>
441
445
<tr><td>List</td><td>Flag to extract lists of PrintConv values into arrays instead of concatenating
442
446
    them into comma-separated strings.</td><td align='center'>0 or 1</td><td align='center'>0</td></tr>
443
 
<tr><td>MakerNotes</td><td>Flag to cause MakerNotes and other writable subdirectories
444
 
    (such as PrintIM) to be extracted as a data block.  Normally when the MakerNotes
 
447
<tr><td>MakerNotes</td><td>Option to extract MakerNotes and other writable
 
448
    subdirectories (such as PrintIM) as a data block.  Normally when the MakerNotes
445
449
    are extracted they are rebuilt to include data outside the boundaries of the
446
450
    original maker note data block, but a value of 2 disables this feature.</td>
447
451
    <td><table class='clear'>
456
460
    <td align='center'>Any string, or undef</td><td align='center'>undef</td></tr>
457
461
<tr><td>PrintConv</td><td><a name="PrintConv"></a>Flag to enable print conversion.  Also enables inverse print
458
462
    conversion for writing.</td><td align='center'>0 or 1</td><td align=center>1</td></tr>
 
463
<tr><td>ScanForXMP</td><td><a name="ScanForXMP"></a>Flag for scan all files (even unrecognized
 
464
    formats) for XMP information unless XMP was already found in the file.  When combined with
 
465
    the FastScan option, only unrecognized file types are scanned for XMP.  
 
466
    </td><td align='center'>0 or 1</td><td align=center>0</td></tr>
459
467
<tr><td>Sort</td><td>Specifies order to sort tags in the returned tag list</td>
460
468
    <td><table class='clear'>
461
469
    <tr><td valign='top' align=center><b>Input</b></td><td>Sort in same order as input tag arguments</td></tr>
470
478
    <td align='center'>0 or 1</td><td align=center>0</td></tr>
471
479
<tr><td>TextOut</td><td>Output file for Verbose and HtmlDump options.</td>
472
480
    <td align='center'>File reference</td><td align=center>\*STDOUT</td></tr>
473
 
<tr><td>Unknown</td><td>Flag to get values of unknown tags</td>
 
481
<tr><td>Unknown</td><td>Control extraction of unknown tags</td>
474
482
    <td><table class='clear'>
475
483
    <tr><td valign='top' align=center><b>0</b>&nbsp;=</td><td>Unknown tags not extracted</td></tr>
476
484
    <tr><td valign='top' align=center><b>1</b>&nbsp;=</td><td>Unknown tags are extracted from EXIF
799
807
    <td>Bitmask of tag protection levels to write:
800
808
    <table class='clear'>
801
809
    <tr><td valign='top' align=center><b>0x01</b>&nbsp;=</td>
802
 
    <td>Write '<a href="TagNames/index.html">unsafe</a>' tags</td></tr>
 
810
    <td>Write '<a href="TagNames/index.html">unsafe</a>' tags (ie. tags not copied
 
811
        automatically via <a href="#SetNewValuesFromFile">SetNewValuesFromFile</a>)</td></tr>
803
812
    <tr><td valign='top' align=center><b>0x02</b>&nbsp;=</td>
804
 
    <td>Write '<a href="TagNames/index.html">protected</a>' tags</td></tr>
 
813
    <td>Write '<a href="TagNames/index.html">protected</a>' tags (internal use only)</td></tr>
805
814
    </table></td><td align=center>0</td></tr>
806
815
<tr><td>Replace</td><td>Replace previous new value for this tag (ie. replace the value
807
816
    set in a previous call to <a href="#SetNewValue">SetNewValue</a>)</td>
922
931
    'Comment&lt;ISO=$ISO Aperture=$aperture Exposure=$shutterSpeed');
923
932
</pre></td></tr></table></blockquote>
924
933
<p><b>Notes:</b></p>
925
 
<p>The PrintConv option applies to this routine, but it should normally be left
 
934
<p>The PrintConv option applies to this routine, but it normally should be left
926
935
on to provide more reliable transfer of information between groups.</p>
927
936
<p>If a preview image exists, it is not copied.  The preview image must be
928
937
transferred separately if desired.</p>
1279
1288
<blockquote><table class='norm'>
1280
1289
<tr><th>Family</th><th>Group Names</th></tr>
1281
1290
<tr><td><b>0 (Information&nbsp;Type)</b></td>
1282
 
<td>AFCP, AIFF, APE, APP12, APP14, APP15, APP5, APP6, APP8, ASF, BMP,
1283
 
CanonVRD, Composite, DICOM, DNG, EXIF, ExifTool, FLAC, File, Flash,
 
1291
<td>AFCP, AIFF, APE, APP12, APP13, APP14, APP15, APP5, APP6, APP8, ASF, BMP,
 
1292
CanonVRD, Composite, DICOM, DNG, Ducky, EXIF, ExifTool, FLAC, File, Flash,
1284
1293
FlashPix, FotoStation, GeoTiff, HTML, ICC_Profile, ID3, IPTC, JFIF, JPEG,
1285
1294
Jpeg2000, Leaf, MIE, MIFF, MNG, MPC, MPEG, MakerNotes, Meta, PDF, PICT, PNG,
1286
 
PhotoMechanic, Photoshop, PostScript, PrintIM, QuickTime, RIFF, Real,
 
1295
PhotoMechanic, Photoshop, PostScript, PrintIM, QuickTime, RAF, RIFF, Real,
1287
1296
SigmaRaw, Vorbis, XMP
1288
1297
</td></tr>
1289
1298
<tr><td><b>1&nbsp;(Specific&nbsp;Location)</b></td>
1290
 
<td>AFCP, AIFF, APE, ASF, Adobe, BMP, Canon, CanonCustom, CanonRaw,
 
1299
<td>AFCP, AIFF, APE, ASF, Adobe, AdobeCM, BMP, Canon, CanonCustom, CanonRaw,
1291
1300
CanonVRD, Casio, Composite, DICOM, DNG, Ducky, EPPIM, ExifIFD, ExifTool,
1292
1301
FLAC, File, Flash, FlashPix, FotoStation, FujiFilm, GPS, GeoTiff,
1293
1302
GlobParamIFD, GraphConv, HP, HTML, HTML-dc, HTML-ncc, HTML-prod, HTML-vw96,
1300
1309
MIE-Video, MIFF, MNG, MPC, MPEG, MakerNotes, MakerUnknown, MetaIFD, Minolta,
1301
1310
MinoltaRaw, Nikon, NikonCapture, NikonPreview, NikonScan, Olympus, PDF,
1302
1311
PICT, PNG, Panasonic, Pentax, PhotoMechanic, Photoshop, PictureInfo,
1303
 
PostScript, PrintIM, QuickTime, RIFF, RMETA, Real, Real-CONT, Real-MDPR,
1304
 
Real-PROP, Real-RA3, Real-RA4, Real-RA5, Real-RJMD, Ricoh, SPIFF, SR2, SRF#,
1305
 
Sanyo, Sigma, SigmaRaw, Sony, SubIFD, Track#, Vorbis, XMP, XMP-PixelLive,
1306
 
XMP-aux, XMP-cc, XMP-crs, XMP-dc, XMP-dex, XMP-exif, XMP-iptcCore, XMP-lr,
1307
 
XMP-microsoft, XMP-pdf, XMP-photomech, XMP-photoshop, XMP-tiff, XMP-xmp,
1308
 
XMP-xmpBJ, XMP-xmpDM, XMP-xmpMM, XMP-xmpPLUS, XMP-xmpRights, XMP-xmpTPg
 
1312
PostScript, PrintIM, QuickTime, RAF, RAF2, RIFF, RMETA, Real, Real-CONT,
 
1313
Real-MDPR, Real-PROP, Real-RA3, Real-RA4, Real-RA5, Real-RJMD, Ricoh, SPIFF,
 
1314
SR2, SRF#, Sanyo, Sigma, SigmaRaw, Sony, SubIFD, Track#, Vorbis, XMP,
 
1315
XMP-DICOM, XMP-PixelLive, XMP-aux, XMP-cc, XMP-crs, XMP-dc, XMP-dex,
 
1316
XMP-exif, XMP-iptcCore, XMP-lr, XMP-mediapro, XMP-microsoft, XMP-pdf,
 
1317
XMP-photomech, XMP-photoshop, XMP-tiff, XMP-xmp, XMP-xmpBJ, XMP-xmpDM,
 
1318
XMP-xmpMM, XMP-xmpPLUS, XMP-xmpRights, XMP-xmpTPg
1309
1319
</td></tr>
1310
1320
<tr><td><b>2&nbsp;(Category)</b></td>
1311
1321
<td>Audio, Author, Camera, Document, ExifTool, Image, Location, Other, Printing,