RubyGems - mini_exiftool_vendored - Versions diffs - 8.9.7.v2 → 9.2.7.v1 - Mend

mini_exiftool_vendored 8.9.7.v2 → 9.2.7.v1

Files changed (1023) hide show

data/vendor/Image-ExifTool-9.27/html/config.html ADDED

@@ -0,0 +1,312 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+        "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
+<html>
+<head><title>~/.ExifTool_config</title>
+<link rel=stylesheet type='text/css' href='style.css' title='Style'>
+</head>
+<body>
+<pre>
+<span class='com'>#------------------------------------------------------------------------------
+# File:         ExifTool_config  --&gt;  ~/.ExifTool_config
+#
+# Description:  Sample user configuration file for Image::ExifTool
+#
+# Notes:        This example file shows how to define your own shortcuts and
+#               add new EXIF, IPTC, XMP, PNG, MIE and Composite tags, as well
+#               as how to specify preferred lenses for the LensID tag and
+#               define default values for ExifTool options.
+#
+#               Note that unknown tags may be extracted even if they aren't
+#               defined, but tags must be defined to be written.  Also note
+#               that it is possible to override an existing tag definition
+#               with a user-defined tag.
+#
+#               To activate this file, rename it to ".ExifTool_config" and
+#               place it in your home directory or the exiftool application
+#               directory.  (On Windows and Mac systems this must be done via
+#               the command line since the GUI's don't allow filenames to begin
+#               with a dot.  Use the "rename" command in Windows or "mv" on the
+#               Mac.)  This causes ExifTool to automatically load the file when
+#               run.  Your home directory is determined by the first defined of
+#               the following environment variables:
+#
+#                   1. EXIFTOOL_HOME
+#                   2. HOME
+#                   3. HOMEDRIVE + HOMEPATH
+#                   4. (the current directory)
+#
+#               Alternatively, the -config option of the exiftool application
+#               may be used to load a specific configuration file (note that
+#               it must be the first option on the command line):
+#
+#                   exiftool -config ExifTool_config ...
+#
+#               This sample file defines the following 16 new tags as well as a
+#               number of Shortcut and Composite tags:
+#
+#                   1.  EXIF:NewEXIFTag
+#                   2.  GPS:GPSPitch
+#                   3.  GPS:GPSRoll
+#                   4.  IPTC:NewIPTCTag
+#                   5.  XMP-xmp:NewXMPxmpTag
+#                   6.  XMP-exif:GPSPitch
+#                   7.  XMP-exif:GPSRoll
+#                   8.  XMP-xxx:NewXMPxxxTag1
+#                   9.  XMP-xxx:NewXMPxxxTag2
+#                  10.  XMP-xxx:NewXMPxxxTag3
+#                  11.  XMP-xxx:NewXMPxxxStruct
+#                  12.  PNG:NewPngTag1
+#                  13.  PNG:NewPngTag2
+#                  14.  PNG:NewPngTag3
+#                  15.  MIE-Meta:NewMieTag1
+#                  16.  MIE-Test:NewMieTag2
+#
+#               For detailed information on the definition of tag tables and
+#               tag information hashes, see lib/Image/ExifTool/README.
+#------------------------------------------------------------------------------
+# Shortcut tags are used when extracting information to simplify
+# commonly used commands.  They can be used to represent groups
+# of tags, or to provide an alias for a tag name.</span>
+%Image::ExifTool::UserDefined::Shortcuts = (
+    MyShortcut =&gt; ['exif:createdate','exposuretime','aperture'],
+    MyAlias =&gt; 'FocalLengthIn35mmFormat',
+);
+<span class='com'># NOTE: All tag names used in the following tables are case sensitive.
+# The %Image::ExifTool::UserDefined hash defines new tags to be added
+# to existing tables.</span>
+%Image::ExifTool::UserDefined = (
+    <span class='com'># All EXIF tags are added to the Main table, and WriteGroup is used to
+    # specify where the tag is written (default is ExifIFD if not specified):</span>
+    'Image::ExifTool::Exif::Main' =&gt; {
+        0xd000 =&gt; {
+            Name =&gt; 'NewEXIFTag',
+            Writable =&gt; 'int16u',
+            WriteGroup =&gt; 'IFD0',
+        },
+        <span class='com'># add more user-defined EXIF tags here...</span>
+    },
+    <span class='com'># the <a href="geotag.html">Geotag feature</a> writes these additional GPS tags if available:</span>
+    'Image::ExifTool::GPS::Main' =&gt; {
+        0xd000 =&gt; {
+            Name =&gt; 'GPSPitch',
+            Writable =&gt; 'rational64s',
+        },
+        0xd001 =&gt; {
+            Name =&gt; 'GPSRoll',
+            Writable =&gt; 'rational64s',
+        },
+    },
+    <span class='com'># IPTC tags are added to a specific record type (ie. application record):
+    # (Note: IPTC tag ID's are limited to the range 0-255)</span>
+    'Image::ExifTool::IPTC::ApplicationRecord' =&gt; {
+        240 =&gt; {
+            Name =&gt; 'NewIPTCTag',
+            Format =&gt; 'string[0,16]',
+        },
+        <span class='com'># add more user-defined IPTC ApplicationRecord tags here...</span>
+    },
+    <span class='com'># XMP tags may be added to existing namespaces:</span>
+    'Image::ExifTool::XMP::xmp' =&gt; {
+        NewXMPxmpTag =&gt; { Groups =&gt; { 2 =&gt; 'Author' } },
+        <span class='com'># add more user-defined XMP-xmp tags here...</span>
+    },
+    <span class='com'># special Geotag tags for XMP-exif:</span>
+    'Image::ExifTool::XMP::exif' =&gt; {
+        GPSPitch =&gt; { Writable =&gt; 'rational', Groups =&gt; { 2 =&gt; 'Location' } },
+        GPSRoll  =&gt; { Writable =&gt; 'rational', Groups =&gt; { 2 =&gt; 'Location' } },
+    },
+    <span class='com'># new XMP namespaces (ie. xxx) must be added to the Main XMP table:</span>
+    'Image::ExifTool::XMP::Main' =&gt; {
+        xxx =&gt; { <span class='com'># &lt;-- must be the same as the NAMESPACE prefix</span>
+            SubDirectory =&gt; {
+                TagTable =&gt; 'Image::ExifTool::UserDefined::xxx',
+                <span class='com'># (see the definition of this table below)</span>
+            },
+        },
+        <span class='com'># add more user-defined XMP namespaces here...</span>
+    },
+    <span class='com'># new PNG tags are added to the PNG::TextualData table:</span>
+    'Image::ExifTool::PNG::TextualData' =&gt; {
+        NewPngTag1 =&gt; { },
+        NewPngTag2 =&gt; { },
+        NewPngTag3 =&gt; { },
+    },
+    <span class='com'># add a new MIE tag (MieTag1) and group (MIE-Test) to MIE-Meta
+    # (Note: MIE group names must NOT end with a number)</span>
+    'Image::ExifTool::MIE::Meta' =&gt; {
+        NewMieTag1 =&gt; {
+            Writable =&gt; 'rational64u',
+            Units =&gt; [ 'cm', 'in' ],
+        },
+        Test =&gt; {
+            SubDirectory =&gt; {
+                TagTable =&gt; 'Image::ExifTool::UserDefined::MIETest',
+                DirName =&gt; 'MIE-Test',
+            },
+        },
+    },
+    <span class='com'># Composite tags are added to the Composite table:</span>
+    'Image::ExifTool::Composite' =&gt; {
+        <span class='com'># Composite tags are unique:  The Require/Desire elements specify
+        # tags that must/may exist, and the keys of these hashes are used as
+        # indices in the @val array of the ValueConv expression to access
+        # the numerical (-n) values of these tags.  All Require'd tags must
+        # exist for the Composite tag to be evaluated.  If no Require'd tags
+        # are specified, then at least one of the Desire'd tags must exist.
+        # See the Composite table in Image::ExifTool::Exif for more
+        # examples, and lib/Image/ExifTool/README for all of the details.</span>
+        BaseName =&gt; {
+            Require =&gt; {
+                0 =&gt; 'FileName',
+            },
+            <span class='com'># remove the extension from FileName</span>
+            ValueConv =&gt; 'my $name=$val[0]; $name=~s/\..*?$//; $name',
+        },
+        <span class='com'># the next few examples demonstrate simplifications which may be
+        # used if only one tag is Require'd or Desire'd:
+        # 1) the Require lookup may be replaced with a simple tag name
+        # 2) "$val" may be used to represent "$val[0]" in the expression</span>
+        FileExtension =&gt; {
+            Require =&gt; 'FileName',
+            ValueConv =&gt; '$val=~/\.([^.]*)$/; $1',
+        },
+        <span class='com'># override CircleOfConfusion tag to use D/1750 instead of D/1440</span>
+        CircleOfConfusion =&gt; {
+            Require =&gt; 'ScaleFactor35efl',
+            Groups =&gt; { 2 =&gt; 'Camera' },
+            ValueConv =&gt; 'sqrt(24*24+36*36) / ($val * 1750)',
+            <span class='com'># an optional PrintConv may be used to format the value</span>
+            PrintConv =&gt; 'sprintf("%.3f mm",$val)',
+        },
+        <span class='com'># generate a description for this file type</span>
+        FileTypeDescription =&gt; {
+            Require =&gt; 'FileType',
+            ValueConv =&gt; 'GetFileType($val,1) || $val',
+        },
+        <span class='com'># calculate physical image size based on resolution</span>
+        PhysicalImageSize => {
+            Require => {
+                0 => 'ImageWidth',
+                1 => 'ImageHeight',
+                2 => 'XResolution',
+                3 => 'YResolution',
+                4 => 'ResolutionUnit',
+            },
+            ValueConv => '$val[0]/$val[2] . " " . $val[1]/$val[3]',
+            <span class='com'># (the @prt array contains print-formatted values)</span>
+            PrintConv => 'sprintf("%.1fx%.1f $prt[4]", split(" ",$val))',
+        },
+        <span class='com'># [advanced] select largest JPEG preview image</span>
+        BigImage => {
+            Desire => {
+                0 => 'JpgFromRaw',
+                1 => 'PreviewImage',
+                2 => 'OtherImage',
+                <span class='com'># (DNG and A100 ARW may be have 2 PreviewImage's)</span>
+                3 => 'PreviewImage (1)',
+            },
+            <span class='com'># ValueConv may also be a code reference
+            # Inputs: 0) reference to list of values, 1) ExifTool object</span>
+            ValueConv => sub {
+                my $val = shift;
+                my ($image, $bigImage, $len, $bigLen);
+                foreach $image (@$val) {
+                    next unless ref $image eq 'SCALAR';
+                    <span class='com'># check for JPEG image (or "Binary data" if -b not used)</span>
+                    next unless $$image =~ /^(\xff\xd8\xff|Binary data (\d+))/;
+                    $len = $2 || length $$image; <span class='com'># get image length</span>
+                    <span class='com'># save largest image</span>
+                    next if defined $bigLen and $bigLen >= $len;
+                    $bigLen = $len;
+                    $bigImage = $image;
+                }
+                return $bigImage;
+            },
+        },
+    },
+);
+<a name='xmp-xxx'><span class='com'># This is a basic example of the definition for a new XMP namespace.
+# This table is referenced through a SubDirectory tag definition
+# in the %Image::ExifTool::UserDefined definition above.
+# The namespace prefix for these tags is 'xxx', which corresponds to
+# an ExifTool family 1 group name of 'XMP-xxx'.</span></a>
+%Image::ExifTool::UserDefined::xxx = (
+    GROUPS =&gt; { 0 =&gt; 'XMP', 1 =&gt; 'XMP-xxx', 2 =&gt; 'Image' },
+    NAMESPACE =&gt; { 'xxx' =&gt; 'http://ns.myname.com/xxx/1.0/' },
+    WRITABLE =&gt; 'string',
+    <span class='com'># replace "NewXMPxxxTag1" with your own tag name (ie. "MyTag")</span>
+    NewXMPxxxTag1 =&gt; { Writable => 'lang-alt' },
+    NewXMPxxxTag2 =&gt; { Groups =&gt; { 2 =&gt; 'Author' } },
+    NewXMPxxxTag3 =&gt; { List =&gt; 'Bag' },
+    <span class='com'># example structured XMP tag</span>
+    NewXMPxxxStruct => {
+        <span class='com'># the "Struct" entry defines the structure fields</span>
+        Struct =&gt; {
+            <span class='com'># optional namespace prefix and URI for structure fields
+            # (required only if different than NAMESPACE above)</span>
+            NAMESPACE =&gt; { 'test' =&gt; 'http://x.y.z/test/' },
+            <span class='com'># optional structure name (used for warning messages only)</span>
+            STRUCT_NAME =&gt; 'MyStruct',
+            <span class='com'># optional rdf:type property for the structure</span>
+            TYPE =&gt; 'http://x.y.z/test/xystruct',
+            <span class='com'># structure fields (very similar to tag definitions)</span>
+            X =&gt; { Writable =&gt; 'integer' },
+            Y =&gt; { Writable =&gt; 'integer' },
+            <span class='com'># a nested structure...</span>
+            Things =&gt; {
+                List =&gt; 'Bag',
+                Struct =&gt; {
+                    NAMESPACE =&gt; { thing =&gt; 'http://x.y.z/thing/' },
+                    What  =&gt; { },
+                    Where =&gt; { },
+                },
+            },
+        },
+        List =&gt; 'Seq', <span class='com'># structures may also be elements of a list</span>
+    },
+<span class='com'>    # Each field in the structure has an automatically-generated
+    # corresponding flattened tag with an ID that is the concatenation
+    # of the original structure tag ID and the field name (after
+    # capitalizing the first letter of the field name if necessary).
+    # The Name and/or Description of these flattened tags may be changed
+    # if desired, but all other tag properties are taken from the
+    # structure field definition.  When this is done, the "Flat" flag
+    # must also be set in the tag definition.  For example:</span>
+    NewXMPxxxStructX => { Name => 'SomeOtherName', Flat => 1 },
+);
+<span class='com'># Adding a new MIE group requires a few extra definitions</span>
+use Image::ExifTool::MIE;
+%Image::ExifTool::UserDefined::MIETest = (
+    %Image::ExifTool::MIE::tableDefaults,   <span class='com'># default MIE table entries</span>
+    GROUPS      =&gt; { 0 =&gt; 'MIE', 1 =&gt; 'MIE-Test', 2 =&gt; 'Document' },
+    WRITE_GROUP =&gt; 'MIE-Test',
+    NewMieTag2  =&gt; { },     <span class='com'># new user-defined tag in MIE-Test group</span>
+);
+<span class='com'># A special 'Lenses' list can be defined to give priority to specific lenses
+# in the logic to determine a lens model for the Composite:LensID tag</span>
+@Image::ExifTool::UserDefined::Lenses = (
+    'Sigma AF 10-20mm F4-5.6 EX DC',
+    'Tokina AF193-2 19-35mm f/3.5-4.5',
+);
+<span class='com'># Specify default ExifTool option values
+# (see the <a href="ExifTool.html#Options">Options function documentation</a> for available options)</span>
+%Image::ExifTool::UserDefined::Options = (
+    CoordFormat =&gt; '%.6f',  <span class='com'># change default GPS coordinate format</span>
+    Duplicates =&gt; 1,        <span class='com'># make -a default for the exiftool app</span>
+    GeoMaxHDOP =&gt; 4,        <span class='com'># ignore GPS fixes with HDOP &gt; 4</span>
+);
+<span class='com'>#------------------------------------------------------------------------------</span>
+1;  <span class='com'>#end</span>
+</pre>
+<hr>
+<p class='lf'><a href="index.html">&lt;-- Back to ExifTool home page</a></p>
+</body>
+</html>

