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

2 3
/* png.c - location for general purpose libpng functions
 *
4
 * libpng version 1.0.11beta3 - April 15, 2001
5
 * Copyright (c) 1998-2001 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
 */
G
Guy Schalnat 已提交
10 11 12 13 14

#define PNG_INTERNAL
#define PNG_NO_EXTERN
#include "png.h"

15
/* Generate a compiler error if there is an old png.h in the search path. */
16
typedef version_1_0_11beta3 Your_png_h_is_not_version_1_0_11beta3;
17

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

21
#ifdef PNG_USE_GLOBAL_ARRAYS
22
/* png_libpng_ver was changed to a function in version 1.0.5c */
23
const char png_libpng_ver[18] = "1.0.11beta3";
G
Guy Schalnat 已提交
24

25
/* png_sig was changed to a function in version 1.0.5c */
26
/* Place to hold the signature string for a PNG file. */
27
const png_byte FARDATA png_sig[8] = {137, 80, 78, 71, 13, 10, 26, 10};
28

29 30 31 32 33 34 35 36 37
/* 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;
38 39
PNG_iCCP;
PNG_iTXt;
40 41
PNG_oFFs;
PNG_pCAL;
42
PNG_sCAL;
43 44
PNG_pHYs;
PNG_sBIT;
45
PNG_sPLT;
46 47 48 49 50
PNG_sRGB;
PNG_tEXt;
PNG_tIME;
PNG_tRNS;
PNG_zTXt;
G
Guy Schalnat 已提交
51 52 53 54

/* arrays to facilitate easy interlacing - use pass (0 - 6) as index */

/* start of interlace block */
55
const int FARDATA png_pass_start[] = {0, 4, 0, 2, 0, 1, 0};
G
Guy Schalnat 已提交
56 57

/* offset to next interlace block */
58
const int FARDATA png_pass_inc[] = {8, 8, 4, 4, 2, 2, 1};
G
Guy Schalnat 已提交
59 60

/* start of interlace block in the y direction */
61
const int FARDATA png_pass_ystart[] = {0, 0, 4, 0, 2, 0, 1};
G
Guy Schalnat 已提交
62 63

/* offset to next interlace block in the y direction */
64
const int FARDATA png_pass_yinc[] = {8, 8, 8, 4, 4, 2, 2};
G
Guy Schalnat 已提交
65

66 67
/* width of interlace block (used in assembler routines only) */
#ifdef PNG_HAVE_ASSEMBLER_COMBINE_ROW
68
const int FARDATA png_pass_width[] = {8, 4, 4, 2, 2, 1, 1};
69
#endif
G
Guy Schalnat 已提交
70

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

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

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

83 84
#endif

A
Andreas Dilger 已提交
85 86 87 88 89
/* 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.
 */
90

91
void PNGAPI
A
Andreas Dilger 已提交
92 93
png_set_sig_bytes(png_structp png_ptr, int num_bytes)
{
A
Andreas Dilger 已提交
94
   png_debug(1, "in png_set_sig_bytes\n");
A
Andreas Dilger 已提交
95 96 97
   if (num_bytes > 8)
      png_error(png_ptr, "Too many bytes for PNG signature.");

98
   png_ptr->sig_bytes = (png_byte)(num_bytes < 0 ? 0 : num_bytes);
A
Andreas Dilger 已提交
99 100 101 102 103 104 105 106 107 108
}

/* 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).
 */
109
int PNGAPI
A
Andreas Dilger 已提交
110
png_sig_cmp(png_bytep sig, png_size_t start, png_size_t num_to_check)
G
Guy Schalnat 已提交
111
{
112
   png_byte png_signature[8] = {137, 80, 78, 71, 13, 10, 26, 10};
A
Andreas Dilger 已提交
113 114 115
   if (num_to_check > 8)
      num_to_check = 8;
   else if (num_to_check < 1)
116
      return (0);
A
Andreas Dilger 已提交
117

A
Andreas Dilger 已提交
118
   if (start > 7)
119
      return (0);
G
Guy Schalnat 已提交
120

A
Andreas Dilger 已提交
121 122 123
   if (start + num_to_check > 8)
      num_to_check = 8 - start;

124
   return ((int)(png_memcmp(&sig[start], &png_signature[start], num_to_check)));
A
Andreas Dilger 已提交
125 126 127
}

