view release on metacpan or  search on metacpan

html/ExifTool.html  view on Meta::CPAN

<tr id="ListJoin"><td>ListJoin</td><td>Separator used to join the PrintConv value of
    multi-item List-type tags into a single string.  If not defined, multi-item lists
    are returned as a list reference.  Does not affect ValueConv values.</td>
    <td align=center>Any string, or undef</td><td align=center>', '</td></tr>
<!-- deprecated in ExifTool 10.54; use "ListJoin" instead
<tr id="ListSep"><td>ListSep</td><td>Separator string used to join lists of PrintConv values when
    List option is not set.</td><td align=center>Any string</td><td align=center>', '</td></tr>
-->
<tr id="ListSplit"><td>ListSplit</td><td>Regular expression used to split values of list-type tags
    into individual items when writing. (eg. Use <code>',\\s*'</code> to split a comma-separated
    list.)  Split when writing either PrintConv or ValueConv values.</td>
    <td align=center>A regular expression pattern, or undef</td><td align=center>undef</td></tr>
<tr id="MakerNotes"><td>MakerNotes</td><td>Option to extract MakerNotes and other writable
    subdirectories (such as PrintIM) as a data block.  Normally when the MakerNotes
    are extracted they are rebuilt to include data outside the boundaries of the
    original maker note data block, but a value of 2 disables this feature.</td>
    <td><table class=clear>
    <tr><td valign=top align=center><b>0</b>&nbsp;=</td><td>Don't extract writable subdirectories</td></tr>
    <tr><td valign=top align=center><b>1</b>&nbsp;=</td><td>Extract and rebuild makernotes into self-contained block</td></tr>
    <tr><td valign=top align=center><b>2</b>&nbsp;=</td><td>Extract without rebuilding makernotes</td></tr>
    </table></td><td align=center>undef</td></tr>
<tr id="MDItemTags"><td>MDItemTags</td><td>Flag to extract the OS X
    metadata item tags (see the "mdls" man page and the
    <a href="TagNames/MacOS.html#MDItem">MacOS MDItem Tags documentation</a> for more information).</td>
    <td align=center>0 or 1</td><td align=center>undef</td></tr>
<tr id="MissingTagValue"><td>MissingTagValue</td><td>Value for missing tags
    interpolated in tag name expressions (or tags where the advanced formatting
    expression returns undef). If not set, a minor error is issued for missing
    values, or the value is set to '' if IgnoreMinorErrors is set.</td>
    <td align=center>Any string, or undef</td><td align=center>undef</td></tr>
<tr id="NoDups"><td>NoDups</td><td>Flag to remove duplicate items from queued values for
    List-type tags when writing.  This applies only to queued values, and doesn't resolve
    duplicates with existing values in the file when adding to an existing list.</td>
    <td align=center>0 or 1</td><td align=center>undef</td></tr>
<tr id="NoMandatory"><td>NoMandatory</td><td>Flag to bypass writing of mandatory EXIF tags.</td>
    <td align=center>0 or 1</td><td align=center>undef</td></tr>
<tr id="NoMultiExif"><td>NoMultiExif</td><td>Raise error when attempting to write multi-segment
    EXIF in a JPEG image.</td><td align=center>0 or 1</td><td align=center>undef</td></tr>
<tr id="NoPDFList"><td>NoPDFList</td><td>Flag to avoid splitting PDF list-type tag
    values into separate items.</td>
    <td align=center>0 or 1</td><td align=center>undef</td></tr>
<tr id="NoWarning"><td>NoWarning[+]</td><td>Regular expression to suppress matching
    warning messages.  For example, a value of "^Ignored" suppresses all
    warnings that begin with the word "Ignored".  Has no other effect on
    processing, unlike <a href="#IgnoreMinorErrors">IgnoreMinorErrors</a> for
    some warnings.  Start the expression with "(?i)" for case-insensitive
    matching.  Use NoWarning+ to add to existing expressions.</td>
    <td align=center>A regular expression pattern, or undef</td><td align=center>undef</td></tr>
<tr id="Password"><td>Password</td><td>Password for reading/writing
    password-protected PDF documents. Ignored if a password is not required. Character encoding of
    the password is determined by the value of the Charset option at processing time.</td>
    <td align=center>Any string</td><td align=center>undef</td></tr>
