EXIF library (libexif) API  0.6.24
exif-tag.h
Go to the documentation of this file.
1 
4 /*
5  * Copyright (c) 2001 Lutz Mueller <lutz@users.sourceforge.net>
6  *
7  * This library is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU Lesser General Public
9  * License as published by the Free Software Foundation; either
10  * version 2 of the License, or (at your option) any later version.
11  *
12  * This library is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15  * Lesser General Public License for more details.
16  *
17  * You should have received a copy of the GNU Lesser General Public
18  * License along with this library; if not, write to the
19  * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
20  * Boston, MA 02110-1301 USA.
21  */
22 
23 #ifndef LIBEXIF_EXIF_TAG_H
24 #define LIBEXIF_EXIF_TAG_H
25 
26 #ifdef __cplusplus
27 extern "C" {
28 #endif /* __cplusplus */
29 
30 #include <libexif/exif-ifd.h>
31 #include <libexif/exif-data-type.h>
32 
34 typedef enum {
35  EXIF_TAG_INTEROPERABILITY_INDEX = 0x0001,
36  EXIF_TAG_INTEROPERABILITY_VERSION = 0x0002,
37  EXIF_TAG_NEW_SUBFILE_TYPE = 0x00fe,
38  EXIF_TAG_IMAGE_WIDTH = 0x0100,
39  EXIF_TAG_IMAGE_LENGTH = 0x0101,
40  EXIF_TAG_BITS_PER_SAMPLE = 0x0102,
41  EXIF_TAG_COMPRESSION = 0x0103,
42  EXIF_TAG_PHOTOMETRIC_INTERPRETATION = 0x0106,
43  EXIF_TAG_FILL_ORDER = 0x010a,
44  EXIF_TAG_DOCUMENT_NAME = 0x010d,
45  EXIF_TAG_IMAGE_DESCRIPTION = 0x010e,
46  EXIF_TAG_MAKE = 0x010f,
47  EXIF_TAG_MODEL = 0x0110,
48  EXIF_TAG_STRIP_OFFSETS = 0x0111,
49  EXIF_TAG_ORIENTATION = 0x0112,
50  EXIF_TAG_SAMPLES_PER_PIXEL = 0x0115,
51  EXIF_TAG_ROWS_PER_STRIP = 0x0116,
52  EXIF_TAG_STRIP_BYTE_COUNTS = 0x0117,
53  EXIF_TAG_X_RESOLUTION = 0x011a,
54  EXIF_TAG_Y_RESOLUTION = 0x011b,
55  EXIF_TAG_PLANAR_CONFIGURATION = 0x011c,
56  EXIF_TAG_RESOLUTION_UNIT = 0x0128,
57  EXIF_TAG_TRANSFER_FUNCTION = 0x012d,
58  EXIF_TAG_SOFTWARE = 0x0131,
59  EXIF_TAG_DATE_TIME = 0x0132,
60  EXIF_TAG_ARTIST = 0x013b,
61  EXIF_TAG_WHITE_POINT = 0x013e,
62  EXIF_TAG_PRIMARY_CHROMATICITIES = 0x013f,
63  EXIF_TAG_SUB_IFDS = 0x014a,
64  EXIF_TAG_TRANSFER_RANGE = 0x0156,
65  EXIF_TAG_JPEG_PROC = 0x0200,
66  EXIF_TAG_JPEG_INTERCHANGE_FORMAT = 0x0201,
67  EXIF_TAG_JPEG_INTERCHANGE_FORMAT_LENGTH = 0x0202,
68  EXIF_TAG_YCBCR_COEFFICIENTS = 0x0211,
69  EXIF_TAG_YCBCR_SUB_SAMPLING = 0x0212,
70  EXIF_TAG_YCBCR_POSITIONING = 0x0213,
71  EXIF_TAG_REFERENCE_BLACK_WHITE = 0x0214,
72  EXIF_TAG_XML_PACKET = 0x02bc,
73  EXIF_TAG_RELATED_IMAGE_FILE_FORMAT = 0x1000,
74  EXIF_TAG_RELATED_IMAGE_WIDTH = 0x1001,
75  EXIF_TAG_RELATED_IMAGE_LENGTH = 0x1002,
76  EXIF_TAG_IMAGE_DEPTH = 0x80e5,
77  EXIF_TAG_CFA_REPEAT_PATTERN_DIM = 0x828d,
78  EXIF_TAG_CFA_PATTERN = 0x828e,
79  EXIF_TAG_BATTERY_LEVEL = 0x828f,
80  EXIF_TAG_COPYRIGHT = 0x8298,
81  EXIF_TAG_EXPOSURE_TIME = 0x829a,
82  EXIF_TAG_FNUMBER = 0x829d,
83  EXIF_TAG_IPTC_NAA = 0x83bb,
84  EXIF_TAG_IMAGE_RESOURCES = 0x8649,
85  EXIF_TAG_EXIF_IFD_POINTER = 0x8769,
86  EXIF_TAG_INTER_COLOR_PROFILE = 0x8773,
87  EXIF_TAG_EXPOSURE_PROGRAM = 0x8822,
88  EXIF_TAG_SPECTRAL_SENSITIVITY = 0x8824,
89  EXIF_TAG_GPS_INFO_IFD_POINTER = 0x8825,
90  EXIF_TAG_ISO_SPEED_RATINGS = 0x8827,
91  EXIF_TAG_OECF = 0x8828,
92  EXIF_TAG_TIME_ZONE_OFFSET = 0x882a,
93  EXIF_TAG_SENSITIVITY_TYPE = 0x8830,
94  EXIF_TAG_STANDARD_OUTPUT_SENSITIVITY = 0x8831,
95  EXIF_TAG_RECOMMENDED_EXPOSURE_INDEX = 0x8832,
96  EXIF_TAG_ISO_SPEED = 0x8833,
97  EXIF_TAG_ISO_SPEEDLatitudeYYY = 0x8834,
98  EXIF_TAG_ISO_SPEEDLatitudeZZZ = 0x8835,
99  EXIF_TAG_EXIF_VERSION = 0x9000,
100  EXIF_TAG_DATE_TIME_ORIGINAL = 0x9003,
101  EXIF_TAG_DATE_TIME_DIGITIZED = 0x9004,
102  EXIF_TAG_OFFSET_TIME = 0x9010,
103  EXIF_TAG_OFFSET_TIME_ORIGINAL = 0x9011,
104  EXIF_TAG_OFFSET_TIME_DIGITIZED = 0x9012,
105  EXIF_TAG_COMPONENTS_CONFIGURATION = 0x9101,
106  EXIF_TAG_COMPRESSED_BITS_PER_PIXEL = 0x9102,
107  EXIF_TAG_SHUTTER_SPEED_VALUE = 0x9201,
108  EXIF_TAG_APERTURE_VALUE = 0x9202,
109  EXIF_TAG_BRIGHTNESS_VALUE = 0x9203,
110  EXIF_TAG_EXPOSURE_BIAS_VALUE = 0x9204,
111  EXIF_TAG_MAX_APERTURE_VALUE = 0x9205,
112  EXIF_TAG_SUBJECT_DISTANCE = 0x9206,
113  EXIF_TAG_METERING_MODE = 0x9207,
114  EXIF_TAG_LIGHT_SOURCE = 0x9208,
115  EXIF_TAG_FLASH = 0x9209,
116  EXIF_TAG_FOCAL_LENGTH = 0x920a,
117  EXIF_TAG_SUBJECT_AREA = 0x9214,
118  EXIF_TAG_TIFF_EP_STANDARD_ID = 0x9216,
119  EXIF_TAG_MAKER_NOTE = 0x927c,
120  EXIF_TAG_USER_COMMENT = 0x9286,
121  EXIF_TAG_SUB_SEC_TIME = 0x9290,
122  EXIF_TAG_SUB_SEC_TIME_ORIGINAL = 0x9291,
123  EXIF_TAG_SUB_SEC_TIME_DIGITIZED = 0x9292,
124  EXIF_TAG_XP_TITLE = 0x9c9b,
125  EXIF_TAG_XP_COMMENT = 0x9c9c,
126  EXIF_TAG_XP_AUTHOR = 0x9c9d,
127  EXIF_TAG_XP_KEYWORDS = 0x9c9e,
128  EXIF_TAG_XP_SUBJECT = 0x9c9f,
129  EXIF_TAG_FLASH_PIX_VERSION = 0xa000,
130  EXIF_TAG_COLOR_SPACE = 0xa001,
131  EXIF_TAG_PIXEL_X_DIMENSION = 0xa002,
132  EXIF_TAG_PIXEL_Y_DIMENSION = 0xa003,
133  EXIF_TAG_RELATED_SOUND_FILE = 0xa004,
134  EXIF_TAG_INTEROPERABILITY_IFD_POINTER = 0xa005,
135  EXIF_TAG_FLASH_ENERGY = 0xa20b,
136  EXIF_TAG_SPATIAL_FREQUENCY_RESPONSE = 0xa20c,
137  EXIF_TAG_FOCAL_PLANE_X_RESOLUTION = 0xa20e,
138  EXIF_TAG_FOCAL_PLANE_Y_RESOLUTION = 0xa20f,
139  EXIF_TAG_FOCAL_PLANE_RESOLUTION_UNIT = 0xa210,
140  EXIF_TAG_SUBJECT_LOCATION = 0xa214,
141  EXIF_TAG_EXPOSURE_INDEX = 0xa215,
142  EXIF_TAG_SENSING_METHOD = 0xa217,
143  EXIF_TAG_FILE_SOURCE = 0xa300,
144  EXIF_TAG_SCENE_TYPE = 0xa301,
145  EXIF_TAG_NEW_CFA_PATTERN = 0xa302,
146  EXIF_TAG_CUSTOM_RENDERED = 0xa401,
147  EXIF_TAG_EXPOSURE_MODE = 0xa402,
148  EXIF_TAG_WHITE_BALANCE = 0xa403,
149  EXIF_TAG_DIGITAL_ZOOM_RATIO = 0xa404,
150  EXIF_TAG_FOCAL_LENGTH_IN_35MM_FILM = 0xa405,
151  EXIF_TAG_SCENE_CAPTURE_TYPE = 0xa406,
152  EXIF_TAG_GAIN_CONTROL = 0xa407,
153  EXIF_TAG_CONTRAST = 0xa408,
154  EXIF_TAG_SATURATION = 0xa409,
155  EXIF_TAG_SHARPNESS = 0xa40a,
156  EXIF_TAG_DEVICE_SETTING_DESCRIPTION = 0xa40b,
157  EXIF_TAG_SUBJECT_DISTANCE_RANGE = 0xa40c,
158  EXIF_TAG_IMAGE_UNIQUE_ID = 0xa420,
159  EXIF_TAG_CAMERA_OWNER_NAME = 0xa430,
160  EXIF_TAG_BODY_SERIAL_NUMBER = 0xa431,
161  EXIF_TAG_LENS_SPECIFICATION = 0xa432,
162  EXIF_TAG_LENS_MAKE = 0xa433,
163  EXIF_TAG_LENS_MODEL = 0xa434,
164  EXIF_TAG_LENS_SERIAL_NUMBER = 0xa435,
165  EXIF_TAG_COMPOSITE_IMAGE = 0xa460,
166  EXIF_TAG_SOURCE_IMAGE_NUMBER_OF_COMPOSITE_IMAGE = 0xa461,
167  EXIF_TAG_SOURCE_EXPOSURE_TIMES_OF_COMPOSITE_IMAGE = 0xa462,
168  EXIF_TAG_GAMMA = 0xa500,
169  EXIF_TAG_PRINT_IMAGE_MATCHING = 0xc4a5,
170  EXIF_TAG_PADDING = 0xea1c
171 } ExifTag;
172 
173 /* GPS tags overlap with above ones. */
174 #define EXIF_TAG_GPS_VERSION_ID 0x0000
175 #define EXIF_TAG_GPS_LATITUDE_REF 0x0001 /* INTEROPERABILITY_INDEX */
176 #define EXIF_TAG_GPS_LATITUDE 0x0002 /* INTEROPERABILITY_VERSION */
177 #define EXIF_TAG_GPS_LONGITUDE_REF 0x0003
178 #define EXIF_TAG_GPS_LONGITUDE 0x0004
179 #define EXIF_TAG_GPS_ALTITUDE_REF 0x0005
180 #define EXIF_TAG_GPS_ALTITUDE 0x0006
181 #define EXIF_TAG_GPS_TIME_STAMP 0x0007
182 #define EXIF_TAG_GPS_SATELLITES 0x0008
183 #define EXIF_TAG_GPS_STATUS 0x0009
184 #define EXIF_TAG_GPS_MEASURE_MODE 0x000a
185 #define EXIF_TAG_GPS_DOP 0x000b
186 #define EXIF_TAG_GPS_SPEED_REF 0x000c
187 #define EXIF_TAG_GPS_SPEED 0x000d
188 #define EXIF_TAG_GPS_TRACK_REF 0x000e
189 #define EXIF_TAG_GPS_TRACK 0x000f
190 #define EXIF_TAG_GPS_IMG_DIRECTION_REF 0x0010
191 #define EXIF_TAG_GPS_IMG_DIRECTION 0x0011
192 #define EXIF_TAG_GPS_MAP_DATUM 0x0012
193 #define EXIF_TAG_GPS_DEST_LATITUDE_REF 0x0013
194 #define EXIF_TAG_GPS_DEST_LATITUDE 0x0014
195 #define EXIF_TAG_GPS_DEST_LONGITUDE_REF 0x0015
196 #define EXIF_TAG_GPS_DEST_LONGITUDE 0x0016
197 #define EXIF_TAG_GPS_DEST_BEARING_REF 0x0017
198 #define EXIF_TAG_GPS_DEST_BEARING 0x0018
199 #define EXIF_TAG_GPS_DEST_DISTANCE_REF 0x0019
200 #define EXIF_TAG_GPS_DEST_DISTANCE 0x001a
201 #define EXIF_TAG_GPS_PROCESSING_METHOD 0x001b
202 #define EXIF_TAG_GPS_AREA_INFORMATION 0x001c
203 #define EXIF_TAG_GPS_DATE_STAMP 0x001d
204 #define EXIF_TAG_GPS_DIFFERENTIAL 0x001e
205 #define EXIF_TAG_GPS_H_POSITIONING_ERROR 0x001f
206 
208 typedef enum {
210  EXIF_SUPPORT_LEVEL_UNKNOWN = 0,
211 
213  EXIF_SUPPORT_LEVEL_NOT_RECORDED,
214 
216  EXIF_SUPPORT_LEVEL_MANDATORY,
217 
219  EXIF_SUPPORT_LEVEL_OPTIONAL
220 } ExifSupportLevel;
221 
229 ExifTag exif_tag_from_name (const char *name);
230 
239 const char *exif_tag_get_name_in_ifd (ExifTag tag, ExifIfd ifd);
240 
248 const char *exif_tag_get_title_in_ifd (ExifTag tag, ExifIfd ifd);
249 
257 const char *exif_tag_get_description_in_ifd (ExifTag tag, ExifIfd ifd);
258 
271 ExifSupportLevel exif_tag_get_support_level_in_ifd (ExifTag tag, ExifIfd ifd,
272  ExifDataType t);
273 
274 /* Don't use these functions. They are here for compatibility only. */
275 
277 const char *exif_tag_get_name (ExifTag tag);
278 
280 const char *exif_tag_get_title (ExifTag tag);
281 
283 const char *exif_tag_get_description (ExifTag tag);
284 
285 
286 /* For now, do not use these functions. */
287 
289 ExifTag exif_tag_table_get_tag (unsigned int n);
290 
292 const char *exif_tag_table_get_name (unsigned int n);
293 
295 unsigned int exif_tag_table_count (void);
296 
297 
298 /* Don't use these definitions. They are here for compatibility only. */
299 
301 #define EXIF_TAG_UNKNOWN_C4A5 EXIF_TAG_PRINT_IMAGE_MATCHING
302 
303 #ifdef __cplusplus
304 }
305 #endif /* __cplusplus */
306 
307 #endif /* !defined(LIBEXIF_EXIF_TAG_H) */
exif_tag_get_name
const char * exif_tag_get_name(ExifTag tag)
Definition: exif-tag.c:1147
ExifTag
ExifTag
EXIF tags.
Definition: exif-tag.h:34
exif_tag_get_title
const char * exif_tag_get_title(ExifTag tag)
Definition: exif-tag.c:1153
exif_tag_from_name
ExifTag exif_tag_from_name(const char *name)
Return the tag ID given its unique textual name.
Definition: exif-tag.c:1167
exif_tag_get_name_in_ifd
const char * exif_tag_get_name_in_ifd(ExifTag tag, ExifIfd ifd)
Return a textual name of the given tag when found in the given IFD.
Definition: exif-tag.c:1038
exif_tag_table_count
unsigned int exif_tag_table_count(void)
Return the number of entries in the EXIF tag table, including the terminating NULL entry.
Definition: exif-tag.c:973
exif_tag_get_support_level_in_ifd
ExifSupportLevel exif_tag_get_support_level_in_ifd(ExifTag tag, ExifIfd ifd, ExifDataType t)
Return whether the given tag is mandatory or not in the given IFD and data type according to the EXIF...
Definition: exif-tag.c:1256
exif_tag_get_title_in_ifd
const char * exif_tag_get_title_in_ifd(ExifTag tag, ExifIfd ifd)
Return a textual title of the given tag when found in the given IFD.
Definition: exif-tag.c:1060
ExifSupportLevel
ExifSupportLevel
What level of support a tag enjoys in the EXIF standard.
Definition: exif-tag.h:208
EXIF_SUPPORT_LEVEL_UNKNOWN
@ EXIF_SUPPORT_LEVEL_UNKNOWN
The meaning of this tag is unknown.
Definition: exif-tag.h:210
EXIF_SUPPORT_LEVEL_OPTIONAL
@ EXIF_SUPPORT_LEVEL_OPTIONAL
This tag is optional in the given IFD.
Definition: exif-tag.h:219
EXIF_SUPPORT_LEVEL_NOT_RECORDED
@ EXIF_SUPPORT_LEVEL_NOT_RECORDED
This tag is not allowed in the given IFD.
Definition: exif-tag.h:213
EXIF_SUPPORT_LEVEL_MANDATORY
@ EXIF_SUPPORT_LEVEL_MANDATORY
This tag is mandatory in the given IFD.
Definition: exif-tag.h:216
exif_tag_get_description
const char * exif_tag_get_description(ExifTag tag)
Definition: exif-tag.c:1159
exif_tag_get_description_in_ifd
const char * exif_tag_get_description_in_ifd(ExifTag tag, ExifIfd ifd)
Return a verbose textual description of the given tag when found in the given IFD.
Definition: exif-tag.c:1083