test/test-value.c

   1 /* test-value.c
   2  *
   3  * Creates all the types of tags supported in exif_entry_initialize() and
   4  * ensures that exif_entry_get_value() properly truncates the output of each
   5  * one according to the buffer size available.
   6  *
   7  * Copyright 2002 Lutz Mueller <lutz@users.sourceforge.net>
   8  *
   9  * This library is free software; you can redistribute it and/or
  10  * modify it under the terms of the GNU Lesser General Public
  11  * License as published by the Free Software Foundation; either
  12  * version 2 of the License, or (at your option) any later version.
  13  *
  14  * This library is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  17  * Lesser General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU Lesser General Public
  20  * License along with this library; if not, write to the
  21  * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  22  * Boston, MA  02110-1301  USA.
  23  */
  24
  25 #include <libexif/exif-utils.h>
  26 #include <libexif/exif-data.h>
  27
  28 #include <stdio.h>
  29 #include <stdlib.h>
  30 #include <string.h>
  31
  32 /*
  33  * List of tags to test, one per default initialized type.
  34  * There should be one for every block in exif_entry_initialize() and
  35  * exif_entry_get_value().
  36  */
  37 ExifTag trunc_test_tags[] = {
  38         EXIF_TAG_PIXEL_X_DIMENSION,
  39         EXIF_TAG_SUBJECT_LOCATION,
  40         EXIF_TAG_IMAGE_WIDTH,
  41         EXIF_TAG_ORIENTATION,
  42         EXIF_TAG_SAMPLES_PER_PIXEL,
  43         EXIF_TAG_BITS_PER_SAMPLE,
  44         EXIF_TAG_X_RESOLUTION,
  45         EXIF_TAG_WHITE_POINT,
  46         EXIF_TAG_REFERENCE_BLACK_WHITE,
  47         EXIF_TAG_DATE_TIME,
  48         EXIF_TAG_IMAGE_DESCRIPTION,
  49         EXIF_TAG_EXIF_VERSION,
  50         EXIF_TAG_FLASH_PIX_VERSION,
  51         EXIF_TAG_COPYRIGHT,
  52         EXIF_TAG_FILE_SOURCE,
  53         EXIF_TAG_COMPONENTS_CONFIGURATION,
  54         EXIF_TAG_SCENE_TYPE,
  55         EXIF_TAG_YCBCR_SUB_SAMPLING,
  56         EXIF_TAG_PLANAR_CONFIGURATION,
  57 };
  58
  59 /*
  60  * These tags produce different outputs depending on the amount of buffer space
  61  * available.
  62  */
  63 ExifTag nonuniform_test_tags[] = {
  64         EXIF_TAG_RESOLUTION_UNIT,
  65         EXIF_TAG_COLOR_SPACE,
  66         EXIF_TAG_METERING_MODE,
  67 };
  68
  69 /*
  70  * These tags need a nonzero rational number to be interesting.
  71  * They must have space for a rational or srational created automatically by
  72  * exif_entry_initialize().
  73  */
  74 ExifTag rational_test_tags[] = {
  75         EXIF_TAG_FNUMBER,
  76         EXIF_TAG_APERTURE_VALUE,
  77         EXIF_TAG_MAX_APERTURE_VALUE,
  78         EXIF_TAG_FOCAL_LENGTH,
  79         EXIF_TAG_SUBJECT_DISTANCE,
  80         EXIF_TAG_EXPOSURE_TIME,
  81         EXIF_TAG_SHUTTER_SPEED_VALUE,
  82         EXIF_TAG_BRIGHTNESS_VALUE,
  83         EXIF_TAG_EXPOSURE_BIAS_VALUE,
  84 };
  85
  86 /*
  87  * Verify that the entry is properly truncated to the buffer length within
  88  * exif_entry_get_value().  If uniform is zero, then only check that the
  89  * resulting string fits within the buffer and don't check its content.
  90  */
  91 static void check_entry_trunc(ExifEntry *e, int uniform)
  92 {
  93         unsigned int i;
  94         char v[1024], full[1024];  /* Large enough to never truncate output */
  95
  96         printf ("Tag 0x%x\n", (int) e->tag);
  97
  98         /* Get the full, untruncated string to use as the expected value */
  99         exif_entry_get_value (e, full, sizeof(full));
 100         printf ("Full: '%s'\n", full);
 101
 102         for (i = strlen(full); i > 0; i--) {
 103                 /* Make sure the buffer isn't NUL-terminated to begin with */
 104                 memset(v, '*', sizeof(v));
 105                 exif_entry_get_value (e, v, i);
 106                 /* Truncate the full string by one on each iteration */
 107                 full[i-1] = '\0';
 108                 if ((strlen(v) >= i) || (uniform && strcmp(full, v))) {
 109                         printf("Bad truncation!\n");
 110                         printf("Length %2i: '%s'\n", i, v);
 111                         exit(1);
 112                 }
 113         }
 114 }
 115
 116 int
 117 main ()
 118 {
 119         ExifData *data;
 120         ExifEntry *e;
 121         ExifMem *mem;
 122         unsigned i;
 123         static const ExifSRational r = {1., 20.};  /* a nonzero number */
 124         static const char user_comment[] = "ASCII\0\0\0A Long User Comment";
 125         static const char xp_comment[] = "U\0C\0S\0-\0002\0 \0C\0o\0m\0m\0e\0n\0t\0";
 126         static const char interop[] = "R98";
 127         static const char subsec[] = "130 ";
 128         static const ExifRational gpsh = {12., 1.};
 129         static const ExifRational gpsm = {34., 1.};
 130         static const ExifRational gpss = {56780., 1000.};
 131
 132         data = exif_data_new ();
 133         if (!data) {
 134                 printf ("Error running exif_data_new()\n");
 135                 exit(13);
 136         }
 137
 138         /* Full initialization/truncation tests */
 139         for (i=0; i < sizeof(trunc_test_tags)/sizeof(trunc_test_tags[0]); ++i) {
 140                 e = exif_entry_new ();
 141                 if (!e) {
 142                         printf ("Error running exif_entry_new()\n");
 143                         exit(13);
 144                 }
 145                 exif_content_add_entry (data->ifd[EXIF_IFD_0], e);
 146                 exif_entry_initialize (e, trunc_test_tags[i]);
 147                 check_entry_trunc(e, 1);
 148                 exif_content_remove_entry (data->ifd[EXIF_IFD_0], e);
 149                 exif_entry_unref (e);
 150         }
 151
 152         /* Nonuniform initialization/truncation tests */
 153         for (i=0; i < sizeof(nonuniform_test_tags)/sizeof(nonuniform_test_tags[0]);
 154                  ++i) {
 155                 e = exif_entry_new ();
 156                 if (!e) {
 157                         printf ("Error running exif_entry_new()\n");
 158                         exit(13);
 159                 }
 160                 exif_content_add_entry (data->ifd[EXIF_IFD_0], e);
 161                 exif_entry_initialize (e, nonuniform_test_tags[i]);
 162                 check_entry_trunc(e, 0);
 163                 exif_content_remove_entry (data->ifd[EXIF_IFD_0], e);
 164                 exif_entry_unref (e);
 165         }
 166
 167         /* Rational number initialization/truncation tests */
 168         for (i=0; i < sizeof(rational_test_tags)/sizeof(rational_test_tags[0]);
 169                  ++i) {
 170                 e = exif_entry_new ();
 171                 if (!e) {
 172                         printf ("Error running exif_entry_new()\n");
 173                         exit(13);
 174                 }
 175                 exif_content_add_entry (data->ifd[EXIF_IFD_0], e);
 176                 exif_entry_initialize (e, rational_test_tags[i]);
 177                 exif_set_srational (e->data, exif_data_get_byte_order (data), r);
 178                 /* In case this tag needs an unsigned rational instead,
 179                  * fix the type automatically */
 180                 exif_entry_fix (e);
 181                 check_entry_trunc(e, 1);
 182                 exif_content_remove_entry (data->ifd[EXIF_IFD_0], e);
 183                 exif_entry_unref (e);
 184         }
 185
 186         /* Create a memory allocator to manage the remaining ExifEntry structs */
 187         mem = exif_mem_new_default();
 188         if (!mem) {
 189                 printf ("Out of memory\n");
 190                 exit(13);
 191         }
 192
 193         /* EXIF_TAG_SUB_SEC_TIME initialization/truncation tests */
 194         e = exif_entry_new_mem (mem);
 195         if (!e) {
 196                 printf ("Out of memory\n");
 197                 exit(13);
 198         }
 199         exif_content_add_entry (data->ifd[EXIF_IFD_0], e);
 200         exif_entry_initialize (e, EXIF_TAG_SUB_SEC_TIME);
 201         e->size = sizeof(subsec);  /* include NUL */
 202         e->components = e->size;
 203         /* Allocate memory to use for holding the tag data */
 204         e->data = exif_mem_alloc(mem, e->size);
 205         if (!e->data) {
 206                 printf ("Out of memory\n");
 207                 exit(13);
 208         }
 209         memcpy(e->data, subsec, e->size);
 210         check_entry_trunc(e, 1);
 211         exif_content_remove_entry (data->ifd[EXIF_IFD_0], e);
 212         exif_entry_unref (e);
 213
 214         /* EXIF_TAG_USER_COMMENT initialization/truncation tests */
 215         e = exif_entry_new_mem (mem);
 216         if (!e) {
 217                 printf ("Out of memory\n");
 218                 exit(13);
 219         }
 220         exif_content_add_entry (data->ifd[EXIF_IFD_0], e);
 221         exif_entry_initialize (e, EXIF_TAG_USER_COMMENT);
 222         e->size = sizeof(user_comment) - 1;
 223         e->components = e->size;
 224         /* Allocate memory to use for holding the tag data */
 225         e->data = exif_mem_alloc(mem, e->size);
 226         if (!e->data) {
 227                 printf ("Out of memory\n");
 228                 exit(13);
 229         }
 230         memcpy(e->data, user_comment, e->size);
 231         check_entry_trunc(e, 1);
 232         exif_content_remove_entry (data->ifd[EXIF_IFD_0], e);
 233         exif_entry_unref (e);
 234
 235         /* EXIF_TAG_XP_COMMENT truncation tests */
 236         e = exif_entry_new_mem (mem);
 237         if (!e) {
 238                 printf ("Out of memory\n");
 239                 exit(13);
 240         }
 241         exif_content_add_entry (data->ifd[EXIF_IFD_0], e);
 242         exif_entry_initialize (e, EXIF_TAG_XP_COMMENT);
 243         e->format = EXIF_FORMAT_BYTE;
 244         e->size = sizeof(xp_comment) - 1;
 245         e->components = e->size;
 246         /* Allocate memory to use for holding the tag data */
 247         e->data = exif_mem_alloc(mem, e->size);
 248         if (!e->data) {
 249                 printf ("Out of memory\n");
 250                 exit(13);
 251         }
 252         memcpy(e->data, xp_comment, e->size);
 253         check_entry_trunc(e, 1);
 254         exif_content_remove_entry (data->ifd[EXIF_IFD_0], e);
 255         exif_entry_unref (e);
 256
 257         /* EXIF_TAG_INTEROPERABILITY_VERSION truncation tests */
 258         e = exif_entry_new_mem (mem);
 259         if (!e) {
 260                 printf ("Out of memory\n");
 261                 exit(13);
 262         }
 263         exif_content_add_entry (data->ifd[EXIF_IFD_INTEROPERABILITY], e);
 264         exif_entry_initialize (e, EXIF_TAG_INTEROPERABILITY_VERSION);
 265         e->format = EXIF_FORMAT_UNDEFINED;  /* The spec says ASCII, but libexif
 266                                                allows UNDEFINED */
 267         e->size = sizeof(interop);  /* include NUL */
 268         e->components = e->size;
 269         /* Allocate memory to use for holding the tag data */
 270         e->data = exif_mem_alloc(mem, e->size);
 271         if (!e->data) {
 272                 printf ("Out of memory\n");
 273                 exit(13);
 274         }
 275         memcpy(e->data, interop, e->size);
 276         check_entry_trunc(e, 1);
 277         exif_content_remove_entry (data->ifd[EXIF_IFD_INTEROPERABILITY], e);
 278         exif_entry_unref (e);
 279
 280         /* EXIF_TAG_GPS_VERSION_ID truncation tests */
 281         e = exif_entry_new_mem (mem);
 282         if (!e) {
 283                 printf ("Out of memory\n");
 284                 exit(13);
 285         }
 286         exif_content_add_entry (data->ifd[EXIF_IFD_GPS], e);
 287         exif_entry_initialize (e, EXIF_TAG_GPS_VERSION_ID);
 288         e->format = EXIF_FORMAT_BYTE;
 289         e->size = 4;
 290         e->components = e->size;
 291         /* Allocate memory to use for holding the tag data */
 292         e->data = exif_mem_alloc(mem, e->size);
 293         if (!e->data) {
 294                 printf ("Out of memory\n");
 295                 exit(13);
 296         }
 297         e->data[0] = 2;
 298         e->data[1] = 2;
 299         e->data[2] = 0;
 300         e->data[3] = 0;
 301         check_entry_trunc(e, 1);
 302         exif_content_remove_entry (data->ifd[EXIF_IFD_GPS], e);
 303         exif_entry_unref (e);
 304
 305         /* EXIF_TAG_GPS_ALTITUDE_REF truncation tests */
 306         e = exif_entry_new_mem (mem);
 307         if (!e) {
 308                 printf ("Out of memory\n");
 309                 exit(13);
 310         }
 311         exif_content_add_entry (data->ifd[EXIF_IFD_GPS], e);
 312         exif_entry_initialize (e, EXIF_TAG_GPS_ALTITUDE_REF);
 313         e->format = EXIF_FORMAT_BYTE;
 314         e->size = 1;
 315         e->components = e->size;
 316         /* Allocate memory to use for holding the tag data */
 317         e->data = exif_mem_alloc(mem, e->size);
 318         if (!e->data) {
 319                 printf ("Out of memory\n");
 320                 exit(13);
 321         }
 322         e->data[0] = 1;
 323         check_entry_trunc(e, 1);
 324         exif_content_remove_entry (data->ifd[EXIF_IFD_GPS], e);
 325         exif_entry_unref (e);
 326
 327         /* EXIF_TAG_GPS_TIME_STAMP truncation tests */
 328         e = exif_entry_new_mem (mem);
 329         if (!e) {
 330                 printf ("Out of memory\n");
 331                 exit(13);
 332         }
 333         exif_content_add_entry (data->ifd[EXIF_IFD_GPS], e);
 334         exif_entry_initialize (e, EXIF_TAG_GPS_TIME_STAMP);
 335         e->format = EXIF_FORMAT_RATIONAL;
 336         e->components = 3;
 337         e->size = e->components * exif_format_get_size(EXIF_FORMAT_RATIONAL);
 338         /* Allocate memory to use for holding the tag data */
 339         e->data = exif_mem_alloc(mem, e->size);
 340         if (!e->data) {
 341                 printf ("Out of memory\n");
 342                 exit(13);
 343         }
 344         exif_set_rational(e->data, exif_data_get_byte_order (data), gpsh);
 345         exif_set_rational(e->data+8, exif_data_get_byte_order (data), gpsm);
 346         exif_set_rational(e->data+16, exif_data_get_byte_order (data), gpss);
 347         check_entry_trunc(e, 1);
 348         exif_content_remove_entry (data->ifd[EXIF_IFD_GPS], e);
 349         exif_entry_unref (e);
 350
 351         /* EXIF_TAG_SUBJECT_AREA truncation tests */
 352         e = exif_entry_new_mem (mem);
 353         if (!e) {
 354                 printf ("Out of memory\n");
 355                 exit(13);
 356         }
 357         exif_content_add_entry (data->ifd[EXIF_IFD_0], e);
 358         exif_entry_initialize (e, EXIF_TAG_SUBJECT_AREA);
 359         e->format = EXIF_FORMAT_SHORT;
 360         /* This tags is interpreted differently depending on # components */
 361         /* Rectangle */
 362         e->components = 4;
 363         e->size = e->components * exif_format_get_size(EXIF_FORMAT_SHORT);
 364         /* Allocate memory to use for holding the tag data */
 365         e->data = exif_mem_alloc(mem, e->size);
 366         if (!e->data) {
 367                 printf ("Out of memory\n");
 368                 exit(13);
 369         }
 370         exif_set_short(e->data, exif_data_get_byte_order (data), 123);
 371         exif_set_short(e->data+2, exif_data_get_byte_order (data), 456);
 372         exif_set_short(e->data+4, exif_data_get_byte_order (data), 78);
 373         exif_set_short(e->data+6, exif_data_get_byte_order (data), 90);
 374         check_entry_trunc(e, 1);
 375         /* Circle */
 376         e->components = 3;
 377         e->size = e->components * exif_format_get_size(EXIF_FORMAT_SHORT);
 378         check_entry_trunc(e, 1);
 379         /* Centre */
 380         e->components = 2;
 381         e->size = e->components * exif_format_get_size(EXIF_FORMAT_SHORT);
 382         check_entry_trunc(e, 1);
 383         /* Invalid */
 384         e->components = 1;
 385         e->size = e->components * exif_format_get_size(EXIF_FORMAT_SHORT);
 386         check_entry_trunc(e, 1);
 387         exif_content_remove_entry (data->ifd[EXIF_IFD_0], e);
 388         exif_entry_unref (e);
 389
 390         exif_mem_unref(mem);
 391         exif_data_unref (data);
 392
 393         return 0;
 394 }