<tr id="Plot"><td>Plot</td><td>Settings for SVG plot feature as a comma-delimited
    string.  Commas in the values must be escaped as "&amp;#44;". Valid settings and their default values are:
    <table class="clear top">
    <tr><td>"Type=Line"</td><td>-</td><td>type of plot (Line, Scatter or Histogram)</td></tr>
    <tr><td>"Style=Line"</td><td>-</td><td>data style (Line, Marker and/or Fill)</td></tr>
    <tr><td>"NBins=20"</td><td>-</td><td>number of histogram bins</td></tr>
    <tr><td>"Size=800 600"</td><td>-</td><td>width,height of output image</td></tr>
    <tr><td>"Margin=60&nbsp;15&nbsp;15&nbsp;30"</td><td>-</td><td>left,top,right,bottom margins around plot area</td></tr>
    <tr><td>"Legend=0 0"</td><td>-</td><td>x,y offset to shift plot legend</td></tr>
    <tr><td>"TxtPad=10 10"</td><td>-</td><td>padding between text and x,y scale</td></tr>
    <tr><td>"LineSpacing=20"</td><td>-</td><td>spacing between text lines</td></tr>
    <tr><td>"Stroke=1"</td><td>-</td><td>plot stroke width and marker-size scaling</td></tr>
    <tr><td>Title, XLabel, YLabel</td><td>-</td><td>plot title and x/y axis labels (no default)</td></tr>
    <tr><td>XMin, XMax</td><td>-</td><td>x axis minimum/maximum (auto scaling if not set)</td></tr>
    <tr><td>YMin, YMax</td><td>-</td><td>y axis minimum/maximum</td></tr>
    <tr><td>"Multi="</td><td>-</td><td>flag to draw multiple plots, one for each dataset</td></tr>
    <tr><td>"Split="</td><td>-</td><td>flag to split strings of numbers into lists
    (&gt;1 to split into lists of N items)</td></tr>
    <tr><td>"Grid=darkgray"</td><td>-</td><td>grid color</td></tr>
    <tr><td>"Text=black"</td><td>-</td><td>text and border color</td></tr>
    <tr><td>"Bkg="</td><td>-</td><td>background color (default transparent)</td></tr>
    <tr><td colspan=3>"Cols=red green blue black orange gray fuchsia brown turquoise gold"
    - colors for plot data</td></tr>
    <tr><td colspan=3>"Marks=circle square triangle diamond star plus pentagon left down right"
    - marker-shape names for each dataset</td></tr>
    </table></td>
    <td>Comma-delimited string of settings to override default values, or
    undef to revert to default settings.  Settings are accumulated if this option
    is set multiple times.<br><br>See <a href="plot.html">The ExifTool Plot Feature</a>
    for more details and examples.</td><td align=center>undef</td></tr>
<tr id="PrintConv"><td>PrintConv</td><td>Flag to enable print conversion.  Also enables inverse print
    conversion for writing.</td><td align=center>0 or 1</td><td align=center>1</td></tr>
<tr id="PrintCSV"><td>PrintCSV</td><td>Flag to directly print CSV-format output rather
    than extracting tags normally.  Currently, this feature this applies only to
    <a href="TagNames/GM.html">GM PDR data</a>.  Setting this option automatically
    sets <a href="#IgnoreTags">IgnoreTags</a> to "all", and
    <a href="#ExtractEmbedded">ExtractEmbedded</a> to 1.</td>
    <td align=center>0 or 1</td><td align=center>undef</td></tr>
<tr id="QuickTimeHandler"><td>QuickTimeHandler</td><td>Flag set to add an 'mdir'
    <a href="TagNames/QuickTime.html#Handler">Handler</a> to a newly created
    Meta box when adding QuickTime ItemList tags.  Adobe Bridge does not add this
    Handler, but it is commonly found in samples from other software, and it has been
    reported that Apple QuickTime Player and Photos.apps will ignore ItemList tags
    if this is missing.</td>
    <td align=center>0 or 1</td>
    <td align=center>1</td></tr>
<tr id="QuickTimePad"><td>QuickTimePad</td><td>Flag to preserve the padding of
    some QuickTime atoms when writing.  QuickTime-based Canon CR3 files pad
    the values of container atoms with null bytes.  This padding is removed by
    default when the file is rewritten, but setting this option to 1 adds
    padding to preserve the original atom size if the new atom would be smaller
    than the original.</td>
    <td align=center>0 or 1</td>
    <td align=center>undef</td></tr>
<tr id="QuickTimeUTC"><td>QuickTimeUTC</td><td>Flag set to assume that integer-valued
    QuickTime date/time values are stored as UTC, causing conversion to local
    time when they are extracted and from local time when written. According to
    the QuickTime specification these date/time values should be UTC, but many
    digital cameras store local time instead (presumably because they don't know
    the time zone), so the default is to not convert these times (except for
    Canon CR3 files, which always use UTC times).  This option also disables the
    auto-detection of incorrect time-zero offsets in these date/time values,
    and enforces a time zero of 1904 as per the QuickTime specification.</td>
    <td align=center>0 or 1</td>
    <td align=center>undef</td></tr>
<tr id="RequestAll"><td>RequestAll</td><td>Flag to request all tags to be extracted.
    This causes some tags to be generated which normally would not be unless specifically
    requested (by passing the tag name to <a href="#ImageInfo">ImageInfo</a> or
    <a href="#ExtractInfo">ExtractInfo</a>).  May be set to 2 or 3 to enable generation