exiftool_vendored 12.16.0 → 12.25.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6e5f50165965c391eee5f2088b8220f437030d2c6f03f3f1af04df861f962f24
-  data.tar.gz: e9c7f8127928dfc92efcbe0e851dffeea05f6a97282497ff7a1e456c4802c9b6
+  metadata.gz: 04f93501e7bd28d806651831606ad1d1822fd9fc430e73f47c54a8c6be3fd025
+  data.tar.gz: 2be10f782f703d5880106603936d5f00a508db219958a50d7dc66f29102c7ba3
 SHA512:
-  metadata.gz: 54b390d7d5dd0b4e8420b747301442137dba8efea7fb6fb3b509634560ac1f5845f5d8dfae09b35c8ce6793a13cdd88e8620068464437d97632f19fb567da837
-  data.tar.gz: c2f4c386d46378f95d080c67e9a06d8c0b4a8e48038aff3dda4dc3da32cfa280dd79f39ac85c15174dd6186a24e8093157ec2529944a72d19312f4a569806f77
+  metadata.gz: 232066a679e6b866faad15144b640b047cf8cb9bfe67f3b5954f72c015b9b57f59662b0bb4e336f9ef2edaedf449012d4e8ab066e39a181e7c3bdb04b1f16b3f
+  data.tar.gz: '0585582d9a4c8a050982bec0e3e11cfaf7b702f733eff2338dbbdca3f49f73c5cccf73084c6cac300791d43baaccd7cdbcd3e5fa4bfa143facdd3a8e000e9c69'

data/bin/Changes

@@ -7,6 +7,140 @@ RSS feed: https://exiftool.org/rss.xml
 Note: The most recent production release is Version 12.16. (Other versions are
 considered development releases, and are not uploaded to MetaCPAN.)
 
