source/Irrlicht/libpng/pngerror.c

   1 \r
   2 /* pngerror.c - stub functions for i/o and memory allocation\r
   3  *\r
   4  * Last changed in libpng 1.6.15 [November 20, 2014]\r
   5  * Copyright (c) 1998-2002,2004,2006-2014 Glenn Randers-Pehrson\r
   6  * (Version 0.96 Copyright (c) 1996, 1997 Andreas Dilger)\r
   7  * (Version 0.88 Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.)\r
   8  *\r
   9  * This code is released under the libpng license.\r
  10  * For conditions of distribution and use, see the disclaimer\r
  11  * and license in png.h\r
  12  *\r
  13  * This file provides a location for all error handling.  Users who\r
  14  * need special error handling are expected to write replacement functions\r
  15  * and use png_set_error_fn() to use those functions.  See the instructions\r
  16  * at each function.\r
  17  */\r
  18 \r
  19 #include "pngpriv.h"\r
  20 \r
  21 #if defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED)\r
  22 \r
  23 static PNG_FUNCTION(void, png_default_error,PNGARG((png_const_structrp png_ptr,\r
  24     png_const_charp error_message)),PNG_NORETURN);\r
  25 \r
  26 #ifdef PNG_WARNINGS_SUPPORTED\r
  27 static void /* PRIVATE */\r
  28 png_default_warning PNGARG((png_const_structrp png_ptr,\r
  29    png_const_charp warning_message));\r
  30 #endif /* WARNINGS */\r
  31 \r
  32 /* This function is called whenever there is a fatal error.  This function\r
  33  * should not be changed.  If there is a need to handle errors differently,\r
  34  * you should supply a replacement error function and use png_set_error_fn()\r
  35  * to replace the error function at run-time.\r
  36  */\r
  37 #ifdef PNG_ERROR_TEXT_SUPPORTED\r
  38 PNG_FUNCTION(void,PNGAPI\r
  39 png_error,(png_const_structrp png_ptr, png_const_charp error_message),\r
  40    PNG_NORETURN)\r
  41 {\r
  42 #ifdef PNG_ERROR_NUMBERS_SUPPORTED\r
  43    char msg[16];\r
  44    if (png_ptr != NULL)\r
  45    {\r
  46       if ((png_ptr->flags &\r
  47          (PNG_FLAG_STRIP_ERROR_NUMBERS|PNG_FLAG_STRIP_ERROR_TEXT)) != 0)\r
  48       {\r
  49          if (*error_message == PNG_LITERAL_SHARP)\r
  50          {\r
  51             /* Strip "#nnnn " from beginning of error message. */\r
  52             int offset;\r
  53             for (offset = 1; offset<15; offset++)\r
  54                if (error_message[offset] == ' ')\r
  55                   break;\r
  56 \r
  57             if ((png_ptr->flags & PNG_FLAG_STRIP_ERROR_TEXT) != 0)\r
  58             {\r
  59                int i;\r
  60                for (i = 0; i < offset - 1; i++)\r
  61                   msg[i] = error_message[i + 1];\r
  62                msg[i - 1] = '\0';\r
  63                error_message = msg;\r
  64             }\r
  65 \r
  66             else\r
  67                error_message += offset;\r
  68       }\r
  69 \r
  70       else\r
  71       {\r
  72          if ((png_ptr->flags & PNG_FLAG_STRIP_ERROR_TEXT) != 0)\r
  73          {\r
  74             msg[0] = '0';\r
  75             msg[1] = '\0';\r
  76             error_message = msg;\r
  77          }\r
  78        }\r
  79      }\r
  80    }\r
  81 #endif\r
  82    if (png_ptr != NULL && png_ptr->error_fn != NULL)\r
  83       (*(png_ptr->error_fn))(png_constcast(png_structrp,png_ptr),\r
  84           error_message);\r
  85 \r
  86    /* If the custom handler doesn't exist, or if it returns,\r
  87       use the default handler, which will not return. */\r
  88    png_default_error(png_ptr, error_message);\r
  89 }\r
  90 #else\r
  91 PNG_FUNCTION(void,PNGAPI\r
  92 png_err,(png_const_structrp png_ptr),PNG_NORETURN)\r
  93 {\r
  94    /* Prior to 1.5.2 the error_fn received a NULL pointer, expressed\r
  95     * erroneously as '\0', instead of the empty string "".  This was\r
  96     * apparently an error, introduced in libpng-1.2.20, and png_default_error\r
  97     * will crash in this case.\r
  98     */\r
  99    if (png_ptr != NULL && png_ptr->error_fn != NULL)\r
 100       (*(png_ptr->error_fn))(png_constcast(png_structrp,png_ptr), "");\r
 101 \r
 102    /* If the custom handler doesn't exist, or if it returns,\r
 103       use the default handler, which will not return. */\r
 104    png_default_error(png_ptr, "");\r
 105 }\r
 106 #endif /* ERROR_TEXT */\r
 107 \r
 108 /* Utility to safely appends strings to a buffer.  This never errors out so\r
 109  * error checking is not required in the caller.\r
 110  */\r
 111 size_t\r
 112 png_safecat(png_charp buffer, size_t bufsize, size_t pos,\r
 113    png_const_charp string)\r
 114 {\r
 115    if (buffer != NULL && pos < bufsize)\r
 116    {\r
 117       if (string != NULL)\r
 118          while (*string != '\0' && pos < bufsize-1)\r
 119            buffer[pos++] = *string++;\r
 120 \r
 121       buffer[pos] = '\0';\r
 122    }\r
 123 \r
 124    return pos;\r
 125 }\r
 126 \r
 127 #if defined(PNG_WARNINGS_SUPPORTED) || defined(PNG_TIME_RFC1123_SUPPORTED)\r
 128 /* Utility to dump an unsigned value into a buffer, given a start pointer and\r
 129  * and end pointer (which should point just *beyond* the end of the buffer!)\r
 130  * Returns the pointer to the start of the formatted string.\r
 131  */\r
 132 png_charp\r
 133 png_format_number(png_const_charp start, png_charp end, int format,\r
 134    png_alloc_size_t number)\r
 135 {\r
 136    int count = 0;    /* number of digits output */\r
 137    int mincount = 1; /* minimum number required */\r
 138    int output = 0;   /* digit output (for the fixed point format) */\r
 139 \r
 140    *--end = '\0';\r
 141 \r
 142    /* This is written so that the loop always runs at least once, even with\r
 143     * number zero.\r
 144     */\r
 145    while (end > start && (number != 0 || count < mincount))\r
 146    {\r
 147 \r
 148       static const char digits[] = "0123456789ABCDEF";\r
 149 \r
 150       switch (format)\r
 151       {\r
 152          case PNG_NUMBER_FORMAT_fixed:\r
 153             /* Needs five digits (the fraction) */\r
 154             mincount = 5;\r
 155             if (output != 0 || number % 10 != 0)\r
 156             {\r
 157                *--end = digits[number % 10];\r
 158                output = 1;\r
 159             }\r
 160             number /= 10;\r
 161             break;\r
 162 \r
 163          case PNG_NUMBER_FORMAT_02u:\r
 164             /* Expects at least 2 digits. */\r
 165             mincount = 2;\r
 166             /* FALL THROUGH */\r
 167 \r
 168          case PNG_NUMBER_FORMAT_u:\r
 169             *--end = digits[number % 10];\r
 170             number /= 10;\r
 171             break;\r
 172 \r
 173          case PNG_NUMBER_FORMAT_02x:\r
 174             /* This format expects at least two digits */\r
 175             mincount = 2;\r
 176             /* FALL THROUGH */\r
 177 \r
 178          case PNG_NUMBER_FORMAT_x:\r
 179             *--end = digits[number & 0xf];\r
 180             number >>= 4;\r
 181             break;\r
 182 \r
 183          default: /* an error */\r
 184             number = 0;\r
 185             break;\r
 186       }\r
 187 \r
 188       /* Keep track of the number of digits added */\r
 189       ++count;\r
 190 \r
 191       /* Float a fixed number here: */\r
 192       if ((format == PNG_NUMBER_FORMAT_fixed) && (count == 5) && (end > start))\r
 193       {\r
 194          /* End of the fraction, but maybe nothing was output?  In that case\r
 195           * drop the decimal point.  If the number is a true zero handle that\r
 196           * here.\r
 197           */\r
 198          if (output != 0)\r
 199             *--end = '.';\r
 200          else if (number == 0) /* and !output */\r
 201             *--end = '0';\r
 202       }\r
 203    }\r
 204 \r
 205    return end;\r
 206 }\r
 207 #endif\r
 208 \r
 209 #ifdef PNG_WARNINGS_SUPPORTED\r
 210 /* This function is called whenever there is a non-fatal error.  This function\r
 211  * should not be changed.  If there is a need to handle warnings differently,\r
 212  * you should supply a replacement warning function and use\r
 213  * png_set_error_fn() to replace the warning function at run-time.\r
 214  */\r
 215 void PNGAPI\r
 216 png_warning(png_const_structrp png_ptr, png_const_charp warning_message)\r
 217 {\r
 218    int offset = 0;\r
 219    if (png_ptr != NULL)\r
 220    {\r
 221 #ifdef PNG_ERROR_NUMBERS_SUPPORTED\r
 222    if ((png_ptr->flags &\r
 223        (PNG_FLAG_STRIP_ERROR_NUMBERS|PNG_FLAG_STRIP_ERROR_TEXT)) != 0)\r
 224 #endif\r
 225       {\r
 226          if (*warning_message == PNG_LITERAL_SHARP)\r
 227          {\r
 228             for (offset = 1; offset < 15; offset++)\r
 229                if (warning_message[offset] == ' ')\r
 230                   break;\r
 231          }\r
 232       }\r
 233    }\r
 234    if (png_ptr != NULL && png_ptr->warning_fn != NULL)\r
 235       (*(png_ptr->warning_fn))(png_constcast(png_structrp,png_ptr),\r
 236          warning_message + offset);\r
 237    else\r
 238       png_default_warning(png_ptr, warning_message + offset);\r
 239 }\r
 240 \r
 241 /* These functions support 'formatted' warning messages with up to\r
 242  * PNG_WARNING_PARAMETER_COUNT parameters.  In the format string the parameter\r
 243  * is introduced by @<number>, where 'number' starts at 1.  This follows the\r
 244  * standard established by X/Open for internationalizable error messages.\r
 245  */\r
 246 void\r
 247 png_warning_parameter(png_warning_parameters p, int number,\r
 248    png_const_charp string)\r
 249 {\r
 250    if (number > 0 && number <= PNG_WARNING_PARAMETER_COUNT)\r
 251       (void)png_safecat(p[number-1], (sizeof p[number-1]), 0, string);\r
 252 }\r
 253 \r
 254 void\r
 255 png_warning_parameter_unsigned(png_warning_parameters p, int number, int format,\r
 256    png_alloc_size_t value)\r
 257 {\r
 258    char buffer[PNG_NUMBER_BUFFER_SIZE];\r
 259    png_warning_parameter(p, number, PNG_FORMAT_NUMBER(buffer, format, value));\r
 260 }\r
 261 \r
 262 void\r
 263 png_warning_parameter_signed(png_warning_parameters p, int number, int format,\r
 264    png_int_32 value)\r
 265 {\r
 266    png_alloc_size_t u;\r
 267    png_charp str;\r
 268    char buffer[PNG_NUMBER_BUFFER_SIZE];\r
 269 \r
 270    /* Avoid overflow by doing the negate in a png_alloc_size_t: */\r
 271    u = (png_alloc_size_t)value;\r
 272    if (value < 0)\r
 273       u = ~u + 1;\r
 274 \r
 275    str = PNG_FORMAT_NUMBER(buffer, format, u);\r
 276 \r
 277    if (value < 0 && str > buffer)\r
 278       *--str = '-';\r
 279 \r
 280    png_warning_parameter(p, number, str);\r
 281 }\r
 282 \r
 283 void\r
 284 png_formatted_warning(png_const_structrp png_ptr, png_warning_parameters p,\r
 285    png_const_charp message)\r
 286 {\r
 287    /* The internal buffer is just 192 bytes - enough for all our messages,\r
 288     * overflow doesn't happen because this code checks!  If someone figures\r
 289     * out how to send us a message longer than 192 bytes, all that will\r
 290     * happen is that the message will be truncated appropriately.\r
 291     */\r
 292    size_t i = 0; /* Index in the msg[] buffer: */\r
 293    char msg[192];\r
 294 \r
 295    /* Each iteration through the following loop writes at most one character\r
 296     * to msg[i++] then returns here to validate that there is still space for\r
 297     * the trailing '\0'.  It may (in the case of a parameter) read more than\r
 298     * one character from message[]; it must check for '\0' and continue to the\r
 299     * test if it finds the end of string.\r
 300     */\r
 301    while (i<(sizeof msg)-1 && *message != '\0')\r
 302    {\r
 303       /* '@' at end of string is now just printed (previously it was skipped);\r
 304        * it is an error in the calling code to terminate the string with @.\r
 305        */\r
 306       if (p != NULL && *message == '@' && message[1] != '\0')\r
 307       {\r
 308          int parameter_char = *++message; /* Consume the '@' */\r
 309          static const char valid_parameters[] = "123456789";\r
 310          int parameter = 0;\r
 311 \r
 312          /* Search for the parameter digit, the index in the string is the\r
 313           * parameter to use.\r
 314           */\r
 315          while (valid_parameters[parameter] != parameter_char &&\r
 316             valid_parameters[parameter] != '\0')\r
 317             ++parameter;\r
 318 \r
 319          /* If the parameter digit is out of range it will just get printed. */\r
 320          if (parameter < PNG_WARNING_PARAMETER_COUNT)\r
 321          {\r
 322             /* Append this parameter */\r
 323             png_const_charp parm = p[parameter];\r
 324             png_const_charp pend = p[parameter] + (sizeof p[parameter]);\r
 325 \r
 326             /* No need to copy the trailing '\0' here, but there is no guarantee\r
 327              * that parm[] has been initialized, so there is no guarantee of a\r
 328              * trailing '\0':\r
 329              */\r
 330             while (i<(sizeof msg)-1 && *parm != '\0' && parm < pend)\r
 331                msg[i++] = *parm++;\r
 332 \r
 333             /* Consume the parameter digit too: */\r
 334             ++message;\r
 335             continue;\r
 336          }\r
 337 \r
 338          /* else not a parameter and there is a character after the @ sign; just\r
 339           * copy that.  This is known not to be '\0' because of the test above.\r
 340           */\r
 341       }\r
 342 \r
 343       /* At this point *message can't be '\0', even in the bad parameter case\r
 344        * above where there is a lone '@' at the end of the message string.\r
 345        */\r
 346       msg[i++] = *message++;\r
 347    }\r
 348 \r
 349    /* i is always less than (sizeof msg), so: */\r
 350    msg[i] = '\0';\r
 351 \r
 352    /* And this is the formatted message. It may be larger than\r
 353     * PNG_MAX_ERROR_TEXT, but that is only used for 'chunk' errors and these\r
 354     * are not (currently) formatted.\r
 355     */\r
 356    png_warning(png_ptr, msg);\r
 357 }\r
 358 #endif /* WARNINGS */\r
 359 \r
 360 #ifdef PNG_BENIGN_ERRORS_SUPPORTED\r
 361 void PNGAPI\r
 362 png_benign_error(png_const_structrp png_ptr, png_const_charp error_message)\r
 363 {\r
 364    if ((png_ptr->flags & PNG_FLAG_BENIGN_ERRORS_WARN) != 0)\r
 365    {\r
 366 #     ifdef PNG_READ_SUPPORTED\r
 367          if ((png_ptr->mode & PNG_IS_READ_STRUCT) != 0 &&\r
 368             png_ptr->chunk_name != 0)\r
 369             png_chunk_warning(png_ptr, error_message);\r
 370          else\r
 371 #     endif\r
 372       png_warning(png_ptr, error_message);\r
 373    }\r
 374 \r
 375    else\r
 376    {\r
 377 #     ifdef PNG_READ_SUPPORTED\r
 378          if ((png_ptr->mode & PNG_IS_READ_STRUCT) != 0 &&\r
 379             png_ptr->chunk_name != 0)\r
 380             png_chunk_error(png_ptr, error_message);\r
 381          else\r
 382 #     endif\r
 383       png_error(png_ptr, error_message);\r
 384    }\r
 385 \r
 386 #  ifndef PNG_ERROR_TEXT_SUPPORTED\r
 387       PNG_UNUSED(error_message)\r
 388 #  endif\r
 389 }\r
 390 \r
 391 void /* PRIVATE */\r
 392 png_app_warning(png_const_structrp png_ptr, png_const_charp error_message)\r
 393 {\r
 394   if ((png_ptr->flags & PNG_FLAG_APP_WARNINGS_WARN) != 0)\r
 395      png_warning(png_ptr, error_message);\r
 396   else\r
 397      png_error(png_ptr, error_message);\r
 398 \r
 399 #  ifndef PNG_ERROR_TEXT_SUPPORTED\r
 400       PNG_UNUSED(error_message)\r
 401 #  endif\r
 402 }\r
 403 \r
 404 void /* PRIVATE */\r
 405 png_app_error(png_const_structrp png_ptr, png_const_charp error_message)\r
 406 {\r
 407   if ((png_ptr->flags & PNG_FLAG_APP_ERRORS_WARN) != 0)\r
 408      png_warning(png_ptr, error_message);\r
 409   else\r
 410      png_error(png_ptr, error_message);\r
 411 \r
 412 #  ifndef PNG_ERROR_TEXT_SUPPORTED\r
 413       PNG_UNUSED(error_message)\r
 414 #  endif\r
 415 }\r
 416 #endif /* BENIGN_ERRORS */\r
 417 \r
 418 #define PNG_MAX_ERROR_TEXT 196 /* Currently limited by profile_error in png.c */\r
 419 #if defined(PNG_WARNINGS_SUPPORTED) || \\r
 420    (defined(PNG_READ_SUPPORTED) && defined(PNG_ERROR_TEXT_SUPPORTED))\r
 421 /* These utilities are used internally to build an error message that relates\r
 422  * to the current chunk.  The chunk name comes from png_ptr->chunk_name,\r
 423  * which is used to prefix the message.  The message is limited in length\r
 424  * to 63 bytes. The name characters are output as hex digits wrapped in []\r
 425  * if the character is invalid.\r
 426  */\r
 427 #define isnonalpha(c) ((c) < 65 || (c) > 122 || ((c) > 90 && (c) < 97))\r
 428 static PNG_CONST char png_digit[16] = {\r
 429    '0', '1', '2', '3', '4', '5', '6', '7', '8', '9',\r
 430    'A', 'B', 'C', 'D', 'E', 'F'\r
 431 };\r
 432 \r
 433 static void /* PRIVATE */\r
 434 png_format_buffer(png_const_structrp png_ptr, png_charp buffer, png_const_charp\r
 435     error_message)\r
 436 {\r
 437    png_uint_32 chunk_name = png_ptr->chunk_name;\r
 438    int iout = 0, ishift = 24;\r
 439 \r
 440    while (ishift >= 0)\r
 441    {\r
 442       int c = (int)(chunk_name >> ishift) & 0xff;\r
 443 \r
 444       ishift -= 8;\r
 445       if (isnonalpha(c) != 0)\r
 446       {\r
 447          buffer[iout++] = PNG_LITERAL_LEFT_SQUARE_BRACKET;\r
 448          buffer[iout++] = png_digit[(c & 0xf0) >> 4];\r
 449          buffer[iout++] = png_digit[c & 0x0f];\r
 450          buffer[iout++] = PNG_LITERAL_RIGHT_SQUARE_BRACKET;\r
 451       }\r
 452 \r
 453       else\r
 454       {\r
 455          buffer[iout++] = (char)c;\r
 456       }\r
 457    }\r
 458 \r
 459    if (error_message == NULL)\r
 460       buffer[iout] = '\0';\r
 461 \r
 462    else\r
 463    {\r
 464       int iin = 0;\r
 465 \r
 466       buffer[iout++] = ':';\r
 467       buffer[iout++] = ' ';\r
 468 \r
 469       while (iin < PNG_MAX_ERROR_TEXT-1 && error_message[iin] != '\0')\r
 470          buffer[iout++] = error_message[iin++];\r
 471 \r
 472       /* iin < PNG_MAX_ERROR_TEXT, so the following is safe: */\r
 473       buffer[iout] = '\0';\r
 474    }\r
 475 }\r
 476 #endif /* WARNINGS || ERROR_TEXT */\r
 477 \r
 478 #if defined(PNG_READ_SUPPORTED) && defined(PNG_ERROR_TEXT_SUPPORTED)\r
 479 PNG_FUNCTION(void,PNGAPI\r
 480 png_chunk_error,(png_const_structrp png_ptr, png_const_charp error_message),\r
 481    PNG_NORETURN)\r
 482 {\r
 483    char msg[18+PNG_MAX_ERROR_TEXT];\r
 484    if (png_ptr == NULL)\r
 485       png_error(png_ptr, error_message);\r
 486 \r
 487    else\r
 488    {\r
 489       png_format_buffer(png_ptr, msg, error_message);\r
 490       png_error(png_ptr, msg);\r
 491    }\r
 492 }\r
 493 #endif /* READ && ERROR_TEXT */\r
 494 \r
 495 #ifdef PNG_WARNINGS_SUPPORTED\r
 496 void PNGAPI\r
 497 png_chunk_warning(png_const_structrp png_ptr, png_const_charp warning_message)\r
 498 {\r
 499    char msg[18+PNG_MAX_ERROR_TEXT];\r
 500    if (png_ptr == NULL)\r
 501       png_warning(png_ptr, warning_message);\r
 502 \r
 503    else\r
 504    {\r
 505       png_format_buffer(png_ptr, msg, warning_message);\r
 506       png_warning(png_ptr, msg);\r
 507    }\r
 508 }\r
 509 #endif /* WARNINGS */\r
 510 \r
 511 #ifdef PNG_READ_SUPPORTED\r
 512 #ifdef PNG_BENIGN_ERRORS_SUPPORTED\r
 513 void PNGAPI\r
 514 png_chunk_benign_error(png_const_structrp png_ptr, png_const_charp\r
 515     error_message)\r
 516 {\r
 517    if ((png_ptr->flags & PNG_FLAG_BENIGN_ERRORS_WARN) != 0)\r
 518       png_chunk_warning(png_ptr, error_message);\r
 519 \r
 520    else\r
 521       png_chunk_error(png_ptr, error_message);\r
 522 \r
 523 #  ifndef PNG_ERROR_TEXT_SUPPORTED\r
 524       PNG_UNUSED(error_message)\r
 525 #  endif\r
 526 }\r
 527 #endif\r
 528 #endif /* READ */\r
 529 \r
 530 void /* PRIVATE */\r
 531 png_chunk_report(png_const_structrp png_ptr, png_const_charp message, int error)\r
 532 {\r
 533 #  ifndef PNG_WARNINGS_SUPPORTED\r
 534       PNG_UNUSED(message)\r
 535 #  endif\r
 536 \r
 537    /* This is always supported, but for just read or just write it\r
 538     * unconditionally does the right thing.\r
 539     */\r
 540 #  if defined(PNG_READ_SUPPORTED) && defined(PNG_WRITE_SUPPORTED)\r
 541       if ((png_ptr->mode & PNG_IS_READ_STRUCT) != 0)\r
 542 #  endif\r
 543 \r
 544 #  ifdef PNG_READ_SUPPORTED\r
 545       {\r
 546          if (error < PNG_CHUNK_ERROR)\r
 547             png_chunk_warning(png_ptr, message);\r
 548 \r
 549          else\r
 550             png_chunk_benign_error(png_ptr, message);\r
 551       }\r
 552 #  endif\r
 553 \r
 554 #  if defined(PNG_READ_SUPPORTED) && defined(PNG_WRITE_SUPPORTED)\r
 555       else if ((png_ptr->mode & PNG_IS_READ_STRUCT) == 0)\r
 556 #  endif\r
 557 \r
 558 #  ifdef PNG_WRITE_SUPPORTED\r
 559       {\r
 560          if (error < PNG_CHUNK_WRITE_ERROR)\r
 561             png_app_warning(png_ptr, message);\r
 562 \r
 563          else\r
 564             png_app_error(png_ptr, message);\r
 565       }\r
 566 #  endif\r
 567 }\r
 568 \r
 569 #ifdef PNG_ERROR_TEXT_SUPPORTED\r
 570 #ifdef PNG_FLOATING_POINT_SUPPORTED\r
 571 PNG_FUNCTION(void,\r
 572 png_fixed_error,(png_const_structrp png_ptr, png_const_charp name),PNG_NORETURN)\r
 573 {\r
 574 #  define fixed_message "fixed point overflow in "\r
 575 #  define fixed_message_ln ((sizeof fixed_message)-1)\r
 576    int  iin;\r
 577    char msg[fixed_message_ln+PNG_MAX_ERROR_TEXT];\r
 578    memcpy(msg, fixed_message, fixed_message_ln);\r
 579    iin = 0;\r
 580    if (name != NULL)\r
 581       while (iin < (PNG_MAX_ERROR_TEXT-1) && name[iin] != 0)\r
 582       {\r
 583          msg[fixed_message_ln + iin] = name[iin];\r
 584          ++iin;\r
 585       }\r
 586    msg[fixed_message_ln + iin] = 0;\r
 587    png_error(png_ptr, msg);\r
 588 }\r
 589 #endif\r
 590 #endif\r
 591 \r
 592 #ifdef PNG_SETJMP_SUPPORTED\r
 593 /* This API only exists if ANSI-C style error handling is used,\r
 594  * otherwise it is necessary for png_default_error to be overridden.\r
 595  */\r
 596 jmp_buf* PNGAPI\r
 597 png_set_longjmp_fn(png_structrp png_ptr, png_longjmp_ptr longjmp_fn,\r
 598     size_t jmp_buf_size)\r
 599 {\r
 600    /* From libpng 1.6.0 the app gets one chance to set a 'jmpbuf_size' value\r
 601     * and it must not change after that.  Libpng doesn't care how big the\r
 602     * buffer is, just that it doesn't change.\r
 603     *\r
 604     * If the buffer size is no *larger* than the size of jmp_buf when libpng is\r
 605     * compiled a built in jmp_buf is returned; this preserves the pre-1.6.0\r
 606     * semantics that this call will not fail.  If the size is larger, however,\r
 607     * the buffer is allocated and this may fail, causing the function to return\r
 608     * NULL.\r
 609     */\r
 610    if (png_ptr == NULL)\r
 611       return NULL;\r
 612 \r
 613    if (png_ptr->jmp_buf_ptr == NULL)\r
 614    {\r
 615       png_ptr->jmp_buf_size = 0; /* not allocated */\r
 616 \r
 617       if (jmp_buf_size <= (sizeof png_ptr->jmp_buf_local))\r
 618          png_ptr->jmp_buf_ptr = &png_ptr->jmp_buf_local;\r
 619 \r
 620       else\r
 621       {\r
 622          png_ptr->jmp_buf_ptr = png_voidcast(jmp_buf *,\r
 623             png_malloc_warn(png_ptr, jmp_buf_size));\r
 624 \r
 625          if (png_ptr->jmp_buf_ptr == NULL)\r
 626             return NULL; /* new NULL return on OOM */\r
 627 \r
 628          png_ptr->jmp_buf_size = jmp_buf_size;\r
 629       }\r
 630    }\r
 631 \r
 632    else /* Already allocated: check the size */\r
 633    {\r
 634       size_t size = png_ptr->jmp_buf_size;\r
 635 \r
 636       if (size == 0)\r
 637       {\r
 638          size = (sizeof png_ptr->jmp_buf_local);\r
 639          if (png_ptr->jmp_buf_ptr != &png_ptr->jmp_buf_local)\r
 640          {\r
 641             /* This is an internal error in libpng: somehow we have been left\r
 642              * with a stack allocated jmp_buf when the application regained\r
 643              * control.  It's always possible to fix this up, but for the moment\r
 644              * this is a png_error because that makes it easy to detect.\r
 645              */\r
 646             png_error(png_ptr, "Libpng jmp_buf still allocated");\r
 647             /* png_ptr->jmp_buf_ptr = &png_ptr->jmp_buf_local; */\r
 648          }\r
 649       }\r
 650 \r
 651       if (size != jmp_buf_size)\r
 652       {\r
 653          png_warning(png_ptr, "Application jmp_buf size changed");\r
 654          return NULL; /* caller will probably crash: no choice here */\r
 655       }\r
 656    }\r
 657 \r
 658    /* Finally fill in the function, now we have a satisfactory buffer. It is\r
 659     * valid to change the function on every call.\r
 660     */\r
 661    png_ptr->longjmp_fn = longjmp_fn;\r
 662    return png_ptr->jmp_buf_ptr;\r
 663 }\r
 664 \r
 665 void /* PRIVATE */\r
 666 png_free_jmpbuf(png_structrp png_ptr)\r
 667 {\r
 668    if (png_ptr != NULL)\r
 669    {\r
 670       jmp_buf *jb = png_ptr->jmp_buf_ptr;\r
 671 \r
 672       /* A size of 0 is used to indicate a local, stack, allocation of the\r
 673        * pointer; used here and in png.c\r
 674        */\r
 675       if (jb != NULL && png_ptr->jmp_buf_size > 0)\r
 676       {\r
 677 \r
 678          /* This stuff is so that a failure to free the error control structure\r
 679           * does not leave libpng in a state with no valid error handling: the\r
 680           * free always succeeds, if there is an error it gets ignored.\r
 681           */\r
 682          if (jb != &png_ptr->jmp_buf_local)\r
 683          {\r
 684             /* Make an internal, libpng, jmp_buf to return here */\r
 685             jmp_buf free_jmp_buf;\r
 686 \r
 687             if (!setjmp(free_jmp_buf))\r
 688             {\r
 689                png_ptr->jmp_buf_ptr = &free_jmp_buf; /* come back here */\r
 690                png_ptr->jmp_buf_size = 0; /* stack allocation */\r
 691                png_ptr->longjmp_fn = longjmp;\r
 692                png_free(png_ptr, jb); /* Return to setjmp on error */\r
 693             }\r
 694          }\r
 695       }\r
 696 \r
 697       /* *Always* cancel everything out: */\r
 698       png_ptr->jmp_buf_size = 0;\r
 699       png_ptr->jmp_buf_ptr = NULL;\r
 700       png_ptr->longjmp_fn = 0;\r
 701    }\r
 702 }\r
 703 #endif\r
 704 \r
 705 /* This is the default error handling function.  Note that replacements for\r
 706  * this function MUST NOT RETURN, or the program will likely crash.  This\r
 707  * function is used by default, or if the program supplies NULL for the\r
 708  * error function pointer in png_set_error_fn().\r
 709  */\r
 710 static PNG_FUNCTION(void /* PRIVATE */,\r
 711 png_default_error,(png_const_structrp png_ptr, png_const_charp error_message),\r
 712    PNG_NORETURN)\r
 713 {\r
 714 #ifdef PNG_CONSOLE_IO_SUPPORTED\r
 715 #ifdef PNG_ERROR_NUMBERS_SUPPORTED\r
 716    /* Check on NULL only added in 1.5.4 */\r
 717    if (error_message != NULL && *error_message == PNG_LITERAL_SHARP)\r
 718    {\r
 719       /* Strip "#nnnn " from beginning of error message. */\r
 720       int offset;\r
 721       char error_number[16];\r
 722       for (offset = 0; offset<15; offset++)\r
 723       {\r
 724          error_number[offset] = error_message[offset + 1];\r
 725          if (error_message[offset] == ' ')\r
 726             break;\r
 727       }\r
 728 \r
 729       if ((offset > 1) && (offset < 15))\r
 730       {\r
 731          error_number[offset - 1] = '\0';\r
 732          fprintf(stderr, "libpng error no. %s: %s",\r
 733              error_number, error_message + offset + 1);\r
 734          fprintf(stderr, PNG_STRING_NEWLINE);\r
 735       }\r
 736 \r
 737       else\r
 738       {\r
 739          fprintf(stderr, "libpng error: %s, offset=%d",\r
 740              error_message, offset);\r
 741          fprintf(stderr, PNG_STRING_NEWLINE);\r
 742       }\r
 743    }\r
 744    else\r
 745 #endif\r
 746    {\r
 747       fprintf(stderr, "libpng error: %s", error_message ? error_message :\r
 748          "undefined");\r
 749       fprintf(stderr, PNG_STRING_NEWLINE);\r
 750    }\r
 751 #else\r
 752    PNG_UNUSED(error_message) /* Make compiler happy */\r
 753 #endif\r
 754    png_longjmp(png_ptr, 1);\r
 755 }\r
 756 \r
 757 PNG_FUNCTION(void,PNGAPI\r
 758 png_longjmp,(png_const_structrp png_ptr, int val),PNG_NORETURN)\r
 759 {\r
 760 #ifdef PNG_SETJMP_SUPPORTED\r
 761    if (png_ptr != NULL && png_ptr->longjmp_fn != NULL &&\r
 762        png_ptr->jmp_buf_ptr != NULL)\r
 763       png_ptr->longjmp_fn(*png_ptr->jmp_buf_ptr, val);\r
 764 #else\r
 765    PNG_UNUSED(png_ptr)\r
 766    PNG_UNUSED(val)\r
 767 #endif\r
 768 \r
 769    /* If control reaches this point, png_longjmp() must not return. The only\r
 770     * choice is to terminate the whole process (or maybe the thread); to do\r
 771     * this the ANSI-C abort() function is used unless a different method is\r
 772     * implemented by overriding the default configuration setting for\r
 773     * PNG_ABORT().\r
 774     */\r
 775    PNG_ABORT();\r
 776 }\r
 777 \r
 778 #ifdef PNG_WARNINGS_SUPPORTED\r
 779 /* This function is called when there is a warning, but the library thinks\r
 780  * it can continue anyway.  Replacement functions don't have to do anything\r
 781  * here if you don't want them to.  In the default configuration, png_ptr is\r
 782  * not used, but it is passed in case it may be useful.\r
 783  */\r
 784 static void /* PRIVATE */\r
 785 png_default_warning(png_const_structrp png_ptr, png_const_charp warning_message)\r
 786 {\r
 787 #ifdef PNG_CONSOLE_IO_SUPPORTED\r
 788 #  ifdef PNG_ERROR_NUMBERS_SUPPORTED\r
 789    if (*warning_message == PNG_LITERAL_SHARP)\r
 790    {\r
 791       int offset;\r
 792       char warning_number[16];\r
 793       for (offset = 0; offset < 15; offset++)\r
 794       {\r
 795          warning_number[offset] = warning_message[offset + 1];\r
 796          if (warning_message[offset] == ' ')\r
 797             break;\r
 798       }\r
 799 \r
 800       if ((offset > 1) && (offset < 15))\r
 801       {\r
 802          warning_number[offset + 1] = '\0';\r
 803          fprintf(stderr, "libpng warning no. %s: %s",\r
 804              warning_number, warning_message + offset);\r
 805          fprintf(stderr, PNG_STRING_NEWLINE);\r
 806       }\r
 807 \r
 808       else\r
 809       {\r
 810          fprintf(stderr, "libpng warning: %s",\r
 811              warning_message);\r
 812          fprintf(stderr, PNG_STRING_NEWLINE);\r
 813       }\r
 814    }\r
 815    else\r
 816 #  endif\r
 817 \r
 818    {\r
 819       fprintf(stderr, "libpng warning: %s", warning_message);\r
 820       fprintf(stderr, PNG_STRING_NEWLINE);\r
 821    }\r
 822 #else\r
 823    PNG_UNUSED(warning_message) /* Make compiler happy */\r
 824 #endif\r
 825    PNG_UNUSED(png_ptr) /* Make compiler happy */\r
 826 }\r
 827 #endif /* WARNINGS */\r
 828 \r
 829 /* This function is called when the application wants to use another method\r
 830  * of handling errors and warnings.  Note that the error function MUST NOT\r
 831  * return to the calling routine or serious problems will occur.  The return\r
 832  * method used in the default routine calls longjmp(png_ptr->jmp_buf_ptr, 1)\r
 833  */\r
 834 void PNGAPI\r
 835 png_set_error_fn(png_structrp png_ptr, png_voidp error_ptr,\r
 836     png_error_ptr error_fn, png_error_ptr warning_fn)\r
 837 {\r
 838    if (png_ptr == NULL)\r
 839       return;\r
 840 \r
 841    png_ptr->error_ptr = error_ptr;\r
 842    png_ptr->error_fn = error_fn;\r
 843 #ifdef PNG_WARNINGS_SUPPORTED\r
 844    png_ptr->warning_fn = warning_fn;\r
 845 #else\r
 846    PNG_UNUSED(warning_fn)\r
 847 #endif\r
 848 }\r
 849 \r
 850 \r
 851 /* This function returns a pointer to the error_ptr associated with the user\r
 852  * functions.  The application should free any memory associated with this\r
 853  * pointer before png_write_destroy and png_read_destroy are called.\r
 854  */\r
 855 png_voidp PNGAPI\r
 856 png_get_error_ptr(png_const_structrp png_ptr)\r
 857 {\r
 858    if (png_ptr == NULL)\r
 859       return NULL;\r
 860 \r
 861    return ((png_voidp)png_ptr->error_ptr);\r
 862 }\r
 863 \r
 864 \r
 865 #ifdef PNG_ERROR_NUMBERS_SUPPORTED\r
 866 void PNGAPI\r
 867 png_set_strip_error_numbers(png_structrp png_ptr, png_uint_32 strip_mode)\r
 868 {\r
 869    if (png_ptr != NULL)\r
 870    {\r
 871       png_ptr->flags &=\r
 872          ((~(PNG_FLAG_STRIP_ERROR_NUMBERS |\r
 873          PNG_FLAG_STRIP_ERROR_TEXT))&strip_mode);\r
 874    }\r
 875 }\r
 876 #endif\r
 877 \r
 878 #if defined(PNG_SIMPLIFIED_READ_SUPPORTED) ||\\r
 879    defined(PNG_SIMPLIFIED_WRITE_SUPPORTED)\r
 880    /* Currently the above both depend on SETJMP_SUPPORTED, however it would be\r
 881     * possible to implement without setjmp support just so long as there is some\r
 882     * way to handle the error return here:\r
 883     */\r
 884 PNG_FUNCTION(void /* PRIVATE */, (PNGCBAPI\r
 885 png_safe_error),(png_structp png_nonconst_ptr, png_const_charp error_message),\r
 886    PNG_NORETURN)\r
 887 {\r
 888    const png_const_structrp png_ptr = png_nonconst_ptr;\r
 889    png_imagep image = png_voidcast(png_imagep, png_ptr->error_ptr);\r
 890 \r
 891    /* An error is always logged here, overwriting anything (typically a warning)\r
 892     * that is already there:\r
 893     */\r
 894    if (image != NULL)\r
 895    {\r
 896       png_safecat(image->message, (sizeof image->message), 0, error_message);\r
 897       image->warning_or_error |= PNG_IMAGE_ERROR;\r
 898 \r
 899       /* Retrieve the jmp_buf from within the png_control, making this work for\r
 900        * C++ compilation too is pretty tricky: C++ wants a pointer to the first\r
 901        * element of a jmp_buf, but C doesn't tell us the type of that.\r
 902        */\r
 903       if (image->opaque != NULL && image->opaque->error_buf != NULL)\r
 904          longjmp(png_control_jmp_buf(image->opaque), 1);\r
 905 \r
 906       /* Missing longjmp buffer, the following is to help debugging: */\r
 907       {\r
 908          size_t pos = png_safecat(image->message, (sizeof image->message), 0,\r
 909             "bad longjmp: ");\r
 910          png_safecat(image->message, (sizeof image->message), pos,\r
 911              error_message);\r
 912       }\r
 913    }\r
 914 \r
 915    /* Here on an internal programming error. */\r
 916    abort();\r
 917 }\r
 918 \r
 919 #ifdef PNG_WARNINGS_SUPPORTED\r
 920 void /* PRIVATE */ PNGCBAPI\r
 921 png_safe_warning(png_structp png_nonconst_ptr, png_const_charp warning_message)\r
 922 {\r
 923    const png_const_structrp png_ptr = png_nonconst_ptr;\r
 924    png_imagep image = png_voidcast(png_imagep, png_ptr->error_ptr);\r
 925 \r
 926    /* A warning is only logged if there is no prior warning or error. */\r
 927    if (image->warning_or_error == 0)\r
 928    {\r
 929       png_safecat(image->message, (sizeof image->message), 0, warning_message);\r
 930       image->warning_or_error |= PNG_IMAGE_WARNING;\r
 931    }\r
 932 }\r
 933 #endif\r
 934 \r
 935 int /* PRIVATE */\r
 936 png_safe_execute(png_imagep image_in, int (*function)(png_voidp), png_voidp arg)\r
 937 {\r
 938    volatile png_imagep image = image_in;\r
 939    volatile int result;\r
 940    volatile png_voidp saved_error_buf;\r
 941    jmp_buf safe_jmpbuf;\r
 942 \r
 943    /* Safely execute function(arg) with png_error returning to this function. */\r
 944    saved_error_buf = image->opaque->error_buf;\r
 945    result = setjmp(safe_jmpbuf) == 0;\r
 946 \r
 947    if (result != 0)\r
 948    {\r
 949 \r
 950       image->opaque->error_buf = safe_jmpbuf;\r
 951       result = function(arg);\r
 952    }\r
 953 \r
 954    image->opaque->error_buf = saved_error_buf;\r
 955 \r
 956    /* And do the cleanup prior to any failure return. */\r
 957    if (result == 0)\r
 958       png_image_free(image);\r
 959 \r
 960    return result;\r
 961 }\r
 962 #endif /* SIMPLIFIED READ || SIMPLIFIED_WRITE */\r
 963 #endif /* READ || WRITE */\r