png.c 23.7 KB
Newer Older
G
Guy Schalnat 已提交
1

2 3
/* png.c - location for general purpose libpng functions
 *
4
 * Last changed in libpng 1.4.0 [August 31, 2009]
5
 * Copyright (c) 1998-2009 Glenn Randers-Pehrson
6 7
 * (Version 0.96 Copyright (c) 1996, 1997 Andreas Dilger)
 * (Version 0.88 Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.)
8
 *
9
 * This code is released under the libpng license.
10
 * For conditions of distribution and use, see the disclaimer
11
 * and license in png.h
12
 */
G
Guy Schalnat 已提交
13 14 15

#define PNG_NO_EXTERN
#include "png.h"
16
#include "pngpriv.h"
G
Guy Schalnat 已提交
17

18
/* Generate a compiler error if there is an old png.h in the search path. */
19
typedef version_1_4_0beta78 Your_png_h_is_not_version_1_4_0beta78;
20

A
Andreas Dilger 已提交
21
/* Version information for C files.  This had better match the version
22
 * string defined in png.h.  */
23

24
#ifdef PNG_USE_GLOBAL_ARRAYS
25
/* png_libpng_ver was changed to a function in version 1.0.5c */
26
PNG_CONST char png_libpng_ver[18] = PNG_LIBPNG_VER_STRING;
G
Guy Schalnat 已提交
27

28 29
#ifdef PNG_READ_SUPPORTED

30
/* png_sig was changed to a function in version 1.0.5c */
31
/* Place to hold the signature string for a PNG file. */
32
PNG_CONST png_byte FARDATA png_sig[8] = {137, 80, 78, 71, 13, 10, 26, 10};
33
#endif /* PNG_READ_SUPPORTED */
34

35 36 37 38 39 40 41 42 43
/* Invoke global declarations for constant strings for known chunk types */
PNG_IHDR;
PNG_IDAT;
PNG_IEND;
PNG_PLTE;
PNG_bKGD;
PNG_cHRM;
PNG_gAMA;
PNG_hIST;
44 45
PNG_iCCP;
PNG_iTXt;
46 47
PNG_oFFs;
PNG_pCAL;
48
PNG_sCAL;
49 50
PNG_pHYs;
PNG_sBIT;
51
PNG_sPLT;
52 53 54 55 56
PNG_sRGB;
PNG_tEXt;
PNG_tIME;
PNG_tRNS;
PNG_zTXt;
G
Guy Schalnat 已提交
57

58
#ifdef PNG_READ_SUPPORTED
59
/* Arrays to facilitate easy interlacing - use pass (0 - 6) as index */
G
Guy Schalnat 已提交
60

61
/* Start of interlace block */
62
PNG_CONST int FARDATA png_pass_start[] = {0, 4, 0, 2, 0, 1, 0};
G
Guy Schalnat 已提交
63

64
/* Offset to next interlace block */
65
PNG_CONST int FARDATA png_pass_inc[] = {8, 8, 4, 4, 2, 2, 1};
G
Guy Schalnat 已提交
66

67
/* Start of interlace block in the y direction */
68
PNG_CONST int FARDATA png_pass_ystart[] = {0, 0, 4, 0, 2, 0, 1};
G
Guy Schalnat 已提交
69

70
/* Offset to next interlace block in the y direction */
71
PNG_CONST int FARDATA png_pass_yinc[] = {8, 8, 8, 4, 4, 2, 2};
G
Guy Schalnat 已提交
72

73 74
/* Height of interlace block.  This is not currently used - if you need
 * it, uncomment it here and in png.h
75
PNG_CONST int FARDATA png_pass_height[] = {8, 8, 4, 4, 2, 2, 1};
G
Guy Schalnat 已提交
76 77
*/

78
/* Mask to determine which pixels are valid in a pass */
79
PNG_CONST int FARDATA png_pass_mask[] = {0x80, 0x08, 0x88, 0x22, 0xaa, 0x55, 0xff};
G
Guy Schalnat 已提交
80

81
/* Mask to determine which pixels to overwrite while displaying */
82
PNG_CONST int FARDATA png_pass_dsp_mask[]
83
   = {0xff, 0x0f, 0xff, 0x33, 0xff, 0x55, 0xff};
G
Guy Schalnat 已提交
84

85
#endif /* PNG_READ_SUPPORTED */
86
#endif /* PNG_USE_GLOBAL_ARRAYS */
87

