| blob | 156d9b5099acac80bda5a8f8ff4f945f424e25ff |
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 ),
560 /**** Do not extract this property
561 * It interferes with auto exif rotation.
562 * 'Orientation' => array(
563 * 'map_group' => 'exif',
564 * 'mode' => XMPReader::MODE_SIMPLE,
565 * 'validate' => 'validateClosed',
566 * 'choices' => array( '1' => true, '2' => true, '3' => true, '4' => true, 5 => true,
567 * '6' => true, '7' => true, '8' => true ),
568 *),
569 ******/
575 ),
581 ),
586 ),
591 ),
597 ),
602 ),
606 ),
607 /* ignore TransferFunction */
612 ),
617 ),
622 ),
627 ),
633 ),
634 /********
635 * Disable extracting this property (bug 31944)
636 * Several files have a string instead of a Seq
637 * for this property. XMPReader doesn't handle
638 * mismatched types very gracefully (it marks
639 * the entire file as invalid, instead of just
640 * the relavent prop). Since this prop
641 * doesn't communicate all that useful information
642 * just disable this prop for now, until such
643 * XMPReader is more graceful (bug 32172)
644 * 'YCbCrSubSampling' => array(
645 * 'map_group' => 'exif',
646 * 'mode' => XMPReader::MODE_SEQ,
647 * 'validate' => 'validateClosed',
648 * 'choices' => array( '1' => true, '2' => true ),
649 * ),
650 */
651 ),
656 ),
660 ),
665 ),
666 ),
672 ),
677 ),
682 ),
687 ),
692 ),
695 // Note, not mapped with other date properties, as this type of date is
696 // non-specific: "A point or period of time associated with an event in
697 // the lifecycle of the resource"
701 ),
702 /* Do not extract dc:format, as we've got better ways to determine mimetype */
707 ),
713 ),
718 ),
719 // for related images/resources
724 ),
729 ),
730 // Note: source is not mapped with iptc source, since iptc
731 // source describes the source of the image in terms of a person
732 // who provided the image, where this is to describe an image that the
733 // current one is based on.
738 ),
743 ),
748 ),
749 ),
756 ),
761 ),
765 ),
769 ),
775 ),
779 // map_name to be consistent with other date names.
782 ),
786 ),
791 ),
792 ),
798 ),
804 ),
809 ),
810 // this seems similar to dc:rights.
814 ),
818 ),
819 ),
820 // XMP media management.
822 // if we extract the exif UniqueImageID, might
823 // as well do this too.
827 ),
828 // It might also be useful to do xmpMM:LastURL
829 // and xmpMM:DerivedFrom as you can potentially,
830 // get the url of this document/source for this
831 // document. However whats more likely is you'd
832 // get a file:// url for the path of the doc,
833 // which is somewhat of a privacy issue.
834 ),
840 ),
845 ),
850 ),
855 ),
856 ),
857 //Note, this property affects how jpeg metadata is extracted.
862 ),
863 ),
864 /* Note, in iptc schemas, the legacy properties are denoted
865 * as deprecated, since other properties should used instead,
866 * and properties marked as deprecated in the standard are
867 * are marked as general here as they don't have replacements
868 */
874 ),
879 ),
884 ),
887 // marking as deprecated as the xmp prop preferred
891 // note this prop is an XMP, not IPTC date
892 ),
897 ),
902 ),
907 ),
909 /* This corresponds with 2:85
910 * By-line Title, which needs to be
911 * handled weirdly to correspond
912 * with iptc/exif. */
915 ),
919 ),
923 ),
927 ),
929 // Note, this prop is deprecated, but in general
930 // group since it doesn't have a replacement.
934 ),
939 ),
943 ),
944 ),
950 ),
954 ),
955 // Note, this is a six digit code.
956 // See: http://cv.iptc.org/newscodes/scene/
957 // Since these aren't really all that common,
958 // we just show the number.
964 ),
965 /* Note: SubjectCode should be an 8 ascii digits.
966 * it is not really an integer (has leading 0's,
967 * cannot have a +/- sign), but validateInteger
968 * will let it through.
969 */
975 ),
980 ),
982 /* Note this maps to 2:118 in iim
983 * (Contact) field. However those field
984 * types are slightly different - 2:118
985 * is free form text field, where this
986 * is more structured.
987 */
1000 ),
1001 ),
1006 ),
1011 ),
1016 ),
1021 ),
1026 ),
1031 ),
1036 ),
1041 ),
1042 /* End contact info struct properties */
1043 ),
1048 ),
1053 ),
1057 ),
1063 ),
1069 ),
1070 // LocationShown and LocationCreated are handled
1071 // specially because they are hierarchical, but we
1072 // also want to merge with the old non-hierarchical.
1083 ),
1084 ),
1095 ),
1096 ),
1101 ),
1106 ),
1112 ),
1118 ),
1123 ),
1128 ),
1130 /* Other props that might be interesting but
1131 * Not currently extracted:
1132 * ArtworkOrObject, (info about objects in picture)
1133 * DigitalSourceType
1134 * RegistryId
1135 */
1136 ),
1138 /* Plus props we might want to consider:
1139 * (Note: some of these have unclear/incomplete definitions
1140 * from the iptc4xmp standard).
1141 * ImageSupplier (kind of like iptc source field)
1142 * ImageSupplierId (id code for image from supplier)
1143 * CopyrightOwner
1144 * ImageCreator
1145 * Licensor
1146 * Various model release fields
1147 * Property release fields.
1148 */
1149 );
1150 }