1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
|
#ifndef __ReconcileLegacy_hpp__
#define __ReconcileLegacy_hpp__ 1
// =================================================================================================
// Copyright Adobe
// Copyright 2006 Adobe
// All Rights Reserved
//
// NOTICE: Adobe permits you to use, modify, and distribute this file in accordance with the terms
// of the Adobe license agreement accompanying it. If you have received this file from a source other
// than Adobe, then your use, modification, or distribution of it requires the prior written permission
// of Adobe.
// =================================================================================================
#include "public/include/XMP_Environment.h" // ! This must be the first include.
#include "XMPFiles/source/FormatSupport/TIFF_Support.hpp"
#include "XMPFiles/source/FormatSupport/PSIR_Support.hpp"
#include "XMPFiles/source/FormatSupport/IPTC_Support.hpp"
// =================================================================================================
/// \file ReconcileLegacy.hpp
/// \brief Utilities to reconcile between XMP and photo metadata forms such as TIFF/Exif and IPTC.
///
// =================================================================================================
// ImportPhotoData imports TIFF/Exif and IPTC metadata from JPEG, TIFF, and Photoshop files into
// XMP. The caller must have already done the file specific processing to select the appropriate
// sources of the TIFF stream, the Photoshop image resources, and the IPTC.
//
// The reconciliation logic used here is based on the Metadata Working Group guidelines. This is a
// simpler approach than used previously - which was modeled after historical Photoshop behavior.
enum { // Bits for the options to ImportJTPtoXMP.
k2XMP_FileHadXMP = 0x0001, // Set if the file had an XMP packet.
k2XMP_FileHadIPTC = 0x0002, // Set if the file had legacy IPTC.
k2XMP_FileHadExif = 0x0004 // Set if the file had legacy Exif.
};
extern void ImportPhotoData ( const TIFF_Manager & exif,
const IPTC_Manager & iptc,
const PSIR_Manager & psir,
int iptcDigestState,
SXMPMeta * xmp,
XMP_OptionBits options = 0 );
// ExportPhotoData exports XMP into TIFF/Exif and IPTC metadata for JPEG, TIFF, and Photoshop files.
extern void ExportPhotoData ( XMP_FileFormat destFormat,
SXMPMeta * xmp,
TIFF_Manager * exif, // Pass 0 if not wanted.
IPTC_Manager * iptc, // Pass 0 if not wanted.
PSIR_Manager * psir, // Pass 0 if not wanted.
XMP_OptionBits options = 0 );
// *** Mapping notes need revision for MWG related changes.
// =================================================================================================
// Summary of TIFF/Exif mappings to XMP
// ====================================
//
// The mapping for each tag is driven mainly by the tag ID, and secondarily by the type. E.g. there
// is no blanket rule that all ASCII tags are mapped to simple strings in XMP. Some, such as
// SubSecTime or GPSLatitudeRef, are combined with other tags; others, like Flash, are reformated.
// However, most tags are in fact mapped in an obvious manner based on their type and count.
//
// Photoshop practice has been to truncate ASCII tags at the first NUL, not supporting the TIFF
// specification's notion of multi-part ASCII values.
//
// Rational values are mapped to XMP as "num/denom".
//
// The tags of UNDEFINED type that are mapped to XMP text are either special cases like ExifVersion
// or the strings with an explicit encoding like UserComment.
//
// Latitude and logitude are mapped to XMP as "DDD,MM,SSk" or "DDD,MM.mmk"; k is N, S, E, or W.
//
// Flash struct in XMP separates the Fired, Return, Mode, Function, and RedEyeMode portions of the
// Exif value. Fired, Function, and RedEyeMode are Boolean; Return and Mode are integers.
//
// The OECF/SFR, CFA, and DeviceSettings tables are described in the XMP spec.
//
// Instead of iterating through all tags in the various IFDs, it is probably more efficient to have
// explicit processing for the tags that get special treatment, and a static table listing those
// that get mapped by type and count. The type and count processing will verify that the actual
// type and count are as expected, if not the tag is ignored.
//
// Here are the primary (0th) IFD tags that get special treatment:
//
// 270, 33432 - ASCII mapped to alt-text['x-default']
// 306 - DateTime master
// 315 - ASCII mapped to text seq[1]
//
// Here are the primary (0th) IFD tags that get mapped by type and count:
//
// 256, 257, 258, 259, 262, 271, 272, 274, 277, 282, 283, 284, 296, 301, 305, 318, 319,
// 529, 530, 531, 532
//
// Here are the Exif IFD tags that get special treatment:
//
// 34856, 41484 - OECF/SFR table
// 36864, 40960 - 4 ASCII chars to text
// 36867, 36868 - DateTime master
// 37121 - 4 UInt8 to integer seq
// 37385 - Flash struct
// 37510 - explicitly encoded text to alt-text['x-default']
// 41728, 41729 - UInt8 to integer
// 41730 - CFA table
// 41995 - DeviceSettings table
//
// Here are the Exif IFD tags that get mapped by type and count:
//
// 33434, 33437, 34850, 34852, 34855, 37122, 37377, 37378, 37379, 37380, 37381, 37382, 37383, 37384,
// 37386, 37396, 40961, 40962, 40963, 40964, 41483, 41486, 41487, 41488, 41492, 41493, 41495, 41985,
// 41986, 41987, 41988, 41989, 41990, 41991, 41992, 41993, 41994, 41996, 42016
//
// Here are the GPS IFD tags that get special treatment:
//
// 0 - 4 UInt8 to text "n.n.n.n"
// 2, 4, 20, 22 - Latitude or longitude master
// 7 - special DateTime master, the time part
// 27, 28 - explicitly encoded text
//
// Here are the GPS IFD tags that get mapped by type and count:
//
// 5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 23, 24, 25, 26, 30
// =================================================================================================
// *** What about the Camera Raw tags that MDKit maps:
// *** 0xFDE8, 0xFDE9, 0xFDEA, 0xFE4C, 0xFE4D, 0xFE4E, 0xFE4F, 0xFE50, 0xFE51, 0xFE52, 0xFE53,
// *** 0xFE54, 0xFE55, 0xFE56, 0xFE57, 0xFE58
// =================================================================================================
// Summary of TIFF/Exif mappings from XMP
// ======================================
//
// Only a small number of properties are written back from XMP to TIFF/Exif. Most of the TIFF/Exif
// tags mapped into XMP are information about the image or capture process, not things that users
// should be editing. The tags that can be edited and written back to TIFF/Exif are:
//
// 270, 274, 282, 283, 296, 305, 306, 315, 33432; 36867, 36868, 37510, 40964
// =================================================================================================
// =================================================================================================
// Details of TIFF/Exif mappings
// =============================
//
// General (primary and thumbnail, 0th and 1st) IFD tags
// tag TIFF type count Name XMP mapping
//
// 256 SHORTorLONG 1 ImageWidth integer
// 257 SHORTorLONG 1 ImageLength integer
// 258 SHORT 3 BitsPerSample integer seq
// 259 SHORT 1 Compression integer
// 262 SHORT 1 PhotometricInterpretation integer
// 270 ASCII Any ImageDescription text, dc:description['x-default']
// 271 ASCII Any Make text
// 272 ASCII Any Model text
// 274 SHORT 1 Orientation integer
// 277 SHORT 1 SamplesPerPixel integer
// 282 RATIONAL 1 XResolution rational
// 283 RATIONAL 1 YResolution rational
// 284 SHORT 1 PlanarConfiguration integer
// 296 SHORT 1 ResolutionUnit integer
// 301 SHORT 3*256 TransferFunction integer seq
// 305 ASCII Any Software text, xmp:CreatorTool
// 306 ASCII 20 DateTime date, master of 37520, xmp:DateTime
// 315 ASCII Any Artist text, dc:creator[1]
// 318 RATIONAL 2 WhitePoint rational seq
// 319 RATIONAL 6 PrimaryChromaticities rational seq
// 529 RATIONAL 3 YCbCrCoefficients rational seq
// 530 SHORT 2 YCbCrSubSampling integer seq
// 531 SHORT 1 YCbCrPositioning integer
// 532 RATIONAL 6 ReferenceBlackWhite rational seq
// 33432 ASCII Any Copyright text, dc:rights['x-default']
//
// Exif IFD tags
// tag TIFF type count Name XMP mapping
//
// 33434 RATIONAL 1 ExposureTime rational
// 33437 RATIONAL 1 FNumber rational
// 34850 SHORT 1 ExposureProgram integer
// 34852 ASCII Any SpectralSensitivity text
// 34855 SHORT Any ISOSpeedRatings integer seq
// 34856 UNDEFINED Any OECF OECF/SFR table
// 36864 UNDEFINED 4 ExifVersion text, Exif has 4 ASCII chars
// 36867 ASCII 20 DateTimeOriginal date, master of 37521
// 36868 ASCII 20 DateTimeDigitized date, master of 37522
// 37121 UNDEFINED 4 ComponentsConfiguration integer seq, Exif has 4 UInt8
// 37122 RATIONAL 1 CompressedBitsPerPixel rational
// 37377 SRATIONAL 1 ShutterSpeedValue rational
// 37378 RATIONAL 1 ApertureValue rational
// 37379 SRATIONAL 1 BrightnessValue rational
// 37380 SRATIONAL 1 ExposureBiasValue rational
// 37381 RATIONAL 1 MaxApertureValue rational
// 37382 RATIONAL 1 SubjectDistance rational
// 37383 SHORT 1 MeteringMode integer
// 37384 SHORT 1 LightSource integer
// 37385 SHORT 1 Flash Flash struct
// 37386 RATIONAL 1 FocalLength rational
// 37396 SHORT 2..4 SubjectArea integer seq
// 37510 UNDEFINED Any UserComment text, explicit encoding, exif:UserComment['x-default]
// 37520 ASCII Any SubSecTime date, with 306
// 37521 ASCII Any SubSecTimeOriginal date, with 36867
// 37522 ASCII Any SubSecTimeDigitized date, with 36868
// 40960 UNDEFINED 4 FlashpixVersion text, Exif has 4 ASCII chars
// 40961 SHORT 1 ColorSpace integer
// 40962 SHORTorLONG 1 PixelXDimension integer
// 40963 SHORTorLONG 1 PixelYDimension integer
// 40964 ASCII 13 RelatedSoundFile text
// 41483 RATIONAL 1 FlashEnergy rational
// 41484 UNDEFINED Any SpatialFrequencyResponse OECF/SFR table
// 41486 RATIONAL 1 FocalPlaneXResolution rational
// 41487 RATIONAL 1 FocalPlaneYResolution rational
// 41488 SHORT 1 FocalPlaneResolutionUnit integer
// 41492 SHORT 2 SubjectLocation integer seq
// 41493 RATIONAL 1 ExposureIndex rational
// 41495 SHORT 1 SensingMethod integer
// 41728 UNDEFINED 1 FileSource integer, Exif has UInt8
// 41729 UNDEFINED 1 SceneType integer, Exif has UInt8
// 41730 UNDEFINED Any CFAPattern CFA table
// 41985 SHORT 1 CustomRendered integer
// 41986 SHORT 1 ExposureMode integer
// 41987 SHORT 1 WhiteBalance integer
// 41988 RATIONAL 1 DigitalZoomRatio rational
// 41989 SHORT 1 FocalLengthIn35mmFilm integer
// 41990 SHORT 1 SceneCaptureType integer
// 41991 SHORT 1 GainControl integer
// 41992 SHORT 1 Contrast integer
// 41993 SHORT 1 Saturation integer
// 41994 SHORT 1 Sharpness integer
// 41995 UNDEFINED Any DeviceSettingDescription DeviceSettings table
// 41996 SHORT 1 SubjectDistanceRange integer
// 42016 ASCII 33 ImageUniqueID text
//
// GPS IFD tags
// tag TIFF type count Name XMP mapping
//
// 0 BYTE 4 GPSVersionID text, "n.n.n.n", Exif has 4 UInt8
// 1 ASCII 2 GPSLatitudeRef latitude, with 2
// 2 RATIONAL 3 GPSLatitude latitude, master of 2
// 3 ASCII 2 GPSLongitudeRef longitude, with 4
// 4 RATIONAL 3 GPSLongitude longitude, master of 3
// 5 BYTE 1 GPSAltitudeRef integer
// 6 RATIONAL 1 GPSAltitude rational
// 7 RATIONAL 3 GPSTimeStamp date, master of 29
// 8 ASCII Any GPSSatellites text
// 9 ASCII 2 GPSStatus text
// 10 ASCII 2 GPSMeasureMode text
// 11 RATIONAL 1 GPSDOP rational
// 12 ASCII 2 GPSSpeedRef text
// 13 RATIONAL 1 GPSSpeed rational
// 14 ASCII 2 GPSTrackRef text
// 15 RATIONAL 1 GPSTrack rational
// 16 ASCII 2 GPSImgDirectionRef text
// 17 RATIONAL 1 GPSImgDirection rational
// 18 ASCII Any GPSMapDatum text
// 19 ASCII 2 GPSDestLatitudeRef latitude, with 20
// 20 RATIONAL 3 GPSDestLatitude latitude, master of 19
// 21 ASCII 2 GPSDestLongitudeRef longitude, with 22
// 22 RATIONAL 3 GPSDestLongitude logitude, master of 21
// 23 ASCII 2 GPSDestBearingRef text
// 24 RATIONAL 1 GPSDestBearing rational
// 25 ASCII 2 GPSDestDistanceRef text
// 26 RATIONAL 1 GPSDestDistance rational
// 27 UNDEFINED Any GPSProcessingMethod text, explicit encoding
// 28 UNDEFINED Any GPSAreaInformation text, explicit encoding
// 29 ASCII 11 GPSDateStamp date, with 29
// 30 SHORT 1 GPSDifferential integer
//
// =================================================================================================
// =================================================================================================
#endif // #ifndef __ReconcileLegacy_hpp__
|
