exiftool_vendored 11.71.0 → 11.75.0

data/bin/lib/Image/ExifTool/TagNames.pod

@@ -12,7 +12,7 @@ meta information extracted from or written to a file.
 =head1 TAG TABLES
 
 The tables listed below give the names of all tags recognized by ExifTool.
-They contain a total of 23036 tags, with 15080 unique tag names.
+They contain a total of 23164 tags, with 15143 unique tag names.
 
 B<Tag ID>, B<Index#> or B<Sequence> is given in the first column of each
 table.  A B<Tag ID> is the computer-readable equivalent of a tag name, and
@@ -317,8 +317,8 @@ other tags which are not part of the EXIF specification, but may co-exist
 with EXIF tags in some images.  Tags which are part of the EXIF 2.32
 specification have an underlined B<Tag Name> in the HTML version of this
 documentation.  See
-L<http://www.cipa.jp/std/documents/download_e.html?DC-008-Translation-2019-E> for the
-official EXIF 2.32 specification.
+L<https://web.archive.org/web/20190624045241if_/http://www.cipa.jp:80/std/documents/e/DC-008-Translation-2019-E.pdf>
+for the official EXIF 2.32 specification.
 
   Tag ID   Tag Name                  Group      Writable
   ------   --------                  -----      --------
@@ -683,7 +683,6 @@ official EXIF 2.32 specification.
            MakerNoteSanyoC4          ExifIFD    Sanyo
            MakerNoteSanyoPatch       ExifIFD    Sanyo
            MakerNoteSigma            ExifIFD    Sigma
-           MakerNoteSigma3           ExifIFD    Sigma
            MakerNoteSony             ExifIFD    Sony
            MakerNoteSony2            ExifIFD    Olympus
            MakerNoteSony3            ExifIFD    Olympus
@@ -880,9 +879,9 @@ official EXIF 2.32 specification.
   0xc71f   RowInterleaveFactor       -          no
   0xc725   ProfileLookTableDims      IFD0       int32u[3]!
   0xc726   ProfileLookTableData      IFD0       float[n]!
-  0xc740   OpcodeList1               SubIFD     undef~!
-  0xc741   OpcodeList2               SubIFD     undef~!
-  0xc74e   OpcodeList3               SubIFD     undef~!
+  0xc740   OpcodeList1               SubIFD     undef!
+  0xc741   OpcodeList2               SubIFD     undef!
+  0xc74e   OpcodeList3               SubIFD     undef!
   0xc761   NoiseProfile              SubIFD     double[n]!
   0xc763   TimeCodes                 IFD0       int8u[n]
   0xc764   FrameRate                 IFD0       rational64s
@@ -2437,8 +2436,8 @@ These tags belong to the ExifTool XMP-digiKam family 1 group.
 =head3 XMP exif Tags
 
 EXIF namespace for EXIF tags.  See
-L<http://www.cipa.jp/std/documents/e/DC-010-2017_E.pdf> for the
-specification.
+L<https://web.archive.org/web/20180921145139if_/http://www.cipa.jp:80/std/documents/e/DC-010-2017_E.pdf>
+for the specification.
 
 These tags belong to the ExifTool XMP-exif family 1 group.
 
@@ -2926,9 +2925,9 @@ These tags belong to the ExifTool XMP-iptcCore family 1 group.
 
 =head3 XMP iptcExt Tags
 