A
Andreas Dilger 已提交
88 89 90 91 92
/* Tells libpng that we have already handled the first "num_bytes" bytes
 * of the PNG file signature.  If the PNG data is embedded into another
 * stream we can set num_bytes = 8 so that libpng will not attempt to read
 * or write any of the magic bytes before it starts on the IHDR.
 */
93

94
#ifdef PNG_READ_SUPPORTED
95
void PNGAPI
A
Andreas Dilger 已提交
96 97
png_set_sig_bytes(png_structp png_ptr, int num_bytes)
{
98 99
   png_debug(1, "in png_set_sig_bytes");

100 101
   if (png_ptr == NULL)
      return;
102

A
Andreas Dilger 已提交
103
   if (num_bytes > 8)
104
      png_error(png_ptr, "Too many bytes for PNG signature");
A
Andreas Dilger 已提交
105

106
   png_ptr->sig_bytes = (png_byte)(num_bytes < 0 ? 0 : num_bytes);
A
Andreas Dilger 已提交
107 108 109 110 111 112 113 114 115 116
}

/* Checks whether the supplied bytes match the PNG signature.  We allow
 * checking less than the full 8-byte signature so that those apps that
 * already read the first few bytes of a file to determine the file type
 * can simply check the remaining bytes for extra assurance.  Returns
 * an integer less than, equal to, or greater than zero if sig is found,
 * respectively, to be less than, to match, or be greater than the correct
 * PNG signature (this is the same behaviour as strcmp, memcmp, etc).
 */
117
int PNGAPI
A
Andreas Dilger 已提交
118
png_sig_cmp(png_bytep sig, png_size_t start, png_size_t num_to_check)
G
Guy Schalnat 已提交
119
{
120
   png_byte png_signature[8] = {137, 80, 78, 71, 13, 10, 26, 10};
A
Andreas Dilger 已提交
121 122 123
   if (num_to_check > 8)
      num_to_check = 8;
   else if (num_to_check < 1)
124
      return (-1);
A
Andreas Dilger 已提交
125

A
Andreas Dilger 已提交
126
   if (start > 7)
127
      return (-1);
G
Guy Schalnat 已提交
128

A
Andreas Dilger 已提交
129 130 131
   if (start + num_to_check > 8)
      num_to_check = 8 - start;

132
   return ((int)(png_memcmp(&sig[start], &png_signature[start], num_to_check)));
A
Andreas Dilger 已提交
133 134
}

135
#endif /* PNG_READ_SUPPORTED */
G
Guy Schalnat 已提交
136

137
#if defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED)
138
/* Function to allocate memory for zlib and clear it to 0. */
139
voidpf /* PRIVATE */
G
Guy Schalnat 已提交
140
png_zalloc(voidpf png_ptr, uInt items, uInt size)
G
Guy Schalnat 已提交
141
{
142 143 144
   png_voidp ptr;
   png_structp p=(png_structp)png_ptr;
   png_uint_32 save_flags=p->flags;
145
   png_alloc_size_t num_bytes;
146

147 148
   if (png_ptr == NULL)
      return (NULL);
149 150
   if (items > PNG_UINT_32_MAX/size)
   {
151 152
     png_warning (p, "Potential overflow in png_zalloc()");
     return (NULL);
153
   }
154
   num_bytes = (png_alloc_size_t)items * size;
G
Guy Schalnat 已提交
155

156 157 158
   p->flags|=PNG_FLAG_MALLOC_NULL_MEM_OK;
   ptr = (png_voidp)png_malloc((png_structp)png_ptr, num_bytes);
   p->flags=save_flags;
G
Guy Schalnat 已提交
159

160 161 162
   return ((voidpf)ptr);
}

163
/* Function to free memory for zlib */
164
void /* PRIVATE */
G
Guy Schalnat 已提交
165
png_zfree(voidpf png_ptr, voidpf ptr)
G
Guy Schalnat 已提交
166
{
A
Andreas Dilger 已提交
167
   png_free((png_structp)png_ptr, (png_voidp)ptr);
G
Guy Schalnat 已提交
168 169
}

A
Andreas Dilger 已提交
170
/* Reset the CRC variable to 32 bits of 1's.  Care must be taken
171 172
 * in case CRC is > 32 bits to leave the top bits 0.
 */
173
void /* PRIVATE */
G
Guy Schalnat 已提交
174
png_reset_crc(png_structp png_ptr)
G
Guy Schalnat 已提交
175
{
A
Andreas Dilger 已提交
176
   png_ptr->crc = crc32(0, Z_NULL, 0);
G
Guy Schalnat 已提交
177 178
}

