4 * Copyright (C) 2008 The Geeqie Team
7 * Support for Exif file format, originally written by Eric Swalens.
8 * Modified by Quy Tonthat
9 * Reimplemented with generic data storage by John Ellis
12 This program is free software; you can redistribute it and/or modify
13 it under the terms of the GNU General Public License as published by
14 the Free Software Foundation; either version 2 of the License, or
15 (at your option) any later version.
17 This program is distributed in the hope that it will be useful,
18 but WITHOUT ANY WARRANTY; without even the implied warranty of
19 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 GNU General Public License for more details.
22 You should have received a copy of the GNU General Public License
23 along with this program; if not, write to the Free Software
24 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
32 *-----------------------------------------------------------------------------
34 *-----------------------------------------------------------------------------
37 #define EXIF_FORMAT_COUNT 13
40 EXIF_FORMAT_UNKNOWN = 0,
41 EXIF_FORMAT_BYTE_UNSIGNED = 1,
42 EXIF_FORMAT_STRING = 2,
43 EXIF_FORMAT_SHORT_UNSIGNED = 3,
44 EXIF_FORMAT_LONG_UNSIGNED = 4,
45 EXIF_FORMAT_RATIONAL_UNSIGNED = 5,
47 EXIF_FORMAT_UNDEFINED = 7,
48 EXIF_FORMAT_SHORT = 8,
50 EXIF_FORMAT_RATIONAL = 10,
51 EXIF_FORMAT_FLOAT = 11,
52 EXIF_FORMAT_DOUBLE = 12
56 typedef struct _ExifFormattedText ExifFormattedText;
57 struct _ExifFormattedText
60 const gchar *description;
64 *-----------------------------------------------------------------------------
66 *-----------------------------------------------------------------------------
69 typedef struct _ExifItem ExifItem;
71 typedef struct _ExifData ExifData;
73 typedef struct _ExifRational ExifRational;
81 /* enums useful for image manipulation */
84 EXIF_ORIENTATION_UNKNOWN = 0,
85 EXIF_ORIENTATION_TOP_LEFT = 1,
86 EXIF_ORIENTATION_TOP_RIGHT = 2,
87 EXIF_ORIENTATION_BOTTOM_RIGHT = 3,
88 EXIF_ORIENTATION_BOTTOM_LEFT = 4,
89 EXIF_ORIENTATION_LEFT_TOP = 5,
90 EXIF_ORIENTATION_RIGHT_TOP = 6,
91 EXIF_ORIENTATION_RIGHT_BOTTOM = 7,
92 EXIF_ORIENTATION_LEFT_BOTTOM = 8
93 } ExifOrientationType;
96 EXIF_UNIT_UNKNOWN = 0,
99 EXIF_UNIT_CENTIMETER = 3
104 *-----------------------------------------------------------------------------
106 *-----------------------------------------------------------------------------
109 ExifData *exif_read(gchar *path, gchar *sidecar_path);
111 ExifData *exif_read_fd(FileData *fd);
114 int exif_write(ExifData *exif);
115 void exif_free(ExifData *exif);
117 gchar *exif_get_data_as_text(ExifData *exif, const gchar *key);
118 gint exif_get_integer(ExifData *exif, const gchar *key, gint *value);
119 ExifRational *exif_get_rational(ExifData *exif, const gchar *key, gint *sign);
120 double exif_rational_to_double(ExifRational *r, gint sign);
121 double exif_get_rational_as_double(ExifData *exif, const gchar *key);
123 ExifItem *exif_get_item(ExifData *exif, const gchar *key);
124 ExifItem *exif_add_item(ExifData *exif, const gchar *key);
125 ExifItem *exif_get_first_item(ExifData *exif);
126 ExifItem *exif_get_next_item(ExifData *exif);
129 char *exif_item_get_tag_name(ExifItem *item);
130 guint exif_item_get_tag_id(ExifItem *item);
131 guint exif_item_get_elements(ExifItem *item);
132 char *exif_item_get_data(ExifItem *item, guint *data_len);
133 char *exif_item_get_description(ExifItem *item);
134 guint exif_item_get_format_id(ExifItem *item);
135 const char *exif_item_get_format_name(ExifItem *item, gint brief);
136 gchar *exif_item_get_data_as_text(ExifItem *item);
137 gint exif_item_get_integer(ExifItem *item, gint *value);
138 ExifRational *exif_item_get_rational(ExifItem *item, gint *sign);
140 gchar *exif_item_get_string(ExifItem *item, int idx);
142 const gchar *exif_get_description_by_key(const gchar *key);
143 const gchar *exif_get_tag_description_by_key(const gchar *key);
145 gchar *exif_get_formatted_by_key(ExifData *exif, const gchar *key, gint *key_valid);
147 int exif_item_delete(ExifData *exif, ExifItem *item);
148 int exif_item_set_string(ExifItem *item, const char *str);
150 unsigned char *exif_get_color_profile(ExifData *exif, guint *data_len);
152 /* jpeg embedded icc support */
154 void exif_add_jpeg_color_profile(ExifData *exif, unsigned char *cp_data, guint cp_length);
157 gint exif_jpeg_segment_find(unsigned char *data, guint size,
158 guchar app_marker, const gchar *magic, guint magic_len,
159 guint *seg_offset, guint *seg_length);
160 gint exif_jpeg_parse_color(ExifData *exif, unsigned char *data, guint size);
163 gint format_raw_img_exif_offsets_fd(int fd, const gchar *path,
164 unsigned char *header_data, const guint header_len,
165 guint *image_offset, guint *exif_offset);