3 * Copyright (c) 2001 Lutz Mueller <lutz@users.sourceforge.net>
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2 of the License, or (at your option) any later version.
10 * This library 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 GNU
13 * Lesser General Public License for more details.
15 * You should have received a copy of the GNU Lesser General Public
16 * License along with this library; if not, write to the
17 * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
18 * Boston, MA 02110-1301 USA.
23 #include <libexif/exif-tag.h>
24 #include <libexif/i18n.h>
29 #define ESL_NNNN { EXIF_SUPPORT_LEVEL_NOT_RECORDED, EXIF_SUPPORT_LEVEL_NOT_RECORDED, EXIF_SUPPORT_LEVEL_NOT_RECORDED, EXIF_SUPPORT_LEVEL_NOT_RECORDED }
30 #define ESL_OOOO { EXIF_SUPPORT_LEVEL_OPTIONAL, EXIF_SUPPORT_LEVEL_OPTIONAL, EXIF_SUPPORT_LEVEL_OPTIONAL, EXIF_SUPPORT_LEVEL_OPTIONAL }
31 #define ESL_MMMN { EXIF_SUPPORT_LEVEL_MANDATORY, EXIF_SUPPORT_LEVEL_MANDATORY, EXIF_SUPPORT_LEVEL_MANDATORY, EXIF_SUPPORT_LEVEL_NOT_RECORDED }
32 #define ESL_MMMM { EXIF_SUPPORT_LEVEL_MANDATORY, EXIF_SUPPORT_LEVEL_MANDATORY, EXIF_SUPPORT_LEVEL_MANDATORY, EXIF_SUPPORT_LEVEL_MANDATORY }
33 #define ESL_OMON { EXIF_SUPPORT_LEVEL_OPTIONAL, EXIF_SUPPORT_LEVEL_MANDATORY, EXIF_SUPPORT_LEVEL_OPTIONAL, EXIF_SUPPORT_LEVEL_NOT_RECORDED }
34 #define ESL_NNOO { EXIF_SUPPORT_LEVEL_NOT_RECORDED, EXIF_SUPPORT_LEVEL_NOT_RECORDED, EXIF_SUPPORT_LEVEL_OPTIONAL, EXIF_SUPPORT_LEVEL_OPTIONAL }
35 #define ESL_NNMN { EXIF_SUPPORT_LEVEL_NOT_RECORDED, EXIF_SUPPORT_LEVEL_NOT_RECORDED, EXIF_SUPPORT_LEVEL_MANDATORY, EXIF_SUPPORT_LEVEL_NOT_RECORDED }
36 #define ESL_NNMM { EXIF_SUPPORT_LEVEL_NOT_RECORDED, EXIF_SUPPORT_LEVEL_NOT_RECORDED, EXIF_SUPPORT_LEVEL_MANDATORY, EXIF_SUPPORT_LEVEL_MANDATORY }
37 #define ESL_NNNM { EXIF_SUPPORT_LEVEL_NOT_RECORDED, EXIF_SUPPORT_LEVEL_NOT_RECORDED, EXIF_SUPPORT_LEVEL_NOT_RECORDED, EXIF_SUPPORT_LEVEL_MANDATORY }
38 #define ESL_NNNO { EXIF_SUPPORT_LEVEL_NOT_RECORDED, EXIF_SUPPORT_LEVEL_NOT_RECORDED, EXIF_SUPPORT_LEVEL_NOT_RECORDED, EXIF_SUPPORT_LEVEL_OPTIONAL }
39 #define ESL_UUUU { EXIF_SUPPORT_LEVEL_UNKNOWN, EXIF_SUPPORT_LEVEL_UNKNOWN, EXIF_SUPPORT_LEVEL_UNKNOWN, EXIF_SUPPORT_LEVEL_UNKNOWN }
40 #define ESL_GPS { ESL_NNNN, ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN }
41 #define ESL_UNKNOWN { ESL_UUUU, ESL_UUUU, ESL_UUUU, ESL_UUUU, ESL_UUUU }
44 * Table giving information about each EXIF tag.
45 * There may be more than one entry with the same tag value because some tags
46 * have different meanings depending on the IFD in which they appear.
47 * When there are such duplicate entries, there must be no overlap in their
49 * The entries MUST be sorted in tag order.
50 * The name and title are mandatory, but the description may be an empty
51 * string. None of the entries may be NULL except the final array terminator.
53 static const struct TagEntry {
54 /*! Tag ID. There may be duplicate tags when the same number is used for
55 * different meanings in different IFDs. */
59 const char *description;
60 /*! indexed by the types [ExifIfd][ExifDataType] */
61 ExifSupportLevel esl[EXIF_IFD_COUNT][EXIF_DATA_TYPE_COUNT];
63 #ifndef NO_VERBOSE_TAG_STRINGS
64 {EXIF_TAG_GPS_VERSION_ID, "GPSVersionID", N_("GPS Tag Version"),
65 N_("Indicates the version of <GPSInfoIFD>. The version is given "
66 "as 2.0.0.0. This tag is mandatory when <GPSInfo> tag is "
67 "present. (Note: The <GPSVersionID> tag is given in bytes, "
68 "unlike the <ExifVersion> tag. When the version is "
69 "2.0.0.0, the tag value is 02000000.H)."), ESL_GPS},
70 {EXIF_TAG_INTEROPERABILITY_INDEX, "InteroperabilityIndex",
71 N_("Interoperability Index"),
72 N_("Indicates the identification of the Interoperability rule. "
73 "Use \"R98\" for stating ExifR98 Rules. Four bytes used "
74 "including the termination code (NULL). see the separate "
75 "volume of Recommended Exif Interoperability Rules (ExifR98) "
76 "for other tags used for ExifR98."),
77 { ESL_NNNN, ESL_NNNN, ESL_NNNN, ESL_NNNN, ESL_OOOO } },
78 {EXIF_TAG_GPS_LATITUDE_REF, "GPSLatitudeRef", N_("North or South Latitude"),
79 N_("Indicates whether the latitude is north or south latitude. The "
80 "ASCII value 'N' indicates north latitude, and 'S' is south "
81 "latitude."), ESL_GPS},
82 {EXIF_TAG_INTEROPERABILITY_VERSION, "InteroperabilityVersion",
83 N_("Interoperability Version"), "",
84 { ESL_NNNN, ESL_NNNN, ESL_NNNN, ESL_NNNN, ESL_OOOO } },
85 {EXIF_TAG_GPS_LATITUDE, "GPSLatitude", N_("Latitude"),
86 N_("Indicates the latitude. The latitude is expressed as three "
87 "RATIONAL values giving the degrees, minutes, and seconds, "
88 "respectively. When degrees, minutes and seconds are expressed, "
89 "the format is dd/1,mm/1,ss/1. When degrees and minutes are used "
90 "and, for example, fractions of minutes are given up to two "
91 "decimal places, the format is dd/1,mmmm/100,0/1."),
93 {EXIF_TAG_GPS_LONGITUDE_REF, "GPSLongitudeRef", N_("East or West Longitude"),
94 N_("Indicates whether the longitude is east or west longitude. "
95 "ASCII 'E' indicates east longitude, and 'W' is west "
96 "longitude."), ESL_GPS},
97 {EXIF_TAG_GPS_LONGITUDE, "GPSLongitude", N_("Longitude"),
98 N_("Indicates the longitude. The longitude is expressed as three "
99 "RATIONAL values giving the degrees, minutes, and seconds, "
100 "respectively. When degrees, minutes and seconds are expressed, "
101 "the format is ddd/1,mm/1,ss/1. When degrees and minutes are "
102 "used and, for example, fractions of minutes are given up to "
103 "two decimal places, the format is ddd/1,mmmm/100,0/1."),
105 {EXIF_TAG_GPS_ALTITUDE_REF, "GPSAltitudeRef", N_("Altitude Reference"),
106 N_("Indicates the altitude used as the reference altitude. If the "
107 "reference is sea level and the altitude is above sea level, 0 "
108 "is given. If the altitude is below sea level, a value of 1 is given "
109 "and the altitude is indicated as an absolute value in the "
110 "GPSAltitude tag. The reference unit is meters. Note that this tag "
111 "is BYTE type, unlike other reference tags."), ESL_GPS},
112 {EXIF_TAG_GPS_ALTITUDE, "GPSAltitude", N_("Altitude"),
113 N_("Indicates the altitude based on the reference in GPSAltitudeRef. "
114 "Altitude is expressed as one RATIONAL value. The reference unit "
115 "is meters."), ESL_GPS},
116 {EXIF_TAG_GPS_TIME_STAMP, "GPSTimeStamp", N_("GPS Time (Atomic Clock)"),
117 N_("Indicates the time as UTC (Coordinated Universal Time). "
118 "TimeStamp is expressed as three RATIONAL values giving "
119 "the hour, minute, and second."), ESL_GPS},
120 {EXIF_TAG_GPS_SATELLITES, "GPSSatellites", N_("GPS Satellites"),
121 N_("Indicates the GPS satellites used for measurements. This "
122 "tag can be used to describe the number of satellites, their ID "
123 "number, angle of elevation, azimuth, SNR and other information "
124 "in ASCII notation. The format is not specified. If the GPS "
125 "receiver is incapable of taking measurements, value of the tag "
126 "shall be set to NULL."), ESL_GPS},
127 {EXIF_TAG_GPS_STATUS, "GPSStatus", N_("GPS Receiver Status"),
128 N_("Indicates the status of the GPS receiver when the image is "
129 "recorded. 'A' means measurement is in progress, and 'V' means "
130 "the measurement is Interoperability."), ESL_GPS},
131 {EXIF_TAG_GPS_MEASURE_MODE, "GPSMeasureMode", N_("GPS Measurement Mode"),
132 N_("Indicates the GPS measurement mode. '2' means "
133 "two-dimensional measurement and '3' means three-dimensional "
134 "measurement is in progress."), ESL_GPS},
135 {EXIF_TAG_GPS_DOP, "GPSDOP", N_("Measurement Precision"),
136 N_("Indicates the GPS DOP (data degree of precision). An HDOP "
137 "value is written during two-dimensional measurement, and PDOP "
138 "during three-dimensional measurement."), ESL_GPS},
139 {EXIF_TAG_GPS_SPEED_REF, "GPSSpeedRef", N_("Speed Unit"),
140 N_("Indicates the unit used to express the GPS receiver speed "
141 "of movement. 'K', 'M' and 'N' represent kilometers per hour, "
142 "miles per hour, and knots."), ESL_GPS},
143 {EXIF_TAG_GPS_SPEED, "GPSSpeed", N_("Speed of GPS Receiver"),
144 N_("Indicates the speed of GPS receiver movement."), ESL_GPS},
145 {EXIF_TAG_GPS_TRACK_REF, "GPSTrackRef", N_("Reference for direction of movement"),
146 N_("Indicates the reference for giving the direction of GPS "
147 "receiver movement. 'T' denotes true direction and 'M' is "
148 "magnetic direction."), ESL_GPS},
149 {EXIF_TAG_GPS_TRACK, "GPSTrack", N_("Direction of Movement"),
150 N_("Indicates the direction of GPS receiver movement. The range "
151 "of values is from 0.00 to 359.99."), ESL_GPS},
152 {EXIF_TAG_GPS_IMG_DIRECTION_REF, "GPSImgDirectionRef", N_("GPS Image Direction Reference"),
153 N_("Indicates the reference for giving the direction of the image when it is captured. "
154 "'T' denotes true direction and 'M' is magnetic direction."), ESL_GPS},
155 {EXIF_TAG_GPS_IMG_DIRECTION, "GPSImgDirection", N_("GPS Image Direction"),
156 N_("Indicates the direction of the image when it was captured. The range of values is "
157 "from 0.00 to 359.99."), ESL_GPS},
158 {EXIF_TAG_GPS_MAP_DATUM, "GPSMapDatum", N_("Geodetic Survey Data Used"),
159 N_("Indicates the geodetic survey data used by the GPS "
160 "receiver. If the survey data is restricted to Japan, the value "
161 "of this tag is 'TOKYO' or 'WGS-84'. If a GPS Info tag is "
162 "recorded, it is strongly recommended that this tag be recorded."), ESL_GPS},
163 {EXIF_TAG_GPS_DEST_LATITUDE_REF, "GPSDestLatitudeRef", N_("Reference For Latitude of Destination"),
164 N_("Indicates whether the latitude of the destination point is "
165 "north or south latitude. The ASCII value 'N' indicates north "
166 "latitude, and 'S' is south latitude."), ESL_GPS},
167 {EXIF_TAG_GPS_DEST_LATITUDE, "GPSDestLatitude", N_("Latitude of Destination"),
168 N_("Indicates the latitude of the destination point. The "
169 "latitude is expressed as three RATIONAL values giving the "
170 "degrees, minutes, and seconds, respectively. If latitude is "
171 "expressed as degrees, minutes and seconds, a typical format "
172 "would be dd/1,mm/1,ss/1. When degrees and minutes are used and, "
173 "for example, fractions of minutes are given up to two decimal "
174 "places, the format would be dd/1,mmmm/100,0/1."), ESL_GPS},
175 {EXIF_TAG_GPS_DEST_LONGITUDE_REF, "GPSDestLongitudeRef", N_("Reference for Longitude of Destination"),
176 N_("Indicates whether the longitude of the destination point is "
177 "east or west longitude. ASCII 'E' indicates east longitude, and "
178 "'W' is west longitude."), ESL_GPS},
179 {EXIF_TAG_GPS_DEST_LONGITUDE, "GPSDestLongitude", N_("Longitude of Destination"),
180 N_("Indicates the longitude of the destination point. The "
181 "longitude is expressed as three RATIONAL values giving the "
182 "degrees, minutes, and seconds, respectively. If longitude is "
183 "expressed as degrees, minutes and seconds, a typical format "
184 "would be ddd/1,mm/1,ss/1. When degrees and minutes are used "
185 "and, for example, fractions of minutes are given up to two "
186 "decimal places, the format would be ddd/1,mmmm/100,0/1."),
188 {EXIF_TAG_GPS_DEST_BEARING_REF, "GPSDestBearingRef", N_("Reference for Bearing of Destination"),
189 N_("Indicates the reference used for giving the bearing to "
190 "the destination point. 'T' denotes true direction and 'M' is "
191 "magnetic direction."), ESL_GPS},
192 {EXIF_TAG_GPS_DEST_BEARING, "GPSDestBearing", N_("Bearing of Destination"),
193 N_("Indicates the bearing to the destination point. The range "
194 "of values is from 0.00 to 359.99."), ESL_GPS},
195 {EXIF_TAG_GPS_DEST_DISTANCE_REF, "GPSDestDistanceRef", N_("Reference for Distance to Destination"),
196 N_("Indicates the unit used to express the distance to the "
197 "destination point. 'K', 'M' and 'N' represent kilometers, miles "
198 "and nautical miles."), ESL_GPS},
199 {EXIF_TAG_GPS_DEST_DISTANCE, "GPSDestDistance", N_("Distance to Destination"),
200 N_("Indicates the distance to the destination point."), ESL_GPS},
201 {EXIF_TAG_GPS_PROCESSING_METHOD, "GPSProcessingMethod", N_("Name of GPS Processing Method"),
202 N_("A character string recording the name of the method used "
203 "for location finding. The first byte indicates the character "
204 "code used, and this is followed by the name "
205 "of the method. Since the Type is not ASCII, NULL termination is "
206 "not necessary."), ESL_GPS},
207 {EXIF_TAG_GPS_AREA_INFORMATION, "GPSAreaInformation", N_("Name of GPS Area"),
208 N_("A character string recording the name of the GPS area. The "
209 "first byte indicates the character code used, "
210 "and this is followed by the name of the GPS area. Since "
211 "the Type is not ASCII, NULL termination is not necessary."), ESL_GPS},
212 {EXIF_TAG_GPS_DATE_STAMP, "GPSDateStamp", N_("GPS Date"),
213 N_("A character string recording date and time information "
214 "relative to UTC (Coordinated Universal Time). The format is "
215 "\"YYYY:MM:DD\". The length of the string is 11 bytes including "
217 {EXIF_TAG_GPS_DIFFERENTIAL, "GPSDifferential", N_("GPS Differential Correction"),
218 N_("Indicates whether differential correction is applied to the "
219 "GPS receiver."), ESL_GPS},
220 {EXIF_TAG_GPS_H_POSITIONING_ERROR, "GPSHPositioningError", N_("GPS Horizontal Positioning Error"),
221 N_("Indicates the horizontal positioning errors in meters. This is "
222 "expressed as one RATIONAL value."), ESL_GPS},
223 /* Not in EXIF 2.2 */
224 {EXIF_TAG_NEW_SUBFILE_TYPE, "NewSubfileType",
225 N_("New Subfile Type"), N_("A general indication of the kind of data "
226 "contained in this subfile."),
228 {EXIF_TAG_IMAGE_WIDTH, "ImageWidth", N_("Image Width"),
229 N_("The number of columns of image data, equal to the number of "
230 "pixels per row. In JPEG compressed data a JPEG marker is "
231 "used instead of this tag."),
232 { ESL_MMMN, ESL_MMMN, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
233 {EXIF_TAG_IMAGE_LENGTH, "ImageLength", N_("Image Length"),
234 N_("The number of rows of image data. In JPEG compressed data a "
235 "JPEG marker is used instead of this tag."),
236 { ESL_MMMN, ESL_MMMN, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
237 {EXIF_TAG_BITS_PER_SAMPLE, "BitsPerSample", N_("Bits per Sample"),
238 N_("The number of bits per image component. In this standard each "
239 "component of the image is 8 bits, so the value for this "
240 "tag is 8. See also <SamplesPerPixel>. In JPEG compressed data "
241 "a JPEG marker is used instead of this tag."),
242 { ESL_MMMN, ESL_MMMN, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
243 {EXIF_TAG_COMPRESSION, "Compression", N_("Compression"),
244 N_("The compression scheme used for the image data. When a "
245 "primary image is JPEG compressed, this designation is "
246 "not necessary and is omitted. When thumbnails use JPEG "
247 "compression, this tag value is set to 6."),
248 { ESL_MMMN, ESL_MMMM, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
249 {EXIF_TAG_PHOTOMETRIC_INTERPRETATION, "PhotometricInterpretation",
250 N_("Photometric Interpretation"),
251 N_("The pixel composition. In JPEG compressed data a JPEG "
252 "marker is used instead of this tag."),
253 { ESL_MMMN, ESL_MMMN, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
254 /* Not in EXIF 2.2 */
255 {EXIF_TAG_FILL_ORDER, "FillOrder", N_("Fill Order"), "", ESL_UNKNOWN},
256 /* Not in EXIF 2.2 */
257 {EXIF_TAG_DOCUMENT_NAME, "DocumentName", N_("Document Name"), "",
259 {EXIF_TAG_IMAGE_DESCRIPTION, "ImageDescription",
260 N_("Image Description"),
261 N_("A character string giving the title of the image. It may be "
262 "a comment such as \"1988 company picnic\" or "
263 "the like. Two-bytes character codes cannot be used. "
264 "When a 2-bytes code is necessary, the Exif Private tag "
265 "<UserComment> is to be used."),
266 { ESL_OOOO, ESL_OOOO, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
267 {EXIF_TAG_MAKE, "Make", N_("Manufacturer"),
268 N_("The manufacturer of the recording "
269 "equipment. This is the manufacturer of the DSC, scanner, "
270 "video digitizer or other equipment that generated the "
271 "image. When the field is left blank, it is treated as "
273 { ESL_OOOO, ESL_OOOO, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
274 {EXIF_TAG_MODEL, "Model", N_("Model"),
275 N_("The model name or model number of the equipment. This is the "
276 "model name or number of the DSC, scanner, video digitizer "
277 "or other equipment that generated the image. When the field "
278 "is left blank, it is treated as unknown."),
279 { ESL_OOOO, ESL_OOOO, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
280 {EXIF_TAG_STRIP_OFFSETS, "StripOffsets", N_("Strip Offsets"),
281 N_("For each strip, the byte offset of that strip. It is "
282 "recommended that this be selected so the number of strip "
283 "bytes does not exceed 64 Kbytes. With JPEG compressed "
284 "data this designation is not needed and is omitted. See also "
285 "<RowsPerStrip> and <StripByteCounts>."),
286 { ESL_MMMN, ESL_MMMN, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
287 {EXIF_TAG_ORIENTATION, "Orientation", N_("Orientation"),
288 N_("The image orientation viewed in terms of rows and columns."),
289 { ESL_OOOO, ESL_OOOO, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
290 {EXIF_TAG_SAMPLES_PER_PIXEL, "SamplesPerPixel",
291 N_("Samples per Pixel"),
292 N_("The number of components per pixel. Since this standard applies "
293 "to RGB and YCbCr images, the value set for this tag is 3. "
294 "In JPEG compressed data a JPEG marker is used instead of this "
296 { ESL_MMMN, ESL_MMMN, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
297 {EXIF_TAG_ROWS_PER_STRIP, "RowsPerStrip", N_("Rows per Strip"),
298 N_("The number of rows per strip. This is the number of rows "
299 "in the image of one strip when an image is divided into "
300 "strips. With JPEG compressed data this designation is not "
301 "needed and is omitted. See also <StripOffsets> and "
302 "<StripByteCounts>."),
303 { ESL_MMMN, ESL_MMMN, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
304 {EXIF_TAG_STRIP_BYTE_COUNTS, "StripByteCounts", N_("Strip Byte Count"),
305 N_("The total number of bytes in each strip. With JPEG compressed "
306 "data this designation is not needed and is omitted."),
307 { ESL_MMMN, ESL_MMMN, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
308 {EXIF_TAG_X_RESOLUTION, "XResolution", N_("X-Resolution"),
309 N_("The number of pixels per <ResolutionUnit> in the <ImageWidth> "
310 "direction. When the image resolution is unknown, 72 [dpi] "
312 { ESL_MMMM, ESL_MMMM, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
313 {EXIF_TAG_Y_RESOLUTION, "YResolution", N_("Y-Resolution"),
314 N_("The number of pixels per <ResolutionUnit> in the <ImageLength> "
315 "direction. The same value as <XResolution> is designated."),
316 { ESL_MMMM, ESL_MMMM, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
317 {EXIF_TAG_PLANAR_CONFIGURATION, "PlanarConfiguration",
318 N_("Planar Configuration"),
319 N_("Indicates whether pixel components are recorded in a chunky "
320 "or planar format. In JPEG compressed files a JPEG marker "
321 "is used instead of this tag. If this field does not exist, "
322 "the TIFF default of 1 (chunky) is assumed."),
323 { ESL_OMON, ESL_OMON, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
324 {EXIF_TAG_RESOLUTION_UNIT, "ResolutionUnit", N_("Resolution Unit"),
325 N_("The unit for measuring <XResolution> and <YResolution>. The same "
326 "unit is used for both <XResolution> and <YResolution>. If "
327 "the image resolution is unknown, 2 (inches) is designated."),
328 { ESL_MMMM, ESL_MMMM, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
329 {EXIF_TAG_TRANSFER_FUNCTION, "TransferFunction",
330 N_("Transfer Function"),
331 N_("A transfer function for the image, described in tabular style. "
332 "Normally this tag is not necessary, since color space is "
333 "specified in the color space information tag (<ColorSpace>)."),
334 { ESL_OOOO, ESL_OOOO, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
335 {EXIF_TAG_SOFTWARE, "Software", N_("Software"),
336 N_("This tag records the name and version of the software or "
337 "firmware of the camera or image input device used to "
338 "generate the image. The detailed format is not specified, but "
339 "it is recommended that the example shown below be "
340 "followed. When the field is left blank, it is treated as "
342 { ESL_OOOO, ESL_OOOO, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
343 {EXIF_TAG_DATE_TIME, "DateTime", N_("Date and Time"),
344 N_("The date and time of image creation. In this standard "
345 "(EXIF-2.1) it is the date and time the file was changed."),
346 { ESL_OOOO, ESL_OOOO, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
347 {EXIF_TAG_ARTIST, "Artist", N_("Artist"),
348 N_("This tag records the name of the camera owner, photographer or "
349 "image creator. The detailed format is not specified, but it is "
350 "recommended that the information be written as in the example "
351 "below for ease of Interoperability. When the field is "
352 "left blank, it is treated as unknown."),
353 { ESL_OOOO, ESL_OOOO, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
354 {EXIF_TAG_WHITE_POINT, "WhitePoint", N_("White Point"),
355 N_("The chromaticity of the white point of the image. Normally "
356 "this tag is not necessary, since color space is specified "
357 "in the color space information tag (<ColorSpace>)."),
358 { ESL_OOOO, ESL_OOOO, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
359 {EXIF_TAG_PRIMARY_CHROMATICITIES, "PrimaryChromaticities",
360 N_("Primary Chromaticities"),
361 N_("The chromaticity of the three primary colors of the image. "
362 "Normally this tag is not necessary, since color space is "
363 "specified in the color space information tag (<ColorSpace>)."),
364 { ESL_OOOO, ESL_OOOO, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
365 /* Not in EXIF 2.2 */
366 {EXIF_TAG_SUB_IFDS, "SubIFDs", "SubIFD Offsets", N_("Defined by Adobe Corporation "
367 "to enable TIFF Trees within a TIFF file."), ESL_UNKNOWN},
368 /* Not in EXIF 2.2 */
369 {EXIF_TAG_TRANSFER_RANGE, "TransferRange", N_("Transfer Range"), "",
371 /* Not in EXIF 2.2 */
372 {EXIF_TAG_JPEG_PROC, "JPEGProc", "JPEGProc", "", ESL_UNKNOWN},
373 {EXIF_TAG_JPEG_INTERCHANGE_FORMAT, "JPEGInterchangeFormat",
374 N_("JPEG Interchange Format"),
375 N_("The offset to the start byte (SOI) of JPEG compressed "
376 "thumbnail data. This is not used for primary image "
378 { ESL_NNNN, ESL_NNNM, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
379 {EXIF_TAG_JPEG_INTERCHANGE_FORMAT_LENGTH,
380 "JPEGInterchangeFormatLength", N_("JPEG Interchange Format Length"),
381 N_("The number of bytes of JPEG compressed thumbnail data. This "
382 "is not used for primary image JPEG data. JPEG thumbnails "
383 "are not divided but are recorded as a continuous JPEG "
384 "bitstream from SOI to EOI. Appn and COM markers should "
385 "not be recorded. Compressed thumbnails must be recorded in no "
386 "more than 64 Kbytes, including all other data to be "
387 "recorded in APP1."),
388 { ESL_NNNN, ESL_NNNM, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
389 {EXIF_TAG_YCBCR_COEFFICIENTS, "YCbCrCoefficients",
390 N_("YCbCr Coefficients"),
391 N_("The matrix coefficients for transformation from RGB to YCbCr "
392 "image data. No default is given in TIFF; but here the "
393 "value given in \"Color Space Guidelines\", is used "
394 "as the default. The color space is declared in a "
395 "color space information tag, with the default being the value "
396 "that gives the optimal image characteristics "
397 "Interoperability this condition."),
398 { ESL_NNOO, ESL_NNOO, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
399 {EXIF_TAG_YCBCR_SUB_SAMPLING, "YCbCrSubSampling",
400 N_("YCbCr Sub-Sampling"),
401 N_("The sampling ratio of chrominance components in relation to the "
402 "luminance component. In JPEG compressed data a JPEG marker "
403 "is used instead of this tag."),
404 { ESL_NNMN, ESL_NNMN, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
405 {EXIF_TAG_YCBCR_POSITIONING, "YCbCrPositioning",
406 N_("YCbCr Positioning"),
407 N_("The position of chrominance components in relation to the "
408 "luminance component. This field is designated only for "
409 "JPEG compressed data or uncompressed YCbCr data. The TIFF "
410 "default is 1 (centered); but when Y:Cb:Cr = 4:2:2 it is "
411 "recommended in this standard that 2 (co-sited) be used to "
412 "record data, in order to improve the image quality when viewed "
413 "on TV systems. When this field does not exist, the reader shall "
414 "assume the TIFF default. In the case of Y:Cb:Cr = 4:2:0, the "
415 "TIFF default (centered) is recommended. If the reader "
416 "does not have the capability of supporting both kinds of "
417 "<YCbCrPositioning>, it shall follow the TIFF default regardless "
418 "of the value in this field. It is preferable that readers "
419 "be able to support both centered and co-sited positioning."),
420 { ESL_NNMM, ESL_NNOO, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
421 {EXIF_TAG_REFERENCE_BLACK_WHITE, "ReferenceBlackWhite",
422 N_("Reference Black/White"),
423 N_("The reference black point value and reference white point "
424 "value. No defaults are given in TIFF, but the values "
425 "below are given as defaults here. The color space is declared "
426 "in a color space information tag, with the default "
427 "being the value that gives the optimal image characteristics "
428 "Interoperability these conditions."),
429 { ESL_OOOO, ESL_OOOO, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
430 /* Not in EXIF 2.2 */
431 {EXIF_TAG_XML_PACKET, "XMLPacket", N_("XML Packet"), N_("XMP Metadata"),
433 /* Not in EXIF 2.2 */
434 {EXIF_TAG_RELATED_IMAGE_FILE_FORMAT, "RelatedImageFileFormat",
435 "RelatedImageFileFormat", "", ESL_UNKNOWN},
436 /* Not in EXIF 2.2 */
437 {EXIF_TAG_RELATED_IMAGE_WIDTH, "RelatedImageWidth",
438 "RelatedImageWidth", "", ESL_UNKNOWN},
439 /* Not in EXIF 2.2 */
440 {EXIF_TAG_RELATED_IMAGE_LENGTH, "RelatedImageLength",
441 "RelatedImageLength", "", ESL_UNKNOWN},
442 /* Not in EXIF 2.2 */
443 {EXIF_TAG_CFA_REPEAT_PATTERN_DIM, "CFARepeatPatternDim",
444 "CFARepeatPatternDim", "", ESL_UNKNOWN},
445 /* Not in EXIF 2.2 */
446 {EXIF_TAG_CFA_PATTERN, "CFAPattern",
448 N_("Indicates the color filter array (CFA) geometric pattern of the "
449 "image sensor when a one-chip color area sensor is used. "
450 "It does not apply to all sensing methods."), ESL_UNKNOWN},
451 /* Not in EXIF 2.2 */
452 {EXIF_TAG_BATTERY_LEVEL, "BatteryLevel", N_("Battery Level"), "",
454 {EXIF_TAG_COPYRIGHT, "Copyright", N_("Copyright"),
455 N_("Copyright information. In this standard the tag is used to "
456 "indicate both the photographer and editor copyrights. It is "
457 "the copyright notice of the person or organization claiming "
458 "rights to the image. The Interoperability copyright "
459 "statement including date and rights should be written in this "
460 "field; e.g., \"Copyright, John Smith, 19xx. All rights "
461 "reserved.\". In this standard the field records both the "
462 "photographer and editor copyrights, with each recorded in a "
463 "separate part of the statement. When there is a clear "
464 "distinction between the photographer and editor copyrights, "
465 "these are to be written in the order of photographer followed "
466 "by editor copyright, separated by NULL (in this case, "
467 "since the statement also ends with a NULL, there are two NULL "
468 "codes) (see example 1). When only the photographer is given, "
469 "it is terminated by one NULL code (see example 2). When only "
470 "the editor copyright is given, "
471 "the photographer copyright part consists of one space followed "
472 "by a terminating NULL code, then the editor copyright is given "
473 "(see example 3). When the field is left blank, it is treated "
475 { ESL_OOOO, ESL_OOOO, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
476 {EXIF_TAG_EXPOSURE_TIME, "ExposureTime", N_("Exposure Time"),
477 N_("Exposure time, given in seconds (sec)."),
478 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
479 {EXIF_TAG_FNUMBER, "FNumber", N_("F-Number"),
481 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
482 /* Not in EXIF 2.2 */
483 {EXIF_TAG_IPTC_NAA, "IPTC/NAA", "IPTC/NAA", "", ESL_UNKNOWN},
484 /* Not in EXIF 2.2 */
485 {EXIF_TAG_IMAGE_RESOURCES, "ImageResources", N_("Image Resources Block"), "",
487 {EXIF_TAG_EXIF_IFD_POINTER, "ExifIfdPointer", "ExifIFDPointer",
488 N_("A pointer to the Exif IFD. Interoperability, Exif IFD has the "
489 "same structure as that of the IFD specified in TIFF. "
490 "ordinarily, however, it does not contain image data as in "
491 "the case of TIFF."),
492 { ESL_NNNN, ESL_NNNN, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
493 /* Not in EXIF 2.2 */
494 {EXIF_TAG_INTER_COLOR_PROFILE, "InterColorProfile",
495 "InterColorProfile", "", ESL_UNKNOWN},
496 {EXIF_TAG_EXPOSURE_PROGRAM, "ExposureProgram", N_("Exposure Program"),
497 N_("The class of the program used by the camera to set exposure "
498 "when the picture is taken."),
499 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
500 {EXIF_TAG_SPECTRAL_SENSITIVITY, "SpectralSensitivity",
501 N_("Spectral Sensitivity"),
502 N_("Indicates the spectral sensitivity of each channel of the "
503 "camera used. The tag value is an ASCII string compatible "
504 "with the standard developed by the ASTM Technical Committee."),
505 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
506 {EXIF_TAG_GPS_INFO_IFD_POINTER, "GPSInfoIFDPointer",
507 N_("GPS Info IFD Pointer"),
508 N_("A pointer to the GPS Info IFD. The "
509 "Interoperability structure of the GPS Info IFD, like that of "
510 "Exif IFD, has no image data."),
511 { ESL_NNNN, ESL_NNNN, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
513 {EXIF_TAG_ISO_SPEED_RATINGS, "ISOSpeedRatings",
514 N_("ISO Speed Ratings"),
515 N_("Indicates the ISO Speed and ISO Latitude of the camera or "
516 "input device as specified in ISO 12232."),
517 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
518 {EXIF_TAG_OECF, "OECF", N_("Opto-Electronic Conversion Function"),
519 N_("Indicates the Opto-Electronic Conversion Function (OECF) "
520 "specified in ISO 14524. <OECF> is the relationship between "
521 "the camera optical input and the image values."),
522 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
523 /* Not in EXIF 2.2 */
524 {EXIF_TAG_TIME_ZONE_OFFSET, "TimeZoneOffset", N_("Time Zone Offset"),
525 N_("Encodes time zone of camera clock relative to GMT."),
527 {EXIF_TAG_EXIF_VERSION, "ExifVersion", N_("Exif Version"),
528 N_("The version of this standard supported. Nonexistence of this "
529 "field is taken to mean nonconformance to the standard."),
530 { ESL_NNNN, ESL_NNNN, ESL_MMMM, ESL_NNNN, ESL_NNNN } },
531 {EXIF_TAG_DATE_TIME_ORIGINAL, "DateTimeOriginal",
532 N_("Date and Time (Original)"),
533 N_("The date and time when the original image data was generated. "
534 "For a digital still camera "
535 "the date and time the picture was taken are recorded."),
536 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
537 {EXIF_TAG_DATE_TIME_DIGITIZED, "DateTimeDigitized",
538 N_("Date and Time (Digitized)"),
539 N_("The date and time when the image was stored as digital data."),
540 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
541 {EXIF_TAG_COMPONENTS_CONFIGURATION, "ComponentsConfiguration",
542 N_("Components Configuration"),
543 N_("Information specific to compressed data. The channels of "
544 "each component are arranged in order from the 1st "
545 "component to the 4th. For uncompressed data the data "
546 "arrangement is given in the <PhotometricInterpretation> tag. "
547 "However, since <PhotometricInterpretation> can only "
548 "express the order of Y, Cb and Cr, this tag is provided "
549 "for cases when compressed data uses components other than "
550 "Y, Cb, and Cr and to enable support of other sequences."),
551 { ESL_NNNN, ESL_NNNN, ESL_NNNM, ESL_NNNN, ESL_NNNN } },
552 {EXIF_TAG_COMPRESSED_BITS_PER_PIXEL, "CompressedBitsPerPixel",
553 N_("Compressed Bits per Pixel"),
554 N_("Information specific to compressed data. The compression mode "
555 "used for a compressed image is indicated in unit bits "
557 { ESL_NNNN, ESL_NNNN, ESL_NNNO, ESL_NNNN, ESL_NNNN } },
558 {EXIF_TAG_SHUTTER_SPEED_VALUE, "ShutterSpeedValue", N_("Shutter Speed"),
559 N_("Shutter speed. The unit is the APEX (Additive System of "
560 "Photographic Exposure) setting."),
561 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
562 {EXIF_TAG_APERTURE_VALUE, "ApertureValue", N_("Aperture"),
563 N_("The lens aperture. The unit is the APEX value."),
564 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
565 {EXIF_TAG_BRIGHTNESS_VALUE, "BrightnessValue", N_("Brightness"),
566 N_("The value of brightness. The unit is the APEX value. "
567 "Ordinarily it is given in the range of -99.99 to 99.99."),
568 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
569 {EXIF_TAG_EXPOSURE_BIAS_VALUE, "ExposureBiasValue",
571 N_("The exposure bias. The units is the APEX value. Ordinarily "
572 "it is given in the range of -99.99 to 99.99."),
573 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
574 {EXIF_TAG_MAX_APERTURE_VALUE, "MaxApertureValue", N_("Maximum Aperture Value"),
575 N_("The smallest F number of the lens. The unit is the APEX value. "
576 "Ordinarily it is given in the range of 00.00 to 99.99, "
577 "but it is not limited to this range."),
578 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
579 {EXIF_TAG_SUBJECT_DISTANCE, "SubjectDistance",
580 N_("Subject Distance"),
581 N_("The distance to the subject, given in meters."),
582 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
583 {EXIF_TAG_METERING_MODE, "MeteringMode", N_("Metering Mode"),
584 N_("The metering mode."),
585 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
586 {EXIF_TAG_LIGHT_SOURCE, "LightSource", N_("Light Source"),
587 N_("The kind of light source."),
588 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
589 {EXIF_TAG_FLASH, "Flash", N_("Flash"),
590 N_("This tag is recorded when an image is taken using a strobe "
592 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
593 {EXIF_TAG_FOCAL_LENGTH, "FocalLength", N_("Focal Length"),
594 N_("The actual focal length of the lens, in mm. Conversion is not "
595 "made to the focal length of a 35 mm film camera."),
596 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
597 {EXIF_TAG_SUBJECT_AREA, "SubjectArea", N_("Subject Area"),
598 N_("This tag indicates the location and area of the main subject "
599 "in the overall scene."),
600 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
601 /* Not in EXIF 2.2 */
602 {EXIF_TAG_TIFF_EP_STANDARD_ID, "TIFF/EPStandardID", N_("TIFF/EP Standard ID"), "",
604 {EXIF_TAG_MAKER_NOTE, "MakerNote", N_("Maker Note"),
605 N_("A tag for manufacturers of Exif writers to record any desired "
606 "information. The contents are up to the manufacturer."),
607 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
608 {EXIF_TAG_USER_COMMENT, "UserComment", N_("User Comment"),
609 N_("A tag for Exif users to write keywords or comments on the image "
610 "besides those in <ImageDescription>, and without the "
611 "character code limitations of the <ImageDescription> tag. The "
612 "character code used in the <UserComment> tag is identified "
613 "based on an ID code in a fixed 8-byte area at the start of "
614 "the tag data area. The unused portion of the area is padded "
615 "with NULL (\"00.h\"). ID codes are assigned by means of "
616 "registration. The designation method and references for each "
617 "character code are defined in the specification. The value of "
618 "CountN is determined based on the 8 bytes in the character code "
619 "area and the number of bytes in the user comment part. Since "
620 "the TYPE is not ASCII, NULL termination is not necessary. "
621 "The ID code for the <UserComment> area may be a Defined code "
622 "such as JIS or ASCII, or may be Undefined. The Undefined name "
623 "is UndefinedText, and the ID code is filled with 8 bytes of all "
624 "\"NULL\" (\"00.H\"). An Exif reader that reads the "
625 "<UserComment> tag must have a function for determining the "
626 "ID code. This function is not required in Exif readers that "
627 "do not use the <UserComment> tag. "
628 "When a <UserComment> area is set aside, it is recommended that "
629 "the ID code be ASCII and that the following user comment "
630 "part be filled with blank characters [20.H]."),
631 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
632 {EXIF_TAG_SUB_SEC_TIME, "SubsecTime", N_("Sub-second Time"),
633 N_("A tag used to record fractions of seconds for the "
635 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
636 {EXIF_TAG_SUB_SEC_TIME_ORIGINAL, "SubSecTimeOriginal",
637 N_("Sub-second Time (Original)"),
638 N_("A tag used to record fractions of seconds for the "
639 "<DateTimeOriginal> tag."),
640 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
641 {EXIF_TAG_SUB_SEC_TIME_DIGITIZED, "SubSecTimeDigitized",
642 N_("Sub-second Time (Digitized)"),
643 N_("A tag used to record fractions of seconds for the "
644 "<DateTimeDigitized> tag."),
645 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
646 /* Not in EXIF 2.2 (Microsoft extension) */
647 {EXIF_TAG_XP_TITLE, "XPTitle", N_("XP Title"),
648 N_("A character string giving the title of the image, encoded in "
650 { ESL_OOOO, ESL_NNNN, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
651 /* Not in EXIF 2.2 (Microsoft extension) */
652 {EXIF_TAG_XP_COMMENT, "XPComment", N_("XP Comment"),
653 N_("A character string containing a comment about the image, encoded "
655 { ESL_OOOO, ESL_NNNN, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
656 /* Not in EXIF 2.2 (Microsoft extension) */
657 {EXIF_TAG_XP_AUTHOR, "XPAuthor", N_("XP Author"),
658 N_("A character string containing the name of the image creator, "
659 "encoded in UTF-16LE."),
660 { ESL_OOOO, ESL_NNNN, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
661 /* Not in EXIF 2.2 (Microsoft extension) */
662 {EXIF_TAG_XP_KEYWORDS, "XPKeywords", N_("XP Keywords"),
663 N_("A character string containing key words describing the image, "
664 "encoded in UTF-16LE."),
665 { ESL_OOOO, ESL_NNNN, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
666 /* Not in EXIF 2.2 (Microsoft extension) */
667 {EXIF_TAG_XP_SUBJECT, "XPSubject", N_("XP Subject"),
668 N_("A character string giving the image subject, encoded in "
670 { ESL_OOOO, ESL_NNNN, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
671 {EXIF_TAG_FLASH_PIX_VERSION, "FlashpixVersion", "FlashPixVersion",
672 N_("The FlashPix format version supported by a FPXR file."),
673 { ESL_NNNN, ESL_NNNN, ESL_MMMM, ESL_NNNN, ESL_NNNN } },
674 {EXIF_TAG_COLOR_SPACE, "ColorSpace", N_("Color Space"),
675 N_("The color space information tag is always "
676 "recorded as the color space specifier. Normally sRGB (=1) "
677 "is used to define the color space based on the PC monitor "
678 "conditions and environment. If a color space other than "
679 "sRGB is used, Uncalibrated (=FFFF.H) is set. Image data "
680 "recorded as Uncalibrated can be treated as sRGB when it is "
681 "converted to FlashPix."),
682 { ESL_NNNN, ESL_NNNN, ESL_MMMM, ESL_NNNN, ESL_NNNN } },
683 {EXIF_TAG_PIXEL_X_DIMENSION, "PixelXDimension", N_("Pixel X Dimension"),
684 N_("Information specific to compressed data. When a "
685 "compressed file is recorded, the valid width of the "
686 "meaningful image must be recorded in this tag, whether or "
687 "not there is padding data or a restart marker. This tag "
688 "should not exist in an uncompressed file."),
689 { ESL_NNNN, ESL_NNNN, ESL_NNNM, ESL_NNNN, ESL_NNNN } },
690 {EXIF_TAG_PIXEL_Y_DIMENSION, "PixelYDimension", N_("Pixel Y Dimension"),
691 N_("Information specific to compressed data. When a compressed "
692 "file is recorded, the valid height of the meaningful image "
693 "must be recorded in this tag, whether or not there is padding "
694 "data or a restart marker. This tag should not exist in an "
695 "uncompressed file. "
696 "Since data padding is unnecessary in the vertical direction, "
697 "the number of lines recorded in this valid image height tag "
698 "will in fact be the same as that recorded in the SOF."),
699 { ESL_NNNN, ESL_NNNN, ESL_NNNM, ESL_NNNN, ESL_NNNN } },
700 {EXIF_TAG_RELATED_SOUND_FILE, "RelatedSoundFile",
701 N_("Related Sound File"),
702 N_("This tag is used to record the name of an audio file related "
703 "to the image data. The only relational information "
704 "recorded here is the Exif audio file name and extension (an "
705 "ASCII string consisting of 8 characters + '.' + 3 "
706 "characters). The path is not recorded. Stipulations on audio "
707 "and file naming conventions are defined in the specification. "
708 "When using this tag, audio files must be recorded in "
709 "conformance to the Exif audio format. Writers are also allowed "
710 "to store the data such as Audio within APP2 as FlashPix "
711 "extension stream data. "
712 "The mapping of Exif image files and audio files is done "
713 "in any of three ways, [1], [2] and [3]. If multiple files "
714 "are mapped to one file as in [2] or [3], the above "
715 "format is used to record just one audio file name. If "
716 "there are multiple audio files, the first recorded file is "
717 "given. In the case of [3], for example, for the "
718 "Exif image file \"DSC00001.JPG\" only \"SND00001.WAV\" is "
719 "given as the related Exif audio file. When there are three "
720 "Exif audio files \"SND00001.WAV\", \"SND00002.WAV\" and "
721 "\"SND00003.WAV\", the Exif image file name for each of them, "
722 "\"DSC00001.JPG\", is indicated. By combining multiple "
723 "relational information, a variety of playback possibilities "
724 "can be supported. The method of using relational information "
725 "is left to the implementation on the playback side. Since this "
726 "information is an ASCII character string, it is terminated by "
727 "NULL. When this tag is used to map audio files, the relation "
728 "of the audio file to image data must also be indicated on the "
730 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
731 {EXIF_TAG_INTEROPERABILITY_IFD_POINTER, "InteroperabilityIFDPointer",
732 N_("Interoperability IFD Pointer"),
733 N_("Interoperability IFD is composed of tags which stores the "
734 "information to ensure the Interoperability and pointed "
735 "by the following tag located in Exif IFD. "
736 "The Interoperability structure of Interoperability IFD is "
737 "the same as TIFF defined IFD structure "
738 "but does not contain the "
739 "image data characteristically compared with normal TIFF "
741 { ESL_NNNN, ESL_NNNN, ESL_NNNN, ESL_NNNN, ESL_NNNN } },
742 {EXIF_TAG_FLASH_ENERGY, "FlashEnergy", N_("Flash Energy"),
743 N_("Indicates the strobe energy at the time the image is "
744 "captured, as measured in Beam Candle Power Seconds (BCPS)."),
745 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
746 {EXIF_TAG_SPATIAL_FREQUENCY_RESPONSE, "SpatialFrequencyResponse",
747 N_("Spatial Frequency Response"),
748 N_("This tag records the camera or input device spatial frequency "
749 "table and SFR values in the direction of image width, "
750 "image height, and diagonal direction, as specified in ISO "
752 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
753 {EXIF_TAG_FOCAL_PLANE_X_RESOLUTION, "FocalPlaneXResolution",
754 N_("Focal Plane X-Resolution"),
755 N_("Indicates the number of pixels in the image width (X) direction "
756 "per <FocalPlaneResolutionUnit> on the camera focal plane."),
757 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
758 {EXIF_TAG_FOCAL_PLANE_Y_RESOLUTION, "FocalPlaneYResolution",
759 N_("Focal Plane Y-Resolution"),
760 N_("Indicates the number of pixels in the image height (V) direction "
761 "per <FocalPlaneResolutionUnit> on the camera focal plane."),
762 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
763 {EXIF_TAG_FOCAL_PLANE_RESOLUTION_UNIT, "FocalPlaneResolutionUnit",
764 N_("Focal Plane Resolution Unit"),
765 N_("Indicates the unit for measuring <FocalPlaneXResolution> and "
766 "<FocalPlaneYResolution>. This value is the same as the "
767 "<ResolutionUnit>."),
768 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
769 {EXIF_TAG_SUBJECT_LOCATION, "SubjectLocation",
770 N_("Subject Location"),
771 N_("Indicates the location of the main subject in the scene. The "
772 "value of this tag represents the pixel at the center of the "
773 "main subject relative to the left edge, prior to rotation "
774 "processing as per the <Rotation> tag. The first value "
775 "indicates the X column number and the second indicates "
776 "the Y row number."),
777 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
778 {EXIF_TAG_EXPOSURE_INDEX, "ExposureIndex", N_("Exposure Index"),
779 N_("Indicates the exposure index selected on the camera or "
780 "input device at the time the image is captured."),
781 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
782 {EXIF_TAG_SENSING_METHOD, "SensingMethod", N_("Sensing Method"),
783 N_("Indicates the image sensor type on the camera or input "
785 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
786 {EXIF_TAG_FILE_SOURCE, "FileSource", N_("File Source"),
787 N_("Indicates the image source. If a DSC recorded the image, "
788 "the tag value of this tag always be set to 3, indicating "
789 "that the image was recorded on a DSC."),
790 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
791 {EXIF_TAG_SCENE_TYPE, "SceneType", N_("Scene Type"),
792 N_("Indicates the type of scene. If a DSC recorded the image, "
793 "this tag value must always be set to 1, indicating that the "
794 "image was directly photographed."),
795 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
796 {EXIF_TAG_NEW_CFA_PATTERN, "CFAPattern",
798 N_("Indicates the color filter array (CFA) geometric pattern of the "
799 "image sensor when a one-chip color area sensor is used. "
800 "It does not apply to all sensing methods."),
801 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
802 {EXIF_TAG_CUSTOM_RENDERED, "CustomRendered", N_("Custom Rendered"),
803 N_("This tag indicates the use of special processing on image "
804 "data, such as rendering geared to output. When special "
805 "processing is performed, the reader is expected to disable "
806 "or minimize any further processing."),
807 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
808 {EXIF_TAG_EXPOSURE_MODE, "ExposureMode", N_("Exposure Mode"),
809 N_("This tag indicates the exposure mode set when the image was "
810 "shot. In auto-bracketing mode, the camera shoots a series of "
811 "frames of the same scene at different exposure settings."),
812 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
813 {EXIF_TAG_WHITE_BALANCE, "WhiteBalance", N_("White Balance"),
814 N_("This tag indicates the white balance mode set when the image "
816 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
817 {EXIF_TAG_DIGITAL_ZOOM_RATIO, "DigitalZoomRatio",
818 N_("Digital Zoom Ratio"),
819 N_("This tag indicates the digital zoom ratio when the image was "
820 "shot. If the numerator of the recorded value is 0, this "
821 "indicates that digital zoom was not used."),
822 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
823 {EXIF_TAG_FOCAL_LENGTH_IN_35MM_FILM, "FocalLengthIn35mmFilm",
824 N_("Focal Length in 35mm Film"),
825 N_("This tag indicates the equivalent focal length assuming a "
826 "35mm film camera, in mm. A value of 0 means the focal "
827 "length is unknown. Note that this tag differs from the "
829 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
830 {EXIF_TAG_SCENE_CAPTURE_TYPE, "SceneCaptureType",
831 N_("Scene Capture Type"),
832 N_("This tag indicates the type of scene that was shot. It can "
833 "also be used to record the mode in which the image was "
834 "shot. Note that this differs from the scene type "
836 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
837 {EXIF_TAG_GAIN_CONTROL, "GainControl", N_("Gain Control"),
838 N_("This tag indicates the degree of overall image gain "
840 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
841 {EXIF_TAG_CONTRAST, "Contrast", N_("Contrast"),
842 N_("This tag indicates the direction of contrast processing "
843 "applied by the camera when the image was shot."),
844 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
845 {EXIF_TAG_SATURATION, "Saturation", N_("Saturation"),
846 N_("This tag indicates the direction of saturation processing "
847 "applied by the camera when the image was shot."),
848 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
849 {EXIF_TAG_SHARPNESS, "Sharpness", N_("Sharpness"),
850 N_("This tag indicates the direction of sharpness processing "
851 "applied by the camera when the image was shot."),
852 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
853 {EXIF_TAG_DEVICE_SETTING_DESCRIPTION, "DeviceSettingDescription",
854 N_("Device Setting Description"),
855 N_("This tag indicates information on the picture-taking "
856 "conditions of a particular camera model. The tag is used "
857 "only to indicate the picture-taking conditions in the "
859 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
860 {EXIF_TAG_SUBJECT_DISTANCE_RANGE, "SubjectDistanceRange",
861 N_("Subject Distance Range"),
862 N_("This tag indicates the distance to the subject."),
863 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
864 {EXIF_TAG_IMAGE_UNIQUE_ID, "ImageUniqueID", N_("Image Unique ID"),
865 N_("This tag indicates an identifier assigned uniquely to "
866 "each image. It is recorded as an ASCII string equivalent "
867 "to hexadecimal notation and 128-bit fixed length."),
868 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
870 {EXIF_TAG_CAMERA_OWNER_NAME, "CameraOwnerName", N_("Camera Owner Name"),
871 N_("This tag indicates the name of the camera owner, "
872 "photographer or image creator."),
873 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
875 {EXIF_TAG_BODY_SERIAL_NUMBER, "BodySerialNumber", N_("Body Serial Number"),
876 N_("This tag indicates the serial number of the body of the camera"),
877 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
879 {EXIF_TAG_LENS_SPECIFICATION, "LensSpecification", N_("Lens Specification"),
880 N_("This tag indicates minimum focal length, "
881 "maximum focal length, minimum F number in the "
882 "minimum focal length, and minimum F number in "
883 "the maximum focal length."),
884 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
886 {EXIF_TAG_LENS_MAKE, "LensMake", N_("Lens Make"),
887 N_("This tag indicates the lens manufacturer."),
888 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
890 {EXIF_TAG_LENS_MODEL, "LensModel", N_("Lens Model"),
891 N_("This tag indicates the lens' model name and model number."),
892 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
894 {EXIF_TAG_LENS_SERIAL_NUMBER, "LensSerialNumber", N_("Lens Serial Number"),
895 N_("This tag indicates the serial number of the interchangeable lens."),
896 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
898 {EXIF_TAG_COMPOSITE_IMAGE, "CompositeImage", N_("Composite Image"),
899 N_("This tag indicates whether this image was composed from multiple images"),
900 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
902 {EXIF_TAG_SOURCE_IMAGE_NUMBER_OF_COMPOSITE_IMAGE, "SourceImageNumberOfCompositeImage", N_("Source Image Number Of Composite Image"),
903 N_("This tag indicates how many images are included and used in the composition of this image"),
904 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
906 {EXIF_TAG_SOURCE_EXPOSURE_TIMES_OF_COMPOSITE_IMAGE, "SourceExposureTimesOfCompositeImage", N_("Source Exposure Times of Composite Image"),
907 N_("This tag indicates the exposure times of the source images of this image"),
908 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
910 {EXIF_TAG_GAMMA, "Gamma", N_("Gamma"),
911 N_("Indicates the value of coefficient gamma."),
912 { ESL_NNNN, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
913 /* Not in EXIF 2.2 */
914 {EXIF_TAG_PRINT_IMAGE_MATCHING, "PrintImageMatching", N_("PRINT Image Matching"),
915 N_("Related to Epson's PRINT Image Matching technology"),
917 /* Not in EXIF 2.2 (from the Microsoft HD Photo specification) */
918 {EXIF_TAG_PADDING, "Padding", N_("Padding"),
919 N_("This tag reserves space that can be reclaimed later when "
920 "additional metadata are added. New metadata can be written "
921 "in place by replacing this tag with a smaller data element "
922 "and using the reclaimed space to store the new or expanded "
924 { ESL_OOOO, ESL_NNNN, ESL_OOOO, ESL_NNNN, ESL_NNNN } },
926 {0, NULL, NULL, NULL, ESL_UNKNOWN}
929 /* For now, do not use these functions. */
932 * Return the number of entries in the EXIF tag table, including the
933 * terminating NULL entry.
936 exif_tag_table_count (void)
938 return sizeof (ExifTagTable) / sizeof (ExifTagTable[0]);
943 exif_tag_table_get_tag (unsigned int n)
945 return (n < exif_tag_table_count ()) ? ExifTagTable[n].tag : 0;
949 exif_tag_table_get_name (unsigned int n)
951 return (n < exif_tag_table_count ()) ? ExifTagTable[n].name : NULL;
955 * Compares the tag with that in entry.
956 * \param[in] tag pointer to integer tag value
957 * \param[in] entry pointer to a struct TagEntry
958 * \return 0 if tags are equal, <0 if tag < entry, >0 if tag > entry
961 match_tag(const void *tag, const void *entry)
963 return *(int*)tag - ((struct TagEntry *)entry)->tag;
968 * Finds the first entry in the EXIF tag table with the given tag number
969 * using a binary search.
970 * \param[in] tag to find
971 * \return index into table, or -1 if not found
974 exif_tag_table_first(ExifTag tag)
977 struct TagEntry *entry = bsearch(&tag, ExifTagTable,
978 exif_tag_table_count()-1, sizeof(struct TagEntry), match_tag);
980 return -1; /* Not found */
982 /* Calculate index of found entry */
983 i = entry - ExifTagTable;
985 /* There may be other entries with the same tag number, so search
986 * backwards to find the first
988 while ((i > 0) && (ExifTagTable[i-1].tag == tag)) {
995 ((ExifTagTable[i].esl[ifd][EXIF_DATA_TYPE_UNCOMPRESSED_CHUNKY] != EXIF_SUPPORT_LEVEL_NOT_RECORDED) || \
996 (ExifTagTable[i].esl[ifd][EXIF_DATA_TYPE_UNCOMPRESSED_PLANAR] != EXIF_SUPPORT_LEVEL_NOT_RECORDED) || \
997 (ExifTagTable[i].esl[ifd][EXIF_DATA_TYPE_UNCOMPRESSED_YCC] != EXIF_SUPPORT_LEVEL_NOT_RECORDED) || \
998 (ExifTagTable[i].esl[ifd][EXIF_DATA_TYPE_COMPRESSED] != EXIF_SUPPORT_LEVEL_NOT_RECORDED))
1001 exif_tag_get_name_in_ifd (ExifTag tag, ExifIfd ifd)
1006 if (ifd >= EXIF_IFD_COUNT)
1008 first = exif_tag_table_first(tag);
1012 for (i = first; ExifTagTable[i].name; i++) {
1013 if (ExifTagTable[i].tag == tag) {
1017 return NULL; /* Recorded tag not found in the table */
1019 return ExifTagTable[i].name;
1023 exif_tag_get_title_in_ifd (ExifTag tag, ExifIfd ifd)
1028 if (ifd >= EXIF_IFD_COUNT)
1030 first = exif_tag_table_first(tag);
1034 for (i = first; ExifTagTable[i].name; i++) {
1035 if (ExifTagTable[i].tag == tag) {
1039 return NULL; /* Recorded tag not found in the table */
1041 (void) bindtextdomain (GETTEXT_PACKAGE, LOCALEDIR);
1042 return _(ExifTagTable[i].title);
1046 exif_tag_get_description_in_ifd (ExifTag tag, ExifIfd ifd)
1051 if (ifd >= EXIF_IFD_COUNT)
1053 first = exif_tag_table_first(tag);
1057 for (i = first; ExifTagTable[i].name; i++) {
1058 if (ExifTagTable[i].tag == tag) {
1062 return NULL; /* Recorded tag not found in the table */
1065 /* GNU gettext acts strangely when given an empty string */
1066 if (!ExifTagTable[i].description || !*ExifTagTable[i].description)
1069 /* libexif should use the default system locale.
1070 * If an application specifically requires UTF-8, then we
1071 * must give the application a way to tell libexif that.
1073 * bind_textdomain_codeset (GETTEXT_PACKAGE, "UTF-8");
1075 (void) bindtextdomain (GETTEXT_PACKAGE, LOCALEDIR);
1076 return _(ExifTagTable[i].description);
1080 /**********************************************************************
1081 * convenience functions
1082 **********************************************************************/
1084 /* generic part: iterate through IFD list and return first result */
1085 typedef const char * (*get_stuff_func) (ExifTag tag, ExifIfd ifd);
1088 exif_tag_get_stuff (ExifTag tag, get_stuff_func func)
1090 /* Search IFDs in this order, in decreasing order of number of valid tags */
1091 static const ExifIfd ifds[EXIF_IFD_COUNT] = {
1095 EXIF_IFD_INTEROPERABILITY,
1099 for (i=0; i<EXIF_IFD_COUNT; i++) {
1100 const char *result = func(tag, ifds[i]);
1101 if (result != NULL) {
1105 return (const char *) NULL;
1108 /* explicit functions */
1110 exif_tag_get_name (ExifTag tag)
1112 return exif_tag_get_stuff(tag, exif_tag_get_name_in_ifd);
1116 exif_tag_get_title (ExifTag tag)
1118 return exif_tag_get_stuff(tag, exif_tag_get_title_in_ifd);
1122 exif_tag_get_description (ExifTag tag)
1124 return exif_tag_get_stuff(tag, exif_tag_get_description_in_ifd);
1130 exif_tag_from_name (const char *name)
1133 unsigned int result=0;
1135 if (!name) return 0;
1137 for (i = 0; ExifTagTable[i].name; i++)
1138 if (!strcmp (ExifTagTable[i].name, name)) {
1139 result = ExifTagTable[i].tag;
1145 /*! Return the support level of a tag in the given IFD with the given data
1146 * type. If the tag is not specified in the EXIF standard, this function
1147 * returns EXIF_SUPPORT_LEVEL_NOT_RECORDED.
1149 * \param[in] tag EXIF tag
1150 * \param[in] ifd a valid IFD (not EXIF_IFD_COUNT)
1151 * \param[in] t a valid data type (not EXIF_DATA_TYPE_UNKNOWN)
1152 * \return the level of support for this tag
1154 static inline ExifSupportLevel
1155 get_support_level_in_ifd (ExifTag tag, ExifIfd ifd, ExifDataType t)
1158 int first = exif_tag_table_first(tag);
1160 return EXIF_SUPPORT_LEVEL_NOT_RECORDED;
1162 for (i = first; ExifTagTable[i].name; i++) {
1163 if (ExifTagTable[i].tag == tag) {
1164 const ExifSupportLevel supp = ExifTagTable[i].esl[ifd][t];
1165 if (supp != EXIF_SUPPORT_LEVEL_NOT_RECORDED)
1167 /* Try looking for another entry */
1169 break; /* We've reached the end of the matching tags */
1172 return EXIF_SUPPORT_LEVEL_NOT_RECORDED;
1175 /*! Return the support level of a tag in the given IFD, regardless of the
1176 * data type. If the support level varies depending on the data type, this
1177 * function returns EXIF_SUPPORT_LEVEL_UNKNOWN. If the tag is not specified
1178 * in the EXIF standard, this function returns EXIF_SUPPORT_LEVEL_UNKNOWN.
1180 * \param[in] tag EXIF tag
1181 * \param[in] ifd a valid IFD (not EXIF_IFD_COUNT)
1182 * \return the level of support for this tag
1184 static inline ExifSupportLevel
1185 get_support_level_any_type (ExifTag tag, ExifIfd ifd)
1188 int first = exif_tag_table_first(tag);
1190 return EXIF_SUPPORT_LEVEL_UNKNOWN;
1192 for (i = first; ExifTagTable[i].name; i++) {
1193 if (ExifTagTable[i].tag == tag) {
1195 * Check whether the support level is the same for all possible
1196 * data types and isn't marked not recorded.
1198 const ExifSupportLevel supp = ExifTagTable[i].esl[ifd][0];
1199 /* If level is not recorded, keep searching for another */
1200 if (supp != EXIF_SUPPORT_LEVEL_NOT_RECORDED) {
1202 for (dt = 0; dt < EXIF_DATA_TYPE_COUNT; ++dt) {
1203 if (ExifTagTable[i].esl[ifd][dt] != supp)
1206 if (dt == EXIF_DATA_TYPE_COUNT)
1207 /* Support level is always the same, so return it */
1210 /* Keep searching the table for another tag for our IFD */
1212 break; /* We've reached the end of the matching tags */
1215 return EXIF_SUPPORT_LEVEL_UNKNOWN;
1219 exif_tag_get_support_level_in_ifd (ExifTag tag, ExifIfd ifd, ExifDataType t)
1221 if (ifd >= EXIF_IFD_COUNT)
1222 return EXIF_SUPPORT_LEVEL_UNKNOWN;
1224 if (t >= EXIF_DATA_TYPE_COUNT)
1225 return get_support_level_any_type (tag, ifd);
1227 return get_support_level_in_ifd (tag, ifd, t);