A
Andreas Dilger 已提交
179
/* Calculate the CRC over a section of data.  We can only pass as
180 181 182 183
 * much data to this routine as the largest single buffer size.  We
 * also check that this data will actually be used before going to the
 * trouble of calculating it.
 */
184
void /* PRIVATE */
A
Andreas Dilger 已提交
185
png_calculate_crc(png_structp png_ptr, png_bytep ptr, png_size_t length)
G
Guy Schalnat 已提交
186
{
A
Andreas Dilger 已提交
187 188 189 190 191 192 193 194 195 196 197 198 199 200 201
   int need_crc = 1;

   if (png_ptr->chunk_name[0] & 0x20)                     /* ancillary */
   {
      if ((png_ptr->flags & PNG_FLAG_CRC_ANCILLARY_MASK) ==
          (PNG_FLAG_CRC_ANCILLARY_USE | PNG_FLAG_CRC_ANCILLARY_NOWARN))
         need_crc = 0;
   }
   else                                                    /* critical */
   {
      if (png_ptr->flags & PNG_FLAG_CRC_CRITICAL_IGNORE)
         need_crc = 0;
   }

   if (need_crc)
202
      png_ptr->crc = crc32(png_ptr->crc, ptr, (uInt)length);
G
Guy Schalnat 已提交
203
}
G
Guy Schalnat 已提交
204

A
Andreas Dilger 已提交
205
/* Allocate the memory for an info_struct for the application.  We don't
206
 * really need the png_ptr, but it could potentially be useful in the
207
 * future.  This should be used in favour of malloc(png_sizeof(png_info))
208 209 210
 * and png_info_init() so that applications that want to use a shared
 * libpng don't have to be recompiled if png_info changes size.
 */
211
png_infop PNGAPI
G
Guy Schalnat 已提交
212 213 214 215
png_create_info_struct(png_structp png_ptr)
{
   png_infop info_ptr;

216
   png_debug(1, "in png_create_info_struct");
217

218 219
   if (png_ptr == NULL)
      return (NULL);
220

221
#ifdef PNG_USER_MEM_SUPPORTED
222 223
   info_ptr = (png_infop)png_create_struct_2(PNG_STRUCT_INFO,
      png_ptr->malloc_fn, png_ptr->mem_ptr);
224
#else
225
   info_ptr = (png_infop)png_create_struct(PNG_STRUCT_INFO);
226
#endif
227
   if (info_ptr != NULL)
228
      png_info_init_3(&info_ptr, png_sizeof(png_info));
G
Guy Schalnat 已提交
229

230
   return (info_ptr);
G
Guy Schalnat 已提交
231 232
}

A
Andreas Dilger 已提交
233
/* This function frees the memory associated with a single info struct.
234 235 236 237
 * Normally, one would use either png_destroy_read_struct() or
 * png_destroy_write_struct() to free an info struct, but this may be
 * useful for some applications.
 */
238
void PNGAPI
A
Andreas Dilger 已提交
239 240 241 242
png_destroy_info_struct(png_structp png_ptr, png_infopp info_ptr_ptr)
{
   png_infop info_ptr = NULL;

243
   png_debug(1, "in png_destroy_info_struct");
244

245 246 247
   if (png_ptr == NULL)
      return;

A
Andreas Dilger 已提交
248
   if (info_ptr_ptr != NULL)
A
Andreas Dilger 已提交
249 250
      info_ptr = *info_ptr_ptr;

A
Andreas Dilger 已提交
251
   if (info_ptr != NULL)
A
Andreas Dilger 已提交
252 253 254
   {
      png_info_destroy(png_ptr, info_ptr);

255
#ifdef PNG_USER_MEM_SUPPORTED
256 257
      png_destroy_struct_2((png_voidp)info_ptr, png_ptr->free_fn,
          png_ptr->mem_ptr);
258
#else
A
Andreas Dilger 已提交
259
      png_destroy_struct((png_voidp)info_ptr);
260
#endif
261
      *info_ptr_ptr = NULL;
A
Andreas Dilger 已提交
262 263 264 265
   }
}

/* Initialize the info structure.  This is now an internal function (0.89)
266 267 268
 * and applications using it are urged to use png_create_info_struct()
 * instead.
 */
269

270 271 272 273 274
void PNGAPI
png_info_init_3(png_infopp ptr_ptr, png_size_t png_info_struct_size)
{
   png_infop info_ptr = *ptr_ptr;

275 276
   png_debug(1, "in png_info_init_3");

277 278
   if (info_ptr == NULL)
      return;
279

280
   if (png_sizeof(png_info) > png_info_struct_size)
281 282 283 284 285
   {
      png_destroy_struct(info_ptr);
      info_ptr = (png_infop)png_create_struct(PNG_STRUCT_INFO);
      *ptr_ptr = info_ptr;
   }
286

287
   /* Set everything to 0 */
288
   png_memset(info_ptr, 0, png_sizeof(png_info));
A
Andreas Dilger 已提交
289 290
}