/* (Obsolete) function to check signature bytes.  It does not allow one
128 129
 * to check a partial signature.  This function might be removed in the
 * future - use png_sig_cmp().  Returns true (nonzero) if the file is a PNG.
130
 */
131
int PNGAPI
A
Andreas Dilger 已提交
132 133
png_check_sig(png_bytep sig, int num)
{
134
  return ((int)!png_sig_cmp(sig, (png_size_t)0, (png_size_t)num));
G
Guy Schalnat 已提交
135 136
}

137
/* Function to allocate memory for zlib and clear it to 0. */
138
voidpf /* PRIVATE */
G
Guy Schalnat 已提交
139
png_zalloc(voidpf png_ptr, uInt items, uInt size)
G
Guy Schalnat 已提交
140
{
141 142
   png_uint_32 num_bytes = (png_uint_32)items * size;
   png_voidp ptr = (png_voidp)png_malloc((png_structp)png_ptr, num_bytes);
G
Guy Schalnat 已提交
143

144
#ifndef PNG_NO_ZALLOC_ZERO
145
   if (ptr)
G
Guy Schalnat 已提交
146
   {
147 148 149 150 151 152 153 154 155 156
     if (num_bytes > (png_uint_32)0x8000L)
     {
        png_memset(ptr, 0, (png_size_t)0x8000L);
        png_memset((png_bytep)ptr + (png_size_t)0x8000L, 0,
           (png_size_t)(num_bytes - (png_uint_32)0x8000L));
     }
     else
     {
        png_memset(ptr, 0, (png_size_t)num_bytes);
     }
G
Guy Schalnat 已提交
157
   }
158
#endif
159
   return ((voidpf)ptr);
G
Guy Schalnat 已提交
160 161 162
}

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

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

A
Andreas Dilger 已提交
178
/* Calculate the CRC over a section of data.  We can only pass as
179 180 181 182
 * 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.
 */
183
void /* PRIVATE */
A
Andreas Dilger 已提交
184
png_calculate_crc(png_structp png_ptr, png_bytep ptr, png_size_t length)
G
Guy Schalnat 已提交
185
{
A
Andreas Dilger 已提交
186 187 188 189 190 191 192 193 194 195 196 197 198 199 200
   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)
201
      png_ptr->crc = crc32(png_ptr->crc, ptr, (uInt)length);
G
Guy Schalnat 已提交
202
}
G
Guy Schalnat 已提交
203

A
Andreas Dilger 已提交
204
/* Allocate the memory for an info_struct for the application.  We don't
205 206 207 208 209
 * really need the png_ptr, but it could potentially be useful in the
 * future.  This should be used in favour of malloc(sizeof(png_info))
 * 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.
 */
210
png_infop PNGAPI
G
Guy Schalnat 已提交
211 212 213 214
png_create_info_struct(png_structp png_ptr)
{
   png_infop info_ptr;

A
Andreas Dilger 已提交
215
   png_debug(1, "in png_create_info_struct\n");
216
   if(png_ptr == NULL) return (NULL);
217 218 219 220
#ifdef PNG_USER_MEM_SUPPORTED
   if ((info_ptr = (png_infop)png_create_struct_2(PNG_STRUCT_INFO,
      png_ptr->malloc_fn)) != NULL)
#else
G
Guy Schalnat 已提交
221
   if ((info_ptr = (png_infop)png_create_struct(PNG_STRUCT_INFO)) != NULL)
222
#endif
G
Guy Schalnat 已提交
223
   {
A
Andreas Dilger 已提交
224
      png_info_init(info_ptr);
G
Guy Schalnat 已提交
225 226
   }

227
   return (info_ptr);
G
Guy Schalnat 已提交
228 229
}

A
Andreas Dilger 已提交
230
/* This function frees the memory associated with a single info struct.
231 232 233 234
 * 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.
 */
235
void PNGAPI
A
Andreas Dilger 已提交
236 237 238 239
png_destroy_info_struct(png_structp png_ptr, png_infopp info_ptr_ptr)
{
   png_infop info_ptr = NULL;

A
Andreas Dilger 已提交
240 241
   png_debug(1, "in png_destroy_info_struct\n");
   if (info_ptr_ptr != NULL)
A
Andreas Dilger 已提交
242 243
      info_ptr = *info_ptr_ptr;

A
Andreas Dilger 已提交
244
   if (info_ptr != NULL)
A
Andreas Dilger 已提交
245 246 247
   {
      png_info_destroy(png_ptr, info_ptr);

248 249 250
#ifdef PNG_USER_MEM_SUPPORTED
      png_destroy_struct_2((png_voidp)info_ptr, png_ptr->free_fn);
#else
A
Andreas Dilger 已提交
251
      png_destroy_struct((png_voidp)info_ptr);
252
#endif
A
Andreas Dilger 已提交
253 254 255 256 257
      *info_ptr_ptr = (png_infop)NULL;
   }
}

