| blob | 4dbc1cb31ab2c40fe04cea77e2c952293a3c4fb8 |
1 <?php
2 /**
3 * This class is just a container for a big array
4 * used by XMPReader to determine which XMP items to
5 * extract.
6 */
9 /** get the items array
10 * @return Array XMP item configuration array.
11 */
14 // This is for if someone makes a custom metadata extension.
15 // For example, a medical wiki might want to decode DICOM xmp properties.
18 }
20 }
24 /**
25 * XMPInfo::$items keeps a list of all the items
26 * we are interested to extract, as well as
27 * information about the item like what type
28 * it is.
29 *
30 * Format is an array of namespaces,
31 * each containing an array of tags
32 * each tag is an array of information about the
33 * tag, including:
34 * * map_group - what group (used for precedence during conflicts)
35 * * mode - What type of item (self::MODE_SIMPLE usually, see above for all values)
36 * * 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' ).
37 * * choices - array of potential values (format of 'value' => true ). Only used with validateClosed
38 * * rangeLow and rangeHigh - alternative to choices for numeric ranges. Again for validateClosed only.
39 * * children - for MODE_STRUCT items, allowed children.
40 * * structPart - Indicates that this element can only appear as a member of a structure.
41 *
42 * currently this just has a bunch of exif values as this class is only half-done
43 */
51 ),
56 ),
61 ),
66 ),
71 ),
76 ),
81 ),
86 ),
91 ),
96 ),
101 ),
106 ),
111 ),
116 ),
121 ),
126 ),
131 ),
136 ),
141 ),
146 ),
151 ),
156 ),
157 /* Flash */
166 ),
169 ),
175 ),
181 ),
189 ),
197 ),
203 ),
204 /* End Flash */
209 ),
210 /* end rational things */
216 ),
223 ),
229 ),
235 ),
240 ),
245 ),
246 /* todo: there might be interesting information in
247 * exif:DeviceSettingDescription, but need to find an
248 * example
249 */
253 ),
260 ),
267 ),
273 ),
277 ),
282 ),
288 ),
295 ),
296 /* this value is post-processed out later */
302 ),
306 ),
312 ),
319 ),
324 ),
329 ),
335 ),
341 ),
346 ),
351 ),
355 ),
361 ),
365 ),
369 ),
376 ),
382 ),
385 // Note: in exif, GPSDateStamp does not include
386 // the time, where here it does.
390 ),
396 ),
400 ),
404 ),
409 /* can't use a range, as it skips... */
420 ),
421 ),
429 ),
430 /* Pixel(X|Y)Dimension are rather useless, but for
431 * completeness since we do it with exif.
432 */
437 ),
442 ),
449 ),
456 ),
462 ),
463 // Note, 6 is not valid SensingMethod.
471 ),
478 ),
482 ),
483 // This tag should perhaps be displayed to user better.
488 ),
495 ),
500 ),
504 ),
510 ),
511 ),
516 ),
521 ),
527 ),
528 /* this prop should not be used in XMP. dc:rights is the correct prop */
532 ),
537 ),
541 ),
546 ),
551 ),
555 ),
559 ),
566 ),
572 ),
578 ),
583 ),
588 ),
594 ),
599 ),
603 ),
604 /* ignore TransferFunction */
609 ),
614 ),
619 ),
624 ),
630 ),
636 ),
637 ),
642 ),
646 ),
651 ),
652 ),
658 ),
663 ),
668 ),
673 ),
678 ),
681 // Note, not mapped with other date properties, as this type of date is
682 // non-specific: "A point or period of time associated with an event in
683 // the lifecycle of the resource"
687 ),
688 /* Do not extract dc:format, as we've got better ways to determine mimetype */
693 ),
699 ),
704 ),
705 // for related images/resources
710 ),
715 ),
716 // Note: source is not mapped with iptc source, since iptc
717 // source describes the source of the image in terms of a person
718 // who provided the image, where this is to describe an image that the
719 // current one is based on.
724 ),
729 ),
734 ),
735 ),
742 ),
747 ),
751 ),
755 ),
761 ),
765 // map_name to be consistent with other date names.
768 ),
772 ),
777 ),
778 ),
784 ),
790 ),
795 ),
796 // this seems similar to dc:rights.
800 ),
804 ),
805 ),
806 // XMP media management.
808 // if we extract the exif UniqueImageID, might
809 // as well do this too.
813 ),
814 // It might also be useful to do xmpMM:LastURL
815 // and xmpMM:DerivedFrom as you can potentially,
816 // get the url of this document/source for this
817 // document. However whats more likely is you'd
818 // get a file:// url for the path of the doc,
819 // which is somewhat of a privacy issue.
820 ),
826 ),
831 ),
836 ),
841 ),
842 ),
843 //Note, this property affects how jpeg metadata is extracted.
848 ),
849 ),
850 /* Note, in iptc schemas, the legacy properties are denoted
851 * as deprecated, since other properties should used instead,
852 * and properties marked as deprecated in the standard are
853 * are marked as general here as they don't have replacements
854 */
860 ),
865 ),
870 ),
873 // marking as deprecated as the xmp prop preferred
877 // note this prop is an XMP, not IPTC date
878 ),
883 ),
888 ),
893 ),
895 /* This corresponds with 2:85
896 * By-line Title, which needs to be
897 * handled weirdly to correspond
898 * with iptc/exif. */
901 ),
905 ),
909 ),
913 ),
915 // Note, this prop is deprecated, but in general
916 // group since it doesn't have a replacement.
920 ),
925 ),
929 ),
930 ),
936 ),
940 ),
941 // Note, this is a six digit code.
942 // See: http://cv.iptc.org/newscodes/scene/
943 // Since these aren't really all that common,
944 // we just show the number.
950 ),
951 /* Note: SubjectCode should be an 8 ascii digits.
952 * it is not really an integer (has leading 0's,
953 * cannot have a +/- sign), but validateInteger
954 * will let it through.
955 */
961 ),
966 ),
968 /* Note this maps to 2:118 in iim
969 * (Contact) field. However those field
970 * types are slightly different - 2:118
971 * is free form text field, where this
972 * is more structured.
973 */
986 ),
987 ),
992 ),
997 ),
1002 ),
1007 ),
1012 ),
1017 ),
1022 ),
1027 ),
1028 /* End contact info struct properties */
1029 ),
1034 ),
1039 ),
1043 ),
1049 ),
1055 ),
1056 // LocationShown and LocationCreated are handled
1057 // specially because they are hierarchical, but we
1058 // also want to merge with the old non-hierarchical.
1069 ),
1070 ),
1081 ),
1082 ),
1087 ),
1092 ),
1098 ),
1104 ),
1109 ),
1114 ),
1116 /* Other props that might be interesting but
1117 * Not currently extracted:
1118 * ArtworkOrObject, (info about objects in picture)
1119 * DigitalSourceType
1120 * RegistryId
1121 */
1122 ),
1124 /* Plus props we might want to consider:
1125 * (Note: some of these have unclear/incomplete definitions
1126 * from the iptc4xmp standard).
1127 * ImageSupplier (kind of like iptc source field)
1128 * ImageSupplierId (id code for image from supplier)
1129 * CopyrightOwner
1130 * ImageCreator
1131 * Licensor
1132 * Various model release fields
1133 * Property release fields.
1134 */
1135 );
1136 }