+Apr. 22, 2021 - Version 12.25
+
+  - JPEG XL support is now official
+  - Added read support for Medical Research Council (MRC) image files
+  - Added ability to write a number of 3gp tags in video files
+  - Added a new Sony PictureProfile value (thanks Jos Roost)
+  - Added a new Sony LensType (thanks LibRaw)
+  - Added a new Nikon LensID (thanks Niels Kristian Bech Jensen)
+  - Added a new Canon LensType
+  - Decode more GPS information from Blackvue dashcam videos
+  - Decode a couple of new NikonSettings tags (thanks Warren Hatch)
+  - Decode a few new RIFF tags
+  - Improved Validate option to add minor warning if standard XMP is missing
+    xpacket wrapper
+  - Avoid decoding some large arrays in DNG images to improve performance unless
+    the -m option is used
+  - Patched bug that could give runtime warning when trying to write an empty
+    XMP structure
+  - Fixed decoding of ImageWidth/Height for JPEG XL images
+  - Fixed problem were Microsoft Xtra tags couldn't be deleted
+
+Apr. 13, 2021 - Version 12.24
+
+  - Added a new PhaseOne RawFormat value (thanks LibRaw)
+  - Decode a new Sony tag (thanks Jos Roost)
+  - Decode a few new Panasonic and FujiFilm tags (thanks LibRaw and Greybeard)
+  - Patched security vulnerability in DjVu reader
+  - Updated acdsee.config in distribution (thanks StarGeek)
+  - Recognize AutoCAD DXF files
+  - More work on experimental JUMBF read support
+  - More work on experimental JPEG XL read/write support
+
+Apr. 1, 2021 - Version 12.23
+
+  - Added support for Olympus ORI files
+  - Added experimental read/write support for JPEG XL images
+  - Added experimental read support for JUMBF metadata in JPEG and Jpeg2000
+    images
+  - Added built-in support for parsing GPS track from Denver ACG-8050 videos
+    with the -ee option
+  - Added a some new Sony lenses (thanks Jos Roost and LibRaw)
+  - Changed priority of Samsung trailer tags so the first DepthMapImage takes
+    precedence when -a is not used
+  - Improved identification of M4A audio files
+  - Patched to avoid escaping ',' in "Binary data" message when -struct is used
+  - Removed Unknown flag from MXF VideoCodingSchemeID tag
+  - Fixed -forcewrite=EXIF to apply to EXIF in binary header of EPS files
+  - API Changes:
+      - Added BlockExtract option
+
+Mar. 17, 2021 - Version 12.22
+
+  - Added a few new Sony LensTypes and a new SonyModelID (thanks Jos Roost and
+    LibRaw)
+  - Added Extra BaseName tag
+  - Added a new CanonModelID (thanks LibRaw)
+  - Decode timed GPS from unlisted programs in M2TS videos with the -ee3 option
+  - Decode more Sony rtmd tags
+  - Decode some tags for the Sony ILME-FX3 (thanks Jos Roost)
+  - Allow negative values to be written to XMP-aux:LensID
+  - Recognize HEVC video program in M2TS files
+  - Enhanced -b option so --b suppresses tags with binary data
+  - Improved flexibility when writing GPS coordinates:
+      - Now pulls latitude and longitude from a combined GPSCoordinates string
+      - Recognizes the full word "South" and "West" to write negative coordinates
+  - Improved warning when trying to write an integer QuickTime date/time tag and
+    Time::Local is not available
+  - Convert GPSSpeed from mph to km/h in timed GPS from Garmin MP4 videos
+
+Feb. 24, 2021 - Version 12.21
+
+  - Added a few new iOS QuickTime tags
+  - Decode a couple more Sony rtmd tags
+  - Patch to avoid possible "Use of uninitialized value" warning when attempting
+    to write QuickTime date/time tags with an invalid value
+  - Fixed problem writing Microsoft Xtra tags
+  - Fixed Windows daylight savings time patch for file times that was broken in
+    12.19 (however directory times will not yet handle DST properly)
+
+Feb. 23, 2021 - Version 12.20
+
+  - Added ability to write some Microsoft Xtra tags in MOV/MP4 videos
+  - Added two new Canon LensType values (thanks Norbert Wasser)
+  - Added a new Nikon LensID
+  - Fixed problem reading FITS comments that start before column 11
+
+Feb. 18, 2021 - Version 12.19
+
+  - Added -list_dir option
+  - Added the "ls-l" Shortcut tag
+  - Extract Comment and History from FITS files
+  - Enhanced FilePermissions to include device type (similar to "ls -l")
+  - Changed the name of Apple ContentIdentifier tag to MediaGroupUUID
+    (thanks Neal Krawetz)
+  - Fixed a potential "substr outside of string" runtime error when reading
+    corrupted EXIF
+  - Fixed edge case where NikonScanIFD may not be copied properly when copying
+    MakerNotes to another file
+  - API Changes:
+      - Added ability to read/write System tags of directories
+      - Enhanced GetAllGroups() to support family 7 and take optional ExifTool
+        reference
+      - Changed QuickTimeHandler option default to 1
+
+Feb. 9, 2021 - Version 12.18
+
+  - Added a new SonyModelID
+  - Decode a number of Sony tags for the ILCE-1 (thanks Jos Roost)
+  - Decode a couple of new Canon tags (thanks LibRaw)
+  - Patched to read differently formatted UserData:Keywords as written by iPhone
+  - Patched to tolerate out-of-order Nikon MakerNote IFD entries when obtaining
+    tags necessary for decryption
+  - Fixed a few possible Condition warnings for some NikonSettings tags
+
+Feb. 3, 2021 - Version 12.17
+
+  - Added a new Canon FocusMode value
+  - Added a new FujiFilm FilmMode value
+  - Added a number of new XMP-crs tags (thanks Herb)
+  - Decode a new H264 MDPM tag
+  - Allow non-conforming lower-case XMP boolean "true" and "false" values to be
+    written, but only when print conversion is disabled
+  - Improved Validate option to warn about non-capitalized boolean XMP values
+  - Improved logic for setting GPSLatitude/LongitudeRef values when writing
+  - Changed -json and -php options so the -a option is implied even without the
+    -g option
+  - Avoid extracting audio/video data from AVI videos when -ee -u is used
+  - Patched decoding of Canon ContinuousShootingSpeed for newer firmware
+    versions of the EOS-1DXmkIII
+  - Re-worked LensID patch of version 12.00 (github issue #51)
+  - Fixed a few typos in newly-added NikonSettings tags (thanks Herb)
+  - Fixed problem where group could not be specified for PNG-pHYs tags when
+    writing
+
 Jan. 21, 2021 - Version 12.16 (production release)
 
   - Extract another form of video subtitle text
@@ -14,6 +148,8 @@ Jan. 21, 2021 - Version 12.16 (production release)
     stream in MP4 files
   - Changed a Nikon FlashMode value
   - Fixed problem that caused a failed DPX test on Strawberry Perl
+  - API Changes:
+      - Enhanced ExtractEmbedded option
 
 Jan. 18, 2021 - Version 12.15 (production release)
 
@@ -220,7 +356,7 @@ July 27, 2020 - Version 12.02
   - Improved decoding of some Canon EOS 1DXmkIII custom functions
   - Allow integer QuickTime TrackNumber and DiskNumber values
   - Relax validity check of QuickTime:ContentCreateDate when writing with -n
-  - Removed "Com" from the start of some unknown ItemList tag names
+  - Removed "Com" from the start of some unknown QuickTime ItemList tag names
   - Patched CanonCustom decoding for bug in Canon EOS-1DX firmware
   - Changed QuickTime CleanAperture tags decode as signed rationals
 

data/bin/MANIFEST

@@ -19,6 +19,7 @@ config_files/acdsee.config
 config_files/age.config
 config_files/bibble.config
 config_files/convert_regions.config
+config_files/cuepointlist.config
 config_files/depthmap.config
 config_files/example.config
 config_files/fotoware.config
@@ -104,6 +105,7 @@ html/TagNames/MOI.html
 html/TagNames/MPC.html
 html/TagNames/MPEG.html
 html/TagNames/MPF.html
+html/TagNames/MRC.html
 html/TagNames/MWG.html
 html/TagNames/MXF.html
 html/TagNames/MacOS.html
@@ -326,6 +328,7 @@ lib/Image/ExifTool/MOI.pm
 lib/Image/ExifTool/MPC.pm
 lib/Image/ExifTool/MPEG.pm
 lib/Image/ExifTool/MPF.pm
+lib/Image/ExifTool/MRC.pm
 lib/Image/ExifTool/MWG.pm
 lib/Image/ExifTool/MXF.pm
 lib/Image/ExifTool/MacOS.pm
@@ -601,6 +604,9 @@ t/JSON_2.out
 t/JVC.t
 t/JVC_2.out
 t/JVC_3.out
+t/JXL.t
+t/JXL_2.out
+t/JXL_3.out
 t/Jpeg2000.t
 t/Jpeg2000_2.out
 t/Jpeg2000_3.out
@@ -647,6 +653,8 @@ t/MOI.t
 t/MOI_2.out
 t/MP3.t
 t/MP3_2.out
+t/MRC.t
+t/MRC_2.out
 t/MWG.t
 t/MWG_2.out
 t/MWG_3.out
@@ -759,6 +767,8 @@ t/QuickTime_12.out
 t/QuickTime_13.out
 t/QuickTime_14.out
 t/QuickTime_15.out
+t/QuickTime_16.out
+t/QuickTime_17.out
 t/QuickTime_2.out
 t/QuickTime_3.out
 t/QuickTime_4.out
@@ -1001,6 +1011,7 @@ t/images/InDesign.indd
 t/images/JSON.json
 t/images/JVC.jpg
 t/images/JVC2.jpg
+t/images/JXL.jxl
 t/images/Jpeg2000.j2c
 t/images/Jpeg2000.jp2
 t/images/Kodak.jpg
@@ -1012,6 +1023,7 @@ t/images/MIE.mie
 t/images/MIFF.miff
 t/images/MOI.moi
 t/images/MP3.mp3
+t/images/MRC.mrc
 t/images/MWG.jpg
 t/images/MXF.mxf
 t/images/MacOS.macos

data/bin/META.json

@@ -47,5 +47,5 @@
       }
    },
    "release_status" : "stable",
