| blob | f0b2cb5e85c473730c391c92add1b59814d32bdf |
1 <?php
2 /**
3 * Definitions for XMPReader class.
4 *
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
9 *
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
14 *
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 * http://www.gnu.org/copyleft/gpl.html
19 *
20 * @file
21 * @ingroup Media
22 */
24 /**
25 * This class is just a container for a big array
26 * used by XMPReader to determine which XMP items to
27 * extract.
28 */
31 /** get the items array
32 * @return Array XMP item configuration array.
33 */
36 // This is for if someone makes a custom metadata extension.
37 // For example, a medical wiki might want to decode DICOM xmp properties.
40 }
42 }
46 /**
47 * XMPInfo::$items keeps a list of all the items
48 * we are interested to extract, as well as
49 * information about the item like what type
50 * it is.
51 *
52 * Format is an array of namespaces,
53 * each containing an array of tags
54 * each tag is an array of information about the
55 * tag, including:
56 * * map_group - what group (used for precedence during conflicts)
57 * * mode - What type of item (self::MODE_SIMPLE usually, see above for all values)
58 * * validate - method to validate input. Could also post-process the input. A string value is assumed to be a static method of XMPValidate. Can also take a array( 'className', 'methodName' ).
59 * * choices - array of potential values (format of 'value' => true ). Only used with validateClosed
60 * * rangeLow and rangeHigh - alternative to choices for numeric ranges. Again for validateClosed only.
61 * * children - for MODE_STRUCT items, allowed children.
62 * * structPart - Indicates that this element can only appear as a member of a structure.
63 *
64 * currently this just has a bunch of exif values as this class is only half-done
65 */
72 ),
77 ),
82 ),
87 ),
92 ),
97 ),
102 ),
107 ),
112 ),
117 ),
122 ),
127 ),
132 ),
137 ),
142 ),
147 ),
152 ),
157 ),
162 ),
167 ),
172 ),
177 ),
178 /* Flash */
187 ),
190 ),
196 ),
202 ),
210 ),
218 ),
224 ),
225 /* End Flash */
230 ),
231 /* end rational things */
237 ),
244 ),
250 ),
256 ),
261 ),
266 ),
267 /* todo: there might be interesting information in
268 * exif:DeviceSettingDescription, but need to find an
269 * example
270 */
274 ),
281 ),
288 ),
294 ),
298 ),
303 ),
309 ),
316 ),
317 /* this value is post-processed out later */
323 ),
327 ),
333 ),
340 ),
345 ),
350 ),
356 ),
362 ),
367 ),
372 ),
376 ),
382 ),
386 ),
390 ),
397 ),
403 ),
406 // Note: in exif, GPSDateStamp does not include
407 // the time, where here it does.
411 ),
417 ),
421 ),
425 ),
430 /* can't use a range, as it skips... */
441 ),
442 ),
450 ),
451 /* Pixel(X|Y)Dimension are rather useless, but for
452 * completeness since we do it with exif.
453 */
458 ),
463 ),
470 ),
477 ),
483 ),
484 // Note, 6 is not valid SensingMethod.
492 ),
499 ),
503 ),
504 // This tag should perhaps be displayed to user better.
509 ),
516 ),
521 ),
525 ),
531 ),
532 ),
537 ),
542 ),
548 ),
549 /* this prop should not be used in XMP. dc:rights is the correct prop */
553 ),
558 ),
562 ),
567 ),
572 ),
576 ),
580 ),
581 /**** Do not extract this property
582 * It interferes with auto exif rotation.
583 * 'Orientation' => array(
584 * 'map_group' => 'exif',
585 * 'mode' => XMPReader::MODE_SIMPLE,
586 * 'validate' => 'validateClosed',
587 * 'choices' => array( '1' => true, '2' => true, '3' => true, '4' => true, 5 => true,
588 * '6' => true, '7' => true, '8' => true ),
589 *),
590 ******/
596 ),
602 ),
607 ),
612 ),
618 ),
623 ),
627 ),
628 /* ignore TransferFunction */
633 ),
638 ),
643 ),
648 ),
654 ),
655 /********
656 * Disable extracting this property (bug 31944)
657 * Several files have a string instead of a Seq
658 * for this property. XMPReader doesn't handle
659 * mismatched types very gracefully (it marks
660 * the entire file as invalid, instead of just
661 * the relavent prop). Since this prop
662 * doesn't communicate all that useful information
663 * just disable this prop for now, until such
664 * XMPReader is more graceful (bug 32172)
665 * 'YCbCrSubSampling' => array(
666 * 'map_group' => 'exif',
667 * 'mode' => XMPReader::MODE_SEQ,
668 * 'validate' => 'validateClosed',
669 * 'choices' => array( '1' => true, '2' => true ),
670 * ),
671 */
672 ),
677 ),
681 ),
686 ),
687 ),
693 ),
698 ),
703 ),
708 ),
713 ),
716 // Note, not mapped with other date properties, as this type of date is
717 // non-specific: "A point or period of time associated with an event in
718 // the lifecycle of the resource"
722 ),
723 /* Do not extract dc:format, as we've got better ways to determine mimetype */
728 ),
734 ),
739 ),
740 // for related images/resources
745 ),
750 ),
751 // Note: source is not mapped with iptc source, since iptc
752 // source describes the source of the image in terms of a person
753 // who provided the image, where this is to describe an image that the
754 // current one is based on.
759 ),
764 ),
769 ),
770 ),
777 ),
782 ),
786 ),
790 ),
796 ),
800 // map_name to be consistent with other date names.
803 ),
807 ),
812 ),
813 ),
819 ),
825 ),
830 ),
831 // this seems similar to dc:rights.
835 ),
839 ),
840 ),
841 // XMP media management.
843 // if we extract the exif UniqueImageID, might
844 // as well do this too.
848 ),
849 // It might also be useful to do xmpMM:LastURL
850 // and xmpMM:DerivedFrom as you can potentially,
851 // get the url of this document/source for this
852 // document. However whats more likely is you'd
853 // get a file:// url for the path of the doc,
854 // which is somewhat of a privacy issue.
855 ),
861 ),
866 ),
871 ),
876 ),
877 ),
878 //Note, this property affects how jpeg metadata is extracted.
883 ),
884 ),
885 /* Note, in iptc schemas, the legacy properties are denoted
886 * as deprecated, since other properties should used instead,
887 * and properties marked as deprecated in the standard are
888 * are marked as general here as they don't have replacements
889 */
895 ),
900 ),
905 ),
908 // marking as deprecated as the xmp prop preferred
912 // note this prop is an XMP, not IPTC date
913 ),
918 ),
923 ),
928 ),
930 /* This corresponds with 2:85
931 * By-line Title, which needs to be
932 * handled weirdly to correspond
933 * with iptc/exif. */
936 ),
940 ),
944 ),
948 ),
950 // Note, this prop is deprecated, but in general
951 // group since it doesn't have a replacement.
955 ),
960 ),
964 ),
965 ),
971 ),
975 ),
976 // Note, this is a six digit code.
977 // See: http://cv.iptc.org/newscodes/scene/
978 // Since these aren't really all that common,
979 // we just show the number.
985 ),
986 /* Note: SubjectCode should be an 8 ascii digits.
987 * it is not really an integer (has leading 0's,
988 * cannot have a +/- sign), but validateInteger
989 * will let it through.
990 */
996 ),
1001 ),
1003 /* Note this maps to 2:118 in iim
1004 * (Contact) field. However those field
1005 * types are slightly different - 2:118
1006 * is free form text field, where this
1007 * is more structured.
1008 */
1021 ),
1022 ),
1027 ),
1032 ),
1037 ),
1042 ),
1047 ),
1052 ),
1057 ),
1062 ),
1063 /* End contact info struct properties */
1064 ),
1069 ),
1074 ),
1078 ),
1084 ),
1090 ),
1091 // LocationShown and LocationCreated are handled
1092 // specially because they are hierarchical, but we
1093 // also want to merge with the old non-hierarchical.
1104 ),
1105 ),
1116 ),
1117 ),
1122 ),
1127 ),
1133 ),
1139 ),
1144 ),
1149 ),
1151 /* Other props that might be interesting but
1152 * Not currently extracted:
1153 * ArtworkOrObject, (info about objects in picture)
1154 * DigitalSourceType
1155 * RegistryId
1156 */
1157 ),
1159 /* Plus props we might want to consider:
1160 * (Note: some of these have unclear/incomplete definitions
1161 * from the iptc4xmp standard).
1162 * ImageSupplier (kind of like iptc source field)
1163 * ImageSupplierId (id code for image from supplier)
1164 * CopyrightOwner
1165 * ImageCreator
1166 * Licensor
1167 * Various model release fields
1168 * Property release fields.
1169 */
1170 );
1171 }