EXIF library (libexif) API  0.6.24
exif-entry.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_ENTRY_H
24 #define LIBEXIF_EXIF_ENTRY_H
25 
26 #ifdef __cplusplus
27 extern "C" {
28 #endif /* __cplusplus */
29 
35 typedef struct _ExifEntry ExifEntry;
36 typedef struct _ExifEntryPrivate ExifEntryPrivate;
37 
38 #include <libexif/exif-content.h>
39 #include <libexif/exif-format.h>
40 #include <libexif/exif-mem.h>
41 
43 struct _ExifEntry {
46 
49 
52  unsigned long components;
53 
57  unsigned char *data;
58 
61  unsigned int size;
62 
66 
68  ExifEntryPrivate *priv;
69 };
70 
71 /* Lifecycle */
72 
81 
91 
98 void exif_entry_ref (ExifEntry *entry);
99 
105 void exif_entry_unref (ExifEntry *entry);
106 
114 void exif_entry_free (ExifEntry *entry);
115 
126 
140 void exif_entry_fix (ExifEntry *entry);
141 
142 
143 /* For your convenience */
144 
164 const char *exif_entry_get_value (ExifEntry *entry, char *val,
165  unsigned int maxlen);
166 
173 void exif_entry_dump (ExifEntry *entry, unsigned int indent);
174 
180 #define exif_entry_get_ifd(e) ((e)?exif_content_get_ifd((e)->parent):EXIF_IFD_COUNT)
181 
182 #ifdef __cplusplus
183 }
184 #endif /* __cplusplus */
185 
186 #endif /* !defined(LIBEXIF_EXIF_ENTRY_H) */
Handling EXIF IFDs.
const char * exif_entry_get_value(ExifEntry *entry, char *val, unsigned int maxlen)
Return a localized textual representation of the value of the EXIF entry.
Definition: exif-entry.c:846
void exif_entry_fix(ExifEntry *entry)
Fix the type or format of the given EXIF entry to bring it into spec.
Definition: exif-entry.c:205
void exif_entry_free(ExifEntry *entry)
Actually free the ExifEntry.
Definition: exif-entry.c:157
ExifEntry * exif_entry_new_mem(ExifMem *)
Reserve memory for and initialize new ExifEntry using the specified memory allocator.
Definition: exif-entry.c:122
void exif_entry_dump(ExifEntry *entry, unsigned int indent)
Dump text representation of ExifEntry to stdout.
Definition: exif-entry.c:598
ExifEntry * exif_entry_new(void)
Reserve memory for and initialize a new ExifEntry.
Definition: exif-entry.c:111
void exif_entry_ref(ExifEntry *entry)
Increase reference counter for ExifEntry.
Definition: exif-entry.c:139
void exif_entry_initialize(ExifEntry *e, ExifTag tag)
Initialize an empty ExifEntry with default data in the correct format for the given tag.
Definition: exif-entry.c:1459
void exif_entry_unref(ExifEntry *entry)
Decrease reference counter for ExifEntry.
Definition: exif-entry.c:147
Handling native EXIF data types.
ExifFormat
EXIF tag data formats.
Definition: exif-format.h:32
Define the ExifMem data type and the associated functions.
struct _ExifMem ExifMem
ExifMem define a memory allocator.
Definition: exif-mem.h:57
ExifTag
EXIF tags.
Definition: exif-tag.h:34
Definition: exif-content.h:41
Data found in one EXIF tag.
Definition: exif-entry.h:43
unsigned long components
Number of elements in the array, if this is an array entry.
Definition: exif-entry.h:52
ExifFormat format
Type of data in this entry.
Definition: exif-entry.h:48
ExifContent * parent
ExifContent containing this entry.
Definition: exif-entry.h:65
unsigned char * data
Pointer to the raw EXIF data for this entry.
Definition: exif-entry.h:57
ExifTag tag
EXIF tag for this entry.
Definition: exif-entry.h:45
ExifEntryPrivate * priv
Internal data to be used by libexif itself.
Definition: exif-entry.h:68
unsigned int size
Number of bytes in the buffer at data.
Definition: exif-entry.h:61