-   "version" : "12.16"
+   "version" : "12.25"
 }

data/bin/META.yml

@@ -28,4 +28,4 @@ recommends:
   Time::HiRes: 0
 requires:
   perl: 5.004
-version: 12.16
+version: 12.25

data/bin/README

@@ -14,47 +14,47 @@ supported by ExifTool (r = read, w = write, c = create):
 
   File Types
   ------------+-------------+-------------+-------------+------------
-  360   r/w   | DPX   r     | ITC   r     | ODP   r     | RIFF  r
-  3FR   r     | DR4   r/w/c | J2C   r     | ODS   r     | RSRC  r
-  3G2   r/w   | DSS   r     | JNG   r/w   | ODT   r     | RTF   r
-  3GP   r/w   | DV    r     | JP2   r/w   | OFR   r     | RW2   r/w
-  A     r     | DVB   r/w   | JPEG  r/w   | OGG   r     | RWL   r/w
-  AA    r     | DVR-MS r    | JSON  r     | OGV   r     | RWZ   r
-  AAE   r     | DYLIB r     | K25   r     | ONP   r     | RM    r
-  AAX   r/w   | EIP   r     | KDC   r     | OPUS  r     | SEQ   r
-  ACR   r     | EPS   r/w   | KEY   r     | ORF   r/w   | SKETCH r
-  AFM   r     | EPUB  r     | LA    r     | OTF   r     | SO    r
-  AI    r/w   | ERF   r/w   | LFP   r     | PAC   r     | SR2   r/w
-  AIFF  r     | EXE   r     | LNK   r     | PAGES r     | SRF   r
-  APE   r     | EXIF  r/w/c | LRV   r/w   | PBM   r/w   | SRW   r/w
-  ARQ   r/w   | EXR   r     | M2TS  r     | PCD   r     | SVG   r
-  ARW   r/w   | EXV   r/w/c | M4A/V r/w   | PCX   r     | SWF   r
-  ASF   r     | F4A/V r/w   | MACOS r     | PDB   r     | THM   r/w
-  AVI   r     | FFF   r/w   | MAX   r     | PDF   r/w   | TIFF  r/w
-  AVIF  r/w   | FITS  r     | MEF   r/w   | PEF   r/w   | TORRENT r
-  AZW   r     | FLA   r     | MIE   r/w/c | PFA   r     | TTC   r
-  BMP   r     | FLAC  r     | MIFF  r     | PFB   r     | TTF   r
-  BPG   r     | FLIF  r/w   | MKA   r     | PFM   r     | TXT   r
-  BTF   r     | FLV   r     | MKS   r     | PGF   r     | VCF   r
-  CHM   r     | FPF   r     | MKV   r     | PGM   r/w   | VRD   r/w/c
-  COS   r     | FPX   r     | MNG   r/w   | PLIST r     | VSD   r
-  CR2   r/w   | GIF   r/w   | MOBI  r     | PICT  r     | WAV   r
-  CR3   r/w   | GPR   r/w   | MODD  r     | PMP   r     | WDP   r/w
-  CRM   r/w   | GZ    r     | MOI   r     | PNG   r/w   | WEBP  r
-  CRW   r/w   | HDP   r/w   | MOS   r/w   | PPM   r/w   | WEBM  r
-  CS1   r/w   | HDR   r     | MOV   r/w   | PPT   r     | WMA   r
-  CSV   r     | HEIC  r/w   | MP3   r     | PPTX  r     | WMV   r
-  CZI   r     | HEIF  r/w   | MP4   r/w   | PS    r/w   | WTV   r
-  DCM   r     | HTML  r     | MPC   r     | PSB   r/w   | WV    r
-  DCP   r/w   | ICC   r/w/c | MPG   r     | PSD   r/w   | X3F   r/w
-  DCR   r     | ICS   r     | MPO   r/w   | PSP   r     | XCF   r
-  DFONT r     | IDML  r     | MQV   r/w   | QTIF  r/w   | XLS   r
-  DIVX  r     | IIQ   r/w   | MRW   r/w   | R3D   r     | XLSX  r
-  DJVU  r     | IND   r/w   | MXF   r     | RA    r     | XMP   r/w/c
-  DLL   r     | INSP  r/w   | NEF   r/w   | RAF   r/w   | ZIP   r
-  DNG   r/w   | INSV  r     | NRW   r/w   | RAM   r     |
-  DOC   r     | INX   r     | NUMBERS r   | RAR   r     |
-  DOCX  r     | ISO   r     | O     r     | RAW   r/w   |
+  360   r/w   | DPX   r     | ITC   r     | NUMBERS r   | RAM   r
+  3FR   r     | DR4   r/w/c | J2C   r     | O     r     | RAR   r
+  3G2   r/w   | DSS   r     | JNG   r/w   | ODP   r     | RAW   r/w
+  3GP   r/w   | DV    r     | JP2   r/w   | ODS   r     | RIFF  r
+  A     r     | DVB   r/w   | JPEG  r/w   | ODT   r     | RSRC  r
+  AA    r     | DVR-MS r    | JSON  r     | OFR   r     | RTF   r
+  AAE   r     | DYLIB r     | JXL   r     | OGG   r     | RW2   r/w
+  AAX   r/w   | EIP   r     | K25   r     | OGV   r     | RWL   r/w
+  ACR   r     | EPS   r/w   | KDC   r     | ONP   r     | RWZ   r
+  AFM   r     | EPUB  r     | KEY   r     | OPUS  r     | RM    r
+  AI    r/w   | ERF   r/w   | LA    r     | ORF   r/w   | SEQ   r
+  AIFF  r     | EXE   r     | LFP   r     | ORI   r/w   | SKETCH r
+  APE   r     | EXIF  r/w/c | LNK   r     | OTF   r     | SO    r
+  ARQ   r/w   | EXR   r     | LRV   r/w   | PAC   r     | SR2   r/w
+  ARW   r/w   | EXV   r/w/c | M2TS  r     | PAGES r     | SRF   r
+  ASF   r     | F4A/V r/w   | M4A/V r/w   | PBM   r/w   | SRW   r/w
+  AVI   r     | FFF   r/w   | MACOS r     | PCD   r     | SVG   r
+  AVIF  r/w   | FITS  r     | MAX   r     | PCX   r     | SWF   r
+  AZW   r     | FLA   r     | MEF   r/w   | PDB   r     | THM   r/w
+  BMP   r     | FLAC  r     | MIE   r/w/c | PDF   r/w   | TIFF  r/w
+  BPG   r     | FLIF  r/w   | MIFF  r     | PEF   r/w   | TORRENT r
+  BTF   r     | FLV   r     | MKA   r     | PFA   r     | TTC   r
+  CHM   r     | FPF   r     | MKS   r     | PFB   r     | TTF   r
+  COS   r     | FPX   r     | MKV   r     | PFM   r     | TXT   r
+  CR2   r/w   | GIF   r/w   | MNG   r/w   | PGF   r     | VCF   r
+  CR3   r/w   | GPR   r/w   | MOBI  r     | PGM   r/w   | VRD   r/w/c
+  CRM   r/w   | GZ    r     | MODD  r     | PLIST r     | VSD   r
+  CRW   r/w   | HDP   r/w   | MOI   r     | PICT  r     | WAV   r
+  CS1   r/w   | HDR   r     | MOS   r/w   | PMP   r     | WDP   r/w
+  CSV   r     | HEIC  r/w   | MOV   r/w   | PNG   r/w   | WEBP  r
+  CZI   r     | HEIF  r/w   | MP3   r     | PPM   r/w   | WEBM  r
+  DCM   r     | HTML  r     | MP4   r/w   | PPT   r     | WMA   r
+  DCP   r/w   | ICC   r/w/c | MPC   r     | PPTX  r     | WMV   r
+  DCR   r     | ICS   r     | MPG   r     | PS    r/w   | WTV   r
+  DFONT r     | IDML  r     | MPO   r/w   | PSB   r/w   | WV    r
+  DIVX  r     | IIQ   r/w   | MQV   r/w   | PSD   r/w   | X3F   r/w
+  DJVU  r     | IND   r/w   | MRC   r     | PSP   r     | XCF   r
+  DLL   r     | INSP  r/w   | MRW   r/w   | QTIF  r/w   | XLS   r
+  DNG   r/w   | INSV  r     | MXF   r     | R3D   r     | XLSX  r
+  DOC   r     | INX   r     | NEF   r/w   | RA    r     | XMP   r/w/c
+  DOCX  r     | ISO   r     | NRW   r/w   | RAF   r/w   | ZIP   r
 
   Meta Information
   ----------------------+----------------------+---------------------
