tor-browser

The Tor Browser
git clone https://git.dasho.dev/tor-browser.git
Log | Files | Refs | README | LICENSE

png.c (135414B)


      1 /* png.c - location for general purpose libpng functions
      2 *
      3 * Copyright (c) 2018-2025 Cosmin Truta
      4 * Copyright (c) 1998-2002,2004,2006-2018 Glenn Randers-Pehrson
      5 * Copyright (c) 1996-1997 Andreas Dilger
      6 * Copyright (c) 1995-1996 Guy Eric Schalnat, Group 42, Inc.
      7 *
      8 * This code is released under the libpng license.
      9 * For conditions of distribution and use, see the disclaimer
     10 * and license in png.h
     11 */
     12 
     13 #include "pngpriv.h"
     14 
     15 /* Generate a compiler error if there is an old png.h in the search path. */
     16 typedef png_libpng_version_1_6_53 Your_png_h_is_not_version_1_6_53;
     17 
     18 /* Sanity check the chunks definitions - PNG_KNOWN_CHUNKS from pngpriv.h and the
     19 * corresponding macro definitions.  This causes a compile time failure if
     20 * something is wrong but generates no code.
     21 *
     22 * (1) The first check is that the PNG_CHUNK(cHNK, index) 'index' values must
     23 * increment from 0 to the last value.
     24 */
     25 #define PNG_CHUNK(cHNK, index) != (index) || ((index)+1)
     26 
     27 #if 0 PNG_KNOWN_CHUNKS < 0
     28 #  error PNG_KNOWN_CHUNKS chunk definitions are not in order
     29 #endif
     30 
     31 #undef PNG_CHUNK
     32 
     33 /* (2) The chunk name macros, png_cHNK, must all be valid and defined.  Since
     34 * this is a preprocessor test undefined pp-tokens come out as zero and will
     35 * fail this test.
     36 */
     37 #define PNG_CHUNK(cHNK, index) !PNG_CHUNK_NAME_VALID(png_ ## cHNK) ||
     38 
     39 #if PNG_KNOWN_CHUNKS 0
     40 #  error png_cHNK not defined for some known cHNK
     41 #endif
     42 
     43 #undef PNG_CHUNK
     44 
     45 /* Tells libpng that we have already handled the first "num_bytes" bytes
     46 * of the PNG file signature.  If the PNG data is embedded into another
     47 * stream we can set num_bytes = 8 so that libpng will not attempt to read
     48 * or write any of the magic bytes before it starts on the IHDR.
     49 */
     50 
     51 #ifdef PNG_READ_SUPPORTED
     52 void PNGAPI
     53 png_set_sig_bytes(png_structrp png_ptr, int num_bytes)
     54 {
     55   unsigned int nb = (unsigned int)num_bytes;
     56 
     57   png_debug(1, "in png_set_sig_bytes");
     58 
     59   if (png_ptr == NULL)
     60      return;
     61 
     62   if (num_bytes < 0)
     63      nb = 0;
     64 
     65   if (nb > 8)
     66      png_error(png_ptr, "Too many bytes for PNG signature");
     67 
     68   png_ptr->sig_bytes = (png_byte)nb;
     69 }
     70 
     71 /* Checks whether the supplied bytes match the PNG signature.  We allow
     72 * checking less than the full 8-byte signature so that those apps that
     73 * already read the first few bytes of a file to determine the file type
     74 * can simply check the remaining bytes for extra assurance.  Returns
     75 * an integer less than, equal to, or greater than zero if sig is found,
     76 * respectively, to be less than, to match, or be greater than the correct
     77 * PNG signature (this is the same behavior as strcmp, memcmp, etc).
     78 */
     79 int PNGAPI
     80 png_sig_cmp(png_const_bytep sig, size_t start, size_t num_to_check)
     81 {
     82   static const png_byte png_signature[8] = {137, 80, 78, 71, 13, 10, 26, 10};
     83 
     84   if (num_to_check > 8)
     85      num_to_check = 8;
     86 
     87   else if (num_to_check < 1)
     88      return -1;
     89 
     90   if (start > 7)
     91      return -1;
     92 
     93   if (start + num_to_check > 8)
     94      num_to_check = 8 - start;
     95 
     96   return memcmp(&sig[start], &png_signature[start], num_to_check);
     97 }
     98 
     99 #endif /* READ */
    100 
    101 #if defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED)
    102 /* Function to allocate memory for zlib */
    103 PNG_FUNCTION(voidpf /* PRIVATE */,
    104 png_zalloc,(voidpf png_ptr, uInt items, uInt size),PNG_ALLOCATED)
    105 {
    106   png_alloc_size_t num_bytes = size;
    107 
    108   if (png_ptr == NULL)
    109      return NULL;
    110 
    111   /* This check against overflow is vestigial, dating back from
    112    * the old times when png_zalloc used to be an exported function.
    113    * We're still keeping it here for now, as an extra-cautious
    114    * prevention against programming errors inside zlib, although it
    115    * should rather be a debug-time assertion instead.
    116    */
    117   if (size != 0 && items >= (~(png_alloc_size_t)0) / size)
    118   {
    119      png_warning(png_voidcast(png_structrp, png_ptr),
    120                  "Potential overflow in png_zalloc()");
    121      return NULL;
    122   }
    123 
    124   num_bytes *= items;
    125   return png_malloc_warn(png_voidcast(png_structrp, png_ptr), num_bytes);
    126 }
    127 
    128 /* Function to free memory for zlib */
    129 void /* PRIVATE */
    130 png_zfree(voidpf png_ptr, voidpf ptr)
    131 {
    132   png_free(png_voidcast(png_const_structrp,png_ptr), ptr);
    133 }
    134 
    135 /* Reset the CRC variable to 32 bits of 1's.  Care must be taken
    136 * in case CRC is > 32 bits to leave the top bits 0.
    137 */
    138 void /* PRIVATE */
    139 png_reset_crc(png_structrp png_ptr)
    140 {
    141   /* The cast is safe because the crc is a 32-bit value. */
    142   png_ptr->crc = (png_uint_32)crc32(0, Z_NULL, 0);
    143 }
    144 
    145 /* Calculate the CRC over a section of data.  We can only pass as
    146 * much data to this routine as the largest single buffer size.  We
    147 * also check that this data will actually be used before going to the
    148 * trouble of calculating it.
    149 */
    150 void /* PRIVATE */
    151 png_calculate_crc(png_structrp png_ptr, png_const_bytep ptr, size_t length)
    152 {
    153   int need_crc = 1;
    154 
    155   if (PNG_CHUNK_ANCILLARY(png_ptr->chunk_name) != 0)
    156   {
    157      if ((png_ptr->flags & PNG_FLAG_CRC_ANCILLARY_MASK) ==
    158          (PNG_FLAG_CRC_ANCILLARY_USE | PNG_FLAG_CRC_ANCILLARY_NOWARN))
    159         need_crc = 0;
    160   }
    161 
    162   else /* critical */
    163   {
    164      if ((png_ptr->flags & PNG_FLAG_CRC_CRITICAL_IGNORE) != 0)
    165         need_crc = 0;
    166   }
    167 
    168   /* 'uLong' is defined in zlib.h as unsigned long; this means that on some
    169    * systems it is a 64-bit value.  crc32, however, returns 32 bits so the
    170    * following cast is safe.  'uInt' may be no more than 16 bits, so it is
    171    * necessary to perform a loop here.
    172    */
    173   if (need_crc != 0 && length > 0)
    174   {
    175      uLong crc = png_ptr->crc; /* Should never issue a warning */
    176 
    177      do
    178      {
    179         uInt safe_length = (uInt)length;
    180 #ifndef __COVERITY__
    181         if (safe_length == 0)
    182            safe_length = (uInt)-1; /* evil, but safe */
    183 #endif
    184 
    185         crc = crc32(crc, ptr, safe_length);
    186 
    187         /* The following should never issue compiler warnings; if they do the
    188          * target system has characteristics that will probably violate other
    189          * assumptions within the libpng code.
    190          */
    191         ptr += safe_length;
    192         length -= safe_length;
    193      }
    194      while (length > 0);
    195 
    196      /* And the following is always safe because the crc is only 32 bits. */
    197      png_ptr->crc = (png_uint_32)crc;
    198   }
    199 }
    200 
    201 /* Check a user supplied version number, called from both read and write
    202 * functions that create a png_struct.
    203 */
    204 int
    205 png_user_version_check(png_structrp png_ptr, png_const_charp user_png_ver)
    206 {
    207   /* Libpng versions 1.0.0 and later are binary compatible if the version
    208    * string matches through the second '.'; we must recompile any
    209    * applications that use any older library version.
    210    */
    211 
    212   if (user_png_ver != NULL)
    213   {
    214      int i = -1;
    215      int found_dots = 0;
    216 
    217      do
    218      {
    219         i++;
    220         if (user_png_ver[i] != PNG_LIBPNG_VER_STRING[i])
    221            png_ptr->flags |= PNG_FLAG_LIBRARY_MISMATCH;
    222         if (user_png_ver[i] == '.')
    223            found_dots++;
    224      } while (found_dots < 2 && user_png_ver[i] != 0 &&
    225            PNG_LIBPNG_VER_STRING[i] != 0);
    226   }
    227 
    228   else
    229      png_ptr->flags |= PNG_FLAG_LIBRARY_MISMATCH;
    230 
    231   if ((png_ptr->flags & PNG_FLAG_LIBRARY_MISMATCH) != 0)
    232   {
    233 #ifdef PNG_WARNINGS_SUPPORTED
    234      size_t pos = 0;
    235      char m[128];
    236 
    237      pos = png_safecat(m, (sizeof m), pos,
    238          "Application built with libpng-");
    239      pos = png_safecat(m, (sizeof m), pos, user_png_ver);
    240      pos = png_safecat(m, (sizeof m), pos, " but running with ");
    241      pos = png_safecat(m, (sizeof m), pos, PNG_LIBPNG_VER_STRING);
    242      PNG_UNUSED(pos)
    243 
    244      png_warning(png_ptr, m);
    245 #endif
    246 
    247      return 0;
    248   }
    249 
    250   /* Success return. */
    251   return 1;
    252 }
    253 
    254 /* Generic function to create a png_struct for either read or write - this
    255 * contains the common initialization.
    256 */
    257 PNG_FUNCTION(png_structp /* PRIVATE */,
    258 png_create_png_struct,(png_const_charp user_png_ver, png_voidp error_ptr,
    259    png_error_ptr error_fn, png_error_ptr warn_fn, png_voidp mem_ptr,
    260    png_malloc_ptr malloc_fn, png_free_ptr free_fn),PNG_ALLOCATED)
    261 {
    262   png_struct create_struct;
    263 #  ifdef PNG_SETJMP_SUPPORTED
    264      jmp_buf create_jmp_buf;
    265 #  endif
    266 
    267   /* This temporary stack-allocated structure is used to provide a place to
    268    * build enough context to allow the user provided memory allocator (if any)
    269    * to be called.
    270    */
    271   memset(&create_struct, 0, (sizeof create_struct));
    272 
    273 #  ifdef PNG_USER_LIMITS_SUPPORTED
    274      create_struct.user_width_max = PNG_USER_WIDTH_MAX;
    275      create_struct.user_height_max = PNG_USER_HEIGHT_MAX;
    276 
    277 #     ifdef PNG_USER_CHUNK_CACHE_MAX
    278      create_struct.user_chunk_cache_max = PNG_USER_CHUNK_CACHE_MAX;
    279 #     endif
    280 
    281 #     if PNG_USER_CHUNK_MALLOC_MAX > 0 /* default to compile-time limit */
    282      create_struct.user_chunk_malloc_max = PNG_USER_CHUNK_MALLOC_MAX;
    283 
    284      /* No compile-time limit, so initialize to the system limit: */
    285 #     elif defined PNG_MAX_MALLOC_64K /* legacy system limit */
    286      create_struct.user_chunk_malloc_max = 65536U;
    287 
    288 #     else /* modern system limit SIZE_MAX (C99) */
    289      create_struct.user_chunk_malloc_max = PNG_SIZE_MAX;
    290 #     endif
    291 #  endif
    292 
    293   /* The following two API calls simply set fields in png_struct, so it is safe
    294    * to do them now even though error handling is not yet set up.
    295    */
    296 #  ifdef PNG_USER_MEM_SUPPORTED
    297      png_set_mem_fn(&create_struct, mem_ptr, malloc_fn, free_fn);
    298 #  else
    299      PNG_UNUSED(mem_ptr)
    300      PNG_UNUSED(malloc_fn)
    301      PNG_UNUSED(free_fn)
    302 #  endif
    303 
    304   /* (*error_fn) can return control to the caller after the error_ptr is set,
    305    * this will result in a memory leak unless the error_fn does something
    306    * extremely sophisticated.  The design lacks merit but is implicit in the
    307    * API.
    308    */
    309   png_set_error_fn(&create_struct, error_ptr, error_fn, warn_fn);
    310 
    311 #  ifdef PNG_SETJMP_SUPPORTED
    312      if (!setjmp(create_jmp_buf))
    313 #  endif
    314      {
    315 #  ifdef PNG_SETJMP_SUPPORTED
    316         /* Temporarily fake out the longjmp information until we have
    317          * successfully completed this function.  This only works if we have
    318          * setjmp() support compiled in, but it is safe - this stuff should
    319          * never happen.
    320          */
    321         create_struct.jmp_buf_ptr = &create_jmp_buf;
    322         create_struct.jmp_buf_size = 0; /*stack allocation*/
    323         create_struct.longjmp_fn = longjmp;
    324 #  endif
    325         /* Call the general version checker (shared with read and write code):
    326          */
    327         if (png_user_version_check(&create_struct, user_png_ver) != 0)
    328         {
    329            png_structrp png_ptr = png_voidcast(png_structrp,
    330                png_malloc_warn(&create_struct, (sizeof *png_ptr)));
    331 
    332            if (png_ptr != NULL)
    333            {
    334               /* png_ptr->zstream holds a back-pointer to the png_struct, so
    335                * this can only be done now:
    336                */
    337               create_struct.zstream.zalloc = png_zalloc;
    338               create_struct.zstream.zfree = png_zfree;
    339               create_struct.zstream.opaque = png_ptr;
    340 
    341 #              ifdef PNG_SETJMP_SUPPORTED
    342               /* Eliminate the local error handling: */
    343               create_struct.jmp_buf_ptr = NULL;
    344               create_struct.jmp_buf_size = 0;
    345               create_struct.longjmp_fn = 0;
    346 #              endif
    347 
    348               *png_ptr = create_struct;
    349 
    350               /* This is the successful return point */
    351               return png_ptr;
    352            }
    353         }
    354      }
    355 
    356   /* A longjmp because of a bug in the application storage allocator or a
    357    * simple failure to allocate the png_struct.
    358    */
    359   return NULL;
    360 }
    361 
    362 /* Allocate the memory for an info_struct for the application. */
    363 PNG_FUNCTION(png_infop,PNGAPI
    364 png_create_info_struct,(png_const_structrp png_ptr),PNG_ALLOCATED)
    365 {
    366   png_inforp info_ptr;
    367 
    368   png_debug(1, "in png_create_info_struct");
    369 
    370   if (png_ptr == NULL)
    371      return NULL;
    372 
    373   /* Use the internal API that does not (or at least should not) error out, so
    374    * that this call always returns ok.  The application typically sets up the
    375    * error handling *after* creating the info_struct because this is the way it
    376    * has always been done in 'example.c'.
    377    */
    378   info_ptr = png_voidcast(png_inforp, png_malloc_base(png_ptr,
    379       (sizeof *info_ptr)));
    380 
    381   if (info_ptr != NULL)
    382      memset(info_ptr, 0, (sizeof *info_ptr));
    383 
    384   return info_ptr;
    385 }
    386 
    387 /* This function frees the memory associated with a single info struct.
    388 * Normally, one would use either png_destroy_read_struct() or
    389 * png_destroy_write_struct() to free an info struct, but this may be
    390 * useful for some applications.  From libpng 1.6.0 this function is also used
    391 * internally to implement the png_info release part of the 'struct' destroy
    392 * APIs.  This ensures that all possible approaches free the same data (all of
    393 * it).
    394 */
    395 void PNGAPI
    396 png_destroy_info_struct(png_const_structrp png_ptr, png_infopp info_ptr_ptr)
    397 {
    398   png_inforp info_ptr = NULL;
    399 
    400   png_debug(1, "in png_destroy_info_struct");
    401 
    402   if (png_ptr == NULL)
    403      return;
    404 
    405   if (info_ptr_ptr != NULL)
    406      info_ptr = *info_ptr_ptr;
    407 
    408   if (info_ptr != NULL)
    409   {
    410      /* Do this first in case of an error below; if the app implements its own
    411       * memory management this can lead to png_free calling png_error, which
    412       * will abort this routine and return control to the app error handler.
    413       * An infinite loop may result if it then tries to free the same info
    414       * ptr.
    415       */
    416      *info_ptr_ptr = NULL;
    417 
    418      png_free_data(png_ptr, info_ptr, PNG_FREE_ALL, -1);
    419      memset(info_ptr, 0, (sizeof *info_ptr));
    420      png_free(png_ptr, info_ptr);
    421   }
    422 }
    423 
    424 /* Initialize the info structure.  This is now an internal function (0.89)
    425 * and applications using it are urged to use png_create_info_struct()
    426 * instead.  Use deprecated in 1.6.0, internal use removed (used internally it
    427 * is just a memset).
    428 *
    429 * NOTE: it is almost inconceivable that this API is used because it bypasses
    430 * the user-memory mechanism and the user error handling/warning mechanisms in
    431 * those cases where it does anything other than a memset.
    432 */
    433 PNG_FUNCTION(void,PNGAPI
    434 png_info_init_3,(png_infopp ptr_ptr, size_t png_info_struct_size),
    435    PNG_DEPRECATED)
    436 {
    437   png_inforp info_ptr = *ptr_ptr;
    438 
    439   png_debug(1, "in png_info_init_3");
    440 
    441   if (info_ptr == NULL)
    442      return;
    443 
    444   if ((sizeof (png_info)) > png_info_struct_size)
    445   {
    446      *ptr_ptr = NULL;
    447      /* The following line is why this API should not be used: */
    448      free(info_ptr);
    449      info_ptr = png_voidcast(png_inforp, png_malloc_base(NULL,
    450          (sizeof *info_ptr)));
    451      if (info_ptr == NULL)
    452         return;
    453      *ptr_ptr = info_ptr;
    454   }
    455 
    456   /* Set everything to 0 */
    457   memset(info_ptr, 0, (sizeof *info_ptr));
    458 }
    459 
    460 void PNGAPI
    461 png_data_freer(png_const_structrp png_ptr, png_inforp info_ptr,
    462    int freer, png_uint_32 mask)
    463 {
    464   png_debug(1, "in png_data_freer");
    465 
    466   if (png_ptr == NULL || info_ptr == NULL)
    467      return;
    468 
    469   if (freer == PNG_DESTROY_WILL_FREE_DATA)
    470      info_ptr->free_me |= mask;
    471 
    472   else if (freer == PNG_USER_WILL_FREE_DATA)
    473      info_ptr->free_me &= ~mask;
    474 
    475   else
    476      png_error(png_ptr, "Unknown freer parameter in png_data_freer");
    477 }
    478 
    479 void PNGAPI
    480 png_free_data(png_const_structrp png_ptr, png_inforp info_ptr, png_uint_32 mask,
    481    int num)
    482 {
    483   png_debug(1, "in png_free_data");
    484 
    485   if (png_ptr == NULL || info_ptr == NULL)
    486      return;
    487 
    488 #ifdef PNG_TEXT_SUPPORTED
    489   /* Free text item num or (if num == -1) all text items */
    490   if (info_ptr->text != NULL &&
    491       ((mask & PNG_FREE_TEXT) & info_ptr->free_me) != 0)
    492   {
    493      if (num != -1)
    494      {
    495         png_free(png_ptr, info_ptr->text[num].key);
    496         info_ptr->text[num].key = NULL;
    497      }
    498 
    499      else
    500      {
    501         int i;
    502 
    503         for (i = 0; i < info_ptr->num_text; i++)
    504            png_free(png_ptr, info_ptr->text[i].key);
    505 
    506         png_free(png_ptr, info_ptr->text);
    507         info_ptr->text = NULL;
    508         info_ptr->num_text = 0;
    509         info_ptr->max_text = 0;
    510      }
    511   }
    512 #endif
    513 
    514 #ifdef PNG_tRNS_SUPPORTED
    515   /* Free any tRNS entry */
    516   if (((mask & PNG_FREE_TRNS) & info_ptr->free_me) != 0)
    517   {
    518      info_ptr->valid &= ~PNG_INFO_tRNS;
    519      png_free(png_ptr, info_ptr->trans_alpha);
    520      info_ptr->trans_alpha = NULL;
    521      info_ptr->num_trans = 0;
    522   }
    523 #endif
    524 
    525 #ifdef PNG_sCAL_SUPPORTED
    526   /* Free any sCAL entry */
    527   if (((mask & PNG_FREE_SCAL) & info_ptr->free_me) != 0)
    528   {
    529      png_free(png_ptr, info_ptr->scal_s_width);
    530      png_free(png_ptr, info_ptr->scal_s_height);
    531      info_ptr->scal_s_width = NULL;
    532      info_ptr->scal_s_height = NULL;
    533      info_ptr->valid &= ~PNG_INFO_sCAL;
    534   }
    535 #endif
    536 
    537 #ifdef PNG_pCAL_SUPPORTED
    538   /* Free any pCAL entry */
    539   if (((mask & PNG_FREE_PCAL) & info_ptr->free_me) != 0)
    540   {
    541      png_free(png_ptr, info_ptr->pcal_purpose);
    542      png_free(png_ptr, info_ptr->pcal_units);
    543      info_ptr->pcal_purpose = NULL;
    544      info_ptr->pcal_units = NULL;
    545 
    546      if (info_ptr->pcal_params != NULL)
    547         {
    548            int i;
    549 
    550            for (i = 0; i < info_ptr->pcal_nparams; i++)
    551               png_free(png_ptr, info_ptr->pcal_params[i]);
    552 
    553            png_free(png_ptr, info_ptr->pcal_params);
    554            info_ptr->pcal_params = NULL;
    555         }
    556      info_ptr->valid &= ~PNG_INFO_pCAL;
    557   }
    558 #endif
    559 
    560 #ifdef PNG_iCCP_SUPPORTED
    561   /* Free any profile entry */
    562   if (((mask & PNG_FREE_ICCP) & info_ptr->free_me) != 0)
    563   {
    564      png_free(png_ptr, info_ptr->iccp_name);
    565      png_free(png_ptr, info_ptr->iccp_profile);
    566      info_ptr->iccp_name = NULL;
    567      info_ptr->iccp_profile = NULL;
    568      info_ptr->valid &= ~PNG_INFO_iCCP;
    569   }
    570 #endif
    571 
    572 #ifdef PNG_sPLT_SUPPORTED
    573   /* Free a given sPLT entry, or (if num == -1) all sPLT entries */
    574   if (info_ptr->splt_palettes != NULL &&
    575       ((mask & PNG_FREE_SPLT) & info_ptr->free_me) != 0)
    576   {
    577      if (num != -1)
    578      {
    579         png_free(png_ptr, info_ptr->splt_palettes[num].name);
    580         png_free(png_ptr, info_ptr->splt_palettes[num].entries);
    581         info_ptr->splt_palettes[num].name = NULL;
    582         info_ptr->splt_palettes[num].entries = NULL;
    583      }
    584 
    585      else
    586      {
    587         int i;
    588 
    589         for (i = 0; i < info_ptr->splt_palettes_num; i++)
    590         {
    591            png_free(png_ptr, info_ptr->splt_palettes[i].name);
    592            png_free(png_ptr, info_ptr->splt_palettes[i].entries);
    593         }
    594 
    595         png_free(png_ptr, info_ptr->splt_palettes);
    596         info_ptr->splt_palettes = NULL;
    597         info_ptr->splt_palettes_num = 0;
    598         info_ptr->valid &= ~PNG_INFO_sPLT;
    599      }
    600   }
    601 #endif
    602 
    603 #ifdef PNG_STORE_UNKNOWN_CHUNKS_SUPPORTED
    604   if (info_ptr->unknown_chunks != NULL &&
    605       ((mask & PNG_FREE_UNKN) & info_ptr->free_me) != 0)
    606   {
    607      if (num != -1)
    608      {
    609          png_free(png_ptr, info_ptr->unknown_chunks[num].data);
    610          info_ptr->unknown_chunks[num].data = NULL;
    611      }
    612 
    613      else
    614      {
    615         int i;
    616 
    617         for (i = 0; i < info_ptr->unknown_chunks_num; i++)
    618            png_free(png_ptr, info_ptr->unknown_chunks[i].data);
    619 
    620         png_free(png_ptr, info_ptr->unknown_chunks);
    621         info_ptr->unknown_chunks = NULL;
    622         info_ptr->unknown_chunks_num = 0;
    623      }
    624   }
    625 #endif
    626 
    627 #ifdef PNG_eXIf_SUPPORTED
    628   /* Free any eXIf entry */
    629   if (((mask & PNG_FREE_EXIF) & info_ptr->free_me) != 0)
    630   {
    631      if (info_ptr->exif)
    632      {
    633         png_free(png_ptr, info_ptr->exif);
    634         info_ptr->exif = NULL;
    635      }
    636      info_ptr->valid &= ~PNG_INFO_eXIf;
    637   }
    638 #endif
    639 
    640 #ifdef PNG_hIST_SUPPORTED
    641   /* Free any hIST entry */
    642   if (((mask & PNG_FREE_HIST) & info_ptr->free_me) != 0)
    643   {
    644      png_free(png_ptr, info_ptr->hist);
    645      info_ptr->hist = NULL;
    646      info_ptr->valid &= ~PNG_INFO_hIST;
    647   }
    648 #endif
    649 
    650   /* Free any PLTE entry that was internally allocated */
    651   if (((mask & PNG_FREE_PLTE) & info_ptr->free_me) != 0)
    652   {
    653      png_free(png_ptr, info_ptr->palette);
    654      info_ptr->palette = NULL;
    655      info_ptr->valid &= ~PNG_INFO_PLTE;
    656      info_ptr->num_palette = 0;
    657   }
    658 
    659 #ifdef PNG_INFO_IMAGE_SUPPORTED
    660   /* Free any image bits attached to the info structure */
    661   if (((mask & PNG_FREE_ROWS) & info_ptr->free_me) != 0)
    662   {
    663      if (info_ptr->row_pointers != NULL)
    664      {
    665         png_uint_32 row;
    666         for (row = 0; row < info_ptr->height; row++)
    667            png_free(png_ptr, info_ptr->row_pointers[row]);
    668 
    669         png_free(png_ptr, info_ptr->row_pointers);
    670         info_ptr->row_pointers = NULL;
    671      }
    672      info_ptr->valid &= ~PNG_INFO_IDAT;
    673   }
    674 #endif
    675 
    676   if (num != -1)
    677      mask &= ~PNG_FREE_MUL;
    678 
    679   info_ptr->free_me &= ~mask;
    680 }
    681 #endif /* READ || WRITE */
    682 
    683 /* This function returns a pointer to the io_ptr associated with the user
    684 * functions.  The application should free any memory associated with this
    685 * pointer before png_write_destroy() or png_read_destroy() are called.
    686 */
    687 png_voidp PNGAPI
    688 png_get_io_ptr(png_const_structrp png_ptr)
    689 {
    690   if (png_ptr == NULL)
    691      return NULL;
    692 
    693   return png_ptr->io_ptr;
    694 }
    695 
    696 #if defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED)
    697 #  ifdef PNG_STDIO_SUPPORTED
    698 /* Initialize the default input/output functions for the PNG file.  If you
    699 * use your own read or write routines, you can call either png_set_read_fn()
    700 * or png_set_write_fn() instead of png_init_io().  If you have defined
    701 * PNG_NO_STDIO or otherwise disabled PNG_STDIO_SUPPORTED, you must use a
    702 * function of your own because "FILE *" isn't necessarily available.
    703 */
    704 void PNGAPI
    705 png_init_io(png_structrp png_ptr, FILE *fp)
    706 {
    707   png_debug(1, "in png_init_io");
    708 
    709   if (png_ptr == NULL)
    710      return;
    711 
    712   png_ptr->io_ptr = (png_voidp)fp;
    713 }
    714 #  endif
    715 
    716 #  ifdef PNG_SAVE_INT_32_SUPPORTED
    717 /* PNG signed integers are saved in 32-bit 2's complement format.  ANSI C-90
    718 * defines a cast of a signed integer to an unsigned integer either to preserve
    719 * the value, if it is positive, or to calculate:
    720 *
    721 *     (UNSIGNED_MAX+1) + integer
    722 *
    723 * Where UNSIGNED_MAX is the appropriate maximum unsigned value, so when the
    724 * negative integral value is added the result will be an unsigned value
    725 * corresponding to the 2's complement representation.
    726 */
    727 void PNGAPI
    728 png_save_int_32(png_bytep buf, png_int_32 i)
    729 {
    730   png_save_uint_32(buf, (png_uint_32)i);
    731 }
    732 #  endif
    733 
    734 #  ifdef PNG_TIME_RFC1123_SUPPORTED
    735 /* Convert the supplied time into an RFC 1123 string suitable for use in
    736 * a "Creation Time" or other text-based time string.
    737 */
    738 int PNGAPI
    739 png_convert_to_rfc1123_buffer(char out[29], png_const_timep ptime)
    740 {
    741   static const char short_months[12][4] =
    742        {"Jan", "Feb", "Mar", "Apr", "May", "Jun",
    743         "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"};
    744 
    745   if (out == NULL)
    746      return 0;
    747 
    748   if (ptime->year > 9999 /* RFC1123 limitation */ ||
    749       ptime->month == 0    ||  ptime->month > 12  ||
    750       ptime->day   == 0    ||  ptime->day   > 31  ||
    751       ptime->hour  > 23    ||  ptime->minute > 59 ||
    752       ptime->second > 60)
    753      return 0;
    754 
    755   {
    756      size_t pos = 0;
    757      char number_buf[5] = {0, 0, 0, 0, 0}; /* enough for a four-digit year */
    758 
    759 #     define APPEND_STRING(string) pos = png_safecat(out, 29, pos, (string))
    760 #     define APPEND_NUMBER(format, value)\
    761         APPEND_STRING(PNG_FORMAT_NUMBER(number_buf, format, (value)))
    762 #     define APPEND(ch) if (pos < 28) out[pos++] = (ch)
    763 
    764      APPEND_NUMBER(PNG_NUMBER_FORMAT_u, (unsigned)ptime->day);
    765      APPEND(' ');
    766      APPEND_STRING(short_months[(ptime->month - 1)]);
    767      APPEND(' ');
    768      APPEND_NUMBER(PNG_NUMBER_FORMAT_u, ptime->year);
    769      APPEND(' ');
    770      APPEND_NUMBER(PNG_NUMBER_FORMAT_02u, (unsigned)ptime->hour);
    771      APPEND(':');
    772      APPEND_NUMBER(PNG_NUMBER_FORMAT_02u, (unsigned)ptime->minute);
    773      APPEND(':');
    774      APPEND_NUMBER(PNG_NUMBER_FORMAT_02u, (unsigned)ptime->second);
    775      APPEND_STRING(" +0000"); /* This reliably terminates the buffer */
    776      PNG_UNUSED (pos)
    777 
    778 #     undef APPEND
    779 #     undef APPEND_NUMBER
    780 #     undef APPEND_STRING
    781   }
    782 
    783   return 1;
    784 }
    785 
    786 #    if PNG_LIBPNG_VER < 10700
    787 /* To do: remove the following from libpng-1.7 */
    788 /* Original API that uses a private buffer in png_struct.
    789 * Deprecated because it causes png_struct to carry a spurious temporary
    790 * buffer (png_struct::time_buffer), better to have the caller pass this in.
    791 */
    792 png_const_charp PNGAPI
    793 png_convert_to_rfc1123(png_structrp png_ptr, png_const_timep ptime)
    794 {
    795   if (png_ptr != NULL)
    796   {
    797      /* The only failure above if png_ptr != NULL is from an invalid ptime */
    798      if (png_convert_to_rfc1123_buffer(png_ptr->time_buffer, ptime) == 0)
    799         png_warning(png_ptr, "Ignoring invalid time value");
    800 
    801      else
    802         return png_ptr->time_buffer;
    803   }
    804 
    805   return NULL;
    806 }
    807 #    endif /* LIBPNG_VER < 10700 */
    808 #  endif /* TIME_RFC1123 */
    809 
    810 #endif /* READ || WRITE */
    811 
    812 png_const_charp PNGAPI
    813 png_get_copyright(png_const_structrp png_ptr)
    814 {
    815   PNG_UNUSED(png_ptr)  /* Silence compiler warning about unused png_ptr */
    816 #ifdef PNG_STRING_COPYRIGHT
    817   return PNG_STRING_COPYRIGHT
    818 #else
    819   return PNG_STRING_NEWLINE \
    820      "libpng version 1.6.53" PNG_STRING_NEWLINE \
    821      "Copyright (c) 2018-2025 Cosmin Truta" PNG_STRING_NEWLINE \
    822      "Copyright (c) 1998-2002,2004,2006-2018 Glenn Randers-Pehrson" \
    823      PNG_STRING_NEWLINE \
    824      "Copyright (c) 1996-1997 Andreas Dilger" PNG_STRING_NEWLINE \
    825      "Copyright (c) 1995-1996 Guy Eric Schalnat, Group 42, Inc." \
    826      PNG_STRING_NEWLINE;
    827 #endif
    828 }
    829 
    830 /* The following return the library version as a short string in the
    831 * format 1.0.0 through 99.99.99zz.  To get the version of *.h files
    832 * used with your application, print out PNG_LIBPNG_VER_STRING, which
    833 * is defined in png.h.
    834 * Note: now there is no difference between png_get_libpng_ver() and
    835 * png_get_header_ver().  Due to the version_nn_nn_nn typedef guard,
    836 * it is guaranteed that png.c uses the correct version of png.h.
    837 */
    838 png_const_charp PNGAPI
    839 png_get_libpng_ver(png_const_structrp png_ptr)
    840 {
    841   /* Version of *.c files used when building libpng */
    842   return png_get_header_ver(png_ptr);
    843 }
    844 
    845 png_const_charp PNGAPI
    846 png_get_header_ver(png_const_structrp png_ptr)
    847 {
    848   /* Version of *.h files used when building libpng */
    849   PNG_UNUSED(png_ptr)  /* Silence compiler warning about unused png_ptr */
    850   return PNG_LIBPNG_VER_STRING;
    851 }
    852 
    853 png_const_charp PNGAPI
    854 png_get_header_version(png_const_structrp png_ptr)
    855 {
    856   /* Returns longer string containing both version and date */
    857   PNG_UNUSED(png_ptr)  /* Silence compiler warning about unused png_ptr */
    858 #ifdef __STDC__
    859   return PNG_HEADER_VERSION_STRING
    860 #  ifndef PNG_READ_SUPPORTED
    861      " (NO READ SUPPORT)"
    862 #  endif
    863      PNG_STRING_NEWLINE;
    864 #else
    865   return PNG_HEADER_VERSION_STRING;
    866 #endif
    867 }
    868 
    869 #ifdef PNG_BUILD_GRAYSCALE_PALETTE_SUPPORTED
    870 /* NOTE: this routine is not used internally! */
    871 /* Build a grayscale palette.  Palette is assumed to be 1 << bit_depth
    872 * large of png_color.  This lets grayscale images be treated as
    873 * paletted.  Most useful for gamma correction and simplification
    874 * of code.  This API is not used internally.
    875 */
    876 void PNGAPI
    877 png_build_grayscale_palette(int bit_depth, png_colorp palette)
    878 {
    879   int num_palette;
    880   int color_inc;
    881   int i;
    882   int v;
    883 
    884   png_debug(1, "in png_do_build_grayscale_palette");
    885 
    886   if (palette == NULL)
    887      return;
    888 
    889   switch (bit_depth)
    890   {
    891      case 1:
    892         num_palette = 2;
    893         color_inc = 0xff;
    894         break;
    895 
    896      case 2:
    897         num_palette = 4;
    898         color_inc = 0x55;
    899         break;
    900 
    901      case 4:
    902         num_palette = 16;
    903         color_inc = 0x11;
    904         break;
    905 
    906      case 8:
    907         num_palette = 256;
    908         color_inc = 1;
    909         break;
    910 
    911      default:
    912         num_palette = 0;
    913         color_inc = 0;
    914         break;
    915   }
    916 
    917   for (i = 0, v = 0; i < num_palette; i++, v += color_inc)
    918   {
    919      palette[i].red = (png_byte)(v & 0xff);
    920      palette[i].green = (png_byte)(v & 0xff);
    921      palette[i].blue = (png_byte)(v & 0xff);
    922   }
    923 }
    924 #endif
    925 
    926 #ifdef PNG_SET_UNKNOWN_CHUNKS_SUPPORTED
    927 int PNGAPI
    928 png_handle_as_unknown(png_const_structrp png_ptr, png_const_bytep chunk_name)
    929 {
    930   /* Check chunk_name and return "keep" value if it's on the list, else 0 */
    931   png_const_bytep p, p_end;
    932 
    933   if (png_ptr == NULL || chunk_name == NULL || png_ptr->num_chunk_list == 0)
    934      return PNG_HANDLE_CHUNK_AS_DEFAULT;
    935 
    936   p_end = png_ptr->chunk_list;
    937   p = p_end + png_ptr->num_chunk_list*5; /* beyond end */
    938 
    939   /* The code is the fifth byte after each four byte string.  Historically this
    940    * code was always searched from the end of the list, this is no longer
    941    * necessary because the 'set' routine handles duplicate entries correctly.
    942    */
    943   do /* num_chunk_list > 0, so at least one */
    944   {
    945      p -= 5;
    946 
    947      if (memcmp(chunk_name, p, 4) == 0)
    948         return p[4];
    949   }
    950   while (p > p_end);
    951 
    952   /* This means that known chunks should be processed and unknown chunks should
    953    * be handled according to the value of png_ptr->unknown_default; this can be
    954    * confusing because, as a result, there are two levels of defaulting for
    955    * unknown chunks.
    956    */
    957   return PNG_HANDLE_CHUNK_AS_DEFAULT;
    958 }
    959 
    960 #if defined(PNG_READ_UNKNOWN_CHUNKS_SUPPORTED) ||\
    961   defined(PNG_HANDLE_AS_UNKNOWN_SUPPORTED)
    962 int /* PRIVATE */
    963 png_chunk_unknown_handling(png_const_structrp png_ptr, png_uint_32 chunk_name)
    964 {
    965   png_byte chunk_string[5];
    966 
    967   PNG_CSTRING_FROM_CHUNK(chunk_string, chunk_name);
    968   return png_handle_as_unknown(png_ptr, chunk_string);
    969 }
    970 #endif /* READ_UNKNOWN_CHUNKS || HANDLE_AS_UNKNOWN */
    971 #endif /* SET_UNKNOWN_CHUNKS */
    972 
    973 #ifdef PNG_READ_SUPPORTED
    974 /* This function, added to libpng-1.0.6g, is untested. */
    975 int PNGAPI
    976 png_reset_zstream(png_structrp png_ptr)
    977 {
    978   if (png_ptr == NULL)
    979      return Z_STREAM_ERROR;
    980 
    981   /* WARNING: this resets the window bits to the maximum! */
    982   return inflateReset(&png_ptr->zstream);
    983 }
    984 #endif /* READ */
    985 
    986 /* This function was added to libpng-1.0.7 */
    987 png_uint_32 PNGAPI
    988 png_access_version_number(void)
    989 {
    990   /* Version of *.c files used when building libpng */
    991   return (png_uint_32)PNG_LIBPNG_VER;
    992 }
    993 
    994 #if defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED)
    995 /* Ensure that png_ptr->zstream.msg holds some appropriate error message string.
    996 * If it doesn't 'ret' is used to set it to something appropriate, even in cases
    997 * like Z_OK or Z_STREAM_END where the error code is apparently a success code.
    998 */
    999 void /* PRIVATE */
   1000 png_zstream_error(png_structrp png_ptr, int ret)
   1001 {
   1002   /* Translate 'ret' into an appropriate error string, priority is given to the
   1003    * one in zstream if set.  This always returns a string, even in cases like
   1004    * Z_OK or Z_STREAM_END where the error code is a success code.
   1005    */
   1006   if (png_ptr->zstream.msg == NULL) switch (ret)
   1007   {
   1008      default:
   1009      case Z_OK:
   1010         png_ptr->zstream.msg = PNGZ_MSG_CAST("unexpected zlib return code");
   1011         break;
   1012 
   1013      case Z_STREAM_END:
   1014         /* Normal exit */
   1015         png_ptr->zstream.msg = PNGZ_MSG_CAST("unexpected end of LZ stream");
   1016         break;
   1017 
   1018      case Z_NEED_DICT:
   1019         /* This means the deflate stream did not have a dictionary; this
   1020          * indicates a bogus PNG.
   1021          */
   1022         png_ptr->zstream.msg = PNGZ_MSG_CAST("missing LZ dictionary");
   1023         break;
   1024 
   1025      case Z_ERRNO:
   1026         /* gz APIs only: should not happen */
   1027         png_ptr->zstream.msg = PNGZ_MSG_CAST("zlib IO error");
   1028         break;
   1029 
   1030      case Z_STREAM_ERROR:
   1031         /* internal libpng error */
   1032         png_ptr->zstream.msg = PNGZ_MSG_CAST("bad parameters to zlib");
   1033         break;
   1034 
   1035      case Z_DATA_ERROR:
   1036         png_ptr->zstream.msg = PNGZ_MSG_CAST("damaged LZ stream");
   1037         break;
   1038 
   1039      case Z_MEM_ERROR:
   1040         png_ptr->zstream.msg = PNGZ_MSG_CAST("insufficient memory");
   1041         break;
   1042 
   1043      case Z_BUF_ERROR:
   1044         /* End of input or output; not a problem if the caller is doing
   1045          * incremental read or write.
   1046          */
   1047         png_ptr->zstream.msg = PNGZ_MSG_CAST("truncated");
   1048         break;
   1049 
   1050      case Z_VERSION_ERROR:
   1051         png_ptr->zstream.msg = PNGZ_MSG_CAST("unsupported zlib version");
   1052         break;
   1053 
   1054      case PNG_UNEXPECTED_ZLIB_RETURN:
   1055         /* Compile errors here mean that zlib now uses the value co-opted in
   1056          * pngpriv.h for PNG_UNEXPECTED_ZLIB_RETURN; update the switch above
   1057          * and change pngpriv.h.  Note that this message is "... return",
   1058          * whereas the default/Z_OK one is "... return code".
   1059          */
   1060         png_ptr->zstream.msg = PNGZ_MSG_CAST("unexpected zlib return");
   1061         break;
   1062   }
   1063 }
   1064 
   1065 #ifdef PNG_COLORSPACE_SUPPORTED
   1066 static png_int_32
   1067 png_fp_add(png_int_32 addend0, png_int_32 addend1, int *error)
   1068 {
   1069   /* Safely add two fixed point values setting an error flag and returning 0.5
   1070    * on overflow.
   1071    * IMPLEMENTATION NOTE: ANSI requires signed overflow not to occur, therefore
   1072    * relying on addition of two positive values producing a negative one is not
   1073    * safe.
   1074    */
   1075   if (addend0 > 0)
   1076   {
   1077      if (0x7fffffff - addend0 >= addend1)
   1078         return addend0+addend1;
   1079   }
   1080   else if (addend0 < 0)
   1081   {
   1082      if (-0x7fffffff - addend0 <= addend1)
   1083         return addend0+addend1;
   1084   }
   1085   else
   1086      return addend1;
   1087 
   1088   *error = 1;
   1089   return PNG_FP_1/2;
   1090 }
   1091 
   1092 static png_int_32
   1093 png_fp_sub(png_int_32 addend0, png_int_32 addend1, int *error)
   1094 {
   1095   /* As above but calculate addend0-addend1. */
   1096   if (addend1 > 0)
   1097   {
   1098      if (-0x7fffffff + addend1 <= addend0)
   1099         return addend0-addend1;
   1100   }
   1101   else if (addend1 < 0)
   1102   {
   1103      if (0x7fffffff + addend1 >= addend0)
   1104         return addend0-addend1;
   1105   }
   1106   else
   1107      return addend0;
   1108 
   1109   *error = 1;
   1110   return PNG_FP_1/2;
   1111 }
   1112 
   1113 static int
   1114 png_safe_add(png_int_32 *addend0_and_result, png_int_32 addend1,
   1115      png_int_32 addend2)
   1116 {
   1117   /* Safely add three integers.  Returns 0 on success, 1 on overflow.  Does not
   1118    * set the result on overflow.
   1119    */
   1120   int error = 0;
   1121   int result = png_fp_add(*addend0_and_result,
   1122                           png_fp_add(addend1, addend2, &error),
   1123                           &error);
   1124   if (!error) *addend0_and_result = result;
   1125   return error;
   1126 }
   1127 
   1128 /* Added at libpng-1.5.5 to support read and write of true CIEXYZ values for
   1129 * cHRM, as opposed to using chromaticities.  These internal APIs return
   1130 * non-zero on a parameter error.  The X, Y and Z values are required to be
   1131 * positive and less than 1.0.
   1132 */
   1133 int /* PRIVATE */
   1134 png_xy_from_XYZ(png_xy *xy, const png_XYZ *XYZ)
   1135 {
   1136   /* NOTE: returns 0 on success, 1 means error. */
   1137   png_int_32 d, dred, dgreen, dblue, dwhite, whiteX, whiteY;
   1138 
   1139   /* 'd' in each of the blocks below is just X+Y+Z for each component,
   1140    * x, y and z are X,Y,Z/(X+Y+Z).
   1141    */
   1142   d = XYZ->red_X;
   1143   if (png_safe_add(&d, XYZ->red_Y, XYZ->red_Z))
   1144      return 1;
   1145   dred = d;
   1146   if (png_muldiv(&xy->redx, XYZ->red_X, PNG_FP_1, dred) == 0)
   1147      return 1;
   1148   if (png_muldiv(&xy->redy, XYZ->red_Y, PNG_FP_1, dred) == 0)
   1149      return 1;
   1150 
   1151   d = XYZ->green_X;
   1152   if (png_safe_add(&d, XYZ->green_Y, XYZ->green_Z))
   1153      return 1;
   1154   dgreen = d;
   1155   if (png_muldiv(&xy->greenx, XYZ->green_X, PNG_FP_1, dgreen) == 0)
   1156      return 1;
   1157   if (png_muldiv(&xy->greeny, XYZ->green_Y, PNG_FP_1, dgreen) == 0)
   1158      return 1;
   1159 
   1160   d = XYZ->blue_X;
   1161   if (png_safe_add(&d, XYZ->blue_Y, XYZ->blue_Z))
   1162      return 1;
   1163   dblue = d;
   1164   if (png_muldiv(&xy->bluex, XYZ->blue_X, PNG_FP_1, dblue) == 0)
   1165      return 1;
   1166   if (png_muldiv(&xy->bluey, XYZ->blue_Y, PNG_FP_1, dblue) == 0)
   1167      return 1;
   1168 
   1169   /* The reference white is simply the sum of the end-point (X,Y,Z) vectors so
   1170    * the fillowing calculates (X+Y+Z) of the reference white (media white,
   1171    * encoding white) itself:
   1172    */
   1173   d = dblue;
   1174   if (png_safe_add(&d, dred, dgreen))
   1175      return 1;
   1176   dwhite = d;
   1177 
   1178   /* Find the white X,Y values from the sum of the red, green and blue X,Y
   1179    * values.
   1180    */
   1181   d = XYZ->red_X;
   1182   if (png_safe_add(&d, XYZ->green_X, XYZ->blue_X))
   1183      return 1;
   1184   whiteX = d;
   1185 
   1186   d = XYZ->red_Y;
   1187   if (png_safe_add(&d, XYZ->green_Y, XYZ->blue_Y))
   1188      return 1;
   1189   whiteY = d;
   1190 
   1191   if (png_muldiv(&xy->whitex, whiteX, PNG_FP_1, dwhite) == 0)
   1192      return 1;
   1193   if (png_muldiv(&xy->whitey, whiteY, PNG_FP_1, dwhite) == 0)
   1194      return 1;
   1195 
   1196   return 0;
   1197 }
   1198 
   1199 int /* PRIVATE */
   1200 png_XYZ_from_xy(png_XYZ *XYZ, const png_xy *xy)
   1201 {
   1202   /* NOTE: returns 0 on success, 1 means error. */
   1203   png_fixed_point red_inverse, green_inverse, blue_scale;
   1204   png_fixed_point left, right, denominator;
   1205 
   1206   /* Check xy and, implicitly, z.  Note that wide gamut color spaces typically
   1207    * have end points with 0 tristimulus values (these are impossible end
   1208    * points, but they are used to cover the possible colors).  We check
   1209    * xy->whitey against 5, not 0, to avoid a possible integer overflow.
   1210    *
   1211    * The limits here will *not* accept ACES AP0, where bluey is -7700
   1212    * (-0.0770) because the PNG spec itself requires the xy values to be
   1213    * unsigned.  whitey is also required to be 5 or more to avoid overflow.
   1214    *
   1215    * Instead the upper limits have been relaxed to accomodate ACES AP1 where
   1216    * redz ends up as -600 (-0.006).  ProPhotoRGB was already "in range."
   1217    * The new limit accomodates the AP0 and AP1 ranges for z but not AP0 redy.
   1218    */
   1219   const png_fixed_point fpLimit = PNG_FP_1+(PNG_FP_1/10);
   1220   if (xy->redx   < 0 || xy->redx > fpLimit) return 1;
   1221   if (xy->redy   < 0 || xy->redy > fpLimit-xy->redx) return 1;
   1222   if (xy->greenx < 0 || xy->greenx > fpLimit) return 1;
   1223   if (xy->greeny < 0 || xy->greeny > fpLimit-xy->greenx) return 1;
   1224   if (xy->bluex  < 0 || xy->bluex > fpLimit) return 1;
   1225   if (xy->bluey  < 0 || xy->bluey > fpLimit-xy->bluex) return 1;
   1226   if (xy->whitex < 0 || xy->whitex > fpLimit) return 1;
   1227   if (xy->whitey < 5 || xy->whitey > fpLimit-xy->whitex) return 1;
   1228 
   1229   /* The reverse calculation is more difficult because the original tristimulus
   1230    * value had 9 independent values (red,green,blue)x(X,Y,Z) however only 8
   1231    * derived values were recorded in the cHRM chunk;
   1232    * (red,green,blue,white)x(x,y).  This loses one degree of freedom and
   1233    * therefore an arbitrary ninth value has to be introduced to undo the
   1234    * original transformations.
   1235    *
   1236    * Think of the original end-points as points in (X,Y,Z) space.  The
   1237    * chromaticity values (c) have the property:
   1238    *
   1239    *           C
   1240    *   c = ---------
   1241    *       X + Y + Z
   1242    *
   1243    * For each c (x,y,z) from the corresponding original C (X,Y,Z).  Thus the
   1244    * three chromaticity values (x,y,z) for each end-point obey the
   1245    * relationship:
   1246    *
   1247    *   x + y + z = 1
   1248    *
   1249    * This describes the plane in (X,Y,Z) space that intersects each axis at the
   1250    * value 1.0; call this the chromaticity plane.  Thus the chromaticity
   1251    * calculation has scaled each end-point so that it is on the x+y+z=1 plane
   1252    * and chromaticity is the intersection of the vector from the origin to the
   1253    * (X,Y,Z) value with the chromaticity plane.
   1254    *
   1255    * To fully invert the chromaticity calculation we would need the three
   1256    * end-point scale factors, (red-scale, green-scale, blue-scale), but these
   1257    * were not recorded.  Instead we calculated the reference white (X,Y,Z) and
   1258    * recorded the chromaticity of this.  The reference white (X,Y,Z) would have
   1259    * given all three of the scale factors since:
   1260    *
   1261    *    color-C = color-c * color-scale
   1262    *    white-C = red-C + green-C + blue-C
   1263    *            = red-c*red-scale + green-c*green-scale + blue-c*blue-scale
   1264    *
   1265    * But cHRM records only white-x and white-y, so we have lost the white scale
   1266    * factor:
   1267    *
   1268    *    white-C = white-c*white-scale
   1269    *
   1270    * To handle this the inverse transformation makes an arbitrary assumption
   1271    * about white-scale:
   1272    *
   1273    *    Assume: white-Y = 1.0
   1274    *    Hence:  white-scale = 1/white-y
   1275    *    Or:     red-Y + green-Y + blue-Y = 1.0
   1276    *
   1277    * Notice the last statement of the assumption gives an equation in three of
   1278    * the nine values we want to calculate.  8 more equations come from the
   1279    * above routine as summarised at the top above (the chromaticity
   1280    * calculation):
   1281    *
   1282    *    Given: color-x = color-X / (color-X + color-Y + color-Z)
   1283    *    Hence: (color-x - 1)*color-X + color.x*color-Y + color.x*color-Z = 0
   1284    *
   1285    * This is 9 simultaneous equations in the 9 variables "color-C" and can be
   1286    * solved by Cramer's rule.  Cramer's rule requires calculating 10 9x9 matrix
   1287    * determinants, however this is not as bad as it seems because only 28 of
   1288    * the total of 90 terms in the various matrices are non-zero.  Nevertheless
   1289    * Cramer's rule is notoriously numerically unstable because the determinant
   1290    * calculation involves the difference of large, but similar, numbers.  It is
   1291    * difficult to be sure that the calculation is stable for real world values
   1292    * and it is certain that it becomes unstable where the end points are close
   1293    * together.
   1294    *
   1295    * So this code uses the perhaps slightly less optimal but more
   1296    * understandable and totally obvious approach of calculating color-scale.
   1297    *
   1298    * This algorithm depends on the precision in white-scale and that is
   1299    * (1/white-y), so we can immediately see that as white-y approaches 0 the
   1300    * accuracy inherent in the cHRM chunk drops off substantially.
   1301    *
   1302    * libpng arithmetic: a simple inversion of the above equations
   1303    * ------------------------------------------------------------
   1304    *
   1305    *    white_scale = 1/white-y
   1306    *    white-X = white-x * white-scale
   1307    *    white-Y = 1.0
   1308    *    white-Z = (1 - white-x - white-y) * white_scale
   1309    *
   1310    *    white-C = red-C + green-C + blue-C
   1311    *            = red-c*red-scale + green-c*green-scale + blue-c*blue-scale
   1312    *
   1313    * This gives us three equations in (red-scale,green-scale,blue-scale) where
   1314    * all the coefficients are now known:
   1315    *
   1316    *    red-x*red-scale + green-x*green-scale + blue-x*blue-scale
   1317    *       = white-x/white-y
   1318    *    red-y*red-scale + green-y*green-scale + blue-y*blue-scale = 1
   1319    *    red-z*red-scale + green-z*green-scale + blue-z*blue-scale
   1320    *       = (1 - white-x - white-y)/white-y
   1321    *
   1322    * In the last equation color-z is (1 - color-x - color-y) so we can add all
   1323    * three equations together to get an alternative third:
   1324    *
   1325    *    red-scale + green-scale + blue-scale = 1/white-y = white-scale
   1326    *
   1327    * So now we have a Cramer's rule solution where the determinants are just
   1328    * 3x3 - far more tractible.  Unfortunately 3x3 determinants still involve
   1329    * multiplication of three coefficients so we can't guarantee to avoid
   1330    * overflow in the libpng fixed point representation.  Using Cramer's rule in
   1331    * floating point is probably a good choice here, but it's not an option for
   1332    * fixed point.  Instead proceed to simplify the first two equations by
   1333    * eliminating what is likely to be the largest value, blue-scale:
   1334    *
   1335    *    blue-scale = white-scale - red-scale - green-scale
   1336    *
   1337    * Hence:
   1338    *
   1339    *    (red-x - blue-x)*red-scale + (green-x - blue-x)*green-scale =
   1340    *                (white-x - blue-x)*white-scale
   1341    *
   1342    *    (red-y - blue-y)*red-scale + (green-y - blue-y)*green-scale =
   1343    *                1 - blue-y*white-scale
   1344    *
   1345    * And now we can trivially solve for (red-scale,green-scale):
   1346    *
   1347    *    green-scale =
   1348    *                (white-x - blue-x)*white-scale - (red-x - blue-x)*red-scale
   1349    *                -----------------------------------------------------------
   1350    *                                  green-x - blue-x
   1351    *
   1352    *    red-scale =
   1353    *                1 - blue-y*white-scale - (green-y - blue-y) * green-scale
   1354    *                ---------------------------------------------------------
   1355    *                                  red-y - blue-y
   1356    *
   1357    * Hence:
   1358    *
   1359    *    red-scale =
   1360    *          ( (green-x - blue-x) * (white-y - blue-y) -
   1361    *            (green-y - blue-y) * (white-x - blue-x) ) / white-y
   1362    * -------------------------------------------------------------------------
   1363    *  (green-x - blue-x)*(red-y - blue-y)-(green-y - blue-y)*(red-x - blue-x)
   1364    *
   1365    *    green-scale =
   1366    *          ( (red-y - blue-y) * (white-x - blue-x) -
   1367    *            (red-x - blue-x) * (white-y - blue-y) ) / white-y
   1368    * -------------------------------------------------------------------------
   1369    *  (green-x - blue-x)*(red-y - blue-y)-(green-y - blue-y)*(red-x - blue-x)
   1370    *
   1371    * Accuracy:
   1372    * The input values have 5 decimal digits of accuracy.
   1373    *
   1374    * In the previous implementation the values were all in the range 0 < value
   1375    * < 1, so simple products are in the same range but may need up to 10
   1376    * decimal digits to preserve the original precision and avoid underflow.
   1377    * Because we are using a 32-bit signed representation we cannot match this;
   1378    * the best is a little over 9 decimal digits, less than 10.
   1379    *
   1380    * This range has now been extended to allow values up to 1.1, or 110,000 in
   1381    * fixed point.
   1382    *
   1383    * The approach used here is to preserve the maximum precision within the
   1384    * signed representation.  Because the red-scale calculation above uses the
   1385    * difference between two products of values that must be in the range
   1386    * -1.1..+1.1 it is sufficient to divide the product by 8;
   1387    * ceil(121,000/32767*2).  The factor is irrelevant in the calculation
   1388    * because it is applied to both numerator and denominator.
   1389    *
   1390    * Note that the values of the differences of the products of the
   1391    * chromaticities in the above equations tend to be small, for example for
   1392    * the sRGB chromaticities they are:
   1393    *
   1394    * red numerator:    -0.04751
   1395    * green numerator:  -0.08788
   1396    * denominator:      -0.2241 (without white-y multiplication)
   1397    *
   1398    *  The resultant Y coefficients from the chromaticities of some widely used
   1399    *  color space definitions are (to 15 decimal places):
   1400    *
   1401    *  sRGB
   1402    *    0.212639005871510 0.715168678767756 0.072192315360734
   1403    *  Kodak ProPhoto
   1404    *    0.288071128229293 0.711843217810102 0.000085653960605
   1405    *  Adobe RGB
   1406    *    0.297344975250536 0.627363566255466 0.075291458493998
   1407    *  Adobe Wide Gamut RGB
   1408    *    0.258728243040113 0.724682314948566 0.016589442011321
   1409    */
   1410   {
   1411      int error = 0;
   1412 
   1413      /* By the argument above overflow should be impossible here, however the
   1414       * code now simply returns a failure code.  The xy subtracts in the
   1415       * arguments to png_muldiv are *not* checked for overflow because the
   1416       * checks at the start guarantee they are in the range 0..110000 and
   1417       * png_fixed_point is a 32-bit signed number.
   1418       */
   1419      if (png_muldiv(&left, xy->greenx-xy->bluex, xy->redy - xy->bluey, 8) == 0)
   1420         return 1;
   1421      if (png_muldiv(&right, xy->greeny-xy->bluey, xy->redx - xy->bluex, 8) ==
   1422            0)
   1423         return 1;
   1424      denominator = png_fp_sub(left, right, &error);
   1425      if (error) return 1;
   1426 
   1427      /* Now find the red numerator. */
   1428      if (png_muldiv(&left, xy->greenx-xy->bluex, xy->whitey-xy->bluey, 8) == 0)
   1429         return 1;
   1430      if (png_muldiv(&right, xy->greeny-xy->bluey, xy->whitex-xy->bluex, 8) ==
   1431            0)
   1432         return 1;
   1433 
   1434      /* Overflow is possible here and it indicates an extreme set of PNG cHRM
   1435       * chunk values.  This calculation actually returns the reciprocal of the
   1436       * scale value because this allows us to delay the multiplication of
   1437       * white-y into the denominator, which tends to produce a small number.
   1438       */
   1439      if (png_muldiv(&red_inverse, xy->whitey, denominator,
   1440                     png_fp_sub(left, right, &error)) == 0 || error ||
   1441          red_inverse <= xy->whitey /* r+g+b scales = white scale */)
   1442         return 1;
   1443 
   1444      /* Similarly for green_inverse: */
   1445      if (png_muldiv(&left, xy->redy-xy->bluey, xy->whitex-xy->bluex, 8) == 0)
   1446         return 1;
   1447      if (png_muldiv(&right, xy->redx-xy->bluex, xy->whitey-xy->bluey, 8) == 0)
   1448         return 1;
   1449      if (png_muldiv(&green_inverse, xy->whitey, denominator,
   1450                     png_fp_sub(left, right, &error)) == 0 || error ||
   1451          green_inverse <= xy->whitey)
   1452         return 1;
   1453 
   1454      /* And the blue scale, the checks above guarantee this can't overflow but
   1455       * it can still produce 0 for extreme cHRM values.
   1456       */
   1457      blue_scale = png_fp_sub(png_fp_sub(png_reciprocal(xy->whitey),
   1458                                         png_reciprocal(red_inverse), &error),
   1459                              png_reciprocal(green_inverse), &error);
   1460      if (error || blue_scale <= 0)
   1461         return 1;
   1462   }
   1463 
   1464   /* And fill in the png_XYZ.  Again the subtracts are safe because of the
   1465    * checks on the xy values at the start (the subtracts just calculate the
   1466    * corresponding z values.)
   1467    */
   1468   if (png_muldiv(&XYZ->red_X, xy->redx, PNG_FP_1, red_inverse) == 0)
   1469      return 1;
   1470   if (png_muldiv(&XYZ->red_Y, xy->redy, PNG_FP_1, red_inverse) == 0)
   1471      return 1;
   1472   if (png_muldiv(&XYZ->red_Z, PNG_FP_1 - xy->redx - xy->redy, PNG_FP_1,
   1473       red_inverse) == 0)
   1474      return 1;
   1475 
   1476   if (png_muldiv(&XYZ->green_X, xy->greenx, PNG_FP_1, green_inverse) == 0)
   1477      return 1;
   1478   if (png_muldiv(&XYZ->green_Y, xy->greeny, PNG_FP_1, green_inverse) == 0)
   1479      return 1;
   1480   if (png_muldiv(&XYZ->green_Z, PNG_FP_1 - xy->greenx - xy->greeny, PNG_FP_1,
   1481       green_inverse) == 0)
   1482      return 1;
   1483 
   1484   if (png_muldiv(&XYZ->blue_X, xy->bluex, blue_scale, PNG_FP_1) == 0)
   1485      return 1;
   1486   if (png_muldiv(&XYZ->blue_Y, xy->bluey, blue_scale, PNG_FP_1) == 0)
   1487      return 1;
   1488   if (png_muldiv(&XYZ->blue_Z, PNG_FP_1 - xy->bluex - xy->bluey, blue_scale,
   1489       PNG_FP_1) == 0)
   1490      return 1;
   1491 
   1492   return 0; /*success*/
   1493 }
   1494 #endif /* COLORSPACE */
   1495 
   1496 #ifdef PNG_READ_iCCP_SUPPORTED
   1497 /* Error message generation */
   1498 static char
   1499 png_icc_tag_char(png_uint_32 byte)
   1500 {
   1501   byte &= 0xff;
   1502   if (byte >= 32 && byte <= 126)
   1503      return (char)byte;
   1504   else
   1505      return '?';
   1506 }
   1507 
   1508 static void
   1509 png_icc_tag_name(char *name, png_uint_32 tag)
   1510 {
   1511   name[0] = '\'';
   1512   name[1] = png_icc_tag_char(tag >> 24);
   1513   name[2] = png_icc_tag_char(tag >> 16);
   1514   name[3] = png_icc_tag_char(tag >>  8);
   1515   name[4] = png_icc_tag_char(tag      );
   1516   name[5] = '\'';
   1517 }
   1518 
   1519 static int
   1520 is_ICC_signature_char(png_alloc_size_t it)
   1521 {
   1522   return it == 32 || (it >= 48 && it <= 57) || (it >= 65 && it <= 90) ||
   1523      (it >= 97 && it <= 122);
   1524 }
   1525 
   1526 static int
   1527 is_ICC_signature(png_alloc_size_t it)
   1528 {
   1529   return is_ICC_signature_char(it >> 24) /* checks all the top bits */ &&
   1530      is_ICC_signature_char((it >> 16) & 0xff) &&
   1531      is_ICC_signature_char((it >> 8) & 0xff) &&
   1532      is_ICC_signature_char(it & 0xff);
   1533 }
   1534 
   1535 static int
   1536 png_icc_profile_error(png_const_structrp png_ptr, png_const_charp name,
   1537   png_alloc_size_t value, png_const_charp reason)
   1538 {
   1539   size_t pos;
   1540   char message[196]; /* see below for calculation */
   1541 
   1542   pos = png_safecat(message, (sizeof message), 0, "profile '"); /* 9 chars */
   1543   pos = png_safecat(message, pos+79, pos, name); /* Truncate to 79 chars */
   1544   pos = png_safecat(message, (sizeof message), pos, "': "); /* +2 = 90 */
   1545   if (is_ICC_signature(value) != 0)
   1546   {
   1547      /* So 'value' is at most 4 bytes and the following cast is safe */
   1548      png_icc_tag_name(message+pos, (png_uint_32)value);
   1549      pos += 6; /* total +8; less than the else clause */
   1550      message[pos++] = ':';
   1551      message[pos++] = ' ';
   1552   }
   1553 #  ifdef PNG_WARNINGS_SUPPORTED
   1554   else
   1555   {
   1556      char number[PNG_NUMBER_BUFFER_SIZE]; /* +24 = 114 */
   1557 
   1558      pos = png_safecat(message, (sizeof message), pos,
   1559          png_format_number(number, number+(sizeof number),
   1560          PNG_NUMBER_FORMAT_x, value));
   1561      pos = png_safecat(message, (sizeof message), pos, "h: "); /* +2 = 116 */
   1562   }
   1563 #  endif
   1564   /* The 'reason' is an arbitrary message, allow +79 maximum 195 */
   1565   pos = png_safecat(message, (sizeof message), pos, reason);
   1566   PNG_UNUSED(pos)
   1567 
   1568   png_chunk_benign_error(png_ptr, message);
   1569 
   1570   return 0;
   1571 }
   1572 
   1573 /* Encoded value of D50 as an ICC XYZNumber.  From the ICC 2010 spec the value
   1574 * is XYZ(0.9642,1.0,0.8249), which scales to:
   1575 *
   1576 *    (63189.8112, 65536, 54060.6464)
   1577 */
   1578 static const png_byte D50_nCIEXYZ[12] =
   1579   { 0x00, 0x00, 0xf6, 0xd6, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0xd3, 0x2d };
   1580 
   1581 static int /* bool */
   1582 icc_check_length(png_const_structrp png_ptr, png_const_charp name,
   1583   png_uint_32 profile_length)
   1584 {
   1585   if (profile_length < 132)
   1586      return png_icc_profile_error(png_ptr, name, profile_length, "too short");
   1587   return 1;
   1588 }
   1589 
   1590 int /* PRIVATE */
   1591 png_icc_check_length(png_const_structrp png_ptr, png_const_charp name,
   1592   png_uint_32 profile_length)
   1593 {
   1594   if (!icc_check_length(png_ptr, name, profile_length))
   1595      return 0;
   1596 
   1597   /* This needs to be here because the 'normal' check is in
   1598    * png_decompress_chunk, yet this happens after the attempt to
   1599    * png_malloc_base the required data.  We only need this on read; on write
   1600    * the caller supplies the profile buffer so libpng doesn't allocate it.  See
   1601    * the call to icc_check_length below (the write case).
   1602    */
   1603   if (profile_length > png_chunk_max(png_ptr))
   1604      return png_icc_profile_error(png_ptr, name, profile_length,
   1605            "profile too long");
   1606 
   1607   return 1;
   1608 }
   1609 
   1610 int /* PRIVATE */
   1611 png_icc_check_header(png_const_structrp png_ptr, png_const_charp name,
   1612   png_uint_32 profile_length,
   1613   png_const_bytep profile/* first 132 bytes only */, int color_type)
   1614 {
   1615   png_uint_32 temp;
   1616 
   1617   /* Length check; this cannot be ignored in this code because profile_length
   1618    * is used later to check the tag table, so even if the profile seems over
   1619    * long profile_length from the caller must be correct.  The caller can fix
   1620    * this up on read or write by just passing in the profile header length.
   1621    */
   1622   temp = png_get_uint_32(profile);
   1623   if (temp != profile_length)
   1624      return png_icc_profile_error(png_ptr, name, temp,
   1625          "length does not match profile");
   1626 
   1627   temp = (png_uint_32) (*(profile+8));
   1628   if (temp > 3 && (profile_length & 3))
   1629      return png_icc_profile_error(png_ptr, name, profile_length,
   1630          "invalid length");
   1631 
   1632   temp = png_get_uint_32(profile+128); /* tag count: 12 bytes/tag */
   1633   if (temp > 357913930 || /* (2^32-4-132)/12: maximum possible tag count */
   1634      profile_length < 132+12*temp) /* truncated tag table */
   1635      return png_icc_profile_error(png_ptr, name, temp,
   1636          "tag count too large");
   1637 
   1638   /* The 'intent' must be valid or we can't store it, ICC limits the intent to
   1639    * 16 bits.
   1640    */
   1641   temp = png_get_uint_32(profile+64);
   1642   if (temp >= 0xffff) /* The ICC limit */
   1643      return png_icc_profile_error(png_ptr, name, temp,
   1644          "invalid rendering intent");
   1645 
   1646   /* This is just a warning because the profile may be valid in future
   1647    * versions.
   1648    */
   1649   if (temp >= PNG_sRGB_INTENT_LAST)
   1650      (void)png_icc_profile_error(png_ptr, name, temp,
   1651          "intent outside defined range");
   1652 
   1653   /* At this point the tag table can't be checked because it hasn't necessarily
   1654    * been loaded; however, various header fields can be checked.  These checks
   1655    * are for values permitted by the PNG spec in an ICC profile; the PNG spec
   1656    * restricts the profiles that can be passed in an iCCP chunk (they must be
   1657    * appropriate to processing PNG data!)
   1658    */
   1659 
   1660   /* Data checks (could be skipped).  These checks must be independent of the
   1661    * version number; however, the version number doesn't accommodate changes in
   1662    * the header fields (just the known tags and the interpretation of the
   1663    * data.)
   1664    */
   1665   temp = png_get_uint_32(profile+36); /* signature 'ascp' */
   1666   if (temp != 0x61637370)
   1667      return png_icc_profile_error(png_ptr, name, temp,
   1668          "invalid signature");
   1669 
   1670   /* Currently the PCS illuminant/adopted white point (the computational
   1671    * white point) are required to be D50,
   1672    * however the profile contains a record of the illuminant so perhaps ICC
   1673    * expects to be able to change this in the future (despite the rationale in
   1674    * the introduction for using a fixed PCS adopted white.)  Consequently the
   1675    * following is just a warning.
   1676    */
   1677   if (memcmp(profile+68, D50_nCIEXYZ, 12) != 0)
   1678      (void)png_icc_profile_error(png_ptr, name, 0/*no tag value*/,
   1679          "PCS illuminant is not D50");
   1680 
   1681   /* The PNG spec requires this:
   1682    * "If the iCCP chunk is present, the image samples conform to the colour
   1683    * space represented by the embedded ICC profile as defined by the
   1684    * International Color Consortium [ICC]. The colour space of the ICC profile
   1685    * shall be an RGB colour space for colour images (PNG colour types 2, 3, and
   1686    * 6), or a greyscale colour space for greyscale images (PNG colour types 0
   1687    * and 4)."
   1688    *
   1689    * This checking code ensures the embedded profile (on either read or write)
   1690    * conforms to the specification requirements.  Notice that an ICC 'gray'
   1691    * color-space profile contains the information to transform the monochrome
   1692    * data to XYZ or L*a*b (according to which PCS the profile uses) and this
   1693    * should be used in preference to the standard libpng K channel replication
   1694    * into R, G and B channels.
   1695    *
   1696    * Previously it was suggested that an RGB profile on grayscale data could be
   1697    * handled.  However it it is clear that using an RGB profile in this context
   1698    * must be an error - there is no specification of what it means.  Thus it is
   1699    * almost certainly more correct to ignore the profile.
   1700    */
   1701   temp = png_get_uint_32(profile+16); /* data colour space field */
   1702   switch (temp)
   1703   {
   1704      case 0x52474220: /* 'RGB ' */
   1705         if ((color_type & PNG_COLOR_MASK_COLOR) == 0)
   1706            return png_icc_profile_error(png_ptr, name, temp,
   1707                "RGB color space not permitted on grayscale PNG");
   1708         break;
   1709 
   1710      case 0x47524159: /* 'GRAY' */
   1711         if ((color_type & PNG_COLOR_MASK_COLOR) != 0)
   1712            return png_icc_profile_error(png_ptr, name, temp,
   1713                "Gray color space not permitted on RGB PNG");
   1714         break;
   1715 
   1716      default:
   1717         return png_icc_profile_error(png_ptr, name, temp,
   1718             "invalid ICC profile color space");
   1719   }
   1720 
   1721   /* It is up to the application to check that the profile class matches the
   1722    * application requirements; the spec provides no guidance, but it's pretty
   1723    * weird if the profile is not scanner ('scnr'), monitor ('mntr'), printer
   1724    * ('prtr') or 'spac' (for generic color spaces).  Issue a warning in these
   1725    * cases.  Issue an error for device link or abstract profiles - these don't
   1726    * contain the records necessary to transform the color-space to anything
   1727    * other than the target device (and not even that for an abstract profile).
   1728    * Profiles of these classes may not be embedded in images.
   1729    */
   1730   temp = png_get_uint_32(profile+12); /* profile/device class */
   1731   switch (temp)
   1732   {
   1733      case 0x73636e72: /* 'scnr' */
   1734      case 0x6d6e7472: /* 'mntr' */
   1735      case 0x70727472: /* 'prtr' */
   1736      case 0x73706163: /* 'spac' */
   1737         /* All supported */
   1738         break;
   1739 
   1740      case 0x61627374: /* 'abst' */
   1741         /* May not be embedded in an image */
   1742         return png_icc_profile_error(png_ptr, name, temp,
   1743             "invalid embedded Abstract ICC profile");
   1744 
   1745      case 0x6c696e6b: /* 'link' */
   1746         /* DeviceLink profiles cannot be interpreted in a non-device specific
   1747          * fashion, if an app uses the AToB0Tag in the profile the results are
   1748          * undefined unless the result is sent to the intended device,
   1749          * therefore a DeviceLink profile should not be found embedded in a
   1750          * PNG.
   1751          */
   1752         return png_icc_profile_error(png_ptr, name, temp,
   1753             "unexpected DeviceLink ICC profile class");
   1754 
   1755      case 0x6e6d636c: /* 'nmcl' */
   1756         /* A NamedColor profile is also device specific, however it doesn't
   1757          * contain an AToB0 tag that is open to misinterpretation.  Almost
   1758          * certainly it will fail the tests below.
   1759          */
   1760         (void)png_icc_profile_error(png_ptr, name, temp,
   1761             "unexpected NamedColor ICC profile class");
   1762         break;
   1763 
   1764      default:
   1765         /* To allow for future enhancements to the profile accept unrecognized
   1766          * profile classes with a warning, these then hit the test below on the
   1767          * tag content to ensure they are backward compatible with one of the
   1768          * understood profiles.
   1769          */
   1770         (void)png_icc_profile_error(png_ptr, name, temp,
   1771             "unrecognized ICC profile class");
   1772         break;
   1773   }
   1774 
   1775   /* For any profile other than a device link one the PCS must be encoded
   1776    * either in XYZ or Lab.
   1777    */
   1778   temp = png_get_uint_32(profile+20);
   1779   switch (temp)
   1780   {
   1781      case 0x58595a20: /* 'XYZ ' */
   1782      case 0x4c616220: /* 'Lab ' */
   1783         break;
   1784 
   1785      default:
   1786         return png_icc_profile_error(png_ptr, name, temp,
   1787             "unexpected ICC PCS encoding");
   1788   }
   1789 
   1790   return 1;
   1791 }
   1792 
   1793 int /* PRIVATE */
   1794 png_icc_check_tag_table(png_const_structrp png_ptr, png_const_charp name,
   1795   png_uint_32 profile_length,
   1796   png_const_bytep profile /* header plus whole tag table */)
   1797 {
   1798   png_uint_32 tag_count = png_get_uint_32(profile+128);
   1799   png_uint_32 itag;
   1800   png_const_bytep tag = profile+132; /* The first tag */
   1801 
   1802   /* First scan all the tags in the table and add bits to the icc_info value
   1803    * (temporarily in 'tags').
   1804    */
   1805   for (itag=0; itag < tag_count; ++itag, tag += 12)
   1806   {
   1807      png_uint_32 tag_id = png_get_uint_32(tag+0);
   1808      png_uint_32 tag_start = png_get_uint_32(tag+4); /* must be aligned */
   1809      png_uint_32 tag_length = png_get_uint_32(tag+8);/* not padded */
   1810 
   1811      /* The ICC specification does not exclude zero length tags, therefore the
   1812       * start might actually be anywhere if there is no data, but this would be
   1813       * a clear abuse of the intent of the standard so the start is checked for
   1814       * being in range.  All defined tag types have an 8 byte header - a 4 byte
   1815       * type signature then 0.
   1816       */
   1817 
   1818      /* This is a hard error; potentially it can cause read outside the
   1819       * profile.
   1820       */
   1821      if (tag_start > profile_length || tag_length > profile_length - tag_start)
   1822         return png_icc_profile_error(png_ptr, name, tag_id,
   1823             "ICC profile tag outside profile");
   1824 
   1825      if ((tag_start & 3) != 0)
   1826      {
   1827         /* CNHP730S.icc shipped with Microsoft Windows 64 violates this; it is
   1828          * only a warning here because libpng does not care about the
   1829          * alignment.
   1830          */
   1831         (void)png_icc_profile_error(png_ptr, name, tag_id,
   1832             "ICC profile tag start not a multiple of 4");
   1833      }
   1834   }
   1835 
   1836   return 1; /* success, maybe with warnings */
   1837 }
   1838 #endif /* READ_iCCP */
   1839 
   1840 #ifdef PNG_READ_RGB_TO_GRAY_SUPPORTED
   1841 #if (defined PNG_READ_mDCV_SUPPORTED) || (defined PNG_READ_cHRM_SUPPORTED)
   1842 static int
   1843 have_chromaticities(png_const_structrp png_ptr)
   1844 {
   1845   /* Handle new PNGv3 chunks and the precedence rules to determine whether
   1846    * png_struct::chromaticities must be processed.  Only required for RGB to
   1847    * gray.
   1848    *
   1849    * mDCV: this is the mastering colour space and it is independent of the
   1850    *       encoding so it needs to be used regardless of the encoded space.
   1851    *
   1852    * cICP: first in priority but not yet implemented - the chromaticities come
   1853    *       from the 'primaries'.
   1854    *
   1855    * iCCP: not supported by libpng (so ignored)
   1856    *
   1857    * sRGB: the defaults match sRGB
   1858    *
   1859    * cHRM: calculate the coefficients
   1860    */
   1861 #  ifdef PNG_READ_mDCV_SUPPORTED
   1862      if (png_has_chunk(png_ptr, mDCV))
   1863         return 1;
   1864 #     define check_chromaticities 1
   1865 #  endif /*mDCV*/
   1866 
   1867 #  ifdef PNG_READ_sRGB_SUPPORTED
   1868      if (png_has_chunk(png_ptr, sRGB))
   1869         return 0;
   1870 #  endif /*sRGB*/
   1871 
   1872 #  ifdef PNG_READ_cHRM_SUPPORTED
   1873      if (png_has_chunk(png_ptr, cHRM))
   1874         return 1;
   1875 #     define check_chromaticities 1
   1876 #  endif /*cHRM*/
   1877 
   1878   return 0; /* sRGB defaults */
   1879 }
   1880 #endif /* READ_mDCV || READ_cHRM */
   1881 
   1882 void /* PRIVATE */
   1883 png_set_rgb_coefficients(png_structrp png_ptr)
   1884 {
   1885   /* Set the rgb_to_gray coefficients from the colorspace if available.  Note
   1886    * that '_set' means that png_rgb_to_gray was called **and** it successfully
   1887    * set up the coefficients.
   1888    */
   1889   if (png_ptr->rgb_to_gray_coefficients_set == 0)
   1890   {
   1891 #  if check_chromaticities
   1892      png_XYZ xyz;
   1893 
   1894      if (have_chromaticities(png_ptr) &&
   1895          png_XYZ_from_xy(&xyz, &png_ptr->chromaticities) == 0)
   1896      {
   1897         /* png_set_rgb_to_gray has not set the coefficients, get them from the
   1898          * Y * values of the colorspace colorants.
   1899          */
   1900         png_fixed_point r = xyz.red_Y;
   1901         png_fixed_point g = xyz.green_Y;
   1902         png_fixed_point b = xyz.blue_Y;
   1903         png_fixed_point total = r+g+b;
   1904 
   1905         if (total > 0 &&
   1906            r >= 0 && png_muldiv(&r, r, 32768, total) && r >= 0 && r <= 32768 &&
   1907            g >= 0 && png_muldiv(&g, g, 32768, total) && g >= 0 && g <= 32768 &&
   1908            b >= 0 && png_muldiv(&b, b, 32768, total) && b >= 0 && b <= 32768 &&
   1909            r+g+b <= 32769)
   1910         {
   1911            /* We allow 0 coefficients here.  r+g+b may be 32769 if two or
   1912             * all of the coefficients were rounded up.  Handle this by
   1913             * reducing the *largest* coefficient by 1; this matches the
   1914             * approach used for the default coefficients in pngrtran.c
   1915             */
   1916            int add = 0;
   1917 
   1918            if (r+g+b > 32768)
   1919               add = -1;
   1920            else if (r+g+b < 32768)
   1921               add = 1;
   1922 
   1923            if (add != 0)
   1924            {
   1925               if (g >= r && g >= b)
   1926                  g += add;
   1927               else if (r >= g && r >= b)
   1928                  r += add;
   1929               else
   1930                  b += add;
   1931            }
   1932 
   1933            /* Check for an internal error. */
   1934            if (r+g+b != 32768)
   1935               png_error(png_ptr,
   1936                   "internal error handling cHRM coefficients");
   1937 
   1938            else
   1939            {
   1940               png_ptr->rgb_to_gray_red_coeff   = (png_uint_16)r;
   1941               png_ptr->rgb_to_gray_green_coeff = (png_uint_16)g;
   1942            }
   1943         }
   1944      }
   1945      else
   1946 #  endif /* check_chromaticities */
   1947      {
   1948         /* Use the historical REC 709 (etc) values: */
   1949         png_ptr->rgb_to_gray_red_coeff   = 6968;
   1950         png_ptr->rgb_to_gray_green_coeff = 23434;
   1951         /* png_ptr->rgb_to_gray_blue_coeff  = 2366; */
   1952      }
   1953   }
   1954 }
   1955 #endif /* READ_RGB_TO_GRAY */
   1956 
   1957 void /* PRIVATE */
   1958 png_check_IHDR(png_const_structrp png_ptr,
   1959    png_uint_32 width, png_uint_32 height, int bit_depth,
   1960    int color_type, int interlace_type, int compression_type,
   1961    int filter_type)
   1962 {
   1963   int error = 0;
   1964 
   1965   /* Check for width and height valid values */
   1966   if (width == 0)
   1967   {
   1968      png_warning(png_ptr, "Image width is zero in IHDR");
   1969      error = 1;
   1970   }
   1971 
   1972   if (width > PNG_UINT_31_MAX)
   1973   {
   1974      png_warning(png_ptr, "Invalid image width in IHDR");
   1975      error = 1;
   1976   }
   1977 
   1978   /* The bit mask on the first line below must be at least as big as a
   1979    * png_uint_32.  "~7U" is not adequate on 16-bit systems because it will
   1980    * be an unsigned 16-bit value.  Casting to (png_alloc_size_t) makes the
   1981    * type of the result at least as bit (in bits) as the RHS of the > operator
   1982    * which also avoids a common warning on 64-bit systems that the comparison
   1983    * of (png_uint_32) against the constant value on the RHS will always be
   1984    * false.
   1985    */
   1986   if (((width + 7) & ~(png_alloc_size_t)7) >
   1987       (((PNG_SIZE_MAX
   1988           - 48        /* big_row_buf hack */
   1989           - 1)        /* filter byte */
   1990           / 8)        /* 8-byte RGBA pixels */
   1991           - 1))       /* extra max_pixel_depth pad */
   1992   {
   1993      /* The size of the row must be within the limits of this architecture.
   1994       * Because the read code can perform arbitrary transformations the
   1995       * maximum size is checked here.  Because the code in png_read_start_row
   1996       * adds extra space "for safety's sake" in several places a conservative
   1997       * limit is used here.
   1998       *
   1999       * NOTE: it would be far better to check the size that is actually used,
   2000       * but the effect in the real world is minor and the changes are more
   2001       * extensive, therefore much more dangerous and much more difficult to
   2002       * write in a way that avoids compiler warnings.
   2003       */
   2004      png_warning(png_ptr, "Image width is too large for this architecture");
   2005      error = 1;
   2006   }
   2007 
   2008 #ifdef PNG_SET_USER_LIMITS_SUPPORTED
   2009   if (width > png_ptr->user_width_max)
   2010 #else
   2011   if (width > PNG_USER_WIDTH_MAX)
   2012 #endif
   2013   {
   2014      png_warning(png_ptr, "Image width exceeds user limit in IHDR");
   2015      error = 1;
   2016   }
   2017 
   2018   if (height == 0)
   2019   {
   2020      png_warning(png_ptr, "Image height is zero in IHDR");
   2021      error = 1;
   2022   }
   2023 
   2024   if (height > PNG_UINT_31_MAX)
   2025   {
   2026      png_warning(png_ptr, "Invalid image height in IHDR");
   2027      error = 1;
   2028   }
   2029 
   2030 #ifdef PNG_SET_USER_LIMITS_SUPPORTED
   2031   if (height > png_ptr->user_height_max)
   2032 #else
   2033   if (height > PNG_USER_HEIGHT_MAX)
   2034 #endif
   2035   {
   2036      png_warning(png_ptr, "Image height exceeds user limit in IHDR");
   2037      error = 1;
   2038   }
   2039 
   2040   /* Check other values */
   2041   if (bit_depth != 1 && bit_depth != 2 && bit_depth != 4 &&
   2042       bit_depth != 8 && bit_depth != 16)
   2043   {
   2044      png_warning(png_ptr, "Invalid bit depth in IHDR");
   2045      error = 1;
   2046   }
   2047 
   2048   if (color_type < 0 || color_type == 1 ||
   2049       color_type == 5 || color_type > 6)
   2050   {
   2051      png_warning(png_ptr, "Invalid color type in IHDR");
   2052      error = 1;
   2053   }
   2054 
   2055   if (((color_type == PNG_COLOR_TYPE_PALETTE) && bit_depth > 8) ||
   2056       ((color_type == PNG_COLOR_TYPE_RGB ||
   2057         color_type == PNG_COLOR_TYPE_GRAY_ALPHA ||
   2058         color_type == PNG_COLOR_TYPE_RGB_ALPHA) && bit_depth < 8))
   2059   {
   2060      png_warning(png_ptr, "Invalid color type/bit depth combination in IHDR");
   2061      error = 1;
   2062   }
   2063 
   2064   if (interlace_type >= PNG_INTERLACE_LAST)
   2065   {
   2066      png_warning(png_ptr, "Unknown interlace method in IHDR");
   2067      error = 1;
   2068   }
   2069 
   2070   if (compression_type != PNG_COMPRESSION_TYPE_BASE)
   2071   {
   2072      png_warning(png_ptr, "Unknown compression method in IHDR");
   2073      error = 1;
   2074   }
   2075 
   2076 #ifdef PNG_MNG_FEATURES_SUPPORTED
   2077   /* Accept filter_method 64 (intrapixel differencing) only if
   2078    * 1. Libpng was compiled with PNG_MNG_FEATURES_SUPPORTED and
   2079    * 2. Libpng did not read a PNG signature (this filter_method is only
   2080    *    used in PNG datastreams that are embedded in MNG datastreams) and
   2081    * 3. The application called png_permit_mng_features with a mask that
   2082    *    included PNG_FLAG_MNG_FILTER_64 and
   2083    * 4. The filter_method is 64 and
   2084    * 5. The color_type is RGB or RGBA
   2085    */
   2086   if ((png_ptr->mode & PNG_HAVE_PNG_SIGNATURE) != 0 &&
   2087       png_ptr->mng_features_permitted != 0)
   2088      png_warning(png_ptr, "MNG features are not allowed in a PNG datastream");
   2089 
   2090   if (filter_type != PNG_FILTER_TYPE_BASE)
   2091   {
   2092      if (!((png_ptr->mng_features_permitted & PNG_FLAG_MNG_FILTER_64) != 0 &&
   2093          (filter_type == PNG_INTRAPIXEL_DIFFERENCING) &&
   2094          ((png_ptr->mode & PNG_HAVE_PNG_SIGNATURE) == 0) &&
   2095          (color_type == PNG_COLOR_TYPE_RGB ||
   2096          color_type == PNG_COLOR_TYPE_RGB_ALPHA)))
   2097      {
   2098         png_warning(png_ptr, "Unknown filter method in IHDR");
   2099         error = 1;
   2100      }
   2101 
   2102      if ((png_ptr->mode & PNG_HAVE_PNG_SIGNATURE) != 0)
   2103      {
   2104         png_warning(png_ptr, "Invalid filter method in IHDR");
   2105         error = 1;
   2106      }
   2107   }
   2108 
   2109 #else
   2110   if (filter_type != PNG_FILTER_TYPE_BASE)
   2111   {
   2112      png_warning(png_ptr, "Unknown filter method in IHDR");
   2113      error = 1;
   2114   }
   2115 #endif
   2116 
   2117   if (error == 1)
   2118      png_error(png_ptr, "Invalid IHDR data");
   2119 }
   2120 
   2121 #if defined(PNG_sCAL_SUPPORTED) || defined(PNG_pCAL_SUPPORTED)
   2122 /* ASCII to fp functions */
   2123 /* Check an ASCII formatted floating point value, see the more detailed
   2124 * comments in pngpriv.h
   2125 */
   2126 /* The following is used internally to preserve the sticky flags */
   2127 #define png_fp_add(state, flags) ((state) |= (flags))
   2128 #define png_fp_set(state, value) ((state) = (value) | ((state) & PNG_FP_STICKY))
   2129 
   2130 int /* PRIVATE */
   2131 png_check_fp_number(png_const_charp string, size_t size, int *statep,
   2132    size_t *whereami)
   2133 {
   2134   int state = *statep;
   2135   size_t i = *whereami;
   2136 
   2137   while (i < size)
   2138   {
   2139      int type;
   2140      /* First find the type of the next character */
   2141      switch (string[i])
   2142      {
   2143      case 43:  type = PNG_FP_SAW_SIGN;                   break;
   2144      case 45:  type = PNG_FP_SAW_SIGN + PNG_FP_NEGATIVE; break;
   2145      case 46:  type = PNG_FP_SAW_DOT;                    break;
   2146      case 48:  type = PNG_FP_SAW_DIGIT;                  break;
   2147      case 49: case 50: case 51: case 52:
   2148      case 53: case 54: case 55: case 56:
   2149      case 57:  type = PNG_FP_SAW_DIGIT + PNG_FP_NONZERO; break;
   2150      case 69:
   2151      case 101: type = PNG_FP_SAW_E;                      break;
   2152      default:  goto PNG_FP_End;
   2153      }
   2154 
   2155      /* Now deal with this type according to the current
   2156       * state, the type is arranged to not overlap the
   2157       * bits of the PNG_FP_STATE.
   2158       */
   2159      switch ((state & PNG_FP_STATE) + (type & PNG_FP_SAW_ANY))
   2160      {
   2161      case PNG_FP_INTEGER + PNG_FP_SAW_SIGN:
   2162         if ((state & PNG_FP_SAW_ANY) != 0)
   2163            goto PNG_FP_End; /* not a part of the number */
   2164 
   2165         png_fp_add(state, type);
   2166         break;
   2167 
   2168      case PNG_FP_INTEGER + PNG_FP_SAW_DOT:
   2169         /* Ok as trailer, ok as lead of fraction. */
   2170         if ((state & PNG_FP_SAW_DOT) != 0) /* two dots */
   2171            goto PNG_FP_End;
   2172 
   2173         else if ((state & PNG_FP_SAW_DIGIT) != 0) /* trailing dot? */
   2174            png_fp_add(state, type);
   2175 
   2176         else
   2177            png_fp_set(state, PNG_FP_FRACTION | type);
   2178 
   2179         break;
   2180 
   2181      case PNG_FP_INTEGER + PNG_FP_SAW_DIGIT:
   2182         if ((state & PNG_FP_SAW_DOT) != 0) /* delayed fraction */
   2183            png_fp_set(state, PNG_FP_FRACTION | PNG_FP_SAW_DOT);
   2184 
   2185         png_fp_add(state, type | PNG_FP_WAS_VALID);
   2186 
   2187         break;
   2188 
   2189      case PNG_FP_INTEGER + PNG_FP_SAW_E:
   2190         if ((state & PNG_FP_SAW_DIGIT) == 0)
   2191            goto PNG_FP_End;
   2192 
   2193         png_fp_set(state, PNG_FP_EXPONENT);
   2194 
   2195         break;
   2196 
   2197   /* case PNG_FP_FRACTION + PNG_FP_SAW_SIGN:
   2198         goto PNG_FP_End; ** no sign in fraction */
   2199 
   2200   /* case PNG_FP_FRACTION + PNG_FP_SAW_DOT:
   2201         goto PNG_FP_End; ** Because SAW_DOT is always set */
   2202 
   2203      case PNG_FP_FRACTION + PNG_FP_SAW_DIGIT:
   2204         png_fp_add(state, type | PNG_FP_WAS_VALID);
   2205         break;
   2206 
   2207      case PNG_FP_FRACTION + PNG_FP_SAW_E:
   2208         /* This is correct because the trailing '.' on an
   2209          * integer is handled above - so we can only get here
   2210          * with the sequence ".E" (with no preceding digits).
   2211          */
   2212         if ((state & PNG_FP_SAW_DIGIT) == 0)
   2213            goto PNG_FP_End;
   2214 
   2215         png_fp_set(state, PNG_FP_EXPONENT);
   2216 
   2217         break;
   2218 
   2219      case PNG_FP_EXPONENT + PNG_FP_SAW_SIGN:
   2220         if ((state & PNG_FP_SAW_ANY) != 0)
   2221            goto PNG_FP_End; /* not a part of the number */
   2222 
   2223         png_fp_add(state, PNG_FP_SAW_SIGN);
   2224 
   2225         break;
   2226 
   2227   /* case PNG_FP_EXPONENT + PNG_FP_SAW_DOT:
   2228         goto PNG_FP_End; */
   2229 
   2230      case PNG_FP_EXPONENT + PNG_FP_SAW_DIGIT:
   2231         png_fp_add(state, PNG_FP_SAW_DIGIT | PNG_FP_WAS_VALID);
   2232 
   2233         break;
   2234 
   2235   /* case PNG_FP_EXPONEXT + PNG_FP_SAW_E:
   2236         goto PNG_FP_End; */
   2237 
   2238      default: goto PNG_FP_End; /* I.e. break 2 */
   2239      }
   2240 
   2241      /* The character seems ok, continue. */
   2242      ++i;
   2243   }
   2244 
   2245 PNG_FP_End:
   2246   /* Here at the end, update the state and return the correct
   2247    * return code.
   2248    */
   2249   *statep = state;
   2250   *whereami = i;
   2251 
   2252   return (state & PNG_FP_SAW_DIGIT) != 0;
   2253 }
   2254 
   2255 
   2256 /* The same but for a complete string. */
   2257 int
   2258 png_check_fp_string(png_const_charp string, size_t size)
   2259 {
   2260   int        state=0;
   2261   size_t char_index=0;
   2262 
   2263   if (png_check_fp_number(string, size, &state, &char_index) != 0 &&
   2264      (char_index == size || string[char_index] == 0))
   2265      return state /* must be non-zero - see above */;
   2266 
   2267   return 0; /* i.e. fail */
   2268 }
   2269 #endif /* pCAL || sCAL */
   2270 
   2271 #ifdef PNG_sCAL_SUPPORTED
   2272 #  ifdef PNG_FLOATING_POINT_SUPPORTED
   2273 /* Utility used below - a simple accurate power of ten from an integral
   2274 * exponent.
   2275 */
   2276 static double
   2277 png_pow10(int power)
   2278 {
   2279   int recip = 0;
   2280   double d = 1;
   2281 
   2282   /* Handle negative exponent with a reciprocal at the end because
   2283    * 10 is exact whereas .1 is inexact in base 2
   2284    */
   2285   if (power < 0)
   2286   {
   2287      if (power < DBL_MIN_10_EXP) return 0;
   2288      recip = 1; power = -power;
   2289   }
   2290 
   2291   if (power > 0)
   2292   {
   2293      /* Decompose power bitwise. */
   2294      double mult = 10;
   2295      do
   2296      {
   2297         if (power & 1) d *= mult;
   2298         mult *= mult;
   2299         power >>= 1;
   2300      }
   2301      while (power > 0);
   2302 
   2303      if (recip != 0) d = 1/d;
   2304   }
   2305   /* else power is 0 and d is 1 */
   2306 
   2307   return d;
   2308 }
   2309 
   2310 /* Function to format a floating point value in ASCII with a given
   2311 * precision.
   2312 */
   2313 void /* PRIVATE */
   2314 png_ascii_from_fp(png_const_structrp png_ptr, png_charp ascii, size_t size,
   2315    double fp, unsigned int precision)
   2316 {
   2317   /* We use standard functions from math.h, but not printf because
   2318    * that would require stdio.  The caller must supply a buffer of
   2319    * sufficient size or we will png_error.  The tests on size and
   2320    * the space in ascii[] consumed are indicated below.
   2321    */
   2322   if (precision < 1)
   2323      precision = DBL_DIG;
   2324 
   2325   /* Enforce the limit of the implementation precision too. */
   2326   if (precision > DBL_DIG+1)
   2327      precision = DBL_DIG+1;
   2328 
   2329   /* Basic sanity checks */
   2330   if (size >= precision+5) /* See the requirements below. */
   2331   {
   2332      if (fp < 0)
   2333      {
   2334         fp = -fp;
   2335         *ascii++ = 45; /* '-'  PLUS 1 TOTAL 1 */
   2336         --size;
   2337      }
   2338 
   2339      if (fp >= DBL_MIN && fp <= DBL_MAX)
   2340      {
   2341         int exp_b10;   /* A base 10 exponent */
   2342         double base;   /* 10^exp_b10 */
   2343 
   2344         /* First extract a base 10 exponent of the number,
   2345          * the calculation below rounds down when converting
   2346          * from base 2 to base 10 (multiply by log10(2) -
   2347          * 0.3010, but 77/256 is 0.3008, so exp_b10 needs to
   2348          * be increased.  Note that the arithmetic shift
   2349          * performs a floor() unlike C arithmetic - using a
   2350          * C multiply would break the following for negative
   2351          * exponents.
   2352          */
   2353         (void)frexp(fp, &exp_b10); /* exponent to base 2 */
   2354 
   2355         exp_b10 = (exp_b10 * 77) >> 8; /* <= exponent to base 10 */
   2356 
   2357         /* Avoid underflow here. */
   2358         base = png_pow10(exp_b10); /* May underflow */
   2359 
   2360         while (base < DBL_MIN || base < fp)
   2361         {
   2362            /* And this may overflow. */
   2363            double test = png_pow10(exp_b10+1);
   2364 
   2365            if (test <= DBL_MAX)
   2366            {
   2367               ++exp_b10; base = test;
   2368            }
   2369 
   2370            else
   2371               break;
   2372         }
   2373 
   2374         /* Normalize fp and correct exp_b10, after this fp is in the
   2375          * range [.1,1) and exp_b10 is both the exponent and the digit
   2376          * *before* which the decimal point should be inserted
   2377          * (starting with 0 for the first digit).  Note that this
   2378          * works even if 10^exp_b10 is out of range because of the
   2379          * test on DBL_MAX above.
   2380          */
   2381         fp /= base;
   2382         while (fp >= 1)
   2383         {
   2384            fp /= 10; ++exp_b10;
   2385         }
   2386 
   2387         /* Because of the code above fp may, at this point, be
   2388          * less than .1, this is ok because the code below can
   2389          * handle the leading zeros this generates, so no attempt
   2390          * is made to correct that here.
   2391          */
   2392 
   2393         {
   2394            unsigned int czero, clead, cdigits;
   2395            char exponent[10];
   2396 
   2397            /* Allow up to two leading zeros - this will not lengthen
   2398             * the number compared to using E-n.
   2399             */
   2400            if (exp_b10 < 0 && exp_b10 > -3) /* PLUS 3 TOTAL 4 */
   2401            {
   2402               czero = 0U-exp_b10; /* PLUS 2 digits: TOTAL 3 */
   2403               exp_b10 = 0;      /* Dot added below before first output. */
   2404            }
   2405            else
   2406               czero = 0;    /* No zeros to add */
   2407 
   2408            /* Generate the digit list, stripping trailing zeros and
   2409             * inserting a '.' before a digit if the exponent is 0.
   2410             */
   2411            clead = czero; /* Count of leading zeros */
   2412            cdigits = 0;   /* Count of digits in list. */
   2413 
   2414            do
   2415            {
   2416               double d;
   2417 
   2418               fp *= 10;
   2419               /* Use modf here, not floor and subtract, so that
   2420                * the separation is done in one step.  At the end
   2421                * of the loop don't break the number into parts so
   2422                * that the final digit is rounded.
   2423                */
   2424               if (cdigits+czero+1 < precision+clead)
   2425                  fp = modf(fp, &d);
   2426 
   2427               else
   2428               {
   2429                  d = floor(fp + .5);
   2430 
   2431                  if (d > 9)
   2432                  {
   2433                     /* Rounding up to 10, handle that here. */
   2434                     if (czero > 0)
   2435                     {
   2436                        --czero; d = 1;
   2437                        if (cdigits == 0) --clead;
   2438                     }
   2439                     else
   2440                     {
   2441                        while (cdigits > 0 && d > 9)
   2442                        {
   2443                           int ch = *--ascii;
   2444 
   2445                           if (exp_b10 != (-1))
   2446                              ++exp_b10;
   2447 
   2448                           else if (ch == 46)
   2449                           {
   2450                              ch = *--ascii; ++size;
   2451                              /* Advance exp_b10 to '1', so that the
   2452                               * decimal point happens after the
   2453                               * previous digit.
   2454                               */
   2455                              exp_b10 = 1;
   2456                           }
   2457 
   2458                           --cdigits;
   2459                           d = ch - 47;  /* I.e. 1+(ch-48) */
   2460                        }
   2461 
   2462                        /* Did we reach the beginning? If so adjust the
   2463                         * exponent but take into account the leading
   2464                         * decimal point.
   2465                         */
   2466                        if (d > 9)  /* cdigits == 0 */
   2467                        {
   2468                           if (exp_b10 == (-1))
   2469                           {
   2470                              /* Leading decimal point (plus zeros?), if
   2471                               * we lose the decimal point here it must
   2472                               * be reentered below.
   2473                               */
   2474                              int ch = *--ascii;
   2475 
   2476                              if (ch == 46)
   2477                              {
   2478                                 ++size; exp_b10 = 1;
   2479                              }
   2480 
   2481                              /* Else lost a leading zero, so 'exp_b10' is
   2482                               * still ok at (-1)
   2483                               */
   2484                           }
   2485                           else
   2486                              ++exp_b10;
   2487 
   2488                           /* In all cases we output a '1' */
   2489                           d = 1;
   2490                        }
   2491                     }
   2492                  }
   2493                  fp = 0; /* Guarantees termination below. */
   2494               }
   2495 
   2496               if (d == 0)
   2497               {
   2498                  ++czero;
   2499                  if (cdigits == 0) ++clead;
   2500               }
   2501               else
   2502               {
   2503                  /* Included embedded zeros in the digit count. */
   2504                  cdigits += czero - clead;
   2505                  clead = 0;
   2506 
   2507                  while (czero > 0)
   2508                  {
   2509                     /* exp_b10 == (-1) means we just output the decimal
   2510                      * place - after the DP don't adjust 'exp_b10' any
   2511                      * more!
   2512                      */
   2513                     if (exp_b10 != (-1))
   2514                     {
   2515                        if (exp_b10 == 0)
   2516                        {
   2517                           *ascii++ = 46; --size;
   2518                        }
   2519                        /* PLUS 1: TOTAL 4 */
   2520                        --exp_b10;
   2521                     }
   2522                     *ascii++ = 48; --czero;
   2523                  }
   2524 
   2525                  if (exp_b10 != (-1))
   2526                  {
   2527                     if (exp_b10 == 0)
   2528                     {
   2529                        *ascii++ = 46; --size; /* counted above */
   2530                     }
   2531 
   2532                     --exp_b10;
   2533                  }
   2534                  *ascii++ = (char)(48 + (int)d); ++cdigits;
   2535               }
   2536            }
   2537            while (cdigits+czero < precision+clead && fp > DBL_MIN);
   2538 
   2539            /* The total output count (max) is now 4+precision */
   2540 
   2541            /* Check for an exponent, if we don't need one we are
   2542             * done and just need to terminate the string.  At this
   2543             * point, exp_b10==(-1) is effectively a flag: it got
   2544             * to '-1' because of the decrement, after outputting
   2545             * the decimal point above. (The exponent required is
   2546             * *not* -1.)
   2547             */
   2548            if (exp_b10 >= (-1) && exp_b10 <= 2)
   2549            {
   2550               /* The following only happens if we didn't output the
   2551                * leading zeros above for negative exponent, so this
   2552                * doesn't add to the digit requirement.  Note that the
   2553                * two zeros here can only be output if the two leading
   2554                * zeros were *not* output, so this doesn't increase
   2555                * the output count.
   2556                */
   2557               while (exp_b10-- > 0) *ascii++ = 48;
   2558 
   2559               *ascii = 0;
   2560 
   2561               /* Total buffer requirement (including the '\0') is
   2562                * 5+precision - see check at the start.
   2563                */
   2564               return;
   2565            }
   2566 
   2567            /* Here if an exponent is required, adjust size for
   2568             * the digits we output but did not count.  The total
   2569             * digit output here so far is at most 1+precision - no
   2570             * decimal point and no leading or trailing zeros have
   2571             * been output.
   2572             */
   2573            size -= cdigits;
   2574 
   2575            *ascii++ = 69; --size;    /* 'E': PLUS 1 TOTAL 2+precision */
   2576 
   2577            /* The following use of an unsigned temporary avoids ambiguities in
   2578             * the signed arithmetic on exp_b10 and permits GCC at least to do
   2579             * better optimization.
   2580             */
   2581            {
   2582               unsigned int uexp_b10;
   2583 
   2584               if (exp_b10 < 0)
   2585               {
   2586                  *ascii++ = 45; --size; /* '-': PLUS 1 TOTAL 3+precision */
   2587                  uexp_b10 = 0U-exp_b10;
   2588               }
   2589 
   2590               else
   2591                  uexp_b10 = 0U+exp_b10;
   2592 
   2593               cdigits = 0;
   2594 
   2595               while (uexp_b10 > 0)
   2596               {
   2597                  exponent[cdigits++] = (char)(48 + uexp_b10 % 10);
   2598                  uexp_b10 /= 10;
   2599               }
   2600            }
   2601 
   2602            /* Need another size check here for the exponent digits, so
   2603             * this need not be considered above.
   2604             */
   2605            if (size > cdigits)
   2606            {
   2607               while (cdigits > 0) *ascii++ = exponent[--cdigits];
   2608 
   2609               *ascii = 0;
   2610 
   2611               return;
   2612            }
   2613         }
   2614      }
   2615      else if (!(fp >= DBL_MIN))
   2616      {
   2617         *ascii++ = 48; /* '0' */
   2618         *ascii = 0;
   2619         return;
   2620      }
   2621      else
   2622      {
   2623         *ascii++ = 105; /* 'i' */
   2624         *ascii++ = 110; /* 'n' */
   2625         *ascii++ = 102; /* 'f' */
   2626         *ascii = 0;
   2627         return;
   2628      }
   2629   }
   2630 
   2631   /* Here on buffer too small. */
   2632   png_error(png_ptr, "ASCII conversion buffer too small");
   2633 }
   2634 #  endif /* FLOATING_POINT */
   2635 
   2636 #  ifdef PNG_FIXED_POINT_SUPPORTED
   2637 /* Function to format a fixed point value in ASCII.
   2638 */
   2639 void /* PRIVATE */
   2640 png_ascii_from_fixed(png_const_structrp png_ptr, png_charp ascii,
   2641    size_t size, png_fixed_point fp)
   2642 {
   2643   /* Require space for 10 decimal digits, a decimal point, a minus sign and a
   2644    * trailing \0, 13 characters:
   2645    */
   2646   if (size > 12)
   2647   {
   2648      png_uint_32 num;
   2649 
   2650      /* Avoid overflow here on the minimum integer. */
   2651      if (fp < 0)
   2652      {
   2653         *ascii++ = 45; num = (png_uint_32)(-fp);
   2654      }
   2655      else
   2656         num = (png_uint_32)fp;
   2657 
   2658      if (num <= 0x80000000) /* else overflowed */
   2659      {
   2660         unsigned int ndigits = 0, first = 16 /* flag value */;
   2661         char digits[10] = {0};
   2662 
   2663         while (num)
   2664         {
   2665            /* Split the low digit off num: */
   2666            unsigned int tmp = num/10;
   2667            num -= tmp*10;
   2668            digits[ndigits++] = (char)(48 + num);
   2669            /* Record the first non-zero digit, note that this is a number
   2670             * starting at 1, it's not actually the array index.
   2671             */
   2672            if (first == 16 && num > 0)
   2673               first = ndigits;
   2674            num = tmp;
   2675         }
   2676 
   2677         if (ndigits > 0)
   2678         {
   2679            while (ndigits > 5) *ascii++ = digits[--ndigits];
   2680            /* The remaining digits are fractional digits, ndigits is '5' or
   2681             * smaller at this point.  It is certainly not zero.  Check for a
   2682             * non-zero fractional digit:
   2683             */
   2684            if (first <= 5)
   2685            {
   2686               unsigned int i;
   2687               *ascii++ = 46; /* decimal point */
   2688               /* ndigits may be <5 for small numbers, output leading zeros
   2689                * then ndigits digits to first:
   2690                */
   2691               i = 5;
   2692               while (ndigits < i)
   2693               {
   2694                  *ascii++ = 48; --i;
   2695               }
   2696               while (ndigits >= first) *ascii++ = digits[--ndigits];
   2697               /* Don't output the trailing zeros! */
   2698            }
   2699         }
   2700         else
   2701            *ascii++ = 48;
   2702 
   2703         /* And null terminate the string: */
   2704         *ascii = 0;
   2705         return;
   2706      }
   2707   }
   2708 
   2709   /* Here on buffer too small. */
   2710   png_error(png_ptr, "ASCII conversion buffer too small");
   2711 }
   2712 #   endif /* FIXED_POINT */
   2713 #endif /* SCAL */
   2714 
   2715 #if defined(PNG_FLOATING_POINT_SUPPORTED) && \
   2716   !defined(PNG_FIXED_POINT_MACRO_SUPPORTED) && \
   2717   (defined(PNG_gAMA_SUPPORTED) || defined(PNG_cHRM_SUPPORTED) || \
   2718   defined(PNG_sCAL_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED) || \
   2719   defined(PNG_READ_RGB_TO_GRAY_SUPPORTED)) || \
   2720   (defined(PNG_sCAL_SUPPORTED) && \
   2721   defined(PNG_FLOATING_ARITHMETIC_SUPPORTED))
   2722 png_fixed_point
   2723 png_fixed(png_const_structrp png_ptr, double fp, png_const_charp text)
   2724 {
   2725   double r = floor(100000 * fp + .5);
   2726 
   2727   if (r > 2147483647. || r < -2147483648.)
   2728      png_fixed_error(png_ptr, text);
   2729 
   2730 #  ifndef PNG_ERROR_TEXT_SUPPORTED
   2731   PNG_UNUSED(text)
   2732 #  endif
   2733 
   2734   return (png_fixed_point)r;
   2735 }
   2736 #endif
   2737 
   2738 #if defined(PNG_FLOATING_POINT_SUPPORTED) && \
   2739   !defined(PNG_FIXED_POINT_MACRO_SUPPORTED) && \
   2740   (defined(PNG_cLLI_SUPPORTED) || defined(PNG_mDCV_SUPPORTED))
   2741 png_uint_32
   2742 png_fixed_ITU(png_const_structrp png_ptr, double fp, png_const_charp text)
   2743 {
   2744   double r = floor(10000 * fp + .5);
   2745 
   2746   if (r > 2147483647. || r < 0)
   2747      png_fixed_error(png_ptr, text);
   2748 
   2749 #  ifndef PNG_ERROR_TEXT_SUPPORTED
   2750   PNG_UNUSED(text)
   2751 #  endif
   2752 
   2753   return (png_uint_32)r;
   2754 }
   2755 #endif
   2756 
   2757 
   2758 #if defined(PNG_READ_GAMMA_SUPPORTED) || defined(PNG_COLORSPACE_SUPPORTED) ||\
   2759    defined(PNG_INCH_CONVERSIONS_SUPPORTED) || defined(PNG_READ_pHYs_SUPPORTED)
   2760 /* muldiv functions */
   2761 /* This API takes signed arguments and rounds the result to the nearest
   2762 * integer (or, for a fixed point number - the standard argument - to
   2763 * the nearest .00001).  Overflow and divide by zero are signalled in
   2764 * the result, a boolean - true on success, false on overflow.
   2765 */
   2766 int /* PRIVATE */
   2767 png_muldiv(png_fixed_point_p res, png_fixed_point a, png_int_32 times,
   2768    png_int_32 divisor)
   2769 {
   2770   /* Return a * times / divisor, rounded. */
   2771   if (divisor != 0)
   2772   {
   2773      if (a == 0 || times == 0)
   2774      {
   2775         *res = 0;
   2776         return 1;
   2777      }
   2778      else
   2779      {
   2780 #ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
   2781         double r = a;
   2782         r *= times;
   2783         r /= divisor;
   2784         r = floor(r+.5);
   2785 
   2786         /* A png_fixed_point is a 32-bit integer. */
   2787         if (r <= 2147483647. && r >= -2147483648.)
   2788         {
   2789            *res = (png_fixed_point)r;
   2790            return 1;
   2791         }
   2792 #else
   2793         int negative = 0;
   2794         png_uint_32 A, T, D;
   2795         png_uint_32 s16, s32, s00;
   2796 
   2797         if (a < 0)
   2798            negative = 1, A = -a;
   2799         else
   2800            A = a;
   2801 
   2802         if (times < 0)
   2803            negative = !negative, T = -times;
   2804         else
   2805            T = times;
   2806 
   2807         if (divisor < 0)
   2808            negative = !negative, D = -divisor;
   2809         else
   2810            D = divisor;
   2811 
   2812         /* Following can't overflow because the arguments only
   2813          * have 31 bits each, however the result may be 32 bits.
   2814          */
   2815         s16 = (A >> 16) * (T & 0xffff) +
   2816                           (A & 0xffff) * (T >> 16);
   2817         /* Can't overflow because the a*times bit is only 30
   2818          * bits at most.
   2819          */
   2820         s32 = (A >> 16) * (T >> 16) + (s16 >> 16);
   2821         s00 = (A & 0xffff) * (T & 0xffff);
   2822 
   2823         s16 = (s16 & 0xffff) << 16;
   2824         s00 += s16;
   2825 
   2826         if (s00 < s16)
   2827            ++s32; /* carry */
   2828 
   2829         if (s32 < D) /* else overflow */
   2830         {
   2831            /* s32.s00 is now the 64-bit product, do a standard
   2832             * division, we know that s32 < D, so the maximum
   2833             * required shift is 31.
   2834             */
   2835            int bitshift = 32;
   2836            png_fixed_point result = 0; /* NOTE: signed */
   2837 
   2838            while (--bitshift >= 0)
   2839            {
   2840               png_uint_32 d32, d00;
   2841 
   2842               if (bitshift > 0)
   2843                  d32 = D >> (32-bitshift), d00 = D << bitshift;
   2844 
   2845               else
   2846                  d32 = 0, d00 = D;
   2847 
   2848               if (s32 > d32)
   2849               {
   2850                  if (s00 < d00) --s32; /* carry */
   2851                  s32 -= d32, s00 -= d00, result += 1<<bitshift;
   2852               }
   2853 
   2854               else
   2855                  if (s32 == d32 && s00 >= d00)
   2856                     s32 = 0, s00 -= d00, result += 1<<bitshift;
   2857            }
   2858 
   2859            /* Handle the rounding. */
   2860            if (s00 >= (D >> 1))
   2861               ++result;
   2862 
   2863            if (negative != 0)
   2864               result = -result;
   2865 
   2866            /* Check for overflow. */
   2867            if ((negative != 0 && result <= 0) ||
   2868                (negative == 0 && result >= 0))
   2869            {
   2870               *res = result;
   2871               return 1;
   2872            }
   2873         }
   2874 #endif
   2875      }
   2876   }
   2877 
   2878   return 0;
   2879 }
   2880 
   2881 /* Calculate a reciprocal, return 0 on div-by-zero or overflow. */
   2882 png_fixed_point
   2883 png_reciprocal(png_fixed_point a)
   2884 {
   2885 #ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
   2886   double r = floor(1E10/a+.5);
   2887 
   2888   if (r <= 2147483647. && r >= -2147483648.)
   2889      return (png_fixed_point)r;
   2890 #else
   2891   png_fixed_point res;
   2892 
   2893   if (png_muldiv(&res, 100000, 100000, a) != 0)
   2894      return res;
   2895 #endif
   2896 
   2897   return 0; /* error/overflow */
   2898 }
   2899 #endif /* READ_GAMMA || COLORSPACE || INCH_CONVERSIONS || READ_pHYS */
   2900 
   2901 #ifdef PNG_READ_GAMMA_SUPPORTED
   2902 /* This is the shared test on whether a gamma value is 'significant' - whether
   2903 * it is worth doing gamma correction.
   2904 */
   2905 int /* PRIVATE */
   2906 png_gamma_significant(png_fixed_point gamma_val)
   2907 {
   2908   /* sRGB:       1/2.2 == 0.4545(45)
   2909    * AdobeRGB:   1/(2+51/256) ~= 0.45471 5dp
   2910    *
   2911    * So the correction from AdobeRGB to sRGB (output) is:
   2912    *
   2913    *    2.2/(2+51/256) == 1.00035524
   2914    *
   2915    * I.e. vanishly small (<4E-4) but still detectable in 16-bit linear (+/-
   2916    * 23).  Note that the Adobe choice seems to be something intended to give an
   2917    * exact number with 8 binary fractional digits - it is the closest to 2.2
   2918    * that is possible a base 2 .8p representation.
   2919    */
   2920   return gamma_val < PNG_FP_1 - PNG_GAMMA_THRESHOLD_FIXED ||
   2921       gamma_val > PNG_FP_1 + PNG_GAMMA_THRESHOLD_FIXED;
   2922 }
   2923 
   2924 #ifndef PNG_FLOATING_ARITHMETIC_SUPPORTED
   2925 /* A local convenience routine. */
   2926 static png_fixed_point
   2927 png_product2(png_fixed_point a, png_fixed_point b)
   2928 {
   2929   /* The required result is a * b; the following preserves accuracy. */
   2930 #ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED /* Should now be unused */
   2931   double r = a * 1E-5;
   2932   r *= b;
   2933   r = floor(r+.5);
   2934 
   2935   if (r <= 2147483647. && r >= -2147483648.)
   2936      return (png_fixed_point)r;
   2937 #else
   2938   png_fixed_point res;
   2939 
   2940   if (png_muldiv(&res, a, b, 100000) != 0)
   2941      return res;
   2942 #endif
   2943 
   2944   return 0; /* overflow */
   2945 }
   2946 #endif /* FLOATING_ARITHMETIC */
   2947 
   2948 png_fixed_point
   2949 png_reciprocal2(png_fixed_point a, png_fixed_point b)
   2950 {
   2951   /* The required result is 1/a * 1/b; the following preserves accuracy. */
   2952 #ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
   2953   if (a != 0 && b != 0)
   2954   {
   2955      double r = 1E15/a;
   2956      r /= b;
   2957      r = floor(r+.5);
   2958 
   2959      if (r <= 2147483647. && r >= -2147483648.)
   2960         return (png_fixed_point)r;
   2961   }
   2962 #else
   2963   /* This may overflow because the range of png_fixed_point isn't symmetric,
   2964    * but this API is only used for the product of file and screen gamma so it
   2965    * doesn't matter that the smallest number it can produce is 1/21474, not
   2966    * 1/100000
   2967    */
   2968   png_fixed_point res = png_product2(a, b);
   2969 
   2970   if (res != 0)
   2971      return png_reciprocal(res);
   2972 #endif
   2973 
   2974   return 0; /* overflow */
   2975 }
   2976 #endif /* READ_GAMMA */
   2977 
   2978 #ifdef PNG_READ_GAMMA_SUPPORTED /* gamma table code */
   2979 #ifndef PNG_FLOATING_ARITHMETIC_SUPPORTED
   2980 /* Fixed point gamma.
   2981 *
   2982 * The code to calculate the tables used below can be found in the shell script
   2983 * contrib/tools/intgamma.sh
   2984 *
   2985 * To calculate gamma this code implements fast log() and exp() calls using only
   2986 * fixed point arithmetic.  This code has sufficient precision for either 8-bit
   2987 * or 16-bit sample values.
   2988 *
   2989 * The tables used here were calculated using simple 'bc' programs, but C double
   2990 * precision floating point arithmetic would work fine.
   2991 *
   2992 * 8-bit log table
   2993 *   This is a table of -log(value/255)/log(2) for 'value' in the range 128 to
   2994 *   255, so it's the base 2 logarithm of a normalized 8-bit floating point
   2995 *   mantissa.  The numbers are 32-bit fractions.
   2996 */
   2997 static const png_uint_32
   2998 png_8bit_l2[128] =
   2999 {
   3000   4270715492U, 4222494797U, 4174646467U, 4127164793U, 4080044201U, 4033279239U,
   3001   3986864580U, 3940795015U, 3895065449U, 3849670902U, 3804606499U, 3759867474U,
   3002   3715449162U, 3671346997U, 3627556511U, 3584073329U, 3540893168U, 3498011834U,
   3003   3455425220U, 3413129301U, 3371120137U, 3329393864U, 3287946700U, 3246774933U,
   3004   3205874930U, 3165243125U, 3124876025U, 3084770202U, 3044922296U, 3005329011U,
   3005   2965987113U, 2926893432U, 2888044853U, 2849438323U, 2811070844U, 2772939474U,
   3006   2735041326U, 2697373562U, 2659933400U, 2622718104U, 2585724991U, 2548951424U,
   3007   2512394810U, 2476052606U, 2439922311U, 2404001468U, 2368287663U, 2332778523U,
   3008   2297471715U, 2262364947U, 2227455964U, 2192742551U, 2158222529U, 2123893754U,
   3009   2089754119U, 2055801552U, 2022034013U, 1988449497U, 1955046031U, 1921821672U,
   3010   1888774511U, 1855902668U, 1823204291U, 1790677560U, 1758320682U, 1726131893U,
   3011   1694109454U, 1662251657U, 1630556815U, 1599023271U, 1567649391U, 1536433567U,
   3012   1505374214U, 1474469770U, 1443718700U, 1413119487U, 1382670639U, 1352370686U,
   3013   1322218179U, 1292211689U, 1262349810U, 1232631153U, 1203054352U, 1173618059U,
   3014   1144320946U, 1115161701U, 1086139034U, 1057251672U, 1028498358U, 999877854U,
   3015   971388940U, 943030410U, 914801076U, 886699767U, 858725327U, 830876614U,
   3016   803152505U, 775551890U, 748073672U, 720716771U, 693480120U, 666362667U,
   3017   639363374U, 612481215U, 585715177U, 559064263U, 532527486U, 506103872U,
   3018   479792461U, 453592303U, 427502463U, 401522014U, 375650043U, 349885648U,
   3019   324227938U, 298676034U, 273229066U, 247886176U, 222646516U, 197509248U,
   3020   172473545U, 147538590U, 122703574U, 97967701U, 73330182U, 48790236U,
   3021   24347096U, 0U
   3022 
   3023 #if 0
   3024   /* The following are the values for 16-bit tables - these work fine for the
   3025    * 8-bit conversions but produce very slightly larger errors in the 16-bit
   3026    * log (about 1.2 as opposed to 0.7 absolute error in the final value).  To
   3027    * use these all the shifts below must be adjusted appropriately.
   3028    */
   3029   65166, 64430, 63700, 62976, 62257, 61543, 60835, 60132, 59434, 58741, 58054,
   3030   57371, 56693, 56020, 55352, 54689, 54030, 53375, 52726, 52080, 51439, 50803,
   3031   50170, 49542, 48918, 48298, 47682, 47070, 46462, 45858, 45257, 44661, 44068,
   3032   43479, 42894, 42312, 41733, 41159, 40587, 40020, 39455, 38894, 38336, 37782,
   3033   37230, 36682, 36137, 35595, 35057, 34521, 33988, 33459, 32932, 32408, 31887,
   3034   31369, 30854, 30341, 29832, 29325, 28820, 28319, 27820, 27324, 26830, 26339,
   3035   25850, 25364, 24880, 24399, 23920, 23444, 22970, 22499, 22029, 21562, 21098,
   3036   20636, 20175, 19718, 19262, 18808, 18357, 17908, 17461, 17016, 16573, 16132,
   3037   15694, 15257, 14822, 14390, 13959, 13530, 13103, 12678, 12255, 11834, 11415,
   3038   10997, 10582, 10168, 9756, 9346, 8937, 8531, 8126, 7723, 7321, 6921, 6523,
   3039   6127, 5732, 5339, 4947, 4557, 4169, 3782, 3397, 3014, 2632, 2251, 1872, 1495,
   3040   1119, 744, 372
   3041 #endif
   3042 };
   3043 
   3044 static png_int_32
   3045 png_log8bit(unsigned int x)
   3046 {
   3047   unsigned int lg2 = 0;
   3048   /* Each time 'x' is multiplied by 2, 1 must be subtracted off the final log,
   3049    * because the log is actually negate that means adding 1.  The final
   3050    * returned value thus has the range 0 (for 255 input) to 7.994 (for 1
   3051    * input), return -1 for the overflow (log 0) case, - so the result is
   3052    * always at most 19 bits.
   3053    */
   3054   if ((x &= 0xff) == 0)
   3055      return -1;
   3056 
   3057   if ((x & 0xf0) == 0)
   3058      lg2  = 4, x <<= 4;
   3059 
   3060   if ((x & 0xc0) == 0)
   3061      lg2 += 2, x <<= 2;
   3062 
   3063   if ((x & 0x80) == 0)
   3064      lg2 += 1, x <<= 1;
   3065 
   3066   /* result is at most 19 bits, so this cast is safe: */
   3067   return (png_int_32)((lg2 << 16) + ((png_8bit_l2[x-128]+32768)>>16));
   3068 }
   3069 
   3070 /* The above gives exact (to 16 binary places) log2 values for 8-bit images,
   3071 * for 16-bit images we use the most significant 8 bits of the 16-bit value to
   3072 * get an approximation then multiply the approximation by a correction factor
   3073 * determined by the remaining up to 8 bits.  This requires an additional step
   3074 * in the 16-bit case.
   3075 *
   3076 * We want log2(value/65535), we have log2(v'/255), where:
   3077 *
   3078 *    value = v' * 256 + v''
   3079 *          = v' * f
   3080 *
   3081 * So f is value/v', which is equal to (256+v''/v') since v' is in the range 128
   3082 * to 255 and v'' is in the range 0 to 255 f will be in the range 256 to less
   3083 * than 258.  The final factor also needs to correct for the fact that our 8-bit
   3084 * value is scaled by 255, whereas the 16-bit values must be scaled by 65535.
   3085 *
   3086 * This gives a final formula using a calculated value 'x' which is value/v' and
   3087 * scaling by 65536 to match the above table:
   3088 *
   3089 *   log2(x/257) * 65536
   3090 *
   3091 * Since these numbers are so close to '1' we can use simple linear
   3092 * interpolation between the two end values 256/257 (result -368.61) and 258/257
   3093 * (result 367.179).  The values used below are scaled by a further 64 to give
   3094 * 16-bit precision in the interpolation:
   3095 *
   3096 * Start (256): -23591
   3097 * Zero  (257):      0
   3098 * End   (258):  23499
   3099 */
   3100 #ifdef PNG_16BIT_SUPPORTED
   3101 static png_int_32
   3102 png_log16bit(png_uint_32 x)
   3103 {
   3104   unsigned int lg2 = 0;
   3105 
   3106   /* As above, but now the input has 16 bits. */
   3107   if ((x &= 0xffff) == 0)
   3108      return -1;
   3109 
   3110   if ((x & 0xff00) == 0)
   3111      lg2  = 8, x <<= 8;
   3112 
   3113   if ((x & 0xf000) == 0)
   3114      lg2 += 4, x <<= 4;
   3115 
   3116   if ((x & 0xc000) == 0)
   3117      lg2 += 2, x <<= 2;
   3118 
   3119   if ((x & 0x8000) == 0)
   3120      lg2 += 1, x <<= 1;
   3121 
   3122   /* Calculate the base logarithm from the top 8 bits as a 28-bit fractional
   3123    * value.
   3124    */
   3125   lg2 <<= 28;
   3126   lg2 += (png_8bit_l2[(x>>8)-128]+8) >> 4;
   3127 
   3128   /* Now we need to interpolate the factor, this requires a division by the top
   3129    * 8 bits.  Do this with maximum precision.
   3130    */
   3131   x = ((x << 16) + (x >> 9)) / (x >> 8);
   3132 
   3133   /* Since we divided by the top 8 bits of 'x' there will be a '1' at 1<<24,
   3134    * the value at 1<<16 (ignoring this) will be 0 or 1; this gives us exactly
   3135    * 16 bits to interpolate to get the low bits of the result.  Round the
   3136    * answer.  Note that the end point values are scaled by 64 to retain overall
   3137    * precision and that 'lg2' is current scaled by an extra 12 bits, so adjust
   3138    * the overall scaling by 6-12.  Round at every step.
   3139    */
   3140   x -= 1U << 24;
   3141 
   3142   if (x <= 65536U) /* <= '257' */
   3143      lg2 += ((23591U * (65536U-x)) + (1U << (16+6-12-1))) >> (16+6-12);
   3144 
   3145   else
   3146      lg2 -= ((23499U * (x-65536U)) + (1U << (16+6-12-1))) >> (16+6-12);
   3147 
   3148   /* Safe, because the result can't have more than 20 bits: */
   3149   return (png_int_32)((lg2 + 2048) >> 12);
   3150 }
   3151 #endif /* 16BIT */
   3152 
   3153 /* The 'exp()' case must invert the above, taking a 20-bit fixed point
   3154 * logarithmic value and returning a 16 or 8-bit number as appropriate.  In
   3155 * each case only the low 16 bits are relevant - the fraction - since the
   3156 * integer bits (the top 4) simply determine a shift.
   3157 *
   3158 * The worst case is the 16-bit distinction between 65535 and 65534. This
   3159 * requires perhaps spurious accuracy in the decoding of the logarithm to
   3160 * distinguish log2(65535/65534.5) - 10^-5 or 17 bits.  There is little chance
   3161 * of getting this accuracy in practice.
   3162 *
   3163 * To deal with this the following exp() function works out the exponent of the
   3164 * fractional part of the logarithm by using an accurate 32-bit value from the
   3165 * top four fractional bits then multiplying in the remaining bits.
   3166 */
   3167 static const png_uint_32
   3168 png_32bit_exp[16] =
   3169 {
   3170   /* NOTE: the first entry is deliberately set to the maximum 32-bit value. */
   3171   4294967295U, 4112874773U, 3938502376U, 3771522796U, 3611622603U, 3458501653U,
   3172   3311872529U, 3171459999U, 3037000500U, 2908241642U, 2784941738U, 2666869345U,
   3173   2553802834U, 2445529972U, 2341847524U, 2242560872U
   3174 };
   3175 
   3176 /* Adjustment table; provided to explain the numbers in the code below. */
   3177 #if 0
   3178 for (i=11;i>=0;--i){ print i, " ", (1 - e(-(2^i)/65536*l(2))) * 2^(32-i), "\n"}
   3179   11 44937.64284865548751208448
   3180   10 45180.98734845585101160448
   3181    9 45303.31936980687359311872
   3182    8 45364.65110595323018870784
   3183    7 45395.35850361789624614912
   3184    6 45410.72259715102037508096
   3185    5 45418.40724413220722311168
   3186    4 45422.25021786898173001728
   3187    3 45424.17186732298419044352
   3188    2 45425.13273269940811464704
   3189    1 45425.61317555035558641664
   3190    0 45425.85339951654943850496
   3191 #endif
   3192 
   3193 static png_uint_32
   3194 png_exp(png_fixed_point x)
   3195 {
   3196   if (x > 0 && x <= 0xfffff) /* Else overflow or zero (underflow) */
   3197   {
   3198      /* Obtain a 4-bit approximation */
   3199      png_uint_32 e = png_32bit_exp[(x >> 12) & 0x0f];
   3200 
   3201      /* Incorporate the low 12 bits - these decrease the returned value by
   3202       * multiplying by a number less than 1 if the bit is set.  The multiplier
   3203       * is determined by the above table and the shift. Notice that the values
   3204       * converge on 45426 and this is used to allow linear interpolation of the
   3205       * low bits.
   3206       */
   3207      if (x & 0x800)
   3208         e -= (((e >> 16) * 44938U) +  16U) >> 5;
   3209 
   3210      if (x & 0x400)
   3211         e -= (((e >> 16) * 45181U) +  32U) >> 6;
   3212 
   3213      if (x & 0x200)
   3214         e -= (((e >> 16) * 45303U) +  64U) >> 7;
   3215 
   3216      if (x & 0x100)
   3217         e -= (((e >> 16) * 45365U) + 128U) >> 8;
   3218 
   3219      if (x & 0x080)
   3220         e -= (((e >> 16) * 45395U) + 256U) >> 9;
   3221 
   3222      if (x & 0x040)
   3223         e -= (((e >> 16) * 45410U) + 512U) >> 10;
   3224 
   3225      /* And handle the low 6 bits in a single block. */
   3226      e -= (((e >> 16) * 355U * (x & 0x3fU)) + 256U) >> 9;
   3227 
   3228      /* Handle the upper bits of x. */
   3229      e >>= x >> 16;
   3230      return e;
   3231   }
   3232 
   3233   /* Check for overflow */
   3234   if (x <= 0)
   3235      return png_32bit_exp[0];
   3236 
   3237   /* Else underflow */
   3238   return 0;
   3239 }
   3240 
   3241 static png_byte
   3242 png_exp8bit(png_fixed_point lg2)
   3243 {
   3244   /* Get a 32-bit value: */
   3245   png_uint_32 x = png_exp(lg2);
   3246 
   3247   /* Convert the 32-bit value to 0..255 by multiplying by 256-1. Note that the
   3248    * second, rounding, step can't overflow because of the first, subtraction,
   3249    * step.
   3250    */
   3251   x -= x >> 8;
   3252   return (png_byte)(((x + 0x7fffffU) >> 24) & 0xff);
   3253 }
   3254 
   3255 #ifdef PNG_16BIT_SUPPORTED
   3256 static png_uint_16
   3257 png_exp16bit(png_fixed_point lg2)
   3258 {
   3259   /* Get a 32-bit value: */
   3260   png_uint_32 x = png_exp(lg2);
   3261 
   3262   /* Convert the 32-bit value to 0..65535 by multiplying by 65536-1: */
   3263   x -= x >> 16;
   3264   return (png_uint_16)((x + 32767U) >> 16);
   3265 }
   3266 #endif /* 16BIT */
   3267 #endif /* FLOATING_ARITHMETIC */
   3268 
   3269 png_byte
   3270 png_gamma_8bit_correct(unsigned int value, png_fixed_point gamma_val)
   3271 {
   3272   if (value > 0 && value < 255)
   3273   {
   3274 #     ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
   3275         /* 'value' is unsigned, ANSI-C90 requires the compiler to correctly
   3276          * convert this to a floating point value.  This includes values that
   3277          * would overflow if 'value' were to be converted to 'int'.
   3278          *
   3279          * Apparently GCC, however, does an intermediate conversion to (int)
   3280          * on some (ARM) but not all (x86) platforms, possibly because of
   3281          * hardware FP limitations.  (E.g. if the hardware conversion always
   3282          * assumes the integer register contains a signed value.)  This results
   3283          * in ANSI-C undefined behavior for large values.
   3284          *
   3285          * Other implementations on the same machine might actually be ANSI-C90
   3286          * conformant and therefore compile spurious extra code for the large
   3287          * values.
   3288          *
   3289          * We can be reasonably sure that an unsigned to float conversion
   3290          * won't be faster than an int to float one.  Therefore this code
   3291          * assumes responsibility for the undefined behavior, which it knows
   3292          * can't happen because of the check above.
   3293          *
   3294          * Note the argument to this routine is an (unsigned int) because, on
   3295          * 16-bit platforms, it is assigned a value which might be out of
   3296          * range for an (int); that would result in undefined behavior in the
   3297          * caller if the *argument* ('value') were to be declared (int).
   3298          */
   3299         double r = floor(255*pow((int)/*SAFE*/value/255.,gamma_val*.00001)+.5);
   3300         return (png_byte)r;
   3301 #     else
   3302         png_int_32 lg2 = png_log8bit(value);
   3303         png_fixed_point res;
   3304 
   3305         if (png_muldiv(&res, gamma_val, lg2, PNG_FP_1) != 0)
   3306            return png_exp8bit(res);
   3307 
   3308         /* Overflow. */
   3309         value = 0;
   3310 #     endif
   3311   }
   3312 
   3313   return (png_byte)(value & 0xff);
   3314 }
   3315 
   3316 #ifdef PNG_16BIT_SUPPORTED
   3317 png_uint_16
   3318 png_gamma_16bit_correct(unsigned int value, png_fixed_point gamma_val)
   3319 {
   3320   if (value > 0 && value < 65535)
   3321   {
   3322 # ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
   3323      /* The same (unsigned int)->(double) constraints apply here as above,
   3324       * however in this case the (unsigned int) to (int) conversion can
   3325       * overflow on an ANSI-C90 compliant system so the cast needs to ensure
   3326       * that this is not possible.
   3327       */
   3328      double r = floor(65535*pow((png_int_32)value/65535.,
   3329          gamma_val*.00001)+.5);
   3330      return (png_uint_16)r;
   3331 # else
   3332      png_int_32 lg2 = png_log16bit(value);
   3333      png_fixed_point res;
   3334 
   3335      if (png_muldiv(&res, gamma_val, lg2, PNG_FP_1) != 0)
   3336         return png_exp16bit(res);
   3337 
   3338      /* Overflow. */
   3339      value = 0;
   3340 # endif
   3341   }
   3342 
   3343   return (png_uint_16)value;
   3344 }
   3345 #endif /* 16BIT */
   3346 
   3347 /* This does the right thing based on the bit_depth field of the
   3348 * png_struct, interpreting values as 8-bit or 16-bit.  While the result
   3349 * is nominally a 16-bit value if bit depth is 8 then the result is
   3350 * 8-bit (as are the arguments.)
   3351 */
   3352 png_uint_16 /* PRIVATE */
   3353 png_gamma_correct(png_structrp png_ptr, unsigned int value,
   3354    png_fixed_point gamma_val)
   3355 {
   3356   if (png_ptr->bit_depth == 8)
   3357      return png_gamma_8bit_correct(value, gamma_val);
   3358 
   3359 #ifdef PNG_16BIT_SUPPORTED
   3360   else
   3361      return png_gamma_16bit_correct(value, gamma_val);
   3362 #else
   3363      /* should not reach this */
   3364      return 0;
   3365 #endif /* 16BIT */
   3366 }
   3367 
   3368 #ifdef PNG_16BIT_SUPPORTED
   3369 /* Internal function to build a single 16-bit table - the table consists of
   3370 * 'num' 256 entry subtables, where 'num' is determined by 'shift' - the amount
   3371 * to shift the input values right (or 16-number_of_signifiant_bits).
   3372 *
   3373 * The caller is responsible for ensuring that the table gets cleaned up on
   3374 * png_error (i.e. if one of the mallocs below fails) - i.e. the *table argument
   3375 * should be somewhere that will be cleaned.
   3376 */
   3377 static void
   3378 png_build_16bit_table(png_structrp png_ptr, png_uint_16pp *ptable,
   3379    unsigned int shift, png_fixed_point gamma_val)
   3380 {
   3381   /* Various values derived from 'shift': */
   3382   unsigned int num = 1U << (8U - shift);
   3383 #ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
   3384   /* CSE the division and work round wacky GCC warnings (see the comments
   3385    * in png_gamma_8bit_correct for where these come from.)
   3386    */
   3387   double fmax = 1.0 / (((png_int_32)1 << (16U - shift)) - 1);
   3388 #endif
   3389   unsigned int max = (1U << (16U - shift)) - 1U;
   3390   unsigned int max_by_2 = 1U << (15U - shift);
   3391   unsigned int i;
   3392 
   3393   png_uint_16pp table = *ptable =
   3394       (png_uint_16pp)png_calloc(png_ptr, num * (sizeof (png_uint_16p)));
   3395 
   3396   for (i = 0; i < num; i++)
   3397   {
   3398      png_uint_16p sub_table = table[i] =
   3399          (png_uint_16p)png_malloc(png_ptr, 256 * (sizeof (png_uint_16)));
   3400 
   3401      /* The 'threshold' test is repeated here because it can arise for one of
   3402       * the 16-bit tables even if the others don't hit it.
   3403       */
   3404      if (png_gamma_significant(gamma_val) != 0)
   3405      {
   3406         /* The old code would overflow at the end and this would cause the
   3407          * 'pow' function to return a result >1, resulting in an
   3408          * arithmetic error.  This code follows the spec exactly; ig is
   3409          * the recovered input sample, it always has 8-16 bits.
   3410          *
   3411          * We want input * 65535/max, rounded, the arithmetic fits in 32
   3412          * bits (unsigned) so long as max <= 32767.
   3413          */
   3414         unsigned int j;
   3415         for (j = 0; j < 256; j++)
   3416         {
   3417            png_uint_32 ig = (j << (8-shift)) + i;
   3418 #           ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
   3419               /* Inline the 'max' scaling operation: */
   3420               /* See png_gamma_8bit_correct for why the cast to (int) is
   3421                * required here.
   3422                */
   3423               double d = floor(65535.*pow(ig*fmax, gamma_val*.00001)+.5);
   3424               sub_table[j] = (png_uint_16)d;
   3425 #           else
   3426               if (shift != 0)
   3427                  ig = (ig * 65535U + max_by_2)/max;
   3428 
   3429               sub_table[j] = png_gamma_16bit_correct(ig, gamma_val);
   3430 #           endif
   3431         }
   3432      }
   3433      else
   3434      {
   3435         /* We must still build a table, but do it the fast way. */
   3436         unsigned int j;
   3437 
   3438         for (j = 0; j < 256; j++)
   3439         {
   3440            png_uint_32 ig = (j << (8-shift)) + i;
   3441 
   3442            if (shift != 0)
   3443               ig = (ig * 65535U + max_by_2)/max;
   3444 
   3445            sub_table[j] = (png_uint_16)ig;
   3446         }
   3447      }
   3448   }
   3449 }
   3450 
   3451 /* NOTE: this function expects the *inverse* of the overall gamma transformation
   3452 * required.
   3453 */
   3454 static void
   3455 png_build_16to8_table(png_structrp png_ptr, png_uint_16pp *ptable,
   3456    unsigned int shift, png_fixed_point gamma_val)
   3457 {
   3458   unsigned int num = 1U << (8U - shift);
   3459   unsigned int max = (1U << (16U - shift))-1U;
   3460   unsigned int i;
   3461   png_uint_32 last;
   3462 
   3463   png_uint_16pp table = *ptable =
   3464       (png_uint_16pp)png_calloc(png_ptr, num * (sizeof (png_uint_16p)));
   3465 
   3466   /* 'num' is the number of tables and also the number of low bits of low
   3467    * bits of the input 16-bit value used to select a table.  Each table is
   3468    * itself indexed by the high 8 bits of the value.
   3469    */
   3470   for (i = 0; i < num; i++)
   3471      table[i] = (png_uint_16p)png_malloc(png_ptr,
   3472          256 * (sizeof (png_uint_16)));
   3473 
   3474   /* 'gamma_val' is set to the reciprocal of the value calculated above, so
   3475    * pow(out,g) is an *input* value.  'last' is the last input value set.
   3476    *
   3477    * In the loop 'i' is used to find output values.  Since the output is
   3478    * 8-bit there are only 256 possible values.  The tables are set up to
   3479    * select the closest possible output value for each input by finding
   3480    * the input value at the boundary between each pair of output values
   3481    * and filling the table up to that boundary with the lower output
   3482    * value.
   3483    *
   3484    * The boundary values are 0.5,1.5..253.5,254.5.  Since these are 9-bit
   3485    * values the code below uses a 16-bit value in i; the values start at
   3486    * 128.5 (for 0.5) and step by 257, for a total of 254 values (the last
   3487    * entries are filled with 255).  Start i at 128 and fill all 'last'
   3488    * table entries <= 'max'
   3489    */
   3490   last = 0;
   3491   for (i = 0; i < 255; ++i) /* 8-bit output value */
   3492   {
   3493      /* Find the corresponding maximum input value */
   3494      png_uint_16 out = (png_uint_16)(i * 257U); /* 16-bit output value */
   3495 
   3496      /* Find the boundary value in 16 bits: */
   3497      png_uint_32 bound = png_gamma_16bit_correct(out+128U, gamma_val);
   3498 
   3499      /* Adjust (round) to (16-shift) bits: */
   3500      bound = (bound * max + 32768U)/65535U + 1U;
   3501 
   3502      while (last < bound)
   3503      {
   3504         table[last & (0xffU >> shift)][last >> (8U - shift)] = out;
   3505         last++;
   3506      }
   3507   }
   3508 
   3509   /* And fill in the final entries. */
   3510   while (last < (num << 8))
   3511   {
   3512      table[last & (0xff >> shift)][last >> (8U - shift)] = 65535U;
   3513      last++;
   3514   }
   3515 }
   3516 #endif /* 16BIT */
   3517 
   3518 /* Build a single 8-bit table: same as the 16-bit case but much simpler (and
   3519 * typically much faster).  Note that libpng currently does no sBIT processing
   3520 * (apparently contrary to the spec) so a 256-entry table is always generated.
   3521 */
   3522 static void
   3523 png_build_8bit_table(png_structrp png_ptr, png_bytepp ptable,
   3524    png_fixed_point gamma_val)
   3525 {
   3526   unsigned int i;
   3527   png_bytep table = *ptable = (png_bytep)png_malloc(png_ptr, 256);
   3528 
   3529   if (png_gamma_significant(gamma_val) != 0)
   3530      for (i=0; i<256; i++)
   3531         table[i] = png_gamma_8bit_correct(i, gamma_val);
   3532 
   3533   else
   3534      for (i=0; i<256; ++i)
   3535         table[i] = (png_byte)(i & 0xff);
   3536 }
   3537 
   3538 /* Used from png_read_destroy and below to release the memory used by the gamma
   3539 * tables.
   3540 */
   3541 void /* PRIVATE */
   3542 png_destroy_gamma_table(png_structrp png_ptr)
   3543 {
   3544   png_free(png_ptr, png_ptr->gamma_table);
   3545   png_ptr->gamma_table = NULL;
   3546 
   3547 #ifdef PNG_16BIT_SUPPORTED
   3548   if (png_ptr->gamma_16_table != NULL)
   3549   {
   3550      int i;
   3551      int istop = (1 << (8 - png_ptr->gamma_shift));
   3552      for (i = 0; i < istop; i++)
   3553      {
   3554         png_free(png_ptr, png_ptr->gamma_16_table[i]);
   3555      }
   3556   png_free(png_ptr, png_ptr->gamma_16_table);
   3557   png_ptr->gamma_16_table = NULL;
   3558   }
   3559 #endif /* 16BIT */
   3560 
   3561 #if defined(PNG_READ_BACKGROUND_SUPPORTED) || \
   3562   defined(PNG_READ_ALPHA_MODE_SUPPORTED) || \
   3563   defined(PNG_READ_RGB_TO_GRAY_SUPPORTED)
   3564   png_free(png_ptr, png_ptr->gamma_from_1);
   3565   png_ptr->gamma_from_1 = NULL;
   3566   png_free(png_ptr, png_ptr->gamma_to_1);
   3567   png_ptr->gamma_to_1 = NULL;
   3568 
   3569 #ifdef PNG_16BIT_SUPPORTED
   3570   if (png_ptr->gamma_16_from_1 != NULL)
   3571   {
   3572      int i;
   3573      int istop = (1 << (8 - png_ptr->gamma_shift));
   3574      for (i = 0; i < istop; i++)
   3575      {
   3576         png_free(png_ptr, png_ptr->gamma_16_from_1[i]);
   3577      }
   3578   png_free(png_ptr, png_ptr->gamma_16_from_1);
   3579   png_ptr->gamma_16_from_1 = NULL;
   3580   }
   3581   if (png_ptr->gamma_16_to_1 != NULL)
   3582   {
   3583      int i;
   3584      int istop = (1 << (8 - png_ptr->gamma_shift));
   3585      for (i = 0; i < istop; i++)
   3586      {
   3587         png_free(png_ptr, png_ptr->gamma_16_to_1[i]);
   3588      }
   3589   png_free(png_ptr, png_ptr->gamma_16_to_1);
   3590   png_ptr->gamma_16_to_1 = NULL;
   3591   }
   3592 #endif /* 16BIT */
   3593 #endif /* READ_BACKGROUND || READ_ALPHA_MODE || RGB_TO_GRAY */
   3594 }
   3595 
   3596 /* We build the 8- or 16-bit gamma tables here.  Note that for 16-bit
   3597 * tables, we don't make a full table if we are reducing to 8-bit in
   3598 * the future.  Note also how the gamma_16 tables are segmented so that
   3599 * we don't need to allocate > 64K chunks for a full 16-bit table.
   3600 *
   3601 * TODO: move this to pngrtran.c and make it static.  Better yet create
   3602 * pngcolor.c and put all the PNG_COLORSPACE stuff in there.
   3603 */
   3604 #if defined(PNG_READ_BACKGROUND_SUPPORTED) || \
   3605   defined(PNG_READ_ALPHA_MODE_SUPPORTED) || \
   3606   defined(PNG_READ_RGB_TO_GRAY_SUPPORTED)
   3607 #  define GAMMA_TRANSFORMS 1 /* #ifdef CSE */
   3608 #else
   3609 #  define GAMMA_TRANSFORMS 0
   3610 #endif
   3611 
   3612 void /* PRIVATE */
   3613 png_build_gamma_table(png_structrp png_ptr, int bit_depth)
   3614 {
   3615   png_fixed_point file_gamma, screen_gamma;
   3616   png_fixed_point correction;
   3617 #  if GAMMA_TRANSFORMS
   3618      png_fixed_point file_to_linear, linear_to_screen;
   3619 #  endif
   3620 
   3621   png_debug(1, "in png_build_gamma_table");
   3622 
   3623   /* Remove any existing table; this copes with multiple calls to
   3624    * png_read_update_info. The warning is because building the gamma tables
   3625    * multiple times is a performance hit - it's harmless but the ability to
   3626    * call png_read_update_info() multiple times is new in 1.5.6 so it seems
   3627    * sensible to warn if the app introduces such a hit.
   3628    */
   3629   if (png_ptr->gamma_table != NULL || png_ptr->gamma_16_table != NULL)
   3630   {
   3631      png_warning(png_ptr, "gamma table being rebuilt");
   3632      png_destroy_gamma_table(png_ptr);
   3633   }
   3634 
   3635   /* The following fields are set, finally, in png_init_read_transformations.
   3636    * If file_gamma is 0 (unset) nothing can be done otherwise if screen_gamma
   3637    * is 0 (unset) there is no gamma correction but to/from linear is possible.
   3638    */
   3639   file_gamma = png_ptr->file_gamma;
   3640   screen_gamma = png_ptr->screen_gamma;
   3641 #  if GAMMA_TRANSFORMS
   3642      file_to_linear = png_reciprocal(file_gamma);
   3643 #  endif
   3644 
   3645   if (screen_gamma > 0)
   3646   {
   3647 #     if GAMMA_TRANSFORMS
   3648         linear_to_screen = png_reciprocal(screen_gamma);
   3649 #     endif
   3650      correction = png_reciprocal2(screen_gamma, file_gamma);
   3651   }
   3652   else /* screen gamma unknown */
   3653   {
   3654 #     if GAMMA_TRANSFORMS
   3655         linear_to_screen = file_gamma;
   3656 #     endif
   3657      correction = PNG_FP_1;
   3658   }
   3659 
   3660   if (bit_depth <= 8)
   3661   {
   3662      png_build_8bit_table(png_ptr, &png_ptr->gamma_table, correction);
   3663 
   3664 #if GAMMA_TRANSFORMS
   3665      if ((png_ptr->transformations & (PNG_COMPOSE | PNG_RGB_TO_GRAY)) != 0)
   3666      {
   3667         png_build_8bit_table(png_ptr, &png_ptr->gamma_to_1, file_to_linear);
   3668 
   3669         png_build_8bit_table(png_ptr, &png_ptr->gamma_from_1,
   3670            linear_to_screen);
   3671      }
   3672 #endif /* GAMMA_TRANSFORMS */
   3673   }
   3674 #ifdef PNG_16BIT_SUPPORTED
   3675   else
   3676   {
   3677      png_byte shift, sig_bit;
   3678 
   3679      if ((png_ptr->color_type & PNG_COLOR_MASK_COLOR) != 0)
   3680      {
   3681         sig_bit = png_ptr->sig_bit.red;
   3682 
   3683         if (png_ptr->sig_bit.green > sig_bit)
   3684            sig_bit = png_ptr->sig_bit.green;
   3685 
   3686         if (png_ptr->sig_bit.blue > sig_bit)
   3687            sig_bit = png_ptr->sig_bit.blue;
   3688      }
   3689      else
   3690         sig_bit = png_ptr->sig_bit.gray;
   3691 
   3692      /* 16-bit gamma code uses this equation:
   3693       *
   3694       *   ov = table[(iv & 0xff) >> gamma_shift][iv >> 8]
   3695       *
   3696       * Where 'iv' is the input color value and 'ov' is the output value -
   3697       * pow(iv, gamma).
   3698       *
   3699       * Thus the gamma table consists of up to 256 256-entry tables.  The table
   3700       * is selected by the (8-gamma_shift) most significant of the low 8 bits
   3701       * of the color value then indexed by the upper 8 bits:
   3702       *
   3703       *   table[low bits][high 8 bits]
   3704       *
   3705       * So the table 'n' corresponds to all those 'iv' of:
   3706       *
   3707       *   <all high 8-bit values><n << gamma_shift>..<(n+1 << gamma_shift)-1>
   3708       *
   3709       */
   3710      if (sig_bit > 0 && sig_bit < 16U)
   3711         /* shift == insignificant bits */
   3712         shift = (png_byte)((16U - sig_bit) & 0xff);
   3713 
   3714      else
   3715         shift = 0; /* keep all 16 bits */
   3716 
   3717      if ((png_ptr->transformations & (PNG_16_TO_8 | PNG_SCALE_16_TO_8)) != 0)
   3718      {
   3719         /* PNG_MAX_GAMMA_8 is the number of bits to keep - effectively
   3720          * the significant bits in the *input* when the output will
   3721          * eventually be 8 bits.  By default it is 11.
   3722          */
   3723         if (shift < (16U - PNG_MAX_GAMMA_8))
   3724            shift = (16U - PNG_MAX_GAMMA_8);
   3725      }
   3726 
   3727      if (shift > 8U)
   3728         shift = 8U; /* Guarantees at least one table! */
   3729 
   3730      png_ptr->gamma_shift = shift;
   3731 
   3732      /* NOTE: prior to 1.5.4 this test used to include PNG_BACKGROUND (now
   3733       * PNG_COMPOSE).  This effectively smashed the background calculation for
   3734       * 16-bit output because the 8-bit table assumes the result will be
   3735       * reduced to 8 bits.
   3736       */
   3737      if ((png_ptr->transformations & (PNG_16_TO_8 | PNG_SCALE_16_TO_8)) != 0)
   3738         png_build_16to8_table(png_ptr, &png_ptr->gamma_16_table, shift,
   3739            png_reciprocal(correction));
   3740      else
   3741         png_build_16bit_table(png_ptr, &png_ptr->gamma_16_table, shift,
   3742            correction);
   3743 
   3744 #  if GAMMA_TRANSFORMS
   3745      if ((png_ptr->transformations & (PNG_COMPOSE | PNG_RGB_TO_GRAY)) != 0)
   3746      {
   3747         png_build_16bit_table(png_ptr, &png_ptr->gamma_16_to_1, shift,
   3748            file_to_linear);
   3749 
   3750         /* Notice that the '16 from 1' table should be full precision, however
   3751          * the lookup on this table still uses gamma_shift, so it can't be.
   3752          * TODO: fix this.
   3753          */
   3754         png_build_16bit_table(png_ptr, &png_ptr->gamma_16_from_1, shift,
   3755            linear_to_screen);
   3756      }
   3757 #endif /* GAMMA_TRANSFORMS */
   3758   }
   3759 #endif /* 16BIT */
   3760 }
   3761 #endif /* READ_GAMMA */
   3762 
   3763 /* HARDWARE OR SOFTWARE OPTION SUPPORT */
   3764 #ifdef PNG_SET_OPTION_SUPPORTED
   3765 int PNGAPI
   3766 png_set_option(png_structrp png_ptr, int option, int onoff)
   3767 {
   3768   if (png_ptr != NULL && option >= 0 && option < PNG_OPTION_NEXT &&
   3769      (option & 1) == 0)
   3770   {
   3771      png_uint_32 mask = 3U << option;
   3772      png_uint_32 setting = (2U + (onoff != 0)) << option;
   3773      png_uint_32 current = png_ptr->options;
   3774 
   3775      png_ptr->options = (png_uint_32)((current & ~mask) | setting);
   3776 
   3777      return (int)(current & mask) >> option;
   3778   }
   3779 
   3780   return PNG_OPTION_INVALID;
   3781 }
   3782 #endif
   3783 
   3784 /* sRGB support */
   3785 #if defined(PNG_SIMPLIFIED_READ_SUPPORTED) ||\
   3786   defined(PNG_SIMPLIFIED_WRITE_SUPPORTED)
   3787 /* sRGB conversion tables; these are machine generated with the code in
   3788 * contrib/tools/makesRGB.c.  The actual sRGB transfer curve defined in the
   3789 * specification (see the article at https://en.wikipedia.org/wiki/SRGB)
   3790 * is used, not the gamma=1/2.2 approximation use elsewhere in libpng.
   3791 * The sRGB to linear table is exact (to the nearest 16-bit linear fraction).
   3792 * The inverse (linear to sRGB) table has accuracies as follows:
   3793 *
   3794 * For all possible (255*65535+1) input values:
   3795 *
   3796 *    error: -0.515566 - 0.625971, 79441 (0.475369%) of readings inexact
   3797 *
   3798 * For the input values corresponding to the 65536 16-bit values:
   3799 *
   3800 *    error: -0.513727 - 0.607759, 308 (0.469978%) of readings inexact
   3801 *
   3802 * In all cases the inexact readings are only off by one.
   3803 */
   3804 
   3805 #ifdef PNG_SIMPLIFIED_READ_SUPPORTED
   3806 /* The convert-to-sRGB table is only currently required for read. */
   3807 const png_uint_16 png_sRGB_table[256] =
   3808 {
   3809   0,20,40,60,80,99,119,139,
   3810   159,179,199,219,241,264,288,313,
   3811   340,367,396,427,458,491,526,562,
   3812   599,637,677,718,761,805,851,898,
   3813   947,997,1048,1101,1156,1212,1270,1330,
   3814   1391,1453,1517,1583,1651,1720,1790,1863,
   3815   1937,2013,2090,2170,2250,2333,2418,2504,
   3816   2592,2681,2773,2866,2961,3058,3157,3258,
   3817   3360,3464,3570,3678,3788,3900,4014,4129,
   3818   4247,4366,4488,4611,4736,4864,4993,5124,
   3819   5257,5392,5530,5669,5810,5953,6099,6246,
   3820   6395,6547,6700,6856,7014,7174,7335,7500,
   3821   7666,7834,8004,8177,8352,8528,8708,8889,
   3822   9072,9258,9445,9635,9828,10022,10219,10417,
   3823   10619,10822,11028,11235,11446,11658,11873,12090,
   3824   12309,12530,12754,12980,13209,13440,13673,13909,
   3825   14146,14387,14629,14874,15122,15371,15623,15878,
   3826   16135,16394,16656,16920,17187,17456,17727,18001,
   3827   18277,18556,18837,19121,19407,19696,19987,20281,
   3828   20577,20876,21177,21481,21787,22096,22407,22721,
   3829   23038,23357,23678,24002,24329,24658,24990,25325,
   3830   25662,26001,26344,26688,27036,27386,27739,28094,
   3831   28452,28813,29176,29542,29911,30282,30656,31033,
   3832   31412,31794,32179,32567,32957,33350,33745,34143,
   3833   34544,34948,35355,35764,36176,36591,37008,37429,
   3834   37852,38278,38706,39138,39572,40009,40449,40891,
   3835   41337,41785,42236,42690,43147,43606,44069,44534,
   3836   45002,45473,45947,46423,46903,47385,47871,48359,
   3837   48850,49344,49841,50341,50844,51349,51858,52369,
   3838   52884,53401,53921,54445,54971,55500,56032,56567,
   3839   57105,57646,58190,58737,59287,59840,60396,60955,
   3840   61517,62082,62650,63221,63795,64372,64952,65535
   3841 };
   3842 #endif /* SIMPLIFIED_READ */
   3843 
   3844 /* The base/delta tables are required for both read and write (but currently
   3845 * only the simplified versions.)
   3846 */
   3847 const png_uint_16 png_sRGB_base[512] =
   3848 {
   3849   128,1782,3383,4644,5675,6564,7357,8074,
   3850   8732,9346,9921,10463,10977,11466,11935,12384,
   3851   12816,13233,13634,14024,14402,14769,15125,15473,
   3852   15812,16142,16466,16781,17090,17393,17690,17981,
   3853   18266,18546,18822,19093,19359,19621,19879,20133,
   3854   20383,20630,20873,21113,21349,21583,21813,22041,
   3855   22265,22487,22707,22923,23138,23350,23559,23767,
   3856   23972,24175,24376,24575,24772,24967,25160,25352,
   3857   25542,25730,25916,26101,26284,26465,26645,26823,
   3858   27000,27176,27350,27523,27695,27865,28034,28201,
   3859   28368,28533,28697,28860,29021,29182,29341,29500,
   3860   29657,29813,29969,30123,30276,30429,30580,30730,
   3861   30880,31028,31176,31323,31469,31614,31758,31902,
   3862   32045,32186,32327,32468,32607,32746,32884,33021,
   3863   33158,33294,33429,33564,33697,33831,33963,34095,
   3864   34226,34357,34486,34616,34744,34873,35000,35127,
   3865   35253,35379,35504,35629,35753,35876,35999,36122,
   3866   36244,36365,36486,36606,36726,36845,36964,37083,
   3867   37201,37318,37435,37551,37668,37783,37898,38013,
   3868   38127,38241,38354,38467,38580,38692,38803,38915,
   3869   39026,39136,39246,39356,39465,39574,39682,39790,
   3870   39898,40005,40112,40219,40325,40431,40537,40642,
   3871   40747,40851,40955,41059,41163,41266,41369,41471,
   3872   41573,41675,41777,41878,41979,42079,42179,42279,
   3873   42379,42478,42577,42676,42775,42873,42971,43068,
   3874   43165,43262,43359,43456,43552,43648,43743,43839,
   3875   43934,44028,44123,44217,44311,44405,44499,44592,
   3876   44685,44778,44870,44962,45054,45146,45238,45329,
   3877   45420,45511,45601,45692,45782,45872,45961,46051,
   3878   46140,46229,46318,46406,46494,46583,46670,46758,
   3879   46846,46933,47020,47107,47193,47280,47366,47452,
   3880   47538,47623,47709,47794,47879,47964,48048,48133,
   3881   48217,48301,48385,48468,48552,48635,48718,48801,
   3882   48884,48966,49048,49131,49213,49294,49376,49458,
   3883   49539,49620,49701,49782,49862,49943,50023,50103,
   3884   50183,50263,50342,50422,50501,50580,50659,50738,
   3885   50816,50895,50973,51051,51129,51207,51285,51362,
   3886   51439,51517,51594,51671,51747,51824,51900,51977,
   3887   52053,52129,52205,52280,52356,52432,52507,52582,
   3888   52657,52732,52807,52881,52956,53030,53104,53178,
   3889   53252,53326,53400,53473,53546,53620,53693,53766,
   3890   53839,53911,53984,54056,54129,54201,54273,54345,
   3891   54417,54489,54560,54632,54703,54774,54845,54916,
   3892   54987,55058,55129,55199,55269,55340,55410,55480,
   3893   55550,55620,55689,55759,55828,55898,55967,56036,
   3894   56105,56174,56243,56311,56380,56448,56517,56585,
   3895   56653,56721,56789,56857,56924,56992,57059,57127,
   3896   57194,57261,57328,57395,57462,57529,57595,57662,
   3897   57728,57795,57861,57927,57993,58059,58125,58191,
   3898   58256,58322,58387,58453,58518,58583,58648,58713,
   3899   58778,58843,58908,58972,59037,59101,59165,59230,
   3900   59294,59358,59422,59486,59549,59613,59677,59740,
   3901   59804,59867,59930,59993,60056,60119,60182,60245,
   3902   60308,60370,60433,60495,60558,60620,60682,60744,
   3903   60806,60868,60930,60992,61054,61115,61177,61238,
   3904   61300,61361,61422,61483,61544,61605,61666,61727,
   3905   61788,61848,61909,61969,62030,62090,62150,62211,
   3906   62271,62331,62391,62450,62510,62570,62630,62689,
   3907   62749,62808,62867,62927,62986,63045,63104,63163,
   3908   63222,63281,63340,63398,63457,63515,63574,63632,
   3909   63691,63749,63807,63865,63923,63981,64039,64097,
   3910   64155,64212,64270,64328,64385,64443,64500,64557,
   3911   64614,64672,64729,64786,64843,64900,64956,65013,
   3912   65070,65126,65183,65239,65296,65352,65409,65465
   3913 };
   3914 
   3915 const png_byte png_sRGB_delta[512] =
   3916 {
   3917   207,201,158,129,113,100,90,82,77,72,68,64,61,59,56,54,
   3918   52,50,49,47,46,45,43,42,41,40,39,39,38,37,36,36,
   3919   35,34,34,33,33,32,32,31,31,30,30,30,29,29,28,28,
   3920   28,27,27,27,27,26,26,26,25,25,25,25,24,24,24,24,
   3921   23,23,23,23,23,22,22,22,22,22,22,21,21,21,21,21,
   3922   21,20,20,20,20,20,20,20,20,19,19,19,19,19,19,19,
   3923   19,18,18,18,18,18,18,18,18,18,18,17,17,17,17,17,
   3924   17,17,17,17,17,17,16,16,16,16,16,16,16,16,16,16,
   3925   16,16,16,16,15,15,15,15,15,15,15,15,15,15,15,15,
   3926   15,15,15,15,14,14,14,14,14,14,14,14,14,14,14,14,
   3927   14,14,14,14,14,14,14,13,13,13,13,13,13,13,13,13,
   3928   13,13,13,13,13,13,13,13,13,13,13,13,13,13,12,12,
   3929   12,12,12,12,12,12,12,12,12,12,12,12,12,12,12,12,
   3930   12,12,12,12,12,12,12,12,12,12,12,12,11,11,11,11,
   3931   11,11,11,11,11,11,11,11,11,11,11,11,11,11,11,11,
   3932   11,11,11,11,11,11,11,11,11,11,11,11,11,11,11,11,
   3933   11,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,
   3934   10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,
   3935   10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,
   3936   10,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,
   3937   9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,
   3938   9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,
   3939   9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,
   3940   9,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,
   3941   8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,
   3942   8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,
   3943   8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,
   3944   8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,
   3945   8,8,8,8,8,8,8,8,8,7,7,7,7,7,7,7,
   3946   7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,
   3947   7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,
   3948   7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7
   3949 };
   3950 #endif /* SIMPLIFIED READ/WRITE sRGB support */
   3951 
   3952 /* SIMPLIFIED READ/WRITE SUPPORT */
   3953 #if defined(PNG_SIMPLIFIED_READ_SUPPORTED) ||\
   3954   defined(PNG_SIMPLIFIED_WRITE_SUPPORTED)
   3955 static int
   3956 png_image_free_function(png_voidp argument)
   3957 {
   3958   png_imagep image = png_voidcast(png_imagep, argument);
   3959   png_controlp cp = image->opaque;
   3960   png_control c;
   3961 
   3962   /* Double check that we have a png_ptr - it should be impossible to get here
   3963    * without one.
   3964    */
   3965   if (cp->png_ptr == NULL)
   3966      return 0;
   3967 
   3968   /* First free any data held in the control structure. */
   3969 #  ifdef PNG_STDIO_SUPPORTED
   3970      if (cp->owned_file != 0)
   3971      {
   3972         FILE *fp = png_voidcast(FILE *, cp->png_ptr->io_ptr);
   3973         cp->owned_file = 0;
   3974 
   3975         /* Ignore errors here. */
   3976         if (fp != NULL)
   3977         {
   3978            cp->png_ptr->io_ptr = NULL;
   3979            (void)fclose(fp);
   3980         }
   3981      }
   3982 #  endif
   3983 
   3984   /* Copy the control structure so that the original, allocated, version can be
   3985    * safely freed.  Notice that a png_error here stops the remainder of the
   3986    * cleanup, but this is probably fine because that would indicate bad memory
   3987    * problems anyway.
   3988    */
   3989   c = *cp;
   3990   image->opaque = &c;
   3991   png_free(c.png_ptr, cp);
   3992 
   3993   /* Then the structures, calling the correct API. */
   3994   if (c.for_write != 0)
   3995   {
   3996 #     ifdef PNG_SIMPLIFIED_WRITE_SUPPORTED
   3997         png_destroy_write_struct(&c.png_ptr, &c.info_ptr);
   3998 #     else
   3999         png_error(c.png_ptr, "simplified write not supported");
   4000 #     endif
   4001   }
   4002   else
   4003   {
   4004 #     ifdef PNG_SIMPLIFIED_READ_SUPPORTED
   4005         png_destroy_read_struct(&c.png_ptr, &c.info_ptr, NULL);
   4006 #     else
   4007         png_error(c.png_ptr, "simplified read not supported");
   4008 #     endif
   4009   }
   4010 
   4011   /* Success. */
   4012   return 1;
   4013 }
   4014 
   4015 void PNGAPI
   4016 png_image_free(png_imagep image)
   4017 {
   4018   /* Safely call the real function, but only if doing so is safe at this point
   4019    * (if not inside an error handling context).  Otherwise assume
   4020    * png_safe_execute will call this API after the return.
   4021    */
   4022   if (image != NULL && image->opaque != NULL &&
   4023      image->opaque->error_buf == NULL)
   4024   {
   4025      png_image_free_function(image);
   4026      image->opaque = NULL;
   4027   }
   4028 }
   4029 
   4030 int /* PRIVATE */
   4031 png_image_error(png_imagep image, png_const_charp error_message)
   4032 {
   4033   /* Utility to log an error. */
   4034   png_safecat(image->message, (sizeof image->message), 0, error_message);
   4035   image->warning_or_error |= PNG_IMAGE_ERROR;
   4036   png_image_free(image);
   4037   return 0;
   4038 }
   4039 
   4040 #endif /* SIMPLIFIED READ/WRITE */
   4041 #endif /* READ || WRITE */