exiftool_vendored 10.04.0 → 10.23.0

data/bin/Image-ExifTool-10.23/META.yml

@@ -0,0 +1,28 @@
+--- #YAML:1.0
+name:               Image-ExifTool
+version:            10.23
+abstract:           Read and write meta information
+author:
+    - Phil Harvey (phil@owl.phy.queensu.ca)
+license:            perl
+distribution_type:  module
+configure_requires:
+    ExtUtils::MakeMaker:  0
+build_requires:
+    ExtUtils::MakeMaker:  0
+requires:
+    perl:  5.004
+no_index:
+    directory:
+        - t
+        - inc
+generated_by:       ExtUtils::MakeMaker version 6.56
+meta-spec:
+    url:      http://module-build.sourceforge.net/META-spec-v1.4.html
+    version:  1.4
+recommends:
+    Archive::Zip:    0
+    Compress::Zlib:  0
+    Digest::MD5:     0
+    Digest::SHA:     0
+    Time::HiRes:     0

data/bin/Image-ExifTool-10.23/Makefile.PL

@@ -0,0 +1,46 @@
+use ExtUtils::MakeMaker;
+use File::Spec;
+
+my $ExifTool_pm  = File::Spec->catfile('lib', 'Image', 'ExifTool.pm');
+my $ExifTool_pod = File::Spec->catfile('lib', 'Image', 'ExifTool.pod');
+
+WriteMakefile(
+    NAME          => 'Image::ExifTool',
+    VERSION_FROM  => $ExifTool_pm,
+    PREREQ_PM     => { },
+    (($ExtUtils::MakeMaker::VERSION gt '6.31' and
+      $ExtUtils::MakeMaker::VERSION lt '6.46') ?
+        (EXTRA_META => "recommends:\n" .
+            "    Archive::Zip:    0\n" .
+            "    Compress::Zlib:  0\n" .
+            "    Digest::MD5:     0\n" .
+            "    Digest::SHA:     0\n" .
+            "    Time::HiRes:     0\n" ,
+          # (not worth recommending -- only for column alignment of some languages)
+          #  "    Unicode::LineBreak: 0\n",
+          # (not worth recommending -- only for Rawzor files)
+          # "    IO::Compress::Bzip2: 0\n",
+        ) : ()),
+    ($ExtUtils::MakeMaker::VERSION ge '6.46' ?
+        (META_MERGE => {
+            recommends => {
+                'Archive::Zip'   => 0,
+                'Compress::Zlib' => 0,
+                'Digest::MD5'    => 0,
+                'Digest::SHA'    => 0,
+                'Time::HiRes'    => 0,
+              # 'Unicode::LineBreak' => 0,
+              # 'IO::Compress::Bzip2' => 0,
+            },
+        } ) : ()),
+    clean         => { FILES => 't/*.tmp' },
+    EXE_FILES     => [ 'exiftool' ],
+    ($] >= 5.005 ?
+        (ABSTRACT_FROM => $ExifTool_pod,
+         AUTHOR        => 'Phil Harvey (phil@owl.phy.queensu.ca)',
+        ) : ()),
+    (($ExtUtils::MakeMaker::VERSION gt '6.30') ?
+        (LICENSE => 'perl') : ()),    
+    (($ExtUtils::MakeMaker::VERSION ge '6.47') ?
+        (MIN_PERL_VERSION => '5.004') : ()),    
+);

data/bin/Image-ExifTool-10.23/README