@@ -106,8 +106,8 @@ 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-12.16.tar.gz | tar -xf -
-  cd Image-ExifTool-12.16
+  gzip -dc Image-ExifTool-12.25.tar.gz | tar -xf -
+  cd Image-ExifTool-12.25
   ./exiftool t/images/ExifTool.jpg
 
 Note:  These commands extract meta information from one of the test images. 
@@ -194,6 +194,7 @@ distribution package:
     age.config                - Calculate Age of person in photo
     bibble.config             - Definitions for writing Bibble XMP tags
     convert_regions.config    - Convert between MWG, MP and IPTC regions
+    cuepointlist.config       - Extract cue points and labels as a list
     depthmap.config           - Extract Google DepthMap images
     example.config            - General example showing config features
     fotoware.config           - Definitions for writing Fotoware XMP tags

data/bin/config_files/acdsee.config

@@ -2,20 +2,76 @@
 # File:         acdsee.config
 #
 # Description:  This config file defines ACDSee XMP region tags for writing.
+#               The following tags are created in the XMP-acdsee-rs group
 #
-# Usage:        exiftool -config acdsee.config -ACDSEETAG=VALUE FILE ...
+#                   RegionInfoACDSee : The structured tag for the ACDSee regions
+#                                      (similar to XMP-mwg-rs:RegionInfo)
+#
+#                   The following tags are the width, height, and unit of the
+#                   image at the time of processing  when storing image region
+#                   metadata.  They are similar to the AppliedToDimensions tags
+#                   of the MWG regions.
+#                       ACDSeeRegionAppliedToDimensionsH : Height of the image
+#                       ACDSeeRegionAppliedToDimensionsUnit : Unit of the image
+#                       ACDSeeRegionAppliedToDimensionsW : Width of the image
+#
+#                   Actual region data, stored in an array.  These flattened tags
+#                   are treated as List Type tags.  There are two region types,
+#                   the ALYArea and the DLYArea.  The ALYArea tags tags assigned
+#                   by ACDSee and are usually square in dimensions.  The DLYArea
+#                   tags are both the tags assigned by ACDSee (but possibly
+#                   rectangular instead of square) as well as any  manual
+#                   assigned tags.  They are similar to the area tags of the MWG
+#                   regions.
+#                       ACDSeeRegionDLYAreaH : Height of DLY region
+#                       ACDSeeRegionDLYAreaW : Width of DLY region
+#                       ACDSeeRegionDLYAreaX : X centerpoint of DLY region
+#                       ACDSeeRegionDLYAreaY : Y centerpoint of DLY region
+#                       ACDSeeRegionALYAreaH : Height of ALY region
+#                       ACDSeeRegionALYAreaW : Width of ALY region
+#                       ACDSeeRegionALYAreaX : X centerpoint of ALY region
+#                       ACDSeeRegionALYAreaY : Y centerpoint of ALY region
+#                       ACDSeeRegionName : Name of region
+#                       ACDSeeRegionType : Type of region
+#                       ACDSeeRegionNameAssignType : How the type was assigned.
+#                                                    "Manual" is the only known
+#                                                    entry at this time
+#
+#               Conversion tags.  These tags can be used to convert other region
+#               type tags to ACDSee regions.
+#                   MPRegion2ACDSeeRegion : Converts a Microsoft RegionInfoMP
+#                   IPTCRegion2ACDSeeRegion : Converts an IPTC ImageRegion
+#                   MWGRegion2ACDSeeRegion : Converts a MWG RegionInfo
+#
+# Usage:        To set individual tags
+#               exiftool -config acdsee.config -ACDSEETAG=VALUE FILE ...
+#
+#               To convert Microsoft Regions to ACDSee regions
+#               exiftool -config acdsee.config "-RegionInfoACDSee<MPRegion2ACDSeeRegion" File ...
+#               To convert IPTC regions to ACDSee regions
+#               exiftool -config acdsee.config "-RegionInfoACDSee<IPTCRegion2ACDSeeRegion" File ...
+#               To convert MWG Regions to ACDSee regions
+#               exiftool -config acdsee.config "-RegionInfoACDSee<MWGRegion2ACDSeeRegion" File ...
 #
 # Requires:     ExifTool version 10.28 or later
 #
 # Revisions:    2020/01/28 - Bryan K. Williams (aka StarGeek) Created
