Index: libexif/sources/libexif/exif-content.h |
=================================================================== |
--- libexif/sources/libexif/exif-content.h (revision 0) |
+++ libexif/sources/libexif/exif-content.h (revision 0) |
@@ -0,0 +1,145 @@ |
+/*! \file exif-content.h |
+ * \brief Handling EXIF IFDs |
+ */ |
+/* |
+ * Copyright (c) 2001 Lutz Mueller <lutz@users.sourceforge.net> |
+ * |
+ * This library is free software; you can redistribute it and/or |
+ * modify it under the terms of the GNU Lesser General Public |
+ * License as published by the Free Software Foundation; either |
+ * version 2 of the License, or (at your option) any later version. |
+ * |
+ * This library is distributed in the hope that it will be useful, |
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of |
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
+ * Lesser General Public License for more details. |
+ * |
+ * You should have received a copy of the GNU Lesser General Public |
+ * License along with this library; if not, write to the |
+ * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, |
+ * Boston, MA 02110-1301 USA. |
+ */ |
+ |
+#ifndef __EXIF_CONTENT_H__ |
+#define __EXIF_CONTENT_H__ |
+ |
+#ifdef __cplusplus |
+extern "C" { |
+#endif /* __cplusplus */ |
+ |
+/*! Holds all EXIF tags in a single IFD */ |
+typedef struct _ExifContent ExifContent; |
+typedef struct _ExifContentPrivate ExifContentPrivate; |
+ |
+#include <libexif/exif-tag.h> |
+#include <libexif/exif-entry.h> |
+#include <libexif/exif-data.h> |
+#include <libexif/exif-log.h> |
+#include <libexif/exif-mem.h> |
+ |
+struct _ExifContent |
+{ |
+ ExifEntry **entries; |
+ unsigned int count; |
+ |
+ /*! Data containing this content */ |
+ ExifData *parent; |
+ |
+ ExifContentPrivate *priv; |
+}; |
+ |
+/* Lifecycle */ |
+ExifContent *exif_content_new (void); |
+ExifContent *exif_content_new_mem (ExifMem *); |
+void exif_content_ref (ExifContent *content); |
+void exif_content_unref (ExifContent *content); |
+void exif_content_free (ExifContent *content); |
+ |
+/*! Add an EXIF tag to an IFD. |
+ * If this tag already exists in the IFD, this function does nothing. |
+ * \pre The "tag" member of the entry must be set on entry. |
+ * |
+ * \param[out] c IFD |
+ * \param[in] entry EXIF entry to add |
+ */ |
+void exif_content_add_entry (ExifContent *c, ExifEntry *entry); |
+ |
+/*! Remove an EXIF tag from an IFD. |
+ * If this tag does not exist in the IFD, this function does nothing. |
+ * |
+ * \param[out] c IFD |
+ * \param[in] e EXIF entry to remove |
+ */ |
+void exif_content_remove_entry (ExifContent *c, ExifEntry *e); |
+ |
+/*! Return the #ExifEntry in this IFD corresponding to the given tag. |
+ * This is a pointer into a member of the #ExifContent array and must NOT be |
+ * freed or unrefed by the caller. |
+ * |
+ * \param[in] content EXIF content for an IFD |
+ * \param[in] tag EXIF tag to return |
+ * \return #ExifEntry of the tag, or NULL on error |
+ */ |
+ExifEntry *exif_content_get_entry (ExifContent *content, ExifTag tag); |
+ |
+/*! Fix the IFD to bring it into specification. Call #exif_entry_fix on |
+ * each entry in this IFD to fix existing entries, create any new entries |
+ * that are mandatory in this IFD but do not yet exist, and remove any |
+ * entries that are not allowed in this IFD. |
+ * |
+ * \param[in,out] c EXIF content for an IFD |
+ */ |
+void exif_content_fix (ExifContent *c); |
+ |
+typedef void (* ExifContentForeachEntryFunc) (ExifEntry *, void *user_data); |
+ |
+/*! Executes function on each EXIF tag in this IFD in turn. |
+ * The tags will not necessarily be visited in numerical order. |
+ * |
+ * \param[in,out] content IFD over which to iterate |
+ * \param[in] func function to call for each entry |
+ * \param[in] user_data data to pass into func on each call |
+ */ |
+void exif_content_foreach_entry (ExifContent *content, |
+ ExifContentForeachEntryFunc func, |
+ void *user_data); |
+ |
+/*! Return the IFD number in which the given #ExifContent is found. |
+ * |
+ * \param[in] c an #ExifContent* |
+ * \return IFD number, or #EXIF_IFD_COUNT on error |
+ */ |
+ExifIfd exif_content_get_ifd (ExifContent *c); |
+ |
+/*! Return a textual representation of the EXIF data for a tag. |
+ * |
+ * \param[in] c #ExifContent* for an IFD |
+ * \param[in] t #ExifTag to return |
+ * \param[out] v char* buffer in which to store value |
+ * \param[in] m unsigned int length of the buffer v |
+ * \return the v pointer, or NULL on error |
+ */ |
+#define exif_content_get_value(c,t,v,m) \ |
+ (exif_content_get_entry (c,t) ? \ |
+ exif_entry_get_value (exif_content_get_entry (c,t),v,m) : NULL) |
+ |
+/*! Dump contents of the IFD to stdout. |
+ * This is intended for diagnostic purposes only. |
+ * |
+ * \param[in] content IFD data |
+ * \param[in] indent how many levels deep to indent the data |
+ */ |
+void exif_content_dump (ExifContent *content, unsigned int indent); |
+ |
+/*! Set the log message object for this IFD. |
+ * |
+ * \param[in] content IFD |
+ * \param[in] log #ExifLog* |
+ */ |
+void exif_content_log (ExifContent *content, ExifLog *log); |
+ |
+#ifdef __cplusplus |
+} |
+#endif /* __cplusplus */ |
+ |
+#endif /* __EXIF_CONTENT_H__ */ |
Property changes on: libexif/sources/libexif/exif-content.h |
___________________________________________________________________ |
Added: svn:eol-style |
+ LF |