| blob | 6fc2343869f7c3ac1a0ed61ee2e01001206d0093 |
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 */
30 /** Get the items array
31 * @return array XMP item configuration array.
32 */
35 }
37 /**
38 * XMPInfo::$items keeps a list of all the items
39 * we are interested to extract, as well as
40 * information about the item like what type
41 * it is.
42 *
43 * Format is an array of namespaces,
44 * each containing an array of tags
45 * each tag is an array of information about the
46 * tag, including:
47 * * map_group - What group (used for precedence during conflicts).
48 * * mode - What type of item (self::MODE_SIMPLE usually, see above for
49 * all values).
50 * * validate - Method to validate input. Could also post-process the
51 * input. A string value is assumed to be a method of
52 * XMPValidate. Can also take a array( 'className', 'methodName' ).
53 * * choices - Array of potential values (format of 'value' => true ).
54 * Only used with validateClosed.
55 * * rangeLow and rangeHigh - Alternative to choices for numeric ranges.
56 * Again for validateClosed only.
57 * * children - For MODE_STRUCT items, allowed children.
58 * * structPart - Indicates that this element can only appear as a member
59 * of a structure.
60 *
61 * Currently this just has a bunch of EXIF values as this class is only half-done.
62 */
69 ),
74 ),
79 ),
84 ),
89 ),
94 ),
99 ),
104 ),
109 ),
114 ),
119 ),
124 ),
129 ),
134 ),
139 ),
144 ),
149 ),
154 ),
159 ),
164 ),
169 ),
174 ),
175 /* Flash */
184 ),
187 ),
193 ),
199 ),
207 ),
215 ),
221 ),
222 /* End Flash */
227 ),
228 /* end rational things */
234 ),
241 ),
247 ),
253 ),
258 ),
263 ),
264 /* todo: there might be interesting information in
265 * exif:DeviceSettingDescription, but need to find an
266 * example
267 */
271 ),
278 ),
285 ),
291 ),
295 ),
300 ),
306 ),
313 ),
314 /* this value is post-processed out later */
320 ),
324 ),
330 ),
337 ),
342 ),
347 ),
353 ),
359 ),
364 ),
369 ),
373 ),
379 ),
383 ),
387 ),
394 ),
400 ),
403 // Note: in exif, GPSDateStamp does not include
404 // the time, where here it does.
408 ),
414 ),
418 ),
422 ),
427 /* can't use a range, as it skips... */
438 ),
439 ),
447 ),
448 /* Pixel(X|Y)Dimension are rather useless, but for
449 * completeness since we do it with exif.
450 */
455 ),
460 ),
467 ),
474 ),
480 ),
481 // Note, 6 is not valid SensingMethod.
489 ),
496 ),
500 ),
501 // This tag should perhaps be displayed to user better.
506 ),
513 ),
518 ),
522 ),
528 ),
529 ),
534 ),
539 ),
545 ),
546 /* this prop should not be used in XMP. dc:rights is the correct prop */
550 ),
555 ),
559 ),
564 ),
569 ),
573 ),
577 ),
578 /**** Do not extract this property
579 * It interferes with auto exif rotation.
580 * 'Orientation' => array(
581 * 'map_group' => 'exif',
582 * 'mode' => XMPReader::MODE_SIMPLE,
583 * 'validate' => 'validateClosed',
584 * 'choices' => array( '1' => true, '2' => true, '3' => true, '4' => true, 5 => true,
585 * '6' => true, '7' => true, '8' => true ),
586 *),
587 ******/
593 ),
599 ),
604 ),
609 ),
615 ),
620 ),
624 ),
625 /* ignore TransferFunction */
630 ),
635 ),
640 ),
645 ),
651 ),
652 /********
653 * Disable extracting this property (bug 31944)
654 * Several files have a string instead of a Seq
655 * for this property. XMPReader doesn't handle
656 * mismatched types very gracefully (it marks
657 * the entire file as invalid, instead of just
658 * the relavent prop). Since this prop
659 * doesn't communicate all that useful information
660 * just disable this prop for now, until such
661 * XMPReader is more graceful (bug 32172)
662 * 'YCbCrSubSampling' => array(
663 * 'map_group' => 'exif',
664 * 'mode' => XMPReader::MODE_SEQ,
665 * 'validate' => 'validateClosed',
666 * 'choices' => array( '1' => true, '2' => true ),
667 * ),
668 */
669 ),
674 ),
678 ),
683 ),
684 ),
690 ),
695 ),
700 ),
705 ),
710 ),
713 // Note, not mapped with other date properties, as this type of date is
714 // non-specific: "A point or period of time associated with an event in
715 // the lifecycle of the resource"
719 ),
720 /* Do not extract dc:format, as we've got better ways to determine MIME type */
725 ),
731 ),
736 ),
737 // for related images/resources
742 ),
747 ),
748 // Note: source is not mapped with iptc source, since iptc
749 // source describes the source of the image in terms of a person
750 // who provided the image, where this is to describe an image that the
751 // current one is based on.
756 ),
761 ),
766 ),
767 ),
774 ),
779 ),
783 ),
787 ),
793 ),
797 // map_name to be consistent with other date names.
800 ),
804 ),
809 ),
810 ),
816 ),
822 ),
827 ),
828 // this seems similar to dc:rights.
832 ),
836 ),
837 ),
838 // XMP media management.
840 // if we extract the exif UniqueImageID, might
841 // as well do this too.
845 ),
846 // It might also be useful to do xmpMM:LastURL
847 // and xmpMM:DerivedFrom as you can potentially,
848 // get the url of this document/source for this
849 // document. However whats more likely is you'd
850 // get a file:// url for the path of the doc,
851 // which is somewhat of a privacy issue.
852 ),
858 ),
863 ),
868 ),
873 ),
874 ),
875 // Note, this property affects how jpeg metadata is extracted.
880 ),
881 ),
882 /* Note, in iptc schemas, the legacy properties are denoted
883 * as deprecated, since other properties should used instead,
884 * and properties marked as deprecated in the standard are
885 * are marked as general here as they don't have replacements
886 */
892 ),
897 ),
902 ),
905 // marking as deprecated as the xmp prop preferred
909 // note this prop is an XMP, not IPTC date
910 ),
915 ),
920 ),
925 ),
927 /* This corresponds with 2:85
928 * By-line Title, which needs to be
929 * handled weirdly to correspond
930 * with iptc/exif. */
933 ),
937 ),
941 ),
945 ),
947 // Note, this prop is deprecated, but in general
948 // group since it doesn't have a replacement.
952 ),
957 ),
961 ),
962 ),
968 ),
972 ),
973 // Note, this is a six digit code.
974 // See: http://cv.iptc.org/newscodes/scene/
975 // Since these aren't really all that common,
976 // we just show the number.
982 ),
983 /* Note: SubjectCode should be an 8 ascii digits.
984 * it is not really an integer (has leading 0's,
985 * cannot have a +/- sign), but validateInteger
986 * will let it through.
987 */
993 ),
998 ),
1000 /* Note this maps to 2:118 in iim
1001 * (Contact) field. However those field
1002 * types are slightly different - 2:118
1003 * is free form text field, where this
1004 * is more structured.
1005 */
1018 ),
1019 ),
1024 ),
1029 ),
1034 ),
1039 ),
1044 ),
1049 ),
1054 ),
1059 ),
1060 /* End contact info struct properties */
1061 ),
1066 ),
1071 ),
1075 ),
1081 ),
1087 ),
1088 // LocationShown and LocationCreated are handled
1089 // specially because they are hierarchical, but we
1090 // also want to merge with the old non-hierarchical.
1101 ),
1102 ),
1113 ),
1114 ),
1119 ),
1124 ),
1130 ),
1136 ),
1141 ),
1146 ),
1148 /* Other props that might be interesting but
1149 * Not currently extracted:
1150 * ArtworkOrObject, (info about objects in picture)
1151 * DigitalSourceType
1152 * RegistryId
1153 */
1154 ),
1156 /* Plus props we might want to consider:
1157 * (Note: some of these have unclear/incomplete definitions
1158 * from the iptc4xmp standard).
1159 * ImageSupplier (kind of like iptc source field)
1160 * ImageSupplierId (id code for image from supplier)
1161 * CopyrightOwner
1162 * ImageCreator
1163 * Licensor
1164 * Various model release fields
1165 * Property release fields.
1166 */
1167 );
1168 }