/* Initialize the info structure.  This is now an internal function (0.89)
258 259 260
 * and applications using it are urged to use png_create_info_struct()
 * instead.
 */
261
void /* PRIVATE */
A
Andreas Dilger 已提交
262
png_info_init(png_infop info_ptr)
G
Guy Schalnat 已提交
263
{
A
Andreas Dilger 已提交
264
   png_debug(1, "in png_info_init\n");
G
Guy Schalnat 已提交
265
   /* set everything to 0 */
A
Andreas Dilger 已提交
266 267 268
   png_memset(info_ptr, 0, sizeof (png_info));
}

269
#ifdef PNG_FREE_ME_SUPPORTED
270
void PNGAPI
271 272 273 274 275 276 277 278 279 280 281 282 283 284
png_data_freer(png_structp png_ptr, png_infop info_ptr,
   int freer, png_uint_32 mask)
{
   png_debug(1, "in png_data_freer\n");
   if (png_ptr == NULL || info_ptr == NULL)
      return;
   if(freer == PNG_DESTROY_WILL_FREE_DATA)
      info_ptr->free_me |= mask;
   else if(freer == PNG_USER_WILL_FREE_DATA)
      info_ptr->free_me &= ~mask;
   else
      png_warning(png_ptr,
         "Unknown freer parameter in png_data_freer.");
}
285
#endif
286

287
void PNGAPI
288
png_free_data(png_structp png_ptr, png_infop info_ptr, png_uint_32 mask, int num)
289
{
290
   png_debug(1, "in png_free_data\n");
291 292
   if (png_ptr == NULL || info_ptr == NULL)
      return;
293 294 295

#if defined(PNG_TEXT_SUPPORTED)
/* free text item num or (if num == -1) all text items */
296
#ifdef PNG_FREE_ME_SUPPORTED
297
if ((mask & PNG_FREE_TEXT) & info_ptr->free_me)
298 299
#else
if (mask & PNG_FREE_TEXT)
300
#endif
301
{
302 303
   if (num != -1)
   {
304
     if (info_ptr->text && info_ptr->text[num].key)
305 306 307 308 309
     {
         png_free(png_ptr, info_ptr->text[num].key);
         info_ptr->text[num].key = NULL;
     }
   }
310
   else
311
   {
312 313 314 315 316 317
       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;
318 319 320 321 322 323
   }
}
#endif

#if defined(PNG_tRNS_SUPPORTED)
/* free any tRNS entry */
324
#ifdef PNG_FREE_ME_SUPPORTED
325
if ((mask & PNG_FREE_TRNS) & info_ptr->free_me)
326
#else
327
if ((mask & PNG_FREE_TRNS) && (png_ptr->flags & PNG_FLAG_FREE_TRNS))
328
#endif
329
{
330 331
    png_free(png_ptr, info_ptr->trans);
    info_ptr->valid &= ~PNG_INFO_tRNS;
332
    info_ptr->trans = NULL;
333 334 335 336 337
}
#endif

#if defined(PNG_sCAL_SUPPORTED)
/* free any sCAL entry */
338
#ifdef PNG_FREE_ME_SUPPORTED
339
if ((mask & PNG_FREE_SCAL) & info_ptr->free_me)
340 341 342
#else
if (mask & PNG_FREE_SCAL)
#endif
343
{
344
#if defined(PNG_FIXED_POINT_SUPPORTED) && !defined(PNG_FLOATING_POINT_SUPPORTED)
345 346
    png_free(png_ptr, info_ptr->scal_s_width);
    png_free(png_ptr, info_ptr->scal_s_height);
347 348
    info_ptr->scal_s_width = NULL;
    info_ptr->scal_s_height = NULL;
349
#endif
350
    info_ptr->valid &= ~PNG_INFO_sCAL;
351 352 353 354 355
}
#endif

#if defined(PNG_pCAL_SUPPORTED)
/* free any pCAL entry */
356
#ifdef PNG_FREE_ME_SUPPORTED
357
if ((mask & PNG_FREE_PCAL) & info_ptr->free_me)
358 359 360
#else
if (mask & PNG_FREE_PCAL)
#endif
361
{
362 363
    png_free(png_ptr, info_ptr->pcal_purpose);
    png_free(png_ptr, info_ptr->pcal_units);
364 365
    info_ptr->pcal_purpose = NULL;
    info_ptr->pcal_units = NULL;
366 367 368 369
    if (info_ptr->pcal_params != NULL)
    {
        int i;
        for (i = 0; i < (int)info_ptr->pcal_nparams; i++)
370
        {
371
          png_free(png_ptr, info_ptr->pcal_params[i]);
372 373
          info_ptr->pcal_params[i]=NULL;
        }
374
        png_free(png_ptr, info_ptr->pcal_params);
375
        info_ptr->pcal_params = NULL;
376 377
    }
    info_ptr->valid &= ~PNG_INFO_pCAL;
378 379 380 381
}
#endif

#if defined(PNG_iCCP_SUPPORTED)
382
/* free any iCCP entry */
383
#ifdef PNG_FREE_ME_SUPPORTED
384
if ((mask & PNG_FREE_ICCP) & info_ptr->free_me)
385
#else
386
if (mask & PNG_FREE_ICCP)
387
#endif
388
{
389 390
    png_free(png_ptr, info_ptr->iccp_name);
    png_free(png_ptr, info_ptr->iccp_profile);
391 392
    info_ptr->iccp_name = NULL;
    info_ptr->iccp_profile = NULL;
393
    info_ptr->valid &= ~PNG_INFO_iCCP;
394 395 396 397 398
}
#endif

#if defined(PNG_sPLT_SUPPORTED)
/* free a given sPLT entry, or (if num == -1) all sPLT entries */
399
#ifdef PNG_FREE_ME_SUPPORTED
400
if ((mask & PNG_FREE_SPLT) & info_ptr->free_me)
401
#else
402
if (mask & PNG_FREE_SPLT)
403
#endif
404 405 406
{
   if (num != -1)
   {
407 408 409 410
      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);
411 412
          info_ptr->splt_palettes[num].name = NULL;
          info_ptr->splt_palettes[num].entries = NULL;
413
      }
414 415 416
   }
   else
   {
417 418 419 420 421
       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);
