grub2: bring back build of aros-side grub2 tools
[AROS.git] / workbench / libs / png / png.c
blobf29d7dadc2b9ce3a2240badc71574d7ea6b64c34
2 /* png.c - location for general purpose libpng functions
4 * Last changed in libpng 1.6.2 [April 25, 2013]
5 * Copyright (c) 1998-2013 Glenn Randers-Pehrson
6 * (Version 0.96 Copyright (c) 1996, 1997 Andreas Dilger)
7 * (Version 0.88 Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.)
9 * This code is released under the libpng license.
10 * For conditions of distribution and use, see the disclaimer
11 * and license in png.h
14 #include "pngpriv.h"
16 /* Generate a compiler error if there is an old png.h in the search path. */
17 typedef png_libpng_version_1_6_3 Your_png_h_is_not_version_1_6_3;
19 /* Tells libpng that we have already handled the first "num_bytes" bytes
20 * of the PNG file signature. If the PNG data is embedded into another
21 * stream we can set num_bytes = 8 so that libpng will not attempt to read
22 * or write any of the magic bytes before it starts on the IHDR.
25 #ifdef PNG_READ_SUPPORTED
26 void PNGAPI
27 png_set_sig_bytes(png_structrp png_ptr, int num_bytes)
29 png_debug(1, "in png_set_sig_bytes");
31 if (png_ptr == NULL)
32 return;
34 if (num_bytes > 8)
35 png_error(png_ptr, "Too many bytes for PNG signature");
37 png_ptr->sig_bytes = (png_byte)(num_bytes < 0 ? 0 : num_bytes);
40 /* Checks whether the supplied bytes match the PNG signature. We allow
41 * checking less than the full 8-byte signature so that those apps that
42 * already read the first few bytes of a file to determine the file type
43 * can simply check the remaining bytes for extra assurance. Returns
44 * an integer less than, equal to, or greater than zero if sig is found,
45 * respectively, to be less than, to match, or be greater than the correct
46 * PNG signature (this is the same behavior as strcmp, memcmp, etc).
48 int PNGAPI
49 png_sig_cmp(png_const_bytep sig, png_size_t start, png_size_t num_to_check)
51 png_byte png_signature[8] = {137, 80, 78, 71, 13, 10, 26, 10};
53 if (num_to_check > 8)
54 num_to_check = 8;
56 else if (num_to_check < 1)
57 return (-1);
59 if (start > 7)
60 return (-1);
62 if (start + num_to_check > 8)
63 num_to_check = 8 - start;
65 return ((int)(memcmp(&sig[start], &png_signature[start], num_to_check)));
68 #endif /* PNG_READ_SUPPORTED */
70 #ifdef __AROS__
71 #ifdef PNG_READ_SUPPORTED
72 /* (Obsolete) function to check signature bytes. It does not allow one
73 * to check a partial signature. This function might be removed in the
74 * future - use png_sig_cmp(). Returns true (nonzero) if the file is PNG.
76 int PNGAPI
77 png_check_sig_(png_bytep sig, int num)
79 return ((int)!png_sig_cmp(sig, (png_size_t)0, (png_size_t)num));
81 #endif /* PNG_READ_SUPPORTED */
82 #endif /* __AROS__ */
84 #if defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED)
85 /* Function to allocate memory for zlib */
86 PNG_FUNCTION(voidpf /* PRIVATE */,
87 png_zalloc,(voidpf png_ptr, uInt items, uInt size),PNG_ALLOCATED)
89 png_alloc_size_t num_bytes = size;
91 if (png_ptr == NULL)
92 return NULL;
94 if (items >= (~(png_alloc_size_t)0)/size)
96 png_warning (png_voidcast(png_structrp, png_ptr),
97 "Potential overflow in png_zalloc()");
98 return NULL;
101 num_bytes *= items;
102 return png_malloc_warn(png_voidcast(png_structrp, png_ptr), num_bytes);
105 /* Function to free memory for zlib */
106 void /* PRIVATE */
107 png_zfree(voidpf png_ptr, voidpf ptr)
109 png_free(png_voidcast(png_const_structrp,png_ptr), ptr);
112 /* Reset the CRC variable to 32 bits of 1's. Care must be taken
113 * in case CRC is > 32 bits to leave the top bits 0.
115 void /* PRIVATE */
116 png_reset_crc(png_structrp png_ptr)
118 /* The cast is safe because the crc is a 32 bit value. */
119 png_ptr->crc = (png_uint_32)crc32(0, Z_NULL, 0);
122 /* Calculate the CRC over a section of data. We can only pass as
123 * much data to this routine as the largest single buffer size. We
124 * also check that this data will actually be used before going to the
125 * trouble of calculating it.
127 void /* PRIVATE */
128 png_calculate_crc(png_structrp png_ptr, png_const_bytep ptr, png_size_t length)
130 int need_crc = 1;
132 if (PNG_CHUNK_ANCILLARY(png_ptr->chunk_name))
134 if ((png_ptr->flags & PNG_FLAG_CRC_ANCILLARY_MASK) ==
135 (PNG_FLAG_CRC_ANCILLARY_USE | PNG_FLAG_CRC_ANCILLARY_NOWARN))
136 need_crc = 0;
139 else /* critical */
141 if (png_ptr->flags & PNG_FLAG_CRC_CRITICAL_IGNORE)
142 need_crc = 0;
145 /* 'uLong' is defined in zlib.h as unsigned long; this means that on some
146 * systems it is a 64 bit value. crc32, however, returns 32 bits so the
147 * following cast is safe. 'uInt' may be no more than 16 bits, so it is
148 * necessary to perform a loop here.
150 if (need_crc && length > 0)
152 uLong crc = png_ptr->crc; /* Should never issue a warning */
156 uInt safe_length = (uInt)length;
157 if (safe_length == 0)
158 safe_length = (uInt)-1; /* evil, but safe */
160 crc = crc32(crc, ptr, safe_length);
162 /* The following should never issue compiler warnings; if they do the
163 * target system has characteristics that will probably violate other
164 * assumptions within the libpng code.
166 ptr += safe_length;
167 length -= safe_length;
169 while (length > 0);
171 /* And the following is always safe because the crc is only 32 bits. */
172 png_ptr->crc = (png_uint_32)crc;
176 /* Check a user supplied version number, called from both read and write
177 * functions that create a png_struct.
180 png_user_version_check(png_structrp png_ptr, png_const_charp user_png_ver)
182 if (user_png_ver)
184 int i = 0;
188 if (user_png_ver[i] != png_libpng_ver[i])
189 png_ptr->flags |= PNG_FLAG_LIBRARY_MISMATCH;
190 } while (png_libpng_ver[i++]);
193 else
194 png_ptr->flags |= PNG_FLAG_LIBRARY_MISMATCH;
196 if (png_ptr->flags & PNG_FLAG_LIBRARY_MISMATCH)
198 /* Libpng 0.90 and later are binary incompatible with libpng 0.89, so
199 * we must recompile any applications that use any older library version.
200 * For versions after libpng 1.0, we will be compatible, so we need
201 * only check the first and third digits (note that when we reach version
202 * 1.10 we will need to check the fourth symbol, namely user_png_ver[3]).
204 if (user_png_ver == NULL || user_png_ver[0] != png_libpng_ver[0] ||
205 (user_png_ver[0] == '1' && (user_png_ver[2] != png_libpng_ver[2] ||
206 user_png_ver[3] != png_libpng_ver[3])) ||
207 (user_png_ver[0] == '0' && user_png_ver[2] < '9'))
209 #ifdef PNG_WARNINGS_SUPPORTED
210 size_t pos = 0;
211 char m[128];
213 pos = png_safecat(m, (sizeof m), pos,
214 "Application built with libpng-");
215 pos = png_safecat(m, (sizeof m), pos, user_png_ver);
216 pos = png_safecat(m, (sizeof m), pos, " but running with ");
217 pos = png_safecat(m, (sizeof m), pos, png_libpng_ver);
219 png_warning(png_ptr, m);
220 #endif
222 #ifdef PNG_ERROR_NUMBERS_SUPPORTED
223 png_ptr->flags = 0;
224 #endif
226 return 0;
230 /* Success return. */
231 return 1;
234 /* Generic function to create a png_struct for either read or write - this
235 * contains the common initialization.
237 PNG_FUNCTION(png_structp /* PRIVATE */,
238 png_create_png_struct,(png_const_charp user_png_ver, png_voidp error_ptr,
239 png_error_ptr error_fn, png_error_ptr warn_fn, png_voidp mem_ptr,
240 png_malloc_ptr malloc_fn, png_free_ptr free_fn),PNG_ALLOCATED)
242 png_struct create_struct;
243 # ifdef PNG_SETJMP_SUPPORTED
244 jmp_buf create_jmp_buf;
245 # endif
247 /* This temporary stack-allocated structure is used to provide a place to
248 * build enough context to allow the user provided memory allocator (if any)
249 * to be called.
251 memset(&create_struct, 0, (sizeof create_struct));
253 /* Added at libpng-1.2.6 */
254 # ifdef PNG_USER_LIMITS_SUPPORTED
255 create_struct.user_width_max = PNG_USER_WIDTH_MAX;
256 create_struct.user_height_max = PNG_USER_HEIGHT_MAX;
258 # ifdef PNG_USER_CHUNK_CACHE_MAX
259 /* Added at libpng-1.2.43 and 1.4.0 */
260 create_struct.user_chunk_cache_max = PNG_USER_CHUNK_CACHE_MAX;
261 # endif
263 # ifdef PNG_USER_CHUNK_MALLOC_MAX
264 /* Added at libpng-1.2.43 and 1.4.1, required only for read but exists
265 * in png_struct regardless.
267 create_struct.user_chunk_malloc_max = PNG_USER_CHUNK_MALLOC_MAX;
268 # endif
269 # endif
271 /* The following two API calls simply set fields in png_struct, so it is safe
272 * to do them now even though error handling is not yet set up.
274 # ifdef PNG_USER_MEM_SUPPORTED
275 png_set_mem_fn(&create_struct, mem_ptr, malloc_fn, free_fn);
276 # endif
278 /* (*error_fn) can return control to the caller after the error_ptr is set,
279 * this will result in a memory leak unless the error_fn does something
280 * extremely sophisticated. The design lacks merit but is implicit in the
281 * API.
283 png_set_error_fn(&create_struct, error_ptr, error_fn, warn_fn);
285 # ifdef PNG_SETJMP_SUPPORTED
286 if (!setjmp(create_jmp_buf))
288 /* Temporarily fake out the longjmp information until we have
289 * successfully completed this function. This only works if we have
290 * setjmp() support compiled in, but it is safe - this stuff should
291 * never happen.
293 create_struct.jmp_buf_ptr = &create_jmp_buf;
294 create_struct.jmp_buf_size = 0; /*stack allocation*/
295 create_struct.longjmp_fn = longjmp;
296 # else
298 # endif
299 /* Call the general version checker (shared with read and write code):
301 if (png_user_version_check(&create_struct, user_png_ver))
303 png_structrp png_ptr = png_voidcast(png_structrp,
304 png_malloc_warn(&create_struct, (sizeof *png_ptr)));
306 if (png_ptr != NULL)
308 /* png_ptr->zstream holds a back-pointer to the png_struct, so
309 * this can only be done now:
311 create_struct.zstream.zalloc = png_zalloc;
312 create_struct.zstream.zfree = png_zfree;
313 create_struct.zstream.opaque = png_ptr;
315 # ifdef PNG_SETJMP_SUPPORTED
316 /* Eliminate the local error handling: */
317 create_struct.jmp_buf_ptr = NULL;
318 create_struct.jmp_buf_size = 0;
319 create_struct.longjmp_fn = 0;
320 # endif
322 *png_ptr = create_struct;
324 /* This is the successful return point */
325 return png_ptr;
330 /* A longjmp because of a bug in the application storage allocator or a
331 * simple failure to allocate the png_struct.
333 return NULL;
336 /* Allocate the memory for an info_struct for the application. */
337 PNG_FUNCTION(png_infop,PNGAPI
338 png_create_info_struct,(png_const_structrp png_ptr),PNG_ALLOCATED)
340 png_inforp info_ptr;
342 png_debug(1, "in png_create_info_struct");
344 if (png_ptr == NULL)
345 return NULL;
347 /* Use the internal API that does not (or at least should not) error out, so
348 * that this call always returns ok. The application typically sets up the
349 * error handling *after* creating the info_struct because this is the way it
350 * has always been done in 'example.c'.
352 info_ptr = png_voidcast(png_inforp, png_malloc_base(png_ptr,
353 (sizeof *info_ptr)));
355 if (info_ptr != NULL)
356 memset(info_ptr, 0, (sizeof *info_ptr));
358 return info_ptr;
361 /* This function frees the memory associated with a single info struct.
362 * Normally, one would use either png_destroy_read_struct() or
363 * png_destroy_write_struct() to free an info struct, but this may be
364 * useful for some applications. From libpng 1.6.0 this function is also used
365 * internally to implement the png_info release part of the 'struct' destroy
366 * APIs. This ensures that all possible approaches free the same data (all of
367 * it).
369 void PNGAPI
370 png_destroy_info_struct(png_const_structrp png_ptr, png_infopp info_ptr_ptr)
372 png_inforp info_ptr = NULL;
374 png_debug(1, "in png_destroy_info_struct");
376 if (png_ptr == NULL)
377 return;
379 if (info_ptr_ptr != NULL)
380 info_ptr = *info_ptr_ptr;
382 if (info_ptr != NULL)
384 /* Do this first in case of an error below; if the app implements its own
385 * memory management this can lead to png_free calling png_error, which
386 * will abort this routine and return control to the app error handler.
387 * An infinite loop may result if it then tries to free the same info
388 * ptr.
390 *info_ptr_ptr = NULL;
392 png_free_data(png_ptr, info_ptr, PNG_FREE_ALL, -1);
393 memset(info_ptr, 0, (sizeof *info_ptr));
394 png_free(png_ptr, info_ptr);
398 /* Initialize the info structure. This is now an internal function (0.89)
399 * and applications using it are urged to use png_create_info_struct()
400 * instead. Use deprecated in 1.6.0, internal use removed (used internally it
401 * is just a memset).
403 * NOTE: it is almost inconceivable that this API is used because it bypasses
404 * the user-memory mechanism and the user error handling/warning mechanisms in
405 * those cases where it does anything other than a memset.
407 PNG_FUNCTION(void,PNGAPI
408 png_info_init_3,(png_infopp ptr_ptr, png_size_t png_info_struct_size),
409 PNG_DEPRECATED)
411 png_inforp info_ptr = *ptr_ptr;
413 png_debug(1, "in png_info_init_3");
415 if (info_ptr == NULL)
416 return;
418 if ((sizeof (png_info)) > png_info_struct_size)
420 *ptr_ptr = NULL;
421 /* The following line is why this API should not be used: */
422 free(info_ptr);
423 info_ptr = png_voidcast(png_inforp, png_malloc_base(NULL,
424 (sizeof *info_ptr)));
425 *ptr_ptr = info_ptr;
428 /* Set everything to 0 */
429 memset(info_ptr, 0, (sizeof *info_ptr));
432 /* The following API is not called internally */
433 void PNGAPI
434 png_data_freer(png_const_structrp png_ptr, png_inforp info_ptr,
435 int freer, png_uint_32 mask)
437 png_debug(1, "in png_data_freer");
439 if (png_ptr == NULL || info_ptr == NULL)
440 return;
442 if (freer == PNG_DESTROY_WILL_FREE_DATA)
443 info_ptr->free_me |= mask;
445 else if (freer == PNG_USER_WILL_FREE_DATA)
446 info_ptr->free_me &= ~mask;
448 else
449 png_error(png_ptr, "Unknown freer parameter in png_data_freer");
452 void PNGAPI
453 png_free_data(png_const_structrp png_ptr, png_inforp info_ptr, png_uint_32 mask,
454 int num)
456 png_debug(1, "in png_free_data");
458 if (png_ptr == NULL || info_ptr == NULL)
459 return;
461 #ifdef PNG_TEXT_SUPPORTED
462 /* Free text item num or (if num == -1) all text items */
463 if ((mask & PNG_FREE_TEXT) & info_ptr->free_me)
465 if (num != -1)
467 if (info_ptr->text && info_ptr->text[num].key)
469 png_free(png_ptr, info_ptr->text[num].key);
470 info_ptr->text[num].key = NULL;
474 else
476 int i;
477 for (i = 0; i < info_ptr->num_text; i++)
478 png_free_data(png_ptr, info_ptr, PNG_FREE_TEXT, i);
479 png_free(png_ptr, info_ptr->text);
480 info_ptr->text = NULL;
481 info_ptr->num_text=0;
484 #endif
486 #ifdef PNG_tRNS_SUPPORTED
487 /* Free any tRNS entry */
488 if ((mask & PNG_FREE_TRNS) & info_ptr->free_me)
490 png_free(png_ptr, info_ptr->trans_alpha);
491 info_ptr->trans_alpha = NULL;
492 info_ptr->valid &= ~PNG_INFO_tRNS;
494 #endif
496 #ifdef PNG_sCAL_SUPPORTED
497 /* Free any sCAL entry */
498 if ((mask & PNG_FREE_SCAL) & info_ptr->free_me)
500 png_free(png_ptr, info_ptr->scal_s_width);
501 png_free(png_ptr, info_ptr->scal_s_height);
502 info_ptr->scal_s_width = NULL;
503 info_ptr->scal_s_height = NULL;
504 info_ptr->valid &= ~PNG_INFO_sCAL;
506 #endif
508 #ifdef PNG_pCAL_SUPPORTED
509 /* Free any pCAL entry */
510 if ((mask & PNG_FREE_PCAL) & info_ptr->free_me)
512 png_free(png_ptr, info_ptr->pcal_purpose);
513 png_free(png_ptr, info_ptr->pcal_units);
514 info_ptr->pcal_purpose = NULL;
515 info_ptr->pcal_units = NULL;
516 if (info_ptr->pcal_params != NULL)
518 unsigned int i;
519 for (i = 0; i < info_ptr->pcal_nparams; i++)
521 png_free(png_ptr, info_ptr->pcal_params[i]);
522 info_ptr->pcal_params[i] = NULL;
524 png_free(png_ptr, info_ptr->pcal_params);
525 info_ptr->pcal_params = NULL;
527 info_ptr->valid &= ~PNG_INFO_pCAL;
529 #endif
531 #ifdef PNG_iCCP_SUPPORTED
532 /* Free any profile entry */
533 if ((mask & PNG_FREE_ICCP) & info_ptr->free_me)
535 png_free(png_ptr, info_ptr->iccp_name);
536 png_free(png_ptr, info_ptr->iccp_profile);
537 info_ptr->iccp_name = NULL;
538 info_ptr->iccp_profile = NULL;
539 info_ptr->valid &= ~PNG_INFO_iCCP;
541 #endif
543 #ifdef PNG_sPLT_SUPPORTED
544 /* Free a given sPLT entry, or (if num == -1) all sPLT entries */
545 if ((mask & PNG_FREE_SPLT) & info_ptr->free_me)
547 if (num != -1)
549 if (info_ptr->splt_palettes)
551 png_free(png_ptr, info_ptr->splt_palettes[num].name);
552 png_free(png_ptr, info_ptr->splt_palettes[num].entries);
553 info_ptr->splt_palettes[num].name = NULL;
554 info_ptr->splt_palettes[num].entries = NULL;
558 else
560 if (info_ptr->splt_palettes_num)
562 int i;
563 for (i = 0; i < info_ptr->splt_palettes_num; i++)
564 png_free_data(png_ptr, info_ptr, PNG_FREE_SPLT, (int)i);
566 png_free(png_ptr, info_ptr->splt_palettes);
567 info_ptr->splt_palettes = NULL;
568 info_ptr->splt_palettes_num = 0;
570 info_ptr->valid &= ~PNG_INFO_sPLT;
573 #endif
575 #ifdef PNG_STORE_UNKNOWN_CHUNKS_SUPPORTED
576 if ((mask & PNG_FREE_UNKN) & info_ptr->free_me)
578 if (num != -1)
580 if (info_ptr->unknown_chunks)
582 png_free(png_ptr, info_ptr->unknown_chunks[num].data);
583 info_ptr->unknown_chunks[num].data = NULL;
587 else
589 int i;
591 if (info_ptr->unknown_chunks_num)
593 for (i = 0; i < info_ptr->unknown_chunks_num; i++)
594 png_free_data(png_ptr, info_ptr, PNG_FREE_UNKN, (int)i);
596 png_free(png_ptr, info_ptr->unknown_chunks);
597 info_ptr->unknown_chunks = NULL;
598 info_ptr->unknown_chunks_num = 0;
602 #endif
604 #ifdef PNG_hIST_SUPPORTED
605 /* Free any hIST entry */
606 if ((mask & PNG_FREE_HIST) & info_ptr->free_me)
608 png_free(png_ptr, info_ptr->hist);
609 info_ptr->hist = NULL;
610 info_ptr->valid &= ~PNG_INFO_hIST;
612 #endif
614 /* Free any PLTE entry that was internally allocated */
615 if ((mask & PNG_FREE_PLTE) & info_ptr->free_me)
617 png_free(png_ptr, info_ptr->palette);
618 info_ptr->palette = NULL;
619 info_ptr->valid &= ~PNG_INFO_PLTE;
620 info_ptr->num_palette = 0;
623 #ifdef PNG_INFO_IMAGE_SUPPORTED
624 /* Free any image bits attached to the info structure */
625 if ((mask & PNG_FREE_ROWS) & info_ptr->free_me)
627 if (info_ptr->row_pointers)
629 png_uint_32 row;
630 for (row = 0; row < info_ptr->height; row++)
632 png_free(png_ptr, info_ptr->row_pointers[row]);
633 info_ptr->row_pointers[row] = NULL;
635 png_free(png_ptr, info_ptr->row_pointers);
636 info_ptr->row_pointers = NULL;
638 info_ptr->valid &= ~PNG_INFO_IDAT;
640 #endif
642 if (num != -1)
643 mask &= ~PNG_FREE_MUL;
645 info_ptr->free_me &= ~mask;
647 #endif /* defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED) */
649 /* This function returns a pointer to the io_ptr associated with the user
650 * functions. The application should free any memory associated with this
651 * pointer before png_write_destroy() or png_read_destroy() are called.
653 png_voidp PNGAPI
654 png_get_io_ptr(png_const_structrp png_ptr)
656 if (png_ptr == NULL)
657 return (NULL);
659 return (png_ptr->io_ptr);
662 #if defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED)
663 # ifdef PNG_STDIO_SUPPORTED
664 /* Initialize the default input/output functions for the PNG file. If you
665 * use your own read or write routines, you can call either png_set_read_fn()
666 * or png_set_write_fn() instead of png_init_io(). If you have defined
667 * PNG_NO_STDIO or otherwise disabled PNG_STDIO_SUPPORTED, you must use a
668 * function of your own because "FILE *" isn't necessarily available.
670 void PNGAPI
671 png_init_io(png_structrp png_ptr, png_FILE_p fp)
673 png_debug(1, "in png_init_io");
675 if (png_ptr == NULL)
676 return;
678 png_ptr->io_ptr = (png_voidp)fp;
680 # endif
682 #ifdef PNG_SAVE_INT_32_SUPPORTED
683 /* The png_save_int_32 function assumes integers are stored in two's
684 * complement format. If this isn't the case, then this routine needs to
685 * be modified to write data in two's complement format. Note that,
686 * the following works correctly even if png_int_32 has more than 32 bits
687 * (compare the more complex code required on read for sign extension.)
689 void PNGAPI
690 png_save_int_32(png_bytep buf, png_int_32 i)
692 buf[0] = (png_byte)((i >> 24) & 0xff);
693 buf[1] = (png_byte)((i >> 16) & 0xff);
694 buf[2] = (png_byte)((i >> 8) & 0xff);
695 buf[3] = (png_byte)(i & 0xff);
697 #endif
699 # ifdef PNG_TIME_RFC1123_SUPPORTED
700 /* Convert the supplied time into an RFC 1123 string suitable for use in
701 * a "Creation Time" or other text-based time string.
703 int PNGAPI
704 png_convert_to_rfc1123_buffer(char out[29], png_const_timep ptime)
706 static PNG_CONST char short_months[12][4] =
707 {"Jan", "Feb", "Mar", "Apr", "May", "Jun",
708 "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"};
710 if (out == NULL)
711 return 0;
713 if (ptime->year > 9999 /* RFC1123 limitation */ ||
714 ptime->month == 0 || ptime->month > 12 ||
715 ptime->day == 0 || ptime->day > 31 ||
716 ptime->hour > 23 || ptime->minute > 59 ||
717 ptime->second > 60)
718 return 0;
721 size_t pos = 0;
722 char number_buf[5]; /* enough for a four-digit year */
724 # define APPEND_STRING(string) pos = png_safecat(out, 29, pos, (string))
725 # define APPEND_NUMBER(format, value)\
726 APPEND_STRING(PNG_FORMAT_NUMBER(number_buf, format, (value)))
727 # define APPEND(ch) if (pos < 28) out[pos++] = (ch)
729 APPEND_NUMBER(PNG_NUMBER_FORMAT_u, (unsigned)ptime->day);
730 APPEND(' ');
731 APPEND_STRING(short_months[(ptime->month - 1)]);
732 APPEND(' ');
733 APPEND_NUMBER(PNG_NUMBER_FORMAT_u, ptime->year);
734 APPEND(' ');
735 APPEND_NUMBER(PNG_NUMBER_FORMAT_02u, (unsigned)ptime->hour);
736 APPEND(':');
737 APPEND_NUMBER(PNG_NUMBER_FORMAT_02u, (unsigned)ptime->minute);
738 APPEND(':');
739 APPEND_NUMBER(PNG_NUMBER_FORMAT_02u, (unsigned)ptime->second);
740 APPEND_STRING(" +0000"); /* This reliably terminates the buffer */
742 # undef APPEND
743 # undef APPEND_NUMBER
744 # undef APPEND_STRING
747 return 1;
750 # if PNG_LIBPNG_VER < 10700
751 /* To do: remove the following from libpng-1.7 */
752 /* Original API that uses a private buffer in png_struct.
753 * Deprecated because it causes png_struct to carry a spurious temporary
754 * buffer (png_struct::time_buffer), better to have the caller pass this in.
756 png_const_charp PNGAPI
757 png_convert_to_rfc1123(png_structrp png_ptr, png_const_timep ptime)
759 if (png_ptr != NULL)
761 /* The only failure above if png_ptr != NULL is from an invalid ptime */
762 if (!png_convert_to_rfc1123_buffer(png_ptr->time_buffer, ptime))
763 png_warning(png_ptr, "Ignoring invalid time value");
765 else
766 return png_ptr->time_buffer;
769 return NULL;
771 # endif
772 # endif /* PNG_TIME_RFC1123_SUPPORTED */
774 #endif /* defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED) */
776 png_const_charp PNGAPI
777 png_get_copyright(png_const_structrp png_ptr)
779 PNG_UNUSED(png_ptr) /* Silence compiler warning about unused png_ptr */
780 #ifdef PNG_STRING_COPYRIGHT
781 return PNG_STRING_COPYRIGHT
782 #else
783 # ifdef __STDC__
784 return PNG_STRING_NEWLINE \
785 "libpng version 1.6.3 - July 18, 2013" PNG_STRING_NEWLINE \
786 "Copyright (c) 1998-2013 Glenn Randers-Pehrson" PNG_STRING_NEWLINE \
787 "Copyright (c) 1996-1997 Andreas Dilger" PNG_STRING_NEWLINE \
788 "Copyright (c) 1995-1996 Guy Eric Schalnat, Group 42, Inc." \
789 PNG_STRING_NEWLINE;
790 # else
791 return "libpng version 1.6.3 - July 18, 2013\
792 Copyright (c) 1998-2013 Glenn Randers-Pehrson\
793 Copyright (c) 1996-1997 Andreas Dilger\
794 Copyright (c) 1995-1996 Guy Eric Schalnat, Group 42, Inc.";
795 # endif
796 #endif
799 /* The following return the library version as a short string in the
800 * format 1.0.0 through 99.99.99zz. To get the version of *.h files
801 * used with your application, print out PNG_LIBPNG_VER_STRING, which
802 * is defined in png.h.
803 * Note: now there is no difference between png_get_libpng_ver() and
804 * png_get_header_ver(). Due to the version_nn_nn_nn typedef guard,
805 * it is guaranteed that png.c uses the correct version of png.h.
807 png_const_charp PNGAPI
808 png_get_libpng_ver(png_const_structrp png_ptr)
810 /* Version of *.c files used when building libpng */
811 return png_get_header_ver(png_ptr);
814 png_const_charp PNGAPI
815 png_get_header_ver(png_const_structrp png_ptr)
817 /* Version of *.h files used when building libpng */
818 PNG_UNUSED(png_ptr) /* Silence compiler warning about unused png_ptr */
819 return PNG_LIBPNG_VER_STRING;
822 png_const_charp PNGAPI
823 png_get_header_version(png_const_structrp png_ptr)
825 /* Returns longer string containing both version and date */
826 PNG_UNUSED(png_ptr) /* Silence compiler warning about unused png_ptr */
827 #ifdef __STDC__
828 return PNG_HEADER_VERSION_STRING
829 # ifndef PNG_READ_SUPPORTED
830 " (NO READ SUPPORT)"
831 # endif
832 PNG_STRING_NEWLINE;
833 #else
834 return PNG_HEADER_VERSION_STRING;
835 #endif
838 #ifdef PNG_SET_UNKNOWN_CHUNKS_SUPPORTED
839 int PNGAPI
840 png_handle_as_unknown(png_const_structrp png_ptr, png_const_bytep chunk_name)
842 /* Check chunk_name and return "keep" value if it's on the list, else 0 */
843 png_const_bytep p, p_end;
845 if (png_ptr == NULL || chunk_name == NULL || png_ptr->num_chunk_list == 0)
846 return PNG_HANDLE_CHUNK_AS_DEFAULT;
848 p_end = png_ptr->chunk_list;
849 p = p_end + png_ptr->num_chunk_list*5; /* beyond end */
851 /* The code is the fifth byte after each four byte string. Historically this
852 * code was always searched from the end of the list, this is no longer
853 * necessary because the 'set' routine handles duplicate entries correcty.
855 do /* num_chunk_list > 0, so at least one */
857 p -= 5;
859 if (!memcmp(chunk_name, p, 4))
860 return p[4];
862 while (p > p_end);
864 /* This means that known chunks should be processed and unknown chunks should
865 * be handled according to the value of png_ptr->unknown_default; this can be
866 * confusing because, as a result, there are two levels of defaulting for
867 * unknown chunks.
869 return PNG_HANDLE_CHUNK_AS_DEFAULT;
872 #ifdef PNG_READ_UNKNOWN_CHUNKS_SUPPORTED
873 int /* PRIVATE */
874 png_chunk_unknown_handling(png_const_structrp png_ptr, png_uint_32 chunk_name)
876 png_byte chunk_string[5];
878 PNG_CSTRING_FROM_CHUNK(chunk_string, chunk_name);
879 return png_handle_as_unknown(png_ptr, chunk_string);
881 #endif /* READ_UNKNOWN_CHUNKS */
882 #endif /* SET_UNKNOWN_CHUNKS */
884 #ifdef PNG_READ_SUPPORTED
885 /* This function, added to libpng-1.0.6g, is untested. */
886 int PNGAPI
887 png_reset_zstream(png_structrp png_ptr)
889 if (png_ptr == NULL)
890 return Z_STREAM_ERROR;
892 /* WARNING: this resets the window bits to the maximum! */
893 return (inflateReset(&png_ptr->zstream));
895 #endif /* PNG_READ_SUPPORTED */
897 /* This function was added to libpng-1.0.7 */
898 png_uint_32 PNGAPI
899 png_access_version_number(void)
901 /* Version of *.c files used when building libpng */
902 return((png_uint_32)PNG_LIBPNG_VER);
905 #ifdef __AROS__
906 /* This function was added to libpng 1.2.0 */
907 int PNGAPI
908 png_mmx_support(void)
910 /* Obsolete, to be removed from libpng-1.4.0 */
911 return -1;
913 #endif /* __AROS__ */
915 #if defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED)
916 /* Ensure that png_ptr->zstream.msg holds some appropriate error message string.
917 * If it doesn't 'ret' is used to set it to something appropriate, even in cases
918 * like Z_OK or Z_STREAM_END where the error code is apparently a success code.
920 void /* PRIVATE */
921 png_zstream_error(png_structrp png_ptr, int ret)
923 /* Translate 'ret' into an appropriate error string, priority is given to the
924 * one in zstream if set. This always returns a string, even in cases like
925 * Z_OK or Z_STREAM_END where the error code is a success code.
927 if (png_ptr->zstream.msg == NULL) switch (ret)
929 default:
930 case Z_OK:
931 png_ptr->zstream.msg = PNGZ_MSG_CAST("unexpected zlib return code");
932 break;
934 case Z_STREAM_END:
935 /* Normal exit */
936 png_ptr->zstream.msg = PNGZ_MSG_CAST("unexpected end of LZ stream");
937 break;
939 case Z_NEED_DICT:
940 /* This means the deflate stream did not have a dictionary; this
941 * indicates a bogus PNG.
943 png_ptr->zstream.msg = PNGZ_MSG_CAST("missing LZ dictionary");
944 break;
946 case Z_ERRNO:
947 /* gz APIs only: should not happen */
948 png_ptr->zstream.msg = PNGZ_MSG_CAST("zlib IO error");
949 break;
951 case Z_STREAM_ERROR:
952 /* internal libpng error */
953 png_ptr->zstream.msg = PNGZ_MSG_CAST("bad parameters to zlib");
954 break;
956 case Z_DATA_ERROR:
957 png_ptr->zstream.msg = PNGZ_MSG_CAST("damaged LZ stream");
958 break;
960 case Z_MEM_ERROR:
961 png_ptr->zstream.msg = PNGZ_MSG_CAST("insufficient memory");
962 break;
964 case Z_BUF_ERROR:
965 /* End of input or output; not a problem if the caller is doing
966 * incremental read or write.
968 png_ptr->zstream.msg = PNGZ_MSG_CAST("truncated");
969 break;
971 case Z_VERSION_ERROR:
972 png_ptr->zstream.msg = PNGZ_MSG_CAST("unsupported zlib version");
973 break;
975 case PNG_UNEXPECTED_ZLIB_RETURN:
976 /* Compile errors here mean that zlib now uses the value co-opted in
977 * pngpriv.h for PNG_UNEXPECTED_ZLIB_RETURN; update the switch above
978 * and change pngpriv.h. Note that this message is "... return",
979 * whereas the default/Z_OK one is "... return code".
981 png_ptr->zstream.msg = PNGZ_MSG_CAST("unexpected zlib return");
982 break;
986 /* png_convert_size: a PNGAPI but no longer in png.h, so deleted
987 * at libpng 1.5.5!
990 /* Added at libpng version 1.2.34 and 1.4.0 (moved from pngset.c) */
991 #ifdef PNG_GAMMA_SUPPORTED /* always set if COLORSPACE */
992 static int
993 png_colorspace_check_gamma(png_const_structrp png_ptr,
994 png_colorspacerp colorspace, png_fixed_point gAMA, int from)
995 /* This is called to check a new gamma value against an existing one. The
996 * routine returns false if the new gamma value should not be written.
998 * 'from' says where the new gamma value comes from:
1000 * 0: the new gamma value is the libpng estimate for an ICC profile
1001 * 1: the new gamma value comes from a gAMA chunk
1002 * 2: the new gamma value comes from an sRGB chunk
1005 png_fixed_point gtest;
1007 if ((colorspace->flags & PNG_COLORSPACE_HAVE_GAMMA) != 0 &&
1008 (!png_muldiv(&gtest, colorspace->gamma, PNG_FP_1, gAMA) ||
1009 png_gamma_significant(gtest)))
1011 /* Either this is an sRGB image, in which case the calculated gamma
1012 * approximation should match, or this is an image with a profile and the
1013 * value libpng calculates for the gamma of the profile does not match the
1014 * value recorded in the file. The former, sRGB, case is an error, the
1015 * latter is just a warning.
1017 if ((colorspace->flags & PNG_COLORSPACE_FROM_sRGB) != 0 || from == 2)
1019 png_chunk_report(png_ptr, "gamma value does not match sRGB",
1020 PNG_CHUNK_ERROR);
1021 /* Do not overwrite an sRGB value */
1022 return from == 2;
1025 else /* sRGB tag not involved */
1027 png_chunk_report(png_ptr, "gamma value does not match libpng estimate",
1028 PNG_CHUNK_WARNING);
1029 return from == 1;
1033 return 1;
1036 void /* PRIVATE */
1037 png_colorspace_set_gamma(png_const_structrp png_ptr,
1038 png_colorspacerp colorspace, png_fixed_point gAMA)
1040 /* Changed in libpng-1.5.4 to limit the values to ensure overflow can't
1041 * occur. Since the fixed point representation is assymetrical it is
1042 * possible for 1/gamma to overflow the limit of 21474 and this means the
1043 * gamma value must be at least 5/100000 and hence at most 20000.0. For
1044 * safety the limits here are a little narrower. The values are 0.00016 to
1045 * 6250.0, which are truly ridiculous gamma values (and will produce
1046 * displays that are all black or all white.)
1048 * In 1.6.0 this test replaces the ones in pngrutil.c, in the gAMA chunk
1049 * handling code, which only required the value to be >0.
1051 png_const_charp errmsg;
1053 if (gAMA < 16 || gAMA > 625000000)
1054 errmsg = "gamma value out of range";
1056 # ifdef PNG_READ_gAMA_SUPPORTED
1057 /* Allow the application to set the gamma value more than once */
1058 else if ((png_ptr->mode & PNG_IS_READ_STRUCT) != 0 &&
1059 (colorspace->flags & PNG_COLORSPACE_FROM_gAMA) != 0)
1060 errmsg = "duplicate";
1061 # endif
1063 /* Do nothing if the colorspace is already invalid */
1064 else if (colorspace->flags & PNG_COLORSPACE_INVALID)
1065 return;
1067 else
1069 if (png_colorspace_check_gamma(png_ptr, colorspace, gAMA, 1/*from gAMA*/))
1071 /* Store this gamma value. */
1072 colorspace->gamma = gAMA;
1073 colorspace->flags |=
1074 (PNG_COLORSPACE_HAVE_GAMMA | PNG_COLORSPACE_FROM_gAMA);
1077 /* At present if the check_gamma test fails the gamma of the colorspace is
1078 * not updated however the colorspace is not invalidated. This
1079 * corresponds to the case where the existing gamma comes from an sRGB
1080 * chunk or profile. An error message has already been output.
1082 return;
1085 /* Error exit - errmsg has been set. */
1086 colorspace->flags |= PNG_COLORSPACE_INVALID;
1087 png_chunk_report(png_ptr, errmsg, PNG_CHUNK_WRITE_ERROR);
1090 void /* PRIVATE */
1091 png_colorspace_sync_info(png_const_structrp png_ptr, png_inforp info_ptr)
1093 if (info_ptr->colorspace.flags & PNG_COLORSPACE_INVALID)
1095 /* Everything is invalid */
1096 info_ptr->valid &= ~(PNG_INFO_gAMA|PNG_INFO_cHRM|PNG_INFO_sRGB|
1097 PNG_INFO_iCCP);
1099 # ifdef PNG_COLORSPACE_SUPPORTED
1100 /* Clean up the iCCP profile now if it won't be used. */
1101 png_free_data(png_ptr, info_ptr, PNG_FREE_ICCP, -1/*not used*/);
1102 # else
1103 PNG_UNUSED(png_ptr)
1104 # endif
1107 else
1109 # ifdef PNG_COLORSPACE_SUPPORTED
1110 /* Leave the INFO_iCCP flag set if the pngset.c code has already set
1111 * it; this allows a PNG to contain a profile which matches sRGB and
1112 * yet still have that profile retrievable by the application.
1114 if (info_ptr->colorspace.flags & PNG_COLORSPACE_MATCHES_sRGB)
1115 info_ptr->valid |= PNG_INFO_sRGB;
1117 else
1118 info_ptr->valid &= ~PNG_INFO_sRGB;
1120 if (info_ptr->colorspace.flags & PNG_COLORSPACE_HAVE_ENDPOINTS)
1121 info_ptr->valid |= PNG_INFO_cHRM;
1123 else
1124 info_ptr->valid &= ~PNG_INFO_cHRM;
1125 # endif
1127 if (info_ptr->colorspace.flags & PNG_COLORSPACE_HAVE_GAMMA)
1128 info_ptr->valid |= PNG_INFO_gAMA;
1130 else
1131 info_ptr->valid &= ~PNG_INFO_gAMA;
1135 #ifdef PNG_READ_SUPPORTED
1136 void /* PRIVATE */
1137 png_colorspace_sync(png_const_structrp png_ptr, png_inforp info_ptr)
1139 if (info_ptr == NULL) /* reduce code size; check here not in the caller */
1140 return;
1142 info_ptr->colorspace = png_ptr->colorspace;
1143 png_colorspace_sync_info(png_ptr, info_ptr);
1145 #endif
1146 #endif
1148 #ifdef PNG_COLORSPACE_SUPPORTED
1149 /* Added at libpng-1.5.5 to support read and write of true CIEXYZ values for
1150 * cHRM, as opposed to using chromaticities. These internal APIs return
1151 * non-zero on a parameter error. The X, Y and Z values are required to be
1152 * positive and less than 1.0.
1154 static int
1155 png_xy_from_XYZ(png_xy *xy, const png_XYZ *XYZ)
1157 png_int_32 d, dwhite, whiteX, whiteY;
1159 d = XYZ->red_X + XYZ->red_Y + XYZ->red_Z;
1160 if (!png_muldiv(&xy->redx, XYZ->red_X, PNG_FP_1, d)) return 1;
1161 if (!png_muldiv(&xy->redy, XYZ->red_Y, PNG_FP_1, d)) return 1;
1162 dwhite = d;
1163 whiteX = XYZ->red_X;
1164 whiteY = XYZ->red_Y;
1166 d = XYZ->green_X + XYZ->green_Y + XYZ->green_Z;
1167 if (!png_muldiv(&xy->greenx, XYZ->green_X, PNG_FP_1, d)) return 1;
1168 if (!png_muldiv(&xy->greeny, XYZ->green_Y, PNG_FP_1, d)) return 1;
1169 dwhite += d;
1170 whiteX += XYZ->green_X;
1171 whiteY += XYZ->green_Y;
1173 d = XYZ->blue_X + XYZ->blue_Y + XYZ->blue_Z;
1174 if (!png_muldiv(&xy->bluex, XYZ->blue_X, PNG_FP_1, d)) return 1;
1175 if (!png_muldiv(&xy->bluey, XYZ->blue_Y, PNG_FP_1, d)) return 1;
1176 dwhite += d;
1177 whiteX += XYZ->blue_X;
1178 whiteY += XYZ->blue_Y;
1180 /* The reference white is simply the sum of the end-point (X,Y,Z) vectors,
1181 * thus:
1183 if (!png_muldiv(&xy->whitex, whiteX, PNG_FP_1, dwhite)) return 1;
1184 if (!png_muldiv(&xy->whitey, whiteY, PNG_FP_1, dwhite)) return 1;
1186 return 0;
1189 static int
1190 png_XYZ_from_xy(png_XYZ *XYZ, const png_xy *xy)
1192 png_fixed_point red_inverse, green_inverse, blue_scale;
1193 png_fixed_point left, right, denominator;
1195 /* Check xy and, implicitly, z. Note that wide gamut color spaces typically
1196 * have end points with 0 tristimulus values (these are impossible end
1197 * points, but they are used to cover the possible colors.)
1199 if (xy->redx < 0 || xy->redx > PNG_FP_1) return 1;
1200 if (xy->redy < 0 || xy->redy > PNG_FP_1-xy->redx) return 1;
1201 if (xy->greenx < 0 || xy->greenx > PNG_FP_1) return 1;
1202 if (xy->greeny < 0 || xy->greeny > PNG_FP_1-xy->greenx) return 1;
1203 if (xy->bluex < 0 || xy->bluex > PNG_FP_1) return 1;
1204 if (xy->bluey < 0 || xy->bluey > PNG_FP_1-xy->bluex) return 1;
1205 if (xy->whitex < 0 || xy->whitex > PNG_FP_1) return 1;
1206 if (xy->whitey < 0 || xy->whitey > PNG_FP_1-xy->whitex) return 1;
1208 /* The reverse calculation is more difficult because the original tristimulus
1209 * value had 9 independent values (red,green,blue)x(X,Y,Z) however only 8
1210 * derived values were recorded in the cHRM chunk;
1211 * (red,green,blue,white)x(x,y). This loses one degree of freedom and
1212 * therefore an arbitrary ninth value has to be introduced to undo the
1213 * original transformations.
1215 * Think of the original end-points as points in (X,Y,Z) space. The
1216 * chromaticity values (c) have the property:
1219 * c = ---------
1220 * X + Y + Z
1222 * For each c (x,y,z) from the corresponding original C (X,Y,Z). Thus the
1223 * three chromaticity values (x,y,z) for each end-point obey the
1224 * relationship:
1226 * x + y + z = 1
1228 * This describes the plane in (X,Y,Z) space that intersects each axis at the
1229 * value 1.0; call this the chromaticity plane. Thus the chromaticity
1230 * calculation has scaled each end-point so that it is on the x+y+z=1 plane
1231 * and chromaticity is the intersection of the vector from the origin to the
1232 * (X,Y,Z) value with the chromaticity plane.
1234 * To fully invert the chromaticity calculation we would need the three
1235 * end-point scale factors, (red-scale, green-scale, blue-scale), but these
1236 * were not recorded. Instead we calculated the reference white (X,Y,Z) and
1237 * recorded the chromaticity of this. The reference white (X,Y,Z) would have
1238 * given all three of the scale factors since:
1240 * color-C = color-c * color-scale
1241 * white-C = red-C + green-C + blue-C
1242 * = red-c*red-scale + green-c*green-scale + blue-c*blue-scale
1244 * But cHRM records only white-x and white-y, so we have lost the white scale
1245 * factor:
1247 * white-C = white-c*white-scale
1249 * To handle this the inverse transformation makes an arbitrary assumption
1250 * about white-scale:
1252 * Assume: white-Y = 1.0
1253 * Hence: white-scale = 1/white-y
1254 * Or: red-Y + green-Y + blue-Y = 1.0
1256 * Notice the last statement of the assumption gives an equation in three of
1257 * the nine values we want to calculate. 8 more equations come from the
1258 * above routine as summarised at the top above (the chromaticity
1259 * calculation):
1261 * Given: color-x = color-X / (color-X + color-Y + color-Z)
1262 * Hence: (color-x - 1)*color-X + color.x*color-Y + color.x*color-Z = 0
1264 * This is 9 simultaneous equations in the 9 variables "color-C" and can be
1265 * solved by Cramer's rule. Cramer's rule requires calculating 10 9x9 matrix
1266 * determinants, however this is not as bad as it seems because only 28 of
1267 * the total of 90 terms in the various matrices are non-zero. Nevertheless
1268 * Cramer's rule is notoriously numerically unstable because the determinant
1269 * calculation involves the difference of large, but similar, numbers. It is
1270 * difficult to be sure that the calculation is stable for real world values
1271 * and it is certain that it becomes unstable where the end points are close
1272 * together.
1274 * So this code uses the perhaps slightly less optimal but more
1275 * understandable and totally obvious approach of calculating color-scale.
1277 * This algorithm depends on the precision in white-scale and that is
1278 * (1/white-y), so we can immediately see that as white-y approaches 0 the
1279 * accuracy inherent in the cHRM chunk drops off substantially.
1281 * libpng arithmetic: a simple invertion of the above equations
1282 * ------------------------------------------------------------
1284 * white_scale = 1/white-y
1285 * white-X = white-x * white-scale
1286 * white-Y = 1.0
1287 * white-Z = (1 - white-x - white-y) * white_scale
1289 * white-C = red-C + green-C + blue-C
1290 * = red-c*red-scale + green-c*green-scale + blue-c*blue-scale
1292 * This gives us three equations in (red-scale,green-scale,blue-scale) where
1293 * all the coefficients are now known:
1295 * red-x*red-scale + green-x*green-scale + blue-x*blue-scale
1296 * = white-x/white-y
1297 * red-y*red-scale + green-y*green-scale + blue-y*blue-scale = 1
1298 * red-z*red-scale + green-z*green-scale + blue-z*blue-scale
1299 * = (1 - white-x - white-y)/white-y
1301 * In the last equation color-z is (1 - color-x - color-y) so we can add all
1302 * three equations together to get an alternative third:
1304 * red-scale + green-scale + blue-scale = 1/white-y = white-scale
1306 * So now we have a Cramer's rule solution where the determinants are just
1307 * 3x3 - far more tractible. Unfortunately 3x3 determinants still involve
1308 * multiplication of three coefficients so we can't guarantee to avoid
1309 * overflow in the libpng fixed point representation. Using Cramer's rule in
1310 * floating point is probably a good choice here, but it's not an option for
1311 * fixed point. Instead proceed to simplify the first two equations by
1312 * eliminating what is likely to be the largest value, blue-scale:
1314 * blue-scale = white-scale - red-scale - green-scale
1316 * Hence:
1318 * (red-x - blue-x)*red-scale + (green-x - blue-x)*green-scale =
1319 * (white-x - blue-x)*white-scale
1321 * (red-y - blue-y)*red-scale + (green-y - blue-y)*green-scale =
1322 * 1 - blue-y*white-scale
1324 * And now we can trivially solve for (red-scale,green-scale):
1326 * green-scale =
1327 * (white-x - blue-x)*white-scale - (red-x - blue-x)*red-scale
1328 * -----------------------------------------------------------
1329 * green-x - blue-x
1331 * red-scale =
1332 * 1 - blue-y*white-scale - (green-y - blue-y) * green-scale
1333 * ---------------------------------------------------------
1334 * red-y - blue-y
1336 * Hence:
1338 * red-scale =
1339 * ( (green-x - blue-x) * (white-y - blue-y) -
1340 * (green-y - blue-y) * (white-x - blue-x) ) / white-y
1341 * -------------------------------------------------------------------------
1342 * (green-x - blue-x)*(red-y - blue-y)-(green-y - blue-y)*(red-x - blue-x)
1344 * green-scale =
1345 * ( (red-y - blue-y) * (white-x - blue-x) -
1346 * (red-x - blue-x) * (white-y - blue-y) ) / white-y
1347 * -------------------------------------------------------------------------
1348 * (green-x - blue-x)*(red-y - blue-y)-(green-y - blue-y)*(red-x - blue-x)
1350 * Accuracy:
1351 * The input values have 5 decimal digits of accuracy. The values are all in
1352 * the range 0 < value < 1, so simple products are in the same range but may
1353 * need up to 10 decimal digits to preserve the original precision and avoid
1354 * underflow. Because we are using a 32-bit signed representation we cannot
1355 * match this; the best is a little over 9 decimal digits, less than 10.
1357 * The approach used here is to preserve the maximum precision within the
1358 * signed representation. Because the red-scale calculation above uses the
1359 * difference between two products of values that must be in the range -1..+1
1360 * it is sufficient to divide the product by 7; ceil(100,000/32767*2). The
1361 * factor is irrelevant in the calculation because it is applied to both
1362 * numerator and denominator.
1364 * Note that the values of the differences of the products of the
1365 * chromaticities in the above equations tend to be small, for example for
1366 * the sRGB chromaticities they are:
1368 * red numerator: -0.04751
1369 * green numerator: -0.08788
1370 * denominator: -0.2241 (without white-y multiplication)
1372 * The resultant Y coefficients from the chromaticities of some widely used
1373 * color space definitions are (to 15 decimal places):
1375 * sRGB
1376 * 0.212639005871510 0.715168678767756 0.072192315360734
1377 * Kodak ProPhoto
1378 * 0.288071128229293 0.711843217810102 0.000085653960605
1379 * Adobe RGB
1380 * 0.297344975250536 0.627363566255466 0.075291458493998
1381 * Adobe Wide Gamut RGB
1382 * 0.258728243040113 0.724682314948566 0.016589442011321
1384 /* By the argument, above overflow should be impossible here. The return
1385 * value of 2 indicates an internal error to the caller.
1387 if (!png_muldiv(&left, xy->greenx-xy->bluex, xy->redy - xy->bluey, 7))
1388 return 2;
1389 if (!png_muldiv(&right, xy->greeny-xy->bluey, xy->redx - xy->bluex, 7))
1390 return 2;
1391 denominator = left - right;
1393 /* Now find the red numerator. */
1394 if (!png_muldiv(&left, xy->greenx-xy->bluex, xy->whitey-xy->bluey, 7))
1395 return 2;
1396 if (!png_muldiv(&right, xy->greeny-xy->bluey, xy->whitex-xy->bluex, 7))
1397 return 2;
1399 /* Overflow is possible here and it indicates an extreme set of PNG cHRM
1400 * chunk values. This calculation actually returns the reciprocal of the
1401 * scale value because this allows us to delay the multiplication of white-y
1402 * into the denominator, which tends to produce a small number.
1404 if (!png_muldiv(&red_inverse, xy->whitey, denominator, left-right) ||
1405 red_inverse <= xy->whitey /* r+g+b scales = white scale */)
1406 return 1;
1408 /* Similarly for green_inverse: */
1409 if (!png_muldiv(&left, xy->redy-xy->bluey, xy->whitex-xy->bluex, 7))
1410 return 2;
1411 if (!png_muldiv(&right, xy->redx-xy->bluex, xy->whitey-xy->bluey, 7))
1412 return 2;
1413 if (!png_muldiv(&green_inverse, xy->whitey, denominator, left-right) ||
1414 green_inverse <= xy->whitey)
1415 return 1;
1417 /* And the blue scale, the checks above guarantee this can't overflow but it
1418 * can still produce 0 for extreme cHRM values.
1420 blue_scale = png_reciprocal(xy->whitey) - png_reciprocal(red_inverse) -
1421 png_reciprocal(green_inverse);
1422 if (blue_scale <= 0) return 1;
1425 /* And fill in the png_XYZ: */
1426 if (!png_muldiv(&XYZ->red_X, xy->redx, PNG_FP_1, red_inverse)) return 1;
1427 if (!png_muldiv(&XYZ->red_Y, xy->redy, PNG_FP_1, red_inverse)) return 1;
1428 if (!png_muldiv(&XYZ->red_Z, PNG_FP_1 - xy->redx - xy->redy, PNG_FP_1,
1429 red_inverse))
1430 return 1;
1432 if (!png_muldiv(&XYZ->green_X, xy->greenx, PNG_FP_1, green_inverse))
1433 return 1;
1434 if (!png_muldiv(&XYZ->green_Y, xy->greeny, PNG_FP_1, green_inverse))
1435 return 1;
1436 if (!png_muldiv(&XYZ->green_Z, PNG_FP_1 - xy->greenx - xy->greeny, PNG_FP_1,
1437 green_inverse))
1438 return 1;
1440 if (!png_muldiv(&XYZ->blue_X, xy->bluex, blue_scale, PNG_FP_1)) return 1;
1441 if (!png_muldiv(&XYZ->blue_Y, xy->bluey, blue_scale, PNG_FP_1)) return 1;
1442 if (!png_muldiv(&XYZ->blue_Z, PNG_FP_1 - xy->bluex - xy->bluey, blue_scale,
1443 PNG_FP_1))
1444 return 1;
1446 return 0; /*success*/
1449 static int
1450 png_XYZ_normalize(png_XYZ *XYZ)
1452 png_int_32 Y;
1454 if (XYZ->red_Y < 0 || XYZ->green_Y < 0 || XYZ->blue_Y < 0 ||
1455 XYZ->red_X < 0 || XYZ->green_X < 0 || XYZ->blue_X < 0 ||
1456 XYZ->red_Z < 0 || XYZ->green_Z < 0 || XYZ->blue_Z < 0)
1457 return 1;
1459 /* Normalize by scaling so the sum of the end-point Y values is PNG_FP_1.
1460 * IMPLEMENTATION NOTE: ANSI requires signed overflow not to occur, therefore
1461 * relying on addition of two positive values producing a negative one is not
1462 * safe.
1464 Y = XYZ->red_Y;
1465 if (0x7fffffff - Y < XYZ->green_X) return 1;
1466 Y += XYZ->green_Y;
1467 if (0x7fffffff - Y < XYZ->blue_X) return 1;
1468 Y += XYZ->blue_Y;
1470 if (Y != PNG_FP_1)
1472 if (!png_muldiv(&XYZ->red_X, XYZ->red_X, PNG_FP_1, Y)) return 1;
1473 if (!png_muldiv(&XYZ->red_Y, XYZ->red_Y, PNG_FP_1, Y)) return 1;
1474 if (!png_muldiv(&XYZ->red_Z, XYZ->red_Z, PNG_FP_1, Y)) return 1;
1476 if (!png_muldiv(&XYZ->green_X, XYZ->green_X, PNG_FP_1, Y)) return 1;
1477 if (!png_muldiv(&XYZ->green_Y, XYZ->green_Y, PNG_FP_1, Y)) return 1;
1478 if (!png_muldiv(&XYZ->green_Z, XYZ->green_Z, PNG_FP_1, Y)) return 1;
1480 if (!png_muldiv(&XYZ->blue_X, XYZ->blue_X, PNG_FP_1, Y)) return 1;
1481 if (!png_muldiv(&XYZ->blue_Y, XYZ->blue_Y, PNG_FP_1, Y)) return 1;
1482 if (!png_muldiv(&XYZ->blue_Z, XYZ->blue_Z, PNG_FP_1, Y)) return 1;
1485 return 0;
1488 static int
1489 png_colorspace_endpoints_match(const png_xy *xy1, const png_xy *xy2, int delta)
1491 /* Allow an error of +/-0.01 (absolute value) on each chromaticity */
1492 return !(PNG_OUT_OF_RANGE(xy1->whitex, xy2->whitex,delta) ||
1493 PNG_OUT_OF_RANGE(xy1->whitey, xy2->whitey,delta) ||
1494 PNG_OUT_OF_RANGE(xy1->redx, xy2->redx, delta) ||
1495 PNG_OUT_OF_RANGE(xy1->redy, xy2->redy, delta) ||
1496 PNG_OUT_OF_RANGE(xy1->greenx, xy2->greenx,delta) ||
1497 PNG_OUT_OF_RANGE(xy1->greeny, xy2->greeny,delta) ||
1498 PNG_OUT_OF_RANGE(xy1->bluex, xy2->bluex, delta) ||
1499 PNG_OUT_OF_RANGE(xy1->bluey, xy2->bluey, delta));
1502 /* Added in libpng-1.6.0, a different check for the validity of a set of cHRM
1503 * chunk chromaticities. Earlier checks used to simply look for the overflow
1504 * condition (where the determinant of the matrix to solve for XYZ ends up zero
1505 * because the chromaticity values are not all distinct.) Despite this it is
1506 * theoretically possible to produce chromaticities that are apparently valid
1507 * but that rapidly degrade to invalid, potentially crashing, sets because of
1508 * arithmetic inaccuracies when calculations are performed on them. The new
1509 * check is to round-trip xy -> XYZ -> xy and then check that the result is
1510 * within a small percentage of the original.
1512 static int
1513 png_colorspace_check_xy(png_XYZ *XYZ, const png_xy *xy)
1515 int result;
1516 png_xy xy_test;
1518 /* As a side-effect this routine also returns the XYZ endpoints. */
1519 result = png_XYZ_from_xy(XYZ, xy);
1520 if (result) return result;
1522 result = png_xy_from_XYZ(&xy_test, XYZ);
1523 if (result) return result;
1525 if (png_colorspace_endpoints_match(xy, &xy_test,
1526 5/*actually, the math is pretty accurate*/))
1527 return 0;
1529 /* Too much slip */
1530 return 1;
1533 /* This is the check going the other way. The XYZ is modified to normalize it
1534 * (another side-effect) and the xy chromaticities are returned.
1536 static int
1537 png_colorspace_check_XYZ(png_xy *xy, png_XYZ *XYZ)
1539 int result;
1540 png_XYZ XYZtemp;
1542 result = png_XYZ_normalize(XYZ);
1543 if (result) return result;
1545 result = png_xy_from_XYZ(xy, XYZ);
1546 if (result) return result;
1548 XYZtemp = *XYZ;
1549 return png_colorspace_check_xy(&XYZtemp, xy);
1552 /* Used to check for an endpoint match against sRGB */
1553 static const png_xy sRGB_xy = /* From ITU-R BT.709-3 */
1555 /* color x y */
1556 /* red */ 64000, 33000,
1557 /* green */ 30000, 60000,
1558 /* blue */ 15000, 6000,
1559 /* white */ 31270, 32900
1562 static int
1563 png_colorspace_set_xy_and_XYZ(png_const_structrp png_ptr,
1564 png_colorspacerp colorspace, const png_xy *xy, const png_XYZ *XYZ,
1565 int preferred)
1567 if (colorspace->flags & PNG_COLORSPACE_INVALID)
1568 return 0;
1570 /* The consistency check is performed on the chromaticities; this factors out
1571 * variations because of the normalization (or not) of the end point Y
1572 * values.
1574 if (preferred < 2 && (colorspace->flags & PNG_COLORSPACE_HAVE_ENDPOINTS))
1576 /* The end points must be reasonably close to any we already have. The
1577 * following allows an error of up to +/-.001
1579 if (!png_colorspace_endpoints_match(xy, &colorspace->end_points_xy, 100))
1581 colorspace->flags |= PNG_COLORSPACE_INVALID;
1582 png_benign_error(png_ptr, "inconsistent chromaticities");
1583 return 0; /* failed */
1586 /* Only overwrite with preferred values */
1587 if (!preferred)
1588 return 1; /* ok, but no change */
1591 colorspace->end_points_xy = *xy;
1592 colorspace->end_points_XYZ = *XYZ;
1593 colorspace->flags |= PNG_COLORSPACE_HAVE_ENDPOINTS;
1595 /* The end points are normally quoted to two decimal digits, so allow +/-0.01
1596 * on this test.
1598 if (png_colorspace_endpoints_match(xy, &sRGB_xy, 1000))
1599 colorspace->flags |= PNG_COLORSPACE_ENDPOINTS_MATCH_sRGB;
1601 else
1602 colorspace->flags &= PNG_COLORSPACE_CANCEL(
1603 PNG_COLORSPACE_ENDPOINTS_MATCH_sRGB);
1605 return 2; /* ok and changed */
1608 int /* PRIVATE */
1609 png_colorspace_set_chromaticities(png_const_structrp png_ptr,
1610 png_colorspacerp colorspace, const png_xy *xy, int preferred)
1612 /* We must check the end points to ensure they are reasonable - in the past
1613 * color management systems have crashed as a result of getting bogus
1614 * colorant values, while this isn't the fault of libpng it is the
1615 * responsibility of libpng because PNG carries the bomb and libpng is in a
1616 * position to protect against it.
1618 png_XYZ XYZ;
1620 switch (png_colorspace_check_xy(&XYZ, xy))
1622 case 0: /* success */
1623 return png_colorspace_set_xy_and_XYZ(png_ptr, colorspace, xy, &XYZ,
1624 preferred);
1626 case 1:
1627 /* We can't invert the chromaticities so we can't produce value XYZ
1628 * values. Likely as not a color management system will fail too.
1630 colorspace->flags |= PNG_COLORSPACE_INVALID;
1631 png_benign_error(png_ptr, "invalid chromaticities");
1632 break;
1634 default:
1635 /* libpng is broken; this should be a warning but if it happens we
1636 * want error reports so for the moment it is an error.
1638 colorspace->flags |= PNG_COLORSPACE_INVALID;
1639 png_error(png_ptr, "internal error checking chromaticities");
1640 break;
1643 return 0; /* failed */
1646 int /* PRIVATE */
1647 png_colorspace_set_endpoints(png_const_structrp png_ptr,
1648 png_colorspacerp colorspace, const png_XYZ *XYZ_in, int preferred)
1650 png_XYZ XYZ = *XYZ_in;
1651 png_xy xy;
1653 switch (png_colorspace_check_XYZ(&xy, &XYZ))
1655 case 0:
1656 return png_colorspace_set_xy_and_XYZ(png_ptr, colorspace, &xy, &XYZ,
1657 preferred);
1659 case 1:
1660 /* End points are invalid. */
1661 colorspace->flags |= PNG_COLORSPACE_INVALID;
1662 png_benign_error(png_ptr, "invalid end points");
1663 break;
1665 default:
1666 colorspace->flags |= PNG_COLORSPACE_INVALID;
1667 png_error(png_ptr, "internal error checking chromaticities");
1668 break;
1671 return 0; /* failed */
1674 #if defined(PNG_sRGB_SUPPORTED) || defined(PNG_iCCP_SUPPORTED)
1675 /* Error message generation */
1676 static char
1677 png_icc_tag_char(png_uint_32 byte)
1679 byte &= 0xff;
1680 if (byte >= 32 && byte <= 126)
1681 return (char)byte;
1682 else
1683 return '?';
1686 static void
1687 png_icc_tag_name(char *name, png_uint_32 tag)
1689 name[0] = '\'';
1690 name[1] = png_icc_tag_char(tag >> 24);
1691 name[2] = png_icc_tag_char(tag >> 16);
1692 name[3] = png_icc_tag_char(tag >> 8);
1693 name[4] = png_icc_tag_char(tag );
1694 name[5] = '\'';
1697 static int
1698 is_ICC_signature_char(png_alloc_size_t it)
1700 return it == 32 || (it >= 48 && it <= 57) || (it >= 65 && it <= 90) ||
1701 (it >= 97 && it <= 122);
1704 static int is_ICC_signature(png_alloc_size_t it)
1706 return is_ICC_signature_char(it >> 24) /* checks all the top bits */ &&
1707 is_ICC_signature_char((it >> 16) & 0xff) &&
1708 is_ICC_signature_char((it >> 8) & 0xff) &&
1709 is_ICC_signature_char(it & 0xff);
1712 static int
1713 png_icc_profile_error(png_const_structrp png_ptr, png_colorspacerp colorspace,
1714 png_const_charp name, png_alloc_size_t value, png_const_charp reason)
1716 size_t pos;
1717 char message[196]; /* see below for calculation */
1719 if (colorspace != NULL)
1720 colorspace->flags |= PNG_COLORSPACE_INVALID;
1722 pos = png_safecat(message, (sizeof message), 0, "profile '"); /* 9 chars */
1723 pos = png_safecat(message, pos+79, pos, name); /* Truncate to 79 chars */
1724 pos = png_safecat(message, (sizeof message), pos, "': "); /* +2 = 90 */
1725 if (is_ICC_signature(value))
1727 /* So 'value' is at most 4 bytes and the following cast is safe */
1728 png_icc_tag_name(message+pos, (png_uint_32)value);
1729 pos += 6; /* total +8; less than the else clause */
1730 message[pos++] = ':';
1731 message[pos++] = ' ';
1733 # ifdef PNG_WARNINGS_SUPPORTED
1734 else
1736 char number[PNG_NUMBER_BUFFER_SIZE]; /* +24 = 114*/
1738 pos = png_safecat(message, (sizeof message), pos,
1739 png_format_number(number, number+(sizeof number),
1740 PNG_NUMBER_FORMAT_x, value));
1741 pos = png_safecat(message, (sizeof message), pos, "h: "); /*+2 = 116*/
1743 # endif
1744 /* The 'reason' is an arbitrary message, allow +79 maximum 195 */
1745 pos = png_safecat(message, (sizeof message), pos, reason);
1747 /* This is recoverable, but make it unconditionally an app_error on write to
1748 * avoid writing invalid ICC profiles into PNG files. (I.e. we handle them
1749 * on read, with a warning, but on write unless the app turns off
1750 * application errors the PNG won't be written.)
1752 png_chunk_report(png_ptr, message,
1753 (colorspace != NULL) ? PNG_CHUNK_ERROR : PNG_CHUNK_WRITE_ERROR);
1755 return 0;
1757 #endif /* sRGB || iCCP */
1759 #ifdef PNG_sRGB_SUPPORTED
1760 int /* PRIVATE */
1761 png_colorspace_set_sRGB(png_const_structrp png_ptr, png_colorspacerp colorspace,
1762 int intent)
1764 /* sRGB sets known gamma, end points and (from the chunk) intent. */
1765 /* IMPORTANT: these are not necessarily the values found in an ICC profile
1766 * because ICC profiles store values adapted to a D50 environment; it is
1767 * expected that the ICC profile mediaWhitePointTag will be D50, see the
1768 * checks and code elsewhere to understand this better.
1770 * These XYZ values, which are accurate to 5dp, produce rgb to gray
1771 * coefficients of (6968,23435,2366), which are reduced (because they add up
1772 * to 32769 not 32768) to (6968,23434,2366). These are the values that
1773 * libpng has traditionally used (and are the best values given the 15bit
1774 * algorithm used by the rgb to gray code.)
1776 static const png_XYZ sRGB_XYZ = /* D65 XYZ (*not* the D50 adapted values!) */
1778 /* color X Y Z */
1779 /* red */ 41239, 21264, 1933,
1780 /* green */ 35758, 71517, 11919,
1781 /* blue */ 18048, 7219, 95053
1784 /* Do nothing if the colorspace is already invalidated. */
1785 if (colorspace->flags & PNG_COLORSPACE_INVALID)
1786 return 0;
1788 /* Check the intent, then check for existing settings. It is valid for the
1789 * PNG file to have cHRM or gAMA chunks along with sRGB, but the values must
1790 * be consistent with the correct values. If, however, this function is
1791 * called below because an iCCP chunk matches sRGB then it is quite
1792 * conceivable that an older app recorded incorrect gAMA and cHRM because of
1793 * an incorrect calculation based on the values in the profile - this does
1794 * *not* invalidate the profile (though it still produces an error, which can
1795 * be ignored.)
1797 if (intent < 0 || intent >= PNG_sRGB_INTENT_LAST)
1798 return png_icc_profile_error(png_ptr, colorspace, "sRGB",
1799 (unsigned)intent, "invalid sRGB rendering intent");
1801 if ((colorspace->flags & PNG_COLORSPACE_HAVE_INTENT) != 0 &&
1802 colorspace->rendering_intent != intent)
1803 return png_icc_profile_error(png_ptr, colorspace, "sRGB",
1804 (unsigned)intent, "inconsistent rendering intents");
1806 if ((colorspace->flags & PNG_COLORSPACE_FROM_sRGB) != 0)
1808 png_benign_error(png_ptr, "duplicate sRGB information ignored");
1809 return 0;
1812 /* If the standard sRGB cHRM chunk does not match the one from the PNG file
1813 * warn but overwrite the value with the correct one.
1815 if ((colorspace->flags & PNG_COLORSPACE_HAVE_ENDPOINTS) != 0 &&
1816 !png_colorspace_endpoints_match(&sRGB_xy, &colorspace->end_points_xy,
1817 100))
1818 png_chunk_report(png_ptr, "cHRM chunk does not match sRGB",
1819 PNG_CHUNK_ERROR);
1821 /* This check is just done for the error reporting - the routine always
1822 * returns true when the 'from' argument corresponds to sRGB (2).
1824 (void)png_colorspace_check_gamma(png_ptr, colorspace, PNG_GAMMA_sRGB_INVERSE,
1825 2/*from sRGB*/);
1827 /* intent: bugs in GCC force 'int' to be used as the parameter type. */
1828 colorspace->rendering_intent = (png_uint_16)intent;
1829 colorspace->flags |= PNG_COLORSPACE_HAVE_INTENT;
1831 /* endpoints */
1832 colorspace->end_points_xy = sRGB_xy;
1833 colorspace->end_points_XYZ = sRGB_XYZ;
1834 colorspace->flags |=
1835 (PNG_COLORSPACE_HAVE_ENDPOINTS|PNG_COLORSPACE_ENDPOINTS_MATCH_sRGB);
1837 /* gamma */
1838 colorspace->gamma = PNG_GAMMA_sRGB_INVERSE;
1839 colorspace->flags |= PNG_COLORSPACE_HAVE_GAMMA;
1841 /* Finally record that we have an sRGB profile */
1842 colorspace->flags |=
1843 (PNG_COLORSPACE_MATCHES_sRGB|PNG_COLORSPACE_FROM_sRGB);
1845 return 1; /* set */
1847 #endif /* sRGB */
1849 #ifdef PNG_iCCP_SUPPORTED
1850 /* Encoded value of D50 as an ICC XYZNumber. From the ICC 2010 spec the value
1851 * is XYZ(0.9642,1.0,0.8249), which scales to:
1853 * (63189.8112, 65536, 54060.6464)
1855 static const png_byte D50_nCIEXYZ[12] =
1856 { 0x00, 0x00, 0xf6, 0xd6, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0xd3, 0x2d };
1858 int /* PRIVATE */
1859 png_icc_check_length(png_const_structrp png_ptr, png_colorspacerp colorspace,
1860 png_const_charp name, png_uint_32 profile_length)
1862 if (profile_length < 132)
1863 return png_icc_profile_error(png_ptr, colorspace, name, profile_length,
1864 "too short");
1866 if (profile_length & 3)
1867 return png_icc_profile_error(png_ptr, colorspace, name, profile_length,
1868 "invalid length");
1870 return 1;
1873 int /* PRIVATE */
1874 png_icc_check_header(png_const_structrp png_ptr, png_colorspacerp colorspace,
1875 png_const_charp name, png_uint_32 profile_length,
1876 png_const_bytep profile/* first 132 bytes only */, int color_type)
1878 png_uint_32 temp;
1880 /* Length check; this cannot be ignored in this code because profile_length
1881 * is used later to check the tag table, so even if the profile seems over
1882 * long profile_length from the caller must be correct. The caller can fix
1883 * this up on read or write by just passing in the profile header length.
1885 temp = png_get_uint_32(profile);
1886 if (temp != profile_length)
1887 return png_icc_profile_error(png_ptr, colorspace, name, temp,
1888 "length does not match profile");
1890 temp = png_get_uint_32(profile+128); /* tag count: 12 bytes/tag */
1891 if (temp > 357913930 || /* (2^32-4-132)/12: maximum possible tag count */
1892 profile_length < 132+12*temp) /* truncated tag table */
1893 return png_icc_profile_error(png_ptr, colorspace, name, temp,
1894 "tag count too large");
1896 /* The 'intent' must be valid or we can't store it, ICC limits the intent to
1897 * 16 bits.
1899 temp = png_get_uint_32(profile+64);
1900 if (temp >= 0xffff) /* The ICC limit */
1901 return png_icc_profile_error(png_ptr, colorspace, name, temp,
1902 "invalid rendering intent");
1904 /* This is just a warning because the profile may be valid in future
1905 * versions.
1907 if (temp >= PNG_sRGB_INTENT_LAST)
1908 (void)png_icc_profile_error(png_ptr, NULL, name, temp,
1909 "intent outside defined range");
1911 /* At this point the tag table can't be checked because it hasn't necessarily
1912 * been loaded; however, various header fields can be checked. These checks
1913 * are for values permitted by the PNG spec in an ICC profile; the PNG spec
1914 * restricts the profiles that can be passed in an iCCP chunk (they must be
1915 * appropriate to processing PNG data!)
1918 /* Data checks (could be skipped). These checks must be independent of the
1919 * version number; however, the version number doesn't accomodate changes in
1920 * the header fields (just the known tags and the interpretation of the
1921 * data.)
1923 temp = png_get_uint_32(profile+36); /* signature 'ascp' */
1924 if (temp != 0x61637370)
1925 return png_icc_profile_error(png_ptr, colorspace, name, temp,
1926 "invalid signature");
1928 /* Currently the PCS illuminant/adopted white point (the computational
1929 * white point) are required to be D50,
1930 * however the profile contains a record of the illuminant so perhaps ICC
1931 * expects to be able to change this in the future (despite the rationale in
1932 * the introduction for using a fixed PCS adopted white.) Consequently the
1933 * following is just a warning.
1935 if (memcmp(profile+68, D50_nCIEXYZ, 12) != 0)
1936 (void)png_icc_profile_error(png_ptr, NULL, name, 0/*no tag value*/,
1937 "PCS illuminant is not D50");
1939 /* The PNG spec requires this:
1940 * "If the iCCP chunk is present, the image samples conform to the colour
1941 * space represented by the embedded ICC profile as defined by the
1942 * International Color Consortium [ICC]. The colour space of the ICC profile
1943 * shall be an RGB colour space for colour images (PNG colour types 2, 3, and
1944 * 6), or a greyscale colour space for greyscale images (PNG colour types 0
1945 * and 4)."
1947 * This checking code ensures the embedded profile (on either read or write)
1948 * conforms to the specification requirements. Notice that an ICC 'gray'
1949 * color-space profile contains the information to transform the monochrome
1950 * data to XYZ or L*a*b (according to which PCS the profile uses) and this
1951 * should be used in preference to the standard libpng K channel replication
1952 * into R, G and B channels.
1954 * Previously it was suggested that an RGB profile on grayscale data could be
1955 * handled. However it it is clear that using an RGB profile in this context
1956 * must be an error - there is no specification of what it means. Thus it is
1957 * almost certainly more correct to ignore the profile.
1959 temp = png_get_uint_32(profile+16); /* data colour space field */
1960 switch (temp)
1962 case 0x52474220: /* 'RGB ' */
1963 if (!(color_type & PNG_COLOR_MASK_COLOR))
1964 return png_icc_profile_error(png_ptr, colorspace, name, temp,
1965 "RGB color space not permitted on grayscale PNG");
1966 break;
1968 case 0x47524159: /* 'GRAY' */
1969 if (color_type & PNG_COLOR_MASK_COLOR)
1970 return png_icc_profile_error(png_ptr, colorspace, name, temp,
1971 "Gray color space not permitted on RGB PNG");
1972 break;
1974 default:
1975 return png_icc_profile_error(png_ptr, colorspace, name, temp,
1976 "invalid ICC profile color space");
1979 /* It is up to the application to check that the profile class matches the
1980 * application requirements; the spec provides no guidance, but it's pretty
1981 * weird if the profile is not scanner ('scnr'), monitor ('mntr'), printer
1982 * ('prtr') or 'spac' (for generic color spaces). Issue a warning in these
1983 * cases. Issue an error for device link or abstract profiles - these don't
1984 * contain the records necessary to transform the color-space to anything
1985 * other than the target device (and not even that for an abstract profile).
1986 * Profiles of these classes may not be embedded in images.
1988 temp = png_get_uint_32(profile+12); /* profile/device class */
1989 switch (temp)
1991 case 0x73636E72: /* 'scnr' */
1992 case 0x6D6E7472: /* 'mntr' */
1993 case 0x70727472: /* 'prtr' */
1994 case 0x73706163: /* 'spac' */
1995 /* All supported */
1996 break;
1998 case 0x61627374: /* 'abst' */
1999 /* May not be embedded in an image */
2000 return png_icc_profile_error(png_ptr, colorspace, name, temp,
2001 "invalid embedded Abstract ICC profile");
2003 case 0x6C696E6B: /* 'link' */
2004 /* DeviceLink profiles cannnot be interpreted in a non-device specific
2005 * fashion, if an app uses the AToB0Tag in the profile the results are
2006 * undefined unless the result is sent to the intended device,
2007 * therefore a DeviceLink profile should not be found embedded in a
2008 * PNG.
2010 return png_icc_profile_error(png_ptr, colorspace, name, temp,
2011 "unexpected DeviceLink ICC profile class");
2013 case 0x6E6D636C: /* 'nmcl' */
2014 /* A NamedColor profile is also device specific, however it doesn't
2015 * contain an AToB0 tag that is open to misintrepretation. Almost
2016 * certainly it will fail the tests below.
2018 (void)png_icc_profile_error(png_ptr, NULL, name, temp,
2019 "unexpected NamedColor ICC profile class");
2020 break;
2022 default:
2023 /* To allow for future enhancements to the profile accept unrecognized
2024 * profile classes with a warning, these then hit the test below on the
2025 * tag content to ensure they are backward compatible with one of the
2026 * understood profiles.
2028 (void)png_icc_profile_error(png_ptr, NULL, name, temp,
2029 "unrecognized ICC profile class");
2030 break;
2033 /* For any profile other than a device link one the PCS must be encoded
2034 * either in XYZ or Lab.
2036 temp = png_get_uint_32(profile+20);
2037 switch (temp)
2039 case 0x58595A20: /* 'XYZ ' */
2040 case 0x4C616220: /* 'Lab ' */
2041 break;
2043 default:
2044 return png_icc_profile_error(png_ptr, colorspace, name, temp,
2045 "unexpected ICC PCS encoding");
2048 return 1;
2051 int /* PRIVATE */
2052 png_icc_check_tag_table(png_const_structrp png_ptr, png_colorspacerp colorspace,
2053 png_const_charp name, png_uint_32 profile_length,
2054 png_const_bytep profile /* header plus whole tag table */)
2056 png_uint_32 tag_count = png_get_uint_32(profile+128);
2057 png_uint_32 itag;
2058 png_const_bytep tag = profile+132; /* The first tag */
2060 /* First scan all the tags in the table and add bits to the icc_info value
2061 * (temporarily in 'tags').
2063 for (itag=0; itag < tag_count; ++itag, tag += 12)
2065 png_uint_32 tag_id = png_get_uint_32(tag+0);
2066 png_uint_32 tag_start = png_get_uint_32(tag+4); /* must be aligned */
2067 png_uint_32 tag_length = png_get_uint_32(tag+8);/* not padded */
2069 /* The ICC specification does not exclude zero length tags, therefore the
2070 * start might actually be anywhere if there is no data, but this would be
2071 * a clear abuse of the intent of the standard so the start is checked for
2072 * being in range. All defined tag types have an 8 byte header - a 4 byte
2073 * type signature then 0.
2075 if ((tag_start & 3) != 0)
2077 /* CNHP730S.icc shipped with Microsoft Windows 64 violates this, it is
2078 * only a warning here because libpng does not care about the
2079 * alignment.
2081 (void)png_icc_profile_error(png_ptr, NULL, name, tag_id,
2082 "ICC profile tag start not a multiple of 4");
2085 /* This is a hard error; potentially it can cause read outside the
2086 * profile.
2088 if (tag_start > profile_length || tag_length > profile_length - tag_start)
2089 return png_icc_profile_error(png_ptr, colorspace, name, tag_id,
2090 "ICC profile tag outside profile");
2093 return 1; /* success, maybe with warnings */
2096 #ifdef PNG_sRGB_SUPPORTED
2097 /* Information about the known ICC sRGB profiles */
2098 static const struct
2100 png_uint_32 adler, crc, length;
2101 png_uint_32 md5[4];
2102 png_byte have_md5;
2103 png_byte is_broken;
2104 png_uint_16 intent;
2106 # define PNG_MD5(a,b,c,d) { a, b, c, d }, (a!=0)||(b!=0)||(c!=0)||(d!=0)
2107 # define PNG_ICC_CHECKSUM(adler, crc, md5, intent, broke, date, length, fname)\
2108 { adler, crc, length, md5, broke, intent },
2110 } png_sRGB_checks[] =
2112 /* This data comes from contrib/tools/checksum-icc run on downloads of
2113 * all four ICC sRGB profiles from www.color.org.
2115 /* adler32, crc32, MD5[4], intent, date, length, file-name */
2116 PNG_ICC_CHECKSUM(0x0a3fd9f6, 0x3b8772b9,
2117 PNG_MD5(0x29f83dde, 0xaff255ae, 0x7842fae4, 0xca83390d), 0, 0,
2118 "2009/03/27 21:36:31", 3048, "sRGB_IEC61966-2-1_black_scaled.icc")
2120 /* ICC sRGB v2 perceptual no black-compensation: */
2121 PNG_ICC_CHECKSUM(0x4909e5e1, 0x427ebb21,
2122 PNG_MD5(0xc95bd637, 0xe95d8a3b, 0x0df38f99, 0xc1320389), 1, 0,
2123 "2009/03/27 21:37:45", 3052, "sRGB_IEC61966-2-1_no_black_scaling.icc")
2125 PNG_ICC_CHECKSUM(0xfd2144a1, 0x306fd8ae,
2126 PNG_MD5(0xfc663378, 0x37e2886b, 0xfd72e983, 0x8228f1b8), 0, 0,
2127 "2009/08/10 17:28:01", 60988, "sRGB_v4_ICC_preference_displayclass.icc")
2129 /* ICC sRGB v4 perceptual */
2130 PNG_ICC_CHECKSUM(0x209c35d2, 0xbbef7812,
2131 PNG_MD5(0x34562abf, 0x994ccd06, 0x6d2c5721, 0xd0d68c5d), 0, 0,
2132 "2007/07/25 00:05:37", 60960, "sRGB_v4_ICC_preference.icc")
2134 /* The following profiles have no known MD5 checksum. If there is a match
2135 * on the (empty) MD5 the other fields are used to attempt a match and
2136 * a warning is produced. The first two of these profiles have a 'cprt' tag
2137 * which suggests that they were also made by Hewlett Packard.
2139 PNG_ICC_CHECKSUM(0xa054d762, 0x5d5129ce,
2140 PNG_MD5(0x00000000, 0x00000000, 0x00000000, 0x00000000), 1, 0,
2141 "2004/07/21 18:57:42", 3024, "sRGB_IEC61966-2-1_noBPC.icc")
2143 /* This is a 'mntr' (display) profile with a mediaWhitePointTag that does not
2144 * match the D50 PCS illuminant in the header (it is in fact the D65 values,
2145 * so the white point is recorded as the un-adapted value.) The profiles
2146 * below only differ in one byte - the intent - and are basically the same as
2147 * the previous profile except for the mediaWhitePointTag error and a missing
2148 * chromaticAdaptationTag.
2150 PNG_ICC_CHECKSUM(0xf784f3fb, 0x182ea552,
2151 PNG_MD5(0x00000000, 0x00000000, 0x00000000, 0x00000000), 0, 1/*broken*/,
2152 "1998/02/09 06:49:00", 3144, "HP-Microsoft sRGB v2 perceptual")
2154 PNG_ICC_CHECKSUM(0x0398f3fc, 0xf29e526d,
2155 PNG_MD5(0x00000000, 0x00000000, 0x00000000, 0x00000000), 1, 1/*broken*/,
2156 "1998/02/09 06:49:00", 3144, "HP-Microsoft sRGB v2 media-relative")
2159 static int
2160 png_compare_ICC_profile_with_sRGB(png_const_structrp png_ptr,
2161 png_const_bytep profile, uLong adler)
2163 /* The quick check is to verify just the MD5 signature and trust the
2164 * rest of the data. Because the profile has already been verified for
2165 * correctness this is safe. png_colorspace_set_sRGB will check the 'intent'
2166 * field too, so if the profile has been edited with an intent not defined
2167 * by sRGB (but maybe defined by a later ICC specification) the read of
2168 * the profile will fail at that point.
2170 png_uint_32 length = 0;
2171 png_uint_32 intent = 0x10000; /* invalid */
2172 #if PNG_sRGB_PROFILE_CHECKS > 1
2173 uLong crc = 0; /* the value for 0 length data */
2174 #endif
2175 unsigned int i;
2177 for (i=0; i < (sizeof png_sRGB_checks) / (sizeof png_sRGB_checks[0]); ++i)
2179 if (png_get_uint_32(profile+84) == png_sRGB_checks[i].md5[0] &&
2180 png_get_uint_32(profile+88) == png_sRGB_checks[i].md5[1] &&
2181 png_get_uint_32(profile+92) == png_sRGB_checks[i].md5[2] &&
2182 png_get_uint_32(profile+96) == png_sRGB_checks[i].md5[3])
2184 /* This may be one of the old HP profiles without an MD5, in that
2185 * case we can only use the length and Adler32 (note that these
2186 * are not used by default if there is an MD5!)
2188 # if PNG_sRGB_PROFILE_CHECKS == 0
2189 if (png_sRGB_checks[i].have_md5)
2190 return 1+png_sRGB_checks[i].is_broken;
2191 # endif
2193 /* Profile is unsigned or more checks have been configured in. */
2194 if (length == 0)
2196 length = png_get_uint_32(profile);
2197 intent = png_get_uint_32(profile+64);
2200 /* Length *and* intent must match */
2201 if (length == png_sRGB_checks[i].length &&
2202 intent == png_sRGB_checks[i].intent)
2204 /* Now calculate the adler32 if not done already. */
2205 if (adler == 0)
2207 adler = adler32(0, NULL, 0);
2208 adler = adler32(adler, profile, length);
2211 if (adler == png_sRGB_checks[i].adler)
2213 /* These basic checks suggest that the data has not been
2214 * modified, but if the check level is more than 1 perform
2215 * our own crc32 checksum on the data.
2217 # if PNG_sRGB_PROFILE_CHECKS > 1
2218 if (crc == 0)
2220 crc = crc32(0, NULL, 0);
2221 crc = crc32(crc, profile, length);
2224 /* So this check must pass for the 'return' below to happen.
2226 if (crc == png_sRGB_checks[i].crc)
2227 # endif
2229 if (png_sRGB_checks[i].is_broken)
2231 /* These profiles are known to have bad data that may cause
2232 * problems if they are used, therefore attempt to
2233 * discourage their use, skip the 'have_md5' warning below,
2234 * which is made irrelevant by this error.
2236 png_chunk_report(png_ptr, "known incorrect sRGB profile",
2237 PNG_CHUNK_ERROR);
2240 /* Warn that this being done; this isn't even an error since
2241 * the profile is perfectly valid, but it would be nice if
2242 * people used the up-to-date ones.
2244 else if (!png_sRGB_checks[i].have_md5)
2246 png_chunk_report(png_ptr,
2247 "out-of-date sRGB profile with no signature",
2248 PNG_CHUNK_WARNING);
2251 return 1+png_sRGB_checks[i].is_broken;
2256 # if PNG_sRGB_PROFILE_CHECKS > 0
2257 /* The signature matched, but the profile had been changed in some
2258 * way. This is an apparent violation of the ICC terms of use and,
2259 * anyway, probably indicates a data error or uninformed hacking.
2261 if (png_sRGB_checks[i].have_md5)
2262 png_benign_error(png_ptr,
2263 "copyright violation: edited ICC profile ignored");
2264 # endif
2268 return 0; /* no match */
2270 #endif
2272 #ifdef PNG_sRGB_SUPPORTED
2273 void /* PRIVATE */
2274 png_icc_set_sRGB(png_const_structrp png_ptr,
2275 png_colorspacerp colorspace, png_const_bytep profile, uLong adler)
2277 /* Is this profile one of the known ICC sRGB profiles? If it is, just set
2278 * the sRGB information.
2280 if (png_compare_ICC_profile_with_sRGB(png_ptr, profile, adler))
2281 (void)png_colorspace_set_sRGB(png_ptr, colorspace,
2282 (int)/*already checked*/png_get_uint_32(profile+64));
2284 #endif /* PNG_READ_sRGB_SUPPORTED */
2286 int /* PRIVATE */
2287 png_colorspace_set_ICC(png_const_structrp png_ptr, png_colorspacerp colorspace,
2288 png_const_charp name, png_uint_32 profile_length, png_const_bytep profile,
2289 int color_type)
2291 if (colorspace->flags & PNG_COLORSPACE_INVALID)
2292 return 0;
2294 if (png_icc_check_length(png_ptr, colorspace, name, profile_length) &&
2295 png_icc_check_header(png_ptr, colorspace, name, profile_length, profile,
2296 color_type) &&
2297 png_icc_check_tag_table(png_ptr, colorspace, name, profile_length,
2298 profile))
2300 # ifdef PNG_sRGB_SUPPORTED
2301 /* If no sRGB support, don't try storing sRGB information */
2302 png_icc_set_sRGB(png_ptr, colorspace, profile, 0);
2303 # endif
2304 return 1;
2307 /* Failure case */
2308 return 0;
2310 #endif /* iCCP */
2312 #ifdef PNG_READ_RGB_TO_GRAY_SUPPORTED
2313 void /* PRIVATE */
2314 png_colorspace_set_rgb_coefficients(png_structrp png_ptr)
2316 /* Set the rgb_to_gray coefficients from the colorspace. */
2317 if (!png_ptr->rgb_to_gray_coefficients_set &&
2318 (png_ptr->colorspace.flags & PNG_COLORSPACE_HAVE_ENDPOINTS) != 0)
2320 /* png_set_background has not been called, get the coefficients from the Y
2321 * values of the colorspace colorants.
2323 png_fixed_point r = png_ptr->colorspace.end_points_XYZ.red_Y;
2324 png_fixed_point g = png_ptr->colorspace.end_points_XYZ.green_Y;
2325 png_fixed_point b = png_ptr->colorspace.end_points_XYZ.blue_Y;
2326 png_fixed_point total = r+g+b;
2328 if (total > 0 &&
2329 r >= 0 && png_muldiv(&r, r, 32768, total) && r >= 0 && r <= 32768 &&
2330 g >= 0 && png_muldiv(&g, g, 32768, total) && g >= 0 && g <= 32768 &&
2331 b >= 0 && png_muldiv(&b, b, 32768, total) && b >= 0 && b <= 32768 &&
2332 r+g+b <= 32769)
2334 /* We allow 0 coefficients here. r+g+b may be 32769 if two or
2335 * all of the coefficients were rounded up. Handle this by
2336 * reducing the *largest* coefficient by 1; this matches the
2337 * approach used for the default coefficients in pngrtran.c
2339 int add = 0;
2341 if (r+g+b > 32768)
2342 add = -1;
2343 else if (r+g+b < 32768)
2344 add = 1;
2346 if (add != 0)
2348 if (g >= r && g >= b)
2349 g += add;
2350 else if (r >= g && r >= b)
2351 r += add;
2352 else
2353 b += add;
2356 /* Check for an internal error. */
2357 if (r+g+b != 32768)
2358 png_error(png_ptr,
2359 "internal error handling cHRM coefficients");
2361 else
2363 png_ptr->rgb_to_gray_red_coeff = (png_uint_16)r;
2364 png_ptr->rgb_to_gray_green_coeff = (png_uint_16)g;
2368 /* This is a png_error at present even though it could be ignored -
2369 * it should never happen, but it is important that if it does, the
2370 * bug is fixed.
2372 else
2373 png_error(png_ptr, "internal error handling cHRM->XYZ");
2376 #endif
2378 #endif /* COLORSPACE */
2380 void /* PRIVATE */
2381 png_check_IHDR(png_const_structrp png_ptr,
2382 png_uint_32 width, png_uint_32 height, int bit_depth,
2383 int color_type, int interlace_type, int compression_type,
2384 int filter_type)
2386 int error = 0;
2388 /* Check for width and height valid values */
2389 if (width == 0)
2391 png_warning(png_ptr, "Image width is zero in IHDR");
2392 error = 1;
2395 if (height == 0)
2397 png_warning(png_ptr, "Image height is zero in IHDR");
2398 error = 1;
2401 # ifdef PNG_SET_USER_LIMITS_SUPPORTED
2402 if (width > png_ptr->user_width_max)
2404 # else
2405 if (width > PNG_USER_WIDTH_MAX)
2406 # endif
2408 png_warning(png_ptr, "Image width exceeds user limit in IHDR");
2409 error = 1;
2412 # ifdef PNG_SET_USER_LIMITS_SUPPORTED
2413 if (height > png_ptr->user_height_max)
2414 # else
2415 if (height > PNG_USER_HEIGHT_MAX)
2416 # endif
2418 png_warning(png_ptr, "Image height exceeds user limit in IHDR");
2419 error = 1;
2422 if (width > PNG_UINT_31_MAX)
2424 png_warning(png_ptr, "Invalid image width in IHDR");
2425 error = 1;
2428 if (height > PNG_UINT_31_MAX)
2430 png_warning(png_ptr, "Invalid image height in IHDR");
2431 error = 1;
2434 if (width > (PNG_UINT_32_MAX
2435 >> 3) /* 8-byte RGBA pixels */
2436 - 48 /* bigrowbuf hack */
2437 - 1 /* filter byte */
2438 - 7*8 /* rounding of width to multiple of 8 pixels */
2439 - 8) /* extra max_pixel_depth pad */
2440 png_warning(png_ptr, "Width is too large for libpng to process pixels");
2442 /* Check other values */
2443 if (bit_depth != 1 && bit_depth != 2 && bit_depth != 4 &&
2444 bit_depth != 8 && bit_depth != 16)
2446 png_warning(png_ptr, "Invalid bit depth in IHDR");
2447 error = 1;
2450 if (color_type < 0 || color_type == 1 ||
2451 color_type == 5 || color_type > 6)
2453 png_warning(png_ptr, "Invalid color type in IHDR");
2454 error = 1;
2457 if (((color_type == PNG_COLOR_TYPE_PALETTE) && bit_depth > 8) ||
2458 ((color_type == PNG_COLOR_TYPE_RGB ||
2459 color_type == PNG_COLOR_TYPE_GRAY_ALPHA ||
2460 color_type == PNG_COLOR_TYPE_RGB_ALPHA) && bit_depth < 8))
2462 png_warning(png_ptr, "Invalid color type/bit depth combination in IHDR");
2463 error = 1;
2466 if (interlace_type >= PNG_INTERLACE_LAST)
2468 png_warning(png_ptr, "Unknown interlace method in IHDR");
2469 error = 1;
2472 if (compression_type != PNG_COMPRESSION_TYPE_BASE)
2474 png_warning(png_ptr, "Unknown compression method in IHDR");
2475 error = 1;
2478 # ifdef PNG_MNG_FEATURES_SUPPORTED
2479 /* Accept filter_method 64 (intrapixel differencing) only if
2480 * 1. Libpng was compiled with PNG_MNG_FEATURES_SUPPORTED and
2481 * 2. Libpng did not read a PNG signature (this filter_method is only
2482 * used in PNG datastreams that are embedded in MNG datastreams) and
2483 * 3. The application called png_permit_mng_features with a mask that
2484 * included PNG_FLAG_MNG_FILTER_64 and
2485 * 4. The filter_method is 64 and
2486 * 5. The color_type is RGB or RGBA
2488 if ((png_ptr->mode & PNG_HAVE_PNG_SIGNATURE) &&
2489 png_ptr->mng_features_permitted)
2490 png_warning(png_ptr, "MNG features are not allowed in a PNG datastream");
2492 if (filter_type != PNG_FILTER_TYPE_BASE)
2494 if (!((png_ptr->mng_features_permitted & PNG_FLAG_MNG_FILTER_64) &&
2495 (filter_type == PNG_INTRAPIXEL_DIFFERENCING) &&
2496 ((png_ptr->mode & PNG_HAVE_PNG_SIGNATURE) == 0) &&
2497 (color_type == PNG_COLOR_TYPE_RGB ||
2498 color_type == PNG_COLOR_TYPE_RGB_ALPHA)))
2500 png_warning(png_ptr, "Unknown filter method in IHDR");
2501 error = 1;
2504 if (png_ptr->mode & PNG_HAVE_PNG_SIGNATURE)
2506 png_warning(png_ptr, "Invalid filter method in IHDR");
2507 error = 1;
2511 # else
2512 if (filter_type != PNG_FILTER_TYPE_BASE)
2514 png_warning(png_ptr, "Unknown filter method in IHDR");
2515 error = 1;
2517 # endif
2519 if (error == 1)
2520 png_error(png_ptr, "Invalid IHDR data");
2523 #if defined(PNG_sCAL_SUPPORTED) || defined(PNG_pCAL_SUPPORTED)
2524 /* ASCII to fp functions */
2525 /* Check an ASCII formated floating point value, see the more detailed
2526 * comments in pngpriv.h
2528 /* The following is used internally to preserve the sticky flags */
2529 #define png_fp_add(state, flags) ((state) |= (flags))
2530 #define png_fp_set(state, value) ((state) = (value) | ((state) & PNG_FP_STICKY))
2532 int /* PRIVATE */
2533 png_check_fp_number(png_const_charp string, png_size_t size, int *statep,
2534 png_size_tp whereami)
2536 int state = *statep;
2537 png_size_t i = *whereami;
2539 while (i < size)
2541 int type;
2542 /* First find the type of the next character */
2543 switch (string[i])
2545 case 43: type = PNG_FP_SAW_SIGN; break;
2546 case 45: type = PNG_FP_SAW_SIGN + PNG_FP_NEGATIVE; break;
2547 case 46: type = PNG_FP_SAW_DOT; break;
2548 case 48: type = PNG_FP_SAW_DIGIT; break;
2549 case 49: case 50: case 51: case 52:
2550 case 53: case 54: case 55: case 56:
2551 case 57: type = PNG_FP_SAW_DIGIT + PNG_FP_NONZERO; break;
2552 case 69:
2553 case 101: type = PNG_FP_SAW_E; break;
2554 default: goto PNG_FP_End;
2557 /* Now deal with this type according to the current
2558 * state, the type is arranged to not overlap the
2559 * bits of the PNG_FP_STATE.
2561 switch ((state & PNG_FP_STATE) + (type & PNG_FP_SAW_ANY))
2563 case PNG_FP_INTEGER + PNG_FP_SAW_SIGN:
2564 if (state & PNG_FP_SAW_ANY)
2565 goto PNG_FP_End; /* not a part of the number */
2567 png_fp_add(state, type);
2568 break;
2570 case PNG_FP_INTEGER + PNG_FP_SAW_DOT:
2571 /* Ok as trailer, ok as lead of fraction. */
2572 if (state & PNG_FP_SAW_DOT) /* two dots */
2573 goto PNG_FP_End;
2575 else if (state & PNG_FP_SAW_DIGIT) /* trailing dot? */
2576 png_fp_add(state, type);
2578 else
2579 png_fp_set(state, PNG_FP_FRACTION | type);
2581 break;
2583 case PNG_FP_INTEGER + PNG_FP_SAW_DIGIT:
2584 if (state & PNG_FP_SAW_DOT) /* delayed fraction */
2585 png_fp_set(state, PNG_FP_FRACTION | PNG_FP_SAW_DOT);
2587 png_fp_add(state, type | PNG_FP_WAS_VALID);
2589 break;
2591 case PNG_FP_INTEGER + PNG_FP_SAW_E:
2592 if ((state & PNG_FP_SAW_DIGIT) == 0)
2593 goto PNG_FP_End;
2595 png_fp_set(state, PNG_FP_EXPONENT);
2597 break;
2599 /* case PNG_FP_FRACTION + PNG_FP_SAW_SIGN:
2600 goto PNG_FP_End; ** no sign in fraction */
2602 /* case PNG_FP_FRACTION + PNG_FP_SAW_DOT:
2603 goto PNG_FP_End; ** Because SAW_DOT is always set */
2605 case PNG_FP_FRACTION + PNG_FP_SAW_DIGIT:
2606 png_fp_add(state, type | PNG_FP_WAS_VALID);
2607 break;
2609 case PNG_FP_FRACTION + PNG_FP_SAW_E:
2610 /* This is correct because the trailing '.' on an
2611 * integer is handled above - so we can only get here
2612 * with the sequence ".E" (with no preceding digits).
2614 if ((state & PNG_FP_SAW_DIGIT) == 0)
2615 goto PNG_FP_End;
2617 png_fp_set(state, PNG_FP_EXPONENT);
2619 break;
2621 case PNG_FP_EXPONENT + PNG_FP_SAW_SIGN:
2622 if (state & PNG_FP_SAW_ANY)
2623 goto PNG_FP_End; /* not a part of the number */
2625 png_fp_add(state, PNG_FP_SAW_SIGN);
2627 break;
2629 /* case PNG_FP_EXPONENT + PNG_FP_SAW_DOT:
2630 goto PNG_FP_End; */
2632 case PNG_FP_EXPONENT + PNG_FP_SAW_DIGIT:
2633 png_fp_add(state, PNG_FP_SAW_DIGIT | PNG_FP_WAS_VALID);
2635 break;
2637 /* case PNG_FP_EXPONEXT + PNG_FP_SAW_E:
2638 goto PNG_FP_End; */
2640 default: goto PNG_FP_End; /* I.e. break 2 */
2643 /* The character seems ok, continue. */
2644 ++i;
2647 PNG_FP_End:
2648 /* Here at the end, update the state and return the correct
2649 * return code.
2651 *statep = state;
2652 *whereami = i;
2654 return (state & PNG_FP_SAW_DIGIT) != 0;
2658 /* The same but for a complete string. */
2660 png_check_fp_string(png_const_charp string, png_size_t size)
2662 int state=0;
2663 png_size_t char_index=0;
2665 if (png_check_fp_number(string, size, &state, &char_index) &&
2666 (char_index == size || string[char_index] == 0))
2667 return state /* must be non-zero - see above */;
2669 return 0; /* i.e. fail */
2671 #endif /* pCAL or sCAL */
2673 #ifdef PNG_sCAL_SUPPORTED
2674 # ifdef PNG_FLOATING_POINT_SUPPORTED
2675 /* Utility used below - a simple accurate power of ten from an integral
2676 * exponent.
2678 static double
2679 png_pow10(int power)
2681 int recip = 0;
2682 double d = 1;
2684 /* Handle negative exponent with a reciprocal at the end because
2685 * 10 is exact whereas .1 is inexact in base 2
2687 if (power < 0)
2689 if (power < DBL_MIN_10_EXP) return 0;
2690 recip = 1, power = -power;
2693 if (power > 0)
2695 /* Decompose power bitwise. */
2696 double mult = 10;
2699 if (power & 1) d *= mult;
2700 mult *= mult;
2701 power >>= 1;
2703 while (power > 0);
2705 if (recip) d = 1/d;
2707 /* else power is 0 and d is 1 */
2709 return d;
2712 /* Function to format a floating point value in ASCII with a given
2713 * precision.
2715 void /* PRIVATE */
2716 png_ascii_from_fp(png_const_structrp png_ptr, png_charp ascii, png_size_t size,
2717 double fp, unsigned int precision)
2719 /* We use standard functions from math.h, but not printf because
2720 * that would require stdio. The caller must supply a buffer of
2721 * sufficient size or we will png_error. The tests on size and
2722 * the space in ascii[] consumed are indicated below.
2724 if (precision < 1)
2725 precision = DBL_DIG;
2727 /* Enforce the limit of the implementation precision too. */
2728 if (precision > DBL_DIG+1)
2729 precision = DBL_DIG+1;
2731 /* Basic sanity checks */
2732 if (size >= precision+5) /* See the requirements below. */
2734 if (fp < 0)
2736 fp = -fp;
2737 *ascii++ = 45; /* '-' PLUS 1 TOTAL 1 */
2738 --size;
2741 if (fp >= DBL_MIN && fp <= DBL_MAX)
2743 int exp_b10; /* A base 10 exponent */
2744 double base; /* 10^exp_b10 */
2746 /* First extract a base 10 exponent of the number,
2747 * the calculation below rounds down when converting
2748 * from base 2 to base 10 (multiply by log10(2) -
2749 * 0.3010, but 77/256 is 0.3008, so exp_b10 needs to
2750 * be increased. Note that the arithmetic shift
2751 * performs a floor() unlike C arithmetic - using a
2752 * C multiply would break the following for negative
2753 * exponents.
2755 (void)frexp(fp, &exp_b10); /* exponent to base 2 */
2757 exp_b10 = (exp_b10 * 77) >> 8; /* <= exponent to base 10 */
2759 /* Avoid underflow here. */
2760 base = png_pow10(exp_b10); /* May underflow */
2762 while (base < DBL_MIN || base < fp)
2764 /* And this may overflow. */
2765 double test = png_pow10(exp_b10+1);
2767 if (test <= DBL_MAX)
2768 ++exp_b10, base = test;
2770 else
2771 break;
2774 /* Normalize fp and correct exp_b10, after this fp is in the
2775 * range [.1,1) and exp_b10 is both the exponent and the digit
2776 * *before* which the decimal point should be inserted
2777 * (starting with 0 for the first digit). Note that this
2778 * works even if 10^exp_b10 is out of range because of the
2779 * test on DBL_MAX above.
2781 fp /= base;
2782 while (fp >= 1) fp /= 10, ++exp_b10;
2784 /* Because of the code above fp may, at this point, be
2785 * less than .1, this is ok because the code below can
2786 * handle the leading zeros this generates, so no attempt
2787 * is made to correct that here.
2791 int czero, clead, cdigits;
2792 char exponent[10];
2794 /* Allow up to two leading zeros - this will not lengthen
2795 * the number compared to using E-n.
2797 if (exp_b10 < 0 && exp_b10 > -3) /* PLUS 3 TOTAL 4 */
2799 czero = -exp_b10; /* PLUS 2 digits: TOTAL 3 */
2800 exp_b10 = 0; /* Dot added below before first output. */
2802 else
2803 czero = 0; /* No zeros to add */
2805 /* Generate the digit list, stripping trailing zeros and
2806 * inserting a '.' before a digit if the exponent is 0.
2808 clead = czero; /* Count of leading zeros */
2809 cdigits = 0; /* Count of digits in list. */
2813 double d;
2815 fp *= 10;
2816 /* Use modf here, not floor and subtract, so that
2817 * the separation is done in one step. At the end
2818 * of the loop don't break the number into parts so
2819 * that the final digit is rounded.
2821 if (cdigits+czero-clead+1 < (int)precision)
2822 fp = modf(fp, &d);
2824 else
2826 d = floor(fp + .5);
2828 if (d > 9)
2830 /* Rounding up to 10, handle that here. */
2831 if (czero > 0)
2833 --czero, d = 1;
2834 if (cdigits == 0) --clead;
2836 else
2838 while (cdigits > 0 && d > 9)
2840 int ch = *--ascii;
2842 if (exp_b10 != (-1))
2843 ++exp_b10;
2845 else if (ch == 46)
2847 ch = *--ascii, ++size;
2848 /* Advance exp_b10 to '1', so that the
2849 * decimal point happens after the
2850 * previous digit.
2852 exp_b10 = 1;
2855 --cdigits;
2856 d = ch - 47; /* I.e. 1+(ch-48) */
2859 /* Did we reach the beginning? If so adjust the
2860 * exponent but take into account the leading
2861 * decimal point.
2863 if (d > 9) /* cdigits == 0 */
2865 if (exp_b10 == (-1))
2867 /* Leading decimal point (plus zeros?), if
2868 * we lose the decimal point here it must
2869 * be reentered below.
2871 int ch = *--ascii;
2873 if (ch == 46)
2874 ++size, exp_b10 = 1;
2876 /* Else lost a leading zero, so 'exp_b10' is
2877 * still ok at (-1)
2880 else
2881 ++exp_b10;
2883 /* In all cases we output a '1' */
2884 d = 1;
2888 fp = 0; /* Guarantees termination below. */
2891 if (d == 0)
2893 ++czero;
2894 if (cdigits == 0) ++clead;
2896 else
2898 /* Included embedded zeros in the digit count. */
2899 cdigits += czero - clead;
2900 clead = 0;
2902 while (czero > 0)
2904 /* exp_b10 == (-1) means we just output the decimal
2905 * place - after the DP don't adjust 'exp_b10' any
2906 * more!
2908 if (exp_b10 != (-1))
2910 if (exp_b10 == 0) *ascii++ = 46, --size;
2911 /* PLUS 1: TOTAL 4 */
2912 --exp_b10;
2914 *ascii++ = 48, --czero;
2917 if (exp_b10 != (-1))
2919 if (exp_b10 == 0) *ascii++ = 46, --size; /* counted
2920 above */
2921 --exp_b10;
2923 *ascii++ = (char)(48 + (int)d), ++cdigits;
2926 while (cdigits+czero-clead < (int)precision && fp > DBL_MIN);
2928 /* The total output count (max) is now 4+precision */
2930 /* Check for an exponent, if we don't need one we are
2931 * done and just need to terminate the string. At
2932 * this point exp_b10==(-1) is effectively if flag - it got
2933 * to '-1' because of the decrement after outputing
2934 * the decimal point above (the exponent required is
2935 * *not* -1!)
2937 if (exp_b10 >= (-1) && exp_b10 <= 2)
2939 /* The following only happens if we didn't output the
2940 * leading zeros above for negative exponent, so this
2941 * doest add to the digit requirement. Note that the
2942 * two zeros here can only be output if the two leading
2943 * zeros were *not* output, so this doesn't increase
2944 * the output count.
2946 while (--exp_b10 >= 0) *ascii++ = 48;
2948 *ascii = 0;
2950 /* Total buffer requirement (including the '\0') is
2951 * 5+precision - see check at the start.
2953 return;
2956 /* Here if an exponent is required, adjust size for
2957 * the digits we output but did not count. The total
2958 * digit output here so far is at most 1+precision - no
2959 * decimal point and no leading or trailing zeros have
2960 * been output.
2962 size -= cdigits;
2964 *ascii++ = 69, --size; /* 'E': PLUS 1 TOTAL 2+precision */
2966 /* The following use of an unsigned temporary avoids ambiguities in
2967 * the signed arithmetic on exp_b10 and permits GCC at least to do
2968 * better optimization.
2971 unsigned int uexp_b10;
2973 if (exp_b10 < 0)
2975 *ascii++ = 45, --size; /* '-': PLUS 1 TOTAL 3+precision */
2976 uexp_b10 = -exp_b10;
2979 else
2980 uexp_b10 = exp_b10;
2982 cdigits = 0;
2984 while (uexp_b10 > 0)
2986 exponent[cdigits++] = (char)(48 + uexp_b10 % 10);
2987 uexp_b10 /= 10;
2991 /* Need another size check here for the exponent digits, so
2992 * this need not be considered above.
2994 if ((int)size > cdigits)
2996 while (cdigits > 0) *ascii++ = exponent[--cdigits];
2998 *ascii = 0;
3000 return;
3004 else if (!(fp >= DBL_MIN))
3006 *ascii++ = 48; /* '0' */
3007 *ascii = 0;
3008 return;
3010 else
3012 *ascii++ = 105; /* 'i' */
3013 *ascii++ = 110; /* 'n' */
3014 *ascii++ = 102; /* 'f' */
3015 *ascii = 0;
3016 return;
3020 /* Here on buffer too small. */
3021 png_error(png_ptr, "ASCII conversion buffer too small");
3024 # endif /* FLOATING_POINT */
3026 # ifdef PNG_FIXED_POINT_SUPPORTED
3027 /* Function to format a fixed point value in ASCII.
3029 void /* PRIVATE */
3030 png_ascii_from_fixed(png_const_structrp png_ptr, png_charp ascii,
3031 png_size_t size, png_fixed_point fp)
3033 /* Require space for 10 decimal digits, a decimal point, a minus sign and a
3034 * trailing \0, 13 characters:
3036 if (size > 12)
3038 png_uint_32 num;
3040 /* Avoid overflow here on the minimum integer. */
3041 if (fp < 0)
3042 *ascii++ = 45, --size, num = -fp;
3043 else
3044 num = fp;
3046 if (num <= 0x80000000) /* else overflowed */
3048 unsigned int ndigits = 0, first = 16 /* flag value */;
3049 char digits[10];
3051 while (num)
3053 /* Split the low digit off num: */
3054 unsigned int tmp = num/10;
3055 num -= tmp*10;
3056 digits[ndigits++] = (char)(48 + num);
3057 /* Record the first non-zero digit, note that this is a number
3058 * starting at 1, it's not actually the array index.
3060 if (first == 16 && num > 0)
3061 first = ndigits;
3062 num = tmp;
3065 if (ndigits > 0)
3067 while (ndigits > 5) *ascii++ = digits[--ndigits];
3068 /* The remaining digits are fractional digits, ndigits is '5' or
3069 * smaller at this point. It is certainly not zero. Check for a
3070 * non-zero fractional digit:
3072 if (first <= 5)
3074 unsigned int i;
3075 *ascii++ = 46; /* decimal point */
3076 /* ndigits may be <5 for small numbers, output leading zeros
3077 * then ndigits digits to first:
3079 i = 5;
3080 while (ndigits < i) *ascii++ = 48, --i;
3081 while (ndigits >= first) *ascii++ = digits[--ndigits];
3082 /* Don't output the trailing zeros! */
3085 else
3086 *ascii++ = 48;
3088 /* And null terminate the string: */
3089 *ascii = 0;
3090 return;
3094 /* Here on buffer too small. */
3095 png_error(png_ptr, "ASCII conversion buffer too small");
3097 # endif /* FIXED_POINT */
3098 #endif /* READ_SCAL */
3100 #if defined(PNG_FLOATING_POINT_SUPPORTED) && \
3101 !defined(PNG_FIXED_POINT_MACRO_SUPPORTED) && \
3102 (defined(PNG_gAMA_SUPPORTED) || defined(PNG_cHRM_SUPPORTED) || \
3103 defined(PNG_sCAL_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED) || \
3104 defined(PNG_READ_RGB_TO_GRAY_SUPPORTED)) || \
3105 (defined(PNG_sCAL_SUPPORTED) && \
3106 defined(PNG_FLOATING_ARITHMETIC_SUPPORTED))
3107 png_fixed_point
3108 png_fixed(png_const_structrp png_ptr, double fp, png_const_charp text)
3110 double r = floor(100000 * fp + .5);
3112 if (r > 2147483647. || r < -2147483648.)
3113 png_fixed_error(png_ptr, text);
3115 return (png_fixed_point)r;
3117 #endif
3119 #if defined(PNG_READ_GAMMA_SUPPORTED) || \
3120 defined(PNG_INCH_CONVERSIONS_SUPPORTED) || defined(PNG_READ_pHYs_SUPPORTED)
3121 /* muldiv functions */
3122 /* This API takes signed arguments and rounds the result to the nearest
3123 * integer (or, for a fixed point number - the standard argument - to
3124 * the nearest .00001). Overflow and divide by zero are signalled in
3125 * the result, a boolean - true on success, false on overflow.
3128 png_muldiv(png_fixed_point_p res, png_fixed_point a, png_int_32 times,
3129 png_int_32 divisor)
3131 /* Return a * times / divisor, rounded. */
3132 if (divisor != 0)
3134 if (a == 0 || times == 0)
3136 *res = 0;
3137 return 1;
3139 else
3141 #ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
3142 double r = a;
3143 r *= times;
3144 r /= divisor;
3145 r = floor(r+.5);
3147 /* A png_fixed_point is a 32-bit integer. */
3148 if (r <= 2147483647. && r >= -2147483648.)
3150 *res = (png_fixed_point)r;
3151 return 1;
3153 #else
3154 int negative = 0;
3155 png_uint_32 A, T, D;
3156 png_uint_32 s16, s32, s00;
3158 if (a < 0)
3159 negative = 1, A = -a;
3160 else
3161 A = a;
3163 if (times < 0)
3164 negative = !negative, T = -times;
3165 else
3166 T = times;
3168 if (divisor < 0)
3169 negative = !negative, D = -divisor;
3170 else
3171 D = divisor;
3173 /* Following can't overflow because the arguments only
3174 * have 31 bits each, however the result may be 32 bits.
3176 s16 = (A >> 16) * (T & 0xffff) +
3177 (A & 0xffff) * (T >> 16);
3178 /* Can't overflow because the a*times bit is only 30
3179 * bits at most.
3181 s32 = (A >> 16) * (T >> 16) + (s16 >> 16);
3182 s00 = (A & 0xffff) * (T & 0xffff);
3184 s16 = (s16 & 0xffff) << 16;
3185 s00 += s16;
3187 if (s00 < s16)
3188 ++s32; /* carry */
3190 if (s32 < D) /* else overflow */
3192 /* s32.s00 is now the 64-bit product, do a standard
3193 * division, we know that s32 < D, so the maximum
3194 * required shift is 31.
3196 int bitshift = 32;
3197 png_fixed_point result = 0; /* NOTE: signed */
3199 while (--bitshift >= 0)
3201 png_uint_32 d32, d00;
3203 if (bitshift > 0)
3204 d32 = D >> (32-bitshift), d00 = D << bitshift;
3206 else
3207 d32 = 0, d00 = D;
3209 if (s32 > d32)
3211 if (s00 < d00) --s32; /* carry */
3212 s32 -= d32, s00 -= d00, result += 1<<bitshift;
3215 else
3216 if (s32 == d32 && s00 >= d00)
3217 s32 = 0, s00 -= d00, result += 1<<bitshift;
3220 /* Handle the rounding. */
3221 if (s00 >= (D >> 1))
3222 ++result;
3224 if (negative)
3225 result = -result;
3227 /* Check for overflow. */
3228 if ((negative && result <= 0) || (!negative && result >= 0))
3230 *res = result;
3231 return 1;
3234 #endif
3238 return 0;
3240 #endif /* READ_GAMMA || INCH_CONVERSIONS */
3242 #if defined(PNG_READ_GAMMA_SUPPORTED) || defined(PNG_INCH_CONVERSIONS_SUPPORTED)
3243 /* The following is for when the caller doesn't much care about the
3244 * result.
3246 png_fixed_point
3247 png_muldiv_warn(png_const_structrp png_ptr, png_fixed_point a, png_int_32 times,
3248 png_int_32 divisor)
3250 png_fixed_point result;
3252 if (png_muldiv(&result, a, times, divisor))
3253 return result;
3255 png_warning(png_ptr, "fixed point overflow ignored");
3256 return 0;
3258 #endif
3260 #ifdef PNG_GAMMA_SUPPORTED /* more fixed point functions for gamma */
3261 /* Calculate a reciprocal, return 0 on div-by-zero or overflow. */
3262 png_fixed_point
3263 png_reciprocal(png_fixed_point a)
3265 #ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
3266 double r = floor(1E10/a+.5);
3268 if (r <= 2147483647. && r >= -2147483648.)
3269 return (png_fixed_point)r;
3270 #else
3271 png_fixed_point res;
3273 if (png_muldiv(&res, 100000, 100000, a))
3274 return res;
3275 #endif
3277 return 0; /* error/overflow */
3280 /* This is the shared test on whether a gamma value is 'significant' - whether
3281 * it is worth doing gamma correction.
3283 int /* PRIVATE */
3284 png_gamma_significant(png_fixed_point gamma_val)
3286 return gamma_val < PNG_FP_1 - PNG_GAMMA_THRESHOLD_FIXED ||
3287 gamma_val > PNG_FP_1 + PNG_GAMMA_THRESHOLD_FIXED;
3289 #endif
3291 #ifdef PNG_READ_GAMMA_SUPPORTED
3292 /* A local convenience routine. */
3293 static png_fixed_point
3294 png_product2(png_fixed_point a, png_fixed_point b)
3296 /* The required result is 1/a * 1/b; the following preserves accuracy. */
3297 #ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
3298 double r = a * 1E-5;
3299 r *= b;
3300 r = floor(r+.5);
3302 if (r <= 2147483647. && r >= -2147483648.)
3303 return (png_fixed_point)r;
3304 #else
3305 png_fixed_point res;
3307 if (png_muldiv(&res, a, b, 100000))
3308 return res;
3309 #endif
3311 return 0; /* overflow */
3314 /* The inverse of the above. */
3315 png_fixed_point
3316 png_reciprocal2(png_fixed_point a, png_fixed_point b)
3318 /* The required result is 1/a * 1/b; the following preserves accuracy. */
3319 #ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
3320 double r = 1E15/a;
3321 r /= b;
3322 r = floor(r+.5);
3324 if (r <= 2147483647. && r >= -2147483648.)
3325 return (png_fixed_point)r;
3326 #else
3327 /* This may overflow because the range of png_fixed_point isn't symmetric,
3328 * but this API is only used for the product of file and screen gamma so it
3329 * doesn't matter that the smallest number it can produce is 1/21474, not
3330 * 1/100000
3332 png_fixed_point res = png_product2(a, b);
3334 if (res != 0)
3335 return png_reciprocal(res);
3336 #endif
3338 return 0; /* overflow */
3340 #endif /* READ_GAMMA */
3342 #ifdef PNG_READ_GAMMA_SUPPORTED /* gamma table code */
3343 #ifndef PNG_FLOATING_ARITHMETIC_SUPPORTED
3344 /* Fixed point gamma.
3346 * The code to calculate the tables used below can be found in the shell script
3347 * contrib/tools/intgamma.sh
3349 * To calculate gamma this code implements fast log() and exp() calls using only
3350 * fixed point arithmetic. This code has sufficient precision for either 8-bit
3351 * or 16-bit sample values.
3353 * The tables used here were calculated using simple 'bc' programs, but C double
3354 * precision floating point arithmetic would work fine.
3356 * 8-bit log table
3357 * This is a table of -log(value/255)/log(2) for 'value' in the range 128 to
3358 * 255, so it's the base 2 logarithm of a normalized 8-bit floating point
3359 * mantissa. The numbers are 32-bit fractions.
3361 static const png_uint_32
3362 png_8bit_l2[128] =
3364 4270715492U, 4222494797U, 4174646467U, 4127164793U, 4080044201U, 4033279239U,
3365 3986864580U, 3940795015U, 3895065449U, 3849670902U, 3804606499U, 3759867474U,
3366 3715449162U, 3671346997U, 3627556511U, 3584073329U, 3540893168U, 3498011834U,
3367 3455425220U, 3413129301U, 3371120137U, 3329393864U, 3287946700U, 3246774933U,
3368 3205874930U, 3165243125U, 3124876025U, 3084770202U, 3044922296U, 3005329011U,
3369 2965987113U, 2926893432U, 2888044853U, 2849438323U, 2811070844U, 2772939474U,
3370 2735041326U, 2697373562U, 2659933400U, 2622718104U, 2585724991U, 2548951424U,
3371 2512394810U, 2476052606U, 2439922311U, 2404001468U, 2368287663U, 2332778523U,
3372 2297471715U, 2262364947U, 2227455964U, 2192742551U, 2158222529U, 2123893754U,
3373 2089754119U, 2055801552U, 2022034013U, 1988449497U, 1955046031U, 1921821672U,
3374 1888774511U, 1855902668U, 1823204291U, 1790677560U, 1758320682U, 1726131893U,
3375 1694109454U, 1662251657U, 1630556815U, 1599023271U, 1567649391U, 1536433567U,
3376 1505374214U, 1474469770U, 1443718700U, 1413119487U, 1382670639U, 1352370686U,
3377 1322218179U, 1292211689U, 1262349810U, 1232631153U, 1203054352U, 1173618059U,
3378 1144320946U, 1115161701U, 1086139034U, 1057251672U, 1028498358U, 999877854U,
3379 971388940U, 943030410U, 914801076U, 886699767U, 858725327U, 830876614U,
3380 803152505U, 775551890U, 748073672U, 720716771U, 693480120U, 666362667U,
3381 639363374U, 612481215U, 585715177U, 559064263U, 532527486U, 506103872U,
3382 479792461U, 453592303U, 427502463U, 401522014U, 375650043U, 349885648U,
3383 324227938U, 298676034U, 273229066U, 247886176U, 222646516U, 197509248U,
3384 172473545U, 147538590U, 122703574U, 97967701U, 73330182U, 48790236U,
3385 24347096U, 0U
3387 #if 0
3388 /* The following are the values for 16-bit tables - these work fine for the
3389 * 8-bit conversions but produce very slightly larger errors in the 16-bit
3390 * log (about 1.2 as opposed to 0.7 absolute error in the final value). To
3391 * use these all the shifts below must be adjusted appropriately.
3393 65166, 64430, 63700, 62976, 62257, 61543, 60835, 60132, 59434, 58741, 58054,
3394 57371, 56693, 56020, 55352, 54689, 54030, 53375, 52726, 52080, 51439, 50803,
3395 50170, 49542, 48918, 48298, 47682, 47070, 46462, 45858, 45257, 44661, 44068,
3396 43479, 42894, 42312, 41733, 41159, 40587, 40020, 39455, 38894, 38336, 37782,
3397 37230, 36682, 36137, 35595, 35057, 34521, 33988, 33459, 32932, 32408, 31887,
3398 31369, 30854, 30341, 29832, 29325, 28820, 28319, 27820, 27324, 26830, 26339,
3399 25850, 25364, 24880, 24399, 23920, 23444, 22970, 22499, 22029, 21562, 21098,
3400 20636, 20175, 19718, 19262, 18808, 18357, 17908, 17461, 17016, 16573, 16132,
3401 15694, 15257, 14822, 14390, 13959, 13530, 13103, 12678, 12255, 11834, 11415,
3402 10997, 10582, 10168, 9756, 9346, 8937, 8531, 8126, 7723, 7321, 6921, 6523,
3403 6127, 5732, 5339, 4947, 4557, 4169, 3782, 3397, 3014, 2632, 2251, 1872, 1495,
3404 1119, 744, 372
3405 #endif
3408 static png_int_32
3409 png_log8bit(unsigned int x)
3411 unsigned int lg2 = 0;
3412 /* Each time 'x' is multiplied by 2, 1 must be subtracted off the final log,
3413 * because the log is actually negate that means adding 1. The final
3414 * returned value thus has the range 0 (for 255 input) to 7.994 (for 1
3415 * input), return -1 for the overflow (log 0) case, - so the result is
3416 * always at most 19 bits.
3418 if ((x &= 0xff) == 0)
3419 return -1;
3421 if ((x & 0xf0) == 0)
3422 lg2 = 4, x <<= 4;
3424 if ((x & 0xc0) == 0)
3425 lg2 += 2, x <<= 2;
3427 if ((x & 0x80) == 0)
3428 lg2 += 1, x <<= 1;
3430 /* result is at most 19 bits, so this cast is safe: */
3431 return (png_int_32)((lg2 << 16) + ((png_8bit_l2[x-128]+32768)>>16));
3434 /* The above gives exact (to 16 binary places) log2 values for 8-bit images,
3435 * for 16-bit images we use the most significant 8 bits of the 16-bit value to
3436 * get an approximation then multiply the approximation by a correction factor
3437 * determined by the remaining up to 8 bits. This requires an additional step
3438 * in the 16-bit case.
3440 * We want log2(value/65535), we have log2(v'/255), where:
3442 * value = v' * 256 + v''
3443 * = v' * f
3445 * So f is value/v', which is equal to (256+v''/v') since v' is in the range 128
3446 * to 255 and v'' is in the range 0 to 255 f will be in the range 256 to less
3447 * than 258. The final factor also needs to correct for the fact that our 8-bit
3448 * value is scaled by 255, whereas the 16-bit values must be scaled by 65535.
3450 * This gives a final formula using a calculated value 'x' which is value/v' and
3451 * scaling by 65536 to match the above table:
3453 * log2(x/257) * 65536
3455 * Since these numbers are so close to '1' we can use simple linear
3456 * interpolation between the two end values 256/257 (result -368.61) and 258/257
3457 * (result 367.179). The values used below are scaled by a further 64 to give
3458 * 16-bit precision in the interpolation:
3460 * Start (256): -23591
3461 * Zero (257): 0
3462 * End (258): 23499
3464 static png_int_32
3465 png_log16bit(png_uint_32 x)
3467 unsigned int lg2 = 0;
3469 /* As above, but now the input has 16 bits. */
3470 if ((x &= 0xffff) == 0)
3471 return -1;
3473 if ((x & 0xff00) == 0)
3474 lg2 = 8, x <<= 8;
3476 if ((x & 0xf000) == 0)
3477 lg2 += 4, x <<= 4;
3479 if ((x & 0xc000) == 0)
3480 lg2 += 2, x <<= 2;
3482 if ((x & 0x8000) == 0)
3483 lg2 += 1, x <<= 1;
3485 /* Calculate the base logarithm from the top 8 bits as a 28-bit fractional
3486 * value.
3488 lg2 <<= 28;
3489 lg2 += (png_8bit_l2[(x>>8)-128]+8) >> 4;
3491 /* Now we need to interpolate the factor, this requires a division by the top
3492 * 8 bits. Do this with maximum precision.
3494 x = ((x << 16) + (x >> 9)) / (x >> 8);
3496 /* Since we divided by the top 8 bits of 'x' there will be a '1' at 1<<24,
3497 * the value at 1<<16 (ignoring this) will be 0 or 1; this gives us exactly
3498 * 16 bits to interpolate to get the low bits of the result. Round the
3499 * answer. Note that the end point values are scaled by 64 to retain overall
3500 * precision and that 'lg2' is current scaled by an extra 12 bits, so adjust
3501 * the overall scaling by 6-12. Round at every step.
3503 x -= 1U << 24;
3505 if (x <= 65536U) /* <= '257' */
3506 lg2 += ((23591U * (65536U-x)) + (1U << (16+6-12-1))) >> (16+6-12);
3508 else
3509 lg2 -= ((23499U * (x-65536U)) + (1U << (16+6-12-1))) >> (16+6-12);
3511 /* Safe, because the result can't have more than 20 bits: */
3512 return (png_int_32)((lg2 + 2048) >> 12);
3515 /* The 'exp()' case must invert the above, taking a 20-bit fixed point
3516 * logarithmic value and returning a 16 or 8-bit number as appropriate. In
3517 * each case only the low 16 bits are relevant - the fraction - since the
3518 * integer bits (the top 4) simply determine a shift.
3520 * The worst case is the 16-bit distinction between 65535 and 65534, this
3521 * requires perhaps spurious accuracty in the decoding of the logarithm to
3522 * distinguish log2(65535/65534.5) - 10^-5 or 17 bits. There is little chance
3523 * of getting this accuracy in practice.
3525 * To deal with this the following exp() function works out the exponent of the
3526 * frational part of the logarithm by using an accurate 32-bit value from the
3527 * top four fractional bits then multiplying in the remaining bits.
3529 static const png_uint_32
3530 png_32bit_exp[16] =
3532 /* NOTE: the first entry is deliberately set to the maximum 32-bit value. */
3533 4294967295U, 4112874773U, 3938502376U, 3771522796U, 3611622603U, 3458501653U,
3534 3311872529U, 3171459999U, 3037000500U, 2908241642U, 2784941738U, 2666869345U,
3535 2553802834U, 2445529972U, 2341847524U, 2242560872U
3538 /* Adjustment table; provided to explain the numbers in the code below. */
3539 #if 0
3540 for (i=11;i>=0;--i){ print i, " ", (1 - e(-(2^i)/65536*l(2))) * 2^(32-i), "\n"}
3541 11 44937.64284865548751208448
3542 10 45180.98734845585101160448
3543 9 45303.31936980687359311872
3544 8 45364.65110595323018870784
3545 7 45395.35850361789624614912
3546 6 45410.72259715102037508096
3547 5 45418.40724413220722311168
3548 4 45422.25021786898173001728
3549 3 45424.17186732298419044352
3550 2 45425.13273269940811464704
3551 1 45425.61317555035558641664
3552 0 45425.85339951654943850496
3553 #endif
3555 static png_uint_32
3556 png_exp(png_fixed_point x)
3558 if (x > 0 && x <= 0xfffff) /* Else overflow or zero (underflow) */
3560 /* Obtain a 4-bit approximation */
3561 png_uint_32 e = png_32bit_exp[(x >> 12) & 0xf];
3563 /* Incorporate the low 12 bits - these decrease the returned value by
3564 * multiplying by a number less than 1 if the bit is set. The multiplier
3565 * is determined by the above table and the shift. Notice that the values
3566 * converge on 45426 and this is used to allow linear interpolation of the
3567 * low bits.
3569 if (x & 0x800)
3570 e -= (((e >> 16) * 44938U) + 16U) >> 5;
3572 if (x & 0x400)
3573 e -= (((e >> 16) * 45181U) + 32U) >> 6;
3575 if (x & 0x200)
3576 e -= (((e >> 16) * 45303U) + 64U) >> 7;
3578 if (x & 0x100)
3579 e -= (((e >> 16) * 45365U) + 128U) >> 8;
3581 if (x & 0x080)
3582 e -= (((e >> 16) * 45395U) + 256U) >> 9;
3584 if (x & 0x040)
3585 e -= (((e >> 16) * 45410U) + 512U) >> 10;
3587 /* And handle the low 6 bits in a single block. */
3588 e -= (((e >> 16) * 355U * (x & 0x3fU)) + 256U) >> 9;
3590 /* Handle the upper bits of x. */
3591 e >>= x >> 16;
3592 return e;
3595 /* Check for overflow */
3596 if (x <= 0)
3597 return png_32bit_exp[0];
3599 /* Else underflow */
3600 return 0;
3603 static png_byte
3604 png_exp8bit(png_fixed_point lg2)
3606 /* Get a 32-bit value: */
3607 png_uint_32 x = png_exp(lg2);
3609 /* Convert the 32-bit value to 0..255 by multiplying by 256-1, note that the
3610 * second, rounding, step can't overflow because of the first, subtraction,
3611 * step.
3613 x -= x >> 8;
3614 return (png_byte)((x + 0x7fffffU) >> 24);
3617 static png_uint_16
3618 png_exp16bit(png_fixed_point lg2)
3620 /* Get a 32-bit value: */
3621 png_uint_32 x = png_exp(lg2);
3623 /* Convert the 32-bit value to 0..65535 by multiplying by 65536-1: */
3624 x -= x >> 16;
3625 return (png_uint_16)((x + 32767U) >> 16);
3627 #endif /* FLOATING_ARITHMETIC */
3629 png_byte
3630 png_gamma_8bit_correct(unsigned int value, png_fixed_point gamma_val)
3632 if (value > 0 && value < 255)
3634 # ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
3635 double r = floor(255*pow(value/255.,gamma_val*.00001)+.5);
3636 return (png_byte)r;
3637 # else
3638 png_int_32 lg2 = png_log8bit(value);
3639 png_fixed_point res;
3641 if (png_muldiv(&res, gamma_val, lg2, PNG_FP_1))
3642 return png_exp8bit(res);
3644 /* Overflow. */
3645 value = 0;
3646 # endif
3649 return (png_byte)value;
3652 png_uint_16
3653 png_gamma_16bit_correct(unsigned int value, png_fixed_point gamma_val)
3655 if (value > 0 && value < 65535)
3657 # ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
3658 double r = floor(65535*pow(value/65535.,gamma_val*.00001)+.5);
3659 return (png_uint_16)r;
3660 # else
3661 png_int_32 lg2 = png_log16bit(value);
3662 png_fixed_point res;
3664 if (png_muldiv(&res, gamma_val, lg2, PNG_FP_1))
3665 return png_exp16bit(res);
3667 /* Overflow. */
3668 value = 0;
3669 # endif
3672 return (png_uint_16)value;
3675 /* This does the right thing based on the bit_depth field of the
3676 * png_struct, interpreting values as 8-bit or 16-bit. While the result
3677 * is nominally a 16-bit value if bit depth is 8 then the result is
3678 * 8-bit (as are the arguments.)
3680 png_uint_16 /* PRIVATE */
3681 png_gamma_correct(png_structrp png_ptr, unsigned int value,
3682 png_fixed_point gamma_val)
3684 if (png_ptr->bit_depth == 8)
3685 return png_gamma_8bit_correct(value, gamma_val);
3687 else
3688 return png_gamma_16bit_correct(value, gamma_val);
3691 /* Internal function to build a single 16-bit table - the table consists of
3692 * 'num' 256 entry subtables, where 'num' is determined by 'shift' - the amount
3693 * to shift the input values right (or 16-number_of_signifiant_bits).
3695 * The caller is responsible for ensuring that the table gets cleaned up on
3696 * png_error (i.e. if one of the mallocs below fails) - i.e. the *table argument
3697 * should be somewhere that will be cleaned.
3699 static void
3700 png_build_16bit_table(png_structrp png_ptr, png_uint_16pp *ptable,
3701 PNG_CONST unsigned int shift, PNG_CONST png_fixed_point gamma_val)
3703 /* Various values derived from 'shift': */
3704 PNG_CONST unsigned int num = 1U << (8U - shift);
3705 PNG_CONST unsigned int max = (1U << (16U - shift))-1U;
3706 PNG_CONST unsigned int max_by_2 = 1U << (15U-shift);
3707 unsigned int i;
3709 png_uint_16pp table = *ptable =
3710 (png_uint_16pp)png_calloc(png_ptr, num * (sizeof (png_uint_16p)));
3712 for (i = 0; i < num; i++)
3714 png_uint_16p sub_table = table[i] =
3715 (png_uint_16p)png_malloc(png_ptr, 256 * (sizeof (png_uint_16)));
3717 /* The 'threshold' test is repeated here because it can arise for one of
3718 * the 16-bit tables even if the others don't hit it.
3720 if (png_gamma_significant(gamma_val))
3722 /* The old code would overflow at the end and this would cause the
3723 * 'pow' function to return a result >1, resulting in an
3724 * arithmetic error. This code follows the spec exactly; ig is
3725 * the recovered input sample, it always has 8-16 bits.
3727 * We want input * 65535/max, rounded, the arithmetic fits in 32
3728 * bits (unsigned) so long as max <= 32767.
3730 unsigned int j;
3731 for (j = 0; j < 256; j++)
3733 png_uint_32 ig = (j << (8-shift)) + i;
3734 # ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
3735 /* Inline the 'max' scaling operation: */
3736 double d = floor(65535*pow(ig/(double)max, gamma_val*.00001)+.5);
3737 sub_table[j] = (png_uint_16)d;
3738 # else
3739 if (shift)
3740 ig = (ig * 65535U + max_by_2)/max;
3742 sub_table[j] = png_gamma_16bit_correct(ig, gamma_val);
3743 # endif
3746 else
3748 /* We must still build a table, but do it the fast way. */
3749 unsigned int j;
3751 for (j = 0; j < 256; j++)
3753 png_uint_32 ig = (j << (8-shift)) + i;
3755 if (shift)
3756 ig = (ig * 65535U + max_by_2)/max;
3758 sub_table[j] = (png_uint_16)ig;
3764 /* NOTE: this function expects the *inverse* of the overall gamma transformation
3765 * required.
3767 static void
3768 png_build_16to8_table(png_structrp png_ptr, png_uint_16pp *ptable,
3769 PNG_CONST unsigned int shift, PNG_CONST png_fixed_point gamma_val)
3771 PNG_CONST unsigned int num = 1U << (8U - shift);
3772 PNG_CONST unsigned int max = (1U << (16U - shift))-1U;
3773 unsigned int i;
3774 png_uint_32 last;
3776 png_uint_16pp table = *ptable =
3777 (png_uint_16pp)png_calloc(png_ptr, num * (sizeof (png_uint_16p)));
3779 /* 'num' is the number of tables and also the number of low bits of low
3780 * bits of the input 16-bit value used to select a table. Each table is
3781 * itself index by the high 8 bits of the value.
3783 for (i = 0; i < num; i++)
3784 table[i] = (png_uint_16p)png_malloc(png_ptr,
3785 256 * (sizeof (png_uint_16)));
3787 /* 'gamma_val' is set to the reciprocal of the value calculated above, so
3788 * pow(out,g) is an *input* value. 'last' is the last input value set.
3790 * In the loop 'i' is used to find output values. Since the output is
3791 * 8-bit there are only 256 possible values. The tables are set up to
3792 * select the closest possible output value for each input by finding
3793 * the input value at the boundary between each pair of output values
3794 * and filling the table up to that boundary with the lower output
3795 * value.
3797 * The boundary values are 0.5,1.5..253.5,254.5. Since these are 9-bit
3798 * values the code below uses a 16-bit value in i; the values start at
3799 * 128.5 (for 0.5) and step by 257, for a total of 254 values (the last
3800 * entries are filled with 255). Start i at 128 and fill all 'last'
3801 * table entries <= 'max'
3803 last = 0;
3804 for (i = 0; i < 255; ++i) /* 8-bit output value */
3806 /* Find the corresponding maximum input value */
3807 png_uint_16 out = (png_uint_16)(i * 257U); /* 16-bit output value */
3809 /* Find the boundary value in 16 bits: */
3810 png_uint_32 bound = png_gamma_16bit_correct(out+128U, gamma_val);
3812 /* Adjust (round) to (16-shift) bits: */
3813 bound = (bound * max + 32768U)/65535U + 1U;
3815 while (last < bound)
3817 table[last & (0xffU >> shift)][last >> (8U - shift)] = out;
3818 last++;
3822 /* And fill in the final entries. */
3823 while (last < (num << 8))
3825 table[last & (0xff >> shift)][last >> (8U - shift)] = 65535U;
3826 last++;
3830 /* Build a single 8-bit table: same as the 16-bit case but much simpler (and
3831 * typically much faster). Note that libpng currently does no sBIT processing
3832 * (apparently contrary to the spec) so a 256 entry table is always generated.
3834 static void
3835 png_build_8bit_table(png_structrp png_ptr, png_bytepp ptable,
3836 PNG_CONST png_fixed_point gamma_val)
3838 unsigned int i;
3839 png_bytep table = *ptable = (png_bytep)png_malloc(png_ptr, 256);
3841 if (png_gamma_significant(gamma_val)) for (i=0; i<256; i++)
3842 table[i] = png_gamma_8bit_correct(i, gamma_val);
3844 else for (i=0; i<256; ++i)
3845 table[i] = (png_byte)i;
3848 /* Used from png_read_destroy and below to release the memory used by the gamma
3849 * tables.
3851 void /* PRIVATE */
3852 png_destroy_gamma_table(png_structrp png_ptr)
3854 png_free(png_ptr, png_ptr->gamma_table);
3855 png_ptr->gamma_table = NULL;
3857 if (png_ptr->gamma_16_table != NULL)
3859 int i;
3860 int istop = (1 << (8 - png_ptr->gamma_shift));
3861 for (i = 0; i < istop; i++)
3863 png_free(png_ptr, png_ptr->gamma_16_table[i]);
3865 png_free(png_ptr, png_ptr->gamma_16_table);
3866 png_ptr->gamma_16_table = NULL;
3869 #if defined(PNG_READ_BACKGROUND_SUPPORTED) || \
3870 defined(PNG_READ_ALPHA_MODE_SUPPORTED) || \
3871 defined(PNG_READ_RGB_TO_GRAY_SUPPORTED)
3872 png_free(png_ptr, png_ptr->gamma_from_1);
3873 png_ptr->gamma_from_1 = NULL;
3874 png_free(png_ptr, png_ptr->gamma_to_1);
3875 png_ptr->gamma_to_1 = NULL;
3877 if (png_ptr->gamma_16_from_1 != NULL)
3879 int i;
3880 int istop = (1 << (8 - png_ptr->gamma_shift));
3881 for (i = 0; i < istop; i++)
3883 png_free(png_ptr, png_ptr->gamma_16_from_1[i]);
3885 png_free(png_ptr, png_ptr->gamma_16_from_1);
3886 png_ptr->gamma_16_from_1 = NULL;
3888 if (png_ptr->gamma_16_to_1 != NULL)
3890 int i;
3891 int istop = (1 << (8 - png_ptr->gamma_shift));
3892 for (i = 0; i < istop; i++)
3894 png_free(png_ptr, png_ptr->gamma_16_to_1[i]);
3896 png_free(png_ptr, png_ptr->gamma_16_to_1);
3897 png_ptr->gamma_16_to_1 = NULL;
3899 #endif /* READ_BACKGROUND || READ_ALPHA_MODE || RGB_TO_GRAY */
3902 /* We build the 8- or 16-bit gamma tables here. Note that for 16-bit
3903 * tables, we don't make a full table if we are reducing to 8-bit in
3904 * the future. Note also how the gamma_16 tables are segmented so that
3905 * we don't need to allocate > 64K chunks for a full 16-bit table.
3907 void /* PRIVATE */
3908 png_build_gamma_table(png_structrp png_ptr, int bit_depth)
3910 png_debug(1, "in png_build_gamma_table");
3912 /* Remove any existing table; this copes with multiple calls to
3913 * png_read_update_info. The warning is because building the gamma tables
3914 * multiple times is a performance hit - it's harmless but the ability to call
3915 * png_read_update_info() multiple times is new in 1.5.6 so it seems sensible
3916 * to warn if the app introduces such a hit.
3918 if (png_ptr->gamma_table != NULL || png_ptr->gamma_16_table != NULL)
3920 png_warning(png_ptr, "gamma table being rebuilt");
3921 png_destroy_gamma_table(png_ptr);
3924 if (bit_depth <= 8)
3926 png_build_8bit_table(png_ptr, &png_ptr->gamma_table,
3927 png_ptr->screen_gamma > 0 ? png_reciprocal2(png_ptr->colorspace.gamma,
3928 png_ptr->screen_gamma) : PNG_FP_1);
3930 #if defined(PNG_READ_BACKGROUND_SUPPORTED) || \
3931 defined(PNG_READ_ALPHA_MODE_SUPPORTED) || \
3932 defined(PNG_READ_RGB_TO_GRAY_SUPPORTED)
3933 if (png_ptr->transformations & (PNG_COMPOSE | PNG_RGB_TO_GRAY))
3935 png_build_8bit_table(png_ptr, &png_ptr->gamma_to_1,
3936 png_reciprocal(png_ptr->colorspace.gamma));
3938 png_build_8bit_table(png_ptr, &png_ptr->gamma_from_1,
3939 png_ptr->screen_gamma > 0 ? png_reciprocal(png_ptr->screen_gamma) :
3940 png_ptr->colorspace.gamma/* Probably doing rgb_to_gray */);
3942 #endif /* READ_BACKGROUND || READ_ALPHA_MODE || RGB_TO_GRAY */
3944 else
3946 png_byte shift, sig_bit;
3948 if (png_ptr->color_type & PNG_COLOR_MASK_COLOR)
3950 sig_bit = png_ptr->sig_bit.red;
3952 if (png_ptr->sig_bit.green > sig_bit)
3953 sig_bit = png_ptr->sig_bit.green;
3955 if (png_ptr->sig_bit.blue > sig_bit)
3956 sig_bit = png_ptr->sig_bit.blue;
3958 else
3959 sig_bit = png_ptr->sig_bit.gray;
3961 /* 16-bit gamma code uses this equation:
3963 * ov = table[(iv & 0xff) >> gamma_shift][iv >> 8]
3965 * Where 'iv' is the input color value and 'ov' is the output value -
3966 * pow(iv, gamma).
3968 * Thus the gamma table consists of up to 256 256 entry tables. The table
3969 * is selected by the (8-gamma_shift) most significant of the low 8 bits of
3970 * the color value then indexed by the upper 8 bits:
3972 * table[low bits][high 8 bits]
3974 * So the table 'n' corresponds to all those 'iv' of:
3976 * <all high 8-bit values><n << gamma_shift>..<(n+1 << gamma_shift)-1>
3979 if (sig_bit > 0 && sig_bit < 16U)
3980 shift = (png_byte)(16U - sig_bit); /* shift == insignificant bits */
3982 else
3983 shift = 0; /* keep all 16 bits */
3985 if (png_ptr->transformations & (PNG_16_TO_8 | PNG_SCALE_16_TO_8))
3987 /* PNG_MAX_GAMMA_8 is the number of bits to keep - effectively
3988 * the significant bits in the *input* when the output will
3989 * eventually be 8 bits. By default it is 11.
3991 if (shift < (16U - PNG_MAX_GAMMA_8))
3992 shift = (16U - PNG_MAX_GAMMA_8);
3995 if (shift > 8U)
3996 shift = 8U; /* Guarantees at least one table! */
3998 png_ptr->gamma_shift = shift;
4000 #ifdef PNG_16BIT_SUPPORTED
4001 /* NOTE: prior to 1.5.4 this test used to include PNG_BACKGROUND (now
4002 * PNG_COMPOSE). This effectively smashed the background calculation for
4003 * 16-bit output because the 8-bit table assumes the result will be reduced
4004 * to 8 bits.
4006 if (png_ptr->transformations & (PNG_16_TO_8 | PNG_SCALE_16_TO_8))
4007 #endif
4008 png_build_16to8_table(png_ptr, &png_ptr->gamma_16_table, shift,
4009 png_ptr->screen_gamma > 0 ? png_product2(png_ptr->colorspace.gamma,
4010 png_ptr->screen_gamma) : PNG_FP_1);
4012 #ifdef PNG_16BIT_SUPPORTED
4013 else
4014 png_build_16bit_table(png_ptr, &png_ptr->gamma_16_table, shift,
4015 png_ptr->screen_gamma > 0 ? png_reciprocal2(png_ptr->colorspace.gamma,
4016 png_ptr->screen_gamma) : PNG_FP_1);
4017 #endif
4019 #if defined(PNG_READ_BACKGROUND_SUPPORTED) || \
4020 defined(PNG_READ_ALPHA_MODE_SUPPORTED) || \
4021 defined(PNG_READ_RGB_TO_GRAY_SUPPORTED)
4022 if (png_ptr->transformations & (PNG_COMPOSE | PNG_RGB_TO_GRAY))
4024 png_build_16bit_table(png_ptr, &png_ptr->gamma_16_to_1, shift,
4025 png_reciprocal(png_ptr->colorspace.gamma));
4027 /* Notice that the '16 from 1' table should be full precision, however
4028 * the lookup on this table still uses gamma_shift, so it can't be.
4029 * TODO: fix this.
4031 png_build_16bit_table(png_ptr, &png_ptr->gamma_16_from_1, shift,
4032 png_ptr->screen_gamma > 0 ? png_reciprocal(png_ptr->screen_gamma) :
4033 png_ptr->colorspace.gamma/* Probably doing rgb_to_gray */);
4035 #endif /* READ_BACKGROUND || READ_ALPHA_MODE || RGB_TO_GRAY */
4038 #endif /* READ_GAMMA */
4040 /* HARDWARE OPTION SUPPORT */
4041 #ifdef PNG_SET_OPTION_SUPPORTED
4042 int PNGAPI
4043 png_set_option(png_structrp png_ptr, int option, int onoff)
4045 if (png_ptr != NULL && option >= 0 && option < PNG_OPTION_NEXT &&
4046 (option & 1) == 0)
4048 int mask = 3 << option;
4049 int setting = (2 + (onoff != 0)) << option;
4050 int current = png_ptr->options;
4052 png_ptr->options = (png_byte)((current & ~mask) | setting);
4054 return (current & mask) >> option;
4057 return PNG_OPTION_INVALID;
4059 #endif
4061 /* sRGB support */
4062 #if defined(PNG_SIMPLIFIED_READ_SUPPORTED) ||\
4063 defined(PNG_SIMPLIFIED_WRITE_SUPPORTED)
4064 /* sRGB conversion tables; these are machine generated with the code in
4065 * contrib/tools/makesRGB.c. The actual sRGB transfer curve defined in the
4066 * specification (see the article at http://en.wikipedia.org/wiki/SRGB)
4067 * is used, not the gamma=1/2.2 approximation use elsewhere in libpng.
4068 * The sRGB to linear table is exact (to the nearest 16 bit linear fraction).
4069 * The inverse (linear to sRGB) table has accuracies as follows:
4071 * For all possible (255*65535+1) input values:
4073 * error: -0.515566 - 0.625971, 79441 (0.475369%) of readings inexact
4075 * For the input values corresponding to the 65536 16-bit values:
4077 * error: -0.513727 - 0.607759, 308 (0.469978%) of readings inexact
4079 * In all cases the inexact readings are off by one.
4082 #ifdef PNG_SIMPLIFIED_READ_SUPPORTED
4083 /* The convert-to-sRGB table is only currently required for read. */
4084 const png_uint_16 png_sRGB_table[256] =
4086 0,20,40,60,80,99,119,139,
4087 159,179,199,219,241,264,288,313,
4088 340,367,396,427,458,491,526,562,
4089 599,637,677,718,761,805,851,898,
4090 947,997,1048,1101,1156,1212,1270,1330,
4091 1391,1453,1517,1583,1651,1720,1790,1863,
4092 1937,2013,2090,2170,2250,2333,2418,2504,
4093 2592,2681,2773,2866,2961,3058,3157,3258,
4094 3360,3464,3570,3678,3788,3900,4014,4129,
4095 4247,4366,4488,4611,4736,4864,4993,5124,
4096 5257,5392,5530,5669,5810,5953,6099,6246,
4097 6395,6547,6700,6856,7014,7174,7335,7500,
4098 7666,7834,8004,8177,8352,8528,8708,8889,
4099 9072,9258,9445,9635,9828,10022,10219,10417,
4100 10619,10822,11028,11235,11446,11658,11873,12090,
4101 12309,12530,12754,12980,13209,13440,13673,13909,
4102 14146,14387,14629,14874,15122,15371,15623,15878,
4103 16135,16394,16656,16920,17187,17456,17727,18001,
4104 18277,18556,18837,19121,19407,19696,19987,20281,
4105 20577,20876,21177,21481,21787,22096,22407,22721,
4106 23038,23357,23678,24002,24329,24658,24990,25325,
4107 25662,26001,26344,26688,27036,27386,27739,28094,
4108 28452,28813,29176,29542,29911,30282,30656,31033,
4109 31412,31794,32179,32567,32957,33350,33745,34143,
4110 34544,34948,35355,35764,36176,36591,37008,37429,
4111 37852,38278,38706,39138,39572,40009,40449,40891,
4112 41337,41785,42236,42690,43147,43606,44069,44534,
4113 45002,45473,45947,46423,46903,47385,47871,48359,
4114 48850,49344,49841,50341,50844,51349,51858,52369,
4115 52884,53401,53921,54445,54971,55500,56032,56567,
4116 57105,57646,58190,58737,59287,59840,60396,60955,
4117 61517,62082,62650,63221,63795,64372,64952,65535
4120 #endif /* simplified read only */
4122 /* The base/delta tables are required for both read and write (but currently
4123 * only the simplified versions.)
4125 const png_uint_16 png_sRGB_base[512] =
4127 128,1782,3383,4644,5675,6564,7357,8074,
4128 8732,9346,9921,10463,10977,11466,11935,12384,
4129 12816,13233,13634,14024,14402,14769,15125,15473,
4130 15812,16142,16466,16781,17090,17393,17690,17981,
4131 18266,18546,18822,19093,19359,19621,19879,20133,
4132 20383,20630,20873,21113,21349,21583,21813,22041,
4133 22265,22487,22707,22923,23138,23350,23559,23767,
4134 23972,24175,24376,24575,24772,24967,25160,25352,
4135 25542,25730,25916,26101,26284,26465,26645,26823,
4136 27000,27176,27350,27523,27695,27865,28034,28201,
4137 28368,28533,28697,28860,29021,29182,29341,29500,
4138 29657,29813,29969,30123,30276,30429,30580,30730,
4139 30880,31028,31176,31323,31469,31614,31758,31902,
4140 32045,32186,32327,32468,32607,32746,32884,33021,
4141 33158,33294,33429,33564,33697,33831,33963,34095,
4142 34226,34357,34486,34616,34744,34873,35000,35127,
4143 35253,35379,35504,35629,35753,35876,35999,36122,
4144 36244,36365,36486,36606,36726,36845,36964,37083,
4145 37201,37318,37435,37551,37668,37783,37898,38013,
4146 38127,38241,38354,38467,38580,38692,38803,38915,
4147 39026,39136,39246,39356,39465,39574,39682,39790,
4148 39898,40005,40112,40219,40325,40431,40537,40642,
4149 40747,40851,40955,41059,41163,41266,41369,41471,
4150 41573,41675,41777,41878,41979,42079,42179,42279,
4151 42379,42478,42577,42676,42775,42873,42971,43068,
4152 43165,43262,43359,43456,43552,43648,43743,43839,
4153 43934,44028,44123,44217,44311,44405,44499,44592,
4154 44685,44778,44870,44962,45054,45146,45238,45329,
4155 45420,45511,45601,45692,45782,45872,45961,46051,
4156 46140,46229,46318,46406,46494,46583,46670,46758,
4157 46846,46933,47020,47107,47193,47280,47366,47452,
4158 47538,47623,47709,47794,47879,47964,48048,48133,
4159 48217,48301,48385,48468,48552,48635,48718,48801,
4160 48884,48966,49048,49131,49213,49294,49376,49458,
4161 49539,49620,49701,49782,49862,49943,50023,50103,
4162 50183,50263,50342,50422,50501,50580,50659,50738,
4163 50816,50895,50973,51051,51129,51207,51285,51362,
4164 51439,51517,51594,51671,51747,51824,51900,51977,
4165 52053,52129,52205,52280,52356,52432,52507,52582,
4166 52657,52732,52807,52881,52956,53030,53104,53178,
4167 53252,53326,53400,53473,53546,53620,53693,53766,
4168 53839,53911,53984,54056,54129,54201,54273,54345,
4169 54417,54489,54560,54632,54703,54774,54845,54916,
4170 54987,55058,55129,55199,55269,55340,55410,55480,
4171 55550,55620,55689,55759,55828,55898,55967,56036,
4172 56105,56174,56243,56311,56380,56448,56517,56585,
4173 56653,56721,56789,56857,56924,56992,57059,57127,
4174 57194,57261,57328,57395,57462,57529,57595,57662,
4175 57728,57795,57861,57927,57993,58059,58125,58191,
4176 58256,58322,58387,58453,58518,58583,58648,58713,
4177 58778,58843,58908,58972,59037,59101,59165,59230,
4178 59294,59358,59422,59486,59549,59613,59677,59740,
4179 59804,59867,59930,59993,60056,60119,60182,60245,
4180 60308,60370,60433,60495,60558,60620,60682,60744,
4181 60806,60868,60930,60992,61054,61115,61177,61238,
4182 61300,61361,61422,61483,61544,61605,61666,61727,
4183 61788,61848,61909,61969,62030,62090,62150,62211,
4184 62271,62331,62391,62450,62510,62570,62630,62689,
4185 62749,62808,62867,62927,62986,63045,63104,63163,
4186 63222,63281,63340,63398,63457,63515,63574,63632,
4187 63691,63749,63807,63865,63923,63981,64039,64097,
4188 64155,64212,64270,64328,64385,64443,64500,64557,
4189 64614,64672,64729,64786,64843,64900,64956,65013,
4190 65070,65126,65183,65239,65296,65352,65409,65465
4193 const png_byte png_sRGB_delta[512] =
4195 207,201,158,129,113,100,90,82,77,72,68,64,61,59,56,54,
4196 52,50,49,47,46,45,43,42,41,40,39,39,38,37,36,36,
4197 35,34,34,33,33,32,32,31,31,30,30,30,29,29,28,28,
4198 28,27,27,27,27,26,26,26,25,25,25,25,24,24,24,24,
4199 23,23,23,23,23,22,22,22,22,22,22,21,21,21,21,21,
4200 21,20,20,20,20,20,20,20,20,19,19,19,19,19,19,19,
4201 19,18,18,18,18,18,18,18,18,18,18,17,17,17,17,17,
4202 17,17,17,17,17,17,16,16,16,16,16,16,16,16,16,16,
4203 16,16,16,16,15,15,15,15,15,15,15,15,15,15,15,15,
4204 15,15,15,15,14,14,14,14,14,14,14,14,14,14,14,14,
4205 14,14,14,14,14,14,14,13,13,13,13,13,13,13,13,13,
4206 13,13,13,13,13,13,13,13,13,13,13,13,13,13,12,12,
4207 12,12,12,12,12,12,12,12,12,12,12,12,12,12,12,12,
4208 12,12,12,12,12,12,12,12,12,12,12,12,11,11,11,11,
4209 11,11,11,11,11,11,11,11,11,11,11,11,11,11,11,11,
4210 11,11,11,11,11,11,11,11,11,11,11,11,11,11,11,11,
4211 11,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,
4212 10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,
4213 10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,
4214 10,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,
4215 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,
4216 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,
4217 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,
4218 9,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,
4219 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,
4220 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,
4221 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,
4222 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,
4223 8,8,8,8,8,8,8,8,8,7,7,7,7,7,7,7,
4224 7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,
4225 7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,
4226 7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7
4228 #endif /* SIMPLIFIED READ/WRITE sRGB support */
4230 /* SIMPLIFIED READ/WRITE SUPPORT */
4231 #if defined(PNG_SIMPLIFIED_READ_SUPPORTED) ||\
4232 defined(PNG_SIMPLIFIED_WRITE_SUPPORTED)
4233 static int
4234 png_image_free_function(png_voidp argument)
4236 png_imagep image = png_voidcast(png_imagep, argument);
4237 png_controlp cp = image->opaque;
4238 png_control c;
4240 /* Double check that we have a png_ptr - it should be impossible to get here
4241 * without one.
4243 if (cp->png_ptr == NULL)
4244 return 0;
4246 /* First free any data held in the control structure. */
4247 # ifdef PNG_STDIO_SUPPORTED
4248 if (cp->owned_file)
4250 FILE *fp = png_voidcast(FILE*, cp->png_ptr->io_ptr);
4251 cp->owned_file = 0;
4253 /* Ignore errors here. */
4254 if (fp != NULL)
4256 cp->png_ptr->io_ptr = NULL;
4257 (void)fclose(fp);
4260 # endif
4262 /* Copy the control structure so that the original, allocated, version can be
4263 * safely freed. Notice that a png_error here stops the remainder of the
4264 * cleanup, but this is probably fine because that would indicate bad memory
4265 * problems anyway.
4267 c = *cp;
4268 image->opaque = &c;
4269 png_free(c.png_ptr, cp);
4271 /* Then the structures, calling the correct API. */
4272 if (c.for_write)
4274 # ifdef PNG_SIMPLIFIED_WRITE_SUPPORTED
4275 png_destroy_write_struct(&c.png_ptr, &c.info_ptr);
4276 # else
4277 png_error(c.png_ptr, "simplified write not supported");
4278 # endif
4280 else
4282 # ifdef PNG_SIMPLIFIED_READ_SUPPORTED
4283 png_destroy_read_struct(&c.png_ptr, &c.info_ptr, NULL);
4284 # else
4285 png_error(c.png_ptr, "simplified read not supported");
4286 # endif
4289 /* Success. */
4290 return 1;
4293 void PNGAPI
4294 png_image_free(png_imagep image)
4296 /* Safely call the real function, but only if doing so is safe at this point
4297 * (if not inside an error handling context). Otherwise assume
4298 * png_safe_execute will call this API after the return.
4300 if (image != NULL && image->opaque != NULL &&
4301 image->opaque->error_buf == NULL)
4303 /* Ignore errors here: */
4304 (void)png_safe_execute(image, png_image_free_function, image);
4305 image->opaque = NULL;
4309 int /* PRIVATE */
4310 png_image_error(png_imagep image, png_const_charp error_message)
4312 /* Utility to log an error. */
4313 png_safecat(image->message, (sizeof image->message), 0, error_message);
4314 image->warning_or_error |= PNG_IMAGE_ERROR;
4315 png_image_free(image);
4316 return 0;
4319 #endif /* SIMPLIFIED READ/WRITE */
4320 #endif /* defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED) */