291
void PNGAPI
292 293 294
png_data_freer(png_structp png_ptr, png_infop info_ptr,
   int freer, png_uint_32 mask)
{
295
   png_debug(1, "in png_data_freer");
296

297 298
   if (png_ptr == NULL || info_ptr == NULL)
      return;
299

300
   if (freer == PNG_DESTROY_WILL_FREE_DATA)
301
      info_ptr->free_me |= mask;
302
   else if (freer == PNG_USER_WILL_FREE_DATA)
303 304 305
      info_ptr->free_me &= ~mask;
   else
      png_warning(png_ptr,
306
         "Unknown freer parameter in png_data_freer");
307 308
}

309
void PNGAPI
310 311
png_free_data(png_structp png_ptr, png_infop info_ptr, png_uint_32 mask,
   int num)
312
{
313
   png_debug(1, "in png_free_data");
314

315 316
   if (png_ptr == NULL || info_ptr == NULL)
      return;
317 318

#if defined(PNG_TEXT_SUPPORTED)
319
   /* Free text item num or (if num == -1) all text items */
320
   if ((mask & PNG_FREE_TEXT) & info_ptr->free_me)
321
   {
322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338
      if (num != -1)
      {
         if (info_ptr->text && info_ptr->text[num].key)
         {
            png_free(png_ptr, info_ptr->text[num].key);
            info_ptr->text[num].key = NULL;
         }
      }
      else
      {
         int i;
         for (i = 0; i < info_ptr->num_text; i++)
             png_free_data(png_ptr, info_ptr, PNG_FREE_TEXT, i);
         png_free(png_ptr, info_ptr->text);
         info_ptr->text = NULL;
         info_ptr->num_text=0;
      }
339 340 341 342
   }
#endif

#if defined(PNG_tRNS_SUPPORTED)
343
   /* Free any tRNS entry */
344 345
   if ((mask & PNG_FREE_TRNS) & info_ptr->free_me)
   {
346 347
      png_free(png_ptr, info_ptr->trans_alpha);
      info_ptr->trans_alpha = NULL;
348 349
      info_ptr->valid &= ~PNG_INFO_tRNS;
   }
350 351 352
#endif

#if defined(PNG_sCAL_SUPPORTED)
353
   /* Free any sCAL entry */
354 355
   if ((mask & PNG_FREE_SCAL) & info_ptr->free_me)
   {
356
#if defined(PNG_FIXED_POINT_SUPPORTED) && !defined(PNG_FLOATING_POINT_SUPPORTED)
357 358 359 360
      png_free(png_ptr, info_ptr->scal_s_width);
      png_free(png_ptr, info_ptr->scal_s_height);
      info_ptr->scal_s_width = NULL;
      info_ptr->scal_s_height = NULL;
361
#endif
362 363
      info_ptr->valid &= ~PNG_INFO_sCAL;
   }
364 365 366
#endif

#if defined(PNG_pCAL_SUPPORTED)
367
   /* Free any pCAL entry */
368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386
   if ((mask & PNG_FREE_PCAL) & info_ptr->free_me)
   {
      png_free(png_ptr, info_ptr->pcal_purpose);
      png_free(png_ptr, info_ptr->pcal_units);
      info_ptr->pcal_purpose = NULL;
      info_ptr->pcal_units = NULL;
      if (info_ptr->pcal_params != NULL)
         {
            int i;
            for (i = 0; i < (int)info_ptr->pcal_nparams; i++)
            {
               png_free(png_ptr, info_ptr->pcal_params[i]);
               info_ptr->pcal_params[i]=NULL;
            }
            png_free(png_ptr, info_ptr->pcal_params);
            info_ptr->pcal_params = NULL;
         }
      info_ptr->valid &= ~PNG_INFO_pCAL;
   }
387 388 389
#endif

#if defined(PNG_iCCP_SUPPORTED)
390
   /* Free any iCCP entry */
391 392 393 394 395 396 397 398
   if ((mask & PNG_FREE_ICCP) & info_ptr->free_me)
   {
      png_free(png_ptr, info_ptr->iccp_name);
      png_free(png_ptr, info_ptr->iccp_profile);
      info_ptr->iccp_name = NULL;
      info_ptr->iccp_profile = NULL;
      info_ptr->valid &= ~PNG_INFO_iCCP;
   }
399 400 401
#endif

#if defined(PNG_sPLT_SUPPORTED)
402
   /* Free a given sPLT entry, or (if num == -1) all sPLT entries */
403
   if ((mask & PNG_FREE_SPLT) & info_ptr->free_me)
404
   {
405
      if (num != -1)
406
      {
407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427
         if (info_ptr->splt_palettes)
         {
            png_free(png_ptr, info_ptr->splt_palettes[num].name);
            png_free(png_ptr, info_ptr->splt_palettes[num].entries);
            info_ptr->splt_palettes[num].name = NULL;
            info_ptr->splt_palettes[num].entries = NULL;
         }
      }
      else
      {
         if (info_ptr->splt_palettes_num)
         {
            int i;
            for (i = 0; i < (int)info_ptr->splt_palettes_num; i++)
               png_free_data(png_ptr, info_ptr, PNG_FREE_SPLT, i);

            png_free(png_ptr, info_ptr->splt_palettes);
            info_ptr->splt_palettes = NULL;
            info_ptr->splt_palettes_num = 0;
         }
         info_ptr->valid &= ~PNG_INFO_sPLT;
428
      }
429 430 431 432
   }
#endif

#if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED)
433 434 435 436 437
   if (png_ptr->unknown_chunk.data)
   {
      png_free(png_ptr, png_ptr->unknown_chunk.data);
      png_ptr->unknown_chunk.data = NULL;
   }
438

439
   if ((mask & PNG_FREE_UNKN) & info_ptr->free_me)
440
   {
441 442 443 444 445 446 447 448 449 450 451
      if (num != -1)
      {
          if (info_ptr->unknown_chunks)
          {
             png_free(png_ptr, info_ptr->unknown_chunks[num].data);
             info_ptr->unknown_chunks[num].data = NULL;
          }
      }
      else
      {
         int i;
452

453 454 455 456
         if (info_ptr->unknown_chunks_num)
         {
            for (i = 0; i < (int)info_ptr->unknown_chunks_num; i++)
               png_free_data(png_ptr, info_ptr, PNG_FREE_UNKN, i);
457

458 459 460 461 462
            png_free(png_ptr, info_ptr->unknown_chunks);
            info_ptr->unknown_chunks = NULL;
            info_ptr->unknown_chunks_num = 0;
         }
      }
463 464 465 466
   }
#endif

#if defined(PNG_hIST_SUPPORTED)
467
   /* Free any hIST entry */
468 469 470 471 472 473
   if ((mask & PNG_FREE_HIST)  & info_ptr->free_me)
   {
      png_free(png_ptr, info_ptr->hist);
      info_ptr->hist = NULL;
      info_ptr->valid &= ~PNG_INFO_hIST;
   }
474 475
#endif

476
   /* Free any PLTE entry that was internally allocated */
477 478 479 480 481 482 483
   if ((mask & PNG_FREE_PLTE) & info_ptr->free_me)
   {
      png_zfree(png_ptr, info_ptr->palette);
      info_ptr->palette = NULL;
      info_ptr->valid &= ~PNG_INFO_PLTE;
      info_ptr->num_palette = 0;
   }
484 485

#if defined(PNG_INFO_IMAGE_SUPPORTED)
486
   /* Free any image bits attached to the info structure */
487 488 489 490 491 492 493 494 495 496 497 498 499
   if ((mask & PNG_FREE_ROWS) & info_ptr->free_me)
   {
      if (info_ptr->row_pointers)
      {
         int row;
         for (row = 0; row < (int)info_ptr->height; row++)
         {
            png_free(png_ptr, info_ptr->row_pointers[row]);
         }
         png_free(png_ptr, info_ptr->row_pointers);
      }
      info_ptr->valid &= ~PNG_INFO_IDAT;
   }
500
#endif
501

502
   if (num == -1)
503
      info_ptr->free_me &= ~mask;
504
   else
505
      info_ptr->free_me &= ~(mask & ~PNG_FREE_MUL);
506
}
507

