src/exif-int.h

   1 /*
   2  * Copyright (C) 2006 John Ellis
   3  * Copyright (C) 2008 - 2016 The Geeqie Team
   4  *
   5  * Authors: Eric Swalens, Quy Tonthat, John Ellis
   6  *
   7  * This program is free software; you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License as published by
   9  * the Free Software Foundation; either version 2 of the License, or
  10  * (at your option) any later version.
  11  *
  12  * This program 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
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License along
  18  * with this program; if not, write to the Free Software Foundation, Inc.,
  19  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  20  */
  21
  22 #ifndef __EXIF_INT_H
  23 #define __EXIF_INT_H
  24
  25 #include "exif.h"
  26
  27 /*
  28  *-----------------------------------------------------------------------------
  29  * Tag formats
  30  *-----------------------------------------------------------------------------
  31  */
  32
  33 typedef enum {
  34         EXIF_BYTE_ORDER_INTEL,
  35         EXIF_BYTE_ORDER_MOTOROLA
  36 } ExifByteOrder;
  37
  38 typedef struct _ExifFormatAttrib ExifFormatAttrib;
  39 struct _ExifFormatAttrib
  40 {
  41         ExifFormatType type;
  42         guint size;
  43         const gchar *short_name;
  44         const gchar *description;
  45 };
  46
  47 /* the list of known tag data formats */
  48 extern ExifFormatAttrib ExifFormatList[];
  49
  50
  51 /*
  52  *-----------------------------------------------------------------------------
  53  * Data storage
  54  *-----------------------------------------------------------------------------
  55  */
  56
  57 typedef struct _ExifMarker ExifMarker;
  58 typedef struct _ExifTextList ExifTextList;
  59
  60 struct _ExifData
  61 {
  62         gchar *path;
  63         GList *items;   /* list of (ExifItem *) */
  64         GList *current; /* for exif_get_next_item */
  65 };
  66
  67
  68 struct _ExifItem
  69 {
  70         ExifFormatType format;
  71         guint tag;
  72         const ExifMarker *marker;
  73         guint elements;
  74         gpointer data;
  75         guint data_len;
  76 };
  77
  78 struct _ExifMarker
  79 {
  80         guint           tag;
  81         ExifFormatType  format;
  82         gint            components;
  83         gchar           *key;
  84         gchar           *description;
  85         ExifTextList    *list;
  86 };
  87
  88 #define EXIF_MARKER_LIST_END { 0x0000, EXIF_FORMAT_UNKNOWN, 0, NULL, NULL, NULL }
  89
  90 struct _ExifTextList
  91 {
  92         gint value;
  93         const gchar *description;
  94 };
  95
  96 #define EXIF_TEXT_LIST_END { -1, NULL }
  97
  98
  99
 100
 101 /*
 102  *-----------------------------------------------------------------------------
 103  * Data
 104  *-----------------------------------------------------------------------------
 105  */
 106
 107
 108
 109 /* the known exif tags list */
 110 extern ExifMarker ExifKnownMarkersList[];
 111
 112 /* the unknown tags utilize this generic list */
 113 extern ExifMarker ExifUnknownMarkersList[];
 114
 115 /* the list of specially formatted keys, for human readable output */
 116 extern ExifFormattedText ExifFormattedList[];
 117
 118
 119 /*
 120  *-----------------------------------------------------------------------------
 121  * functions
 122  *-----------------------------------------------------------------------------
 123  */
 124
 125
 126 /* usually for debugging to stdout */
 127 void exif_write_data_list(ExifData *exif, FILE *f, gint human_readable_list);
 128
 129
 130
 131 /* These funcs for use by makernote/tiff parsers only */
 132
 133 #define EXIF_TIFF_MAX_LEVELS 4
 134
 135 #define EXIF_TIFD_OFFSET_TAG 0
 136 #define EXIF_TIFD_OFFSET_FORMAT 2
 137 #define EXIF_TIFD_OFFSET_COUNT 4
 138 #define EXIF_TIFD_OFFSET_DATA 8
 139 #define EXIF_TIFD_SIZE 12
 140
 141
 142 guint16 exif_byte_get_int16(guchar *f, ExifByteOrder bo);
 143 guint32 exif_byte_get_int32(guchar *f, ExifByteOrder bo);
 144 void exif_byte_put_int16(guchar *f, guint16 n, ExifByteOrder bo);
 145 void exif_byte_put_int32(guchar *f, guint32 n, ExifByteOrder bo);
 146
 147 ExifItem *exif_item_new(ExifFormatType format, guint tag,
 148                         guint elements, const ExifMarker *marker);
 149 void exif_item_copy_data(ExifItem *item, gpointer src, guint len,
 150                          ExifFormatType src_format, ExifByteOrder bo);
 151
 152 gint exif_parse_IFD_table(ExifData *exif,
 153                           guchar *tiff, guint offset,
 154                           guint size, ExifByteOrder bo,
 155                           gint level,
 156                           const ExifMarker *list);
 157
 158 gint exif_tiff_directory_offset(guchar *data, const guint len,
 159                                 guint *offset, ExifByteOrder *bo);
 160 gint exif_tiff_parse(ExifData *exif, guchar *tiff, guint size, ExifMarker *list);
 161
 162 gchar *exif_text_list_find_value(ExifTextList *list, guint value);
 163
 164 #endif
 165 /* vim: set shiftwidth=8 softtabstop=0 cindent cinoptions={1s: */