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 MIME type */
            '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.
         */
    );
}