-IPTC Extension namespace tags.  The actual namespace prefix is
-"Iptc4xmpExt", but ExifTool shortens this for the family 1 group name. (see
-L<http://www.iptc.org/IPTC4XMP/>)
+This table contains tags defined by the IPTC Extension schema version 1.5.
+The actual namespace prefix is "Iptc4xmpExt", but ExifTool shortens this for
+the family 1 group name. (see L<http://www.iptc.org/IPTC4XMP/>)
 
 These tags belong to the ExifTool XMP-iptcExt family 1 group.
 
@@ -3012,6 +3011,26 @@ These tags belong to the ExifTool XMP-iptcExt family 1 group.
   GenreCvTermName                               lang-alt_+
   GenreCvTermRefinedAbout                       string_+
   Headline                                      lang-alt/
+  ImageRegion                                   ImageRegion Struct+
+  ImageRegionName                               lang-alt_+
+  ImageRegionCtype                              Entity Struct_+
+  ImageRegionCtypeIdentifier                    string_+
+  ImageRegionCtypeName                          lang-alt_+
+  ImageRegionBoundary                           RegionBoundary Struct_+
+  ImageRegionBoundaryH                          real_+
+  ImageRegionBoundaryRx                         real_+
+  ImageRegionBoundaryShape                      string_+
+  ImageRegionBoundaryUnit                       string_+
+  ImageRegionBoundaryVertices                   BoundaryPoint Struct_+
+  ImageRegionBoundaryVerticesX                  real_+
+  ImageRegionBoundaryVerticesY                  real_+
+  ImageRegionBoundaryW                          real_+
+  ImageRegionBoundaryX                          real_+
+  ImageRegionBoundaryY                          real_+
+  ImageRegionID                                 string_+
+  ImageRegionRole                               Entity Struct_+
+  ImageRegionRoleIdentifier                     string_+
+  ImageRegionRoleName                           lang-alt_+
   IPTCLastEdited                                date
   LinkedEncRightsExpr                           LEREDetails Struct+
   LinkedEncodedRightsExpr                       string_+
@@ -3074,7 +3093,7 @@ These tags belong to the ExifTool XMP-iptcExt family 1 group.
   PublicationEventIdentifier                    string_+
   PublicationEventName                          string_+
   Rating                                        Rating Struct+
-  RatingRatingRegion                            LocationDetails Struct_+
+  RatingRegion                                  LocationDetails Struct_+
   RatingRegionCity                              string_+
   RatingRegionCountryCode                       string_+
   RatingRegionCountryName                       string_+
@@ -3236,6 +3255,41 @@ These tags belong to the ExifTool XMP-iptcExt family 1 group.
   Name                                          string
   Number                                        string
 
+=head3 XMP ImageRegion Struct
+
+As well as the fields defined below, this structure may contain any
+top-level XMP tags, but since they aren't pre-defined the only way to add
+these tags is to write ImageRegion as a structure with these tags as new
+fields.
+
+  Field Name                                    Writable
+  ----------                                    --------
+  Name                                          lang-alt
+  RegionBoundary                                RegionBoundary Struct
+  RCtype                                        Entity Struct+
+  RId                                           string
+  RRole                                         Entity Struct+
+
+=head3 XMP RegionBoundary Struct
+
+  Field Name                                    Writable
+  ----------                                    --------
+  RbH                                           real
+  RbRx                                          real
+  RbShape                                       string
+  RbUnit                                        string
+  RbVertices                                    BoundaryPoint Struct+
+  RbW                                           real
+  RbX                                           real
+  RbY                                           real
+
+=head3 XMP BoundaryPoint Struct
+
+  Field Name                                    Writable
+  ----------                                    --------
+  RbX                                           real
+  RbY                                           real
+
 =head3 XMP LEREDetails Struct
 
   Field Name                                    Writable
@@ -3810,8 +3864,8 @@ These tags belong to the ExifTool XMP-swf family 1 group.
 =head3 XMP tiff Tags
 
 EXIF namespace for TIFF tags.  See
-L<http://www.cipa.jp/std/documents/e/DC-010-2017_E.pdf> for the
-specification.
+L<https://web.archive.org/web/20180921145139if_/http://www.cipa.jp:80/std/documents/e/DC-010-2017_E.pdf>
+for the specification.
 
 These tags belong to the ExifTool XMP-tiff family 1 group.
 
@@ -4335,6 +4389,7 @@ These tags belong to the ExifTool XMP-xmpMM family 1 group.
   ManifestReferenceVersionID                    string_+
   OriginalDocumentID                            string
   Pantry                                        PantryItem Struct+
+  PantryInstanceID                              string_+
   PreservedFileName                             string
   RenditionClass                                string
   RenditionOf                                   ResourceRef Struct
@@ -7873,6 +7928,7 @@ well as newer tags and values added by later models.
   0x0813   DefaultEraseOption                   int32s
   0x0814   RetractLensOnPowerOff                int32s
   0x0815   AddIPTCInformation                   int32s
+  0x0816   AudioCompression                     int32s
 
 =head2 CanonVRD Tags
 
@@ -16334,6 +16390,8 @@ are less than consistent about their metadata formats.
   0x0024   Calibration                          string
   0x0026   FileFormat                           string
   0x0027   LensType                             string
+           LensType                             -
+                                                Sigma LensType
   0x002a   LensFocalRange                       rational64u[2]
   0x002b   LensMaxApertureRange                 rational64u[2]
   0x002c   ColorMode                            int32u
@@ -16356,10 +16414,14 @@ are less than consistent about their metadata formats.
   0x004d   ExposureCompensation                 rational64s
   0x0055   SensorTemperature                    string
   0x0056   FlashExposureComp                    rational64s
-  0x0057   Firmware                             string
+  0x0057   Firmware2                            string
   0x0058   WhiteBalance                         string
   0x0059   DigitalFilter                        string
   0x0084   Model                                string
+  0x0086   ISO                                  int16u
+  0x0087   ResolutionMode                       string
+  0x0088   WhiteBalance                         string
+  0x008c   Firmware                             string
 
 =head2 Sony Tags
 
@@ -18250,7 +18312,6 @@ still proprietary) Adobe format.
            MakerNoteSanyoC4                     Sanyo
            MakerNoteSanyoPatch                  Sanyo
            MakerNoteSigma                       Sigma
-           MakerNoteSigma3                      Sigma
            MakerNoteSony                        Sony
            MakerNoteSony2                       Olympus
            MakerNoteSony3                       Olympus
@@ -24602,9 +24663,15 @@ the ExtractEmbedded option is used.
   Tag Name                                      Writable
   --------                                      --------
   Accelerometer                                 no
+  AccelerometerData                             no
   AngularVelocity                               no
   CTMD                                          Canon CTMD
   CameraDateTime                                no
+  Car                                           no
+  Distance                                      no
+  ExposureCompensation                          no
+  ExposureTime                                  no
+  FNumber                                       no
   FrameNumber                                   no
   GPSAltitude                                   no
   GPSDOP                                        no
@@ -24617,7 +24684,9 @@ the ExtractEmbedded option is used.
   GPSTimeStamp                                  no
   GPSTrack                                      no
   GPSTrackRef                                   no
+  GSensor                                       no
   INSV                                          QuickTime INSV_MakerNotes
+  ISO                                           no
   JpgFromRaw                                    no
   PreviewInfo                                   QuickTime PreviewInfo
   RVMI_gReV                                     QuickTime RVMI_gReV
@@ -24632,6 +24701,7 @@ the ExtractEmbedded option is used.
   Unknown02?                                    no
   Unknown03?                                    no
   UserLabel                                     no
+  VerticalSpeed                                 no
   camm0                                         QuickTime camm0
   camm1                                         QuickTime camm1
   camm2                                         QuickTime camm2
@@ -24643,6 +24713,7 @@ the ExtractEmbedded option is used.
   fdsc                                          GoPro fdsc
   gpmd                                          GoPro GPMF
   mebx                                          QuickTime Keys
+  mett                                          Parrot mett
   rtmd                                          Sony rtmd
   tx3g                                          QuickTime tx3g
 
@@ -25917,6 +25988,149 @@ Tags used in QTIF QuickTime Image Files.
   'idsc'   ImageDescription                     QuickTime ImageDesc
   'iicc'   ICC_Profile                          ICC_Profile
 
+=head2 Parrot Tags
+
+=head3 Parrot mett Tags
+
+Streaming metadata found in Parrot drone videos. See
+L<https://developer.parrot.com/docs/pdraw/metadata.html> for the
+specification.
+
+  Tag ID   Tag Name                             Writable
+  ------   --------                             --------
+  'P1'     ParrotV1                             Parrot V1
+  'P2'     ParrotV2                             Parrot V2
+  'P3'     ParrotV3                             Parrot V3
+  'E1'     ParrotTimeStamp                      Parrot TimeStamp
+  'E2'     ParrotFollowMe                       Parrot FollowMe
+  'E3'     ParrotAutomation                     Parrot Automation
+
+=head3 Parrot V1 Tags
+
+Parrot version 1 streaming metadata.
+
+  Index1   Tag Name                             Writable
+  ------   --------                             --------
+      4    DroneYaw                             no
+      6    DronePitch                           no
+      8    DroneRoll                            no
+     10    CameraPan                            no
+     12    CameraTilt                           no
+     14    FrameView                            no
+     22    ExposureTime                         no
+     24    ISO                                  no
+     26    WifiRSSI                             no
+     27    Battery                              no
+     28    GPSLatitude                          no
+     32    GPSLongitude                         no
+     36    GPSAltitude                          no
+   36.1    GPSSatellites                        no
+     40    AltitudeFromTakeOff                  no
+     44    DistanceFromHome                     no
+     48    SpeedX                               no
+     50    SpeedY                               no
+     52    SpeedZ                               no
+     54    Binning                              no
+   54.1    FlyingState                          no
+     55    Animation                            no
+   55.1    PilotingMode                         no
+
+=head3 Parrot V2 Tags
+
+Parrot version 2 basic streaming metadata.
+
+  Index1   Tag Name                             Writable
+  ------   --------                             --------
+      4    Elevation                            no
+      8    GPSLatitude                          no
+     12    GPSLongitude                         no
+     16    GPSAltitude                          no
+   16.1    GPSSatellites                        no
+     20    GPSVelocityNorth                     no
+     22    GPSVelocityEast                      no
+     24    GPSVelocityDown                      no
+     26    AirSpeed                             no
+     28    DroneQuaternion                      no
+     36    FrameView                            no
+     44    CameraPan                            no
+     46    CameraTilt                           no
+     48    ExposureTime                         no
+     50    ISO                                  no
+     52    Binning                              no
+   52.1    FlyingState                          no
+     53    Animation                            no
+   53.1    PilotingMode                         no
+     54    WifiRSSI                             no
+     55    Battery                              no
+  'Groups' Groups                               no
+
+=head3 Parrot V3 Tags
+
+Parrot version 3 basic streaming metadata.
+
+  Index1   Tag Name                             Writable
+  ------   --------                             --------
+      4    Elevation                            no
+      8    GPSLatitude                          no
+     12    GPSLongitude                         no
+     16    GPSAltitude                          no
+   16.1    GPSSatellites                        no
+     20    GPSVelocityNorth                     no
+     22    GPSVelocityEast                      no
+     24    GPSVelocityDown                      no
+     26    AirSpeed                             no
+     28    DroneQuaternion                      no
+     36    FrameBaseView                        no
+     44    FrameView                            no
+     52    ExposureTime                         no
+     54    ISO                                  no
+     56    RedBalance                           no
+     58    BlueBalance                          no
+     60    FOV                                  no
+     64    LinkGoodput                          no
+   64.1    LinkQuality                          no
+     68    WifiRSSI                             no
+     69    Battery                              no
+     70    Binning                              no
+   70.1    FlyingState                          no
+     71    Animation                            no
+   71.1    PilotingMode                         no
+
+=head3 Parrot TimeStamp Tags
+
+Parrot streaming metadata timestamp extension.
+
+  Index1   Tag Name                             Writable
+  ------   --------                             --------
+      4    TimeStamp                            no
+
+=head3 Parrot FollowMe Tags
+
+Parrot streaming metadata follow-me extension.
+
+  Index1   Tag Name                             Writable
+  ------   --------                             --------
+      4    GPSTargetLatitude                    no
+      8    GPSTargetLongitude                   no
+     12    GPSTargetAltitude                    no
+     16    Follow-meMode                        no
+     17    Follow-meAnimation                   no
+
+=head3 Parrot Automation Tags
+
+Parrot streaming metadata automation extension.
+
+  Index1   Tag Name                             Writable
+  ------   --------                             --------
+      4    GPSFramingLatitude                   no
+      8    GPSFramingLongitude                  no
+     12    GPSFramingAltitude                   no
+     16    GPSDestLatitude                      no
+     20    GPSDestLongitude                     no
+     24    GPSDestAltitude                      no
+     28    AutomationAnimation                  no
+     29    AutomationFlags                      no
+
 =head2 PLIST Tags
 
 Apple Property List tags.  ExifTool reads both XML and binary-format PLIST
@@ -33012,6 +33226,21 @@ name.  See L<http://tools.ietf.org/html/rfc5545> for the official iCalendar
   'X-wr-relcalid'       CalendarID              no
   'X-wr-timezone'       TimeZone2               no
 
+=head2 Text Tags
+
+Although basic text files contain no metadata, the following tags are
+determined from a simple analysis of the text data.  LineCount and WordCount
+are generated only for 8-bit character sets if the FastScan option is not
+used.
+
+  Tag Name                                      Writable
+  --------                                      --------
+  ByteOrderMark                                 no
+  LineCount                                     no
+  MIMEEncoding                                  no
+  Newlines                                      no
+  WordCount                                     no
+
 =head2 RSRC Tags
 
 Tags extracted from Mac OS resource files and DFONT files.  These tags may
@@ -33656,6 +33885,9 @@ values, may created via the ExifTool configuration file.
   GPSAltitudeRef       QuickTime:LocationInformation no
   GPSDateTime          GPS:GPSDateStamp         no
                        GPS:GPSTimeStamp
+  GPSDateTime          Parrot:GPSLatitude       no
+                       Main:CreateDate
+                       SampleTime
   GPSDestLatitude      GPS:GPSDestLatitude      no
                        GPS:GPSDestLatitudeRef
   GPSDestLatitudeRef   XMP-exif:GPSDestLatitude no
@@ -34033,7 +34265,6 @@ for more details.
                        MakerNoteSanyoC4
                        MakerNoteSanyoPatch
                        MakerNoteSigma
-                       MakerNoteSigma3
                        MakerNoteSony
                        MakerNoteSony2
                        MakerNoteSony3

data/bin/lib/Image/ExifTool/Text.pm

@@ -0,0 +1,160 @@
+#------------------------------------------------------------------------------
+# File:         Text.pm
+#
+# Description:  Deduce characteristics of a text file
+#
+# Revisions:    2019-11-01 - P. Harvey Created
+#
+# References:   1) https://github.com/file/file
+#------------------------------------------------------------------------------
+
+package Image::ExifTool::Text;
+
+use strict;
+use vars qw($VERSION);
+use Image::ExifTool qw(:DataAccess :Utils);
+use Image::ExifTool::XMP;
+
+$VERSION = '1.00';
+
+# Text tags
+%Image::ExifTool::Text::Main = (
+    VARS => { NO_ID => 1 },
+    GROUPS => { 0 => 'File', 1 => 'File', 2 => 'Document' },
+    NOTES => q{
+        Although basic text files contain no metadata, the following tags are
+        determined from a simple analysis of the text data.  LineCount and WordCount
+        are generated only for 8-bit character sets if the FastScan option is not
+        used.
+    },
+    MIMEEncoding => { Groups => { 2 => 'Other' } },
+    Newlines => {
+        PrintConv => {
+            "\r\n" => 'Windows CRLF',
+            "\r"   => 'Macintosh CR',
+            "\n"   => 'Unix LF',
+            ''     => '(none)',
+        },
+    },
+    ByteOrderMark => { PrintConv => { 0 => 'No', 1 => 'Yes' } },
+    LineCount => { },
+    WordCount => { },
+);
+
+#------------------------------------------------------------------------------
+# Extract some stats from a text file
+# Inputs: 0) ExifTool ref, 1) dirInfo ref
+# Returns: 1 on success, 0 if this wasn't a text file
+sub ProcessTXT($$)
+{
+    my ($et, $dirInfo) = @_;
+    my $dataPt = $$dirInfo{TestBuff};
+    my $fast = $et->Options('FastScan') || 0;
+    my ($buff, $enc, $isBOM);
+    my $nl = '';
+
+    return 0 unless length $$dataPt; # can't call it a text file if it has no text
+
+    if ($$dataPt =~ /[\0-\x06\x0e-\x1f\x7f\xff]/) {
+        # file contains weird control characters, could be multi-byte Unicode
+        if ($$dataPt =~ /^(\xff\xfe\0\0|\0\0\xfe\xff)/) {
+            if ($1 eq "\xff\xfe\0\0") {
+                $enc = 'utf-32le';
+                $nl = $1 if $$dataPt =~ /(\r\0\0\0\n|\r|\n)\0\0\0/;
+            } else {
+                $enc = 'utf-32be';
+                $nl = $1 if $$dataPt =~ /\0\0\0(\r\0\0\0\n|\r|\n)/;
+            }
+        } elsif ($$dataPt =~ /^(\xff\xfe|\xfe\xff)/) {
+            if ($1 eq "\xff\xfe") {
+                $enc = 'utf-16le';
+                $nl = $1 if $$dataPt =~ /(\r\0\n|\r|\n)\0/;
+            } else {
+                $enc = 'utf-16be';
+                $nl = $1 if $$dataPt =~ /\0(\r\0\n|\r|\n)/;
+            }
+        } else {
+            return 0;       # probably not a text file
+        }
+        $nl =~ tr/\0//d;    # remove nulls from newline sequence
+        $isBOM = 1;         # (we don't recognize UTF-16/UTF-32 without one)
+    } else {
+        if ($$dataPt !~ /[\x80-\xff]/) {
+            $enc = 'us-ascii';
+        } elsif (Image::ExifTool::XMP::IsUTF8($dataPt,1) > 0) {
+            $enc = 'utf-8';
+            $isBOM = ($$dataPt =~ /^\xef\xbb\xbf/ ? 1 : 0);
+        } elsif ($$dataPt !~ /[\x80-\x9f]/) {
+            $enc = 'iso-8859-1';
+        } else {
+            $enc = 'unknown-8bit';
+        }
+        $nl = $1 if $$dataPt =~ /(\r\n|\r|\n)/;
+    }
+    
+    my $tagTablePtr = GetTagTable('Image::ExifTool::Text::Main');
+    $et->SetFileType();
+    $et->HandleTag($tagTablePtr, MIMEEncoding => $enc);
+    return 1 if $fast == 3;
+    $et->HandleTag($tagTablePtr, ByteOrderMark => $isBOM) if defined $isBOM;
+    $et->HandleTag($tagTablePtr, Newlines => $nl);
+    unless ($enc =~ /^utf-(16|32)/ or $fast) {
+        my $raf = $$dirInfo{RAF};
+        my ($lines, $words) = (0, 0);
+        my $oldNL = $/;
+        $/ = $nl if $nl;
+        while ($raf->ReadLine($buff)) {
+            if (not $nl and $buff =~ /(\r\n|\r|\n)$/) {
+                # (the first line must have been longer than 1024 characters)
+                $$et{VALUE}{Newlines} = $nl = $1;
+            }
+            ++$lines;
+            ++$words while $buff =~ /\S+/g;
+        }
+        $/ = $oldNL;
+        $et->HandleTag($tagTablePtr, LineCount => $lines);
+        $et->HandleTag($tagTablePtr, WordCount => $words);
+    }
+    return 1;
+}
+
+
+1;  # end
+
+__END__
+
+=head1 NAME
+
+Image::ExifTool::Text - Read Text meta information
+
+=head1 SYNOPSIS
+
+This module is used by Image::ExifTool
+
+=head1 DESCRIPTION
+
+This module contains definitions required by Image::ExifTool to deduce some
+characteristics of Text files.
+
+=head1 AUTHOR
+
+Copyright 2003-2019, Phil Harvey (phil at owl.phy.queensu.ca)
+
+This library is free software; you can redistribute it and/or modify it
+under the same terms as Perl itself.
+
+=head1 REFERENCES
+
+=over 4
+
+=item L<https://github.com/file/file>
+
+=back
+
+=head1 SEE ALSO
+
+L<Image::ExifTool::TagNames/Text Tags>,
+L<Image::ExifTool(3pm)|Image::ExifTool>
+
+=cut
+