data/vendor/Image-ExifTool-9.27/html/data_members.html ADDED

@@ -0,0 +1,264 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+        "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
+<html>
+<head>
+<title>ExifTool Object Data Members</title>
+<link rel=stylesheet type='text/css' href='style.css' title='Style'>
+</head>
+<body>
+<h2 class='up'>ExifTool Object Data Members</h2>
+<p>The following table lists the data members of the ExifTool object.  (If this
+was C++, these would be documented next to the definitions in the header file,
+but this is Perl, so I couldn't do that...)</p>
+<p>Aside from the variables defined below, there may be other temporary
+variables added by individual modules. Temporary variables are identified by at
+least one lower case letter in their name, and are deleted automatically before
+reading or writing each new image.  Make, Model and CameraType are temporary
+variables like this, but these three are special because they are initialized to
+an empty string instead of being deleted at the start of processing for each
+image, which allows them to be tested without having to check for an undefined
+value.</p>
+<blockquote><table class='norm'><tr><th>Name</th><th>Description</th></tr>
+<tr><td>ADD_DIRS</td><td>Hash of parent directories for each directory added during
+    writing (Note: entry may exist but be undefined for top-level
+    directory!)</td></tr>
+<tr><td>BASE</td><td>Absolute position of current image in containing file
+    (for example, when processing JPEG image in FujiFilm RAF file)</td></tr>
+<tr><td>BOTH</td><td>Reference to HASH of ValueConv/PrintConv arrays, saved for
+    tags when GetValue is called for 'Both' values, and used to avoid having to
+    recalculate both values again (which speeds up building the Composite tags
+    because often the same tag is Require'd by multiple Composite tags).</td></tr>
+<tr><td>CameraType</td><td>Camera type used for decoding some Olympus tags</td></tr>
+<tr><td>CHANGED</td><td>Number of tags changed during writing</td></tr>
+<tr><td>CHARSET</td><td>Lookup table for current Charset setting</td></tr>
+<tr><td>CHECK_WARN</td><td>Used to return CHECK_PROC warnings</td></tr>
+<tr><td>CUR_LANG</td><td>Hash reference for localized language lookup corresponding
+    to current 'Lang' options setting.</td></tr>
+<tr><td>DEL_GROUP</td><td>Hash of groups to delete.  Value is 1 to delete group
+    completely, or 2 if tags were added back after deleting the group.</td></tr>
+<tr><td>DEL_PREVIEW</td><td>Flag to delete preview from after JPEG EOI</td></tr>
+<tr><td>DIR_COUNT</td><td>Hash reference for counters of various types of directorys (ICC, IPTC,...)</td></tr>
+<tr><td>DIR_NAME</td><td>Name of directory currently being processed</td></tr>
+<tr><td>DOC_COUNT</td><td>Number of top-level embedded sub-documents processed while
+    extracting, or 0 if none were processed</td></tr>
+<tr><td>DOC_NUM</td><td>Current document number while extracting (0, '' or undef for the
+    main document)</td></tr>
+<tr><td>DoneID3</td><td>Set to 1 if audio file was scanned for ID3,
+    or 2 if there was an ID3v1 trailer found</td></tr>
+<tr><td>DROP_TAGS</td><td>Flag to exclude "Drop" tags when writing</td></tr>
+<tr><td>DUPL_TAG</td><td>Hash of last used tag key index numbers for each duplicate tag.</td></tr>
+<tr><td>EDIT_DIRS</td><td>Hash of parent directories for each directory edited during
+    writing (Note: entry may exist but be undefined for top-level
+    directory!)</td></tr>
+<tr><td>ESCAPE_PROC</td><td>Routine for XML or HTML escaping if Escape option is set</td></tr>
+<tr><td>EXCL_TAG_LOOKUP</td><td>Hash for looking up excluded tags (keys are lower case tag names)</td></tr>
+<tr><td>EXIF_DATA</td><td>EXIF data block (valid while reading from file)</td></tr>
+<tr><td>EXIF_POS</td><td>Position of EXIF data in file</td></tr>
+<tr><td>FILENAME</td><td>Name of input file while extracting (only if we opened it, '' otherwise)</td></tr>
+<tr><td>FILE_ORDER</td><td>Hash of numbers to give the sequence the tags were
+    extracted from file, keyed by tag key</td></tr>
+<tr><td>FILE_EXT</td><td>File extension (JPG, PEF, AVI, etc...) May be undefined if
+    file has no extension.</td></tr>
+<tr><td>FILE_SEQUENCE</td><td>File sequence number when extracting information</td></tr>
+<tr><td>FILE_TYPE</td><td>Root file format type (JPEG, TIFF, RIFF, etc...)</td></tr>
+<tr><td>FIRST_EXIF_POS</td><td>Position of first EXIF in file</td></tr>
+<tr><td>FOUND_TAGS</td><td>Found tags with proper case and order</td></tr>
+<tr><td>GLOBAL_TIME_OFFSET</td><td>Time offset hash for first shifted date/time value of GlobalTimeShift option</td></tr>
+<tr><td>HTML_DUMP</td><td>Reference to HtmlDump object when using HtmlDump feature</td></tr>
+<tr><td>INDENT</td><td>Indent string for verbose output</td></tr>
+<tr><td>IN_RESOURCE</td><td>Flag indicates we are processing the resource fork of a Mac OS file</td></tr>
+<tr><td>IO_TAG_LIST</td><td>List for output of requested tags in proper case and order</td></tr>
+<tr><td>LIST_TAGS</td><td>Hash of tag keys by tagInfo reference for active list-type
+    tags.  This hash is cleared at the start of processing for each directory.
+    Not used during when writing.</td></tr>
+<tr><td>LOW_PRIORITY_DIR</td><td>Lookup based on directory name for directories where
+    undefined Priority tags get set to Priority 0 (ie. PreviewIFD in all images,
+    and IFD1 in JPEG images).  This is equivalent to setting PRIORITY to 0 for
+    the tag table only for a specific directory name.</td></tr>
+<tr><td>Make</td><td>Camera make set during reading and writing</td></tr>
+<tr><td>MAKER_NOTE_BYTE_ORDER</td><td>Byte order of extracted maker notes if extracted
+    as a block.</td></tr>
+<tr><td>MAKER_NOTE_INFO</td><td>Used by Image::ExifTool::CanonRaw as temporary storage for
+    maker note information when synthesizing maker notes from CRW file with the
+    MakerNotes option.</td></tr>
+<tr><td>MAKER_NOTE_FIXUP</td><td>Fixup information for maker notes extracted with the MakerNotes
+    option (unless MakerNotes option is 2). Used by SetNewValuesFromFile() to adjust offsets
+    in maker note IFD</td></tr>
+<tr><td>Model</td><td>Camera model name set during reading and writing</td></tr>
+<tr><td>MOVED_KEY</td><td>Tag key of last tag replaced by a higher priority tag
+    in a call to FoundTag().</td></tr>
+<tr><td>NEW_VALUE</td><td>Hash of new value information keyed by tag info reference.
+    Elements of new value information hash are:
+    <table class='clear'><tr><td>TagInfo</td><td>-</td><td>tag information reference</td></tr>
+    <tr><td>DelValue</td><td>-</td><td>list of specific values to delete</td></tr>
+    <tr><td>Value</td><td>-</td><td>list of values to add</td></tr>
+    <tr valign='top'><td>IsCreating</td><td>-</td><td>must be set for the tag to be added, otherwise just
+        changed if it already exists.  A value of 2 will create a new tag if its group already
+        exists, but won't add a new group</td></tr>
+    <tr valign='top'><td>Next</td><td>-</td><td>reference to next new value hash in linked list
+        if there is more than one new value hash (for writing to different groups) for this
+        tagInfo</td></tr>
+    <tr valign='top'><td>Save</td><td>-</td><td>flag set by call to SaveNewValues() if this value
+        should be saved</td></tr>
+    </table></td></tr>
+<tr><td>NewIPTCDigest</td><td>MD5 digest for most recently written IPTC data (undefined if IPTC doesn't
+    exist or if it was deleted).  Calculated only if a value of 'new' is being written/deleted
+    to/from the Photoshop:IPTCDigest tag</td></tr>
+<tr><td>NO_LIST</td><td>Set if List tags shouldn't be accumulated into a list.  Undefined to
+    accumulate lists as usual, or 0 to accumulate lists in TAG_EXTRA "NoList" element (and
+    set a TAG_EXTRA "NoListDel" flag for tags that wouldn't have been created).</td></tr>
+<tr><td>NO_UNKNOWN</td><td>Don't generate unknown tags automatically even if Unknown option is set</td></tr>
+<tr><td>NUM_FOUND</td><td>Number of tags found</td></tr>
+<tr><td>OldIPTCDigest</td><td>MD5 digest for original IPTC data (undefined if IPTC didn't
+    exist).  Calculated only if a value of 'old' is being written/deleted to/from the
+    Photoshop:IPTCDigest tag</td></tr>
+<tr><td>OPTIONS</td><td>ExifTool options</td></tr>
+<tr><td>PATH</td><td>List reference to SubDirectory path.  ie)
+    [qw(JPEG APP13 Photoshop IPTC)]</td></tr>
+<tr><td>PDF_CAPTURE</td><td>Used by PDF module to store information when writing</td></tr>
+<tr><td>PreferredGroup</td><td>Preferred family 1 group for writing tags to the current file.
+    Not defined to use the default group priorities.  Set in call to InitWriteDirs().</td></tr>
+<tr><td>PREVIEW_INFO</td><td>Information about preview image used while writing JPEG
+    images only.  This is a reference to a hash with the following entries:
+    <table class='clear'>
+    <tr valign='top'><td>Absolute</td><td>-</td><td>flag set if PreviewImage pointer is relative to the
+    start of file</td></tr>
+    <tr><td>BaseShift</td><td>-</td><td>shift for base of pointer offsets</td></tr>
+    <tr valign='top'><td>Data</td><td>-</td><td>data for PreviewImage to be written (may either be data
+    for the old or new image, or 'LOAD_PREVIEW' to indicate that the data must be loaded from outside
+    the EXIF segment)</td></tr>
+    <tr><td>Fixup</td><td>-</td><td>[mandatory] fixup for PreviewImage pointers when writing JPEG images</td></tr>
+    <tr valign='top'><td>IsShort</td><td>-</td><td>flag indicates PreviewImage pointers
+    are 2-byte (instead of 4-byte) integers</td></tr>
+    <tr valign='top'><td>IsTrailer</td><td>-</td><td>flag indicates image should always be written as a JPEG
+    trailer, even if it fits inside the APP1 EXIF segment (as with Samsung STMN maker notes)</td></tr>
+    <tr><td>Relative</td><td>-</td><td>flag to indicate that pointer offsets are relative</td></tr>
+    </table></td></tr>
+<tr><td>PRIORITY</td><td>Hash of tag Priority values for current tag, keyed by tag name (not tag key!)</td></tr>
+<tr><td>PRIORITY_DIR</td><td>Name of priority directory (ie. the IFD for the full resolution image)</td></tr>
+<tr><td>PROCESSED</td><td>Reference to hash of address/directory names which were processed
+    during reading and/or writing</td></tr>
+<tr><td>RAF</td><td>Random access file object for reading from input file</td></tr>
+<tr><td>RATIONAL</td><td>Hash of rational values as a string fraction keyed by tag key</td></tr>
+<tr><td>Recreated</td><td>Directories recreated when writing (used to prevent recreating
+    multiple directories of the same type)</td></tr>
+<tr><td>REQUESTED_TAGS</td><td>List of requested tags in original case</td></tr>
+<tr><td>REQ_TAG_LOOKUP</td><td>Hash for looking up requested tags (keys are lower case tag names)</td></tr>
+<tr><td>SAVE_COUNT</td><td>Counts number of times SaveNewValues() has been called</td></tr>
+<tr><td>SAVE_DEL_GROUP</td><td>Hash of saved DEL_GROUP entries</td></tr>
+<tr><td>SAVE_NEW_VALUE</td><td>Hash of new value information which was overwritten after
+    a call to SaveNewValues()</td></tr>
+<tr><td>SET_GROUP0</td><td>Value to use for family 0 group name when new tags
+    are found</td></tr>
+<tr><td>SET_GROUP1</td><td>Value to use for family 1 group name when new tags
+    are found.  May start with a '+' sign to add to existing group name</td></tr>
+<tr><td>TAG_EXTRA</td><td>Hash of extra tag information keyed by tag key.  Current extra
+information may include:
+    <table class='clear'>
+    <tr valign='top'><td>G0</td><td>-</td><td>override for family 0 group name</td></tr>
+    <tr valign='top'><td>G1</td><td>-</td><td>dynamic family 1 group name (ie. IFD name or XMP
+        namespace), with a leading '+' to add value to the existing group 1 name</td></tr>
+    <tr valign='top'><td>G3</td><td>-</td><td>number for embedded documents (ie. 1, 2, etc)</td></tr>
+    </table></td></tr>
+<tr><td>TAG_INFO</td><td>Hash of tagInfo hash references, keyed by tag key</td></tr>
+<tr><td>TAGS_FROM_FILE</td><td>Flag used during extraction when called from SetNewValuesFromFile().
+    Test this flag when extracting tags that are not normally extracted.</td></tr>
+<tr><td>TIFF_END</td><td>Location of end of regular TIFF file set by WriteExif()</td></tr>
+<tr><td>TIFF_TYPE</td><td>Type of TIFF data, only set if FILE_TYPE is TIFF.  Valid values
+    are APP1, APP3, TIFF, CR2, MRW, JP2, JPX, NEF, PEF, ORF, DNG, etc.</td></tr>
+<tr><td>VALUE</td><td>Hash of raw tag values keyed by tag key</td></tr>
+<tr><td>WARNED_ONCE</td><td>Hash of warning messages that have been issued once already</td></tr>
+<tr><td>WRITE_GROUPS</td><td>List of write groups in order of priority</td></tr>
+<tr><td>WRITE_PRIORITY</td><td>Hash of write priority values keyed by group name</td></tr>
+<tr><td>XMP_CAPTURE</td><td>Hash of tag information (value, attribute hash) keyed by XMP
+    property path, used by XMP module during writing</td></tr>
+<tr><td>XMP_ERROR</td><td>Error string used by XMP module during writing</td></tr>
+<tr><td>XMP_NS</td><td>Hash of URI's keyed by namespace prefix, used by XMP module
+    during writing to remember all used namespaces</td></tr>
+</table></blockquote>
+<hr>
+<p class='lf'><a href="index.html">&lt;-- Back to ExifTool home page</a></p>
+</body>
+</html>