@@ -0,0 +1,236 @@
+ExifTool by Phil Harvey (phil at owl.phy.queensu.ca)
+----------------------------------------------------------------------------
+
+ExifTool is a customizable set of Perl modules plus a full-featured
+application for reading and writing meta information in a wide variety of
+files, including the maker note information of many digital cameras by
+various manufacturers such as Canon, Casio, FLIR, FujiFilm, GE, HP,
+JVC/Victor, Kodak, Leaf, Minolta/Konica-Minolta, Nikon, Nintendo,
+Olympus/Epson, Panasonic/Leica, Pentax/Asahi, Phase One, Reconyx, Ricoh,
+Samsung, Sanyo, Sigma/Foveon and Sony.
+
+Below is a list of file types and meta information formats currently
+supported by ExifTool (r = read, w = write, c = create):
+
+  File Types
+  ------------+-------------+-------------+-------------+------------
+  3FR   r     | DV    r     | KDC   r     | OGV   r     | RW2   r/w
+  3G2   r/w   | DVB   r/w   | KEY   r     | OPUS  r     | RWL   r/w
+  3GP   r/w   | DYLIB r     | LA    r     | ORF   r/w   | RWZ   r
+  A     r     | EIP   r     | LFP   r     | OTF   r     | RM    r
+  AA    r     | EPS   r/w   | LNK   r     | PAC   r     | SEQ   r
+  AAX   r/w   | EPUB  r     | M2TS  r     | PAGES r     | SO    r
+  ACR   r     | ERF   r/w   | M4A/V r/w   | PBM   r/w   | SR2   r/w
+  AFM   r     | EXE   r     | MEF   r/w   | PCD   r     | SRF   r
+  AI    r/w   | EXIF  r/w/c | MIE   r/w/c | PDB   r     | SRW   r/w
+  AIFF  r     | EXR   r     | MIFF  r     | PDF   r/w   | SVG   r
+  APE   r     | EXV   r/w/c | MKA   r     | PEF   r/w   | SWF   r
+  ARW   r/w   | F4A/V r/w   | MKS   r     | PFA   r     | THM   r/w
+  ASF   r     | FFF   r/w   | MKV   r     | PFB   r     | TIFF  r/w
+  AVI   r     | FLA   r     | MNG   r/w   | PFM   r     | TORRENT r
+  AZW   r     | FLAC  r     | MOBI  r     | PGF   r     | TTC   r
+  BMP   r     | FLV   r     | MODD  r     | PGM   r/w   | TTF   r
+  BPG   r     | FPF   r     | MOI   r     | PLIST r     | VCF   r
+  BTF   r     | FPX   r     | MOS   r/w   | PICT  r     | VRD   r/w/c
+  CHM   r     | GIF   r/w   | MOV   r/w   | PMP   r     | VSD   r
+  COS   r     | GZ    r     | MP3   r     | PNG   r/w   | WAV   r
+  CR2   r/w   | HDP   r/w   | MP4   r/w   | PPM   r/w   | WDP   r/w
+  CRW   r/w   | HDR   r     | MPC   r     | PPT   r     | WEBP  r
+  CS1   r/w   | HTML  r     | MPG   r     | PPTX  r     | WEBM  r
+  DCM   r     | ICC   r/w/c | MPO   r/w   | PS    r/w   | WMA   r
+  DCP   r/w   | ICS   r     | MQV   r/w   | PSB   r/w   | WMV   r
+  DCR   r     | IDML  r     | MRW   r/w   | PSD   r/w   | WV    r
+  DFONT r     | IIQ   r/w   | MXF   r     | PSP   r     | X3F   r/w
+  DIVX  r     | IND   r/w   | NEF   r/w   | QTIF  r/w   | XCF   r
+  DJVU  r     | INX   r     | NRW   r/w   | RA    r     | XLS   r
+  DLL   r     | ISO   r     | NUMBERS r   | RAF   r/w   | XLSX  r
+  DNG   r/w   | ITC   r     | O     r     | RAM   r     | XMP   r/w/c
+  DOC   r     | J2C   r     | ODP   r     | RAR   r     | ZIP   r
+  DOCX  r     | JNG   r/w   | ODS   r     | RAW   r/w   |
+  DPX   r     | JP2   r/w   | ODT   r     | RIFF  r     |
+  DR4   r/w/c | JPEG  r/w   | OFR   r     | RSRC  r     |
+  DSS   r     | K25   r     | OGG   r     | RTF   r     |
+
+  Meta Information
+  ----------------------+----------------------+---------------------
+  EXIF           r/w/c  |  CIFF           r/w  |  Ricoh RMETA    r
+  GPS            r/w/c  |  AFCP           r/w  |  Picture Info   r
+  IPTC           r/w/c  |  Kodak Meta     r/w  |  Adobe APP14    r
+  XMP            r/w/c  |  FotoStation    r/w  |  MPF            r
+  MakerNotes     r/w/c  |  PhotoMechanic  r/w  |  Stim           r
+  Photoshop IRB  r/w/c  |  JPEG 2000      r    |  DPX            r
+  ICC Profile    r/w/c  |  DICOM          r    |  APE            r
+  MIE            r/w/c  |  Flash          r    |  Vorbis         r
+  JFIF           r/w/c  |  FlashPix       r    |  SPIFF          r
+  Ducky APP12    r/w/c  |  QuickTime      r    |  DjVu           r
+  PDF            r/w/c  |  Matroska       r    |  M2TS           r
+  PNG            r/w/c  |  MXF            r    |  PE/COFF        r
+  Canon VRD      r/w/c  |  PrintIM        r    |  AVCHD          r
+  Nikon Capture  r/w/c  |  FLAC           r    |  ZIP            r
+  GeoTIFF        r/w/c  |  ID3            r    |  (and more)
+
+See html/index.html for more details about ExifTool features.
+
+ExifTool can be downloaded from
+
+  http://owl.phy.queensu.ca/~phil/exiftool/
+
+RUNNING
+
+The exiftool script can be run right away without the need to install
+Image::ExifTool.  For example, from within the exiftool directory you can
+extract the information from one of the included test files by typing:
+
+  ./exiftool t/images/ExifTool.jpg
+
+If you move the exiftool script to a different directory, you must also
+either move the contents of the lib directory or install the Image::ExifTool
+package so the script can find the necessary libraries.
+
+Note:  If you are using the Windows cmd shell, you may need to rename
+'exiftool' to 'exiftool.pl' to run it directly from the command line.
+Alternatively, you can run exiftool with the command 'perl exiftool'.
+
+IF YOU ARE STILL CONFUSED
+
+The exiftool script is a command line application.  You run it by typing
+commands in a terminal window.  The first step is to determine the name of
+the directory where you downloaded the ExifTool distribution package.
+Assuming, for example, you downloaded it to a folder called "Desktop" in
+your home directory, then you would type the following commands in a
+terminal window to extract and run ExifTool:
+
+  cd ~/Desktop
+  gzip -dc Image-ExifTool-##.##.tar.gz | tar -xf -
+  cd Image-ExifTool-##.##
+  ./exiftool t/images/ExifTool.jpg
+
+Note: You must replace "##.##" in the above commands with the actual version
+number of ExifTool that you downloaded.  These commands extract meta
+information from one of the test images.  To use one of your images instead,
+enter the full path name of your file in place of "t/images/ExifTool.jpg".
+
+INSTALLATION
+
+You can install the Image::ExifTool package to make it available for use by
+other Perl scripts by typing the following:
+
+  perl Makefile.PL
+  make
+  make test
+  make install
+
+Notes:
+  i) You need root access for the last step above.
+
+  ii) Some Perl installations (like the standard OSX installation) may not
+  contain the necessary files to complete the first step above.  But no
+  worries:  You can install ExifTool manually by moving 'exiftool' and the
+  'lib' directory to any directory in your current PATH (ie. /usr/bin).
+
+  iii) In Windows, "dmake" or "nmake" may be used if "make" is not
+  available.  The "nmake" utility may be downloaded from Microsoft at
+  http://support.microsoft.com/default.aspx?scid=kb;en-us;Q132084 but note
+  that is utility is very old, and may not work with Makefiles generated by
+  newer Perl versions.
+
+(Also see html/install.html for more help with installation.)
+
+DEPENDENCIES
+
+Requires Perl version 5.004 or later.  No other special libraries are
+required, however the following modules are recommended for decoding
+compressed and/or encrypted information from the indicated file types, and
+for calculating digest values for some information types:
+
+  Archive::Zip         (ZIP, DOCX, PPTX, XLSX, ODP, ODS, ODT, EIP, iWork)
+  Compress::Zlib       (DNG, PNG, PDF, DCM, MIE and SWF files)
+  Digest::MD5          (PDF files, IPTC information, and JPG Extended XMP)
+  Digest::SHA          (PDF with AES-256 encryption)
+  IO::Compress::Bzip2  (RWZ files)
+  Win32::API           (for proper handling of Windows file times)
+  Win32API::File       (for Windows Unicode file names and file times)
+  Win32::FindFile      (for Windows Unicode directory support, app only)
+  Time::HiRes          (allows generation of ProcessingTime tag)
+  Unicode::LineBreak   (for column-alignment of alternate language output)
+
+COPYRIGHT AND LICENSE
+
+Copyright 2003-2016, Phil Harvey
+
+This is free software; you can redistribute it and/or modify it under the
+same terms as Perl itself.
+
+DISTRIBUTION FILES
+
+Below is a list of the files/directories included in the full ExifTool
+distribution package:
+
+  Changes                   - Revision history
+  MANIFEST                  - Full list of distribution files
+  META.yml                  - Standard CPAN dependency file
+  Makefile.PL               - Makefile for installation
+  README                    - This file
+  arg_files/                - Argument files to convert metadata formats:
+    exif2iptc.args            - Arguments for converting EXIF to IPTC
+    exif2xmp.args             - Arguments for converting EXIF to XMP
+    gps2xmp.args              - Arguments for converting GPS to XMP
+    iptc2exif.args            - Arguments for converting IPTC to EXIF
+    iptc2xmp.args             - Arguments for converting IPTC to XMP
+    iptcCore.args             - Complete list of IPTC Core XMP tags
+    pdf2xmp.args              - Arguments for converting PDF to XMP
+    xmp2exif.args             - Arguments for converting XMP to EXIF
+    xmp2gps.args              - Arguments for converting XMP to GPS
+    xmp2iptc.args             - Arguments for converting XMP to IPTC
+    xmp2pdf.args              - Arguments for converting XMP to PDF
+  config_files/             - Sample ExifTool configuration files:
+    convert_regions.config    - Convert between MWG and MP face regions
+    example.config            - General example showing config features
+    gps2utm.config            - Generate UTM coordinate tags from GPS info
+    photoshop_paths.config    - For extracting or copying Photoshop paths
+    picasa_faces.config       - Convert from Picasa to MWG/MP face regions
+  exiftool                  - The exiftool application (Perl script)
+  fmt_files/                - Output formatting example files:
+    gpx.fmt                   - Format file for creating GPX track
+    gpx_wpt.fmt               - Format file for creating GPX waypoints
+    kml.fmt                   - Format file for creating KML output files
+  html/                     - HTML documentation
+  html/TagNames/            - HTML tag name documentation
+  lib/                      - ExifTool Perl library modules
+  perl-Image-ExifTool.spec  - Red Hat Packaging Manager specification file
+  t/                        - Verification test code
+  t/images/                 - Verification test images
+
+ADDITIONAL INFORMATION
+
+Read the following files included in the full distribution for more
+information:
+
+  html/index.html           - Main ExifTool documentation
+  html/install.html         - Installation instructions
+  html/history.html         - Revision history
+  html/ExifTool.html        - API documentation
+  html/TagNames/index.html  - Tag name documentation
+  html/geotag.html          - Geotag feature
+  html/faq.html             - Frequently asked questions
+  html/filename.html        - Renaming/moving files
+  html/metafiles.html       - Working with metadata sidecar files
+  html/struct.html          - Working with structured XMP information
+  lib/Image/ExifTool/README - ExifTool library modules documentation
+
+and if you have installed Image::ExifTool, you can also consult perldoc or
+the man pages:
+
+  perldoc exiftool
+  perldoc Image::ExifTool
+  perldoc Image::ExifTool::TagNames
+
+  man exiftool
+  man Image::ExifTool
+  man Image::ExifTool::TagNames
+
+Note: If the man pages don't work, it is probably because your man path is
+not set to include the installed documentation.  See "man man" for
+information about how to set the man path.
+
+----------------------------------------------------------------------------