422

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

#if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED)
433
#ifdef PNG_FREE_ME_SUPPORTED
434
if ((mask & PNG_FREE_UNKN) & info_ptr->free_me)
435
#else
436
if (mask & PNG_FREE_UNKN)
437
#endif
438 439 440
{
   if (num != -1)
   {
441 442 443 444 445
       if(info_ptr->unknown_chunks)
       {
          png_free(png_ptr, info_ptr->unknown_chunks[num].data);
          info_ptr->unknown_chunks[num].data = NULL;
       }
446 447 448
   }
   else
   {
449 450
       int i;

451 452 453 454
       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);
455

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

#if defined(PNG_hIST_SUPPORTED)
/* free any hIST entry */
466
#ifdef PNG_FREE_ME_SUPPORTED
467
if ((mask & PNG_FREE_HIST)  & info_ptr->free_me)
468
#else
469
if ((mask & PNG_FREE_HIST) && (png_ptr->flags & PNG_FLAG_FREE_HIST))
470
#endif
471
{
472
    png_free(png_ptr, info_ptr->hist);
473
    info_ptr->hist = NULL;
474
    info_ptr->valid &= ~PNG_INFO_hIST;
475 476 477 478
}
#endif

/* free any PLTE entry that was internally allocated */
479
#ifdef PNG_FREE_ME_SUPPORTED
480
if ((mask & PNG_FREE_PLTE) & info_ptr->free_me)
481
#else
482
if ((mask & PNG_FREE_PLTE) && (png_ptr->flags & PNG_FLAG_FREE_PLTE))
483
#endif
484
{
485
    png_zfree(png_ptr, info_ptr->palette);
486
    info_ptr->palette = NULL;
487 488
    info_ptr->valid &= ~PNG_INFO_PLTE;
    info_ptr->num_palette = 0;
489 490 491 492
}

#if defined(PNG_INFO_IMAGE_SUPPORTED)
/* free any image bits attached to the info structure */
493
#ifdef PNG_FREE_ME_SUPPORTED
494
if ((mask & PNG_FREE_ROWS) & info_ptr->free_me)
495 496
#else
if (mask & PNG_FREE_ROWS)
497
#endif
498 499 500
{
    if(info_ptr->row_pointers)
    {
501 502
       int row;
       for (row = 0; row < (int)info_ptr->height; row++)
503
       {
504
          png_free(png_ptr, info_ptr->row_pointers[row]);
505 506
          info_ptr->row_pointers[row]=NULL;
       }
507
       png_free(png_ptr, info_ptr->row_pointers);
508 509
       info_ptr->row_pointers=NULL;
    }
510
    info_ptr->valid &= ~PNG_INFO_IDAT;
511
}
512
#endif
513

514
#ifdef PNG_FREE_ME_SUPPORTED
515 516
   if(num == -1)
     info_ptr->free_me &= ~mask;
517 518
   else
     info_ptr->free_me &= ~(mask & ~PNG_FREE_MUL);
519
#endif
520
}
521

