XMPInfo.php

Go to the documentation of this file.

<?php
class XMPInfo {
    public static function getItems() {
        return self::$items;
    }
 
    static private $items = [
        'http://ns.adobe.com/exif/1.0/' => [
            'ApertureValue' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational'
            ],
            'BrightnessValue' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational'
            ],
            'CompressedBitsPerPixel' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational'
            ],
            'DigitalZoomRatio' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational'
            ],
            'ExposureBiasValue' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational'
            ],
            'ExposureIndex' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational'
            ],
            'ExposureTime' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational'
            ],
            'FlashEnergy' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational',
            ],
            'FNumber' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational'
            ],
            'FocalLength' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational'
            ],
            'FocalPlaneXResolution' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational'
            ],
            'FocalPlaneYResolution' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational'
            ],
            'GPSAltitude' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational',
            ],
            'GPSDestBearing' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational'
            ],
            'GPSDestDistance' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational'
            ],
            'GPSDOP' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational'
            ],
            'GPSImgDirection' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational'
            ],
            'GPSSpeed' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational'
            ],
            'GPSTrack' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational'
            ],
            'MaxApertureValue' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational'
            ],
            'ShutterSpeedValue' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational'
            ],
            'SubjectDistance' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational'
            ],
            /* Flash */
            'Flash' => [
                'mode' => XMPReader::MODE_STRUCT,
                'children' => [
                    'Fired' => true,
                    'Function' => true,
                    'Mode' => true,
                    'RedEyeMode' => true,
                    'Return' => true,
                ],
                'validate' => 'validateFlash',
                'map_group' => 'exif',
            ],
            'Fired' => [
                'map_group' => 'exif',
                'validate' => 'validateBoolean',
                'mode' => XMPReader::MODE_SIMPLE,
                'structPart' => true,
            ],
            'Function' => [
                'map_group' => 'exif',
                'validate' => 'validateBoolean',
                'mode' => XMPReader::MODE_SIMPLE,
                'structPart' => true,
            ],
            'Mode' => [
                'map_group' => 'exif',
                'validate' => 'validateClosed',
                'mode' => XMPReader::MODE_SIMPLE,
                'choices' => [ '0' => true, '1' => true,
                    '2' => true, '3' => true ],
                'structPart' => true,
            ],
            'Return' => [
                'map_group' => 'exif',
                'validate' => 'validateClosed',
                'mode' => XMPReader::MODE_SIMPLE,
                'choices' => [ '0' => true,
                    '2' => true, '3' => true ],
                'structPart' => true,
            ],
            'RedEyeMode' => [
                'map_group' => 'exif',
                'validate' => 'validateBoolean',
                'mode' => XMPReader::MODE_SIMPLE,
                'structPart' => true,
            ],
            /* End Flash */
            'ISOSpeedRatings' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SEQ,
                'validate' => 'validateInteger'
            ],
            /* end rational things */
            'ColorSpace' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ '1' => true, '65535' => true ],
            ],
            'ComponentsConfiguration' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SEQ,
                'validate' => 'validateClosed',
                'choices' => [ '1' => true, '2' => true, '3' => true, '4' => true,
                    '5' => true, '6' => true ]
            ],
            'Contrast' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ '0' => true, '1' => true, '2' => true ]
            ],
            'CustomRendered' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ '0' => true, '1' => true ]
            ],
            'DateTimeOriginal' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateDate',
            ],
            'DateTimeDigitized' => [ /* xmp:CreateDate */
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateDate',
            ],
            /* todo: there might be interesting information in
             * exif:DeviceSettingDescription, but need to find an
             * example
             */
            'ExifVersion' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'ExposureMode' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'rangeLow' => 0,
                'rangeHigh' => 2,
            ],
            'ExposureProgram' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'rangeLow' => 0,
                'rangeHigh' => 8,
            ],
            'FileSource' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ '3' => true ]
            ],
            'FlashpixVersion' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'FocalLengthIn35mmFilm' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateInteger',
            ],
            'FocalPlaneResolutionUnit' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ '2' => true, '3' => true ],
            ],
            'GainControl' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'rangeLow' => 0,
                'rangeHigh' => 4,
            ],
            /* this value is post-processed out later */
            'GPSAltitudeRef' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ '0' => true, '1' => true ],
            ],
            'GPSAreaInformation' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'GPSDestBearingRef' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ 'T' => true, 'M' => true ],
            ],
            'GPSDestDistanceRef' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ 'K' => true, 'M' => true,
                    'N' => true ],
            ],
            'GPSDestLatitude' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateGPS',
            ],
            'GPSDestLongitude' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateGPS',
            ],
            'GPSDifferential' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ '0' => true, '1' => true ],
            ],
            'GPSImgDirectionRef' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ 'T' => true, 'M' => true ],
            ],
            'GPSLatitude' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateGPS',
            ],
            'GPSLongitude' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateGPS',
            ],
            'GPSMapDatum' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'GPSMeasureMode' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ '2' => true, '3' => true ]
            ],
            'GPSProcessingMethod' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'GPSSatellites' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'GPSSpeedRef' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ 'K' => true, 'M' => true,
                    'N' => true ],
            ],
            'GPSStatus' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ 'A' => true, 'V' => true ]
            ],
            'GPSTimeStamp' => [
                'map_group' => 'exif',
                // Note: in exif, GPSDateStamp does not include
                // the time, where here it does.
                'map_name' => 'GPSDateStamp',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateDate',
            ],
            'GPSTrackRef' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ 'T' => true, 'M' => true ]
            ],
            'GPSVersionID' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'ImageUniqueID' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'LightSource' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                /* can't use a range, as it skips... */
                'choices' => [ '0' => true, '1' => true,
                    '2' => true, '3' => true, '4' => true,
                    '9' => true, '10' => true, '11' => true,
                    '12' => true, '13' => true,
                    '14' => true, '15' => true,
                    '17' => true, '18' => true,
                    '19' => true, '20' => true,
                    '21' => true, '22' => true,
                    '23' => true, '24' => true,
                    '255' => true,
                ],
            ],
            'MeteringMode' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'rangeLow' => 0,
                'rangeHigh' => 6,
                'choices' => [ '255' => true ],
            ],
            /* Pixel(X|Y)Dimension are rather useless, but for
             * completeness since we do it with exif.
             */
            'PixelXDimension' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateInteger',
            ],
            'PixelYDimension' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateInteger',
            ],
            'Saturation' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'rangeLow' => 0,
                'rangeHigh' => 2,
            ],
            'SceneCaptureType' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'rangeLow' => 0,
                'rangeHigh' => 3,
            ],
            'SceneType' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ '1' => true ],
            ],
            // Note, 6 is not valid SensingMethod.
            'SensingMethod' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'rangeLow' => 1,
                'rangeHigh' => 5,
                'choices' => [ '7' => true, 8 => true ],
            ],
            'Sharpness' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'rangeLow' => 0,
                'rangeHigh' => 2,
            ],
            'SpectralSensitivity' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            // This tag should perhaps be displayed to user better.
            'SubjectArea' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SEQ,
                'validate' => 'validateInteger',
            ],
            'SubjectDistanceRange' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'rangeLow' => 0,
                'rangeHigh' => 3,
            ],
            'SubjectLocation' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SEQ,
                'validate' => 'validateInteger',
            ],
            'UserComment' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_LANG,
            ],
            'WhiteBalance' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ '0' => true, '1' => true ]
            ],
        ],
        'http://ns.adobe.com/tiff/1.0/' => [
            'Artist' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'BitsPerSample' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SEQ,
                'validate' => 'validateInteger',
            ],
            'Compression' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ '1' => true, '6' => true ],
            ],
            /* this prop should not be used in XMP. dc:rights is the correct prop */
            'Copyright' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_LANG,
            ],
            'DateTime' => [ /* proper prop is xmp:ModifyDate */
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateDate',
            ],
            'ImageDescription' => [ /* proper one is dc:description */
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_LANG,
            ],
            'ImageLength' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateInteger',
            ],
            'ImageWidth' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateInteger',
            ],
            'Make' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'Model' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            /**** Do not extract this property
             * It interferes with auto exif rotation.
             * 'Orientation'       => array(
             *    'map_group' => 'exif',
             *    'mode'      => XMPReader::MODE_SIMPLE,
             *    'validate'  => 'validateClosed',
             *    'choices'   => array( '1' => true, '2' => true, '3' => true, '4' => true, 5 => true,
             *            '6' => true, '7' => true, '8' => true ),
             *),
             ******/
            'PhotometricInterpretation' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ '2' => true, '6' => true ],
            ],
            'PlanerConfiguration' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ '1' => true, '2' => true ],
            ],
            'PrimaryChromaticities' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SEQ,
                'validate' => 'validateRational',
            ],
            'ReferenceBlackWhite' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SEQ,
                'validate' => 'validateRational',
            ],
            'ResolutionUnit' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ '2' => true, '3' => true ],
            ],
            'SamplesPerPixel' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateInteger',
            ],
            'Software' => [ /* see xmp:CreatorTool */
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            /* ignore TransferFunction */
            'WhitePoint' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SEQ,
                'validate' => 'validateRational',
            ],
            'XResolution' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational',
            ],
            'YResolution' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRational',
            ],
            'YCbCrCoefficients' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SEQ,
                'validate' => 'validateRational',
            ],
            'YCbCrPositioning' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateClosed',
                'choices' => [ '1' => true, '2' => true ],
            ],
            /********
             * Disable extracting this property (T33944)
             * Several files have a string instead of a Seq
             * for this property. XMPReader doesn't handle
             * mismatched types very gracefully (it marks
             * the entire file as invalid, instead of just
             * the relavent prop). Since this prop
             * doesn't communicate all that useful information
             * just disable this prop for now, until such
             * XMPReader is more graceful (T34172)
             * 'YCbCrSubSampling'  => array(
             *    'map_group' => 'exif',
             *    'mode'      => XMPReader::MODE_SEQ,
             *    'validate'  => 'validateClosed',
             *    'choices'   => array( '1' => true, '2' => true ),
             * ),
             */
        ],
        'http://ns.adobe.com/exif/1.0/aux/' => [
            'Lens' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'SerialNumber' => [
                'map_group' => 'exif',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'OwnerName' => [
                'map_group' => 'exif',
                'map_name' => 'CameraOwnerName',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
        ],
        'http://purl.org/dc/elements/1.1/' => [
            'title' => [
                'map_group' => 'general',
                'map_name' => 'ObjectName',
                'mode' => XMPReader::MODE_LANG
            ],
            'description' => [
                'map_group' => 'general',
                'map_name' => 'ImageDescription',
                'mode' => XMPReader::MODE_LANG
            ],
            'contributor' => [
                'map_group' => 'general',
                'map_name' => 'dc-contributor',
                'mode' => XMPReader::MODE_BAG
            ],
            'coverage' => [
                'map_group' => 'general',
                'map_name' => 'dc-coverage',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'creator' => [
                'map_group' => 'general',
                'map_name' => 'Artist', // map with exif Artist, iptc byline (2:80)
                'mode' => XMPReader::MODE_SEQ,
            ],
            'date' => [
                'map_group' => 'general',
                // Note, not mapped with other date properties, as this type of date is
                // non-specific: "A point or period of time associated with an event in
                //  the lifecycle of the resource"
                'map_name' => 'dc-date',
                'mode' => XMPReader::MODE_SEQ,
                'validate' => 'validateDate',
            ],
            /* Do not extract dc:format, as we've got better ways to determine MIME type */
            'identifier' => [
                'map_group' => 'deprecated',
                'map_name' => 'Identifier',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'language' => [
                'map_group' => 'general',
                'map_name' => 'LanguageCode', /* mapped with iptc 2:135 */
                'mode' => XMPReader::MODE_BAG,
                'validate' => 'validateLangCode',
            ],
            'publisher' => [
                'map_group' => 'general',
                'map_name' => 'dc-publisher',
                'mode' => XMPReader::MODE_BAG,
            ],
            // for related images/resources
            'relation' => [
                'map_group' => 'general',
                'map_name' => 'dc-relation',
                'mode' => XMPReader::MODE_BAG,
            ],
            'rights' => [
                'map_group' => 'general',
                'map_name' => 'Copyright',
                'mode' => XMPReader::MODE_LANG,
            ],
            // Note: source is not mapped with iptc source, since iptc
            // source describes the source of the image in terms of a person
            // who provided the image, where this is to describe an image that the
            // current one is based on.
            'source' => [
                'map_group' => 'general',
                'map_name' => 'dc-source',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'subject' => [
                'map_group' => 'general',
                'map_name' => 'Keywords', /* maps to iptc 2:25 */
                'mode' => XMPReader::MODE_BAG,
            ],
            'type' => [
                'map_group' => 'general',
                'map_name' => 'dc-type',
                'mode' => XMPReader::MODE_BAG,
            ],
        ],
        'http://ns.adobe.com/xap/1.0/' => [
            'CreateDate' => [
                'map_group' => 'general',
                'map_name' => 'DateTimeDigitized',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateDate',
            ],
            'CreatorTool' => [
                'map_group' => 'general',
                'map_name' => 'Software',
                'mode' => XMPReader::MODE_SIMPLE
            ],
            'Identifier' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_BAG,
            ],
            'Label' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'ModifyDate' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
                'map_name' => 'DateTime',
                'validate' => 'validateDate',
            ],
            'MetadataDate' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
                // map_name to be consistent with other date names.
                'map_name' => 'DateTimeMetadata',
                'validate' => 'validateDate',
            ],
            'Nickname' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'Rating' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateRating',
            ],
        ],
        'http://ns.adobe.com/xap/1.0/rights/' => [
            'Certificate' => [
                'map_group' => 'general',
                'map_name' => 'RightsCertificate',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'Marked' => [
                'map_group' => 'general',
                'map_name' => 'Copyrighted',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateBoolean',
            ],
            'Owner' => [
                'map_group' => 'general',
                'map_name' => 'CopyrightOwner',
                'mode' => XMPReader::MODE_BAG,
            ],
            // this seems similar to dc:rights.
            'UsageTerms' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_LANG,
            ],
            'WebStatement' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
        ],
        // XMP media management.
        'http://ns.adobe.com/xap/1.0/mm/' => [
            // if we extract the exif UniqueImageID, might
            // as well do this too.
            'OriginalDocumentID' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            // It might also be useful to do xmpMM:LastURL
            // and xmpMM:DerivedFrom as you can potentially,
            // get the url of this document/source for this
            // document. However whats more likely is you'd
            // get a file:// url for the path of the doc,
            // which is somewhat of a privacy issue.
        ],
        'http://creativecommons.org/ns#' => [
            'license' => [
                'map_name' => 'LicenseUrl',
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'morePermissions' => [
                'map_name' => 'MorePermissionsUrl',
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'attributionURL' => [
                'map_group' => 'general',
                'map_name' => 'AttributionUrl',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'attributionName' => [
                'map_group' => 'general',
                'map_name' => 'PreferredAttributionName',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
        ],
        // Note, this property affects how jpeg metadata is extracted.
        'http://ns.adobe.com/xmp/note/' => [
            'HasExtendedXMP' => [
                'map_group' => 'special',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
        ],
        /* Note, in iptc schemas, the legacy properties are denoted
         * as deprecated, since other properties should used instead,
         * and properties marked as deprecated in the standard are
         * are marked as general here as they don't have replacements
         */
        'http://ns.adobe.com/photoshop/1.0/' => [
            'City' => [
                'map_group' => 'deprecated',
                'mode' => XMPReader::MODE_SIMPLE,
                'map_name' => 'CityDest',
            ],
            'Country' => [
                'map_group' => 'deprecated',
                'mode' => XMPReader::MODE_SIMPLE,
                'map_name' => 'CountryDest',
            ],
            'State' => [
                'map_group' => 'deprecated',
                'mode' => XMPReader::MODE_SIMPLE,
                'map_name' => 'ProvinceOrStateDest',
            ],
            'DateCreated' => [
                'map_group' => 'deprecated',
                // marking as deprecated as the xmp prop preferred
                'mode' => XMPReader::MODE_SIMPLE,
                'map_name' => 'DateTimeOriginal',
                'validate' => 'validateDate',
                // note this prop is an XMP, not IPTC date
            ],
            'CaptionWriter' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
                'map_name' => 'Writer',
            ],
            'Instructions' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
                'map_name' => 'SpecialInstructions',
            ],
            'TransmissionReference' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
                'map_name' => 'OriginalTransmissionRef',
            ],
            'AuthorsPosition' => [
                /* This corresponds with 2:85
                 * By-line Title, which needs to be
                 * handled weirdly to correspond
                 * with iptc/exif. */
                'map_group' => 'special',
                'mode' => XMPReader::MODE_SIMPLE
            ],
            'Credit' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'Source' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'Urgency' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'Category' => [
                // Note, this prop is deprecated, but in general
                // group since it doesn't have a replacement.
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
                'map_name' => 'iimCategory',
            ],
            'SupplementalCategories' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_BAG,
                'map_name' => 'iimSupplementalCategory',
            ],
            'Headline' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE
            ],
        ],
        'http://iptc.org/std/Iptc4xmpCore/1.0/xmlns/' => [
            'CountryCode' => [
                'map_group' => 'deprecated',
                'mode' => XMPReader::MODE_SIMPLE,
                'map_name' => 'CountryCodeDest',
            ],
            'IntellectualGenre' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            // Note, this is a six digit code.
            // See: http://cv.iptc.org/newscodes/scene/
            // Since these aren't really all that common,
            // we just show the number.
            'Scene' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_BAG,
                'validate' => 'validateInteger',
                'map_name' => 'SceneCode',
            ],
            /* Note: SubjectCode should be an 8 ascii digits.
             * it is not really an integer (has leading 0's,
             * cannot have a +/- sign), but validateInteger
             * will let it through.
             */
            'SubjectCode' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_BAG,
                'map_name' => 'SubjectNewsCode',
                'validate' => 'validateInteger'
            ],
            'Location' => [
                'map_group' => 'deprecated',
                'mode' => XMPReader::MODE_SIMPLE,
                'map_name' => 'SublocationDest',
            ],
            'CreatorContactInfo' => [
                /* Note this maps to 2:118 in iim
                 * (Contact) field. However those field
                 * types are slightly different - 2:118
                 * is free form text field, where this
                 * is more structured.
                 */
                'map_group' => 'general',
                'mode' => XMPReader::MODE_STRUCT,
                'map_name' => 'Contact',
                'children' => [
                    'CiAdrExtadr' => true,
                    'CiAdrCity' => true,
                    'CiAdrCtry' => true,
                    'CiEmailWork' => true,
                    'CiTelWork' => true,
                    'CiAdrPcode' => true,
                    'CiAdrRegion' => true,
                    'CiUrlWork' => true,
                ],
            ],
            'CiAdrExtadr' => [ /* address */
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
                'structPart' => true,
            ],
            'CiAdrCity' => [ /* city */
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
                'structPart' => true,
            ],
            'CiAdrCtry' => [ /* country */
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
                'structPart' => true,
            ],
            'CiEmailWork' => [ /* email (possibly separated by ',') */
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
                'structPart' => true,
            ],
            'CiTelWork' => [ /* telephone */
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
                'structPart' => true,
            ],
            'CiAdrPcode' => [ /* postal code */
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
                'structPart' => true,
            ],
            'CiAdrRegion' => [ /* province/state */
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
                'structPart' => true,
            ],
            'CiUrlWork' => [ /* url. Multiple may be separated by comma. */
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
                'structPart' => true,
            ],
            /* End contact info struct properties */
        ],
        'http://iptc.org/std/Iptc4xmpExt/2008-02-29/' => [
            'Event' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
            ],
            'OrganisationInImageName' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_BAG,
                'map_name' => 'OrganisationInImage'
            ],
            'PersonInImage' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_BAG,
            ],
            'MaxAvailHeight' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateInteger',
                'map_name' => 'OriginalImageHeight',
            ],
            'MaxAvailWidth' => [
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
                'validate' => 'validateInteger',
                'map_name' => 'OriginalImageWidth',
            ],
            // LocationShown and LocationCreated are handled
            // specially because they are hierarchical, but we
            // also want to merge with the old non-hierarchical.
            'LocationShown' => [
                'map_group' => 'special',
                'mode' => XMPReader::MODE_BAGSTRUCT,
                'children' => [
                    'WorldRegion' => true,
                    'CountryCode' => true, /* iso code */
                    'CountryName' => true,
                    'ProvinceState' => true,
                    'City' => true,
                    'Sublocation' => true,
                ],
            ],
            'LocationCreated' => [
                'map_group' => 'special',
                'mode' => XMPReader::MODE_BAGSTRUCT,
                'children' => [
                    'WorldRegion' => true,
                    'CountryCode' => true, /* iso code */
                    'CountryName' => true,
                    'ProvinceState' => true,
                    'City' => true,
                    'Sublocation' => true,
                ],
            ],
            'WorldRegion' => [
                'map_group' => 'special',
                'mode' => XMPReader::MODE_SIMPLE,
                'structPart' => true,
            ],
            'CountryCode' => [
                'map_group' => 'special',
                'mode' => XMPReader::MODE_SIMPLE,
                'structPart' => true,
            ],
            'CountryName' => [
                'map_group' => 'special',
                'mode' => XMPReader::MODE_SIMPLE,
                'structPart' => true,
                'map_name' => 'Country',
            ],
            'ProvinceState' => [
                'map_group' => 'special',
                'mode' => XMPReader::MODE_SIMPLE,
                'structPart' => true,
                'map_name' => 'ProvinceOrState',
            ],
            'City' => [
                'map_group' => 'special',
                'mode' => XMPReader::MODE_SIMPLE,
                'structPart' => true,
            ],
            'Sublocation' => [
                'map_group' => 'special',
                'mode' => XMPReader::MODE_SIMPLE,
                'structPart' => true,
            ],
 
            /* Other props that might be interesting but
             * Not currently extracted:
             * ArtworkOrObject, (info about objects in picture)
             * DigitalSourceType
             * RegistryId
             */
        ],
 
        /* Plus props we might want to consider:
         * (Note: some of these have unclear/incomplete definitions
         * from the iptc4xmp standard).
         * ImageSupplier (kind of like iptc source field)
         * ImageSupplierId (id code for image from supplier)
         * CopyrightOwner
         * ImageCreator
         * Licensor
         * Various model release fields
         * Property release fields.
         */
    ];
}