data/bin/Image-ExifTool-10.23/config_files/example.config

@@ -0,0 +1,343 @@
+#------------------------------------------------------------------------------
+# File:         ExifTool_config  -->  ~/.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 new file types and default ExifTool option values.
+#
+#               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
+#               this must be the first option on the command line):
+#
+#                   exiftool -config example.config ...
+#
+#               This example 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.
+%Image::ExifTool::UserDefined::Shortcuts = (
+    MyShortcut => ['exif:createdate','exposuretime','aperture'],
+    MyAlias => 'FocalLengthIn35mmFormat',
+);
+
+# 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.
+%Image::ExifTool::UserDefined = (
+    # 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):
+    'Image::ExifTool::Exif::Main' => {
+        # Example 1.  EXIF:NewEXIFTag
+        0xd000 => {
+            Name => 'NewEXIFTag',
+            Writable => 'int16u',
+            WriteGroup => 'IFD0',
+        },
+        # add more user-defined EXIF tags here...
+    },
+    # the Geotag feature writes these additional GPS tags if available:
+    'Image::ExifTool::GPS::Main' => {
+        # Example 2.  GPS:GPSPitch
+        0xd000 => {
+            Name => 'GPSPitch',
+            Writable => 'rational64s',
+        },
+        # Example 3.  GPS:GPSRoll
+        0xd001 => {
+            Name => 'GPSRoll',
+            Writable => 'rational64s',
+        },
+    },
+    # IPTC tags are added to a specific record type (eg. application record):
+    # (Note: IPTC tag ID's are limited to the range 0-255)
+    'Image::ExifTool::IPTC::ApplicationRecord' => {
+        # Example 4.  IPTC:NewIPTCTag
+        160 => {
+            Name => 'NewIPTCTag',
+            Format => 'string[0,16]',
+        },
+        # add more user-defined IPTC ApplicationRecord tags here...
+    },
+    # XMP tags may be added to existing namespaces:
+    'Image::ExifTool::XMP::xmp' => {
+        # Example 5.  XMP-xmp:NewXMPxmpTag
+        NewXMPxmpTag => { Groups => { 2 => 'Author' } },
+        # add more user-defined XMP-xmp tags here...
+    },
+    # special Geotag tags for XMP-exif:
+    'Image::ExifTool::XMP::exif' => {
+        # Example 6.  XMP-exif:GPSPitch
+        GPSPitch => { Writable => 'rational', Groups => { 2 => 'Location' } },
+        # Example 7.  XMP-exif:GPSRoll
+        GPSRoll  => { Writable => 'rational', Groups => { 2 => 'Location' } },
+    },
+    # new XMP namespaces (eg. xxx) must be added to the Main XMP table:
+    'Image::ExifTool::XMP::Main' => {
+        # namespace definition for examples 8 to 11
+        xxx => { # <-- must be the same as the NAMESPACE prefix
+            SubDirectory => {
+                TagTable => 'Image::ExifTool::UserDefined::xxx',
+                # (see the definition of this table below)
+            },
+        },
+        # add more user-defined XMP namespaces here...
+    },
+    # new PNG tags are added to the PNG::TextualData table:
+    'Image::ExifTool::PNG::TextualData' => {
+        # Example 12.  PNG:NewPngTag1
+        NewPngTag1 => { },
+        # Example 13.  PNG:NewPngTag2
+        NewPngTag2 => { },
+        # Example 14.  PNG:NewPngTag3
+        NewPngTag3 => { },
+    },
+    # add a new MIE tag (NewMieTag1) and group (MIE-Test) to MIE-Meta
+    # (Note: MIE group names must NOT end with a number)
+    'Image::ExifTool::MIE::Meta' => {
+        # Example 15.  MIE-Meta:NewMieTag1
+        NewMieTag1 => {
+            Writable => 'rational64u',
+            Units => [ 'cm', 'in' ],
+        },
+        # new MIE "Test" group for example 16
+        Test => {
+            SubDirectory => {
+                TagTable => 'Image::ExifTool::UserDefined::MIETest',
+                DirName => 'MIE-Test',
+            },
+        },
+    },
+    # Composite tags are added to the Composite table:
+    'Image::ExifTool::Composite' => {
+        # 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.
+        BaseName => {
+            Require => {
+                0 => 'FileName',
+            },
+            # remove the extension from FileName
+            ValueConv => '$val[0] =~ /(.*)\./ ? $1 : $val[0]',
+        },
+        # 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
+        FileExtension => {
+            Require => 'FileName',
+            ValueConv => '$val=~/\.([^.]*)$/; $1',
+        },
+        # override CircleOfConfusion tag to use D/1750 instead of D/1440
+        CircleOfConfusion => {
+            Require => 'ScaleFactor35efl',
+            Groups => { 2 => 'Camera' },
+            ValueConv => 'sqrt(24*24+36*36) / ($val * 1750)',
+            # an optional PrintConv may be used to format the value
+            PrintConv => 'sprintf("%.3f mm",$val)',
+        },
+        # generate a description for this file type
+        FileTypeDescription => {
+            Require => 'FileType',
+            ValueConv => 'GetFileType($val,1) || $val',
+        },
+        # calculate physical image size based on resolution
+        PhysicalImageSize => {
+            Require => {
+                0 => 'ImageWidth',
+                1 => 'ImageHeight',
+                2 => 'XResolution',
+                3 => 'YResolution',
+                4 => 'ResolutionUnit',
+            },
+            ValueConv => '$val[0]/$val[2] . " " . $val[1]/$val[3]',
+            # (the @prt array contains print-formatted values)
+            PrintConv => 'sprintf("%.1fx%.1f $prt[4]", split(" ",$val))',
+        },
+        # [advanced] select largest JPEG preview image
+        BigImage => {
+            Groups => { 2 => 'Preview' },
+            Desire => {
+                0 => 'JpgFromRaw',
+                1 => 'PreviewImage',
+                2 => 'OtherImage',
+                # (DNG and A100 ARW may be have 2 PreviewImage's)
+                3 => 'PreviewImage (1)',
+            },
+            # ValueConv may also be a code reference
+            # Inputs: 0) reference to list of values, 1) ExifTool object
+            ValueConv => sub {
+                my $val = shift;
+                my ($image, $bigImage, $len, $bigLen);
+                foreach $image (@$val) {
+                    next unless ref $image eq 'SCALAR';
+                    # check for JPEG image (or "Binary data" if -b not used)
+                    next unless $$image =~ /^(\xff\xd8\xff|Binary data (\d+))/;
+                    $len = $2 || length $$image; # get image length
+                    # save largest image
+                    next if defined $bigLen and $bigLen >= $len;
+                    $bigLen = $len;
+                    $bigImage = $image;
+                }
+                return $bigImage;
+            },
+        },
+        # **** ADD ADDITIONAL COMPOSITE TAG DEFINITIONS HERE ****
+    },
+);
+
+# 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'.
+%Image::ExifTool::UserDefined::xxx = (
+    GROUPS        => { 0 => 'XMP', 1 => 'XMP-xxx', 2 => 'Image' },
+    NAMESPACE     => { 'xxx' => 'http://ns.myname.com/xxx/1.0/' },
+    WRITABLE      => 'string', # (default to string-type tags)
+    # Example 8.  XMP-xxx:NewXMPxxxTag1 (an alternate-language tag)
+    # - replace "NewXMPxxxTag1" with your own tag name (eg. "MyTag")
+    NewXMPxxxTag1 => { Writable => 'lang-alt' },
+    # Example 9.  XMP-xxx:NewXMPxxxTag2 (a string tag in the Author category)
+    NewXMPxxxTag2 => { Groups => { 2 => 'Author' } },
+    # Example 10.  XMP-xxx:NewXMPxxxTag3 (an unordered List-type tag)
+    NewXMPxxxTag3 => { List => 'Bag' },
+    # Example 11.  XMP-xxx:NewXMPxxxStruct (a structured tag)
+    # - example structured XMP tag
+    NewXMPxxxStruct => {
+        # the "Struct" entry defines the structure fields
+        Struct => {
+            # optional namespace prefix and URI for structure fields
+            # (required only if different than NAMESPACE above)
+            NAMESPACE => { 'test' => 'http://x.y.z/test/' },
+            # optional structure name (used for warning messages only)
+            STRUCT_NAME => 'MyStruct',
+            # optional rdf:type property for the structure
+            TYPE => 'http://x.y.z/test/xystruct',
+            # structure field definitions (very similar to tag definitions)
+            X => { Writable => 'integer' },
+            Y => { Writable => 'integer' },
+            # a nested structure...
+            Things => {
+                List => 'Bag',
+                Struct => {
+                    NAMESPACE => { thing => 'http://x.y.z/thing/' },
+                    What  => { },
+                    Where => { },
+                },
+            },
+        },
+        List => 'Seq', # structures may also be elements of a list
+    },
+    # 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:
+    NewXMPxxxStructX => { Name => 'SomeOtherName', Flat => 1 },
+);
+
+# Adding a new MIE group requires a few extra definitions
+use Image::ExifTool::MIE;
+%Image::ExifTool::UserDefined::MIETest = (
+    %Image::ExifTool::MIE::tableDefaults,   # default MIE table entries
+    GROUPS      => { 0 => 'MIE', 1 => 'MIE-Test', 2 => 'Document' },
+    WRITE_GROUP => 'MIE-Test',
+    # Example 16.  MIE-Test:NewMieTag2
+    NewMieTag2  => { },     # new user-defined tag in MIE-Test group
+);
+
+# 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
+@Image::ExifTool::UserDefined::Lenses = (
+    'Sigma AF 10-20mm F4-5.6 EX DC',
+    'Tokina AF193-2 19-35mm f/3.5-4.5',
+);
+
+# User-defined file types to recognize
+%Image::ExifTool::UserDefined::FileTypes = (
+    XXX => { # <-- the extension of the new file type (case insensitive)
+        # BaseType specifies the format upon which this file is based.
+        # If BaseType is defined, then the file will be fully supported,
+        # and in this case the Magic pattern should not be defined
+        BaseType => 'TIFF',
+        MIMEType => 'image/x-xxx',
+        Description => 'My XXX file type',
+    },
+    YYY => {
+        # without BaseType, the file will be recognized but not supported
+        Magic => '0123abcd',    # regular expression to match at start of file
+        MIMEType => 'application/test',
+        Description => 'My YYY file type',
+    },
+    ZZZ => {
+        # if neither BaseType nor Magic are defined, the file will be
+        # recognized by extension only
+        Descripton => 'My ZZZ file type',
+    },
+);
+
+# Specify default ExifTool option values
+# (see the Options function documentation for available options)
+%Image::ExifTool::UserDefined::Options = (
+    CoordFormat => '%.6f',  # change default GPS coordinate format
+    Duplicates => 1,        # make -a default for the exiftool app
+    GeoMaxHDOP => 4,        # ignore GPS fixes with HDOP > 4
+    SystemTags => 1,        # extract additional File System tags
+);
+
+#------------------------------------------------------------------------------
+1;  #end