A
Andreas Dilger 已提交
508
/* This is an internal routine to free any memory that the info struct is
A
Andreas Dilger 已提交
509 510 511
 * pointing to before re-using it or freeing the struct itself.  Recall
 * that png_free() checks for NULL pointers for us.
 */
512
void /* PRIVATE */
A
Andreas Dilger 已提交
513 514
png_info_destroy(png_structp png_ptr, png_infop info_ptr)
{
515
   png_debug(1, "in png_info_destroy");
516 517

   png_free_data(png_ptr, info_ptr, PNG_FREE_ALL, -1);
518

519
#if defined(PNG_HANDLE_AS_UNKNOWN_SUPPORTED)
520 521
   if (png_ptr->num_chunk_list)
   {
522 523
      png_free(png_ptr, png_ptr->chunk_list);
      png_ptr->num_chunk_list = 0;
524
   }
A
Andreas Dilger 已提交
525
#endif
526

527
   png_info_init_3(&info_ptr, png_sizeof(png_info));
G
Guy Schalnat 已提交
528
}
529
#endif /* defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED) */
G
Guy Schalnat 已提交
530

G
Guy Schalnat 已提交
531
/* This function returns a pointer to the io_ptr associated with the user
532 533 534
 * functions.  The application should free any memory associated with this
 * pointer before png_write_destroy() or png_read_destroy() are called.
 */
