libexif/exif-entry.c

   1 /* exif-entry.c
   2  *
   3  * Copyright (c) 2001 Lutz Mueller <lutz@users.sourceforge.net>
   4  *
   5  * This library is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU Lesser General Public
   7  * License as published by the Free Software Foundation; either
   8  * version 2 of the License, or (at your option) any later version.
   9  *
  10  * This library is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13  * Lesser General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU Lesser General Public
  16  * License along with this library; if not, write to the
  17  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  18  * Boston, MA 02111-1307, USA.
  19  */
  20
  21 #include <config.h>
  22
  23 #include <libexif/exif-entry.h>
  24 #include <libexif/exif-ifd.h>
  25 #include <libexif/exif-utils.h>
  26 #include <libexif/i18n.h>
  27
  28 #include <ctype.h>
  29 #include <stdlib.h>
  30 #include <stdio.h>
  31 #include <string.h>
  32 #include <time.h>
  33 #include <math.h>
  34
  35 struct _ExifEntryPrivate
  36 {
  37         unsigned int ref_count;
  38
  39         ExifMem *mem;
  40 };
  41
  42 /* This function is hidden in exif-data.c */
  43 ExifLog *exif_data_get_log (ExifData *);
  44
  45 #ifndef NO_VERBOSE_TAG_STRINGS
  46 static void
  47 exif_entry_log (ExifEntry *e, ExifLogCode code, const char *format, ...)
  48 {
  49         va_list args;
  50         ExifLog *l = NULL;
  51
  52         if (e && e->parent && e->parent->parent)
  53                 l = exif_data_get_log (e->parent->parent);
  54         va_start (args, format);
  55         exif_logv (l, code, "ExifEntry", format, args);
  56         va_end (args);
  57 }
  58 #else
  59 #if defined(__STDC_VERSION__) &&  __STDC_VERSION__ >= 199901L
  60 #define exif_entry_log(...) do { } while (0)
  61 #elif defined(__GNUC__)
  62 #define exif_entry_log(x...) do { } while (0)
  63 #else
  64 #define exif_entry_log (void)
  65 #endif
  66 #endif
  67
  68 static void *
  69 exif_entry_alloc (ExifEntry *e, unsigned int i)
  70 {
  71         void *d;
  72         ExifLog *l = NULL;
  73
  74         if (!e || !e->priv || !i) return NULL;
  75
  76         d = exif_mem_alloc (e->priv->mem, i);
  77         if (d) return d;
  78
  79         if (e->parent && e->parent->parent)
  80                 l = exif_data_get_log (e->parent->parent);
  81         EXIF_LOG_NO_MEMORY (l, "ExifEntry", i);
  82         return NULL;
  83 }
  84
  85 static void *
  86 exif_entry_realloc (ExifEntry *e, void *d_orig, unsigned int i)
  87 {
  88         void *d;
  89         ExifLog *l = NULL;
  90
  91         if (!e || !e->priv) return NULL;
  92
  93         if (!i) { exif_mem_free (e->priv->mem, d_orig); return NULL; }
  94
  95         d = exif_mem_realloc (e->priv->mem, d_orig, i);
  96         if (d) return d;
  97
  98         if (e->parent && e->parent->parent)
  99                 l = exif_data_get_log (e->parent->parent);
 100         EXIF_LOG_NO_MEMORY (l, "ExifEntry", i);
 101         return NULL;
 102 }
 103
 104 ExifEntry *
 105 exif_entry_new (void)
 106 {
 107         ExifMem *mem = exif_mem_new_default ();
 108         ExifEntry *e = exif_entry_new_mem (mem);
 109
 110         exif_mem_unref (mem);
 111
 112         return e;
 113 }
 114
 115 ExifEntry *
 116 exif_entry_new_mem (ExifMem *mem)
 117 {
 118         ExifEntry *e = NULL;
 119
 120         e = exif_mem_alloc (mem, sizeof (ExifEntry));
 121         if (!e) return NULL;
 122         e->priv = exif_mem_alloc (mem, sizeof (ExifEntryPrivate));
 123         if (!e->priv) { exif_mem_free (mem, e); return NULL; }
 124         e->priv->ref_count = 1;
 125
 126         e->priv->mem = mem;
 127         exif_mem_ref (mem);
 128
 129         return e;
 130 }
 131
 132 void
 133 exif_entry_ref (ExifEntry *e)
 134 {
 135         if (!e) return;
 136
 137         e->priv->ref_count++;
 138 }
 139
 140 void
 141 exif_entry_unref (ExifEntry *e)
 142 {
 143         if (!e) return;
 144
 145         e->priv->ref_count--;
 146         if (!e->priv->ref_count)
 147                 exif_entry_free (e);
 148 }
 149
 150 void
 151 exif_entry_free (ExifEntry *e)
 152 {
 153         if (!e) return;
 154
 155         if (e->priv) {
 156                 ExifMem *mem = e->priv->mem;
 157                 if (e->data)
 158                         exif_mem_free (mem, e->data);
 159                 exif_mem_free (mem, e->priv);
 160                 exif_mem_free (mem, e);
 161                 exif_mem_unref (mem);
 162         }
 163 }
 164
 165 void
 166 exif_entry_fix (ExifEntry *e)
 167 {
 168         unsigned int i;
 169         ExifByteOrder o;
 170         ExifRational r;
 171         ExifSRational sr;
 172
 173         if (!e || !e->priv) return;
 174
 175         switch (e->tag) {
 176
 177         /* These tags all need to be of format SHORT. */
 178         case EXIF_TAG_YCBCR_SUB_SAMPLING:
 179         case EXIF_TAG_SUBJECT_AREA:
 180         case EXIF_TAG_COLOR_SPACE:
 181         case EXIF_TAG_PLANAR_CONFIGURATION:
 182         case EXIF_TAG_SENSING_METHOD:
 183         case EXIF_TAG_ORIENTATION:
 184         case EXIF_TAG_YCBCR_POSITIONING:
 185         case EXIF_TAG_PHOTOMETRIC_INTERPRETATION:
 186         case EXIF_TAG_CUSTOM_RENDERED:
 187         case EXIF_TAG_EXPOSURE_MODE:
 188         case EXIF_TAG_WHITE_BALANCE:
 189         case EXIF_TAG_SCENE_CAPTURE_TYPE:
 190         case EXIF_TAG_GAIN_CONTROL:
 191         case EXIF_TAG_SATURATION:
 192         case EXIF_TAG_CONTRAST:
 193         case EXIF_TAG_SHARPNESS:
 194                 switch (e->format) {
 195                 case EXIF_FORMAT_LONG:
 196                         if (!e->parent || !e->parent->parent) break;
 197                         o = exif_data_get_byte_order (e->parent->parent);
 198                         for (i = 0; i < e->components; i++)
 199                                 exif_set_short (
 200                                         e->data + i *
 201                                         exif_format_get_size (
 202                                         EXIF_FORMAT_SHORT), o,
 203                                         (ExifShort) exif_get_long (
 204                                         e->data + i *
 205                                         exif_format_get_size (
 206                                         EXIF_FORMAT_LONG), o));
 207                         e->format = EXIF_FORMAT_SHORT;
 208                         e->size = e->components *
 209                                 exif_format_get_size (e->format);
 210                         e->data = exif_entry_realloc (e, e->data, e->size);
 211                         exif_entry_log (e, EXIF_LOG_CODE_DEBUG,
 212                                 _("Tag '%s' was of format '%s' (which is "
 213                                 "against specification) and has been "
 214                                 "changed to format '%s'."),
 215                                 exif_tag_get_name (e->tag),
 216                                 exif_format_get_name (EXIF_FORMAT_LONG),
 217                                 exif_format_get_name (EXIF_FORMAT_SHORT));
 218                         break;
 219                 case EXIF_FORMAT_SHORT:
 220                 default:
 221                         break;
 222                 }
 223                 break;
 224
 225         /* All these tags need to be of format 'Rational'. */
 226         case EXIF_TAG_FNUMBER:
 227         case EXIF_TAG_APERTURE_VALUE:
 228         case EXIF_TAG_EXPOSURE_TIME:
 229         case EXIF_TAG_FOCAL_LENGTH:
 230                 switch (e->format) {
 231                 case EXIF_FORMAT_SRATIONAL:
 232                         if (!e->parent || !e->parent->parent) break;
 233                         o = exif_data_get_byte_order (e->parent->parent);
 234                         for (i = 0; i < e->components; i++) {
 235                                 sr = exif_get_srational (e->data + i *
 236                                         exif_format_get_size (
 237                                                 EXIF_FORMAT_SRATIONAL), o);
 238                                 r.numerator = (ExifLong) sr.numerator;
 239                                 r.denominator = (ExifLong) sr.denominator;
 240                                 exif_set_rational (e->data + i *
 241                                         exif_format_get_size (
 242                                                 EXIF_FORMAT_RATIONAL), o, r);
 243                         }
 244                         e->format = EXIF_FORMAT_RATIONAL;
 245                         exif_entry_log (e, EXIF_LOG_CODE_DEBUG,
 246                                 _("Tag '%s' was of format '%s' (which is "
 247                                 "against specification) and has been "
 248                                 "changed to format '%s'."),
 249                                 exif_tag_get_name (e->tag),
 250                                 exif_format_get_name (EXIF_FORMAT_SRATIONAL),
 251                                 exif_format_get_name (EXIF_FORMAT_RATIONAL));
 252                         break;
 253                 default:
 254                         break;
 255                 }
 256                 break;
 257
 258         case EXIF_TAG_USER_COMMENT:
 259
 260                 /* Format needs to be UNDEFINED. */
 261                 if (e->format != EXIF_FORMAT_UNDEFINED) {
 262                         exif_entry_log (e, EXIF_LOG_CODE_DEBUG,
 263                                 _("Tag 'UserComment' had invalid format '%s'. "
 264                                 "Format has been set to 'undefined'."),
 265                                 exif_format_get_name (e->format));
 266                         e->format = EXIF_FORMAT_UNDEFINED;
 267                 }
 268
 269                 /* Some packages like Canon ZoomBrowser EX 4.5 store
 270                    only one zero byte followed by 7 bytes of rubbish */
 271                 if ((e->size >= 8) && (e->data[0] == 0)) {
 272                         memcpy(e->data, "\0\0\0\0\0\0\0\0", 8);
 273                 }
 274
 275                 /* There need to be at least 8 bytes. */
 276                 if (e->size < 8) {
 277                         e->data = exif_entry_realloc (e, e->data, 8 + e->size);
 278                         if (!e->data) {
 279                                 e->size = 0;
 280                                 e->components = 0;
 281                                 return;
 282                         }
 283
 284                         /* Assume ASCII */
 285                         memmove (e->data + 8, e->data, e->size);
 286                         memcpy (e->data, "ASCII\0\0\0", 8);
 287                         e->size += 8;
 288                         e->components += 8;
 289                         exif_entry_log (e, EXIF_LOG_CODE_DEBUG,
 290                                 _("Tag 'UserComment' has been expanded to at "
 291                                 "least 8 bytes in order to follow the "
 292                                 "specification."));
 293                         break;
 294                 }
 295
 296                 /*
 297                  * If the first 8 bytes are empty and real data starts
 298                  * afterwards, let's assume ASCII and claim the 8 first
 299                  * bytes for the format specifyer.
 300                  */
 301                 for (i = 0; (i < e->size) && !e->data[i]; i++);
 302                 if (!i) for ( ; (i < e->size) && (e->data[i] == ' '); i++);
 303                 if ((i >= 8) && (i < e->size)) {
 304                         exif_entry_log (e, EXIF_LOG_CODE_DEBUG,
 305                                 _("Tag 'UserComment' is not empty but does not "
 306                                 "start with a format identifier. "
 307                                 "This has been fixed."));
 308                         memcpy (e->data, "ASCII\0\0\0", 8);
 309                         break;
 310                 }
 311
 312                 /*
 313                  * First 8 bytes need to follow the specification. If they don't,
 314                  * assume ASCII.
 315                  */
 316                 if (memcmp (e->data, "ASCII\0\0\0"     , 8) &&
 317                     memcmp (e->data, "UNICODE\0"       , 8) &&
 318                     memcmp (e->data, "JIS\0\0\0\0\0"   , 8) &&
 319                     memcmp (e->data, "\0\0\0\0\0\0\0\0", 8)) {
 320                         e->data = exif_entry_realloc (e, e->data, 8 + e->size);
 321                         if (!e->data) {
 322                                 e->size = 0;
 323                                 e->components = 0;
 324                                 break;
 325                         }
 326
 327                         /* Assume ASCII */
 328                         memmove (e->data + 8, e->data, e->size);
 329                         memcpy (e->data, "ASCII\0\0\0", 8);
 330                         e->size += 8;
 331                         e->components += 8;
 332                         exif_entry_log (e, EXIF_LOG_CODE_DEBUG,
 333                                 _("Tag 'UserComment' did not start with "
 334                                 "format identifier. This has been fixed."));
 335                         break;
 336                 }
 337
 338                 break;
 339         default:
 340                 break;
 341         }
 342 }
 343
 344 void
 345 exif_entry_dump (ExifEntry *e, unsigned int indent)
 346 {
 347         char buf[1024];
 348         char value[1024];
 349         unsigned int i;
 350
 351         for (i = 0; i < 2 * indent; i++)
 352                 buf[i] = ' ';
 353         buf[i] = '\0';
 354
 355         if (!e)
 356                 return;
 357
 358         printf ("%sTag: 0x%x ('%s')\n", buf, e->tag,
 359                 exif_tag_get_name (e->tag));
 360         printf ("%s  Format: %i ('%s')\n", buf, e->format,
 361                 exif_format_get_name (e->format));
 362         printf ("%s  Components: %i\n", buf, (int) e->components);
 363         printf ("%s  Size: %i\n", buf, e->size);
 364         printf ("%s  Value: %s\n", buf, exif_entry_get_value (e, value, sizeof(value)));
 365 }
 366
 367 #define CF(entry,target,v,maxlen)                                       \
 368 {                                                                       \
 369         if (entry->format != target) {                                  \
 370                 exif_entry_log (entry, EXIF_LOG_CODE_CORRUPT_DATA,      \
 371                         _("The tag '%s' contains data of an invalid "   \
 372                         "format ('%s', expected '%s')."),               \
 373                         exif_tag_get_name (entry->tag),                 \
 374                         exif_format_get_name (entry->format),           \
 375                         exif_format_get_name (target));                 \
 376                 break;                                                  \
 377         }                                                               \
 378 }
 379
 380 #define CC(entry,target,v,maxlen)                                       \
 381 {                                                                       \
 382         if (entry->components != target) {                              \
 383                 exif_entry_log (entry, EXIF_LOG_CODE_CORRUPT_DATA,      \
 384                         _("The tag '%s' contains an invalid number of " \
 385                           "components (%i, expected %i)."),             \
 386                         exif_tag_get_name (entry->tag),         \
 387                         (int) entry->components, (int) target);         \
 388                 break;                                                  \
 389         }                                                               \
 390 }
 391
 392 static const struct {
 393         ExifTag tag;
 394         const char *strings[10];
 395 } list[] = {
 396 #ifndef NO_VERBOSE_TAG_DATA
 397   { EXIF_TAG_PLANAR_CONFIGURATION,
 398     { N_("chunky format"), N_("planar format"), NULL}},
 399   { EXIF_TAG_SENSING_METHOD,
 400     { "", N_("Not defined"), N_("One-chip color area sensor"),
 401       N_("Two-chip color area sensor"), N_("Three-chip color area sensor"),
 402       N_("Color sequential area sensor"), "", N_("Trilinear sensor"),
 403       N_("Color sequential linear sensor"), NULL}},
 404   { EXIF_TAG_ORIENTATION,
 405     { "", N_("top - left"), N_("top - right"), N_("bottom - right"),
 406       N_("bottom - left"), N_("left - top"), N_("right - top"),
 407       N_("right - bottom"), N_("left - bottom"), NULL}},
 408   { EXIF_TAG_YCBCR_POSITIONING,
 409     { "", N_("centered"), N_("co-sited"), NULL}},
 410   { EXIF_TAG_PHOTOMETRIC_INTERPRETATION,
 411     {N_("Reversed mono"), N_("Normal mono"), N_("RGB"), N_("Palette"), "",
 412       N_("CMYK"), N_("YCbCr"), "", N_("CieLAB"), NULL}},
 413   { EXIF_TAG_CUSTOM_RENDERED,
 414     { N_("Normal process"), N_("Custom process"), NULL}},
 415   { EXIF_TAG_EXPOSURE_MODE,
 416     { N_("Auto exposure"), N_("Manual exposure"), N_("Auto bracket"), NULL}},
 417   { EXIF_TAG_WHITE_BALANCE,
 418     { N_("Auto white balance"), N_("Manual white balance"), NULL}},
 419   { EXIF_TAG_SCENE_CAPTURE_TYPE,
 420     { N_("Standard"), N_("Landscape"), N_("Portrait"),
 421       N_("Night scene"), NULL}},
 422   { EXIF_TAG_GAIN_CONTROL,
 423     { N_("Normal"), N_("Low gain up"), N_("High gain up"),
 424       N_("Low gain down"), N_("High gain down"), NULL}},
 425   { EXIF_TAG_SATURATION,
 426     { N_("Normal"), N_("Low saturation"), N_("High saturation"), NULL}},
 427   { EXIF_TAG_CONTRAST , {N_("Normal"), N_("Soft"), N_("Hard"), NULL}},
 428   { EXIF_TAG_SHARPNESS, {N_("Normal"), N_("Soft"), N_("Hard"), NULL}},
 429 #endif
 430   { 0, {NULL}}
 431 };
 432
 433 static const struct {
 434   ExifTag tag;
 435   struct {
 436     int index;
 437     const char *values[4];
 438   } elem[25];
 439 } list2[] = {
 440 #ifndef NO_VERBOSE_TAG_DATA
 441   { EXIF_TAG_METERING_MODE,
 442     { {  0, {N_("Unknown"), NULL}},
 443       {  1, {N_("Average"), N_("avg"), NULL}},
 444       {  2, {N_("Center-Weighted Average"), N_("Center-Weight"), NULL}},
 445       {  3, {N_("Spot"), NULL}},
 446       {  4, {N_("Multi Spot"), NULL}},
 447       {  5, {N_("Pattern"), NULL}},
 448       {  6, {N_("Partial"), NULL}},
 449       {255, {N_("Other"), NULL}},
 450       {  0, {NULL}}}},
 451   { EXIF_TAG_COMPRESSION,
 452     { {1, {N_("Uncompressed"), NULL}},
 453       {5, {N_("LZW compression"), NULL}},
 454       {6, {N_("JPEG compression"), NULL}},
 455       {7, {N_("JPEG compression"), NULL}},
 456       {8, {N_("Deflate/ZIP compression"), NULL}},
 457       {32773, {N_("PackBits compression"), NULL}},
 458       {0, {NULL}}}},
 459   { EXIF_TAG_LIGHT_SOURCE,
 460     { {  0, {N_("Unknown"), NULL}},
 461       {  1, {N_("Daylight"), NULL}},
 462       {  2, {N_("Fluorescent"), NULL}},
 463       {  3, {N_("Tungsten incandescent light"), N_("Tungsten"), NULL}},
 464       {  4, {N_("Flash"), NULL}},
 465       {  9, {N_("Fine weather"), NULL}},
 466       { 10, {N_("Cloudy weather"), N_("Cloudy"), NULL}},
 467       { 11, {N_("Shade"), NULL}},
 468       { 12, {N_("Daylight fluorescent"), NULL}},
 469       { 13, {N_("Day white fluorescent"), NULL}},
 470       { 14, {N_("Cool white fluorescent"), NULL}},
 471       { 15, {N_("White fluorescent"), NULL}},
 472       { 17, {N_("Standard light A"), NULL}},
 473       { 18, {N_("Standard light B"), NULL}},
 474       { 19, {N_("Standard light C"), NULL}},
 475       { 20, {N_("D55"), NULL}},
 476       { 21, {N_("D65"), NULL}},
 477       { 22, {N_("D75"), NULL}},
 478       { 24, {N_("ISO studio tungsten"),NULL}},
 479       {255, {N_("Other"), NULL}},
 480       {  0, {NULL}}}},
 481   { EXIF_TAG_FOCAL_PLANE_RESOLUTION_UNIT,
 482     { {2, {N_("Inch"), N_("in"), NULL}},
 483       {3, {N_("Centimeter"), N_("cm"), NULL}},
 484       {0, {NULL}}}},
 485   { EXIF_TAG_RESOLUTION_UNIT,
 486     { {2, {N_("Inch"), N_("in"), NULL}},
 487       {3, {N_("Centimeter"), N_("cm"), NULL}},
 488       {0, {NULL}}}},
 489   { EXIF_TAG_EXPOSURE_PROGRAM,
 490     { {0, {N_("Not defined"), NULL}},
 491       {1, {N_("Manual"), NULL}},
 492       {2, {N_("Normal program"), N_("Normal"), NULL}},
 493       {3, {N_("Aperture priority"), N_("Aperture"), NULL}},
 494       {4, {N_("Shutter priority"),N_("Shutter"), NULL}},
 495       {5, {N_("Creative program (biased toward depth of field)"),
 496            N_("Creative"), NULL}},
 497       {6, {N_("Creative program (biased toward fast shutter speed)"),
 498            N_("Action"), NULL}},
 499       {7, {N_("Portrait mode (for closeup photos with the background out "
 500               "of focus)"), N_("Portrait"), NULL}},
 501       {8, {N_("Landscape mode (for landscape photos with the background "
 502               "in focus)"), N_("Landscape"), NULL}},
 503       {0, {NULL}}}},
 504   { EXIF_TAG_FLASH,
 505     { {0x0000, {N_("Flash did not fire."), N_("no flash"), NULL}},
 506       {0x0001, {N_("Flash fired."), N_("flash"), N_("Yes"), NULL}},
 507       {0x0005, {N_("Strobe return light not detected."), N_("W/o strobe"),
 508                 NULL}},
 509       {0x0007, {N_("Strobe return light detected."), N_("W. strobe"), NULL}},
 510       {0x0008, {N_("Flash did not fire."), NULL}}, /* Olympus E-330 */
 511       {0x0009, {N_("Flash fired, compulsory flash mode."), NULL}},
 512       {0x000d, {N_("Flash fired, compulsory flash mode, return light "
 513                    "not detected."), NULL}},
 514       {0x000f, {N_("Flash fired, compulsory flash mode, return light "
 515                    "detected."), NULL}},
 516       {0x0010, {N_("Flash did not fire, compulsory flash mode."), NULL}},
 517       {0x0018, {N_("Flash did not fire, auto mode."), NULL}},
 518       {0x0019, {N_("Flash fired, auto mode."), NULL}},
 519       {0x001d, {N_("Flash fired, auto mode, return light not detected."),
 520                 NULL}},
 521       {0x001f, {N_("Flash fired, auto mode, return light detected."), NULL}},
 522       {0x0020, {N_("No flash function."),NULL}},
 523       {0x0041, {N_("Flash fired, red-eye reduction mode."), NULL}},
 524       {0x0045, {N_("Flash fired, red-eye reduction mode, return light "
 525                    "not detected."), NULL}},
 526       {0x0047, {N_("Flash fired, red-eye reduction mode, return light "
 527                    "detected."), NULL}},
 528       {0x0049, {N_("Flash fired, compulsory flash mode, red-eye reduction "
 529                    "mode."), NULL}},
 530       {0x004d, {N_("Flash fired, compulsory flash mode, red-eye reduction "
 531                   "mode, return light not detected."), NULL}},
 532       {0x004f, {N_("Flash fired, compulsory flash mode, red-eye reduction mode, "
 533                    "return light detected."), NULL}},
 534       {0x0058, {N_("Flash did not fire, auto mode, red-eye reduction mode."), NULL}},
 535       {0x0059, {N_("Flash fired, auto mode, red-eye reduction mode."), NULL}},
 536       {0x005d, {N_("Flash fired, auto mode, return light not detected, "
 537                    "red-eye reduction mode."), NULL}},
 538       {0x005f, {N_("Flash fired, auto mode, return light detected, "
 539                    "red-eye reduction mode."), NULL}},
 540       {0x0000, {NULL}}}},
 541   {EXIF_TAG_SUBJECT_DISTANCE_RANGE,
 542     { {0, {N_("Unknown"), N_("?"), NULL}},
 543       {1, {N_("Macro"), NULL}},
 544       {2, {N_("Close view"), N_("Close"), NULL}},
 545       {3, {N_("Distant view"), N_("Distant"), NULL}},
 546       {0, {NULL}}}},
 547   { EXIF_TAG_COLOR_SPACE,
 548     { {1, {N_("sRGB"), NULL}},
 549       {2, {N_("Adobe RGB"), NULL}},
 550       {0xffff, {N_("Uncalibrated"), NULL}},
 551       {0x0000, {NULL}}}},
 552 #endif
 553   {0, { { 0, {NULL}}} }
 554 };
 555
 556 const char *
 557 exif_entry_get_value (ExifEntry *e, char *val, unsigned int maxlen)
 558 {
 559         unsigned int i, j, k;
 560         const unsigned char *t;
 561         ExifByte v_byte;
 562         ExifShort v_short, v_short2, v_short3, v_short4;
 563         ExifLong v_long;
 564         ExifSLong v_slong;
 565         ExifRational v_rat;
 566         ExifSRational v_srat;
 567         char b[64];
 568         const char *c;
 569         ExifByteOrder o;
 570         double d;
 571         ExifEntry *entry;
 572         static const struct {
 573                 char label[5];
 574                 char major, minor;
 575         } versions[] = {
 576                 {"0110", 1,  1},
 577                 {"0120", 1,  2},
 578                 {"0200", 2,  0},
 579                 {"0210", 2,  1},
 580                 {"0220", 2,  2},
 581                 {"0221", 2, 21},
 582                 {""    , 0,  0}
 583         };
 584
 585         /* FIXME: This belongs to somewhere else. */
 586         /* libexif should use the default system locale.
 587          * If an application specifically requires UTF-8, then we
 588          * must give the application a way to tell libexif that.
 589          *
 590          * bind_textdomain_codeset (GETTEXT_PACKAGE, "UTF-8");
 591          */
 592         bindtextdomain (GETTEXT_PACKAGE, LOCALEDIR);
 593
 594         /* make sure the returned string is zero terminated */
 595         memset (val, 0, maxlen);
 596         maxlen--;
 597         memset (b, 0, sizeof (b));
 598
 599         /* We need the byte order */
 600         if (!e || !e->parent || !e->parent->parent)
 601                 return val;
 602         o = exif_data_get_byte_order (e->parent->parent);
 603
 604         /* Sanity check */
 605         if (e->size != e->components * exif_format_get_size (e->format)) {
 606                 snprintf (val, maxlen, _("Invalid size of entry (%i, "
 607                         "expected %li x %i)."), e->size, e->components,
 608                                 exif_format_get_size (e->format));
 609                 return val;
 610         }
 611
 612         switch (e->tag) {
 613         case EXIF_TAG_USER_COMMENT:
 614
 615                 /*
 616                  * The specification says UNDEFINED, but some
 617                  * manufacturers don't care and use ASCII. If this is the
 618                  * case here, only refuse to read it if there is no chance
 619                  * of finding readable data.
 620                  */
 621                 if ((e->format != EXIF_FORMAT_ASCII) ||
 622                     (e->size <= 8) ||
 623                     ( memcmp (e->data, "ASCII\0\0\0"  , 8) &&
 624                       memcmp (e->data, "UNICODE\0"    , 8) &&
 625                       memcmp (e->data, "JIS\0\0\0\0\0", 8) &&
 626                       memcmp (e->data, "\0\0\0\0\0\0\0\0", 8)))
 627                         CF (e, EXIF_FORMAT_UNDEFINED, val, maxlen);
 628
 629                 /*
 630                  * Note that, according to the specification (V2.1, p 40),
 631                  * the user comment field does not have to be
 632                  * NULL terminated.
 633                  */
 634                 if ((e->size >= 8) && !memcmp (e->data, "ASCII\0\0\0", 8)) {
 635                         strncpy (val, (char *) e->data + 8, MIN (e->size - 8, maxlen));
 636                         break;
 637                 }
 638                 if ((e->size >= 8) && !memcmp (e->data, "UNICODE\0", 8)) {
 639                         strncpy (val, _("Unsupported UNICODE string"), maxlen);
 640                 /* FIXME: use iconv to convert into the locale encoding.
 641                  * EXIF 2.2 implies (but does not say) that this encoding is
 642                  * UCS-2.
 643                  */
 644                         break;
 645                 }
 646                 if ((e->size >= 8) && !memcmp (e->data, "JIS\0\0\0\0\0", 8)) {
 647                         strncpy (val, _("Unsupported JIS string"), maxlen);
 648                 /* FIXME: use iconv to convert into the locale encoding */
 649                         break;
 650                 }
 651
 652                 /* Check if there is really some information in the tag. */
 653                 for (i = 0; (i < e->size) &&
 654                             (!e->data[i] || (e->data[i] == ' ')); i++);
 655                 if (i == e->size) break;
 656
 657                 /*
 658                  * If we reach this point, the tag does not
 659                  * comply with the standard and seems to contain data.
 660                  * Print as much as possible.
 661                  */
 662                 exif_entry_log (e, EXIF_LOG_CODE_DEBUG,
 663                         _("Tag UserComment does not comply "
 664                         "with standard but contains data."));
 665                 for (; (i < e->size)  && (strlen (val) < maxlen - 1); i++) {
 666                         exif_entry_log (e, EXIF_LOG_CODE_DEBUG,
 667                                 _("Byte at position %i: 0x%02x"), i, e->data[i]);
 668                         val[strlen (val)] =
 669                                 isprint (e->data[i]) ? e->data[i] : '.';
 670                 }
 671                 break;
 672
 673         case EXIF_TAG_EXIF_VERSION:
 674                 CF (e, EXIF_FORMAT_UNDEFINED, val, maxlen);
 675                 CC (e, 4, val, maxlen);
 676                 strncpy (val, _("Unknown Exif Version"), maxlen);
 677                 for (i = 0; *versions[i].label; i++) {
 678                         if (!memcmp (e->data, versions[i].label, 4)) {
 679                                 snprintf (val, maxlen,
 680                                         _("Exif Version %d.%d"),
 681                                         versions[i].major,
 682                                         versions[i].minor);
 683                                 break;
 684                         }
 685                 }
 686                 break;
 687         case EXIF_TAG_FLASH_PIX_VERSION:
 688                 CF (e, EXIF_FORMAT_UNDEFINED, val, maxlen);
 689                 CC (e, 4, val, maxlen);
 690                 if (!memcmp (e->data, "0100", 4))
 691                         strncpy (val, _("FlashPix Version 1.0"), maxlen);
 692                 else if (!memcmp (e->data, "0101", 4))
 693                         strncpy (val, _("FlashPix Version 1.01"), maxlen);
 694                 else
 695                         strncpy (val, _("Unknown FlashPix Version"), maxlen);
 696                 break;
 697         case EXIF_TAG_COPYRIGHT:
 698                 CF (e, EXIF_FORMAT_ASCII, val, maxlen);
 699
 700                 /*
 701                  * First part: Photographer.
 702                  * Some cameras store a string like "   " here. Ignore it.
 703                  */
 704                 if (e->size && e->data &&
 705                     (strspn ((char *)e->data, " ") != strlen ((char *) e->data)))
 706                         strncpy (val, (char *) e->data, MIN (maxlen, e->size));
 707                 else
 708                         strncpy (val, _("[None]"), maxlen);
 709                 strncat (val, " ", maxlen - strlen (val));
 710                 strncat (val, _("(Photographer)"), maxlen - strlen (val));
 711
 712                 /* Second part: Editor. */
 713                 strncat (val, " - ", maxlen - strlen (val));
 714                 if (e->size && e->data) {
 715                         size_t ts;
 716                         t = e->data + strlen ((char *) e->data) + 1;
 717                         ts = e->data + e->size - t;
 718                         if ((ts > 0) && (strspn ((char *)t, " ") != ts))
 719                                 strncat (val, (char *)t, MIN (maxlen - strlen (val), ts));
 720                 } else {
 721                         strncat (val, _("[None]"), maxlen - strlen (val));
 722                 }
 723                 strncat (val, " ", maxlen - strlen (val));
 724                 strncat (val, _("(Editor)"), maxlen - strlen (val));
 725
 726                 break;
 727         case EXIF_TAG_FNUMBER:
 728                 CF (e, EXIF_FORMAT_RATIONAL, val, maxlen);
 729                 CC (e, 1, val, maxlen);
 730                 v_rat = exif_get_rational (e->data, o);
 731                 if (!v_rat.denominator) return val;
 732                 d = (double) v_rat.numerator / (double) v_rat.denominator;
 733                 snprintf (val, maxlen, "f/%.01lf", d);
 734                 break;
 735         case EXIF_TAG_APERTURE_VALUE:
 736         case EXIF_TAG_MAX_APERTURE_VALUE:
 737                 CF (e, EXIF_FORMAT_RATIONAL, val, maxlen);
 738                 CC (e, 1, val, maxlen);
 739                 v_rat = exif_get_rational (e->data, o);
 740                 if (!v_rat.denominator) return val;
 741                 d = (double) v_rat.numerator / (double) v_rat.denominator;
 742                 snprintf (val, maxlen, _("%.02lf EV"), d);
 743                 snprintf (b, sizeof (b), _(" (f/%.01f)"), pow (2, d / 2.));
 744                 if (maxlen > strlen (val) + strlen (b))
 745                         strncat (val, b, maxlen - strlen (val) - 1);
 746                 break;
 747         case EXIF_TAG_FOCAL_LENGTH:
 748                 CF (e, EXIF_FORMAT_RATIONAL, val, maxlen);
 749                 CC (e, 1, val, maxlen);
 750                 v_rat = exif_get_rational (e->data, o);
 751                 if (!v_rat.denominator) return val;
 752
 753                 /*
 754                  * For calculation of the 35mm equivalent,
 755                  * Minolta cameras need a multiplier that depends on the
 756                  * camera model.
 757                  */
 758                 d = 0.;
 759                 entry = exif_content_get_entry (
 760                         e->parent->parent->ifd[EXIF_IFD_0], EXIF_TAG_MAKE);
 761                 if (entry && entry->data &&
 762                     !strncmp ((char *)entry->data, "Minolta", 7)) {
 763                         entry = exif_content_get_entry (
 764                                         e->parent->parent->ifd[EXIF_IFD_0],
 765                                         EXIF_TAG_MODEL);
 766                         if (entry && entry->data) {
 767                                 if (!strncmp ((char *)entry->data, "DiMAGE 7", 8))
 768                                         d = 3.9;
 769                                 else if (!strncmp ((char *)entry->data, "DiMAGE 5", 8))
 770                                         d = 4.9;
 771                         }
 772                 }
 773                 if (d)
 774                         snprintf (b, sizeof (b), _(" (35 equivalent: %d mm)"),
 775                                   (int) (d * (double) v_rat.numerator /
 776                                              (double) v_rat.denominator));
 777
 778                 d = (double) v_rat.numerator / (double) v_rat.denominator;
 779                 snprintf (val, maxlen, "%.1lf mm", d);
 780                 if (maxlen > strlen (val) + strlen (b))
 781                         strncat (val, b, maxlen - strlen (val) - 1);
 782                 break;
 783         case EXIF_TAG_SUBJECT_DISTANCE:
 784                 CF (e, EXIF_FORMAT_RATIONAL, val, maxlen);
 785                 CC (e, 1, val, maxlen);
 786                 v_rat = exif_get_rational (e->data, o);
 787                 if (!v_rat.denominator) return val;
 788                 d = (double) v_rat.numerator / (double) v_rat.denominator;
 789                 snprintf (val, maxlen, "%.1lf m", d);
 790                 break;
 791         case EXIF_TAG_EXPOSURE_TIME:
 792                 CF (e, EXIF_FORMAT_RATIONAL, val, maxlen);
 793                 CC (e, 1, val, maxlen);
 794                 v_rat = exif_get_rational (e->data, o);
 795                 if (!v_rat.denominator) return val;
 796                 d = (double) v_rat.numerator / (double) v_rat.denominator;
 797                 if (d < 1)
 798                         snprintf (val, maxlen, _("1/%d"), (int) (0.5 + 1. / d));
 799                 else
 800                         snprintf (val, maxlen, _("%d"), (int) d);
 801                 if (maxlen > strlen (val) + strlen (_(" sec.")))
 802                         strncat (val, _(" sec."), maxlen - strlen (val) - 1);
 803                 break;
 804         case EXIF_TAG_SHUTTER_SPEED_VALUE:
 805                 CF (e, EXIF_FORMAT_SRATIONAL, val, maxlen);
 806                 CC (e, 1, val, maxlen);
 807                 v_srat = exif_get_srational (e->data, o);
 808                 if (!v_srat.denominator) return val;
 809                 d = (double) v_srat.numerator / (double) v_srat.denominator;
 810                 snprintf (val, maxlen, _("%.02f EV"), d);
 811                 snprintf (b, sizeof (b), " (APEX: %i)", (int) pow (sqrt(2), d));
 812                 if (maxlen > strlen (val) + strlen (b))
 813                         strncat (val, b, maxlen - strlen (val) - 1);
 814                 d = 1. / pow (2, d);
 815                 if (d < 1)
 816                   snprintf (b, sizeof (b), _(" 1/%d sec.)"), (int) (1. / d));
 817                 else
 818                   snprintf (b, sizeof (b), _(" %d sec.)"), (int) d);
 819                 if (maxlen > strlen (val) + strlen (b)) {
 820                   val[strlen (val) - 1] = ',';
 821                   strncat (val, b, maxlen - strlen (val) - 1);
 822                 }
 823                 break;
 824         case EXIF_TAG_BRIGHTNESS_VALUE:
 825                 CF (e, EXIF_FORMAT_SRATIONAL, val, maxlen);
 826                 CC (e, 1, val, maxlen);
 827                 v_srat = exif_get_srational (e->data, o);
 828                 if (!v_srat.denominator) return val;
 829                 d = (double) v_srat.numerator / (double) v_srat.denominator;
 830                 snprintf (val, maxlen, _("%.02f EV"), d);
 831                 snprintf (b, sizeof (b), _(" (%.02f cd/m^2)"),
 832                         1. / (M_PI * 0.3048 * 0.3048) * pow (2, d));
 833                 if (maxlen > strlen (val) + strlen (b))
 834                         strncat (val, b, maxlen - strlen (val) - 1);
 835                 break;
 836         case EXIF_TAG_FILE_SOURCE:
 837                 CF (e, EXIF_FORMAT_UNDEFINED, val, maxlen);
 838                 CC (e, 1, val, maxlen);
 839                 switch (e->data[0]) {
 840                 case 0x03: strncpy (val, _("DSC"), maxlen); break;
 841                 default: snprintf (val, maxlen, "0x%02x", e->data[0]); break;
 842                 }
 843                 break;
 844         case EXIF_TAG_COMPONENTS_CONFIGURATION:
 845                 CF (e, EXIF_FORMAT_UNDEFINED, val, maxlen);
 846                 CC (e, 4, val, maxlen);
 847                 for (i = 0; i < 4; i++) {
 848                         switch (e->data[i]) {
 849                         case 0: c = _("-"); break;
 850                         case 1: c = _("Y"); break;
 851                         case 2: c = _("Cb"); break;
 852                         case 3: c = _("Cr"); break;
 853                         case 4: c = _("R"); break;
 854                         case 5: c = _("G"); break;
 855                         case 6: c = _("B"); break;
 856                         default: c = _("reserved"); break;
 857                         }
 858                         strncat (val, c, maxlen - strlen (val));
 859                         if (i < 3) strncat (val, " ", maxlen - strlen (val));
 860                 }
 861                 break;
 862         case EXIF_TAG_EXPOSURE_BIAS_VALUE:
 863                 CF (e, EXIF_FORMAT_SRATIONAL, val, maxlen);
 864                 CC (e, 1, val, maxlen);
 865                 v_srat = exif_get_srational (e->data, o);
 866                 if (!v_srat.denominator) return val;
 867                 d = (double) v_srat.numerator / (double) v_srat.denominator;
 868                 snprintf (val, maxlen, _("%.02f EV"), d);
 869                 break;
 870         case EXIF_TAG_YCBCR_SUB_SAMPLING:
 871                 CF (e, EXIF_FORMAT_SHORT, val, maxlen);
 872                 CC (e, 2, val, maxlen);
 873                 v_short  = exif_get_short (e->data, o);
 874                 v_short2 = exif_get_short (
 875                         e->data + exif_format_get_size (e->format),
 876                         o);
 877                 if ((v_short == 2) && (v_short2 == 1))
 878                         strncpy (val, _("YCbCr4:2:2"), maxlen);
 879                 else if ((v_short == 2) && (v_short2 == 2))
 880                         strncpy (val, _("YCbCr4:2:0"), maxlen);
 881                 else
 882                         snprintf (val, maxlen, "%i, %i", v_short, v_short2);
 883                 break;
 884         case EXIF_TAG_SUBJECT_AREA:
 885                 CF (e, EXIF_FORMAT_SHORT, val, maxlen);
 886                 switch (e->components) {
 887                 case 2:
 888                         v_short  = exif_get_short (e->data, o);
 889                         v_short2 = exif_get_short (e->data + 2, o);
 890                         snprintf (val, maxlen, "(x,y) = (%i,%i)",
 891                                   v_short, v_short2);
 892                         break;
 893                 case 3:
 894                         v_short  = exif_get_short (e->data, o);
 895                         v_short2 = exif_get_short (e->data + 2, o);
 896                         v_short3 = exif_get_short (e->data + 4, o);
 897                         snprintf (val, maxlen, _("Within distance %i of "
 898                                 "(x,y) = (%i,%i)"), v_short3, v_short,
 899                                 v_short2);
 900                         break;
 901                 case 4:
 902                         v_short  = exif_get_short (e->data, o);
 903                         v_short2 = exif_get_short (e->data + 2, o);
 904                         v_short3 = exif_get_short (e->data + 4, o);
 905                         v_short4 = exif_get_short (e->data + 6, o);
 906                         snprintf (val, maxlen, _("Within rectangle "
 907                                 "(width %i, height %i) around "
 908                                 "(x,y) = (%i,%i)"), v_short3, v_short4,
 909                                 v_short, v_short2);
 910                         break;
 911                 default:
 912                         snprintf (val, maxlen, _("Unexpected number "
 913                                 "of components (%li, expected 2, 3, or 4)."),
 914                                 e->components);
 915                 }
 916                 break;
 917
 918         case EXIF_TAG_METERING_MODE:
 919         case EXIF_TAG_COMPRESSION:
 920         case EXIF_TAG_FOCAL_PLANE_RESOLUTION_UNIT:
 921         case EXIF_TAG_RESOLUTION_UNIT:
 922         case EXIF_TAG_EXPOSURE_PROGRAM:
 923         case EXIF_TAG_FLASH:
 924         case EXIF_TAG_SUBJECT_DISTANCE_RANGE:
 925         case EXIF_TAG_COLOR_SPACE:
 926                 CF (e,EXIF_FORMAT_SHORT, val, maxlen);
 927                 CC (e, 1, val, maxlen);
 928                 v_short = exif_get_short (e->data, o);
 929
 930                 /* Search the tag */
 931                 for (i = 0; list2[i].tag && (list2[i].tag != e->tag); i++);
 932                 if (!list2[i].tag) {
 933                         snprintf (val, maxlen, _("Internal error (unknown "
 934                                   "value %i)"), v_short);
 935                         break;
 936                 }
 937
 938                 /* Find the value */
 939                 for (j = 0; list2[i].elem[j].values[0] &&
 940                             (list2[i].elem[j].index < v_short); j++);
 941                 if (list2[i].elem[j].index != v_short) {
 942                         snprintf (val, maxlen, _("Internal error (unknown "
 943                                   "value %i)"), v_short);
 944                         break;
 945                 }
 946
 947                 /* Find a short enough value */
 948                 memset (val, 0, maxlen);
 949                 for (k = 0; list2[i].elem[j].values[k]; k++) {
 950                         size_t l = strlen (_(list2[i].elem[j].values[k]));
 951                         if ((maxlen > l) && (strlen (val) < l))
 952                                 strncpy (val, _(list2[i].elem[j].values[k]), maxlen);
 953                 }
 954                 if (!val[0]) snprintf (val, maxlen, "%i", v_short);
 955
 956                 break;
 957         case EXIF_TAG_PLANAR_CONFIGURATION:
 958         case EXIF_TAG_SENSING_METHOD:
 959         case EXIF_TAG_ORIENTATION:
 960         case EXIF_TAG_YCBCR_POSITIONING:
 961         case EXIF_TAG_PHOTOMETRIC_INTERPRETATION:
 962         case EXIF_TAG_CUSTOM_RENDERED:
 963         case EXIF_TAG_EXPOSURE_MODE:
 964         case EXIF_TAG_WHITE_BALANCE:
 965         case EXIF_TAG_SCENE_CAPTURE_TYPE:
 966         case EXIF_TAG_GAIN_CONTROL:
 967         case EXIF_TAG_SATURATION:
 968         case EXIF_TAG_CONTRAST:
 969         case EXIF_TAG_SHARPNESS:
 970                 CF (e, EXIF_FORMAT_SHORT, val, maxlen);
 971                 CC (e, 1, val, maxlen);
 972                 v_short = exif_get_short (e->data, o);
 973
 974                 /* Search the tag */
 975                 for (i = 0; list[i].tag && (list[i].tag != e->tag); i++);
 976                 if (!list[i].tag) {
 977                         snprintf (val, maxlen, _("Internal error (unknown "
 978                                   "value %i)"), v_short);
 979                         break;
 980                 }
 981
 982                 /* Find the value */
 983                 for (j = 0; list[i].strings[j] && (j < v_short); j++);
 984                 if (!list[i].strings[j])
 985                         snprintf (val, maxlen, "%i", v_short);
 986                 else if (!*list[i].strings[j])
 987                         val[0] = 0;
 988                 else
 989                         strncpy (val, _(list[i].strings[j]), maxlen);
 990                 break;
 991         case EXIF_TAG_XP_TITLE:
 992         case EXIF_TAG_XP_COMMENT:
 993         case EXIF_TAG_XP_AUTHOR:
 994         case EXIF_TAG_XP_KEYWORDS:
 995         case EXIF_TAG_XP_SUBJECT:
 996                 /* Warning! The texts are converted from UTF16 to UTF8 */
 997                 /* FIXME: use iconv to convert into the locale encoding */
 998                 exif_convert_utf16_to_utf8(val, (unsigned short*)e->data, MIN(maxlen, e->size));
 999                 break;
1000         case EXIF_TAG_INTEROPERABILITY_VERSION:
1001                 if (e->format == EXIF_FORMAT_UNDEFINED) {
1002                         strncpy (val, (char *) e->data, MIN (maxlen, e->size));
1003                         break;
1004                 }
1005                 /* Fall through - EXIF_TAG_GPS_LATITUDE is same as INTEROPERABILITY_VERSION */
1006         default:
1007                 if (!e->size) break;
1008                 switch (e->format) {
1009                 case EXIF_FORMAT_UNDEFINED:
1010                         if ((e->tag == EXIF_TAG_SCENE_TYPE) && (e->size == 1)) {
1011                                 snprintf (val, maxlen, "%i", e->data[0]);
1012                         } else {
1013                                 snprintf (val, maxlen, _("%i bytes undefined data"),
1014                                           e->size);
1015                         }
1016                         break;
1017                 case EXIF_FORMAT_BYTE:
1018                 case EXIF_FORMAT_SBYTE:
1019                         v_byte = e->data[0];
1020                         snprintf (val, maxlen, "0x%02x", v_byte);
1021                         maxlen -= strlen (val);
1022                         for (i = 1; i < e->components; i++) {
1023                                 v_byte = e->data[i];
1024                                 snprintf (b, sizeof (b), ", 0x%02x", v_byte);
1025                                 strncat (val, b, maxlen);
1026                                 maxlen -= strlen (b);
1027                                 if ((signed)maxlen <= 0) break;
1028                         }
1029                         break;
1030                 case EXIF_FORMAT_SHORT:
1031                 case EXIF_FORMAT_SSHORT:
1032                         v_short = exif_get_short (e->data, o);
1033                         snprintf (val, maxlen, "%i", v_short);
1034                         maxlen -= strlen (val);
1035                         for (i = 1; i < e->components; i++) {
1036                                 v_short = exif_get_short (e->data +
1037                                         exif_format_get_size (e->format) *
1038                                         i, o);
1039                                 snprintf (b, sizeof (b), ", %i", v_short);
1040                                 strncat (val, b, maxlen);
1041                                 maxlen -= strlen (b);
1042                                 if ((signed)maxlen <= 0) break;
1043                         }
1044                         break;
1045                 case EXIF_FORMAT_LONG:
1046                         v_long = exif_get_long (e->data, o);
1047                         snprintf (val, maxlen, "%li", (long int) v_long);
1048                         maxlen -= strlen (val);
1049                         for (i = 1; i < e->components; i++) {
1050                                 v_long = exif_get_long (e->data +
1051                                         exif_format_get_size (e->format) *
1052                                         i, o);
1053                                 snprintf (b, sizeof (b), ", %li",
1054                                         (long int) v_long);
1055                                 strncat (val, b, maxlen);
1056                                 maxlen -= strlen (b);
1057                                 if ((signed)maxlen <= 0) break;
1058                         }
1059                         break;
1060                 case EXIF_FORMAT_SLONG:
1061                         v_slong = exif_get_slong (e->data, o);
1062                         snprintf (val, maxlen, "%li", (long int) v_slong);
1063                         maxlen -= strlen (val);
1064                         for (i = 1; i < e->components; i++) {
1065                                 v_long = exif_get_slong (e->data +
1066                                         exif_format_get_size (e->format) *
1067                                         i, o);
1068                                 snprintf (b, sizeof (b), ", %li",
1069                                                 (long int) v_long);
1070                                 strncat (val, b, maxlen);
1071                                 maxlen -= strlen (b);
1072                                 if ((signed)maxlen <= 0) break;
1073                         }
1074                         break;
1075                 case EXIF_FORMAT_ASCII:
1076                         strncpy (val, (char *) e->data, MIN (maxlen, e->size));
1077                         break;
1078                 case EXIF_FORMAT_RATIONAL:
1079                         v_rat = exif_get_rational (e->data, o);
1080                         if (v_rat.denominator)
1081                                 snprintf (val, maxlen, "%2.2lf",
1082                                           (double) v_rat.numerator /
1083                                           (double) v_rat.denominator);
1084                         else
1085                                 snprintf (val, maxlen, "%2.2lf/%2.2lf",
1086                                           (double) v_rat.numerator,
1087                                           (double) v_rat.denominator);
1088                         maxlen -= strlen (val);
1089                         for (i = 1; i < e->components; i++) {
1090                                 v_rat = exif_get_rational (
1091                                         e->data + 8 * i, o);
1092                                 if (v_rat.denominator)
1093                                         snprintf (b, sizeof (b), ", %2.2lf",
1094                                                   (double) v_rat.numerator /
1095                                                   (double) v_rat.denominator);
1096                                 else
1097                                         snprintf (b, sizeof (b), ", %2.2lf/%2.2lf",
1098                                                   (double) v_rat.numerator,
1099                                                   (double) v_rat.denominator);
1100                                 strncat (val, b, maxlen);
1101                                 maxlen -= strlen (b);
1102                                 if ((signed) maxlen <= 0) break;
1103                         }
1104                         break;
1105                 case EXIF_FORMAT_SRATIONAL:
1106                         v_srat = exif_get_srational (e->data, o);
1107                         if (v_srat.denominator) {
1108                                 snprintf (val, maxlen, "%2.2f", (double)v_srat.numerator / v_srat.denominator);
1109                         } else {
1110                                 snprintf (val, maxlen, "%i/%i", v_srat.numerator,  v_srat.denominator);
1111                         }
1112                         maxlen -= strlen (val);
1113                         for (i = 1; i < e->components; i++) {
1114                                 v_srat = exif_get_srational (
1115                                         e->data + 8 * i, o);
1116                                 snprintf (b, sizeof (b), ", %2.2f",
1117                                           (double)v_srat.numerator / v_srat.denominator);
1118                                 strncat (val, b, maxlen);
1119                                 maxlen -= strlen (b);
1120                                 if ((signed) maxlen <= 0) break;
1121                         }
1122                         break;
1123                 case EXIF_FORMAT_DOUBLE:
1124                 case EXIF_FORMAT_FLOAT:
1125                 default:
1126                         /* What to do here? */
1127                         break;
1128                 }
1129         }
1130
1131         return val;
1132 }
1133
1134
1135 /*!
1136  * \bug Log and report failed exif_mem_malloc() calls.
1137  */
1138 void
1139 exif_entry_initialize (ExifEntry *e, ExifTag tag)
1140 {
1141         ExifRational r;
1142         ExifByteOrder o;
1143
1144         /* We need the byte order */
1145         if (!e || !e->parent || e->data || !e->parent->parent)
1146                 return;
1147         o = exif_data_get_byte_order (e->parent->parent);
1148
1149         e->tag = tag;
1150         switch (tag) {
1151
1152         /* LONG, 1 component, no default */
1153         case EXIF_TAG_PIXEL_X_DIMENSION:
1154         case EXIF_TAG_PIXEL_Y_DIMENSION:
1155         case EXIF_TAG_EXIF_IFD_POINTER:
1156         case EXIF_TAG_GPS_INFO_IFD_POINTER:
1157         case EXIF_TAG_INTEROPERABILITY_IFD_POINTER:
1158         case EXIF_TAG_JPEG_INTERCHANGE_FORMAT_LENGTH:
1159         case EXIF_TAG_JPEG_INTERCHANGE_FORMAT:
1160                 e->components = 1;
1161                 e->format = EXIF_FORMAT_LONG;
1162                 e->size = exif_format_get_size (e->format) * e->components;
1163                 e->data = exif_entry_alloc (e, e->size);
1164                 if (!e->data) break;
1165                 break;
1166
1167         /* SHORT, 1 component, no default */
1168         case EXIF_TAG_SUBJECT_LOCATION:
1169         case EXIF_TAG_SENSING_METHOD:
1170         case EXIF_TAG_PHOTOMETRIC_INTERPRETATION:
1171         case EXIF_TAG_COMPRESSION:
1172         case EXIF_TAG_EXPOSURE_MODE:
1173         case EXIF_TAG_WHITE_BALANCE:
1174         case EXIF_TAG_FOCAL_LENGTH_IN_35MM_FILM:
1175         case EXIF_TAG_GAIN_CONTROL:
1176         case EXIF_TAG_SUBJECT_DISTANCE_RANGE:
1177         case EXIF_TAG_FLASH:
1178
1179         /* SHORT, 1 component, default 0 */
1180         case EXIF_TAG_IMAGE_WIDTH:
1181         case EXIF_TAG_IMAGE_LENGTH:
1182         case EXIF_TAG_EXPOSURE_PROGRAM:
1183         case EXIF_TAG_LIGHT_SOURCE:
1184         case EXIF_TAG_METERING_MODE:
1185         case EXIF_TAG_CUSTOM_RENDERED:
1186         case EXIF_TAG_SCENE_CAPTURE_TYPE:
1187         case EXIF_TAG_CONTRAST:
1188         case EXIF_TAG_SATURATION:
1189         case EXIF_TAG_SHARPNESS:
1190                 e->components = 1;
1191                 e->format = EXIF_FORMAT_SHORT;
1192                 e->size = exif_format_get_size (e->format) * e->components;
1193                 e->data = exif_entry_alloc (e, e->size);
1194                 if (!e->data) break;
1195                 exif_set_short (e->data, o, 0);
1196                 break;
1197
1198         /* SHORT, 1 component, default 1 */
1199     case EXIF_TAG_ORIENTATION:
1200     case EXIF_TAG_PLANAR_CONFIGURATION:
1201     case EXIF_TAG_YCBCR_POSITIONING:
1202                 e->components = 1;
1203                 e->format = EXIF_FORMAT_SHORT;
1204                 e->size = exif_format_get_size (e->format) * e->components;
1205                 e->data = exif_entry_alloc (e, e->size);
1206                 if (!e->data) break;
1207                 exif_set_short (e->data, o, 1);
1208                 break;
1209
1210         /* SHORT, 1 component, default 2 */
1211     case EXIF_TAG_RESOLUTION_UNIT:
1212         case EXIF_TAG_FOCAL_PLANE_RESOLUTION_UNIT:
1213                 e->components = 1;
1214                 e->format = EXIF_FORMAT_SHORT;
1215                 e->size = exif_format_get_size (e->format) * e->components;
1216                 e->data = exif_entry_alloc (e, e->size);
1217                 if (!e->data) break;
1218                 exif_set_short (e->data, o, 2);
1219                 break;
1220
1221         /* SHORT, 1 component, default 3 */
1222     case EXIF_TAG_SAMPLES_PER_PIXEL:
1223                 e->components = 1;
1224                 e->format = EXIF_FORMAT_SHORT;
1225                 e->size = exif_format_get_size (e->format) * e->components;
1226                 e->data = exif_entry_alloc (e, e->size);
1227                 if (!e->data) break;
1228                 exif_set_short (e->data, o, 3);
1229                 break;
1230
1231         case EXIF_TAG_COLOR_SPACE:
1232         /* SHORT, 1 component, default 0xffff */
1233                 e->components = 1;
1234                 e->format = EXIF_FORMAT_SHORT;
1235                 e->size = exif_format_get_size (e->format) * e->components;
1236                 e->data = exif_entry_alloc (e, e->size);
1237                 if (!e->data) break;
1238                 exif_set_short (e->data, o, 0xffff);
1239                 break;
1240
1241
1242         case EXIF_TAG_BITS_PER_SAMPLE:
1243                 e->components = 3;
1244                 e->format = EXIF_FORMAT_SHORT;
1245                 e->size = exif_format_get_size (e->format) * e->components;
1246                 e->data = exif_entry_alloc (e, e->size);
1247                 if (!e->data) break;
1248                 exif_set_short (e->data, o, 8);
1249                 exif_set_short (
1250                         e->data + exif_format_get_size (e->format),
1251                         o, 8);
1252                 exif_set_short (
1253                         e->data + 2 * exif_format_get_size (e->format),
1254                         o, 8);
1255                 break;
1256         case EXIF_TAG_YCBCR_SUB_SAMPLING:
1257                 e->components = 2;
1258                 e->format = EXIF_FORMAT_SHORT;
1259                 e->size = exif_format_get_size (e->format) * e->components;
1260                 e->data = exif_entry_alloc (e, e->size);
1261                 if (!e->data) break;
1262                 exif_set_short (e->data, o, 2);
1263                 exif_set_short (
1264                         e->data + exif_format_get_size (e->format),
1265                         o, 1);
1266                 break;
1267
1268         /* SRATIONAL, 1 component, no default */
1269         case EXIF_TAG_EXPOSURE_BIAS_VALUE:
1270         case EXIF_TAG_BRIGHTNESS_VALUE:
1271         case EXIF_TAG_SHUTTER_SPEED_VALUE:
1272                 e->components = 1;
1273                 e->format = EXIF_FORMAT_SRATIONAL;
1274                 e->size = exif_format_get_size (e->format) * e->components;
1275                 e->data = exif_entry_alloc (e, e->size);
1276                 if (!e->data) break;
1277                 break;
1278
1279         /* RATIONAL, 1 component, no default */
1280         case EXIF_TAG_EXPOSURE_TIME:
1281         case EXIF_TAG_FOCAL_PLANE_X_RESOLUTION:
1282         case EXIF_TAG_FOCAL_PLANE_Y_RESOLUTION:
1283         case EXIF_TAG_EXPOSURE_INDEX:
1284         case EXIF_TAG_FLASH_ENERGY:
1285         case EXIF_TAG_FNUMBER:
1286         case EXIF_TAG_FOCAL_LENGTH:
1287         case EXIF_TAG_SUBJECT_DISTANCE:
1288         case EXIF_TAG_MAX_APERTURE_VALUE:
1289         case EXIF_TAG_APERTURE_VALUE:
1290         case EXIF_TAG_COMPRESSED_BITS_PER_PIXEL:
1291         case EXIF_TAG_PRIMARY_CHROMATICITIES:
1292         case EXIF_TAG_DIGITAL_ZOOM_RATIO:
1293                 e->components = 1;
1294                 e->format = EXIF_FORMAT_RATIONAL;
1295                 e->size = exif_format_get_size (e->format) * e->components;
1296                 e->data = exif_entry_alloc (e, e->size);
1297                 if (!e->data) break;
1298                 break;
1299
1300         /* RATIONAL, 1 component, default 72/1 */
1301         case EXIF_TAG_X_RESOLUTION:
1302         case EXIF_TAG_Y_RESOLUTION:
1303                 e->components = 1;
1304                 e->format = EXIF_FORMAT_RATIONAL;
1305                 e->size = exif_format_get_size (e->format) * e->components;
1306                 e->data = exif_entry_alloc (e, e->size);
1307                 if (!e->data) break;
1308                 r.numerator = 72;
1309                 r.denominator = 1;
1310                 exif_set_rational (e->data, o, r);
1311                 break;
1312
1313         /* RATIONAL, 2 components, no default */
1314         case EXIF_TAG_WHITE_POINT:
1315                 e->components = 2;
1316                 e->format = EXIF_FORMAT_RATIONAL;
1317                 e->size = exif_format_get_size (e->format) * e->components;
1318                 e->data = exif_entry_alloc (e, e->size);
1319                 if (!e->data) break;
1320                 break;
1321
1322         /* RATIONAL, 6 components */
1323         case EXIF_TAG_REFERENCE_BLACK_WHITE:
1324                 e->components = 6;
1325                 e->format = EXIF_FORMAT_RATIONAL;
1326                 e->size = exif_format_get_size (e->format) * e->components;
1327                 e->data = exif_entry_alloc (e, e->size);
1328                 if (!e->data) break;
1329                 r.denominator = 1;
1330                 r.numerator = 0;
1331                 exif_set_rational (e->data, o, r);
1332                 r.numerator = 255;
1333                 exif_set_rational (
1334                         e->data + exif_format_get_size (e->format), o, r);
1335                 r.numerator = 0;
1336                 exif_set_rational (
1337                         e->data + 2 * exif_format_get_size (e->format), o, r);
1338                 r.numerator = 255;
1339                 exif_set_rational (
1340                         e->data + 3 * exif_format_get_size (e->format), o, r);
1341                 r.numerator = 0;
1342                 exif_set_rational (
1343                         e->data + 4 * exif_format_get_size (e->format), o, r);
1344                 r.numerator = 255;
1345                 exif_set_rational (
1346                         e->data + 5 * exif_format_get_size (e->format), o, r);
1347                 break;
1348
1349         /* ASCII, 20 components */
1350         case EXIF_TAG_DATE_TIME:
1351         case EXIF_TAG_DATE_TIME_ORIGINAL:
1352         case EXIF_TAG_DATE_TIME_DIGITIZED:
1353         {
1354                 time_t t;
1355 #ifdef HAVE_LOCALTIME_R
1356                 struct tm tms;
1357 #endif
1358                 struct tm *tm;
1359
1360                 t = time (NULL);
1361 #ifdef HAVE_LOCALTIME_R
1362                 tm = localtime_r (&t, &tms);
1363 #else
1364                 tm = localtime (&t);
1365 #endif
1366                 e->components = 20;
1367                 e->format = EXIF_FORMAT_ASCII;
1368                 e->size = exif_format_get_size (e->format) * e->components;
1369                 e->data = exif_entry_alloc (e, e->size);
1370                 if (!e->data) break;
1371                 snprintf ((char *) e->data, e->size,
1372                           "%04i:%02i:%02i %02i:%02i:%02i",
1373                           tm->tm_year + 1900, tm->tm_mon + 1, tm->tm_mday,
1374                           tm->tm_hour, tm->tm_min, tm->tm_sec);
1375                 break;
1376         }
1377
1378         /* ASCII, no default */
1379         case EXIF_TAG_SUB_SEC_TIME:
1380         case EXIF_TAG_SUB_SEC_TIME_ORIGINAL:
1381         case EXIF_TAG_SUB_SEC_TIME_DIGITIZED:
1382                 e->components = 0;
1383                 e->format = EXIF_FORMAT_ASCII;
1384                 e->size = 0;
1385                 e->data = NULL;
1386                 break;
1387         case EXIF_TAG_IMAGE_DESCRIPTION:
1388         case EXIF_TAG_MAKE:
1389         case EXIF_TAG_MODEL:
1390         case EXIF_TAG_SOFTWARE:
1391         case EXIF_TAG_ARTIST:
1392                 e->components = strlen (_("[None]")) + 1;
1393                 e->format = EXIF_FORMAT_ASCII;
1394                 e->size = exif_format_get_size (e->format) * e->components;
1395                 e->data = exif_entry_alloc (e, e->size);
1396                 if (!e->data) break;
1397                 strncpy ((char *)e->data, _("[None]"), e->size);
1398                 break;
1399         case EXIF_TAG_COPYRIGHT:
1400                 e->components = (strlen (_("[None]")) + 1) * 2;
1401                 e->format = EXIF_FORMAT_ASCII;
1402                 e->size = exif_format_get_size (e->format) * e->components;
1403                 e->data = exif_entry_alloc (e, e->size);
1404                 if (!e->data) break;
1405                 strcpy (((char *)e->data) + 0, _("[None]"));
1406                 strcpy (((char *)e->data) + strlen (_("[None]")) + 1, _("[None]"));
1407                 break;
1408
1409         /* UNDEFINED, no components, no default */
1410         /* Use this if the tag is otherwise unsupported */
1411         case EXIF_TAG_MAKER_NOTE:
1412         case EXIF_TAG_USER_COMMENT:
1413         default:
1414                 e->components = 0;
1415                 e->format = EXIF_FORMAT_UNDEFINED;
1416                 e->size = 0;
1417                 e->data = NULL;
1418                 break;
1419
1420         /* UNDEFINED, 1 component, default 1 */
1421         case EXIF_TAG_SCENE_TYPE:
1422                 e->components = 1;
1423                 e->format = EXIF_FORMAT_UNDEFINED;
1424                 e->size = exif_format_get_size (e->format) * e->components;
1425                 e->data = exif_entry_alloc (e, e->size);
1426                 if (!e->data) break;
1427                 e->data[0] = 0x01;
1428                 break;
1429
1430         /* UNDEFINED, 1 component, default 3 */
1431         case EXIF_TAG_FILE_SOURCE:
1432                 e->components = 1;
1433                 e->format = EXIF_FORMAT_UNDEFINED;
1434                 e->size = exif_format_get_size (e->format) * e->components;
1435                 e->data = exif_entry_alloc (e, e->size);
1436                 if (!e->data) break;
1437                 e->data[0] = 0x03;
1438                 break;
1439
1440         /* UNDEFINED, 4 components, default 0 1 0 0 */
1441         case EXIF_TAG_FLASH_PIX_VERSION:
1442                 e->components = 4;
1443                 e->format = EXIF_FORMAT_UNDEFINED;
1444                 e->size = exif_format_get_size (e->format) * e->components;
1445                 e->data = exif_entry_alloc (e, e->size);
1446                 if (!e->data) break;
1447                 memcpy (e->data, "0100", 4);
1448                 break;
1449
1450         /* UNDEFINED, 4 components, default 0 2 1 0 */
1451         case EXIF_TAG_EXIF_VERSION:
1452                 e->components = 4;
1453                 e->format = EXIF_FORMAT_UNDEFINED;
1454                 e->size = exif_format_get_size (e->format) * e->components;
1455                 e->data = exif_entry_alloc (e, e->size);
1456                 if (!e->data) break;
1457                 memcpy (e->data, "0210", 4);
1458                 break;
1459         }
1460 }