diff options
Diffstat (limited to 'libexif/exif-utils.h')
| -rw-r--r-- | libexif/exif-utils.h | 194 |
1 files changed, 194 insertions, 0 deletions
diff --git a/libexif/exif-utils.h b/libexif/exif-utils.h new file mode 100644 index 0000000..7861564 --- /dev/null +++ b/libexif/exif-utils.h @@ -0,0 +1,194 @@ +/*! \file exif-utils.h + * \brief EXIF data manipulation functions and types + */ +/* + * 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_UTILS_H__ +#define __EXIF_UTILS_H__ + +#ifdef __cplusplus +extern "C" { +#endif /* __cplusplus */ + +#include <libexif/exif-byte-order.h> +#include <libexif/exif-format.h> +#include <libexif/_stdint.h> + + +/* If these definitions don't work for you, please let us fix the + * macro generating _stdint.h */ + +/*! EXIF Unsigned Byte data type */ +typedef unsigned char ExifByte; /* 1 byte */ + +/*! EXIF Signed Byte data type */ +typedef signed char ExifSByte; /* 1 byte */ + +/*! EXIF Text String data type */ +typedef char * ExifAscii; + +/*! EXIF Unsigned Short data type */ +typedef uint16_t ExifShort; /* 2 bytes */ + +/*! EXIF Signed Short data type */ +typedef int16_t ExifSShort; /* 2 bytes */ + +/*! EXIF Unsigned Long data type */ +typedef uint32_t ExifLong; /* 4 bytes */ + +/*! EXIF Signed Long data type */ +typedef int32_t ExifSLong; /* 4 bytes */ + +/*! EXIF Unsigned Rational data type */ +typedef struct {ExifLong numerator; ExifLong denominator;} ExifRational; + +typedef char ExifUndefined; /* 1 byte */ + +/*! EXIF Signed Rational data type */ +typedef struct {ExifSLong numerator; ExifSLong denominator;} ExifSRational; + + +/*! Retrieve an #ExifShort value from memory. + * + * \param[in] b pointer to raw EXIF value in memory + * \param[in] order byte order of raw value + * \return value + */ +ExifShort exif_get_short (const unsigned char *b, ExifByteOrder order); + +/*! Retrieve an #ExifSShort value from memory. + * + * \param[in] b pointer to raw EXIF value in memory + * \param[in] order byte order of raw value + * \return value + */ +ExifSShort exif_get_sshort (const unsigned char *b, ExifByteOrder order); + +/*! Retrieve an #ExifLong value from memory. + * + * \param[in] b pointer to raw EXIF value in memory + * \param[in] order byte order of raw value + * \return value + */ +ExifLong exif_get_long (const unsigned char *b, ExifByteOrder order); + +/*! Retrieve an #ExifSLong value from memory. + * + * \param[in] b pointer to raw EXIF value in memory + * \param[in] order byte order of raw value + * \return value + */ +ExifSLong exif_get_slong (const unsigned char *b, ExifByteOrder order); + +/*! Retrieve an #ExifRational value from memory. + * + * \param[in] b pointer to raw EXIF value in memory + * \param[in] order byte order of raw value + * \return value + */ +ExifRational exif_get_rational (const unsigned char *b, ExifByteOrder order); + +/*! Retrieve an #ExifSRational value from memory. + * + * \param[in] b pointer to raw EXIF value in memory + * \param[in] order byte order of raw value + * \return value + */ +ExifSRational exif_get_srational (const unsigned char *b, ExifByteOrder order); + +/*! Store an ExifShort value into memory in EXIF format. + * + * \param[out] b buffer in which to write raw value + * \param[in] order byte order to use + * \param[in] value data value to store + */ +void exif_set_short (unsigned char *b, ExifByteOrder order, + ExifShort value); + +/*! Store an ExifSShort value into memory in EXIF format. + * + * \param[out] b buffer in which to write raw value + * \param[in] order byte order to use + * \param[in] value data value to store + */ +void exif_set_sshort (unsigned char *b, ExifByteOrder order, + ExifSShort value); + +/*! Store an ExifLong value into memory in EXIF format. + * + * \param[out] b buffer in which to write raw value + * \param[in] order byte order to use + * \param[in] value data value to store + */ +void exif_set_long (unsigned char *b, ExifByteOrder order, + ExifLong value); + +/*! Store an ExifSLong value into memory in EXIF format. + * + * \param[out] b buffer in which to write raw value + * \param[in] order byte order to use + * \param[in] value data value to store + */ +void exif_set_slong (unsigned char *b, ExifByteOrder order, + ExifSLong value); + +/*! Store an ExifRational value into memory in EXIF format. + * + * \param[out] b buffer in which to write raw value + * \param[in] order byte order to use + * \param[in] value data value to store + */ +void exif_set_rational (unsigned char *b, ExifByteOrder order, + ExifRational value); + +/*! Store an ExifSRational value into memory in EXIF format. + * + * \param[out] b buffer in which to write raw value + * \param[in] order byte order to use + * \param[in] value data value to store + */ +void exif_set_srational (unsigned char *b, ExifByteOrder order, + ExifSRational value); + +/*! \internal */ +void exif_convert_utf16_to_utf8 (char *out, const unsigned short *in, int maxlen); + +/* Please do not use this function outside of the library. */ + +/*! \internal */ +void exif_array_set_byte_order (ExifFormat, unsigned char *, unsigned int, + ExifByteOrder o_orig, ExifByteOrder o_new); + +#undef MIN +#define MIN(a, b) (((a) < (b)) ? (a) : (b)) + +#undef MAX +#define MAX(a, b) (((a) > (b)) ? (a) : (b)) + +/* For compatibility with older versions */ + +/*! \deprecated Use EXIF_TAG_SUB_SEC_TIME instead. */ +#define EXIF_TAG_SUBSEC_TIME EXIF_TAG_SUB_SEC_TIME + +#ifdef __cplusplus +} +#endif /* __cplusplus */ + +#endif /* __EXIF_UTILS_H__ */ |