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