A
Andreas Dilger 已提交
522
/* This is an internal routine to free any memory that the info struct is
A
Andreas Dilger 已提交
523 524 525
 * pointing to before re-using it or freeing the struct itself.  Recall
 * that png_free() checks for NULL pointers for us.
 */
526
void /* PRIVATE */
A
Andreas Dilger 已提交
527 528
png_info_destroy(png_structp png_ptr, png_infop info_ptr)
{
A
Andreas Dilger 已提交
529
   png_debug(1, "in png_info_destroy\n");
530 531

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

533
#if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED)
534 535 536
   if (png_ptr->num_chunk_list)
   {
       png_free(png_ptr, png_ptr->chunk_list);
537
       png_ptr->chunk_list=NULL;
538 539
       png_ptr->num_chunk_list=0;
   }
A
Andreas Dilger 已提交
540
#endif
541

A
Andreas Dilger 已提交
542
   png_info_init(info_ptr);
G
Guy Schalnat 已提交
543
}
G
Guy Schalnat 已提交
544

G
Guy Schalnat 已提交
545
/* This function returns a pointer to the io_ptr associated with the user
546 547 548
 * functions.  The application should free any memory associated with this
 * pointer before png_write_destroy() or png_read_destroy() are called.
 */
549
png_voidp PNGAPI
G
Guy Schalnat 已提交
550 551
png_get_io_ptr(png_structp png_ptr)
{
552
   return (png_ptr->io_ptr);
G
Guy Schalnat 已提交
553
}
A
Andreas Dilger 已提交
554 555 556

#if !defined(PNG_NO_STDIO)
/* Initialize the default input/output functions for the PNG file.  If you
557
 * use your own read or write routines, you can call either png_set_read_fn()
558 559 560
 * 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.
561
 */
562
void PNGAPI
563
png_init_io(png_structp png_ptr, png_FILE_p fp)
G
Guy Schalnat 已提交
564
{
A
Andreas Dilger 已提交
565
   png_debug(1, "in png_init_io\n");
G
Guy Schalnat 已提交
566 567
   png_ptr->io_ptr = (png_voidp)fp;
}
A
Andreas Dilger 已提交
568
#endif
569 570 571 572 573

#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.
 */
574
png_charp PNGAPI
575 576 577
png_convert_to_rfc1123(png_structp png_ptr, png_timep ptime)
{
   static PNG_CONST char short_months[12][4] =
578 579
        {"Jan", "Feb", "Mar", "Apr", "May", "Jun",
         "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"};
580 581 582 583 584 585 586

   if (png_ptr->time_buffer == NULL)
   {
      png_ptr->time_buffer = (png_charp)png_malloc(png_ptr, (png_uint_32)(29*
         sizeof(char)));
   }

587 588 589 590
   if (png_ptr->time_buffer == NULL)
      png_warning(png_ptr, "Malloc of buffer for tIME chunk failed");
   else
   {
591
#if defined(_WIN32_WCE)
592 593 594 595 596 597 598 599 600
     {
        wchar_t time_buf[29];
        wsprintf(time_buf, TEXT("%d %S %d %02d:%02d:%02d +0000"),
            ptime->day % 32, short_months[(ptime->month - 1) % 12],
            ptime->year, ptime->hour % 24, ptime->minute % 60,
            ptime->second % 61);
        WideCharToMultiByte(CP_ACP, 0, time_buf, -1, png_ptr->time_buffer, 29,
            NULL, NULL);
     }
601
#else
602
#ifdef USE_FAR_KEYWORD
603 604 605 606 607 608 609 610 611
     {
        char near_time_buf[29];
        sprintf(near_time_buf, "%d %s %d %02d:%02d:%02d +0000",
            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,
            29*sizeof(char));
     }
612 613
#else
   sprintf(png_ptr->time_buffer, "%d %s %d %02d:%02d:%02d +0000",
614 615 616
       ptime->day % 32, short_months[(ptime->month - 1) % 12],
       ptime->year, ptime->hour % 24, ptime->minute % 60,
       ptime->second % 61);
617
#endif
618
#endif /* _WIN32_WCE */
619
   }
620 621 622
   return ((png_charp)png_ptr->time_buffer);
}
#endif /* PNG_TIME_RFC1123_SUPPORTED */
623