535
png_voidp PNGAPI
G
Guy Schalnat 已提交
536 537
png_get_io_ptr(png_structp png_ptr)
{
538 539
   if (png_ptr == NULL)
      return (NULL);
540
   return (png_ptr->io_ptr);
G
Guy Schalnat 已提交
541
}
A
Andreas Dilger 已提交
542

543
#if defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED)
544
#ifdef PNG_STDIO_SUPPORTED
A
Andreas Dilger 已提交
545
/* Initialize the default input/output functions for the PNG file.  If you
546
 * use your own read or write routines, you can call either png_set_read_fn()
547 548 549
 * or png_set_write_fn() instead of png_init_io().  If you have defined
 * PNG_NO_STDIO, you must use a function of your own because "FILE *" isn't
 * necessarily available.
550
 */
551
void PNGAPI
552
png_init_io(png_structp png_ptr, png_FILE_p fp)
G
Guy Schalnat 已提交
553
{
554
   png_debug(1, "in png_init_io");
555

556 557
   if (png_ptr == NULL)
      return;
558

G
Guy Schalnat 已提交
559 560
   png_ptr->io_ptr = (png_voidp)fp;
}
A
Andreas Dilger 已提交
561
#endif
562 563 564 565 566

#if defined(PNG_TIME_RFC1123_SUPPORTED)
/* Convert the supplied time into an RFC 1123 string suitable for use in
 * a "Creation Time" or other text-based time string.
 */
567
png_charp PNGAPI
568 569 570
png_convert_to_rfc1123(png_structp png_ptr, png_timep ptime)
{
   static PNG_CONST char short_months[12][4] =
571 572
        {"Jan", "Feb", "Mar", "Apr", "May", "Jun",
         "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"};
573

574 575
   if (png_ptr == NULL)
      return (NULL);
576
   if (png_ptr->time_buffer == NULL)
577 578 579 580
   {
      png_ptr->time_buffer = (png_charp)png_malloc(png_ptr, (png_uint_32)(29*
         png_sizeof(char)));
   }
581 582

#ifdef USE_FAR_KEYWORD
583 584
   {
      char near_time_buf[29];
585
      png_snprintf6(near_time_buf, 29, "%d %s %d %02d:%02d:%02d +0000",
586 587 588 589
          ptime->day % 32, short_months[(ptime->month - 1) % 12],
          ptime->year, ptime->hour % 24, ptime->minute % 60,
          ptime->second % 61);
      png_memcpy(png_ptr->time_buffer, near_time_buf,
590
          29*png_sizeof(char));
591
   }
592
#else
593
   png_snprintf6(png_ptr->time_buffer, 29, "%d %s %d %02d:%02d:%02d +0000",
594 595 596
       ptime->day % 32, short_months[(ptime->month - 1) % 12],
       ptime->year, ptime->hour % 24, ptime->minute % 60,
       ptime->second % 61);
597 598 599 600
#endif
   return ((png_charp)png_ptr->time_buffer);
}
#endif /* PNG_TIME_RFC1123_SUPPORTED */
601

602
#endif /* defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED) */
603

