15c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)/*! \file exif-utils.h 25c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * \brief EXIF data manipulation functions and types 35c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) */ 45c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)/* 55c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * Copyright (c) 2001 Lutz Mueller <lutz@users.sourceforge.net> 65c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * 75c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * This library is free software; you can redistribute it and/or 85c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * modify it under the terms of the GNU Lesser General Public 95c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * License as published by the Free Software Foundation; either 105c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * version 2 of the License, or (at your option) any later version. 115c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * 125c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * This library is distributed in the hope that it will be useful, 135c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * but WITHOUT ANY WARRANTY; without even the implied warranty of 145c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 155c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * Lesser General Public License for more details. 165c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * 175c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * You should have received a copy of the GNU Lesser General Public 185c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * License along with this library; if not, write to the 195c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, 205c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * Boston, MA 02110-1301 USA. 215c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) */ 225c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 235c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)#ifndef __EXIF_UTILS_H__ 245c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)#define __EXIF_UTILS_H__ 255c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 265c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)#ifdef __cplusplus 275c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)extern "C" { 285c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)#endif /* __cplusplus */ 295c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 305c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)#include <libexif/exif-byte-order.h> 315267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)#include <libexif/exif-format.h> 325267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)#include <libexif/_stdint.h> 335c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 345267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) 355c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)/* If these definitions don't work for you, please let us fix the 3651b2906e11752df6c18351cf520e30522d3b53a1Torne (Richard Coles) * macro generating _stdint.h */ 37926b001d589ce2f10facb93dd4b87578ea35a855Torne (Richard Coles) 385267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)/*! EXIF Unsigned Byte data type */ 39926b001d589ce2f10facb93dd4b87578ea35a855Torne (Richard Coles)typedef unsigned char ExifByte; /* 1 byte */ 405267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) 415267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)/*! EXIF Signed Byte data type */ 425267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)typedef signed char ExifSByte; /* 1 byte */ 435267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) 445267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)/*! EXIF Text String data type */ 455267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)typedef char * ExifAscii; 465c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 475267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)/*! EXIF Unsigned Short data type */ 485267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)typedef uint16_t ExifShort; /* 2 bytes */ 495267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) 505267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)/*! EXIF Signed Short data type */ 515267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)typedef int16_t ExifSShort; /* 2 bytes */ 525267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) 535267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)/*! EXIF Unsigned Long data type */ 545267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)typedef uint32_t ExifLong; /* 4 bytes */ 555267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) 565267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)/*! EXIF Signed Long data type */ 575267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)typedef int32_t ExifSLong; /* 4 bytes */ 585267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) 595267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)/*! EXIF Unsigned Rational data type */ 605267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)typedef struct {ExifLong numerator; ExifLong denominator;} ExifRational; 615267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) 625267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)typedef char ExifUndefined; /* 1 byte */ 635267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) 645267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)/*! EXIF Signed Rational data type */ 655267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles)typedef struct {ExifSLong numerator; ExifSLong denominator;} ExifSRational; 665267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) 675267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) 6851b2906e11752df6c18351cf520e30522d3b53a1Torne (Richard Coles)/*! Retrieve an #ExifShort value from memory. 695267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) * 705267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) * \param[in] b pointer to raw EXIF value in memory 71 * \param[in] order byte order of raw value 72 * \return value 73 */ 74ExifShort exif_get_short (const unsigned char *b, ExifByteOrder order); 75 76/*! Retrieve an #ExifSShort value from memory. 77 * 78 * \param[in] b pointer to raw EXIF value in memory 79 * \param[in] order byte order of raw value 80 * \return value 81 */ 82ExifSShort exif_get_sshort (const unsigned char *b, ExifByteOrder order); 83 84/*! Retrieve an #ExifLong value from memory. 85 * 86 * \param[in] b pointer to raw EXIF value in memory 87 * \param[in] order byte order of raw value 88 * \return value 89 */ 90ExifLong exif_get_long (const unsigned char *b, ExifByteOrder order); 91 92/*! Retrieve an #ExifSLong value from memory. 93 * 94 * \param[in] b pointer to raw EXIF value in memory 95 * \param[in] order byte order of raw value 96 * \return value 97 */ 98ExifSLong exif_get_slong (const unsigned char *b, ExifByteOrder order); 99 100/*! Retrieve an #ExifRational value from memory. 101 * 102 * \param[in] b pointer to raw EXIF value in memory 103 * \param[in] order byte order of raw value 104 * \return value 105 */ 106ExifRational exif_get_rational (const unsigned char *b, ExifByteOrder order); 107 108/*! Retrieve an #ExifSRational value from memory. 109 * 110 * \param[in] b pointer to raw EXIF value in memory 111 * \param[in] order byte order of raw value 112 * \return value 113 */ 114ExifSRational exif_get_srational (const unsigned char *b, ExifByteOrder order); 115 116/*! Store an ExifShort value into memory in EXIF format. 117 * 118 * \param[out] b buffer in which to write raw value 119 * \param[in] order byte order to use 120 * \param[in] value data value to store 121 */ 122void exif_set_short (unsigned char *b, ExifByteOrder order, 123 ExifShort value); 124 125/*! Store an ExifSShort value into memory in EXIF format. 126 * 127 * \param[out] b buffer in which to write raw value 128 * \param[in] order byte order to use 129 * \param[in] value data value to store 130 */ 131void exif_set_sshort (unsigned char *b, ExifByteOrder order, 132 ExifSShort value); 133 134/*! Store an ExifLong value into memory in EXIF format. 135 * 136 * \param[out] b buffer in which to write raw value 137 * \param[in] order byte order to use 138 * \param[in] value data value to store 139 */ 140void exif_set_long (unsigned char *b, ExifByteOrder order, 141 ExifLong value); 142 143/*! Store an ExifSLong value into memory in EXIF format. 144 * 145 * \param[out] b buffer in which to write raw value 146 * \param[in] order byte order to use 147 * \param[in] value data value to store 148 */ 149void exif_set_slong (unsigned char *b, ExifByteOrder order, 150 ExifSLong value); 151 152/*! Store an ExifRational value into memory in EXIF format. 153 * 154 * \param[out] b buffer in which to write raw value 155 * \param[in] order byte order to use 156 * \param[in] value data value to store 157 */ 158void exif_set_rational (unsigned char *b, ExifByteOrder order, 159 ExifRational value); 160 161/*! Store an ExifSRational value into memory in EXIF format. 162 * 163 * \param[out] b buffer in which to write raw value 164 * \param[in] order byte order to use 165 * \param[in] value data value to store 166 */ 167void exif_set_srational (unsigned char *b, ExifByteOrder order, 168 ExifSRational value); 169 170/*! \internal */ 171void exif_convert_utf16_to_utf8 (char *out, const unsigned short *in, int maxlen); 172 173/* Please do not use this function outside of the library. */ 174 175/*! \internal */ 176void exif_array_set_byte_order (ExifFormat, unsigned char *, unsigned int, 177 ExifByteOrder o_orig, ExifByteOrder o_new); 178 179#undef MIN 180#define MIN(a, b) (((a) < (b)) ? (a) : (b)) 181 182#undef MAX 183#define MAX(a, b) (((a) > (b)) ? (a) : (b)) 184 185/* For compatibility with older versions */ 186 187/*! \deprecated Use EXIF_TAG_SUB_SEC_TIME instead. */ 188#define EXIF_TAG_SUBSEC_TIME EXIF_TAG_SUB_SEC_TIME 189 190#ifdef __cplusplus 191} 192#endif /* __cplusplus */ 193 194#endif /* __EXIF_UTILS_H__ */ 195