624
#if 0
625
/* Signature string for a PNG file. */
626
png_bytep PNGAPI
627
png_sig_bytes(void)
628
{
629
   return ((png_bytep)"\211\120\116\107\015\012\032\012");
630
}
631
#endif
632

633
png_charp PNGAPI
634 635
png_get_copyright(png_structp png_ptr)
{
636
   if (png_ptr != NULL || png_ptr == NULL)  /* silence compiler warning */
637
   return ((png_charp) "\n libpng version 1.0.11beta3 - April 15, 2001\n\
638
   Copyright (c) 1998-2001 Glenn Randers-Pehrson\n\
639
   Copyright (c) 1996, 1997 Andreas Dilger\n\
640
   Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.\n");
641
   return ((png_charp) "");
642
}
643

644 645 646 647 648 649
/* The following return the library version as a short string in the
 * 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.
 */

650
png_charp PNGAPI
651 652 653 654
png_get_libpng_ver(png_structp png_ptr)
{
   /* Version of *.c files used when building libpng */
   if(png_ptr != NULL) /* silence compiler warning about unused png_ptr */
655 656
      return((png_charp) "1.0.11beta3");
   return((png_charp) "1.0.11beta3");
657 658
}

659
png_charp PNGAPI
660 661 662 663
png_get_header_ver(png_structp png_ptr)
{
   /* Version of *.h files used when building libpng */
   if(png_ptr != NULL) /* silence compiler warning about unused png_ptr */
664 665
      return((png_charp) PNG_LIBPNG_VER_STRING);
   return((png_charp) PNG_LIBPNG_VER_STRING);
666 667
}

668
png_charp PNGAPI
669 670 671 672
png_get_header_version(png_structp png_ptr)
{
   /* Returns longer string containing both version and date */
   if(png_ptr != NULL) /* silence compiler warning about unused png_ptr */
673 674
      return((png_charp) PNG_HEADER_VERSION_STRING);
   return((png_charp) PNG_HEADER_VERSION_STRING);
675 676
}

677
#ifdef PNG_HANDLE_AS_UNKNOWN_SUPPORTED
678
int /* PRIVATE */
679 680 681 682 683 684 685 686 687 688 689 690 691 692
png_handle_as_unknown(png_structp png_ptr, png_bytep chunk_name)
{
   /* check chunk_name and return "keep" value if it's on the list, else 0 */
   int i;
   png_bytep p;
   if((png_ptr == NULL && chunk_name == NULL) || png_ptr->num_chunk_list<=0)
      return 0;
   p=png_ptr->chunk_list+png_ptr->num_chunk_list*5-5;
   for (i = png_ptr->num_chunk_list; i; i--, p-=5)
      if (!png_memcmp(chunk_name, p, 4))
        return ((int)*(p+4));
   return 0;
}
#endif
693 694

/* This function, added to libpng-1.0.6g, is untested. */
695
int PNGAPI
696 697 698 699
png_reset_zstream(png_structp png_ptr)
{
   return (inflateReset(&png_ptr->zstream));
}
700

701
/* This function was added to libpng-1.0.7 */
702 703 704 705
png_uint_32 PNGAPI
png_access_version_number(void)
{
   /* Version of *.c files used when building libpng */
706
   return((png_uint_32) 10011L);
707
}
708 709


710
#if 0 /* delay this until version 1.2.0 */
711 712 713 714 715 716 717 718
/* this function was added to libpng 1.0.9 (porting aid to libpng-1.2.0) */
#ifndef PNG_ASSEMBLER_CODE_SUPPORTED
int PNGAPI
png_mmx_support(void)
{
    return -1;
}
#endif
719
#endif /* 0 */