604
png_charp PNGAPI
605 606
png_get_copyright(png_structp png_ptr)
{
607
   png_ptr = png_ptr;  /* Silence compiler warning about unused png_ptr */
608 609 610 611
#ifdef PNG_STRING_COPYRIGHT
      return PNG_STRING_COPYRIGHT
#else
#ifdef __STDC__
612
   return ((png_charp) PNG_STRING_NEWLINE \
613
     "libpng version x 1.4.0beta78 - August 31, 2009" PNG_STRING_NEWLINE \
614
     "Copyright (c) 1998-2009 Glenn Randers-Pehrson" PNG_STRING_NEWLINE \
615 616 617
     "Copyright (c) 1996-1997 Andreas Dilger" PNG_STRING_NEWLINE \
     "Copyright (c) 1995-1996 Guy Eric Schalnat, Group 42, Inc." \
     PNG_STRING_NEWLINE);
618
#else
619
      return ((png_charp) "libpng version 1.4.0beta78 - August 31, 2009\
620
      Copyright (c) 1998-2009 Glenn Randers-Pehrson\
621 622 623 624
      Copyright (c) 1996-1997 Andreas Dilger\
      Copyright (c) 1995-1996 Guy Eric Schalnat, Group 42, Inc.");
#endif
#endif
625
}
626

627
/* The following return the library version as a short string in the
628 629 630 631 632 633
 * format 1.0.0 through 99.99.99zz.  To get the version of *.h files
 * used with your application, print out PNG_LIBPNG_VER_STRING, which
 * is defined in png.h.
 * Note: now there is no difference between png_get_libpng_ver() and
 * png_get_header_ver().  Due to the version_nn_nn_nn typedef guard,
 * it is guaranteed that png.c uses the correct version of png.h.
634
 */
635
png_charp PNGAPI
636 637 638
png_get_libpng_ver(png_structp png_ptr)
{
   /* Version of *.c files used when building libpng */
639
   png_ptr = png_ptr;  /* Silence compiler warning about unused png_ptr */
640
   return ((png_charp) PNG_LIBPNG_VER_STRING);
641 642
}

643
png_charp PNGAPI
644 645 646
png_get_header_ver(png_structp png_ptr)
{
   /* Version of *.h files used when building libpng */
647
   png_ptr = png_ptr;  /* Silence compiler warning about unused png_ptr */
648
   return ((png_charp) PNG_LIBPNG_VER_STRING);
649 650
}

651
png_charp PNGAPI
652 653 654
png_get_header_version(png_structp png_ptr)
{
   /* Returns longer string containing both version and date */
655
   png_ptr = png_ptr;  /* Silence compiler warning about unused png_ptr */
656
#ifdef __STDC__
657 658 659 660
   return ((png_charp) PNG_HEADER_VERSION_STRING
#ifndef PNG_READ_SUPPORTED
   "     (NO READ SUPPORT)"
#endif
661
   PNG_STRING_NEWLINE);
662 663 664
#else
   return ((png_charp) PNG_HEADER_VERSION_STRING);
#endif
665 666
}

667
#if defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED)
668
#ifdef PNG_HANDLE_AS_UNKNOWN_SUPPORTED
669
int PNGAPI
670 671
png_handle_as_unknown(png_structp png_ptr, png_bytep chunk_name)
{
672
   /* Check chunk_name and return "keep" value if it's on the list, else 0 */
673 674
   int i;
   png_bytep p;
675
   if (png_ptr == NULL || chunk_name == NULL || png_ptr->num_chunk_list<=0)
676
      return 0;
677 678
   p = png_ptr->chunk_list + png_ptr->num_chunk_list*5 - 5;
   for (i = png_ptr->num_chunk_list; i; i--, p -= 5)
679
      if (!png_memcmp(chunk_name, p, 4))
680
        return ((int)*(p + 4));
681 682 683
   return 0;
}
#endif
684 685

/* This function, added to libpng-1.0.6g, is untested. */
686
int PNGAPI
687 688
png_reset_zstream(png_structp png_ptr)
{
689 690
   if (png_ptr == NULL)
      return Z_STREAM_ERROR;
691 692
   return (inflateReset(&png_ptr->zstream));
}
693
#endif /* defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED) */
694

695
/* This function was added to libpng-1.0.7 */
696 697 698 699
png_uint_32 PNGAPI
png_access_version_number(void)
{
   /* Version of *.c files used when building libpng */
700
   return((png_uint_32) PNG_LIBPNG_VER);
701 702 703
}


704

705 706 707 708 709 710
#if defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED)
#ifdef PNG_SIZE_T
/* Added at libpng version 1.2.6 */
   PNG_EXTERN png_size_t PNGAPI png_convert_size PNGARG((size_t size));
png_size_t PNGAPI
png_convert_size(size_t size)
711
{
712 713 714
   if (size > (png_size_t)-1)
      PNG_ABORT();  /* We haven't got access to png_ptr, so no png_error() */
   return ((png_size_t)size);
715
}
716
#endif /* PNG_SIZE_T */
717

718
/* Added at libpng version 1.2.34 and 1.4.0 (moved from pngset.c) */
719
#if defined(PNG_cHRM_SUPPORTED)
720
#if defined(PNG_CHECK_cHRM_SUPPORTED)
721

722
/*
723 724 725 726 727 728 729 730 731 732 733 734
 *    Multiply two 32-bit numbers, V1 and V2, using 32-bit
 *    arithmetic, to produce a 64 bit result in the HI/LO words.
 *
 *                  A B
 *                x C D
 *               ------
 *              AD || BD
 *        AC || CB || 0
 *
 *    where A and B are the high and low 16-bit words of V1,
 *    C and D are the 16-bit words of V2, AD is the product of
 *    A and D, and X || Y is (X << 16) + Y.
735 736
*/

737 738
void /* PRIVATE */
png_64bit_product (long v1, long v2, unsigned long *hi_product,
739 740
   unsigned long *lo_product)
{
741 742
   int a, b, c, d;
   long lo, hi, x, y;
743

744 745 746 747
   a = (v1 >> 16) & 0xffff;
   b = v1 & 0xffff;
   c = (v2 >> 16) & 0xffff;
   d = v2 & 0xffff;
748

749 750 751
   lo = b * d;                   /* BD */
   x = a * d + c * b;            /* AD + CB */
   y = ((lo >> 16) & 0xffff) + x;
752

753 754
   lo = (lo & 0xffff) | ((y & 0xffff) << 16);
   hi = (y >> 16) & 0xffff;
755

756
   hi += a * c;                  /* AC */
757

758 759
   *hi_product = (unsigned long)hi;
   *lo_product = (unsigned long)lo;
760
}
761

762
int /* PRIVATE */
763 764 765 766 767 768
png_check_cHRM_fixed(png_structp png_ptr,
   png_fixed_point white_x, png_fixed_point white_y, png_fixed_point red_x,
   png_fixed_point red_y, png_fixed_point green_x, png_fixed_point green_y,
   png_fixed_point blue_x, png_fixed_point blue_y)
{
   int ret = 1;
769
   unsigned long xy_hi,xy_lo,yx_hi,yx_lo;
770 771

   png_debug(1, "in function png_check_cHRM_fixed");
772

773 774 775
   if (png_ptr == NULL)
      return 0;

776 777 778 779
   if (white_x < 0 || white_y <= 0 ||
         red_x < 0 ||   red_y <  0 ||
       green_x < 0 || green_y <  0 ||
        blue_x < 0 ||  blue_y <  0)
780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797
   {
      png_warning(png_ptr,
        "Ignoring attempt to set negative chromaticity value");
      ret = 0;
   }
   if (white_x > (png_fixed_point) PNG_UINT_31_MAX ||
       white_y > (png_fixed_point) PNG_UINT_31_MAX ||
         red_x > (png_fixed_point) PNG_UINT_31_MAX ||
         red_y > (png_fixed_point) PNG_UINT_31_MAX ||
       green_x > (png_fixed_point) PNG_UINT_31_MAX ||
       green_y > (png_fixed_point) PNG_UINT_31_MAX ||
        blue_x > (png_fixed_point) PNG_UINT_31_MAX ||
        blue_y > (png_fixed_point) PNG_UINT_31_MAX )
   {
      png_warning(png_ptr,
        "Ignoring attempt to set chromaticity value exceeding 21474.83");
      ret = 0;
   }
798
   if (white_x > 100000L - white_y)
799 800 801 802
   {
      png_warning(png_ptr, "Invalid cHRM white point");
      ret = 0;
   }
803
   if (red_x > 100000L - red_y)
804 805 806 807
   {
      png_warning(png_ptr, "Invalid cHRM red point");
      ret = 0;
   }
808
   if (green_x > 100000L - green_y)
809 810 811 812
   {
      png_warning(png_ptr, "Invalid cHRM green point");
      ret = 0;
   }
813
   if (blue_x > 100000L - blue_y)
814 815 816 817
   {
      png_warning(png_ptr, "Invalid cHRM blue point");
      ret = 0;
   }
818 819 820 821 822 823 824 825 826 827 828

   png_64bit_product(green_x - red_x, blue_y - red_y, &xy_hi, &xy_lo);
   png_64bit_product(green_y - red_y, blue_x - red_x, &yx_hi, &yx_lo);

   if (xy_hi == yx_hi && xy_lo == yx_lo)
   {
      png_warning(png_ptr,
         "Ignoring attempt to set cHRM RGB triangle with zero area");
      ret = 0;
   }

829 830
   return ret;
}
831
#endif /* PNG_CHECK_cHRM_SUPPORTED */
832
#endif /* PNG_cHRM_SUPPORTED */
833
#endif /* defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED) */