+#               2021/04/08 - BKW Added tags to convert from Microsoft, IPTC,
+#                            and MWG regions to ACDSee regions based upon
+#                            convert_regions.config.  Expanded docs.
+#                            Shortened ADCSee tag names and added shortcuts
+#                            from original names to new names, for example
+#                            "RegionInfoACDSeeAppliedToDimensions*" -> "ACDSeeRegionAppliedToDimensions*"
+#                            "RegionInfoACDSeeRegionList* -> "ACDSeeRegion*"
 #------------------------------------------------------------------------------
+use Data::Dumper;
 
 my %sACDSeeDimensions = (
     STRUCT_NAME => 'ACDSee Dimensions',
     NAMESPACE   => {'acdsee-stDim' => 'http://ns.acdsee.com/sType/Dimensions#'},
-    'w'           => { Writable => 'real' },
-    'h'           => { Writable => 'real' },
-    'unit'        => { },
+    'w'         => { Writable => 'real' },
+    'h'         => { Writable => 'real' },
+    'unit'      => { },
 );
 
 my %sACDSeeArea = (
@@ -38,7 +94,7 @@ my %sACDSeeRegionStruct = (
 );
 
 %Image::ExifTool::UserDefined = (
-    # new XMP namespaces (eg. xxx) must be added to the Main XMP table:
+    # new XMP namespaces for ACDSee regions
     'Image::ExifTool::XMP::Main' => {
         'acdsee-rs' => { # <-- must be the same as the NAMESPACE prefix
             SubDirectory => { 
@@ -46,6 +102,112 @@ my %sACDSeeRegionStruct = (
             },
         },
     },
+    'Image::ExifTool::Composite' => {
+    # create an ACDSee RegionInfo structure from a Microsoft RegionInfoMP structure
+        MPRegion2ACDSeeRegion => {
+            Require => {
+                0 => 'RegionInfoMP',
+                1 => 'ImageWidth',
+                2 => 'ImageHeight',
+            },
+            ValueConv => q{
+                my ($rgn, @newRgns);
+                foreach $rgn (@{$val[0]{Regions}}) {
+                    my $name = $$rgn{PersonDisplayName};
+                    next unless $$rgn{Rectangle} or defined $name;
+                    my %newRgn = ( Type => 'Face' );
+                    if (defined $name) {
+                        # don't add ignored faces
+                        next if $name eq 'ffffffffffffffff';
+                        $newRgn{Name} = $name;
+                    }
+                    if ($$rgn{Rectangle}) {
+                        my @rect = split /\s*,\s*/, $$rgn{Rectangle};
+                        $newRgn{DLYArea} = {
+                            X => $rect[0] + $rect[2]/2,
+                            Y => $rect[1] + $rect[3]/2,
+                            W => $rect[2],
+                            H => $rect[3],
+                        } if @rect == 4;
+                    }
+                    push @newRgns, \%newRgn;
+                }
+                return {
+                    AppliedToDimensions => { W => $val[1], H => $val[2], Unit => 'pixel' },
+                    RegionList => \@newRgns,
+                };
+            },
+        },
+        # create an ACDSee RegionInfo structure from an IPTC ImageRegion list
+        IPTCRegion2ACDSeeRegion => {
+            Require => {
+                0 => 'ImageRegion',
+                1 => 'ImageWidth',
+                2 => 'ImageHeight',
+            },
+            ValueConv => q{
+                my ($rgn, @newRgns);
+                my $rgns = ref $val[0] eq 'ARRAY' ? $val[0] : [ $val[0] ]; 
+                foreach $rgn (@$rgns) {
+                    my %newRgn = ( Type => 'Face' );
+                    if ($$rgn{RegionBoundary} and $$rgn{RegionBoundary}{RbShape} eq 'rectangle') {
+                        my @rect = @{$$rgn{RegionBoundary}}{'RbX','RbY','RbW','RbH'};
+                        if ($$rgn{RegionBoundary}{RbUnit} eq 'pixel') {
+                            $rect[0] /= $val[1],  $rect[2] /= $val[1];
+                            $rect[1] /= $val[2];  $rect[3] /= $val[2];
+                        }
+                        $newRgn{'DLYArea'} = {
+                            X => $rect[0] + $rect[2]/2,
+                            Y => $rect[1] + $rect[3]/2,
+                            W => $rect[2],
+                            H => $rect[3],
+                        };
+                    } else {
+                        next unless defined $$rgn{Name};
+                    }
+                    $newRgn{Name} = $$rgn{Name} if defined $$rgn{Name};
+                    push @newRgns, \%newRgn;
+                }
+                return {
+                    AppliedToDimensions => { 'W' => $val[1], 'H' => $val[2], 'Unit' => 'pixel' },
+                    RegionList => \@newRgns,
+                };
+            },
+        },
+
+        # create an MWG RegionInfo structure from an IPTC ImageRegion list
+        MWGRegion2ACDSeeRegion => {
+            Require => {
+                0 => 'RegionInfo',
+                1 => 'ImageWidth',
+                2 => 'ImageHeight',
+            },
+            ValueConv => q{
+                my ($rgn, @newRgns);
+                my %newRgn;
+                foreach $rgn (@{$val[0]{RegionList}}) {
+                    next unless $$rgn{Area} or defined $$rgn{Name};
+                    my %newRgn;
+                    if ($$rgn{Area}) {
+                        $newRgn{'DLYArea'} = {
+                            'X' => $$rgn{Area}{'X'},
+                            'Y' => $$rgn{Area}{'Y'},
+                            'W' => $$rgn{Area}{'W'},
+                            'H' => $$rgn{Area}{'H'},
+                        };
+                    };
+                    $newRgn{Name} = $$rgn{Name} if defined $$rgn{Name};
+                    $newRgn{'Type'} = $$rgn{'Type'} if defined $$rgn{'Type'};
+                    push @newRgns, \%newRgn;
+                }
+                return {
+                    'AppliedToDimensions' => $val[0]{'AppliedToDimensions'},
+                    RegionList => \@newRgns,
+                }
+            },
+        },
+        ####
+    },
 );
 
 %Image::ExifTool::UserDefined::ACDSeeRegions = (
@@ -54,18 +216,43 @@ my %sACDSeeRegionStruct = (
     WRITABLE => 'string', # (default to string-type tags)
     Regions => {
         Name => 'RegionInfoACDSee',
+        FlatName => 'ACDSee',
         # the "Struct" entry defines the structure fields
         Struct => {
             # optional structure name (used for warning messages only)
             STRUCT_NAME => 'ACDSee RegionInfo',        
             RegionList => {
+                FlatName => 'Region',
                 Struct => \%sACDSeeRegionStruct,
                 List => 'Bag',
             },
-            AppliedToDimensions => { Struct => \%sACDSeeDimensions },
+            AppliedToDimensions => { 
+            FlatName => 'RegionAppliedToDimensions',Struct => \%sACDSeeDimensions },
         },
     },
 );
 
+# Shortcuts to old names added so as not to break previously used commands
+%Image::ExifTool::UserDefined::Shortcuts = (
+    RegionInfoACDSeeAppliedToDimensionsH        => 'ACDSeeRegionAppliedToDimensionsH',
+    RegionInfoACDSeeAppliedToDimensionsUnit     => 'ACDSeeRegionAppliedToDimensionsUnit',
+    RegionInfoACDSeeAppliedToDimensionsW        => 'ACDSeeRegionAppliedToDimensionsW',
+    RegionInfoACDSeeRegionListDLYAreaH          => 'ACDSeeRegionDLYAreaH',
+    RegionInfoACDSeeRegionListDLYAreaW          => 'ACDSeeRegionDLYAreaW',
+    RegionInfoACDSeeRegionListDLYAreaX          => 'ACDSeeRegionDLYAreaX',  
+    RegionInfoACDSeeRegionListDLYAreaY          => 'ACDSeeRegionDLYAreaY',
+    RegionInfoACDSeeRegionListALGAreaH          => 'ACDSeeRegionALGAreaH',
+    RegionInfoACDSeeRegionListALGAreaW          => 'ACDSeeRegionALGAreaW',
+    RegionInfoACDSeeRegionListALGAreaX          => 'ACDSeeRegionALGAreaX',
+    RegionInfoACDSeeRegionListALGAreaY          => 'ACDSeeRegionALGAreaY',
+    RegionInfoACDSeeRegionListName              => 'ACDSeeRegionName',
+    RegionInfoACDSeeRegionListType              => 'ACDSeeRegionType',
+    RegionInfoACDSeeRegionListNameAssignType    => 'ACDSeeRegionNameAssignType',
+);
+
+# Forced -struct option during debugging
+#%Image::ExifTool::UserDefined::Options = (
+#   Struct => 1,
+#);
 #------------------------------------------------------------------------------
 1;  #end