name : exif-mnote-data.h /*! \file exif-mnote-data.h * \brief Handling EXIF MakerNote tags */ /* * Copyright (c) 2003 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 LIBEXIF_EXIF_MNOTE_DATA_H #define LIBEXIF_EXIF_MNOTE_DATA_H #ifdef __cplusplus extern "C" { #endif /* __cplusplus */ #include <libexif/exif-log.h> /*! Data found in the MakerNote tag */ typedef struct _ExifMnoteData ExifMnoteData; void exif_mnote_data_ref (ExifMnoteData *); void exif_mnote_data_unref (ExifMnoteData *); /*! Load the MakerNote data from a memory buffer. * * \param[in] d MakerNote data * \param[in] buf pointer to raw MakerNote tag data * \param[in] buf_size number of bytes of data at buf */ void exif_mnote_data_load (ExifMnoteData *d, const unsigned char *buf, unsigned int buf_size); /*! * Save the raw MakerNote data into a memory buffer. The buffer is * allocated by this function and must subsequently be freed by the * caller. * * \param[in,out] d extract the data from this structure * \param[out] buf pointer to buffer pointer containing MakerNote data on return * \param[out] buf_size pointer to the size of the buffer */ void exif_mnote_data_save (ExifMnoteData *d, unsigned char **buf, unsigned int *buf_size); /*! Return the number of tags in the MakerNote. * * \param[in] d MakerNote data * \return number of tags, or 0 if no MakerNote or the type is not supported */ unsigned int exif_mnote_data_count (ExifMnoteData *d); /*! Return the MakerNote tag number for the tag at the specified index within * the MakerNote. * * \param[in] d MakerNote data * \param[in] n index of the entry within the MakerNote data * \return MakerNote tag number */ unsigned int exif_mnote_data_get_id (ExifMnoteData *d, unsigned int n); /*! Returns textual name of the given MakerNote tag. The name is a short, * unique (within this type of MakerNote), non-localized text string * containing only US-ASCII alphanumeric characters. * * \param[in] d MakerNote data * \param[in] n index of the entry within the MakerNote data * \return textual name of the tag or NULL on error */ const char *exif_mnote_data_get_name (ExifMnoteData *d, unsigned int n); /*! Returns textual title of the given MakerNote tag. * The title is a short, localized textual description of the tag. * * \param[in] d MakerNote data * \param[in] n index of the entry within the MakerNote data * \return textual name of the tag or NULL on error */ const char *exif_mnote_data_get_title (ExifMnoteData *d, unsigned int n); /*! Returns verbose textual description of the given MakerNote tag. * * \param[in] d MakerNote data * \param[in] n index of the entry within the MakerNote data * \return textual description of the tag or NULL on error */ const char *exif_mnote_data_get_description (ExifMnoteData *d, unsigned int n); /*! Return a textual representation of the value of the MakerNote entry. * * \warning The character set of the returned string may be in * the encoding of the current locale or the native encoding * of the camera. * * \param[in] d MakerNote data * \param[in] n index of the entry within the MakerNote data * \param[out] val buffer in which to store value * \param[in] maxlen length of the buffer val * \return val pointer, or NULL on error */ char *exif_mnote_data_get_value (ExifMnoteData *d, unsigned int n, char *val, unsigned int maxlen); void exif_mnote_data_log (ExifMnoteData *, ExifLog *); #ifdef __cplusplus } #endif /* __cplusplus */ #endif /* !defined(LIBEXIF_EXIF_MNOTE_DATA_H) */