XMPInfo.php

Go to the documentation of this file.

<?php
class XMPInfo {

    public static function getItems() {
        if ( !self::$ranHooks ) {
            // This is for if someone makes a custom metadata extension.
            // For example, a medical wiki might want to decode DICOM xmp properties.
            wfRunHooks( 'XMPGetInfo', Array( &self::$items ) );
            self::$ranHooks = true; // Only want to do this once.
        }
        return self::$items;
    }

    static private $ranHooks = false;

    static private $items = array(
        'http://ns.adobe.com/exif/1.0/' => array(
            'ApertureValue' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational'
            ),
            'BrightnessValue' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational'
            ),
            'CompressedBitsPerPixel' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational'
            ),
            'DigitalZoomRatio' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational'
            ),
            'ExposureBiasValue' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational'
            ),
            'ExposureIndex' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational'
            ),
            'ExposureTime' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational'
            ),
            'FlashEnergy' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational',
            ),
            'FNumber' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational'
            ),
            'FocalLength' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational'
            ),
            'FocalPlaneXResolution' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational'
            ),
            'FocalPlaneYResolution' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational'
            ),
            'GPSAltitude' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational',
            ),
            'GPSDestBearing' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational'
            ),
            'GPSDestDistance' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational'
            ),
            'GPSDOP' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational'
            ),
            'GPSImgDirection' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational'
            ),
            'GPSSpeed' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational'
            ),
            'GPSTrack' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational'
            ),
            'MaxApertureValue'  => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational'
            ),
            'ShutterSpeedValue' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational'
            ),
            'SubjectDistance'   => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational'
            ),
            /* Flash */
            'Flash'             => array(
                'mode'      => XMPReader::MODE_STRUCT,
                'children'  => array(
                    'Fired'      => true,
                    'Function'   => true,
                    'Mode'       => true,
                    'RedEyeMode' => true,
                    'Return'     => true,
                ),
                'validate'  => 'validateFlash',
                'map_group' => 'exif',
            ),
            'Fired'             => array(
                'map_group' => 'exif',
                'validate'  => 'validateBoolean',
                'mode'      => XMPReader::MODE_SIMPLE,
                'structPart'=> true,
            ),
            'Function'          => array(
                'map_group' => 'exif',
                'validate'  => 'validateBoolean',
                'mode'      => XMPReader::MODE_SIMPLE,
                'structPart'=> true,
            ),
            'Mode'              => array(
                'map_group' => 'exif',
                'validate'  => 'validateClosed',
                'mode'      => XMPReader::MODE_SIMPLE,
                'choices'   => array( '0' => true, '1' => true,
                        '2' => true, '3' => true ),
                'structPart'=> true,
            ),
            'Return'            => array(
                'map_group' => 'exif',
                'validate'  => 'validateClosed',
                'mode'      => XMPReader::MODE_SIMPLE,
                'choices'   => array( '0' => true,
                        '2' => true, '3' => true ),
                'structPart'=> true,
            ),
            'RedEyeMode'        => array(
                'map_group' => 'exif',
                'validate'  => 'validateBoolean',
                'mode'      => XMPReader::MODE_SIMPLE,
                'structPart'=> true,
            ),
            /* End Flash */
            'ISOSpeedRatings'   => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SEQ,
                'validate'  => 'validateInteger'
            ),
            /* end rational things */
            'ColorSpace'   => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'choices'   => array( '1' => true, '65535' => true ),
            ),
            'ComponentsConfiguration'   => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SEQ,
                'validate'  => 'validateClosed',
                'choices'   => array( '1' => true, '2' => true, '3' => true, '4' => true,
                        '5' => true, '6' => true )
            ),
            'Contrast'          => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'choices'   => array( '0' => true, '1' => true, '2' => true )
            ),
            'CustomRendered'    => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'choices'   => array( '0' => true, '1' => true )
            ),
            'DateTimeOriginal'  => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateDate',
            ),
            'DateTimeDigitized' => array( /* 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'       => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'ExposureMode'      => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'rangeLow'  => 0,
                'rangeHigh' => 2,
            ),
            'ExposureProgram'   => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'rangeLow'  => 0,
                'rangeHigh' => 8,
            ),
            'FileSource'        => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'choices'   => array( '3' => true )
            ),
            'FlashpixVersion'   => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'FocalLengthIn35mmFilm' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateInteger',
            ),
            'FocalPlaneResolutionUnit' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'choices'   => array( '2' => true, '3' => true ),
            ),
            'GainControl'       => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'rangeLow'  => 0,
                'rangeHigh' => 4,
            ),
            /* this value is post-processed out later */
            'GPSAltitudeRef'    => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'choices'   => array( '0' => true, '1' => true ),
            ),
            'GPSAreaInformation' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'GPSDestBearingRef' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'choices'   => array( 'T' => true, 'M' => true ),
            ),
            'GPSDestDistanceRef' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'choices'   => array( 'K' => true, 'M' => true,
                        'N' => true ),
            ),
            'GPSDestLatitude'   => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateGPS',
            ),
            'GPSDestLongitude'  => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateGPS',
            ),
            'GPSDifferential'   => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'choices'   => array( '0' => true, '1' => true ),
            ),
            'GPSImgDirectionRef' => array(
                'map_group'  => 'exif',
                'mode'       => XMPReader::MODE_SIMPLE,
                'validate'   => 'validateClosed',
                'choices'    => array( 'T' => true, 'M' => true ),
            ),
            'GPSLatitude'       => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateGPS',
            ),
            'GPSLongitude'      => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateGPS',
            ),
            'GPSMapDatum'       => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'GPSMeasureMode'    => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'choices'   => array( '2' => true, '3' => true )
            ),
            'GPSProcessingMethod' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'GPSSatellites'     => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'GPSSpeedRef'       => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'choices'   => array( 'K' => true, 'M' => true,
                        'N' => true ),
            ),
            'GPSStatus'         => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'choices'   => array( 'A' => true, 'V' => true )
            ),
            'GPSTimeStamp'      => array(
                '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'       => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'choices'   => array( 'T' => true, 'M' => true )
            ),
            'GPSVersionID'      => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'ImageUniqueID'     => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'LightSource'       => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                /* can't use a range, as it skips... */
                'choices'   => array( '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'      => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'rangeLow'  => 0,
                'rangeHigh' => 6,
                'choices'   => array( '255' => true ),
            ),
            /* Pixel(X|Y)Dimension are rather useless, but for
             * completeness since we do it with exif.
             */
            'PixelXDimension'   => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateInteger',
            ),
            'PixelYDimension'   => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateInteger',
            ),
            'Saturation'        => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'rangeLow'  => 0,
                'rangeHigh' => 2,
            ),
            'SceneCaptureType'  => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'rangeLow'  => 0,
                'rangeHigh' => 3,
            ),
            'SceneType'         => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'choices'   => array( '1' => true ),
            ),
            // Note, 6 is not valid SensingMethod.
            'SensingMethod'     => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'rangeLow'  => 1,
                'rangeHigh' => 5,
                'choices'   => array( '7' => true, 8 => true ),
            ),
            'Sharpness'         => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'rangeLow'  => 0,
                'rangeHigh' => 2,
            ),
            'SpectralSensitivity' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            // This tag should perhaps be displayed to user better.
            'SubjectArea'       => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SEQ,
                'validate'  => 'validateInteger',
            ),
            'SubjectDistanceRange' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'rangeLow'  => 0,
                'rangeHigh' => 3,
            ),
            'SubjectLocation'   => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SEQ,
                'validate'  => 'validateInteger',
            ),
            'UserComment'       => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_LANG,
            ),
            'WhiteBalance'      => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'choices'   => array( '0' => true, '1' => true )
            ),
        ),
        'http://ns.adobe.com/tiff/1.0/' => array(
            'Artist'            => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'BitsPerSample'     => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SEQ,
                'validate'  => 'validateInteger',
            ),
            'Compression'       => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'choices'   => array( '1' => true, '6' => true ),
            ),
            /* this prop should not be used in XMP. dc:rights is the correct prop */
            'Copyright'         => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_LANG,
            ),
            'DateTime'          => array( /* proper prop is xmp:ModifyDate */
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateDate',
            ),
            'ImageDescription'  => array( /* proper one is dc:description */
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_LANG,
            ),
            'ImageLength'       => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateInteger',
            ),
            'ImageWidth'        => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateInteger',
            ),
            'Make'              => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'Model'             => array(
                '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' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'choices'   => array( '2' => true, '6' => true ),
            ),
            'PlanerConfiguration' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'choices'   => array( '1' => true, '2' => true ),
            ),
            'PrimaryChromaticities' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SEQ,
                'validate'  => 'validateRational',
            ),
            'ReferenceBlackWhite' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SEQ,
                'validate'  => 'validateRational',
            ),
            'ResolutionUnit'    => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'choices'   => array( '2' => true, '3' => true ),
            ),
            'SamplesPerPixel'   => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateInteger',
            ),
            'Software'          => array( /* see xmp:CreatorTool */
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            /* ignore TransferFunction */
            'WhitePoint'        => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SEQ,
                'validate'  => 'validateRational',
            ),
            'XResolution'       => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational',
            ),
            'YResolution'       => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRational',
            ),
            'YCbCrCoefficients' => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SEQ,
                'validate'  => 'validateRational',
            ),
            'YCbCrPositioning'  => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateClosed',
                'choices'   => array( '1' => true, '2' => true ),
            ),
            /********
             * Disable extracting this property (bug 31944)
             * 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 (bug 32172)
             * '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/' => array(
            'Lens'              => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'SerialNumber'      => array(
                'map_group' => 'exif',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'OwnerName'         => array(
                'map_group' => 'exif',
                'map_name'  => 'CameraOwnerName',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
        ),
        'http://purl.org/dc/elements/1.1/' => array(
            'title'             => array(
                'map_group' => 'general',
                'map_name'  => 'ObjectName',
                'mode'      => XMPReader::MODE_LANG
            ),
            'description'       => array(
                'map_group' => 'general',
                'map_name'  => 'ImageDescription',
                'mode'      => XMPReader::MODE_LANG
            ),
            'contributor'       => array(
                'map_group' => 'general',
                'map_name'  => 'dc-contributor',
                'mode'      => XMPReader::MODE_BAG
            ),
            'coverage'          => array(
                'map_group' => 'general',
                'map_name'  => 'dc-coverage',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'creator'           => array(
                'map_group' => 'general',
                'map_name'  => 'Artist', //map with exif Artist, iptc byline (2:80)
                'mode'      => XMPReader::MODE_SEQ,
            ),
            'date'              => array(
                '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 mimetype */
            'identifier'        => array(
                'map_group' => 'deprecated',
                'map_name'  => 'Identifier',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'language'          => array(
                'map_group' => 'general',
                'map_name'  => 'LanguageCode', /* mapped with iptc 2:135 */
                'mode'      => XMPReader::MODE_BAG,
                'validate'  => 'validateLangCode',
            ),
            'publisher'         => array(
                'map_group' => 'general',
                'map_name'  => 'dc-publisher',
                'mode'      => XMPReader::MODE_BAG,
            ),
            // for related images/resources
            'relation'          => array(
                'map_group' => 'general',
                'map_name'  => 'dc-relation',
                'mode'      => XMPReader::MODE_BAG,
            ),
            'rights'            => array(
                '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'            => array(
                'map_group' => 'general',
                'map_name'  => 'dc-source',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'subject'           => array(
                'map_group' => 'general',
                'map_name'  => 'Keywords', /* maps to iptc 2:25 */
                'mode'      => XMPReader::MODE_BAG,
            ),
            'type'              => array(
                'map_group' => 'general',
                'map_name'  => 'dc-type',
                'mode'      => XMPReader::MODE_BAG,
            ),
        ),
        'http://ns.adobe.com/xap/1.0/' => array(
            'CreateDate' => array(
                'map_group' => 'general',
                'map_name' => 'DateTimeDigitized',
                'mode'     => XMPReader::MODE_SIMPLE,
                'validate' => 'validateDate',
            ),
            'CreatorTool' => array(
                'map_group' => 'general',
                'map_name'  => 'Software',
                'mode'      => XMPReader::MODE_SIMPLE
            ),
            'Identifier' => array(
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_BAG,
            ),
            'Label' => array(
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'ModifyDate' => array(
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
                'map_name'  => 'DateTime',
                'validate'  => 'validateDate',
            ),
            'MetadataDate' => array(
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
                // map_name to be consistent with other date names.
                'map_name'  => 'DateTimeMetadata',
                'validate'  => 'validateDate',
            ),
            'Nickname' => array(
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'Rating' => array(
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateRating',
            ),
        ),
        'http://ns.adobe.com/xap/1.0/rights/' => array(
            'Certificate' => array(
                'map_group' => 'general',
                'map_name'  => 'RightsCertificate',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'Marked' => array(
                'map_group' => 'general',
                'map_name'  => 'Copyrighted',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateBoolean',
            ),
            'Owner' => array(
                'map_group' => 'general',
                'map_name'  => 'CopyrightOwner',
                'mode'      => XMPReader::MODE_BAG,
            ),
            // this seems similar to dc:rights.
            'UsageTerms' => array(
                'map_group' => 'general',
                'mode' => XMPReader::MODE_LANG,
            ),
            'WebStatement' => array(
                'map_group' => 'general',
                'mode' => XMPReader::MODE_SIMPLE,
            ),
        ),
        // XMP media management.
        'http://ns.adobe.com/xap/1.0/mm/' => array(
            // if we extract the exif UniqueImageID, might
            // as well do this too.
            'OriginalDocumentID' => array(
                '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#' => array(
            'license' => array(
                'map_name'  => 'LicenseUrl',
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'morePermissions' => array(
                'map_name'  => 'MorePermissionsUrl',
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'attributionURL' => array(
                'map_group' => 'general',
                'map_name'  => 'AttributionUrl',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'attributionName' => array(
                '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/' => array(
            'HasExtendedXMP' => array(
                '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/' => array(
            'City' => array(
                'map_group' => 'deprecated',
                'mode'      => XMPReader::MODE_SIMPLE,
                'map_name'  => 'CityDest',
            ),
            'Country' => array(
                'map_group' => 'deprecated',
                'mode'      => XMPReader::MODE_SIMPLE,
                'map_name'  => 'CountryDest',
            ),
            'State' => array(
                'map_group' => 'deprecated',
                'mode'      => XMPReader::MODE_SIMPLE,
                'map_name'  => 'ProvinceOrStateDest',
            ),
            'DateCreated' => array(
                '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' => array(
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
                'map_name'  => 'Writer',
            ),
            'Instructions' => array(
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
                'map_name'  => 'SpecialInstructions',
            ),
            'TransmissionReference' => array(
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
                'map_name'  => 'OriginalTransmissionRef',
            ),
            'AuthorsPosition' => array(
                /* 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' => array(
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'Source' => array(
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'Urgency' => array(
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'Category' => array(
                // 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' => array(
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_BAG,
                'map_name'  => 'iimSupplementalCategory',
            ),
            'Headline' => array(
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE
            ),
        ),
        'http://iptc.org/std/Iptc4xmpCore/1.0/xmlns/' => array(
            'CountryCode' => array(
                'map_group' => 'deprecated',
                'mode'      => XMPReader::MODE_SIMPLE,
                'map_name'  => 'CountryCodeDest',
            ),
            'IntellectualGenre' => array(
                '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' => array(
                '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' => array(
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_BAG,
                'map_name'  => 'SubjectNewsCode',
                'validate'  => 'validateInteger'
            ),
            'Location' => array(
                'map_group' => 'deprecated',
                'mode'      => XMPReader::MODE_SIMPLE,
                'map_name'  => 'SublocationDest',
            ),
            'CreatorContactInfo' => array(
                /* 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'  => array(
                    'CiAdrExtadr' => true,
                    'CiAdrCity'   => true,
                    'CiAdrCtry'   => true,
                    'CiEmailWork' => true,
                    'CiTelWork'   => true,
                    'CiAdrPcode'  => true,
                    'CiAdrRegion' => true,
                    'CiUrlWork'   => true,
                ),
            ),
            'CiAdrExtadr' => array( /* address */
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
                'structPart'=> true,
            ),
            'CiAdrCity' => array( /* city */
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
                'structPart'=> true,
            ),
            'CiAdrCtry' => array( /* country */
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
                'structPart'=> true,
            ),
            'CiEmailWork' => array( /* email (possibly separated by ',') */
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
                'structPart'=> true,
            ),
            'CiTelWork' => array( /* telephone */
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
                'structPart'=> true,
            ),
            'CiAdrPcode' => array( /* postal code */
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
                'structPart'=> true,
            ),
            'CiAdrRegion' => array( /* province/state */
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
                'structPart'=> true,
            ),
            'CiUrlWork' => array( /* 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/' => array(
            'Event' => array(
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
            ),
            'OrganisationInImageName' => array(
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_BAG,
                'map_name'  => 'OrganisationInImage'
            ),
            'PersonInImage' => array(
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_BAG,
            ),
            'MaxAvailHeight' => array(
                'map_group' => 'general',
                'mode'      => XMPReader::MODE_SIMPLE,
                'validate'  => 'validateInteger',
                'map_name'  => 'OriginalImageHeight',
            ),
            'MaxAvailWidth' => array(
                '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' => array(
                'map_group' => 'special',
                'mode'      => XMPReader::MODE_BAGSTRUCT,
                'children'  => array(
                    'WorldRegion' => true,
                    'CountryCode' => true, /* iso code */
                    'CountryName' => true,
                    'ProvinceState' => true,
                    'City' => true,
                    'Sublocation' => true,
                ),
            ),
            'LocationCreated' => array(
                'map_group' => 'special',
                'mode'      => XMPReader::MODE_BAGSTRUCT,
                'children'  => array(
                    'WorldRegion' => true,
                    'CountryCode' => true, /* iso code */
                    'CountryName' => true,
                    'ProvinceState' => true,
                    'City' => true,
                    'Sublocation' => true,
                ),
            ),
            'WorldRegion' => array(
                'map_group' => 'special',
                'mode'      => XMPReader::MODE_SIMPLE,
                'structPart'=> true,
            ),
            'CountryCode' => array(
                'map_group' => 'special',
                'mode'      => XMPReader::MODE_SIMPLE,
                'structPart'=> true,
            ),
            'CountryName' => array(
                'map_group' => 'special',
                'mode'      => XMPReader::MODE_SIMPLE,
                'structPart'=> true,
                'map_name'  => 'Country',
            ),
            'ProvinceState' => array(
                'map_group' => 'special',
                'mode'      => XMPReader::MODE_SIMPLE,
                'structPart'=> true,
                'map_name'  => 'ProvinceOrState',
            ),
            'City' => array(
                'map_group' => 'special',
                'mode'      => XMPReader::MODE_SIMPLE,
                'structPart'=> true,
            ),
            'Sublocation' => array(
                '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.
         */
    );
}