minor tidy up
[AROS.git] / workbench / libs / png / png.c
blobf2952129cadfa98153423b5e077b4261a3f8bfb8
2 /* png.c - location for general purpose libpng functions
4 * Last changed in libpng 1.6.28 [January 5, 2017]
5 * Copyright (c) 1998-2002,2004,2006-2017 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_28 Your_png_h_is_not_version_1_6_28;
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 unsigned int nb = (unsigned int)num_bytes;
31 png_debug(1, "in png_set_sig_bytes");
33 if (png_ptr == NULL)
34 return;
36 if (num_bytes < 0)
37 nb = 0;
39 if (nb > 8)
40 png_error(png_ptr, "Too many bytes for PNG signature");
42 png_ptr->sig_bytes = (png_byte)nb;
45 /* Checks whether the supplied bytes match the PNG signature. We allow
46 * checking less than the full 8-byte signature so that those apps that
47 * already read the first few bytes of a file to determine the file type
48 * can simply check the remaining bytes for extra assurance. Returns
49 * an integer less than, equal to, or greater than zero if sig is found,
50 * respectively, to be less than, to match, or be greater than the correct
51 * PNG signature (this is the same behavior as strcmp, memcmp, etc).
53 int PNGAPI
54 png_sig_cmp(png_const_bytep sig, png_size_t start, png_size_t num_to_check)
56 png_byte png_signature[8] = {137, 80, 78, 71, 13, 10, 26, 10};
58 if (num_to_check > 8)
59 num_to_check = 8;
61 else if (num_to_check < 1)
62 return (-1);
64 if (start > 7)
65 return (-1);
67 if (start + num_to_check > 8)
68 num_to_check = 8 - start;
70 return ((int)(memcmp(&sig[start], &png_signature[start], num_to_check)));
73 #endif /* READ */
75 #ifdef __AROS__
76 #ifdef PNG_READ_SUPPORTED
77 /* (Obsolete) function to check signature bytes. It does not allow one
78 * to check a partial signature. This function might be removed in the
79 * future - use png_sig_cmp(). Returns true (nonzero) if the file is PNG.
81 int PNGAPI
82 png_check_sig_(png_bytep sig, int num)
84 return ((int)!png_sig_cmp(sig, (png_size_t)0, (png_size_t)num));
86 #endif /* PNG_READ_SUPPORTED */
87 #endif /* __AROS__ */
89 #if defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED)
90 /* Function to allocate memory for zlib */
91 PNG_FUNCTION(voidpf /* PRIVATE */,
92 png_zalloc,(voidpf png_ptr, uInt items, uInt size),PNG_ALLOCATED)
94 png_alloc_size_t num_bytes = size;
96 if (png_ptr == NULL)
97 return NULL;
99 if (items >= (~(png_alloc_size_t)0)/size)
101 png_warning (png_voidcast(png_structrp, png_ptr),
102 "Potential overflow in png_zalloc()");
103 return NULL;
106 num_bytes *= items;
107 return png_malloc_warn(png_voidcast(png_structrp, png_ptr), num_bytes);
110 /* Function to free memory for zlib */
111 void /* PRIVATE */
112 png_zfree(voidpf png_ptr, voidpf ptr)
114 png_free(png_voidcast(png_const_structrp,png_ptr), ptr);
117 /* Reset the CRC variable to 32 bits of 1's. Care must be taken
118 * in case CRC is > 32 bits to leave the top bits 0.
120 void /* PRIVATE */
121 png_reset_crc(png_structrp png_ptr)
123 /* The cast is safe because the crc is a 32-bit value. */
124 png_ptr->crc = (png_uint_32)crc32(0, Z_NULL, 0);
127 /* Calculate the CRC over a section of data. We can only pass as
128 * much data to this routine as the largest single buffer size. We
129 * also check that this data will actually be used before going to the
130 * trouble of calculating it.
132 void /* PRIVATE */
133 png_calculate_crc(png_structrp png_ptr, png_const_bytep ptr, png_size_t length)
135 int need_crc = 1;
137 if (PNG_CHUNK_ANCILLARY(png_ptr->chunk_name) != 0)
139 if ((png_ptr->flags & PNG_FLAG_CRC_ANCILLARY_MASK) ==
140 (PNG_FLAG_CRC_ANCILLARY_USE | PNG_FLAG_CRC_ANCILLARY_NOWARN))
141 need_crc = 0;
144 else /* critical */
146 if ((png_ptr->flags & PNG_FLAG_CRC_CRITICAL_IGNORE) != 0)
147 need_crc = 0;
150 /* 'uLong' is defined in zlib.h as unsigned long; this means that on some
151 * systems it is a 64-bit value. crc32, however, returns 32 bits so the
152 * following cast is safe. 'uInt' may be no more than 16 bits, so it is
153 * necessary to perform a loop here.
155 if (need_crc != 0 && length > 0)
157 uLong crc = png_ptr->crc; /* Should never issue a warning */
161 uInt safe_length = (uInt)length;
162 #ifndef __COVERITY__
163 if (safe_length == 0)
164 safe_length = (uInt)-1; /* evil, but safe */
165 #endif
167 crc = crc32(crc, ptr, safe_length);
169 /* The following should never issue compiler warnings; if they do the
170 * target system has characteristics that will probably violate other
171 * assumptions within the libpng code.
173 ptr += safe_length;
174 length -= safe_length;
176 while (length > 0);
178 /* And the following is always safe because the crc is only 32 bits. */
179 png_ptr->crc = (png_uint_32)crc;
183 /* Check a user supplied version number, called from both read and write
184 * functions that create a png_struct.
187 png_user_version_check(png_structrp png_ptr, png_const_charp user_png_ver)
189 /* Libpng versions 1.0.0 and later are binary compatible if the version
190 * string matches through the second '.'; we must recompile any
191 * applications that use any older library version.
194 if (user_png_ver != NULL)
196 int i = -1;
197 int found_dots = 0;
201 i++;
202 if (user_png_ver[i] != PNG_LIBPNG_VER_STRING[i])
203 png_ptr->flags |= PNG_FLAG_LIBRARY_MISMATCH;
204 if (user_png_ver[i] == '.')
205 found_dots++;
206 } while (found_dots < 2 && user_png_ver[i] != 0 &&
207 PNG_LIBPNG_VER_STRING[i] != 0);
210 else
211 png_ptr->flags |= PNG_FLAG_LIBRARY_MISMATCH;
213 if ((png_ptr->flags & PNG_FLAG_LIBRARY_MISMATCH) != 0)
215 #ifdef PNG_WARNINGS_SUPPORTED
216 size_t pos = 0;
217 char m[128];
219 pos = png_safecat(m, (sizeof m), pos,
220 "Application built with libpng-");
221 pos = png_safecat(m, (sizeof m), pos, user_png_ver);
222 pos = png_safecat(m, (sizeof m), pos, " but running with ");
223 pos = png_safecat(m, (sizeof m), pos, PNG_LIBPNG_VER_STRING);
224 PNG_UNUSED(pos)
226 png_warning(png_ptr, m);
227 #endif
229 #ifdef PNG_ERROR_NUMBERS_SUPPORTED
230 png_ptr->flags = 0;
231 #endif
233 return 0;
236 /* Success return. */
237 return 1;
240 /* Generic function to create a png_struct for either read or write - this
241 * contains the common initialization.
243 PNG_FUNCTION(png_structp /* PRIVATE */,
244 png_create_png_struct,(png_const_charp user_png_ver, png_voidp error_ptr,
245 png_error_ptr error_fn, png_error_ptr warn_fn, png_voidp mem_ptr,
246 png_malloc_ptr malloc_fn, png_free_ptr free_fn),PNG_ALLOCATED)
248 png_struct create_struct;
249 # ifdef PNG_SETJMP_SUPPORTED
250 jmp_buf create_jmp_buf;
251 # endif
253 /* This temporary stack-allocated structure is used to provide a place to
254 * build enough context to allow the user provided memory allocator (if any)
255 * to be called.
257 memset(&create_struct, 0, (sizeof create_struct));
259 /* Added at libpng-1.2.6 */
260 # ifdef PNG_USER_LIMITS_SUPPORTED
261 create_struct.user_width_max = PNG_USER_WIDTH_MAX;
262 create_struct.user_height_max = PNG_USER_HEIGHT_MAX;
264 # ifdef PNG_USER_CHUNK_CACHE_MAX
265 /* Added at libpng-1.2.43 and 1.4.0 */
266 create_struct.user_chunk_cache_max = PNG_USER_CHUNK_CACHE_MAX;
267 # endif
269 # ifdef PNG_USER_CHUNK_MALLOC_MAX
270 /* Added at libpng-1.2.43 and 1.4.1, required only for read but exists
271 * in png_struct regardless.
273 create_struct.user_chunk_malloc_max = PNG_USER_CHUNK_MALLOC_MAX;
274 # endif
275 # endif
277 /* The following two API calls simply set fields in png_struct, so it is safe
278 * to do them now even though error handling is not yet set up.
280 # ifdef PNG_USER_MEM_SUPPORTED
281 png_set_mem_fn(&create_struct, mem_ptr, malloc_fn, free_fn);
282 # else
283 PNG_UNUSED(mem_ptr)
284 PNG_UNUSED(malloc_fn)
285 PNG_UNUSED(free_fn)
286 # endif
288 /* (*error_fn) can return control to the caller after the error_ptr is set,
289 * this will result in a memory leak unless the error_fn does something
290 * extremely sophisticated. The design lacks merit but is implicit in the
291 * API.
293 png_set_error_fn(&create_struct, error_ptr, error_fn, warn_fn);
295 # ifdef PNG_SETJMP_SUPPORTED
296 if (!setjmp(create_jmp_buf))
297 # endif
299 # ifdef PNG_SETJMP_SUPPORTED
300 /* Temporarily fake out the longjmp information until we have
301 * successfully completed this function. This only works if we have
302 * setjmp() support compiled in, but it is safe - this stuff should
303 * never happen.
305 create_struct.jmp_buf_ptr = &create_jmp_buf;
306 create_struct.jmp_buf_size = 0; /*stack allocation*/
307 create_struct.longjmp_fn = longjmp;
308 # endif
309 /* Call the general version checker (shared with read and write code):
311 if (png_user_version_check(&create_struct, user_png_ver) != 0)
313 png_structrp png_ptr = png_voidcast(png_structrp,
314 png_malloc_warn(&create_struct, (sizeof *png_ptr)));
316 if (png_ptr != NULL)
318 /* png_ptr->zstream holds a back-pointer to the png_struct, so
319 * this can only be done now:
321 create_struct.zstream.zalloc = png_zalloc;
322 create_struct.zstream.zfree = png_zfree;
323 create_struct.zstream.opaque = png_ptr;
325 # ifdef PNG_SETJMP_SUPPORTED
326 /* Eliminate the local error handling: */
327 create_struct.jmp_buf_ptr = NULL;
328 create_struct.jmp_buf_size = 0;
329 create_struct.longjmp_fn = 0;
330 # endif
332 *png_ptr = create_struct;
334 /* This is the successful return point */
335 return png_ptr;
340 /* A longjmp because of a bug in the application storage allocator or a
341 * simple failure to allocate the png_struct.
343 return NULL;
346 /* Allocate the memory for an info_struct for the application. */
347 PNG_FUNCTION(png_infop,PNGAPI
348 png_create_info_struct,(png_const_structrp png_ptr),PNG_ALLOCATED)
350 png_inforp info_ptr;
352 png_debug(1, "in png_create_info_struct");
354 if (png_ptr == NULL)
355 return NULL;
357 /* Use the internal API that does not (or at least should not) error out, so
358 * that this call always returns ok. The application typically sets up the
359 * error handling *after* creating the info_struct because this is the way it
360 * has always been done in 'example.c'.
362 info_ptr = png_voidcast(png_inforp, png_malloc_base(png_ptr,
363 (sizeof *info_ptr)));
365 if (info_ptr != NULL)
366 memset(info_ptr, 0, (sizeof *info_ptr));
368 return info_ptr;
371 /* This function frees the memory associated with a single info struct.
372 * Normally, one would use either png_destroy_read_struct() or
373 * png_destroy_write_struct() to free an info struct, but this may be
374 * useful for some applications. From libpng 1.6.0 this function is also used
375 * internally to implement the png_info release part of the 'struct' destroy
376 * APIs. This ensures that all possible approaches free the same data (all of
377 * it).
379 void PNGAPI
380 png_destroy_info_struct(png_const_structrp png_ptr, png_infopp info_ptr_ptr)
382 png_inforp info_ptr = NULL;
384 png_debug(1, "in png_destroy_info_struct");
386 if (png_ptr == NULL)
387 return;
389 if (info_ptr_ptr != NULL)
390 info_ptr = *info_ptr_ptr;
392 if (info_ptr != NULL)
394 /* Do this first in case of an error below; if the app implements its own
395 * memory management this can lead to png_free calling png_error, which
396 * will abort this routine and return control to the app error handler.
397 * An infinite loop may result if it then tries to free the same info
398 * ptr.
400 *info_ptr_ptr = NULL;
402 png_free_data(png_ptr, info_ptr, PNG_FREE_ALL, -1);
403 memset(info_ptr, 0, (sizeof *info_ptr));
404 png_free(png_ptr, info_ptr);
408 /* Initialize the info structure. This is now an internal function (0.89)
409 * and applications using it are urged to use png_create_info_struct()
410 * instead. Use deprecated in 1.6.0, internal use removed (used internally it
411 * is just a memset).
413 * NOTE: it is almost inconceivable that this API is used because it bypasses
414 * the user-memory mechanism and the user error handling/warning mechanisms in
415 * those cases where it does anything other than a memset.
417 PNG_FUNCTION(void,PNGAPI
418 png_info_init_3,(png_infopp ptr_ptr, png_size_t png_info_struct_size),
419 PNG_DEPRECATED)
421 png_inforp info_ptr = *ptr_ptr;
423 png_debug(1, "in png_info_init_3");
425 if (info_ptr == NULL)
426 return;
428 if ((sizeof (png_info)) > png_info_struct_size)
430 *ptr_ptr = NULL;
431 /* The following line is why this API should not be used: */
432 free(info_ptr);
433 info_ptr = png_voidcast(png_inforp, png_malloc_base(NULL,
434 (sizeof *info_ptr)));
435 if (info_ptr == NULL)
436 return;
437 *ptr_ptr = info_ptr;
440 /* Set everything to 0 */
441 memset(info_ptr, 0, (sizeof *info_ptr));
444 /* The following API is not called internally */
445 void PNGAPI
446 png_data_freer(png_const_structrp png_ptr, png_inforp info_ptr,
447 int freer, png_uint_32 mask)
449 png_debug(1, "in png_data_freer");
451 if (png_ptr == NULL || info_ptr == NULL)
452 return;
454 if (freer == PNG_DESTROY_WILL_FREE_DATA)
455 info_ptr->free_me |= mask;
457 else if (freer == PNG_USER_WILL_FREE_DATA)
458 info_ptr->free_me &= ~mask;
460 else
461 png_error(png_ptr, "Unknown freer parameter in png_data_freer");
464 void PNGAPI
465 png_free_data(png_const_structrp png_ptr, png_inforp info_ptr, png_uint_32 mask,
466 int num)
468 png_debug(1, "in png_free_data");
470 if (png_ptr == NULL || info_ptr == NULL)
471 return;
473 #ifdef PNG_TEXT_SUPPORTED
474 /* Free text item num or (if num == -1) all text items */
475 if (info_ptr->text != NULL &&
476 ((mask & PNG_FREE_TEXT) & info_ptr->free_me) != 0)
478 if (num != -1)
480 png_free(png_ptr, info_ptr->text[num].key);
481 info_ptr->text[num].key = NULL;
484 else
486 int i;
488 for (i = 0; i < info_ptr->num_text; i++)
489 png_free(png_ptr, info_ptr->text[i].key);
491 png_free(png_ptr, info_ptr->text);
492 info_ptr->text = NULL;
493 info_ptr->num_text = 0;
494 info_ptr->max_text = 0;
497 #endif
499 #ifdef PNG_tRNS_SUPPORTED
500 /* Free any tRNS entry */
501 if (((mask & PNG_FREE_TRNS) & info_ptr->free_me) != 0)
503 info_ptr->valid &= ~PNG_INFO_tRNS;
504 png_free(png_ptr, info_ptr->trans_alpha);
505 info_ptr->trans_alpha = NULL;
506 info_ptr->num_trans = 0;
508 #endif
510 #ifdef PNG_sCAL_SUPPORTED
511 /* Free any sCAL entry */
512 if (((mask & PNG_FREE_SCAL) & info_ptr->free_me) != 0)
514 png_free(png_ptr, info_ptr->scal_s_width);
515 png_free(png_ptr, info_ptr->scal_s_height);
516 info_ptr->scal_s_width = NULL;
517 info_ptr->scal_s_height = NULL;
518 info_ptr->valid &= ~PNG_INFO_sCAL;
520 #endif
522 #ifdef PNG_pCAL_SUPPORTED
523 /* Free any pCAL entry */
524 if (((mask & PNG_FREE_PCAL) & info_ptr->free_me) != 0)
526 png_free(png_ptr, info_ptr->pcal_purpose);
527 png_free(png_ptr, info_ptr->pcal_units);
528 info_ptr->pcal_purpose = NULL;
529 info_ptr->pcal_units = NULL;
531 if (info_ptr->pcal_params != NULL)
533 int i;
535 for (i = 0; i < info_ptr->pcal_nparams; i++)
536 png_free(png_ptr, info_ptr->pcal_params[i]);
538 png_free(png_ptr, info_ptr->pcal_params);
539 info_ptr->pcal_params = NULL;
541 info_ptr->valid &= ~PNG_INFO_pCAL;
543 #endif
545 #ifdef PNG_iCCP_SUPPORTED
546 /* Free any profile entry */
547 if (((mask & PNG_FREE_ICCP) & info_ptr->free_me) != 0)
549 png_free(png_ptr, info_ptr->iccp_name);
550 png_free(png_ptr, info_ptr->iccp_profile);
551 info_ptr->iccp_name = NULL;
552 info_ptr->iccp_profile = NULL;
553 info_ptr->valid &= ~PNG_INFO_iCCP;
555 #endif
557 #ifdef PNG_sPLT_SUPPORTED
558 /* Free a given sPLT entry, or (if num == -1) all sPLT entries */
559 if (info_ptr->splt_palettes != NULL &&
560 ((mask & PNG_FREE_SPLT) & info_ptr->free_me) != 0)
562 if (num != -1)
564 png_free(png_ptr, info_ptr->splt_palettes[num].name);
565 png_free(png_ptr, info_ptr->splt_palettes[num].entries);
566 info_ptr->splt_palettes[num].name = NULL;
567 info_ptr->splt_palettes[num].entries = NULL;
570 else
572 int i;
574 for (i = 0; i < info_ptr->splt_palettes_num; i++)
576 png_free(png_ptr, info_ptr->splt_palettes[i].name);
577 png_free(png_ptr, info_ptr->splt_palettes[i].entries);
580 png_free(png_ptr, info_ptr->splt_palettes);
581 info_ptr->splt_palettes = NULL;
582 info_ptr->splt_palettes_num = 0;
583 info_ptr->valid &= ~PNG_INFO_sPLT;
586 #endif
588 #ifdef PNG_STORE_UNKNOWN_CHUNKS_SUPPORTED
589 if (info_ptr->unknown_chunks != NULL &&
590 ((mask & PNG_FREE_UNKN) & info_ptr->free_me) != 0)
592 if (num != -1)
594 png_free(png_ptr, info_ptr->unknown_chunks[num].data);
595 info_ptr->unknown_chunks[num].data = NULL;
598 else
600 int i;
602 for (i = 0; i < info_ptr->unknown_chunks_num; i++)
603 png_free(png_ptr, info_ptr->unknown_chunks[i].data);
605 png_free(png_ptr, info_ptr->unknown_chunks);
606 info_ptr->unknown_chunks = NULL;
607 info_ptr->unknown_chunks_num = 0;
610 #endif
612 #ifdef PNG_hIST_SUPPORTED
613 /* Free any hIST entry */
614 if (((mask & PNG_FREE_HIST) & info_ptr->free_me) != 0)
616 png_free(png_ptr, info_ptr->hist);
617 info_ptr->hist = NULL;
618 info_ptr->valid &= ~PNG_INFO_hIST;
620 #endif
622 /* Free any PLTE entry that was internally allocated */
623 if (((mask & PNG_FREE_PLTE) & info_ptr->free_me) != 0)
625 png_free(png_ptr, info_ptr->palette);
626 info_ptr->palette = NULL;
627 info_ptr->valid &= ~PNG_INFO_PLTE;
628 info_ptr->num_palette = 0;
631 #ifdef PNG_INFO_IMAGE_SUPPORTED
632 /* Free any image bits attached to the info structure */
633 if (((mask & PNG_FREE_ROWS) & info_ptr->free_me) != 0)
635 if (info_ptr->row_pointers != NULL)
637 png_uint_32 row;
638 for (row = 0; row < info_ptr->height; row++)
639 png_free(png_ptr, info_ptr->row_pointers[row]);
641 png_free(png_ptr, info_ptr->row_pointers);
642 info_ptr->row_pointers = NULL;
644 info_ptr->valid &= ~PNG_INFO_IDAT;
646 #endif
648 if (num != -1)
649 mask &= ~PNG_FREE_MUL;
651 info_ptr->free_me &= ~mask;
653 #endif /* READ || WRITE */
655 /* This function returns a pointer to the io_ptr associated with the user
656 * functions. The application should free any memory associated with this
657 * pointer before png_write_destroy() or png_read_destroy() are called.
659 png_voidp PNGAPI
660 png_get_io_ptr(png_const_structrp png_ptr)
662 if (png_ptr == NULL)
663 return (NULL);
665 return (png_ptr->io_ptr);
668 #if defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED)
669 # ifdef PNG_STDIO_SUPPORTED
670 /* Initialize the default input/output functions for the PNG file. If you
671 * use your own read or write routines, you can call either png_set_read_fn()
672 * or png_set_write_fn() instead of png_init_io(). If you have defined
673 * PNG_NO_STDIO or otherwise disabled PNG_STDIO_SUPPORTED, you must use a
674 * function of your own because "FILE *" isn't necessarily available.
676 void PNGAPI
677 png_init_io(png_structrp png_ptr, png_FILE_p fp)
679 png_debug(1, "in png_init_io");
681 if (png_ptr == NULL)
682 return;
684 png_ptr->io_ptr = (png_voidp)fp;
686 # endif
688 # ifdef PNG_SAVE_INT_32_SUPPORTED
689 /* PNG signed integers are saved in 32-bit 2's complement format. ANSI C-90
690 * defines a cast of a signed integer to an unsigned integer either to preserve
691 * the value, if it is positive, or to calculate:
693 * (UNSIGNED_MAX+1) + integer
695 * Where UNSIGNED_MAX is the appropriate maximum unsigned value, so when the
696 * negative integral value is added the result will be an unsigned value
697 * correspnding to the 2's complement representation.
699 void PNGAPI
700 png_save_int_32(png_bytep buf, png_int_32 i)
702 png_save_uint_32(buf, (png_uint_32)i);
704 # endif
706 # ifdef PNG_TIME_RFC1123_SUPPORTED
707 /* Convert the supplied time into an RFC 1123 string suitable for use in
708 * a "Creation Time" or other text-based time string.
710 int PNGAPI
711 png_convert_to_rfc1123_buffer(char out[29], png_const_timep ptime)
713 static PNG_CONST char short_months[12][4] =
714 {"Jan", "Feb", "Mar", "Apr", "May", "Jun",
715 "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"};
717 if (out == NULL)
718 return 0;
720 if (ptime->year > 9999 /* RFC1123 limitation */ ||
721 ptime->month == 0 || ptime->month > 12 ||
722 ptime->day == 0 || ptime->day > 31 ||
723 ptime->hour > 23 || ptime->minute > 59 ||
724 ptime->second > 60)
725 return 0;
728 size_t pos = 0;
729 char number_buf[5]; /* enough for a four-digit year */
731 # define APPEND_STRING(string) pos = png_safecat(out, 29, pos, (string))
732 # define APPEND_NUMBER(format, value)\
733 APPEND_STRING(PNG_FORMAT_NUMBER(number_buf, format, (value)))
734 # define APPEND(ch) if (pos < 28) out[pos++] = (ch)
736 APPEND_NUMBER(PNG_NUMBER_FORMAT_u, (unsigned)ptime->day);
737 APPEND(' ');
738 APPEND_STRING(short_months[(ptime->month - 1)]);
739 APPEND(' ');
740 APPEND_NUMBER(PNG_NUMBER_FORMAT_u, ptime->year);
741 APPEND(' ');
742 APPEND_NUMBER(PNG_NUMBER_FORMAT_02u, (unsigned)ptime->hour);
743 APPEND(':');
744 APPEND_NUMBER(PNG_NUMBER_FORMAT_02u, (unsigned)ptime->minute);
745 APPEND(':');
746 APPEND_NUMBER(PNG_NUMBER_FORMAT_02u, (unsigned)ptime->second);
747 APPEND_STRING(" +0000"); /* This reliably terminates the buffer */
748 PNG_UNUSED (pos)
750 # undef APPEND
751 # undef APPEND_NUMBER
752 # undef APPEND_STRING
755 return 1;
758 # if PNG_LIBPNG_VER < 10700
759 /* To do: remove the following from libpng-1.7 */
760 /* Original API that uses a private buffer in png_struct.
761 * Deprecated because it causes png_struct to carry a spurious temporary
762 * buffer (png_struct::time_buffer), better to have the caller pass this in.
764 png_const_charp PNGAPI
765 png_convert_to_rfc1123(png_structrp png_ptr, png_const_timep ptime)
767 if (png_ptr != NULL)
769 /* The only failure above if png_ptr != NULL is from an invalid ptime */
770 if (png_convert_to_rfc1123_buffer(png_ptr->time_buffer, ptime) == 0)
771 png_warning(png_ptr, "Ignoring invalid time value");
773 else
774 return png_ptr->time_buffer;
777 return NULL;
779 # endif /* LIBPNG_VER < 10700 */
780 # endif /* TIME_RFC1123 */
782 #endif /* READ || WRITE */
784 png_const_charp PNGAPI
785 png_get_copyright(png_const_structrp png_ptr)
787 PNG_UNUSED(png_ptr) /* Silence compiler warning about unused png_ptr */
788 #ifdef PNG_STRING_COPYRIGHT
789 return PNG_STRING_COPYRIGHT
790 #else
791 # ifdef __STDC__
792 return PNG_STRING_NEWLINE \
793 "libpng version 1.6.28 - January 5, 2017" PNG_STRING_NEWLINE \
794 "Copyright (c) 1998-2002,2004,2006-2017 Glenn Randers-Pehrson" \
795 PNG_STRING_NEWLINE \
796 "Copyright (c) 1996-1997 Andreas Dilger" PNG_STRING_NEWLINE \
797 "Copyright (c) 1995-1996 Guy Eric Schalnat, Group 42, Inc." \
798 PNG_STRING_NEWLINE;
799 # else
800 return "libpng version 1.6.28 - January 5, 2017\
801 Copyright (c) 1998-2002,2004,2006-2017 Glenn Randers-Pehrson\
802 Copyright (c) 1996-1997 Andreas Dilger\
803 Copyright (c) 1995-1996 Guy Eric Schalnat, Group 42, Inc.";
804 # endif
805 #endif
808 /* The following return the library version as a short string in the
809 * format 1.0.0 through 99.99.99zz. To get the version of *.h files
810 * used with your application, print out PNG_LIBPNG_VER_STRING, which
811 * is defined in png.h.
812 * Note: now there is no difference between png_get_libpng_ver() and
813 * png_get_header_ver(). Due to the version_nn_nn_nn typedef guard,
814 * it is guaranteed that png.c uses the correct version of png.h.
816 png_const_charp PNGAPI
817 png_get_libpng_ver(png_const_structrp png_ptr)
819 /* Version of *.c files used when building libpng */
820 return png_get_header_ver(png_ptr);
823 png_const_charp PNGAPI
824 png_get_header_ver(png_const_structrp png_ptr)
826 /* Version of *.h files used when building libpng */
827 PNG_UNUSED(png_ptr) /* Silence compiler warning about unused png_ptr */
828 return PNG_LIBPNG_VER_STRING;
831 png_const_charp PNGAPI
832 png_get_header_version(png_const_structrp png_ptr)
834 /* Returns longer string containing both version and date */
835 PNG_UNUSED(png_ptr) /* Silence compiler warning about unused png_ptr */
836 #ifdef __STDC__
837 return PNG_HEADER_VERSION_STRING
838 # ifndef PNG_READ_SUPPORTED
839 " (NO READ SUPPORT)"
840 # endif
841 PNG_STRING_NEWLINE;
842 #else
843 return PNG_HEADER_VERSION_STRING;
844 #endif
847 #ifdef PNG_BUILD_GRAYSCALE_PALETTE_SUPPORTED
848 /* NOTE: this routine is not used internally! */
849 /* Build a grayscale palette. Palette is assumed to be 1 << bit_depth
850 * large of png_color. This lets grayscale images be treated as
851 * paletted. Most useful for gamma correction and simplification
852 * of code. This API is not used internally.
854 void PNGAPI
855 png_build_grayscale_palette(int bit_depth, png_colorp palette)
857 int num_palette;
858 int color_inc;
859 int i;
860 int v;
862 png_debug(1, "in png_do_build_grayscale_palette");
864 if (palette == NULL)
865 return;
867 switch (bit_depth)
869 case 1:
870 num_palette = 2;
871 color_inc = 0xff;
872 break;
874 case 2:
875 num_palette = 4;
876 color_inc = 0x55;
877 break;
879 case 4:
880 num_palette = 16;
881 color_inc = 0x11;
882 break;
884 case 8:
885 num_palette = 256;
886 color_inc = 1;
887 break;
889 default:
890 num_palette = 0;
891 color_inc = 0;
892 break;
895 for (i = 0, v = 0; i < num_palette; i++, v += color_inc)
897 palette[i].red = (png_byte)(v & 0xff);
898 palette[i].green = (png_byte)(v & 0xff);
899 palette[i].blue = (png_byte)(v & 0xff);
902 #endif
904 #ifdef PNG_SET_UNKNOWN_CHUNKS_SUPPORTED
905 int PNGAPI
906 png_handle_as_unknown(png_const_structrp png_ptr, png_const_bytep chunk_name)
908 /* Check chunk_name and return "keep" value if it's on the list, else 0 */
909 png_const_bytep p, p_end;
911 if (png_ptr == NULL || chunk_name == NULL || png_ptr->num_chunk_list == 0)
912 return PNG_HANDLE_CHUNK_AS_DEFAULT;
914 p_end = png_ptr->chunk_list;
915 p = p_end + png_ptr->num_chunk_list*5; /* beyond end */
917 /* The code is the fifth byte after each four byte string. Historically this
918 * code was always searched from the end of the list, this is no longer
919 * necessary because the 'set' routine handles duplicate entries correcty.
921 do /* num_chunk_list > 0, so at least one */
923 p -= 5;
925 if (memcmp(chunk_name, p, 4) == 0)
926 return p[4];
928 while (p > p_end);
930 /* This means that known chunks should be processed and unknown chunks should
931 * be handled according to the value of png_ptr->unknown_default; this can be
932 * confusing because, as a result, there are two levels of defaulting for
933 * unknown chunks.
935 return PNG_HANDLE_CHUNK_AS_DEFAULT;
938 #if defined(PNG_READ_UNKNOWN_CHUNKS_SUPPORTED) ||\
939 defined(PNG_HANDLE_AS_UNKNOWN_SUPPORTED)
940 int /* PRIVATE */
941 png_chunk_unknown_handling(png_const_structrp png_ptr, png_uint_32 chunk_name)
943 png_byte chunk_string[5];
945 PNG_CSTRING_FROM_CHUNK(chunk_string, chunk_name);
946 return png_handle_as_unknown(png_ptr, chunk_string);
948 #endif /* READ_UNKNOWN_CHUNKS || HANDLE_AS_UNKNOWN */
949 #endif /* SET_UNKNOWN_CHUNKS */
951 #ifdef PNG_READ_SUPPORTED
952 /* This function, added to libpng-1.0.6g, is untested. */
953 int PNGAPI
954 png_reset_zstream(png_structrp png_ptr)
956 if (png_ptr == NULL)
957 return Z_STREAM_ERROR;
959 /* WARNING: this resets the window bits to the maximum! */
960 return (inflateReset(&png_ptr->zstream));
962 #endif /* READ */
964 /* This function was added to libpng-1.0.7 */
965 png_uint_32 PNGAPI
966 png_access_version_number(void)
968 /* Version of *.c files used when building libpng */
969 return((png_uint_32)PNG_LIBPNG_VER);
972 #ifdef __AROS__
973 /* This function was added to libpng 1.2.0 */
974 int PNGAPI
975 png_mmx_support(void)
977 /* Obsolete, to be removed from libpng-1.4.0 */
978 return -1;
980 #endif /* __AROS__ */
982 #if defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED)
983 /* Ensure that png_ptr->zstream.msg holds some appropriate error message string.
984 * If it doesn't 'ret' is used to set it to something appropriate, even in cases
985 * like Z_OK or Z_STREAM_END where the error code is apparently a success code.
987 void /* PRIVATE */
988 png_zstream_error(png_structrp png_ptr, int ret)
990 /* Translate 'ret' into an appropriate error string, priority is given to the
991 * one in zstream if set. This always returns a string, even in cases like
992 * Z_OK or Z_STREAM_END where the error code is a success code.
994 if (png_ptr->zstream.msg == NULL) switch (ret)
996 default:
997 case Z_OK:
998 png_ptr->zstream.msg = PNGZ_MSG_CAST("unexpected zlib return code");
999 break;
1001 case Z_STREAM_END:
1002 /* Normal exit */
1003 png_ptr->zstream.msg = PNGZ_MSG_CAST("unexpected end of LZ stream");
1004 break;
1006 case Z_NEED_DICT:
1007 /* This means the deflate stream did not have a dictionary; this
1008 * indicates a bogus PNG.
1010 png_ptr->zstream.msg = PNGZ_MSG_CAST("missing LZ dictionary");
1011 break;
1013 case Z_ERRNO:
1014 /* gz APIs only: should not happen */
1015 png_ptr->zstream.msg = PNGZ_MSG_CAST("zlib IO error");
1016 break;
1018 case Z_STREAM_ERROR:
1019 /* internal libpng error */
1020 png_ptr->zstream.msg = PNGZ_MSG_CAST("bad parameters to zlib");
1021 break;
1023 case Z_DATA_ERROR:
1024 png_ptr->zstream.msg = PNGZ_MSG_CAST("damaged LZ stream");
1025 break;
1027 case Z_MEM_ERROR:
1028 png_ptr->zstream.msg = PNGZ_MSG_CAST("insufficient memory");
1029 break;
1031 case Z_BUF_ERROR:
1032 /* End of input or output; not a problem if the caller is doing
1033 * incremental read or write.
1035 png_ptr->zstream.msg = PNGZ_MSG_CAST("truncated");
1036 break;
1038 case Z_VERSION_ERROR:
1039 png_ptr->zstream.msg = PNGZ_MSG_CAST("unsupported zlib version");
1040 break;
1042 case PNG_UNEXPECTED_ZLIB_RETURN:
1043 /* Compile errors here mean that zlib now uses the value co-opted in
1044 * pngpriv.h for PNG_UNEXPECTED_ZLIB_RETURN; update the switch above
1045 * and change pngpriv.h. Note that this message is "... return",
1046 * whereas the default/Z_OK one is "... return code".
1048 png_ptr->zstream.msg = PNGZ_MSG_CAST("unexpected zlib return");
1049 break;
1053 /* png_convert_size: a PNGAPI but no longer in png.h, so deleted
1054 * at libpng 1.5.5!
1057 /* Added at libpng version 1.2.34 and 1.4.0 (moved from pngset.c) */
1058 #ifdef PNG_GAMMA_SUPPORTED /* always set if COLORSPACE */
1059 static int
1060 png_colorspace_check_gamma(png_const_structrp png_ptr,
1061 png_colorspacerp colorspace, png_fixed_point gAMA, int from)
1062 /* This is called to check a new gamma value against an existing one. The
1063 * routine returns false if the new gamma value should not be written.
1065 * 'from' says where the new gamma value comes from:
1067 * 0: the new gamma value is the libpng estimate for an ICC profile
1068 * 1: the new gamma value comes from a gAMA chunk
1069 * 2: the new gamma value comes from an sRGB chunk
1072 png_fixed_point gtest;
1074 if ((colorspace->flags & PNG_COLORSPACE_HAVE_GAMMA) != 0 &&
1075 (png_muldiv(&gtest, colorspace->gamma, PNG_FP_1, gAMA) == 0 ||
1076 png_gamma_significant(gtest) != 0))
1078 /* Either this is an sRGB image, in which case the calculated gamma
1079 * approximation should match, or this is an image with a profile and the
1080 * value libpng calculates for the gamma of the profile does not match the
1081 * value recorded in the file. The former, sRGB, case is an error, the
1082 * latter is just a warning.
1084 if ((colorspace->flags & PNG_COLORSPACE_FROM_sRGB) != 0 || from == 2)
1086 png_chunk_report(png_ptr, "gamma value does not match sRGB",
1087 PNG_CHUNK_ERROR);
1088 /* Do not overwrite an sRGB value */
1089 return from == 2;
1092 else /* sRGB tag not involved */
1094 png_chunk_report(png_ptr, "gamma value does not match libpng estimate",
1095 PNG_CHUNK_WARNING);
1096 return from == 1;
1100 return 1;
1103 void /* PRIVATE */
1104 png_colorspace_set_gamma(png_const_structrp png_ptr,
1105 png_colorspacerp colorspace, png_fixed_point gAMA)
1107 /* Changed in libpng-1.5.4 to limit the values to ensure overflow can't
1108 * occur. Since the fixed point representation is asymetrical it is
1109 * possible for 1/gamma to overflow the limit of 21474 and this means the
1110 * gamma value must be at least 5/100000 and hence at most 20000.0. For
1111 * safety the limits here are a little narrower. The values are 0.00016 to
1112 * 6250.0, which are truly ridiculous gamma values (and will produce
1113 * displays that are all black or all white.)
1115 * In 1.6.0 this test replaces the ones in pngrutil.c, in the gAMA chunk
1116 * handling code, which only required the value to be >0.
1118 png_const_charp errmsg;
1120 if (gAMA < 16 || gAMA > 625000000)
1121 errmsg = "gamma value out of range";
1123 # ifdef PNG_READ_gAMA_SUPPORTED
1124 /* Allow the application to set the gamma value more than once */
1125 else if ((png_ptr->mode & PNG_IS_READ_STRUCT) != 0 &&
1126 (colorspace->flags & PNG_COLORSPACE_FROM_gAMA) != 0)
1127 errmsg = "duplicate";
1128 # endif
1130 /* Do nothing if the colorspace is already invalid */
1131 else if ((colorspace->flags & PNG_COLORSPACE_INVALID) != 0)
1132 return;
1134 else
1136 if (png_colorspace_check_gamma(png_ptr, colorspace, gAMA,
1137 1/*from gAMA*/) != 0)
1139 /* Store this gamma value. */
1140 colorspace->gamma = gAMA;
1141 colorspace->flags |=
1142 (PNG_COLORSPACE_HAVE_GAMMA | PNG_COLORSPACE_FROM_gAMA);
1145 /* At present if the check_gamma test fails the gamma of the colorspace is
1146 * not updated however the colorspace is not invalidated. This
1147 * corresponds to the case where the existing gamma comes from an sRGB
1148 * chunk or profile. An error message has already been output.
1150 return;
1153 /* Error exit - errmsg has been set. */
1154 colorspace->flags |= PNG_COLORSPACE_INVALID;
1155 png_chunk_report(png_ptr, errmsg, PNG_CHUNK_WRITE_ERROR);
1158 void /* PRIVATE */
1159 png_colorspace_sync_info(png_const_structrp png_ptr, png_inforp info_ptr)
1161 if ((info_ptr->colorspace.flags & PNG_COLORSPACE_INVALID) != 0)
1163 /* Everything is invalid */
1164 info_ptr->valid &= ~(PNG_INFO_gAMA|PNG_INFO_cHRM|PNG_INFO_sRGB|
1165 PNG_INFO_iCCP);
1167 # ifdef PNG_COLORSPACE_SUPPORTED
1168 /* Clean up the iCCP profile now if it won't be used. */
1169 png_free_data(png_ptr, info_ptr, PNG_FREE_ICCP, -1/*not used*/);
1170 # else
1171 PNG_UNUSED(png_ptr)
1172 # endif
1175 else
1177 # ifdef PNG_COLORSPACE_SUPPORTED
1178 /* Leave the INFO_iCCP flag set if the pngset.c code has already set
1179 * it; this allows a PNG to contain a profile which matches sRGB and
1180 * yet still have that profile retrievable by the application.
1182 if ((info_ptr->colorspace.flags & PNG_COLORSPACE_MATCHES_sRGB) != 0)
1183 info_ptr->valid |= PNG_INFO_sRGB;
1185 else
1186 info_ptr->valid &= ~PNG_INFO_sRGB;
1188 if ((info_ptr->colorspace.flags & PNG_COLORSPACE_HAVE_ENDPOINTS) != 0)
1189 info_ptr->valid |= PNG_INFO_cHRM;
1191 else
1192 info_ptr->valid &= ~PNG_INFO_cHRM;
1193 # endif
1195 if ((info_ptr->colorspace.flags & PNG_COLORSPACE_HAVE_GAMMA) != 0)
1196 info_ptr->valid |= PNG_INFO_gAMA;
1198 else
1199 info_ptr->valid &= ~PNG_INFO_gAMA;
1203 #ifdef PNG_READ_SUPPORTED
1204 void /* PRIVATE */
1205 png_colorspace_sync(png_const_structrp png_ptr, png_inforp info_ptr)
1207 if (info_ptr == NULL) /* reduce code size; check here not in the caller */
1208 return;
1210 info_ptr->colorspace = png_ptr->colorspace;
1211 png_colorspace_sync_info(png_ptr, info_ptr);
1213 #endif
1214 #endif /* GAMMA */
1216 #ifdef PNG_COLORSPACE_SUPPORTED
1217 /* Added at libpng-1.5.5 to support read and write of true CIEXYZ values for
1218 * cHRM, as opposed to using chromaticities. These internal APIs return
1219 * non-zero on a parameter error. The X, Y and Z values are required to be
1220 * positive and less than 1.0.
1222 static int
1223 png_xy_from_XYZ(png_xy *xy, const png_XYZ *XYZ)
1225 png_int_32 d, dwhite, whiteX, whiteY;
1227 d = XYZ->red_X + XYZ->red_Y + XYZ->red_Z;
1228 if (png_muldiv(&xy->redx, XYZ->red_X, PNG_FP_1, d) == 0)
1229 return 1;
1230 if (png_muldiv(&xy->redy, XYZ->red_Y, PNG_FP_1, d) == 0)
1231 return 1;
1232 dwhite = d;
1233 whiteX = XYZ->red_X;
1234 whiteY = XYZ->red_Y;
1236 d = XYZ->green_X + XYZ->green_Y + XYZ->green_Z;
1237 if (png_muldiv(&xy->greenx, XYZ->green_X, PNG_FP_1, d) == 0)
1238 return 1;
1239 if (png_muldiv(&xy->greeny, XYZ->green_Y, PNG_FP_1, d) == 0)
1240 return 1;
1241 dwhite += d;
1242 whiteX += XYZ->green_X;
1243 whiteY += XYZ->green_Y;
1245 d = XYZ->blue_X + XYZ->blue_Y + XYZ->blue_Z;
1246 if (png_muldiv(&xy->bluex, XYZ->blue_X, PNG_FP_1, d) == 0)
1247 return 1;
1248 if (png_muldiv(&xy->bluey, XYZ->blue_Y, PNG_FP_1, d) == 0)
1249 return 1;
1250 dwhite += d;
1251 whiteX += XYZ->blue_X;
1252 whiteY += XYZ->blue_Y;
1254 /* The reference white is simply the sum of the end-point (X,Y,Z) vectors,
1255 * thus:
1257 if (png_muldiv(&xy->whitex, whiteX, PNG_FP_1, dwhite) == 0)
1258 return 1;
1259 if (png_muldiv(&xy->whitey, whiteY, PNG_FP_1, dwhite) == 0)
1260 return 1;
1262 return 0;
1265 static int
1266 png_XYZ_from_xy(png_XYZ *XYZ, const png_xy *xy)
1268 png_fixed_point red_inverse, green_inverse, blue_scale;
1269 png_fixed_point left, right, denominator;
1271 /* Check xy and, implicitly, z. Note that wide gamut color spaces typically
1272 * have end points with 0 tristimulus values (these are impossible end
1273 * points, but they are used to cover the possible colors). We check
1274 * xy->whitey against 5, not 0, to avoid a possible integer overflow.
1276 if (xy->redx < 0 || xy->redx > PNG_FP_1) return 1;
1277 if (xy->redy < 0 || xy->redy > PNG_FP_1-xy->redx) return 1;
1278 if (xy->greenx < 0 || xy->greenx > PNG_FP_1) return 1;
1279 if (xy->greeny < 0 || xy->greeny > PNG_FP_1-xy->greenx) return 1;
1280 if (xy->bluex < 0 || xy->bluex > PNG_FP_1) return 1;
1281 if (xy->bluey < 0 || xy->bluey > PNG_FP_1-xy->bluex) return 1;
1282 if (xy->whitex < 0 || xy->whitex > PNG_FP_1) return 1;
1283 if (xy->whitey < 5 || xy->whitey > PNG_FP_1-xy->whitex) return 1;
1285 /* The reverse calculation is more difficult because the original tristimulus
1286 * value had 9 independent values (red,green,blue)x(X,Y,Z) however only 8
1287 * derived values were recorded in the cHRM chunk;
1288 * (red,green,blue,white)x(x,y). This loses one degree of freedom and
1289 * therefore an arbitrary ninth value has to be introduced to undo the
1290 * original transformations.
1292 * Think of the original end-points as points in (X,Y,Z) space. The
1293 * chromaticity values (c) have the property:
1296 * c = ---------
1297 * X + Y + Z
1299 * For each c (x,y,z) from the corresponding original C (X,Y,Z). Thus the
1300 * three chromaticity values (x,y,z) for each end-point obey the
1301 * relationship:
1303 * x + y + z = 1
1305 * This describes the plane in (X,Y,Z) space that intersects each axis at the
1306 * value 1.0; call this the chromaticity plane. Thus the chromaticity
1307 * calculation has scaled each end-point so that it is on the x+y+z=1 plane
1308 * and chromaticity is the intersection of the vector from the origin to the
1309 * (X,Y,Z) value with the chromaticity plane.
1311 * To fully invert the chromaticity calculation we would need the three
1312 * end-point scale factors, (red-scale, green-scale, blue-scale), but these
1313 * were not recorded. Instead we calculated the reference white (X,Y,Z) and
1314 * recorded the chromaticity of this. The reference white (X,Y,Z) would have
1315 * given all three of the scale factors since:
1317 * color-C = color-c * color-scale
1318 * white-C = red-C + green-C + blue-C
1319 * = red-c*red-scale + green-c*green-scale + blue-c*blue-scale
1321 * But cHRM records only white-x and white-y, so we have lost the white scale
1322 * factor:
1324 * white-C = white-c*white-scale
1326 * To handle this the inverse transformation makes an arbitrary assumption
1327 * about white-scale:
1329 * Assume: white-Y = 1.0
1330 * Hence: white-scale = 1/white-y
1331 * Or: red-Y + green-Y + blue-Y = 1.0
1333 * Notice the last statement of the assumption gives an equation in three of
1334 * the nine values we want to calculate. 8 more equations come from the
1335 * above routine as summarised at the top above (the chromaticity
1336 * calculation):
1338 * Given: color-x = color-X / (color-X + color-Y + color-Z)
1339 * Hence: (color-x - 1)*color-X + color.x*color-Y + color.x*color-Z = 0
1341 * This is 9 simultaneous equations in the 9 variables "color-C" and can be
1342 * solved by Cramer's rule. Cramer's rule requires calculating 10 9x9 matrix
1343 * determinants, however this is not as bad as it seems because only 28 of
1344 * the total of 90 terms in the various matrices are non-zero. Nevertheless
1345 * Cramer's rule is notoriously numerically unstable because the determinant
1346 * calculation involves the difference of large, but similar, numbers. It is
1347 * difficult to be sure that the calculation is stable for real world values
1348 * and it is certain that it becomes unstable where the end points are close
1349 * together.
1351 * So this code uses the perhaps slightly less optimal but more
1352 * understandable and totally obvious approach of calculating color-scale.
1354 * This algorithm depends on the precision in white-scale and that is
1355 * (1/white-y), so we can immediately see that as white-y approaches 0 the
1356 * accuracy inherent in the cHRM chunk drops off substantially.
1358 * libpng arithmetic: a simple inversion of the above equations
1359 * ------------------------------------------------------------
1361 * white_scale = 1/white-y
1362 * white-X = white-x * white-scale
1363 * white-Y = 1.0
1364 * white-Z = (1 - white-x - white-y) * white_scale
1366 * white-C = red-C + green-C + blue-C
1367 * = red-c*red-scale + green-c*green-scale + blue-c*blue-scale
1369 * This gives us three equations in (red-scale,green-scale,blue-scale) where
1370 * all the coefficients are now known:
1372 * red-x*red-scale + green-x*green-scale + blue-x*blue-scale
1373 * = white-x/white-y
1374 * red-y*red-scale + green-y*green-scale + blue-y*blue-scale = 1
1375 * red-z*red-scale + green-z*green-scale + blue-z*blue-scale
1376 * = (1 - white-x - white-y)/white-y
1378 * In the last equation color-z is (1 - color-x - color-y) so we can add all
1379 * three equations together to get an alternative third:
1381 * red-scale + green-scale + blue-scale = 1/white-y = white-scale
1383 * So now we have a Cramer's rule solution where the determinants are just
1384 * 3x3 - far more tractible. Unfortunately 3x3 determinants still involve
1385 * multiplication of three coefficients so we can't guarantee to avoid
1386 * overflow in the libpng fixed point representation. Using Cramer's rule in
1387 * floating point is probably a good choice here, but it's not an option for
1388 * fixed point. Instead proceed to simplify the first two equations by
1389 * eliminating what is likely to be the largest value, blue-scale:
1391 * blue-scale = white-scale - red-scale - green-scale
1393 * Hence:
1395 * (red-x - blue-x)*red-scale + (green-x - blue-x)*green-scale =
1396 * (white-x - blue-x)*white-scale
1398 * (red-y - blue-y)*red-scale + (green-y - blue-y)*green-scale =
1399 * 1 - blue-y*white-scale
1401 * And now we can trivially solve for (red-scale,green-scale):
1403 * green-scale =
1404 * (white-x - blue-x)*white-scale - (red-x - blue-x)*red-scale
1405 * -----------------------------------------------------------
1406 * green-x - blue-x
1408 * red-scale =
1409 * 1 - blue-y*white-scale - (green-y - blue-y) * green-scale
1410 * ---------------------------------------------------------
1411 * red-y - blue-y
1413 * Hence:
1415 * red-scale =
1416 * ( (green-x - blue-x) * (white-y - blue-y) -
1417 * (green-y - blue-y) * (white-x - blue-x) ) / white-y
1418 * -------------------------------------------------------------------------
1419 * (green-x - blue-x)*(red-y - blue-y)-(green-y - blue-y)*(red-x - blue-x)
1421 * green-scale =
1422 * ( (red-y - blue-y) * (white-x - blue-x) -
1423 * (red-x - blue-x) * (white-y - blue-y) ) / white-y
1424 * -------------------------------------------------------------------------
1425 * (green-x - blue-x)*(red-y - blue-y)-(green-y - blue-y)*(red-x - blue-x)
1427 * Accuracy:
1428 * The input values have 5 decimal digits of accuracy. The values are all in
1429 * the range 0 < value < 1, so simple products are in the same range but may
1430 * need up to 10 decimal digits to preserve the original precision and avoid
1431 * underflow. Because we are using a 32-bit signed representation we cannot
1432 * match this; the best is a little over 9 decimal digits, less than 10.
1434 * The approach used here is to preserve the maximum precision within the
1435 * signed representation. Because the red-scale calculation above uses the
1436 * difference between two products of values that must be in the range -1..+1
1437 * it is sufficient to divide the product by 7; ceil(100,000/32767*2). The
1438 * factor is irrelevant in the calculation because it is applied to both
1439 * numerator and denominator.
1441 * Note that the values of the differences of the products of the
1442 * chromaticities in the above equations tend to be small, for example for
1443 * the sRGB chromaticities they are:
1445 * red numerator: -0.04751
1446 * green numerator: -0.08788
1447 * denominator: -0.2241 (without white-y multiplication)
1449 * The resultant Y coefficients from the chromaticities of some widely used
1450 * color space definitions are (to 15 decimal places):
1452 * sRGB
1453 * 0.212639005871510 0.715168678767756 0.072192315360734
1454 * Kodak ProPhoto
1455 * 0.288071128229293 0.711843217810102 0.000085653960605
1456 * Adobe RGB
1457 * 0.297344975250536 0.627363566255466 0.075291458493998
1458 * Adobe Wide Gamut RGB
1459 * 0.258728243040113 0.724682314948566 0.016589442011321
1461 /* By the argument, above overflow should be impossible here. The return
1462 * value of 2 indicates an internal error to the caller.
1464 if (png_muldiv(&left, xy->greenx-xy->bluex, xy->redy - xy->bluey, 7) == 0)
1465 return 2;
1466 if (png_muldiv(&right, xy->greeny-xy->bluey, xy->redx - xy->bluex, 7) == 0)
1467 return 2;
1468 denominator = left - right;
1470 /* Now find the red numerator. */
1471 if (png_muldiv(&left, xy->greenx-xy->bluex, xy->whitey-xy->bluey, 7) == 0)
1472 return 2;
1473 if (png_muldiv(&right, xy->greeny-xy->bluey, xy->whitex-xy->bluex, 7) == 0)
1474 return 2;
1476 /* Overflow is possible here and it indicates an extreme set of PNG cHRM
1477 * chunk values. This calculation actually returns the reciprocal of the
1478 * scale value because this allows us to delay the multiplication of white-y
1479 * into the denominator, which tends to produce a small number.
1481 if (png_muldiv(&red_inverse, xy->whitey, denominator, left-right) == 0 ||
1482 red_inverse <= xy->whitey /* r+g+b scales = white scale */)
1483 return 1;
1485 /* Similarly for green_inverse: */
1486 if (png_muldiv(&left, xy->redy-xy->bluey, xy->whitex-xy->bluex, 7) == 0)
1487 return 2;
1488 if (png_muldiv(&right, xy->redx-xy->bluex, xy->whitey-xy->bluey, 7) == 0)
1489 return 2;
1490 if (png_muldiv(&green_inverse, xy->whitey, denominator, left-right) == 0 ||
1491 green_inverse <= xy->whitey)
1492 return 1;
1494 /* And the blue scale, the checks above guarantee this can't overflow but it
1495 * can still produce 0 for extreme cHRM values.
1497 blue_scale = png_reciprocal(xy->whitey) - png_reciprocal(red_inverse) -
1498 png_reciprocal(green_inverse);
1499 if (blue_scale <= 0)
1500 return 1;
1503 /* And fill in the png_XYZ: */
1504 if (png_muldiv(&XYZ->red_X, xy->redx, PNG_FP_1, red_inverse) == 0)
1505 return 1;
1506 if (png_muldiv(&XYZ->red_Y, xy->redy, PNG_FP_1, red_inverse) == 0)
1507 return 1;
1508 if (png_muldiv(&XYZ->red_Z, PNG_FP_1 - xy->redx - xy->redy, PNG_FP_1,
1509 red_inverse) == 0)
1510 return 1;
1512 if (png_muldiv(&XYZ->green_X, xy->greenx, PNG_FP_1, green_inverse) == 0)
1513 return 1;
1514 if (png_muldiv(&XYZ->green_Y, xy->greeny, PNG_FP_1, green_inverse) == 0)
1515 return 1;
1516 if (png_muldiv(&XYZ->green_Z, PNG_FP_1 - xy->greenx - xy->greeny, PNG_FP_1,
1517 green_inverse) == 0)
1518 return 1;
1520 if (png_muldiv(&XYZ->blue_X, xy->bluex, blue_scale, PNG_FP_1) == 0)
1521 return 1;
1522 if (png_muldiv(&XYZ->blue_Y, xy->bluey, blue_scale, PNG_FP_1) == 0)
1523 return 1;
1524 if (png_muldiv(&XYZ->blue_Z, PNG_FP_1 - xy->bluex - xy->bluey, blue_scale,
1525 PNG_FP_1) == 0)
1526 return 1;
1528 return 0; /*success*/
1531 static int
1532 png_XYZ_normalize(png_XYZ *XYZ)
1534 png_int_32 Y;
1536 if (XYZ->red_Y < 0 || XYZ->green_Y < 0 || XYZ->blue_Y < 0 ||
1537 XYZ->red_X < 0 || XYZ->green_X < 0 || XYZ->blue_X < 0 ||
1538 XYZ->red_Z < 0 || XYZ->green_Z < 0 || XYZ->blue_Z < 0)
1539 return 1;
1541 /* Normalize by scaling so the sum of the end-point Y values is PNG_FP_1.
1542 * IMPLEMENTATION NOTE: ANSI requires signed overflow not to occur, therefore
1543 * relying on addition of two positive values producing a negative one is not
1544 * safe.
1546 Y = XYZ->red_Y;
1547 if (0x7fffffff - Y < XYZ->green_X)
1548 return 1;
1549 Y += XYZ->green_Y;
1550 if (0x7fffffff - Y < XYZ->blue_X)
1551 return 1;
1552 Y += XYZ->blue_Y;
1554 if (Y != PNG_FP_1)
1556 if (png_muldiv(&XYZ->red_X, XYZ->red_X, PNG_FP_1, Y) == 0)
1557 return 1;
1558 if (png_muldiv(&XYZ->red_Y, XYZ->red_Y, PNG_FP_1, Y) == 0)
1559 return 1;
1560 if (png_muldiv(&XYZ->red_Z, XYZ->red_Z, PNG_FP_1, Y) == 0)
1561 return 1;
1563 if (png_muldiv(&XYZ->green_X, XYZ->green_X, PNG_FP_1, Y) == 0)
1564 return 1;
1565 if (png_muldiv(&XYZ->green_Y, XYZ->green_Y, PNG_FP_1, Y) == 0)
1566 return 1;
1567 if (png_muldiv(&XYZ->green_Z, XYZ->green_Z, PNG_FP_1, Y) == 0)
1568 return 1;
1570 if (png_muldiv(&XYZ->blue_X, XYZ->blue_X, PNG_FP_1, Y) == 0)
1571 return 1;
1572 if (png_muldiv(&XYZ->blue_Y, XYZ->blue_Y, PNG_FP_1, Y) == 0)
1573 return 1;
1574 if (png_muldiv(&XYZ->blue_Z, XYZ->blue_Z, PNG_FP_1, Y) == 0)
1575 return 1;
1578 return 0;
1581 static int
1582 png_colorspace_endpoints_match(const png_xy *xy1, const png_xy *xy2, int delta)
1584 /* Allow an error of +/-0.01 (absolute value) on each chromaticity */
1585 if (PNG_OUT_OF_RANGE(xy1->whitex, xy2->whitex,delta) ||
1586 PNG_OUT_OF_RANGE(xy1->whitey, xy2->whitey,delta) ||
1587 PNG_OUT_OF_RANGE(xy1->redx, xy2->redx, delta) ||
1588 PNG_OUT_OF_RANGE(xy1->redy, xy2->redy, delta) ||
1589 PNG_OUT_OF_RANGE(xy1->greenx, xy2->greenx,delta) ||
1590 PNG_OUT_OF_RANGE(xy1->greeny, xy2->greeny,delta) ||
1591 PNG_OUT_OF_RANGE(xy1->bluex, xy2->bluex, delta) ||
1592 PNG_OUT_OF_RANGE(xy1->bluey, xy2->bluey, delta))
1593 return 0;
1594 return 1;
1597 /* Added in libpng-1.6.0, a different check for the validity of a set of cHRM
1598 * chunk chromaticities. Earlier checks used to simply look for the overflow
1599 * condition (where the determinant of the matrix to solve for XYZ ends up zero
1600 * because the chromaticity values are not all distinct.) Despite this it is
1601 * theoretically possible to produce chromaticities that are apparently valid
1602 * but that rapidly degrade to invalid, potentially crashing, sets because of
1603 * arithmetic inaccuracies when calculations are performed on them. The new
1604 * check is to round-trip xy -> XYZ -> xy and then check that the result is
1605 * within a small percentage of the original.
1607 static int
1608 png_colorspace_check_xy(png_XYZ *XYZ, const png_xy *xy)
1610 int result;
1611 png_xy xy_test;
1613 /* As a side-effect this routine also returns the XYZ endpoints. */
1614 result = png_XYZ_from_xy(XYZ, xy);
1615 if (result != 0)
1616 return result;
1618 result = png_xy_from_XYZ(&xy_test, XYZ);
1619 if (result != 0)
1620 return result;
1622 if (png_colorspace_endpoints_match(xy, &xy_test,
1623 5/*actually, the math is pretty accurate*/) != 0)
1624 return 0;
1626 /* Too much slip */
1627 return 1;
1630 /* This is the check going the other way. The XYZ is modified to normalize it
1631 * (another side-effect) and the xy chromaticities are returned.
1633 static int
1634 png_colorspace_check_XYZ(png_xy *xy, png_XYZ *XYZ)
1636 int result;
1637 png_XYZ XYZtemp;
1639 result = png_XYZ_normalize(XYZ);
1640 if (result != 0)
1641 return result;
1643 result = png_xy_from_XYZ(xy, XYZ);
1644 if (result != 0)
1645 return result;
1647 XYZtemp = *XYZ;
1648 return png_colorspace_check_xy(&XYZtemp, xy);
1651 /* Used to check for an endpoint match against sRGB */
1652 static const png_xy sRGB_xy = /* From ITU-R BT.709-3 */
1654 /* color x y */
1655 /* red */ 64000, 33000,
1656 /* green */ 30000, 60000,
1657 /* blue */ 15000, 6000,
1658 /* white */ 31270, 32900
1661 static int
1662 png_colorspace_set_xy_and_XYZ(png_const_structrp png_ptr,
1663 png_colorspacerp colorspace, const png_xy *xy, const png_XYZ *XYZ,
1664 int preferred)
1666 if ((colorspace->flags & PNG_COLORSPACE_INVALID) != 0)
1667 return 0;
1669 /* The consistency check is performed on the chromaticities; this factors out
1670 * variations because of the normalization (or not) of the end point Y
1671 * values.
1673 if (preferred < 2 &&
1674 (colorspace->flags & PNG_COLORSPACE_HAVE_ENDPOINTS) != 0)
1676 /* The end points must be reasonably close to any we already have. The
1677 * following allows an error of up to +/-.001
1679 if (png_colorspace_endpoints_match(xy, &colorspace->end_points_xy,
1680 100) == 0)
1682 colorspace->flags |= PNG_COLORSPACE_INVALID;
1683 png_benign_error(png_ptr, "inconsistent chromaticities");
1684 return 0; /* failed */
1687 /* Only overwrite with preferred values */
1688 if (preferred == 0)
1689 return 1; /* ok, but no change */
1692 colorspace->end_points_xy = *xy;
1693 colorspace->end_points_XYZ = *XYZ;
1694 colorspace->flags |= PNG_COLORSPACE_HAVE_ENDPOINTS;
1696 /* The end points are normally quoted to two decimal digits, so allow +/-0.01
1697 * on this test.
1699 if (png_colorspace_endpoints_match(xy, &sRGB_xy, 1000) != 0)
1700 colorspace->flags |= PNG_COLORSPACE_ENDPOINTS_MATCH_sRGB;
1702 else
1703 colorspace->flags &= PNG_COLORSPACE_CANCEL(
1704 PNG_COLORSPACE_ENDPOINTS_MATCH_sRGB);
1706 return 2; /* ok and changed */
1709 int /* PRIVATE */
1710 png_colorspace_set_chromaticities(png_const_structrp png_ptr,
1711 png_colorspacerp colorspace, const png_xy *xy, int preferred)
1713 /* We must check the end points to ensure they are reasonable - in the past
1714 * color management systems have crashed as a result of getting bogus
1715 * colorant values, while this isn't the fault of libpng it is the
1716 * responsibility of libpng because PNG carries the bomb and libpng is in a
1717 * position to protect against it.
1719 png_XYZ XYZ;
1721 switch (png_colorspace_check_xy(&XYZ, xy))
1723 case 0: /* success */
1724 return png_colorspace_set_xy_and_XYZ(png_ptr, colorspace, xy, &XYZ,
1725 preferred);
1727 case 1:
1728 /* We can't invert the chromaticities so we can't produce value XYZ
1729 * values. Likely as not a color management system will fail too.
1731 colorspace->flags |= PNG_COLORSPACE_INVALID;
1732 png_benign_error(png_ptr, "invalid chromaticities");
1733 break;
1735 default:
1736 /* libpng is broken; this should be a warning but if it happens we
1737 * want error reports so for the moment it is an error.
1739 colorspace->flags |= PNG_COLORSPACE_INVALID;
1740 png_error(png_ptr, "internal error checking chromaticities");
1743 return 0; /* failed */
1746 int /* PRIVATE */
1747 png_colorspace_set_endpoints(png_const_structrp png_ptr,
1748 png_colorspacerp colorspace, const png_XYZ *XYZ_in, int preferred)
1750 png_XYZ XYZ = *XYZ_in;
1751 png_xy xy;
1753 switch (png_colorspace_check_XYZ(&xy, &XYZ))
1755 case 0:
1756 return png_colorspace_set_xy_and_XYZ(png_ptr, colorspace, &xy, &XYZ,
1757 preferred);
1759 case 1:
1760 /* End points are invalid. */
1761 colorspace->flags |= PNG_COLORSPACE_INVALID;
1762 png_benign_error(png_ptr, "invalid end points");
1763 break;
1765 default:
1766 colorspace->flags |= PNG_COLORSPACE_INVALID;
1767 png_error(png_ptr, "internal error checking chromaticities");
1770 return 0; /* failed */
1773 #if defined(PNG_sRGB_SUPPORTED) || defined(PNG_iCCP_SUPPORTED)
1774 /* Error message generation */
1775 static char
1776 png_icc_tag_char(png_uint_32 byte)
1778 byte &= 0xff;
1779 if (byte >= 32 && byte <= 126)
1780 return (char)byte;
1781 else
1782 return '?';
1785 static void
1786 png_icc_tag_name(char *name, png_uint_32 tag)
1788 name[0] = '\'';
1789 name[1] = png_icc_tag_char(tag >> 24);
1790 name[2] = png_icc_tag_char(tag >> 16);
1791 name[3] = png_icc_tag_char(tag >> 8);
1792 name[4] = png_icc_tag_char(tag );
1793 name[5] = '\'';
1796 static int
1797 is_ICC_signature_char(png_alloc_size_t it)
1799 return it == 32 || (it >= 48 && it <= 57) || (it >= 65 && it <= 90) ||
1800 (it >= 97 && it <= 122);
1803 static int
1804 is_ICC_signature(png_alloc_size_t it)
1806 return is_ICC_signature_char(it >> 24) /* checks all the top bits */ &&
1807 is_ICC_signature_char((it >> 16) & 0xff) &&
1808 is_ICC_signature_char((it >> 8) & 0xff) &&
1809 is_ICC_signature_char(it & 0xff);
1812 static int
1813 png_icc_profile_error(png_const_structrp png_ptr, png_colorspacerp colorspace,
1814 png_const_charp name, png_alloc_size_t value, png_const_charp reason)
1816 size_t pos;
1817 char message[196]; /* see below for calculation */
1819 if (colorspace != NULL)
1820 colorspace->flags |= PNG_COLORSPACE_INVALID;
1822 pos = png_safecat(message, (sizeof message), 0, "profile '"); /* 9 chars */
1823 pos = png_safecat(message, pos+79, pos, name); /* Truncate to 79 chars */
1824 pos = png_safecat(message, (sizeof message), pos, "': "); /* +2 = 90 */
1825 if (is_ICC_signature(value) != 0)
1827 /* So 'value' is at most 4 bytes and the following cast is safe */
1828 png_icc_tag_name(message+pos, (png_uint_32)value);
1829 pos += 6; /* total +8; less than the else clause */
1830 message[pos++] = ':';
1831 message[pos++] = ' ';
1833 # ifdef PNG_WARNINGS_SUPPORTED
1834 else
1836 char number[PNG_NUMBER_BUFFER_SIZE]; /* +24 = 114*/
1838 pos = png_safecat(message, (sizeof message), pos,
1839 png_format_number(number, number+(sizeof number),
1840 PNG_NUMBER_FORMAT_x, value));
1841 pos = png_safecat(message, (sizeof message), pos, "h: "); /*+2 = 116*/
1843 # endif
1844 /* The 'reason' is an arbitrary message, allow +79 maximum 195 */
1845 pos = png_safecat(message, (sizeof message), pos, reason);
1846 PNG_UNUSED(pos)
1848 /* This is recoverable, but make it unconditionally an app_error on write to
1849 * avoid writing invalid ICC profiles into PNG files (i.e., we handle them
1850 * on read, with a warning, but on write unless the app turns off
1851 * application errors the PNG won't be written.)
1853 png_chunk_report(png_ptr, message,
1854 (colorspace != NULL) ? PNG_CHUNK_ERROR : PNG_CHUNK_WRITE_ERROR);
1856 return 0;
1858 #endif /* sRGB || iCCP */
1860 #ifdef PNG_sRGB_SUPPORTED
1861 int /* PRIVATE */
1862 png_colorspace_set_sRGB(png_const_structrp png_ptr, png_colorspacerp colorspace,
1863 int intent)
1865 /* sRGB sets known gamma, end points and (from the chunk) intent. */
1866 /* IMPORTANT: these are not necessarily the values found in an ICC profile
1867 * because ICC profiles store values adapted to a D50 environment; it is
1868 * expected that the ICC profile mediaWhitePointTag will be D50; see the
1869 * checks and code elsewhere to understand this better.
1871 * These XYZ values, which are accurate to 5dp, produce rgb to gray
1872 * coefficients of (6968,23435,2366), which are reduced (because they add up
1873 * to 32769 not 32768) to (6968,23434,2366). These are the values that
1874 * libpng has traditionally used (and are the best values given the 15bit
1875 * algorithm used by the rgb to gray code.)
1877 static const png_XYZ sRGB_XYZ = /* D65 XYZ (*not* the D50 adapted values!) */
1879 /* color X Y Z */
1880 /* red */ 41239, 21264, 1933,
1881 /* green */ 35758, 71517, 11919,
1882 /* blue */ 18048, 7219, 95053
1885 /* Do nothing if the colorspace is already invalidated. */
1886 if ((colorspace->flags & PNG_COLORSPACE_INVALID) != 0)
1887 return 0;
1889 /* Check the intent, then check for existing settings. It is valid for the
1890 * PNG file to have cHRM or gAMA chunks along with sRGB, but the values must
1891 * be consistent with the correct values. If, however, this function is
1892 * called below because an iCCP chunk matches sRGB then it is quite
1893 * conceivable that an older app recorded incorrect gAMA and cHRM because of
1894 * an incorrect calculation based on the values in the profile - this does
1895 * *not* invalidate the profile (though it still produces an error, which can
1896 * be ignored.)
1898 if (intent < 0 || intent >= PNG_sRGB_INTENT_LAST)
1899 return png_icc_profile_error(png_ptr, colorspace, "sRGB",
1900 (unsigned)intent, "invalid sRGB rendering intent");
1902 if ((colorspace->flags & PNG_COLORSPACE_HAVE_INTENT) != 0 &&
1903 colorspace->rendering_intent != intent)
1904 return png_icc_profile_error(png_ptr, colorspace, "sRGB",
1905 (unsigned)intent, "inconsistent rendering intents");
1907 if ((colorspace->flags & PNG_COLORSPACE_FROM_sRGB) != 0)
1909 png_benign_error(png_ptr, "duplicate sRGB information ignored");
1910 return 0;
1913 /* If the standard sRGB cHRM chunk does not match the one from the PNG file
1914 * warn but overwrite the value with the correct one.
1916 if ((colorspace->flags & PNG_COLORSPACE_HAVE_ENDPOINTS) != 0 &&
1917 !png_colorspace_endpoints_match(&sRGB_xy, &colorspace->end_points_xy,
1918 100))
1919 png_chunk_report(png_ptr, "cHRM chunk does not match sRGB",
1920 PNG_CHUNK_ERROR);
1922 /* This check is just done for the error reporting - the routine always
1923 * returns true when the 'from' argument corresponds to sRGB (2).
1925 (void)png_colorspace_check_gamma(png_ptr, colorspace, PNG_GAMMA_sRGB_INVERSE,
1926 2/*from sRGB*/);
1928 /* intent: bugs in GCC force 'int' to be used as the parameter type. */
1929 colorspace->rendering_intent = (png_uint_16)intent;
1930 colorspace->flags |= PNG_COLORSPACE_HAVE_INTENT;
1932 /* endpoints */
1933 colorspace->end_points_xy = sRGB_xy;
1934 colorspace->end_points_XYZ = sRGB_XYZ;
1935 colorspace->flags |=
1936 (PNG_COLORSPACE_HAVE_ENDPOINTS|PNG_COLORSPACE_ENDPOINTS_MATCH_sRGB);
1938 /* gamma */
1939 colorspace->gamma = PNG_GAMMA_sRGB_INVERSE;
1940 colorspace->flags |= PNG_COLORSPACE_HAVE_GAMMA;
1942 /* Finally record that we have an sRGB profile */
1943 colorspace->flags |=
1944 (PNG_COLORSPACE_MATCHES_sRGB|PNG_COLORSPACE_FROM_sRGB);
1946 return 1; /* set */
1948 #endif /* sRGB */
1950 #ifdef PNG_iCCP_SUPPORTED
1951 /* Encoded value of D50 as an ICC XYZNumber. From the ICC 2010 spec the value
1952 * is XYZ(0.9642,1.0,0.8249), which scales to:
1954 * (63189.8112, 65536, 54060.6464)
1956 static const png_byte D50_nCIEXYZ[12] =
1957 { 0x00, 0x00, 0xf6, 0xd6, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0xd3, 0x2d };
1959 static int /* bool */
1960 icc_check_length(png_const_structrp png_ptr, png_colorspacerp colorspace,
1961 png_const_charp name, png_uint_32 profile_length)
1963 if (profile_length < 132)
1964 return png_icc_profile_error(png_ptr, colorspace, name, profile_length,
1965 "too short");
1967 return 1;
1970 #ifdef PNG_READ_iCCP_SUPPORTED
1971 int /* PRIVATE */
1972 png_icc_check_length(png_const_structrp png_ptr, png_colorspacerp colorspace,
1973 png_const_charp name, png_uint_32 profile_length)
1975 if (!icc_check_length(png_ptr, colorspace, name, profile_length))
1976 return 0;
1978 /* This needs to be here because the 'normal' check is in
1979 * png_decompress_chunk, yet this happens after the attempt to
1980 * png_malloc_base the required data. We only need this on read; on write
1981 * the caller supplies the profile buffer so libpng doesn't allocate it. See
1982 * the call to icc_check_length below (the write case).
1984 # ifdef PNG_SET_USER_LIMITS_SUPPORTED
1985 else if (png_ptr->user_chunk_malloc_max > 0 &&
1986 png_ptr->user_chunk_malloc_max < profile_length)
1987 return png_icc_profile_error(png_ptr, colorspace, name, profile_length,
1988 "exceeds application limits");
1989 # elif PNG_USER_CHUNK_MALLOC_MAX > 0
1990 else if (PNG_USER_CHUNK_MALLOC_MAX < profile_length)
1991 return png_icc_profile_error(png_ptr, colorspace, name, profile_length,
1992 "exceeds libpng limits");
1993 # else /* !SET_USER_LIMITS */
1994 /* This will get compiled out on all 32-bit and better systems. */
1995 else if (PNG_SIZE_MAX < profile_length)
1996 return png_icc_profile_error(png_ptr, colorspace, name, profile_length,
1997 "exceeds system limits");
1998 # endif /* !SET_USER_LIMITS */
2000 return 1;
2002 #endif /* READ_iCCP */
2004 int /* PRIVATE */
2005 png_icc_check_header(png_const_structrp png_ptr, png_colorspacerp colorspace,
2006 png_const_charp name, png_uint_32 profile_length,
2007 png_const_bytep profile/* first 132 bytes only */, int color_type)
2009 png_uint_32 temp;
2011 /* Length check; this cannot be ignored in this code because profile_length
2012 * is used later to check the tag table, so even if the profile seems over
2013 * long profile_length from the caller must be correct. The caller can fix
2014 * this up on read or write by just passing in the profile header length.
2016 temp = png_get_uint_32(profile);
2017 if (temp != profile_length)
2018 return png_icc_profile_error(png_ptr, colorspace, name, temp,
2019 "length does not match profile");
2021 temp = (png_uint_32) (*(profile+8));
2022 if (temp > 3 && (profile_length & 3))
2023 return png_icc_profile_error(png_ptr, colorspace, name, profile_length,
2024 "invalid length");
2026 temp = png_get_uint_32(profile+128); /* tag count: 12 bytes/tag */
2027 if (temp > 357913930 || /* (2^32-4-132)/12: maximum possible tag count */
2028 profile_length < 132+12*temp) /* truncated tag table */
2029 return png_icc_profile_error(png_ptr, colorspace, name, temp,
2030 "tag count too large");
2032 /* The 'intent' must be valid or we can't store it, ICC limits the intent to
2033 * 16 bits.
2035 temp = png_get_uint_32(profile+64);
2036 if (temp >= 0xffff) /* The ICC limit */
2037 return png_icc_profile_error(png_ptr, colorspace, name, temp,
2038 "invalid rendering intent");
2040 /* This is just a warning because the profile may be valid in future
2041 * versions.
2043 if (temp >= PNG_sRGB_INTENT_LAST)
2044 (void)png_icc_profile_error(png_ptr, NULL, name, temp,
2045 "intent outside defined range");
2047 /* At this point the tag table can't be checked because it hasn't necessarily
2048 * been loaded; however, various header fields can be checked. These checks
2049 * are for values permitted by the PNG spec in an ICC profile; the PNG spec
2050 * restricts the profiles that can be passed in an iCCP chunk (they must be
2051 * appropriate to processing PNG data!)
2054 /* Data checks (could be skipped). These checks must be independent of the
2055 * version number; however, the version number doesn't accomodate changes in
2056 * the header fields (just the known tags and the interpretation of the
2057 * data.)
2059 temp = png_get_uint_32(profile+36); /* signature 'ascp' */
2060 if (temp != 0x61637370)
2061 return png_icc_profile_error(png_ptr, colorspace, name, temp,
2062 "invalid signature");
2064 /* Currently the PCS illuminant/adopted white point (the computational
2065 * white point) are required to be D50,
2066 * however the profile contains a record of the illuminant so perhaps ICC
2067 * expects to be able to change this in the future (despite the rationale in
2068 * the introduction for using a fixed PCS adopted white.) Consequently the
2069 * following is just a warning.
2071 if (memcmp(profile+68, D50_nCIEXYZ, 12) != 0)
2072 (void)png_icc_profile_error(png_ptr, NULL, name, 0/*no tag value*/,
2073 "PCS illuminant is not D50");
2075 /* The PNG spec requires this:
2076 * "If the iCCP chunk is present, the image samples conform to the colour
2077 * space represented by the embedded ICC profile as defined by the
2078 * International Color Consortium [ICC]. The colour space of the ICC profile
2079 * shall be an RGB colour space for colour images (PNG colour types 2, 3, and
2080 * 6), or a greyscale colour space for greyscale images (PNG colour types 0
2081 * and 4)."
2083 * This checking code ensures the embedded profile (on either read or write)
2084 * conforms to the specification requirements. Notice that an ICC 'gray'
2085 * color-space profile contains the information to transform the monochrome
2086 * data to XYZ or L*a*b (according to which PCS the profile uses) and this
2087 * should be used in preference to the standard libpng K channel replication
2088 * into R, G and B channels.
2090 * Previously it was suggested that an RGB profile on grayscale data could be
2091 * handled. However it it is clear that using an RGB profile in this context
2092 * must be an error - there is no specification of what it means. Thus it is
2093 * almost certainly more correct to ignore the profile.
2095 temp = png_get_uint_32(profile+16); /* data colour space field */
2096 switch (temp)
2098 case 0x52474220: /* 'RGB ' */
2099 if ((color_type & PNG_COLOR_MASK_COLOR) == 0)
2100 return png_icc_profile_error(png_ptr, colorspace, name, temp,
2101 "RGB color space not permitted on grayscale PNG");
2102 break;
2104 case 0x47524159: /* 'GRAY' */
2105 if ((color_type & PNG_COLOR_MASK_COLOR) != 0)
2106 return png_icc_profile_error(png_ptr, colorspace, name, temp,
2107 "Gray color space not permitted on RGB PNG");
2108 break;
2110 default:
2111 return png_icc_profile_error(png_ptr, colorspace, name, temp,
2112 "invalid ICC profile color space");
2115 /* It is up to the application to check that the profile class matches the
2116 * application requirements; the spec provides no guidance, but it's pretty
2117 * weird if the profile is not scanner ('scnr'), monitor ('mntr'), printer
2118 * ('prtr') or 'spac' (for generic color spaces). Issue a warning in these
2119 * cases. Issue an error for device link or abstract profiles - these don't
2120 * contain the records necessary to transform the color-space to anything
2121 * other than the target device (and not even that for an abstract profile).
2122 * Profiles of these classes may not be embedded in images.
2124 temp = png_get_uint_32(profile+12); /* profile/device class */
2125 switch (temp)
2127 case 0x73636e72: /* 'scnr' */
2128 case 0x6d6e7472: /* 'mntr' */
2129 case 0x70727472: /* 'prtr' */
2130 case 0x73706163: /* 'spac' */
2131 /* All supported */
2132 break;
2134 case 0x61627374: /* 'abst' */
2135 /* May not be embedded in an image */
2136 return png_icc_profile_error(png_ptr, colorspace, name, temp,
2137 "invalid embedded Abstract ICC profile");
2139 case 0x6c696e6b: /* 'link' */
2140 /* DeviceLink profiles cannot be interpreted in a non-device specific
2141 * fashion, if an app uses the AToB0Tag in the profile the results are
2142 * undefined unless the result is sent to the intended device,
2143 * therefore a DeviceLink profile should not be found embedded in a
2144 * PNG.
2146 return png_icc_profile_error(png_ptr, colorspace, name, temp,
2147 "unexpected DeviceLink ICC profile class");
2149 case 0x6e6d636c: /* 'nmcl' */
2150 /* A NamedColor profile is also device specific, however it doesn't
2151 * contain an AToB0 tag that is open to misinterpretation. Almost
2152 * certainly it will fail the tests below.
2154 (void)png_icc_profile_error(png_ptr, NULL, name, temp,
2155 "unexpected NamedColor ICC profile class");
2156 break;
2158 default:
2159 /* To allow for future enhancements to the profile accept unrecognized
2160 * profile classes with a warning, these then hit the test below on the
2161 * tag content to ensure they are backward compatible with one of the
2162 * understood profiles.
2164 (void)png_icc_profile_error(png_ptr, NULL, name, temp,
2165 "unrecognized ICC profile class");
2166 break;
2169 /* For any profile other than a device link one the PCS must be encoded
2170 * either in XYZ or Lab.
2172 temp = png_get_uint_32(profile+20);
2173 switch (temp)
2175 case 0x58595a20: /* 'XYZ ' */
2176 case 0x4c616220: /* 'Lab ' */
2177 break;
2179 default:
2180 return png_icc_profile_error(png_ptr, colorspace, name, temp,
2181 "unexpected ICC PCS encoding");
2184 return 1;
2187 int /* PRIVATE */
2188 png_icc_check_tag_table(png_const_structrp png_ptr, png_colorspacerp colorspace,
2189 png_const_charp name, png_uint_32 profile_length,
2190 png_const_bytep profile /* header plus whole tag table */)
2192 png_uint_32 tag_count = png_get_uint_32(profile+128);
2193 png_uint_32 itag;
2194 png_const_bytep tag = profile+132; /* The first tag */
2196 /* First scan all the tags in the table and add bits to the icc_info value
2197 * (temporarily in 'tags').
2199 for (itag=0; itag < tag_count; ++itag, tag += 12)
2201 png_uint_32 tag_id = png_get_uint_32(tag+0);
2202 png_uint_32 tag_start = png_get_uint_32(tag+4); /* must be aligned */
2203 png_uint_32 tag_length = png_get_uint_32(tag+8);/* not padded */
2205 /* The ICC specification does not exclude zero length tags, therefore the
2206 * start might actually be anywhere if there is no data, but this would be
2207 * a clear abuse of the intent of the standard so the start is checked for
2208 * being in range. All defined tag types have an 8 byte header - a 4 byte
2209 * type signature then 0.
2211 if ((tag_start & 3) != 0)
2213 /* CNHP730S.icc shipped with Microsoft Windows 64 violates this, it is
2214 * only a warning here because libpng does not care about the
2215 * alignment.
2217 (void)png_icc_profile_error(png_ptr, NULL, name, tag_id,
2218 "ICC profile tag start not a multiple of 4");
2221 /* This is a hard error; potentially it can cause read outside the
2222 * profile.
2224 if (tag_start > profile_length || tag_length > profile_length - tag_start)
2225 return png_icc_profile_error(png_ptr, colorspace, name, tag_id,
2226 "ICC profile tag outside profile");
2229 return 1; /* success, maybe with warnings */
2232 #ifdef PNG_sRGB_SUPPORTED
2233 #if PNG_sRGB_PROFILE_CHECKS >= 0
2234 /* Information about the known ICC sRGB profiles */
2235 static const struct
2237 png_uint_32 adler, crc, length;
2238 png_uint_32 md5[4];
2239 png_byte have_md5;
2240 png_byte is_broken;
2241 png_uint_16 intent;
2243 # define PNG_MD5(a,b,c,d) { a, b, c, d }, (a!=0)||(b!=0)||(c!=0)||(d!=0)
2244 # define PNG_ICC_CHECKSUM(adler, crc, md5, intent, broke, date, length, fname)\
2245 { adler, crc, length, md5, broke, intent },
2247 } png_sRGB_checks[] =
2249 /* This data comes from contrib/tools/checksum-icc run on downloads of
2250 * all four ICC sRGB profiles from www.color.org.
2252 /* adler32, crc32, MD5[4], intent, date, length, file-name */
2253 PNG_ICC_CHECKSUM(0x0a3fd9f6, 0x3b8772b9,
2254 PNG_MD5(0x29f83dde, 0xaff255ae, 0x7842fae4, 0xca83390d), 0, 0,
2255 "2009/03/27 21:36:31", 3048, "sRGB_IEC61966-2-1_black_scaled.icc")
2257 /* ICC sRGB v2 perceptual no black-compensation: */
2258 PNG_ICC_CHECKSUM(0x4909e5e1, 0x427ebb21,
2259 PNG_MD5(0xc95bd637, 0xe95d8a3b, 0x0df38f99, 0xc1320389), 1, 0,
2260 "2009/03/27 21:37:45", 3052, "sRGB_IEC61966-2-1_no_black_scaling.icc")
2262 PNG_ICC_CHECKSUM(0xfd2144a1, 0x306fd8ae,
2263 PNG_MD5(0xfc663378, 0x37e2886b, 0xfd72e983, 0x8228f1b8), 0, 0,
2264 "2009/08/10 17:28:01", 60988, "sRGB_v4_ICC_preference_displayclass.icc")
2266 /* ICC sRGB v4 perceptual */
2267 PNG_ICC_CHECKSUM(0x209c35d2, 0xbbef7812,
2268 PNG_MD5(0x34562abf, 0x994ccd06, 0x6d2c5721, 0xd0d68c5d), 0, 0,
2269 "2007/07/25 00:05:37", 60960, "sRGB_v4_ICC_preference.icc")
2271 /* The following profiles have no known MD5 checksum. If there is a match
2272 * on the (empty) MD5 the other fields are used to attempt a match and
2273 * a warning is produced. The first two of these profiles have a 'cprt' tag
2274 * which suggests that they were also made by Hewlett Packard.
2276 PNG_ICC_CHECKSUM(0xa054d762, 0x5d5129ce,
2277 PNG_MD5(0x00000000, 0x00000000, 0x00000000, 0x00000000), 1, 0,
2278 "2004/07/21 18:57:42", 3024, "sRGB_IEC61966-2-1_noBPC.icc")
2280 /* This is a 'mntr' (display) profile with a mediaWhitePointTag that does not
2281 * match the D50 PCS illuminant in the header (it is in fact the D65 values,
2282 * so the white point is recorded as the un-adapted value.) The profiles
2283 * below only differ in one byte - the intent - and are basically the same as
2284 * the previous profile except for the mediaWhitePointTag error and a missing
2285 * chromaticAdaptationTag.
2287 PNG_ICC_CHECKSUM(0xf784f3fb, 0x182ea552,
2288 PNG_MD5(0x00000000, 0x00000000, 0x00000000, 0x00000000), 0, 1/*broken*/,
2289 "1998/02/09 06:49:00", 3144, "HP-Microsoft sRGB v2 perceptual")
2291 PNG_ICC_CHECKSUM(0x0398f3fc, 0xf29e526d,
2292 PNG_MD5(0x00000000, 0x00000000, 0x00000000, 0x00000000), 1, 1/*broken*/,
2293 "1998/02/09 06:49:00", 3144, "HP-Microsoft sRGB v2 media-relative")
2296 static int
2297 png_compare_ICC_profile_with_sRGB(png_const_structrp png_ptr,
2298 png_const_bytep profile, uLong adler)
2300 /* The quick check is to verify just the MD5 signature and trust the
2301 * rest of the data. Because the profile has already been verified for
2302 * correctness this is safe. png_colorspace_set_sRGB will check the 'intent'
2303 * field too, so if the profile has been edited with an intent not defined
2304 * by sRGB (but maybe defined by a later ICC specification) the read of
2305 * the profile will fail at that point.
2308 png_uint_32 length = 0;
2309 png_uint_32 intent = 0x10000; /* invalid */
2310 #if PNG_sRGB_PROFILE_CHECKS > 1
2311 uLong crc = 0; /* the value for 0 length data */
2312 #endif
2313 unsigned int i;
2315 #ifdef PNG_SET_OPTION_SUPPORTED
2316 /* First see if PNG_SKIP_sRGB_CHECK_PROFILE has been set to "on" */
2317 if (((png_ptr->options >> PNG_SKIP_sRGB_CHECK_PROFILE) & 3) ==
2318 PNG_OPTION_ON)
2319 return 0;
2320 #endif
2322 for (i=0; i < (sizeof png_sRGB_checks) / (sizeof png_sRGB_checks[0]); ++i)
2324 if (png_get_uint_32(profile+84) == png_sRGB_checks[i].md5[0] &&
2325 png_get_uint_32(profile+88) == png_sRGB_checks[i].md5[1] &&
2326 png_get_uint_32(profile+92) == png_sRGB_checks[i].md5[2] &&
2327 png_get_uint_32(profile+96) == png_sRGB_checks[i].md5[3])
2329 /* This may be one of the old HP profiles without an MD5, in that
2330 * case we can only use the length and Adler32 (note that these
2331 * are not used by default if there is an MD5!)
2333 # if PNG_sRGB_PROFILE_CHECKS == 0
2334 if (png_sRGB_checks[i].have_md5 != 0)
2335 return 1+png_sRGB_checks[i].is_broken;
2336 # endif
2338 /* Profile is unsigned or more checks have been configured in. */
2339 if (length == 0)
2341 length = png_get_uint_32(profile);
2342 intent = png_get_uint_32(profile+64);
2345 /* Length *and* intent must match */
2346 if (length == (png_uint_32) png_sRGB_checks[i].length &&
2347 intent == (png_uint_32) png_sRGB_checks[i].intent)
2349 /* Now calculate the adler32 if not done already. */
2350 if (adler == 0)
2352 adler = adler32(0, NULL, 0);
2353 adler = adler32(adler, profile, length);
2356 if (adler == png_sRGB_checks[i].adler)
2358 /* These basic checks suggest that the data has not been
2359 * modified, but if the check level is more than 1 perform
2360 * our own crc32 checksum on the data.
2362 # if PNG_sRGB_PROFILE_CHECKS > 1
2363 if (crc == 0)
2365 crc = crc32(0, NULL, 0);
2366 crc = crc32(crc, profile, length);
2369 /* So this check must pass for the 'return' below to happen.
2371 if (crc == png_sRGB_checks[i].crc)
2372 # endif
2374 if (png_sRGB_checks[i].is_broken != 0)
2376 /* These profiles are known to have bad data that may cause
2377 * problems if they are used, therefore attempt to
2378 * discourage their use, skip the 'have_md5' warning below,
2379 * which is made irrelevant by this error.
2381 png_chunk_report(png_ptr, "known incorrect sRGB profile",
2382 PNG_CHUNK_ERROR);
2385 /* Warn that this being done; this isn't even an error since
2386 * the profile is perfectly valid, but it would be nice if
2387 * people used the up-to-date ones.
2389 else if (png_sRGB_checks[i].have_md5 == 0)
2391 png_chunk_report(png_ptr,
2392 "out-of-date sRGB profile with no signature",
2393 PNG_CHUNK_WARNING);
2396 return 1+png_sRGB_checks[i].is_broken;
2400 # if PNG_sRGB_PROFILE_CHECKS > 0
2401 /* The signature matched, but the profile had been changed in some
2402 * way. This probably indicates a data error or uninformed hacking.
2403 * Fall through to "no match".
2405 png_chunk_report(png_ptr,
2406 "Not recognizing known sRGB profile that has been edited",
2407 PNG_CHUNK_WARNING);
2408 break;
2409 # endif
2414 return 0; /* no match */
2417 void /* PRIVATE */
2418 png_icc_set_sRGB(png_const_structrp png_ptr,
2419 png_colorspacerp colorspace, png_const_bytep profile, uLong adler)
2421 /* Is this profile one of the known ICC sRGB profiles? If it is, just set
2422 * the sRGB information.
2424 if (png_compare_ICC_profile_with_sRGB(png_ptr, profile, adler) != 0)
2425 (void)png_colorspace_set_sRGB(png_ptr, colorspace,
2426 (int)/*already checked*/png_get_uint_32(profile+64));
2428 #endif /* PNG_sRGB_PROFILE_CHECKS >= 0 */
2429 #endif /* sRGB */
2431 int /* PRIVATE */
2432 png_colorspace_set_ICC(png_const_structrp png_ptr, png_colorspacerp colorspace,
2433 png_const_charp name, png_uint_32 profile_length, png_const_bytep profile,
2434 int color_type)
2436 if ((colorspace->flags & PNG_COLORSPACE_INVALID) != 0)
2437 return 0;
2439 if (icc_check_length(png_ptr, colorspace, name, profile_length) != 0 &&
2440 png_icc_check_header(png_ptr, colorspace, name, profile_length, profile,
2441 color_type) != 0 &&
2442 png_icc_check_tag_table(png_ptr, colorspace, name, profile_length,
2443 profile) != 0)
2445 # if defined(PNG_sRGB_SUPPORTED) && PNG_sRGB_PROFILE_CHECKS >= 0
2446 /* If no sRGB support, don't try storing sRGB information */
2447 png_icc_set_sRGB(png_ptr, colorspace, profile, 0);
2448 # endif
2449 return 1;
2452 /* Failure case */
2453 return 0;
2455 #endif /* iCCP */
2457 #ifdef PNG_READ_RGB_TO_GRAY_SUPPORTED
2458 void /* PRIVATE */
2459 png_colorspace_set_rgb_coefficients(png_structrp png_ptr)
2461 /* Set the rgb_to_gray coefficients from the colorspace. */
2462 if (png_ptr->rgb_to_gray_coefficients_set == 0 &&
2463 (png_ptr->colorspace.flags & PNG_COLORSPACE_HAVE_ENDPOINTS) != 0)
2465 /* png_set_background has not been called, get the coefficients from the Y
2466 * values of the colorspace colorants.
2468 png_fixed_point r = png_ptr->colorspace.end_points_XYZ.red_Y;
2469 png_fixed_point g = png_ptr->colorspace.end_points_XYZ.green_Y;
2470 png_fixed_point b = png_ptr->colorspace.end_points_XYZ.blue_Y;
2471 png_fixed_point total = r+g+b;
2473 if (total > 0 &&
2474 r >= 0 && png_muldiv(&r, r, 32768, total) && r >= 0 && r <= 32768 &&
2475 g >= 0 && png_muldiv(&g, g, 32768, total) && g >= 0 && g <= 32768 &&
2476 b >= 0 && png_muldiv(&b, b, 32768, total) && b >= 0 && b <= 32768 &&
2477 r+g+b <= 32769)
2479 /* We allow 0 coefficients here. r+g+b may be 32769 if two or
2480 * all of the coefficients were rounded up. Handle this by
2481 * reducing the *largest* coefficient by 1; this matches the
2482 * approach used for the default coefficients in pngrtran.c
2484 int add = 0;
2486 if (r+g+b > 32768)
2487 add = -1;
2488 else if (r+g+b < 32768)
2489 add = 1;
2491 if (add != 0)
2493 if (g >= r && g >= b)
2494 g += add;
2495 else if (r >= g && r >= b)
2496 r += add;
2497 else
2498 b += add;
2501 /* Check for an internal error. */
2502 if (r+g+b != 32768)
2503 png_error(png_ptr,
2504 "internal error handling cHRM coefficients");
2506 else
2508 png_ptr->rgb_to_gray_red_coeff = (png_uint_16)r;
2509 png_ptr->rgb_to_gray_green_coeff = (png_uint_16)g;
2513 /* This is a png_error at present even though it could be ignored -
2514 * it should never happen, but it is important that if it does, the
2515 * bug is fixed.
2517 else
2518 png_error(png_ptr, "internal error handling cHRM->XYZ");
2521 #endif /* READ_RGB_TO_GRAY */
2523 #endif /* COLORSPACE */
2525 #ifdef __GNUC__
2526 /* This exists solely to work round a warning from GNU C. */
2527 static int /* PRIVATE */
2528 png_gt(size_t a, size_t b)
2530 return a > b;
2532 #else
2533 # define png_gt(a,b) ((a) > (b))
2534 #endif
2536 void /* PRIVATE */
2537 png_check_IHDR(png_const_structrp png_ptr,
2538 png_uint_32 width, png_uint_32 height, int bit_depth,
2539 int color_type, int interlace_type, int compression_type,
2540 int filter_type)
2542 int error = 0;
2544 /* Check for width and height valid values */
2545 if (width == 0)
2547 png_warning(png_ptr, "Image width is zero in IHDR");
2548 error = 1;
2551 if (width > PNG_UINT_31_MAX)
2553 png_warning(png_ptr, "Invalid image width in IHDR");
2554 error = 1;
2557 if (png_gt(((width + 7) & (~7U)),
2558 ((PNG_SIZE_MAX
2559 - 48 /* big_row_buf hack */
2560 - 1) /* filter byte */
2561 / 8) /* 8-byte RGBA pixels */
2562 - 1)) /* extra max_pixel_depth pad */
2564 /* The size of the row must be within the limits of this architecture.
2565 * Because the read code can perform arbitrary transformations the
2566 * maximum size is checked here. Because the code in png_read_start_row
2567 * adds extra space "for safety's sake" in several places a conservative
2568 * limit is used here.
2570 * NOTE: it would be far better to check the size that is actually used,
2571 * but the effect in the real world is minor and the changes are more
2572 * extensive, therefore much more dangerous and much more difficult to
2573 * write in a way that avoids compiler warnings.
2575 png_warning(png_ptr, "Image width is too large for this architecture");
2576 error = 1;
2579 #ifdef PNG_SET_USER_LIMITS_SUPPORTED
2580 if (width > png_ptr->user_width_max)
2581 #else
2582 if (width > PNG_USER_WIDTH_MAX)
2583 #endif
2585 png_warning(png_ptr, "Image width exceeds user limit in IHDR");
2586 error = 1;
2589 if (height == 0)
2591 png_warning(png_ptr, "Image height is zero in IHDR");
2592 error = 1;
2595 if (height > PNG_UINT_31_MAX)
2597 png_warning(png_ptr, "Invalid image height in IHDR");
2598 error = 1;
2601 #ifdef PNG_SET_USER_LIMITS_SUPPORTED
2602 if (height > png_ptr->user_height_max)
2603 #else
2604 if (height > PNG_USER_HEIGHT_MAX)
2605 #endif
2607 png_warning(png_ptr, "Image height exceeds user limit in IHDR");
2608 error = 1;
2611 /* Check other values */
2612 if (bit_depth != 1 && bit_depth != 2 && bit_depth != 4 &&
2613 bit_depth != 8 && bit_depth != 16)
2615 png_warning(png_ptr, "Invalid bit depth in IHDR");
2616 error = 1;
2619 if (color_type < 0 || color_type == 1 ||
2620 color_type == 5 || color_type > 6)
2622 png_warning(png_ptr, "Invalid color type in IHDR");
2623 error = 1;
2626 if (((color_type == PNG_COLOR_TYPE_PALETTE) && bit_depth > 8) ||
2627 ((color_type == PNG_COLOR_TYPE_RGB ||
2628 color_type == PNG_COLOR_TYPE_GRAY_ALPHA ||
2629 color_type == PNG_COLOR_TYPE_RGB_ALPHA) && bit_depth < 8))
2631 png_warning(png_ptr, "Invalid color type/bit depth combination in IHDR");
2632 error = 1;
2635 if (interlace_type >= PNG_INTERLACE_LAST)
2637 png_warning(png_ptr, "Unknown interlace method in IHDR");
2638 error = 1;
2641 if (compression_type != PNG_COMPRESSION_TYPE_BASE)
2643 png_warning(png_ptr, "Unknown compression method in IHDR");
2644 error = 1;
2647 #ifdef PNG_MNG_FEATURES_SUPPORTED
2648 /* Accept filter_method 64 (intrapixel differencing) only if
2649 * 1. Libpng was compiled with PNG_MNG_FEATURES_SUPPORTED and
2650 * 2. Libpng did not read a PNG signature (this filter_method is only
2651 * used in PNG datastreams that are embedded in MNG datastreams) and
2652 * 3. The application called png_permit_mng_features with a mask that
2653 * included PNG_FLAG_MNG_FILTER_64 and
2654 * 4. The filter_method is 64 and
2655 * 5. The color_type is RGB or RGBA
2657 if ((png_ptr->mode & PNG_HAVE_PNG_SIGNATURE) != 0 &&
2658 png_ptr->mng_features_permitted != 0)
2659 png_warning(png_ptr, "MNG features are not allowed in a PNG datastream");
2661 if (filter_type != PNG_FILTER_TYPE_BASE)
2663 if (!((png_ptr->mng_features_permitted & PNG_FLAG_MNG_FILTER_64) != 0 &&
2664 (filter_type == PNG_INTRAPIXEL_DIFFERENCING) &&
2665 ((png_ptr->mode & PNG_HAVE_PNG_SIGNATURE) == 0) &&
2666 (color_type == PNG_COLOR_TYPE_RGB ||
2667 color_type == PNG_COLOR_TYPE_RGB_ALPHA)))
2669 png_warning(png_ptr, "Unknown filter method in IHDR");
2670 error = 1;
2673 if ((png_ptr->mode & PNG_HAVE_PNG_SIGNATURE) != 0)
2675 png_warning(png_ptr, "Invalid filter method in IHDR");
2676 error = 1;
2680 #else
2681 if (filter_type != PNG_FILTER_TYPE_BASE)
2683 png_warning(png_ptr, "Unknown filter method in IHDR");
2684 error = 1;
2686 #endif
2688 if (error == 1)
2689 png_error(png_ptr, "Invalid IHDR data");
2692 #if defined(PNG_sCAL_SUPPORTED) || defined(PNG_pCAL_SUPPORTED)
2693 /* ASCII to fp functions */
2694 /* Check an ASCII formated floating point value, see the more detailed
2695 * comments in pngpriv.h
2697 /* The following is used internally to preserve the sticky flags */
2698 #define png_fp_add(state, flags) ((state) |= (flags))
2699 #define png_fp_set(state, value) ((state) = (value) | ((state) & PNG_FP_STICKY))
2701 int /* PRIVATE */
2702 png_check_fp_number(png_const_charp string, png_size_t size, int *statep,
2703 png_size_tp whereami)
2705 int state = *statep;
2706 png_size_t i = *whereami;
2708 while (i < size)
2710 int type;
2711 /* First find the type of the next character */
2712 switch (string[i])
2714 case 43: type = PNG_FP_SAW_SIGN; break;
2715 case 45: type = PNG_FP_SAW_SIGN + PNG_FP_NEGATIVE; break;
2716 case 46: type = PNG_FP_SAW_DOT; break;
2717 case 48: type = PNG_FP_SAW_DIGIT; break;
2718 case 49: case 50: case 51: case 52:
2719 case 53: case 54: case 55: case 56:
2720 case 57: type = PNG_FP_SAW_DIGIT + PNG_FP_NONZERO; break;
2721 case 69:
2722 case 101: type = PNG_FP_SAW_E; break;
2723 default: goto PNG_FP_End;
2726 /* Now deal with this type according to the current
2727 * state, the type is arranged to not overlap the
2728 * bits of the PNG_FP_STATE.
2730 switch ((state & PNG_FP_STATE) + (type & PNG_FP_SAW_ANY))
2732 case PNG_FP_INTEGER + PNG_FP_SAW_SIGN:
2733 if ((state & PNG_FP_SAW_ANY) != 0)
2734 goto PNG_FP_End; /* not a part of the number */
2736 png_fp_add(state, type);
2737 break;
2739 case PNG_FP_INTEGER + PNG_FP_SAW_DOT:
2740 /* Ok as trailer, ok as lead of fraction. */
2741 if ((state & PNG_FP_SAW_DOT) != 0) /* two dots */
2742 goto PNG_FP_End;
2744 else if ((state & PNG_FP_SAW_DIGIT) != 0) /* trailing dot? */
2745 png_fp_add(state, type);
2747 else
2748 png_fp_set(state, PNG_FP_FRACTION | type);
2750 break;
2752 case PNG_FP_INTEGER + PNG_FP_SAW_DIGIT:
2753 if ((state & PNG_FP_SAW_DOT) != 0) /* delayed fraction */
2754 png_fp_set(state, PNG_FP_FRACTION | PNG_FP_SAW_DOT);
2756 png_fp_add(state, type | PNG_FP_WAS_VALID);
2758 break;
2760 case PNG_FP_INTEGER + PNG_FP_SAW_E:
2761 if ((state & PNG_FP_SAW_DIGIT) == 0)
2762 goto PNG_FP_End;
2764 png_fp_set(state, PNG_FP_EXPONENT);
2766 break;
2768 /* case PNG_FP_FRACTION + PNG_FP_SAW_SIGN:
2769 goto PNG_FP_End; ** no sign in fraction */
2771 /* case PNG_FP_FRACTION + PNG_FP_SAW_DOT:
2772 goto PNG_FP_End; ** Because SAW_DOT is always set */
2774 case PNG_FP_FRACTION + PNG_FP_SAW_DIGIT:
2775 png_fp_add(state, type | PNG_FP_WAS_VALID);
2776 break;
2778 case PNG_FP_FRACTION + PNG_FP_SAW_E:
2779 /* This is correct because the trailing '.' on an
2780 * integer is handled above - so we can only get here
2781 * with the sequence ".E" (with no preceding digits).
2783 if ((state & PNG_FP_SAW_DIGIT) == 0)
2784 goto PNG_FP_End;
2786 png_fp_set(state, PNG_FP_EXPONENT);
2788 break;
2790 case PNG_FP_EXPONENT + PNG_FP_SAW_SIGN:
2791 if ((state & PNG_FP_SAW_ANY) != 0)
2792 goto PNG_FP_End; /* not a part of the number */
2794 png_fp_add(state, PNG_FP_SAW_SIGN);
2796 break;
2798 /* case PNG_FP_EXPONENT + PNG_FP_SAW_DOT:
2799 goto PNG_FP_End; */
2801 case PNG_FP_EXPONENT + PNG_FP_SAW_DIGIT:
2802 png_fp_add(state, PNG_FP_SAW_DIGIT | PNG_FP_WAS_VALID);
2804 break;
2806 /* case PNG_FP_EXPONEXT + PNG_FP_SAW_E:
2807 goto PNG_FP_End; */
2809 default: goto PNG_FP_End; /* I.e. break 2 */
2812 /* The character seems ok, continue. */
2813 ++i;
2816 PNG_FP_End:
2817 /* Here at the end, update the state and return the correct
2818 * return code.
2820 *statep = state;
2821 *whereami = i;
2823 return (state & PNG_FP_SAW_DIGIT) != 0;
2827 /* The same but for a complete string. */
2829 png_check_fp_string(png_const_charp string, png_size_t size)
2831 int state=0;
2832 png_size_t char_index=0;
2834 if (png_check_fp_number(string, size, &state, &char_index) != 0 &&
2835 (char_index == size || string[char_index] == 0))
2836 return state /* must be non-zero - see above */;
2838 return 0; /* i.e. fail */
2840 #endif /* pCAL || sCAL */
2842 #ifdef PNG_sCAL_SUPPORTED
2843 # ifdef PNG_FLOATING_POINT_SUPPORTED
2844 /* Utility used below - a simple accurate power of ten from an integral
2845 * exponent.
2847 static double
2848 png_pow10(int power)
2850 int recip = 0;
2851 double d = 1;
2853 /* Handle negative exponent with a reciprocal at the end because
2854 * 10 is exact whereas .1 is inexact in base 2
2856 if (power < 0)
2858 if (power < DBL_MIN_10_EXP) return 0;
2859 recip = 1, power = -power;
2862 if (power > 0)
2864 /* Decompose power bitwise. */
2865 double mult = 10;
2868 if (power & 1) d *= mult;
2869 mult *= mult;
2870 power >>= 1;
2872 while (power > 0);
2874 if (recip != 0) d = 1/d;
2876 /* else power is 0 and d is 1 */
2878 return d;
2881 /* Function to format a floating point value in ASCII with a given
2882 * precision.
2884 void /* PRIVATE */
2885 png_ascii_from_fp(png_const_structrp png_ptr, png_charp ascii, png_size_t size,
2886 double fp, unsigned int precision)
2888 /* We use standard functions from math.h, but not printf because
2889 * that would require stdio. The caller must supply a buffer of
2890 * sufficient size or we will png_error. The tests on size and
2891 * the space in ascii[] consumed are indicated below.
2893 if (precision < 1)
2894 precision = DBL_DIG;
2896 /* Enforce the limit of the implementation precision too. */
2897 if (precision > DBL_DIG+1)
2898 precision = DBL_DIG+1;
2900 /* Basic sanity checks */
2901 if (size >= precision+5) /* See the requirements below. */
2903 if (fp < 0)
2905 fp = -fp;
2906 *ascii++ = 45; /* '-' PLUS 1 TOTAL 1 */
2907 --size;
2910 if (fp >= DBL_MIN && fp <= DBL_MAX)
2912 int exp_b10; /* A base 10 exponent */
2913 double base; /* 10^exp_b10 */
2915 /* First extract a base 10 exponent of the number,
2916 * the calculation below rounds down when converting
2917 * from base 2 to base 10 (multiply by log10(2) -
2918 * 0.3010, but 77/256 is 0.3008, so exp_b10 needs to
2919 * be increased. Note that the arithmetic shift
2920 * performs a floor() unlike C arithmetic - using a
2921 * C multiply would break the following for negative
2922 * exponents.
2924 (void)frexp(fp, &exp_b10); /* exponent to base 2 */
2926 exp_b10 = (exp_b10 * 77) >> 8; /* <= exponent to base 10 */
2928 /* Avoid underflow here. */
2929 base = png_pow10(exp_b10); /* May underflow */
2931 while (base < DBL_MIN || base < fp)
2933 /* And this may overflow. */
2934 double test = png_pow10(exp_b10+1);
2936 if (test <= DBL_MAX)
2937 ++exp_b10, base = test;
2939 else
2940 break;
2943 /* Normalize fp and correct exp_b10, after this fp is in the
2944 * range [.1,1) and exp_b10 is both the exponent and the digit
2945 * *before* which the decimal point should be inserted
2946 * (starting with 0 for the first digit). Note that this
2947 * works even if 10^exp_b10 is out of range because of the
2948 * test on DBL_MAX above.
2950 fp /= base;
2951 while (fp >= 1) fp /= 10, ++exp_b10;
2953 /* Because of the code above fp may, at this point, be
2954 * less than .1, this is ok because the code below can
2955 * handle the leading zeros this generates, so no attempt
2956 * is made to correct that here.
2960 unsigned int czero, clead, cdigits;
2961 char exponent[10];
2963 /* Allow up to two leading zeros - this will not lengthen
2964 * the number compared to using E-n.
2966 if (exp_b10 < 0 && exp_b10 > -3) /* PLUS 3 TOTAL 4 */
2968 czero = (unsigned int)(-exp_b10); /* PLUS 2 digits: TOTAL 3 */
2969 exp_b10 = 0; /* Dot added below before first output. */
2971 else
2972 czero = 0; /* No zeros to add */
2974 /* Generate the digit list, stripping trailing zeros and
2975 * inserting a '.' before a digit if the exponent is 0.
2977 clead = czero; /* Count of leading zeros */
2978 cdigits = 0; /* Count of digits in list. */
2982 double d;
2984 fp *= 10;
2985 /* Use modf here, not floor and subtract, so that
2986 * the separation is done in one step. At the end
2987 * of the loop don't break the number into parts so
2988 * that the final digit is rounded.
2990 if (cdigits+czero+1 < precision+clead)
2991 fp = modf(fp, &d);
2993 else
2995 d = floor(fp + .5);
2997 if (d > 9)
2999 /* Rounding up to 10, handle that here. */
3000 if (czero > 0)
3002 --czero, d = 1;
3003 if (cdigits == 0) --clead;
3005 else
3007 while (cdigits > 0 && d > 9)
3009 int ch = *--ascii;
3011 if (exp_b10 != (-1))
3012 ++exp_b10;
3014 else if (ch == 46)
3016 ch = *--ascii, ++size;
3017 /* Advance exp_b10 to '1', so that the
3018 * decimal point happens after the
3019 * previous digit.
3021 exp_b10 = 1;
3024 --cdigits;
3025 d = ch - 47; /* I.e. 1+(ch-48) */
3028 /* Did we reach the beginning? If so adjust the
3029 * exponent but take into account the leading
3030 * decimal point.
3032 if (d > 9) /* cdigits == 0 */
3034 if (exp_b10 == (-1))
3036 /* Leading decimal point (plus zeros?), if
3037 * we lose the decimal point here it must
3038 * be reentered below.
3040 int ch = *--ascii;
3042 if (ch == 46)
3043 ++size, exp_b10 = 1;
3045 /* Else lost a leading zero, so 'exp_b10' is
3046 * still ok at (-1)
3049 else
3050 ++exp_b10;
3052 /* In all cases we output a '1' */
3053 d = 1;
3057 fp = 0; /* Guarantees termination below. */
3060 if (d == 0)
3062 ++czero;
3063 if (cdigits == 0) ++clead;
3065 else
3067 /* Included embedded zeros in the digit count. */
3068 cdigits += czero - clead;
3069 clead = 0;
3071 while (czero > 0)
3073 /* exp_b10 == (-1) means we just output the decimal
3074 * place - after the DP don't adjust 'exp_b10' any
3075 * more!
3077 if (exp_b10 != (-1))
3079 if (exp_b10 == 0) *ascii++ = 46, --size;
3080 /* PLUS 1: TOTAL 4 */
3081 --exp_b10;
3083 *ascii++ = 48, --czero;
3086 if (exp_b10 != (-1))
3088 if (exp_b10 == 0)
3089 *ascii++ = 46, --size; /* counted above */
3091 --exp_b10;
3093 *ascii++ = (char)(48 + (int)d), ++cdigits;
3096 while (cdigits+czero < precision+clead && fp > DBL_MIN);
3098 /* The total output count (max) is now 4+precision */
3100 /* Check for an exponent, if we don't need one we are
3101 * done and just need to terminate the string. At
3102 * this point exp_b10==(-1) is effectively if flag - it got
3103 * to '-1' because of the decrement after outputting
3104 * the decimal point above (the exponent required is
3105 * *not* -1!)
3107 if (exp_b10 >= (-1) && exp_b10 <= 2)
3109 /* The following only happens if we didn't output the
3110 * leading zeros above for negative exponent, so this
3111 * doesn't add to the digit requirement. Note that the
3112 * two zeros here can only be output if the two leading
3113 * zeros were *not* output, so this doesn't increase
3114 * the output count.
3116 while (--exp_b10 >= 0) *ascii++ = 48;
3118 *ascii = 0;
3120 /* Total buffer requirement (including the '\0') is
3121 * 5+precision - see check at the start.
3123 return;
3126 /* Here if an exponent is required, adjust size for
3127 * the digits we output but did not count. The total
3128 * digit output here so far is at most 1+precision - no
3129 * decimal point and no leading or trailing zeros have
3130 * been output.
3132 size -= cdigits;
3134 *ascii++ = 69, --size; /* 'E': PLUS 1 TOTAL 2+precision */
3136 /* The following use of an unsigned temporary avoids ambiguities in
3137 * the signed arithmetic on exp_b10 and permits GCC at least to do
3138 * better optimization.
3141 unsigned int uexp_b10;
3143 if (exp_b10 < 0)
3145 *ascii++ = 45, --size; /* '-': PLUS 1 TOTAL 3+precision */
3146 uexp_b10 = (unsigned int)(-exp_b10);
3149 else
3150 uexp_b10 = (unsigned int)exp_b10;
3152 cdigits = 0;
3154 while (uexp_b10 > 0)
3156 exponent[cdigits++] = (char)(48 + uexp_b10 % 10);
3157 uexp_b10 /= 10;
3161 /* Need another size check here for the exponent digits, so
3162 * this need not be considered above.
3164 if (size > cdigits)
3166 while (cdigits > 0) *ascii++ = exponent[--cdigits];
3168 *ascii = 0;
3170 return;
3174 else if (!(fp >= DBL_MIN))
3176 *ascii++ = 48; /* '0' */
3177 *ascii = 0;
3178 return;
3180 else
3182 *ascii++ = 105; /* 'i' */
3183 *ascii++ = 110; /* 'n' */
3184 *ascii++ = 102; /* 'f' */
3185 *ascii = 0;
3186 return;
3190 /* Here on buffer too small. */
3191 png_error(png_ptr, "ASCII conversion buffer too small");
3194 # endif /* FLOATING_POINT */
3196 # ifdef PNG_FIXED_POINT_SUPPORTED
3197 /* Function to format a fixed point value in ASCII.
3199 void /* PRIVATE */
3200 png_ascii_from_fixed(png_const_structrp png_ptr, png_charp ascii,
3201 png_size_t size, png_fixed_point fp)
3203 /* Require space for 10 decimal digits, a decimal point, a minus sign and a
3204 * trailing \0, 13 characters:
3206 if (size > 12)
3208 png_uint_32 num;
3210 /* Avoid overflow here on the minimum integer. */
3211 if (fp < 0)
3212 *ascii++ = 45, num = (png_uint_32)(-fp);
3213 else
3214 num = (png_uint_32)fp;
3216 if (num <= 0x80000000) /* else overflowed */
3218 unsigned int ndigits = 0, first = 16 /* flag value */;
3219 char digits[10];
3221 while (num)
3223 /* Split the low digit off num: */
3224 unsigned int tmp = num/10;
3225 num -= tmp*10;
3226 digits[ndigits++] = (char)(48 + num);
3227 /* Record the first non-zero digit, note that this is a number
3228 * starting at 1, it's not actually the array index.
3230 if (first == 16 && num > 0)
3231 first = ndigits;
3232 num = tmp;
3235 if (ndigits > 0)
3237 while (ndigits > 5) *ascii++ = digits[--ndigits];
3238 /* The remaining digits are fractional digits, ndigits is '5' or
3239 * smaller at this point. It is certainly not zero. Check for a
3240 * non-zero fractional digit:
3242 if (first <= 5)
3244 unsigned int i;
3245 *ascii++ = 46; /* decimal point */
3246 /* ndigits may be <5 for small numbers, output leading zeros
3247 * then ndigits digits to first:
3249 i = 5;
3250 while (ndigits < i) *ascii++ = 48, --i;
3251 while (ndigits >= first) *ascii++ = digits[--ndigits];
3252 /* Don't output the trailing zeros! */
3255 else
3256 *ascii++ = 48;
3258 /* And null terminate the string: */
3259 *ascii = 0;
3260 return;
3264 /* Here on buffer too small. */
3265 png_error(png_ptr, "ASCII conversion buffer too small");
3267 # endif /* FIXED_POINT */
3268 #endif /* SCAL */
3270 #if defined(PNG_FLOATING_POINT_SUPPORTED) && \
3271 !defined(PNG_FIXED_POINT_MACRO_SUPPORTED) && \
3272 (defined(PNG_gAMA_SUPPORTED) || defined(PNG_cHRM_SUPPORTED) || \
3273 defined(PNG_sCAL_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED) || \
3274 defined(PNG_READ_RGB_TO_GRAY_SUPPORTED)) || \
3275 (defined(PNG_sCAL_SUPPORTED) && \
3276 defined(PNG_FLOATING_ARITHMETIC_SUPPORTED))
3277 png_fixed_point
3278 png_fixed(png_const_structrp png_ptr, double fp, png_const_charp text)
3280 double r = floor(100000 * fp + .5);
3282 if (r > 2147483647. || r < -2147483648.)
3283 png_fixed_error(png_ptr, text);
3285 # ifndef PNG_ERROR_TEXT_SUPPORTED
3286 PNG_UNUSED(text)
3287 # endif
3289 return (png_fixed_point)r;
3291 #endif
3293 #if defined(PNG_GAMMA_SUPPORTED) || defined(PNG_COLORSPACE_SUPPORTED) ||\
3294 defined(PNG_INCH_CONVERSIONS_SUPPORTED) || defined(PNG_READ_pHYs_SUPPORTED)
3295 /* muldiv functions */
3296 /* This API takes signed arguments and rounds the result to the nearest
3297 * integer (or, for a fixed point number - the standard argument - to
3298 * the nearest .00001). Overflow and divide by zero are signalled in
3299 * the result, a boolean - true on success, false on overflow.
3302 png_muldiv(png_fixed_point_p res, png_fixed_point a, png_int_32 times,
3303 png_int_32 divisor)
3305 /* Return a * times / divisor, rounded. */
3306 if (divisor != 0)
3308 if (a == 0 || times == 0)
3310 *res = 0;
3311 return 1;
3313 else
3315 #ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
3316 double r = a;
3317 r *= times;
3318 r /= divisor;
3319 r = floor(r+.5);
3321 /* A png_fixed_point is a 32-bit integer. */
3322 if (r <= 2147483647. && r >= -2147483648.)
3324 *res = (png_fixed_point)r;
3325 return 1;
3327 #else
3328 int negative = 0;
3329 png_uint_32 A, T, D;
3330 png_uint_32 s16, s32, s00;
3332 if (a < 0)
3333 negative = 1, A = -a;
3334 else
3335 A = a;
3337 if (times < 0)
3338 negative = !negative, T = -times;
3339 else
3340 T = times;
3342 if (divisor < 0)
3343 negative = !negative, D = -divisor;
3344 else
3345 D = divisor;
3347 /* Following can't overflow because the arguments only
3348 * have 31 bits each, however the result may be 32 bits.
3350 s16 = (A >> 16) * (T & 0xffff) +
3351 (A & 0xffff) * (T >> 16);
3352 /* Can't overflow because the a*times bit is only 30
3353 * bits at most.
3355 s32 = (A >> 16) * (T >> 16) + (s16 >> 16);
3356 s00 = (A & 0xffff) * (T & 0xffff);
3358 s16 = (s16 & 0xffff) << 16;
3359 s00 += s16;
3361 if (s00 < s16)
3362 ++s32; /* carry */
3364 if (s32 < D) /* else overflow */
3366 /* s32.s00 is now the 64-bit product, do a standard
3367 * division, we know that s32 < D, so the maximum
3368 * required shift is 31.
3370 int bitshift = 32;
3371 png_fixed_point result = 0; /* NOTE: signed */
3373 while (--bitshift >= 0)
3375 png_uint_32 d32, d00;
3377 if (bitshift > 0)
3378 d32 = D >> (32-bitshift), d00 = D << bitshift;
3380 else
3381 d32 = 0, d00 = D;
3383 if (s32 > d32)
3385 if (s00 < d00) --s32; /* carry */
3386 s32 -= d32, s00 -= d00, result += 1<<bitshift;
3389 else
3390 if (s32 == d32 && s00 >= d00)
3391 s32 = 0, s00 -= d00, result += 1<<bitshift;
3394 /* Handle the rounding. */
3395 if (s00 >= (D >> 1))
3396 ++result;
3398 if (negative != 0)
3399 result = -result;
3401 /* Check for overflow. */
3402 if ((negative != 0 && result <= 0) ||
3403 (negative == 0 && result >= 0))
3405 *res = result;
3406 return 1;
3409 #endif
3413 return 0;
3415 #endif /* READ_GAMMA || INCH_CONVERSIONS */
3417 #if defined(PNG_READ_GAMMA_SUPPORTED) || defined(PNG_INCH_CONVERSIONS_SUPPORTED)
3418 /* The following is for when the caller doesn't much care about the
3419 * result.
3421 png_fixed_point
3422 png_muldiv_warn(png_const_structrp png_ptr, png_fixed_point a, png_int_32 times,
3423 png_int_32 divisor)
3425 png_fixed_point result;
3427 if (png_muldiv(&result, a, times, divisor) != 0)
3428 return result;
3430 png_warning(png_ptr, "fixed point overflow ignored");
3431 return 0;
3433 #endif
3435 #ifdef PNG_GAMMA_SUPPORTED /* more fixed point functions for gamma */
3436 /* Calculate a reciprocal, return 0 on div-by-zero or overflow. */
3437 png_fixed_point
3438 png_reciprocal(png_fixed_point a)
3440 #ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
3441 double r = floor(1E10/a+.5);
3443 if (r <= 2147483647. && r >= -2147483648.)
3444 return (png_fixed_point)r;
3445 #else
3446 png_fixed_point res;
3448 if (png_muldiv(&res, 100000, 100000, a) != 0)
3449 return res;
3450 #endif
3452 return 0; /* error/overflow */
3455 /* This is the shared test on whether a gamma value is 'significant' - whether
3456 * it is worth doing gamma correction.
3458 int /* PRIVATE */
3459 png_gamma_significant(png_fixed_point gamma_val)
3461 return gamma_val < PNG_FP_1 - PNG_GAMMA_THRESHOLD_FIXED ||
3462 gamma_val > PNG_FP_1 + PNG_GAMMA_THRESHOLD_FIXED;
3464 #endif
3466 #ifdef PNG_READ_GAMMA_SUPPORTED
3467 #ifdef PNG_16BIT_SUPPORTED
3468 /* A local convenience routine. */
3469 static png_fixed_point
3470 png_product2(png_fixed_point a, png_fixed_point b)
3472 /* The required result is 1/a * 1/b; the following preserves accuracy. */
3473 #ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
3474 double r = a * 1E-5;
3475 r *= b;
3476 r = floor(r+.5);
3478 if (r <= 2147483647. && r >= -2147483648.)
3479 return (png_fixed_point)r;
3480 #else
3481 png_fixed_point res;
3483 if (png_muldiv(&res, a, b, 100000) != 0)
3484 return res;
3485 #endif
3487 return 0; /* overflow */
3489 #endif /* 16BIT */
3491 /* The inverse of the above. */
3492 png_fixed_point
3493 png_reciprocal2(png_fixed_point a, png_fixed_point b)
3495 /* The required result is 1/a * 1/b; the following preserves accuracy. */
3496 #ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
3497 if (a != 0 && b != 0)
3499 double r = 1E15/a;
3500 r /= b;
3501 r = floor(r+.5);
3503 if (r <= 2147483647. && r >= -2147483648.)
3504 return (png_fixed_point)r;
3506 #else
3507 /* This may overflow because the range of png_fixed_point isn't symmetric,
3508 * but this API is only used for the product of file and screen gamma so it
3509 * doesn't matter that the smallest number it can produce is 1/21474, not
3510 * 1/100000
3512 png_fixed_point res = png_product2(a, b);
3514 if (res != 0)
3515 return png_reciprocal(res);
3516 #endif
3518 return 0; /* overflow */
3520 #endif /* READ_GAMMA */
3522 #ifdef PNG_READ_GAMMA_SUPPORTED /* gamma table code */
3523 #ifndef PNG_FLOATING_ARITHMETIC_SUPPORTED
3524 /* Fixed point gamma.
3526 * The code to calculate the tables used below can be found in the shell script
3527 * contrib/tools/intgamma.sh
3529 * To calculate gamma this code implements fast log() and exp() calls using only
3530 * fixed point arithmetic. This code has sufficient precision for either 8-bit
3531 * or 16-bit sample values.
3533 * The tables used here were calculated using simple 'bc' programs, but C double
3534 * precision floating point arithmetic would work fine.
3536 * 8-bit log table
3537 * This is a table of -log(value/255)/log(2) for 'value' in the range 128 to
3538 * 255, so it's the base 2 logarithm of a normalized 8-bit floating point
3539 * mantissa. The numbers are 32-bit fractions.
3541 static const png_uint_32
3542 png_8bit_l2[128] =
3544 4270715492U, 4222494797U, 4174646467U, 4127164793U, 4080044201U, 4033279239U,
3545 3986864580U, 3940795015U, 3895065449U, 3849670902U, 3804606499U, 3759867474U,
3546 3715449162U, 3671346997U, 3627556511U, 3584073329U, 3540893168U, 3498011834U,
3547 3455425220U, 3413129301U, 3371120137U, 3329393864U, 3287946700U, 3246774933U,
3548 3205874930U, 3165243125U, 3124876025U, 3084770202U, 3044922296U, 3005329011U,
3549 2965987113U, 2926893432U, 2888044853U, 2849438323U, 2811070844U, 2772939474U,
3550 2735041326U, 2697373562U, 2659933400U, 2622718104U, 2585724991U, 2548951424U,
3551 2512394810U, 2476052606U, 2439922311U, 2404001468U, 2368287663U, 2332778523U,
3552 2297471715U, 2262364947U, 2227455964U, 2192742551U, 2158222529U, 2123893754U,
3553 2089754119U, 2055801552U, 2022034013U, 1988449497U, 1955046031U, 1921821672U,
3554 1888774511U, 1855902668U, 1823204291U, 1790677560U, 1758320682U, 1726131893U,
3555 1694109454U, 1662251657U, 1630556815U, 1599023271U, 1567649391U, 1536433567U,
3556 1505374214U, 1474469770U, 1443718700U, 1413119487U, 1382670639U, 1352370686U,
3557 1322218179U, 1292211689U, 1262349810U, 1232631153U, 1203054352U, 1173618059U,
3558 1144320946U, 1115161701U, 1086139034U, 1057251672U, 1028498358U, 999877854U,
3559 971388940U, 943030410U, 914801076U, 886699767U, 858725327U, 830876614U,
3560 803152505U, 775551890U, 748073672U, 720716771U, 693480120U, 666362667U,
3561 639363374U, 612481215U, 585715177U, 559064263U, 532527486U, 506103872U,
3562 479792461U, 453592303U, 427502463U, 401522014U, 375650043U, 349885648U,
3563 324227938U, 298676034U, 273229066U, 247886176U, 222646516U, 197509248U,
3564 172473545U, 147538590U, 122703574U, 97967701U, 73330182U, 48790236U,
3565 24347096U, 0U
3567 #if 0
3568 /* The following are the values for 16-bit tables - these work fine for the
3569 * 8-bit conversions but produce very slightly larger errors in the 16-bit
3570 * log (about 1.2 as opposed to 0.7 absolute error in the final value). To
3571 * use these all the shifts below must be adjusted appropriately.
3573 65166, 64430, 63700, 62976, 62257, 61543, 60835, 60132, 59434, 58741, 58054,
3574 57371, 56693, 56020, 55352, 54689, 54030, 53375, 52726, 52080, 51439, 50803,
3575 50170, 49542, 48918, 48298, 47682, 47070, 46462, 45858, 45257, 44661, 44068,
3576 43479, 42894, 42312, 41733, 41159, 40587, 40020, 39455, 38894, 38336, 37782,
3577 37230, 36682, 36137, 35595, 35057, 34521, 33988, 33459, 32932, 32408, 31887,
3578 31369, 30854, 30341, 29832, 29325, 28820, 28319, 27820, 27324, 26830, 26339,
3579 25850, 25364, 24880, 24399, 23920, 23444, 22970, 22499, 22029, 21562, 21098,
3580 20636, 20175, 19718, 19262, 18808, 18357, 17908, 17461, 17016, 16573, 16132,
3581 15694, 15257, 14822, 14390, 13959, 13530, 13103, 12678, 12255, 11834, 11415,
3582 10997, 10582, 10168, 9756, 9346, 8937, 8531, 8126, 7723, 7321, 6921, 6523,
3583 6127, 5732, 5339, 4947, 4557, 4169, 3782, 3397, 3014, 2632, 2251, 1872, 1495,
3584 1119, 744, 372
3585 #endif
3588 static png_int_32
3589 png_log8bit(unsigned int x)
3591 unsigned int lg2 = 0;
3592 /* Each time 'x' is multiplied by 2, 1 must be subtracted off the final log,
3593 * because the log is actually negate that means adding 1. The final
3594 * returned value thus has the range 0 (for 255 input) to 7.994 (for 1
3595 * input), return -1 for the overflow (log 0) case, - so the result is
3596 * always at most 19 bits.
3598 if ((x &= 0xff) == 0)
3599 return -1;
3601 if ((x & 0xf0) == 0)
3602 lg2 = 4, x <<= 4;
3604 if ((x & 0xc0) == 0)
3605 lg2 += 2, x <<= 2;
3607 if ((x & 0x80) == 0)
3608 lg2 += 1, x <<= 1;
3610 /* result is at most 19 bits, so this cast is safe: */
3611 return (png_int_32)((lg2 << 16) + ((png_8bit_l2[x-128]+32768)>>16));
3614 /* The above gives exact (to 16 binary places) log2 values for 8-bit images,
3615 * for 16-bit images we use the most significant 8 bits of the 16-bit value to
3616 * get an approximation then multiply the approximation by a correction factor
3617 * determined by the remaining up to 8 bits. This requires an additional step
3618 * in the 16-bit case.
3620 * We want log2(value/65535), we have log2(v'/255), where:
3622 * value = v' * 256 + v''
3623 * = v' * f
3625 * So f is value/v', which is equal to (256+v''/v') since v' is in the range 128
3626 * to 255 and v'' is in the range 0 to 255 f will be in the range 256 to less
3627 * than 258. The final factor also needs to correct for the fact that our 8-bit
3628 * value is scaled by 255, whereas the 16-bit values must be scaled by 65535.
3630 * This gives a final formula using a calculated value 'x' which is value/v' and
3631 * scaling by 65536 to match the above table:
3633 * log2(x/257) * 65536
3635 * Since these numbers are so close to '1' we can use simple linear
3636 * interpolation between the two end values 256/257 (result -368.61) and 258/257
3637 * (result 367.179). The values used below are scaled by a further 64 to give
3638 * 16-bit precision in the interpolation:
3640 * Start (256): -23591
3641 * Zero (257): 0
3642 * End (258): 23499
3644 #ifdef PNG_16BIT_SUPPORTED
3645 static png_int_32
3646 png_log16bit(png_uint_32 x)
3648 unsigned int lg2 = 0;
3650 /* As above, but now the input has 16 bits. */
3651 if ((x &= 0xffff) == 0)
3652 return -1;
3654 if ((x & 0xff00) == 0)
3655 lg2 = 8, x <<= 8;
3657 if ((x & 0xf000) == 0)
3658 lg2 += 4, x <<= 4;
3660 if ((x & 0xc000) == 0)
3661 lg2 += 2, x <<= 2;
3663 if ((x & 0x8000) == 0)
3664 lg2 += 1, x <<= 1;
3666 /* Calculate the base logarithm from the top 8 bits as a 28-bit fractional
3667 * value.
3669 lg2 <<= 28;
3670 lg2 += (png_8bit_l2[(x>>8)-128]+8) >> 4;
3672 /* Now we need to interpolate the factor, this requires a division by the top
3673 * 8 bits. Do this with maximum precision.
3675 x = ((x << 16) + (x >> 9)) / (x >> 8);
3677 /* Since we divided by the top 8 bits of 'x' there will be a '1' at 1<<24,
3678 * the value at 1<<16 (ignoring this) will be 0 or 1; this gives us exactly
3679 * 16 bits to interpolate to get the low bits of the result. Round the
3680 * answer. Note that the end point values are scaled by 64 to retain overall
3681 * precision and that 'lg2' is current scaled by an extra 12 bits, so adjust
3682 * the overall scaling by 6-12. Round at every step.
3684 x -= 1U << 24;
3686 if (x <= 65536U) /* <= '257' */
3687 lg2 += ((23591U * (65536U-x)) + (1U << (16+6-12-1))) >> (16+6-12);
3689 else
3690 lg2 -= ((23499U * (x-65536U)) + (1U << (16+6-12-1))) >> (16+6-12);
3692 /* Safe, because the result can't have more than 20 bits: */
3693 return (png_int_32)((lg2 + 2048) >> 12);
3695 #endif /* 16BIT */
3697 /* The 'exp()' case must invert the above, taking a 20-bit fixed point
3698 * logarithmic value and returning a 16 or 8-bit number as appropriate. In
3699 * each case only the low 16 bits are relevant - the fraction - since the
3700 * integer bits (the top 4) simply determine a shift.
3702 * The worst case is the 16-bit distinction between 65535 and 65534. This
3703 * requires perhaps spurious accuracy in the decoding of the logarithm to
3704 * distinguish log2(65535/65534.5) - 10^-5 or 17 bits. There is little chance
3705 * of getting this accuracy in practice.
3707 * To deal with this the following exp() function works out the exponent of the
3708 * frational part of the logarithm by using an accurate 32-bit value from the
3709 * top four fractional bits then multiplying in the remaining bits.
3711 static const png_uint_32
3712 png_32bit_exp[16] =
3714 /* NOTE: the first entry is deliberately set to the maximum 32-bit value. */
3715 4294967295U, 4112874773U, 3938502376U, 3771522796U, 3611622603U, 3458501653U,
3716 3311872529U, 3171459999U, 3037000500U, 2908241642U, 2784941738U, 2666869345U,
3717 2553802834U, 2445529972U, 2341847524U, 2242560872U
3720 /* Adjustment table; provided to explain the numbers in the code below. */
3721 #if 0
3722 for (i=11;i>=0;--i){ print i, " ", (1 - e(-(2^i)/65536*l(2))) * 2^(32-i), "\n"}
3723 11 44937.64284865548751208448
3724 10 45180.98734845585101160448
3725 9 45303.31936980687359311872
3726 8 45364.65110595323018870784
3727 7 45395.35850361789624614912
3728 6 45410.72259715102037508096
3729 5 45418.40724413220722311168
3730 4 45422.25021786898173001728
3731 3 45424.17186732298419044352
3732 2 45425.13273269940811464704
3733 1 45425.61317555035558641664
3734 0 45425.85339951654943850496
3735 #endif
3737 static png_uint_32
3738 png_exp(png_fixed_point x)
3740 if (x > 0 && x <= 0xfffff) /* Else overflow or zero (underflow) */
3742 /* Obtain a 4-bit approximation */
3743 png_uint_32 e = png_32bit_exp[(x >> 12) & 0x0f];
3745 /* Incorporate the low 12 bits - these decrease the returned value by
3746 * multiplying by a number less than 1 if the bit is set. The multiplier
3747 * is determined by the above table and the shift. Notice that the values
3748 * converge on 45426 and this is used to allow linear interpolation of the
3749 * low bits.
3751 if (x & 0x800)
3752 e -= (((e >> 16) * 44938U) + 16U) >> 5;
3754 if (x & 0x400)
3755 e -= (((e >> 16) * 45181U) + 32U) >> 6;
3757 if (x & 0x200)
3758 e -= (((e >> 16) * 45303U) + 64U) >> 7;
3760 if (x & 0x100)
3761 e -= (((e >> 16) * 45365U) + 128U) >> 8;
3763 if (x & 0x080)
3764 e -= (((e >> 16) * 45395U) + 256U) >> 9;
3766 if (x & 0x040)
3767 e -= (((e >> 16) * 45410U) + 512U) >> 10;
3769 /* And handle the low 6 bits in a single block. */
3770 e -= (((e >> 16) * 355U * (x & 0x3fU)) + 256U) >> 9;
3772 /* Handle the upper bits of x. */
3773 e >>= x >> 16;
3774 return e;
3777 /* Check for overflow */
3778 if (x <= 0)
3779 return png_32bit_exp[0];
3781 /* Else underflow */
3782 return 0;
3785 static png_byte
3786 png_exp8bit(png_fixed_point lg2)
3788 /* Get a 32-bit value: */
3789 png_uint_32 x = png_exp(lg2);
3791 /* Convert the 32-bit value to 0..255 by multiplying by 256-1. Note that the
3792 * second, rounding, step can't overflow because of the first, subtraction,
3793 * step.
3795 x -= x >> 8;
3796 return (png_byte)(((x + 0x7fffffU) >> 24) & 0xff);
3799 #ifdef PNG_16BIT_SUPPORTED
3800 static png_uint_16
3801 png_exp16bit(png_fixed_point lg2)
3803 /* Get a 32-bit value: */
3804 png_uint_32 x = png_exp(lg2);
3806 /* Convert the 32-bit value to 0..65535 by multiplying by 65536-1: */
3807 x -= x >> 16;
3808 return (png_uint_16)((x + 32767U) >> 16);
3810 #endif /* 16BIT */
3811 #endif /* FLOATING_ARITHMETIC */
3813 png_byte
3814 png_gamma_8bit_correct(unsigned int value, png_fixed_point gamma_val)
3816 if (value > 0 && value < 255)
3818 # ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
3819 /* 'value' is unsigned, ANSI-C90 requires the compiler to correctly
3820 * convert this to a floating point value. This includes values that
3821 * would overflow if 'value' were to be converted to 'int'.
3823 * Apparently GCC, however, does an intermediate conversion to (int)
3824 * on some (ARM) but not all (x86) platforms, possibly because of
3825 * hardware FP limitations. (E.g. if the hardware conversion always
3826 * assumes the integer register contains a signed value.) This results
3827 * in ANSI-C undefined behavior for large values.
3829 * Other implementations on the same machine might actually be ANSI-C90
3830 * conformant and therefore compile spurious extra code for the large
3831 * values.
3833 * We can be reasonably sure that an unsigned to float conversion
3834 * won't be faster than an int to float one. Therefore this code
3835 * assumes responsibility for the undefined behavior, which it knows
3836 * can't happen because of the check above.
3838 * Note the argument to this routine is an (unsigned int) because, on
3839 * 16-bit platforms, it is assigned a value which might be out of
3840 * range for an (int); that would result in undefined behavior in the
3841 * caller if the *argument* ('value') were to be declared (int).
3843 double r = floor(255*pow((int)/*SAFE*/value/255.,gamma_val*.00001)+.5);
3844 return (png_byte)r;
3845 # else
3846 png_int_32 lg2 = png_log8bit(value);
3847 png_fixed_point res;
3849 if (png_muldiv(&res, gamma_val, lg2, PNG_FP_1) != 0)
3850 return png_exp8bit(res);
3852 /* Overflow. */
3853 value = 0;
3854 # endif
3857 return (png_byte)(value & 0xff);
3860 #ifdef PNG_16BIT_SUPPORTED
3861 png_uint_16
3862 png_gamma_16bit_correct(unsigned int value, png_fixed_point gamma_val)
3864 if (value > 0 && value < 65535)
3866 # ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
3867 /* The same (unsigned int)->(double) constraints apply here as above,
3868 * however in this case the (unsigned int) to (int) conversion can
3869 * overflow on an ANSI-C90 compliant system so the cast needs to ensure
3870 * that this is not possible.
3872 double r = floor(65535*pow((png_int_32)value/65535.,
3873 gamma_val*.00001)+.5);
3874 return (png_uint_16)r;
3875 # else
3876 png_int_32 lg2 = png_log16bit(value);
3877 png_fixed_point res;
3879 if (png_muldiv(&res, gamma_val, lg2, PNG_FP_1) != 0)
3880 return png_exp16bit(res);
3882 /* Overflow. */
3883 value = 0;
3884 # endif
3887 return (png_uint_16)value;
3889 #endif /* 16BIT */
3891 /* This does the right thing based on the bit_depth field of the
3892 * png_struct, interpreting values as 8-bit or 16-bit. While the result
3893 * is nominally a 16-bit value if bit depth is 8 then the result is
3894 * 8-bit (as are the arguments.)
3896 png_uint_16 /* PRIVATE */
3897 png_gamma_correct(png_structrp png_ptr, unsigned int value,
3898 png_fixed_point gamma_val)
3900 if (png_ptr->bit_depth == 8)
3901 return png_gamma_8bit_correct(value, gamma_val);
3903 #ifdef PNG_16BIT_SUPPORTED
3904 else
3905 return png_gamma_16bit_correct(value, gamma_val);
3906 #else
3907 /* should not reach this */
3908 return 0;
3909 #endif /* 16BIT */
3912 #ifdef PNG_16BIT_SUPPORTED
3913 /* Internal function to build a single 16-bit table - the table consists of
3914 * 'num' 256 entry subtables, where 'num' is determined by 'shift' - the amount
3915 * to shift the input values right (or 16-number_of_signifiant_bits).
3917 * The caller is responsible for ensuring that the table gets cleaned up on
3918 * png_error (i.e. if one of the mallocs below fails) - i.e. the *table argument
3919 * should be somewhere that will be cleaned.
3921 static void
3922 png_build_16bit_table(png_structrp png_ptr, png_uint_16pp *ptable,
3923 PNG_CONST unsigned int shift, PNG_CONST png_fixed_point gamma_val)
3925 /* Various values derived from 'shift': */
3926 PNG_CONST unsigned int num = 1U << (8U - shift);
3927 #ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
3928 /* CSE the division and work round wacky GCC warnings (see the comments
3929 * in png_gamma_8bit_correct for where these come from.)
3931 PNG_CONST double fmax = 1./(((png_int_32)1 << (16U - shift))-1);
3932 #endif
3933 PNG_CONST unsigned int max = (1U << (16U - shift))-1U;
3934 PNG_CONST unsigned int max_by_2 = 1U << (15U-shift);
3935 unsigned int i;
3937 png_uint_16pp table = *ptable =
3938 (png_uint_16pp)png_calloc(png_ptr, num * (sizeof (png_uint_16p)));
3940 for (i = 0; i < num; i++)
3942 png_uint_16p sub_table = table[i] =
3943 (png_uint_16p)png_malloc(png_ptr, 256 * (sizeof (png_uint_16)));
3945 /* The 'threshold' test is repeated here because it can arise for one of
3946 * the 16-bit tables even if the others don't hit it.
3948 if (png_gamma_significant(gamma_val) != 0)
3950 /* The old code would overflow at the end and this would cause the
3951 * 'pow' function to return a result >1, resulting in an
3952 * arithmetic error. This code follows the spec exactly; ig is
3953 * the recovered input sample, it always has 8-16 bits.
3955 * We want input * 65535/max, rounded, the arithmetic fits in 32
3956 * bits (unsigned) so long as max <= 32767.
3958 unsigned int j;
3959 for (j = 0; j < 256; j++)
3961 png_uint_32 ig = (j << (8-shift)) + i;
3962 # ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
3963 /* Inline the 'max' scaling operation: */
3964 /* See png_gamma_8bit_correct for why the cast to (int) is
3965 * required here.
3967 double d = floor(65535.*pow(ig*fmax, gamma_val*.00001)+.5);
3968 sub_table[j] = (png_uint_16)d;
3969 # else
3970 if (shift != 0)
3971 ig = (ig * 65535U + max_by_2)/max;
3973 sub_table[j] = png_gamma_16bit_correct(ig, gamma_val);
3974 # endif
3977 else
3979 /* We must still build a table, but do it the fast way. */
3980 unsigned int j;
3982 for (j = 0; j < 256; j++)
3984 png_uint_32 ig = (j << (8-shift)) + i;
3986 if (shift != 0)
3987 ig = (ig * 65535U + max_by_2)/max;
3989 sub_table[j] = (png_uint_16)ig;
3995 /* NOTE: this function expects the *inverse* of the overall gamma transformation
3996 * required.
3998 static void
3999 png_build_16to8_table(png_structrp png_ptr, png_uint_16pp *ptable,
4000 PNG_CONST unsigned int shift, PNG_CONST png_fixed_point gamma_val)
4002 PNG_CONST unsigned int num = 1U << (8U - shift);
4003 PNG_CONST unsigned int max = (1U << (16U - shift))-1U;
4004 unsigned int i;
4005 png_uint_32 last;
4007 png_uint_16pp table = *ptable =
4008 (png_uint_16pp)png_calloc(png_ptr, num * (sizeof (png_uint_16p)));
4010 /* 'num' is the number of tables and also the number of low bits of low
4011 * bits of the input 16-bit value used to select a table. Each table is
4012 * itself indexed by the high 8 bits of the value.
4014 for (i = 0; i < num; i++)
4015 table[i] = (png_uint_16p)png_malloc(png_ptr,
4016 256 * (sizeof (png_uint_16)));
4018 /* 'gamma_val' is set to the reciprocal of the value calculated above, so
4019 * pow(out,g) is an *input* value. 'last' is the last input value set.
4021 * In the loop 'i' is used to find output values. Since the output is
4022 * 8-bit there are only 256 possible values. The tables are set up to
4023 * select the closest possible output value for each input by finding
4024 * the input value at the boundary between each pair of output values
4025 * and filling the table up to that boundary with the lower output
4026 * value.
4028 * The boundary values are 0.5,1.5..253.5,254.5. Since these are 9-bit
4029 * values the code below uses a 16-bit value in i; the values start at
4030 * 128.5 (for 0.5) and step by 257, for a total of 254 values (the last
4031 * entries are filled with 255). Start i at 128 and fill all 'last'
4032 * table entries <= 'max'
4034 last = 0;
4035 for (i = 0; i < 255; ++i) /* 8-bit output value */
4037 /* Find the corresponding maximum input value */
4038 png_uint_16 out = (png_uint_16)(i * 257U); /* 16-bit output value */
4040 /* Find the boundary value in 16 bits: */
4041 png_uint_32 bound = png_gamma_16bit_correct(out+128U, gamma_val);
4043 /* Adjust (round) to (16-shift) bits: */
4044 bound = (bound * max + 32768U)/65535U + 1U;
4046 while (last < bound)
4048 table[last & (0xffU >> shift)][last >> (8U - shift)] = out;
4049 last++;
4053 /* And fill in the final entries. */
4054 while (last < (num << 8))
4056 table[last & (0xff >> shift)][last >> (8U - shift)] = 65535U;
4057 last++;
4060 #endif /* 16BIT */
4062 /* Build a single 8-bit table: same as the 16-bit case but much simpler (and
4063 * typically much faster). Note that libpng currently does no sBIT processing
4064 * (apparently contrary to the spec) so a 256-entry table is always generated.
4066 static void
4067 png_build_8bit_table(png_structrp png_ptr, png_bytepp ptable,
4068 PNG_CONST png_fixed_point gamma_val)
4070 unsigned int i;
4071 png_bytep table = *ptable = (png_bytep)png_malloc(png_ptr, 256);
4073 if (png_gamma_significant(gamma_val) != 0)
4074 for (i=0; i<256; i++)
4075 table[i] = png_gamma_8bit_correct(i, gamma_val);
4077 else
4078 for (i=0; i<256; ++i)
4079 table[i] = (png_byte)(i & 0xff);
4082 /* Used from png_read_destroy and below to release the memory used by the gamma
4083 * tables.
4085 void /* PRIVATE */
4086 png_destroy_gamma_table(png_structrp png_ptr)
4088 png_free(png_ptr, png_ptr->gamma_table);
4089 png_ptr->gamma_table = NULL;
4091 #ifdef PNG_16BIT_SUPPORTED
4092 if (png_ptr->gamma_16_table != NULL)
4094 int i;
4095 int istop = (1 << (8 - png_ptr->gamma_shift));
4096 for (i = 0; i < istop; i++)
4098 png_free(png_ptr, png_ptr->gamma_16_table[i]);
4100 png_free(png_ptr, png_ptr->gamma_16_table);
4101 png_ptr->gamma_16_table = NULL;
4103 #endif /* 16BIT */
4105 #if defined(PNG_READ_BACKGROUND_SUPPORTED) || \
4106 defined(PNG_READ_ALPHA_MODE_SUPPORTED) || \
4107 defined(PNG_READ_RGB_TO_GRAY_SUPPORTED)
4108 png_free(png_ptr, png_ptr->gamma_from_1);
4109 png_ptr->gamma_from_1 = NULL;
4110 png_free(png_ptr, png_ptr->gamma_to_1);
4111 png_ptr->gamma_to_1 = NULL;
4113 #ifdef PNG_16BIT_SUPPORTED
4114 if (png_ptr->gamma_16_from_1 != NULL)
4116 int i;
4117 int istop = (1 << (8 - png_ptr->gamma_shift));
4118 for (i = 0; i < istop; i++)
4120 png_free(png_ptr, png_ptr->gamma_16_from_1[i]);
4122 png_free(png_ptr, png_ptr->gamma_16_from_1);
4123 png_ptr->gamma_16_from_1 = NULL;
4125 if (png_ptr->gamma_16_to_1 != NULL)
4127 int i;
4128 int istop = (1 << (8 - png_ptr->gamma_shift));
4129 for (i = 0; i < istop; i++)
4131 png_free(png_ptr, png_ptr->gamma_16_to_1[i]);
4133 png_free(png_ptr, png_ptr->gamma_16_to_1);
4134 png_ptr->gamma_16_to_1 = NULL;
4136 #endif /* 16BIT */
4137 #endif /* READ_BACKGROUND || READ_ALPHA_MODE || RGB_TO_GRAY */
4140 /* We build the 8- or 16-bit gamma tables here. Note that for 16-bit
4141 * tables, we don't make a full table if we are reducing to 8-bit in
4142 * the future. Note also how the gamma_16 tables are segmented so that
4143 * we don't need to allocate > 64K chunks for a full 16-bit table.
4145 void /* PRIVATE */
4146 png_build_gamma_table(png_structrp png_ptr, int bit_depth)
4148 png_debug(1, "in png_build_gamma_table");
4150 /* Remove any existing table; this copes with multiple calls to
4151 * png_read_update_info. The warning is because building the gamma tables
4152 * multiple times is a performance hit - it's harmless but the ability to
4153 * call png_read_update_info() multiple times is new in 1.5.6 so it seems
4154 * sensible to warn if the app introduces such a hit.
4156 if (png_ptr->gamma_table != NULL || png_ptr->gamma_16_table != NULL)
4158 png_warning(png_ptr, "gamma table being rebuilt");
4159 png_destroy_gamma_table(png_ptr);
4162 if (bit_depth <= 8)
4164 png_build_8bit_table(png_ptr, &png_ptr->gamma_table,
4165 png_ptr->screen_gamma > 0 ?
4166 png_reciprocal2(png_ptr->colorspace.gamma,
4167 png_ptr->screen_gamma) : PNG_FP_1);
4169 #if defined(PNG_READ_BACKGROUND_SUPPORTED) || \
4170 defined(PNG_READ_ALPHA_MODE_SUPPORTED) || \
4171 defined(PNG_READ_RGB_TO_GRAY_SUPPORTED)
4172 if ((png_ptr->transformations & (PNG_COMPOSE | PNG_RGB_TO_GRAY)) != 0)
4174 png_build_8bit_table(png_ptr, &png_ptr->gamma_to_1,
4175 png_reciprocal(png_ptr->colorspace.gamma));
4177 png_build_8bit_table(png_ptr, &png_ptr->gamma_from_1,
4178 png_ptr->screen_gamma > 0 ?
4179 png_reciprocal(png_ptr->screen_gamma) :
4180 png_ptr->colorspace.gamma/* Probably doing rgb_to_gray */);
4182 #endif /* READ_BACKGROUND || READ_ALPHA_MODE || RGB_TO_GRAY */
4184 #ifdef PNG_16BIT_SUPPORTED
4185 else
4187 png_byte shift, sig_bit;
4189 if ((png_ptr->color_type & PNG_COLOR_MASK_COLOR) != 0)
4191 sig_bit = png_ptr->sig_bit.red;
4193 if (png_ptr->sig_bit.green > sig_bit)
4194 sig_bit = png_ptr->sig_bit.green;
4196 if (png_ptr->sig_bit.blue > sig_bit)
4197 sig_bit = png_ptr->sig_bit.blue;
4199 else
4200 sig_bit = png_ptr->sig_bit.gray;
4202 /* 16-bit gamma code uses this equation:
4204 * ov = table[(iv & 0xff) >> gamma_shift][iv >> 8]
4206 * Where 'iv' is the input color value and 'ov' is the output value -
4207 * pow(iv, gamma).
4209 * Thus the gamma table consists of up to 256 256-entry tables. The table
4210 * is selected by the (8-gamma_shift) most significant of the low 8 bits
4211 * of the color value then indexed by the upper 8 bits:
4213 * table[low bits][high 8 bits]
4215 * So the table 'n' corresponds to all those 'iv' of:
4217 * <all high 8-bit values><n << gamma_shift>..<(n+1 << gamma_shift)-1>
4220 if (sig_bit > 0 && sig_bit < 16U)
4221 /* shift == insignificant bits */
4222 shift = (png_byte)((16U - sig_bit) & 0xff);
4224 else
4225 shift = 0; /* keep all 16 bits */
4227 if ((png_ptr->transformations & (PNG_16_TO_8 | PNG_SCALE_16_TO_8)) != 0)
4229 /* PNG_MAX_GAMMA_8 is the number of bits to keep - effectively
4230 * the significant bits in the *input* when the output will
4231 * eventually be 8 bits. By default it is 11.
4233 if (shift < (16U - PNG_MAX_GAMMA_8))
4234 shift = (16U - PNG_MAX_GAMMA_8);
4237 if (shift > 8U)
4238 shift = 8U; /* Guarantees at least one table! */
4240 png_ptr->gamma_shift = shift;
4242 /* NOTE: prior to 1.5.4 this test used to include PNG_BACKGROUND (now
4243 * PNG_COMPOSE). This effectively smashed the background calculation for
4244 * 16-bit output because the 8-bit table assumes the result will be
4245 * reduced to 8 bits.
4247 if ((png_ptr->transformations & (PNG_16_TO_8 | PNG_SCALE_16_TO_8)) != 0)
4248 png_build_16to8_table(png_ptr, &png_ptr->gamma_16_table, shift,
4249 png_ptr->screen_gamma > 0 ? png_product2(png_ptr->colorspace.gamma,
4250 png_ptr->screen_gamma) : PNG_FP_1);
4252 else
4253 png_build_16bit_table(png_ptr, &png_ptr->gamma_16_table, shift,
4254 png_ptr->screen_gamma > 0 ? png_reciprocal2(png_ptr->colorspace.gamma,
4255 png_ptr->screen_gamma) : PNG_FP_1);
4257 #if defined(PNG_READ_BACKGROUND_SUPPORTED) || \
4258 defined(PNG_READ_ALPHA_MODE_SUPPORTED) || \
4259 defined(PNG_READ_RGB_TO_GRAY_SUPPORTED)
4260 if ((png_ptr->transformations & (PNG_COMPOSE | PNG_RGB_TO_GRAY)) != 0)
4262 png_build_16bit_table(png_ptr, &png_ptr->gamma_16_to_1, shift,
4263 png_reciprocal(png_ptr->colorspace.gamma));
4265 /* Notice that the '16 from 1' table should be full precision, however
4266 * the lookup on this table still uses gamma_shift, so it can't be.
4267 * TODO: fix this.
4269 png_build_16bit_table(png_ptr, &png_ptr->gamma_16_from_1, shift,
4270 png_ptr->screen_gamma > 0 ? png_reciprocal(png_ptr->screen_gamma) :
4271 png_ptr->colorspace.gamma/* Probably doing rgb_to_gray */);
4273 #endif /* READ_BACKGROUND || READ_ALPHA_MODE || RGB_TO_GRAY */
4275 #endif /* 16BIT */
4277 #endif /* READ_GAMMA */
4279 /* HARDWARE OR SOFTWARE OPTION SUPPORT */
4280 #ifdef PNG_SET_OPTION_SUPPORTED
4281 int PNGAPI
4282 png_set_option(png_structrp png_ptr, int option, int onoff)
4284 if (png_ptr != NULL && option >= 0 && option < PNG_OPTION_NEXT &&
4285 (option & 1) == 0)
4287 png_uint_32 mask = 3 << option;
4288 png_uint_32 setting = (2 + (onoff != 0)) << option;
4289 png_uint_32 current = png_ptr->options;
4291 png_ptr->options = (png_uint_32)(((current & ~mask) | setting) & 0xff);
4293 return (current & mask) >> option;
4296 return PNG_OPTION_INVALID;
4298 #endif
4300 /* sRGB support */
4301 #if defined(PNG_SIMPLIFIED_READ_SUPPORTED) ||\
4302 defined(PNG_SIMPLIFIED_WRITE_SUPPORTED)
4303 /* sRGB conversion tables; these are machine generated with the code in
4304 * contrib/tools/makesRGB.c. The actual sRGB transfer curve defined in the
4305 * specification (see the article at http://en.wikipedia.org/wiki/SRGB)
4306 * is used, not the gamma=1/2.2 approximation use elsewhere in libpng.
4307 * The sRGB to linear table is exact (to the nearest 16-bit linear fraction).
4308 * The inverse (linear to sRGB) table has accuracies as follows:
4310 * For all possible (255*65535+1) input values:
4312 * error: -0.515566 - 0.625971, 79441 (0.475369%) of readings inexact
4314 * For the input values corresponding to the 65536 16-bit values:
4316 * error: -0.513727 - 0.607759, 308 (0.469978%) of readings inexact
4318 * In all cases the inexact readings are only off by one.
4321 #ifdef PNG_SIMPLIFIED_READ_SUPPORTED
4322 /* The convert-to-sRGB table is only currently required for read. */
4323 const png_uint_16 png_sRGB_table[256] =
4325 0,20,40,60,80,99,119,139,
4326 159,179,199,219,241,264,288,313,
4327 340,367,396,427,458,491,526,562,
4328 599,637,677,718,761,805,851,898,
4329 947,997,1048,1101,1156,1212,1270,1330,
4330 1391,1453,1517,1583,1651,1720,1790,1863,
4331 1937,2013,2090,2170,2250,2333,2418,2504,
4332 2592,2681,2773,2866,2961,3058,3157,3258,
4333 3360,3464,3570,3678,3788,3900,4014,4129,
4334 4247,4366,4488,4611,4736,4864,4993,5124,
4335 5257,5392,5530,5669,5810,5953,6099,6246,
4336 6395,6547,6700,6856,7014,7174,7335,7500,
4337 7666,7834,8004,8177,8352,8528,8708,8889,
4338 9072,9258,9445,9635,9828,10022,10219,10417,
4339 10619,10822,11028,11235,11446,11658,11873,12090,
4340 12309,12530,12754,12980,13209,13440,13673,13909,
4341 14146,14387,14629,14874,15122,15371,15623,15878,
4342 16135,16394,16656,16920,17187,17456,17727,18001,
4343 18277,18556,18837,19121,19407,19696,19987,20281,
4344 20577,20876,21177,21481,21787,22096,22407,22721,
4345 23038,23357,23678,24002,24329,24658,24990,25325,
4346 25662,26001,26344,26688,27036,27386,27739,28094,
4347 28452,28813,29176,29542,29911,30282,30656,31033,
4348 31412,31794,32179,32567,32957,33350,33745,34143,
4349 34544,34948,35355,35764,36176,36591,37008,37429,
4350 37852,38278,38706,39138,39572,40009,40449,40891,
4351 41337,41785,42236,42690,43147,43606,44069,44534,
4352 45002,45473,45947,46423,46903,47385,47871,48359,
4353 48850,49344,49841,50341,50844,51349,51858,52369,
4354 52884,53401,53921,54445,54971,55500,56032,56567,
4355 57105,57646,58190,58737,59287,59840,60396,60955,
4356 61517,62082,62650,63221,63795,64372,64952,65535
4358 #endif /* SIMPLIFIED_READ */
4360 /* The base/delta tables are required for both read and write (but currently
4361 * only the simplified versions.)
4363 const png_uint_16 png_sRGB_base[512] =
4365 128,1782,3383,4644,5675,6564,7357,8074,
4366 8732,9346,9921,10463,10977,11466,11935,12384,
4367 12816,13233,13634,14024,14402,14769,15125,15473,
4368 15812,16142,16466,16781,17090,17393,17690,17981,
4369 18266,18546,18822,19093,19359,19621,19879,20133,
4370 20383,20630,20873,21113,21349,21583,21813,22041,
4371 22265,22487,22707,22923,23138,23350,23559,23767,
4372 23972,24175,24376,24575,24772,24967,25160,25352,
4373 25542,25730,25916,26101,26284,26465,26645,26823,
4374 27000,27176,27350,27523,27695,27865,28034,28201,
4375 28368,28533,28697,28860,29021,29182,29341,29500,
4376 29657,29813,29969,30123,30276,30429,30580,30730,
4377 30880,31028,31176,31323,31469,31614,31758,31902,
4378 32045,32186,32327,32468,32607,32746,32884,33021,
4379 33158,33294,33429,33564,33697,33831,33963,34095,
4380 34226,34357,34486,34616,34744,34873,35000,35127,
4381 35253,35379,35504,35629,35753,35876,35999,36122,
4382 36244,36365,36486,36606,36726,36845,36964,37083,
4383 37201,37318,37435,37551,37668,37783,37898,38013,
4384 38127,38241,38354,38467,38580,38692,38803,38915,
4385 39026,39136,39246,39356,39465,39574,39682,39790,
4386 39898,40005,40112,40219,40325,40431,40537,40642,
4387 40747,40851,40955,41059,41163,41266,41369,41471,
4388 41573,41675,41777,41878,41979,42079,42179,42279,
4389 42379,42478,42577,42676,42775,42873,42971,43068,
4390 43165,43262,43359,43456,43552,43648,43743,43839,
4391 43934,44028,44123,44217,44311,44405,44499,44592,
4392 44685,44778,44870,44962,45054,45146,45238,45329,
4393 45420,45511,45601,45692,45782,45872,45961,46051,
4394 46140,46229,46318,46406,46494,46583,46670,46758,
4395 46846,46933,47020,47107,47193,47280,47366,47452,
4396 47538,47623,47709,47794,47879,47964,48048,48133,
4397 48217,48301,48385,48468,48552,48635,48718,48801,
4398 48884,48966,49048,49131,49213,49294,49376,49458,
4399 49539,49620,49701,49782,49862,49943,50023,50103,
4400 50183,50263,50342,50422,50501,50580,50659,50738,
4401 50816,50895,50973,51051,51129,51207,51285,51362,
4402 51439,51517,51594,51671,51747,51824,51900,51977,
4403 52053,52129,52205,52280,52356,52432,52507,52582,
4404 52657,52732,52807,52881,52956,53030,53104,53178,
4405 53252,53326,53400,53473,53546,53620,53693,53766,
4406 53839,53911,53984,54056,54129,54201,54273,54345,
4407 54417,54489,54560,54632,54703,54774,54845,54916,
4408 54987,55058,55129,55199,55269,55340,55410,55480,
4409 55550,55620,55689,55759,55828,55898,55967,56036,
4410 56105,56174,56243,56311,56380,56448,56517,56585,
4411 56653,56721,56789,56857,56924,56992,57059,57127,
4412 57194,57261,57328,57395,57462,57529,57595,57662,
4413 57728,57795,57861,57927,57993,58059,58125,58191,
4414 58256,58322,58387,58453,58518,58583,58648,58713,
4415 58778,58843,58908,58972,59037,59101,59165,59230,
4416 59294,59358,59422,59486,59549,59613,59677,59740,
4417 59804,59867,59930,59993,60056,60119,60182,60245,
4418 60308,60370,60433,60495,60558,60620,60682,60744,
4419 60806,60868,60930,60992,61054,61115,61177,61238,
4420 61300,61361,61422,61483,61544,61605,61666,61727,
4421 61788,61848,61909,61969,62030,62090,62150,62211,
4422 62271,62331,62391,62450,62510,62570,62630,62689,
4423 62749,62808,62867,62927,62986,63045,63104,63163,
4424 63222,63281,63340,63398,63457,63515,63574,63632,
4425 63691,63749,63807,63865,63923,63981,64039,64097,
4426 64155,64212,64270,64328,64385,64443,64500,64557,
4427 64614,64672,64729,64786,64843,64900,64956,65013,
4428 65070,65126,65183,65239,65296,65352,65409,65465
4431 const png_byte png_sRGB_delta[512] =
4433 207,201,158,129,113,100,90,82,77,72,68,64,61,59,56,54,
4434 52,50,49,47,46,45,43,42,41,40,39,39,38,37,36,36,
4435 35,34,34,33,33,32,32,31,31,30,30,30,29,29,28,28,
4436 28,27,27,27,27,26,26,26,25,25,25,25,24,24,24,24,
4437 23,23,23,23,23,22,22,22,22,22,22,21,21,21,21,21,
4438 21,20,20,20,20,20,20,20,20,19,19,19,19,19,19,19,
4439 19,18,18,18,18,18,18,18,18,18,18,17,17,17,17,17,
4440 17,17,17,17,17,17,16,16,16,16,16,16,16,16,16,16,
4441 16,16,16,16,15,15,15,15,15,15,15,15,15,15,15,15,
4442 15,15,15,15,14,14,14,14,14,14,14,14,14,14,14,14,
4443 14,14,14,14,14,14,14,13,13,13,13,13,13,13,13,13,
4444 13,13,13,13,13,13,13,13,13,13,13,13,13,13,12,12,
4445 12,12,12,12,12,12,12,12,12,12,12,12,12,12,12,12,
4446 12,12,12,12,12,12,12,12,12,12,12,12,11,11,11,11,
4447 11,11,11,11,11,11,11,11,11,11,11,11,11,11,11,11,
4448 11,11,11,11,11,11,11,11,11,11,11,11,11,11,11,11,
4449 11,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,
4450 10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,
4451 10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,
4452 10,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,
4453 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,
4454 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,
4455 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,
4456 9,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,
4457 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,
4458 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,
4459 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,
4460 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,
4461 8,8,8,8,8,8,8,8,8,7,7,7,7,7,7,7,
4462 7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,
4463 7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,
4464 7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7
4466 #endif /* SIMPLIFIED READ/WRITE sRGB support */
4468 /* SIMPLIFIED READ/WRITE SUPPORT */
4469 #if defined(PNG_SIMPLIFIED_READ_SUPPORTED) ||\
4470 defined(PNG_SIMPLIFIED_WRITE_SUPPORTED)
4471 static int
4472 png_image_free_function(png_voidp argument)
4474 png_imagep image = png_voidcast(png_imagep, argument);
4475 png_controlp cp = image->opaque;
4476 png_control c;
4478 /* Double check that we have a png_ptr - it should be impossible to get here
4479 * without one.
4481 if (cp->png_ptr == NULL)
4482 return 0;
4484 /* First free any data held in the control structure. */
4485 # ifdef PNG_STDIO_SUPPORTED
4486 if (cp->owned_file != 0)
4488 FILE *fp = png_voidcast(FILE*, cp->png_ptr->io_ptr);
4489 cp->owned_file = 0;
4491 /* Ignore errors here. */
4492 if (fp != NULL)
4494 cp->png_ptr->io_ptr = NULL;
4495 (void)fclose(fp);
4498 # endif
4500 /* Copy the control structure so that the original, allocated, version can be
4501 * safely freed. Notice that a png_error here stops the remainder of the
4502 * cleanup, but this is probably fine because that would indicate bad memory
4503 * problems anyway.
4505 c = *cp;
4506 image->opaque = &c;
4507 png_free(c.png_ptr, cp);
4509 /* Then the structures, calling the correct API. */
4510 if (c.for_write != 0)
4512 # ifdef PNG_SIMPLIFIED_WRITE_SUPPORTED
4513 png_destroy_write_struct(&c.png_ptr, &c.info_ptr);
4514 # else
4515 png_error(c.png_ptr, "simplified write not supported");
4516 # endif
4518 else
4520 # ifdef PNG_SIMPLIFIED_READ_SUPPORTED
4521 png_destroy_read_struct(&c.png_ptr, &c.info_ptr, NULL);
4522 # else
4523 png_error(c.png_ptr, "simplified read not supported");
4524 # endif
4527 /* Success. */
4528 return 1;
4531 void PNGAPI
4532 png_image_free(png_imagep image)
4534 /* Safely call the real function, but only if doing so is safe at this point
4535 * (if not inside an error handling context). Otherwise assume
4536 * png_safe_execute will call this API after the return.
4538 if (image != NULL && image->opaque != NULL &&
4539 image->opaque->error_buf == NULL)
4541 /* Ignore errors here: */
4542 (void)png_safe_execute(image, png_image_free_function, image);
4543 image->opaque = NULL;
4547 int /* PRIVATE */
4548 png_image_error(png_imagep image, png_const_charp error_message)
4550 /* Utility to log an error. */
4551 png_safecat(image->message, (sizeof image->message), 0, error_message);
4552 image->warning_or_error |= PNG_IMAGE_ERROR;
4553 png_image_free(image);
4554 return 0;
4557 #endif /* SIMPLIFIED READ/WRITE */
4558 #endif /* READ || WRITE */