EXIF library (libexif) API
0.6.21
|
Go to the documentation of this file.
24 #ifndef __EXIF_DATA_H__
25 #define __EXIF_DATA_H__
32 #include <libexif/exif-data-type.h>
33 #include <libexif/exif-ifd.h>
39 typedef struct _ExifDataPrivate ExifDataPrivate;
57 ExifDataPrivate *priv;
122 void exif_data_ref (
ExifData *data);
123 void exif_data_unref (
ExifData *data);
124 void exif_data_free (
ExifData *data);
161 typedef void (* ExifDataForeachContentFunc) (
ExifContent *,
void *user_data);
170 ExifDataForeachContentFunc func,
249 #define exif_data_get_entry(d,t) \
250 (exif_content_get_entry(d->ifd[EXIF_IFD_0],t) ? \
251 exif_content_get_entry(d->ifd[EXIF_IFD_0],t) : \
252 exif_content_get_entry(d->ifd[EXIF_IFD_1],t) ? \
253 exif_content_get_entry(d->ifd[EXIF_IFD_1],t) : \
254 exif_content_get_entry(d->ifd[EXIF_IFD_EXIF],t) ? \
255 exif_content_get_entry(d->ifd[EXIF_IFD_EXIF],t) : \
256 exif_content_get_entry(d->ifd[EXIF_IFD_GPS],t) ? \
257 exif_content_get_entry(d->ifd[EXIF_IFD_GPS],t) : \
258 exif_content_get_entry(d->ifd[EXIF_IFD_INTEROPERABILITY],t) ? \
259 exif_content_get_entry(d->ifd[EXIF_IFD_INTEROPERABILITY],t) : NULL)
unsigned long components
Number of elements in the array, if this is an array entry.
Definition: exif-entry.h:52
Data found in one EXIF tag.
Definition: exif-entry.h:43
void exif_content_foreach_entry(ExifContent *content, ExifContentForeachEntryFunc func, void *user_data)
Executes function on each EXIF tag in this IFD in turn.
Definition: exif-content.c:210
ExifTag tag
EXIF tag for this entry.
Definition: exif-entry.h:45
void exif_data_foreach_content(ExifData *data, ExifDataForeachContentFunc func, void *user_data)
Execute a function on each IFD in turn.
Definition: exif-data.c:1145
Defines the ExifLoader type.
@ EXIF_DATA_OPTION_DONT_CHANGE_MAKER_NOTE
Leave the MakerNote alone, which could cause it to be corrupted.
Definition: exif-data.h:182
void exif_content_remove_entry(ExifContent *c, ExifEntry *e)
Remove an EXIF tag from an IFD.
Definition: exif-content.c:157
const char * exif_data_option_get_description(ExifDataOption o)
Return a verbose textual description of the given ExifDataOption.
Definition: exif-data.c:1248
ExifDataOption
Options to configure the behaviour of ExifData.
Definition: exif-data.h:174
ExifByteOrder exif_data_get_byte_order(ExifData *data)
Return the byte order in use by this EXIF structure.
Definition: exif-data.c:1136
ExifLoader * exif_loader_new(void)
Allocate a new ExifLoader.
Definition: exif-loader.c:317
System specific definitions, not for installation!
ExifMem * exif_mem_new_default(void)
Create a new ExifMem with default values for your convenience.
Definition: exif-mem.c:95
void exif_content_add_entry(ExifContent *c, ExifEntry *entry)
Add an EXIF tag to an IFD.
Definition: exif-content.c:133
ExifTag
EXIF tags.
Definition: exif-tag.h:34
unsigned char * data
Pointer to the raw EXIF data for this entry.
Definition: exif-entry.h:57
void exif_data_unset_option(ExifData *d, ExifDataOption o)
Clear the given option on the given ExifData.
Definition: exif-data.c:1268
struct _ExifLog ExifLog
State maintained by the logging interface.
Definition: exif-log.h:34
Definition: exif-content.h:40
ExifData * exif_data_new_mem(ExifMem *)
Allocate a new ExifData using the given memory allocator.
Definition: exif-data.c:106
uint16_t ExifShort
EXIF Unsigned Short data type.
Definition: exif-utils.h:48
ExifLong exif_get_long(const unsigned char *b, ExifByteOrder order)
Retrieve an ExifLong value from memory.
Definition: exif-utils.c:165
void exif_data_set_option(ExifData *d, ExifDataOption o)
Set the given option on the given ExifData.
Definition: exif-data.c:1259
Handling EXIF MakerNote tags.
@ EXIF_BYTE_ORDER_MOTOROLA
Big-endian byte order.
Definition: exif-byte-order.h:33
void exif_mnote_data_load(ExifMnoteData *d, const unsigned char *buf, unsigned int buf_siz)
Load the MakerNote data from a memory buffer.
Definition: exif-mnote-data.c:80
void exif_mnote_data_save(ExifMnoteData *d, unsigned char **buf, unsigned int *buf_siz)
Save the raw MakerNote data into a memory buffer.
Definition: exif-mnote-data.c:88
Definition: exif-mnote-data-priv.h:60
@ EXIF_DATA_OPTION_IGNORE_UNKNOWN_TAGS
Act as though unknown tags are not present.
Definition: exif-data.h:176
ExifData * exif_data_new_from_file(const char *path)
Allocate a new ExifData and load EXIF data from a JPEG file.
Definition: exif-data.c:1038
void exif_data_load_data(ExifData *data, const unsigned char *d, unsigned int size)
Load the ExifData structure from the raw JPEG or EXIF data in the given memory buffer.
Definition: exif-data.c:829
const char * exif_tag_get_name(ExifTag tag)
Definition: exif-tag.c:1062
Defines the ExifByteOrder enum and the associated functions.
unsigned char * data
Pointer to thumbnail image, or NULL if not available.
Definition: exif-data.h:52
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:946
EXIF data manipulation functions and types.
void exif_mem_unref(ExifMem *)
Unrefcount an ExifMem.
Definition: exif-mem.c:61
void exif_set_long(unsigned char *b, ExifByteOrder order, ExifLong value)
Store an ExifLong value into memory in EXIF format.
Definition: exif-utils.c:171
void exif_data_set_data_type(ExifData *d, ExifDataType dt)
Set the data type for the given ExifData.
Definition: exif-data.c:1311
void exif_data_save_data(ExifData *data, unsigned char **d, unsigned int *ds)
Store raw EXIF data representing the ExifData structure into a memory buffer.
Definition: exif-data.c:993
void exif_loader_unref(ExifLoader *loader)
Decrease the refcount of the ExifLoader.
Definition: exif-loader.c:369
@ EXIF_DATA_OPTION_FOLLOW_SPECIFICATION
Fix the EXIF tags to follow the spec.
Definition: exif-data.h:179
void exif_data_log(ExifData *data, ExifLog *log)
Set the log message object for all IFDs.
Definition: exif-data.c:1196
ExifData * exif_data_new(void)
Allocate a new ExifData.
Definition: exif-data.c:95
void exif_data_dump(ExifData *data)
Dump all EXIF data to stdout.
Definition: exif-data.c:1109
void exif_content_fix(ExifContent *c)
Fix the IFD to bring it into specification.
Definition: exif-content.c:278
void exif_content_dump(ExifContent *content, unsigned int indent)
Dump contents of the IFD to stdout.
Definition: exif-content.c:114
void exif_data_fix(ExifData *d)
Fix the EXIF data to bring it into specification.
Definition: exif-data.c:1305
Log message infrastructure.
void exif_entry_unref(ExifEntry *entry)
Decrease reference counter for ExifEntry.
Definition: exif-entry.c:146
@ EXIF_BYTE_ORDER_INTEL
Little-endian byte order.
Definition: exif-byte-order.h:35
ExifFormat format
Type of data in this entry.
Definition: exif-entry.h:48
struct _ExifLoader ExifLoader
Data used by the loader interface.
Definition: exif-loader.h:35
ExifData * parent
Data containing this content.
Definition: exif-content.h:46
ExifData * exif_loader_get_data(ExifLoader *loader)
Create an ExifData from the data in the loader.
Definition: exif-loader.c:391
ExifShort exif_get_short(const unsigned char *b, ExifByteOrder order)
Retrieve an ExifShort value from memory.
Definition: exif-utils.c:102
unsigned int size
Number of bytes in thumbnail image at data.
Definition: exif-data.h:55
ExifEntry * exif_entry_new_mem(ExifMem *)
Reserve memory for and initialize new ExifEntry using the specified memory allocator.
Definition: exif-entry.c:121
#define exif_data_get_entry(d, t)
Return an ExifEntry for the given tag if found in any IFD.
Definition: exif-data.h:249
ExifDataType exif_data_get_data_type(ExifData *d)
Return the data type for the given ExifData.
Definition: exif-data.c:1320
ExifIfd exif_content_get_ifd(ExifContent *c)
Return the IFD number in which the given ExifContent is found.
Definition: exif-content.c:234
ExifByteOrder
Which byte order to use.
Definition: exif-byte-order.h:31
const char * exif_data_option_get_name(ExifDataOption o)
Return a short textual description of the given ExifDataOption.
Definition: exif-data.c:1237
ExifData * exif_data_new_from_data(const unsigned char *data, unsigned int size)
Allocate a new ExifData and load EXIF data from a memory buffer.
Definition: exif-data.c:153
ExifMnoteData * exif_data_get_mnote_data(ExifData *d)
Return the MakerNote data out of the EXIF data.
Definition: exif-data.c:89
struct _ExifMem ExifMem
ExifMem define a memory allocator.
Definition: exif-mem.h:57
Define the ExifMem data type and the associated functions. ExifMem defines the memory management func...
unsigned int size
Number of bytes in the buffer at data.
Definition: exif-entry.h:61
void exif_content_log(ExifContent *content, ExifLog *log)
Set the log message object for this IFD.
Definition: exif-content.c:223
Defines the ExifData type and the associated functions.
void exif_loader_write_file(ExifLoader *loader, const char *fname)
Load a file into the given ExifLoader from the filesystem.
Definition: exif-loader.c:107
uint32_t ExifLong
EXIF Unsigned Long data type.
Definition: exif-utils.h:54
Represents the entire EXIF data found in an image.
Definition: exif-data.h:46
ExifContent * ifd[EXIF_IFD_COUNT]
Data for each IFD.
Definition: exif-data.h:49
void exif_data_set_byte_order(ExifData *data, ExifByteOrder order)
Set the byte order to use for this EXIF data.
Definition: exif-data.c:1180
void exif_mem_ref(ExifMem *)
Refcount an ExifMem.
Definition: exif-mem.c:54
void exif_set_short(unsigned char *b, ExifByteOrder order, ExifShort value)
Store an ExifShort value into memory in EXIF format.
Definition: exif-utils.c:124