Subversion Repositories Kolibri OS

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
4680 right-hear 1
 
2
 *
3
 * For conditions of distribution and use, see copyright notice in png.h
4
 * Copyright (c) 1998-2011 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
 * Last changed in libpng 1.5.0 [January 6, 2011]
9
 *
10
 * This code is released under the libpng license.
11
 * For conditions of distribution and use, see the disclaimer
12
 * and license in png.h
13
 */
14
15
 
16
 * as PNG_EXTERN) are PRIVATE.  They are not part of the libpng public
17
 * interface, and are not recommended for use by regular applications.
18
 * Some of them may become public in the future; others may stay private,
19
 * change in an incompatible way, or even disappear.
20
 * Although the libpng users are not forbidden to include this header,
21
 * they should be well aware of the issues that may arise from doing so.
22
 */
23
24
 
25
#define PNGPRIV_H
26
27
 
28
 * error handler when all else fails.
29
 */
30
#include 
31
32
 
33
#ifdef PNG_USER_CONFIG
34
#  include "pngusr.h"
35
   /* These should have been defined in pngusr.h */
36
#  ifndef PNG_USER_PRIVATEBUILD
37
#    define PNG_USER_PRIVATEBUILD "Custom libpng build"
38
#  endif
39
#  ifndef PNG_USER_DLLFNAME_POSTFIX
40
#    define PNG_USER_DLLFNAME_POSTFIX "Cb"
41
#  endif
42
#endif
43
#include "png.h"
44
#include "pnginfo.h"
45
#include "pngstruct.h"
46
47
 
48
 * this could be changed:
49
 */
50
typedef PNG_CONST png_uint_16p FAR * png_const_uint_16pp;
51
52
 
53
/* Moved to pngpriv.h at libpng-1.5.0 */
54
55
 
56
 * script.  We may need it here to get the correct configuration on things
57
 * like limits.
58
 */
59
#ifdef PNG_CONFIGURE_LIBPNG
60
#  ifdef HAVE_CONFIG_H
61
#    include "config.h"
62
#  endif
63
#endif
64
65
 
66
/* NOTE: some of these may have been used in external applications as
67
 * these definitions were exposed in pngconf.h prior to 1.5.
68
 */
69
70
 
71
 * than 64K of memory at once, uncomment this.  While libpng will not
72
 * normally need that much memory in a chunk (unless you load up a very
73
 * large file), zlib needs to know how big of a chunk it can use, and
74
 * libpng thus makes sure to check any memory allocation to verify it
75
 * will fit into memory.
76
 *
77
 * zlib provides 'MAXSEG_64K' which, if defined, indicates the
78
 * same limit and pngconf.h (already included) sets the limit
79
 * if certain operating systems are detected.
80
 */
81
#if defined(MAXSEG_64K) && !defined(PNG_MAX_MALLOC_64K)
82
#  define PNG_MAX_MALLOC_64K
83
#endif
84
85
 
86
 * which is expected to have no bad effects on performance (optimizing
87
 * compilers will probably remove it entirely).  Note that if you replace
88
 * it with something other than whitespace, you must include the terminating
89
 * semicolon.
90
 */
91
#define PNG_UNUSED(param) (void)param;
92
93
 
94
 * contradictory.
95
 */
96
#if (PNG_ZBUF_SIZE > 65536L) && defined(PNG_MAX_MALLOC_64K)
97
#  undef PNG_ZBUF_SIZE
98
#  define PNG_ZBUF_SIZE 65536L
99
#endif
100
101
 
102
 * or redirected here.
103
 */
104
#ifndef PNG_WARNINGS_SUPPORTED
105
#  define png_warning(s1,s2) ((void)0)
106
#  define png_chunk_warning(s1,s2) ((void)0)
107
#endif
108
#ifndef PNG_ERROR_TEXT_SUPPORTED
109
#  define png_error(s1,s2) png_err(s1)
110
#  define png_chunk_error(s1,s2) png_err(s1)
111
#  define png_fixed_error(s1,s2) png_err(s1)
112
#endif
113
114
 
115
/* The functions exported by PNG_EXTERN are internal functions, which
116
 * aren't usually used outside the library (as far as I know), so it is
117
 * debatable if they should be exported at all.  In the future, when it
118
 * is possible to have run-time registry of chunk-handling functions,
119
 * some of these might be made available again.
120
#  define PNG_EXTERN extern
121
 */
122
#  define PNG_EXTERN
123
#endif
124
125
 
126
 * they get used by the corresponding floating point APIs.  This magic
127
 * deals with this:
128
 */
129
#ifdef PNG_FIXED_POINT_SUPPORTED
130
#  define PNGFAPI PNGAPI
131
#else
132
#  define PNGFAPI /* PRIVATE */
133
#endif
134
135
 
136
 * them inside an appropriate ifdef/endif pair for portability.
137
 */
138
#if defined(PNG_FLOATING_POINT_SUPPORTED) ||\
139
    defined(PNG_FLOATING_ARITHMETIC_SUPPORTED)
140
   /* png.c requires the following ANSI-C constants if the conversion of
141
    * floating point to ASCII is implemented therein:
142
    *
143
    *  DBL_DIG  Maximum number of decimal digits (can be set to any constant)
144
    *  DBL_MIN  Smallest normalized fp number (can be set to an arbitrary value)
145
    *  DBL_MAX  Maximum floating point number (can be set to an arbitrary value)
146
    */
147
#  include 
148
149
 
150
    defined(THINK_C) || defined(__SC__) || defined(TARGET_OS_MAC)
151
     /* We need to check that  hasn't already been included earlier
152
      * as it seems it doesn't agree with , yet we should really use
153
      *  if possible.
154
      */
155
#    if !defined(__MATH_H__) && !defined(__MATH_H) && !defined(__cmath__)
156
#      include 
157
#    endif
158
#  else
159
#    include 
160
#  endif
161
#  if defined(_AMIGA) && defined(__SASC) && defined(_M68881)
162
     /* Amiga SAS/C: We must include builtin FPU functions when compiling using
163
      * MATH=68881
164
      */
165
#    include 
166
#  endif
167
#endif
168
169
 
170
#if defined(__TURBOC__) && defined(__MSDOS__)
171
#  include 
172
#  include 
173
#endif
174
175
 
176
 
177
/* Users may want to use these so they are not private.  Any library
178
 * functions that are passed far data must be model-independent.
179
 */
180
181
 
182
#ifndef PNG_ABORT
183
#  ifdef _WINDOWS_
184
#    define PNG_ABORT() ExitProcess(0)
185
#  else
186
#    define PNG_ABORT() abort()
187
#  endif
188
#endif
189
190
 
191
/* Use this to make far-to-near assignments */
192
#  define CHECK   1
193
#  define NOCHECK 0
194
#  define CVT_PTR(ptr) (png_far_to_near(png_ptr,ptr,CHECK))
195
#  define CVT_PTR_NOCHECK(ptr) (png_far_to_near(png_ptr,ptr,NOCHECK))
196
#  define png_strcpy  _fstrcpy
197
#  define png_strncpy _fstrncpy   /* Added to v 1.2.6 */
198
#  define png_strlen  _fstrlen
199
#  define png_memcmp  _fmemcmp    /* SJT: added */
200
#  define png_memcpy  _fmemcpy
201
#  define png_memset  _fmemset
202
#  define png_sprintf sprintf
203
#else
204
#  ifdef _WINDOWS_  /* Favor Windows over C runtime fns */
205
#    define CVT_PTR(ptr)         (ptr)
206
#    define CVT_PTR_NOCHECK(ptr) (ptr)
207
#    define png_strcpy  lstrcpyA
208
#    define png_strncpy lstrcpynA
209
#    define png_strlen  lstrlenA
210
#    define png_memcmp  memcmp
211
#    define png_memcpy  CopyMemory
212
#    define png_memset  memset
213
#    define png_sprintf wsprintfA
214
#  else
215
#    define CVT_PTR(ptr)         (ptr)
216
#    define CVT_PTR_NOCHECK(ptr) (ptr)
217
#    define png_strcpy  strcpy
218
#    define png_strncpy strncpy     /* Added to v 1.2.6 */
219
#    define png_strlen  strlen
220
#    define png_memcmp  memcmp      /* SJT: added */
221
#    define png_memcpy  memcpy
222
#    define png_memset  memset
223
#    define png_sprintf sprintf
224
#  endif
225
#endif
226
/* End of memory model/platform independent support */
227
228
 
229
#  ifdef _MSC_VER
230
#    define png_snprintf _snprintf   /* Added to v 1.2.19 */
231
#    define png_snprintf2 _snprintf
232
#    define png_snprintf6 _snprintf
233
#  else
234
#    define png_snprintf snprintf   /* Added to v 1.2.19 */
235
#    define png_snprintf2 snprintf
236
#    define png_snprintf6 snprintf
237
#  endif
238
#else
239
  /* You don't have or don't want to use snprintf().  Caution: Using
240
   * sprintf instead of snprintf exposes your application to accidental
241
   * or malevolent buffer overflows.  If you don't have snprintf()
242
   * as a general rule you should provide one (you can get one from
243
   * Portable OpenSSH).
244
   */
245
#  define png_snprintf(s1,n,fmt,x1) png_sprintf(s1,fmt,x1)
246
#  define png_snprintf2(s1,n,fmt,x1,x2) png_sprintf(s1,fmt,x1,x2)
247
#  define png_snprintf6(s1,n,fmt,x1,x2,x3,x4,x5,x6) \
248
      png_sprintf(s1,fmt,x1,x2,x3,x4,x5,x6)
249
#endif
250
/* End of 1.5.0beta36 move from pngconf.h */
251
252
 
253
 * These are used internally by libpng and not exposed in the API
254
 */
255
256
 
257
 * zero automatically when the structure is created.
258
 */
259
#define PNG_HAVE_IHDR               0x01
260
#define PNG_HAVE_PLTE               0x02
261
#define PNG_HAVE_IDAT               0x04
262
#define PNG_AFTER_IDAT              0x08 /* Have complete zlib datastream */
263
#define PNG_HAVE_IEND               0x10
264
#define PNG_HAVE_gAMA               0x20
265
#define PNG_HAVE_cHRM               0x40
266
#define PNG_HAVE_sRGB               0x80
267
#define PNG_HAVE_CHUNK_HEADER      0x100
268
#define PNG_WROTE_tIME             0x200
269
#define PNG_WROTE_INFO_BEFORE_PLTE 0x400
270
#define PNG_BACKGROUND_IS_GRAY     0x800
271
#define PNG_HAVE_PNG_SIGNATURE    0x1000
272
#define PNG_HAVE_CHUNK_AFTER_IDAT 0x2000 /* Have another chunk after IDAT */
273
274
 
275
#define PNG_BGR                 0x0001
276
#define PNG_INTERLACE           0x0002
277
#define PNG_PACK                0x0004
278
#define PNG_SHIFT               0x0008
279
#define PNG_SWAP_BYTES          0x0010
280
#define PNG_INVERT_MONO         0x0020
281
#define PNG_QUANTIZE            0x0040
282
#define PNG_BACKGROUND          0x0080
283
#define PNG_BACKGROUND_EXPAND   0x0100
284
                          /*    0x0200 unused */
285
#define PNG_16_TO_8             0x0400
286
#define PNG_RGBA                0x0800
287
#define PNG_EXPAND              0x1000
288
#define PNG_GAMMA               0x2000
289
#define PNG_GRAY_TO_RGB         0x4000
290
#define PNG_FILLER              0x8000L
291
#define PNG_PACKSWAP           0x10000L
292
#define PNG_SWAP_ALPHA         0x20000L
293
#define PNG_STRIP_ALPHA        0x40000L
294
#define PNG_INVERT_ALPHA       0x80000L
295
#define PNG_USER_TRANSFORM    0x100000L
296
#define PNG_RGB_TO_GRAY_ERR   0x200000L
297
#define PNG_RGB_TO_GRAY_WARN  0x400000L
298
#define PNG_RGB_TO_GRAY       0x600000L  /* two bits, RGB_TO_GRAY_ERR|WARN */
299
                       /*     0x800000L     Unused */
300
#define PNG_ADD_ALPHA         0x1000000L  /* Added to libpng-1.2.7 */
301
#define PNG_EXPAND_tRNS       0x2000000L  /* Added to libpng-1.2.9 */
302
                       /*   0x4000000L  unused */
303
                       /*   0x8000000L  unused */
304
                       /*  0x10000000L  unused */
305
                       /*  0x20000000L  unused */
306
                       /*  0x40000000L  unused */
307
308
 
309
#define PNG_STRUCT_PNG   0x0001
310
#define PNG_STRUCT_INFO  0x0002
311
312
 
313
#define PNG_WEIGHT_FACTOR (1<<(PNG_WEIGHT_SHIFT))
314
#define PNG_COST_FACTOR (1<<(PNG_COST_SHIFT))
315
316
 
317
#define PNG_FLAG_ZLIB_CUSTOM_STRATEGY     0x0001
318
#define PNG_FLAG_ZLIB_CUSTOM_LEVEL        0x0002
319
#define PNG_FLAG_ZLIB_CUSTOM_MEM_LEVEL    0x0004
320
#define PNG_FLAG_ZLIB_CUSTOM_WINDOW_BITS  0x0008
321
#define PNG_FLAG_ZLIB_CUSTOM_METHOD       0x0010
322
#define PNG_FLAG_ZLIB_FINISHED            0x0020
323
#define PNG_FLAG_ROW_INIT                 0x0040
324
#define PNG_FLAG_FILLER_AFTER             0x0080
325
#define PNG_FLAG_CRC_ANCILLARY_USE        0x0100
326
#define PNG_FLAG_CRC_ANCILLARY_NOWARN     0x0200
327
#define PNG_FLAG_CRC_CRITICAL_USE         0x0400
328
#define PNG_FLAG_CRC_CRITICAL_IGNORE      0x0800
329
                                /*        0x1000  unused */
330
                                /*        0x2000  unused */
331
                                /*        0x4000  unused */
332
#define PNG_FLAG_KEEP_UNKNOWN_CHUNKS      0x8000L
333
#define PNG_FLAG_KEEP_UNSAFE_CHUNKS       0x10000L
334
#define PNG_FLAG_LIBRARY_MISMATCH         0x20000L
335
#define PNG_FLAG_STRIP_ERROR_NUMBERS      0x40000L
336
#define PNG_FLAG_STRIP_ERROR_TEXT         0x80000L
337
#define PNG_FLAG_MALLOC_NULL_MEM_OK       0x100000L
338
#define PNG_FLAG_ADD_ALPHA                0x200000L  /* Added to libpng-1.2.8 */
339
#define PNG_FLAG_STRIP_ALPHA              0x400000L  /* Added to libpng-1.2.8 */
340
#define PNG_FLAG_BENIGN_ERRORS_WARN       0x800000L  /* Added to libpng-1.4.0 */
341
                                  /*     0x1000000L  unused */
342
                                  /*     0x2000000L  unused */
343
                                  /*     0x4000000L  unused */
344
                                  /*     0x8000000L  unused */
345
                                  /*    0x10000000L  unused */
346
                                  /*    0x20000000L  unused */
347
                                  /*    0x40000000L  unused */
348
349
 
350
                                     PNG_FLAG_CRC_ANCILLARY_NOWARN)
351
352
 
353
                                     PNG_FLAG_CRC_CRITICAL_IGNORE)
354
355
 
356
                                     PNG_FLAG_CRC_CRITICAL_MASK)
357
358
 
359
 * can handle at once.  This type need be no larger than 16 bits (so maximum of
360
 * 65535), this define allows us to discover how big it is, but limited by the
361
 * maximuum for png_size_t.  The value can be overriden in a library build
362
 * (pngusr.h, or set it in CPPFLAGS) and it works to set it to a considerably
363
 * lower value (e.g. 255 works).  A lower value may help memory usage (slightly)
364
 * and may even improve performance on some systems (and degrade it on others.)
365
 */
366
#ifndef ZLIB_IO_MAX
367
#  define ZLIB_IO_MAX ((uInt)-1)
368
#endif
369
370
 
371
372
 
373
   abs((int)((c1).green) - (int)((c2).green)) + \
374
   abs((int)((c1).blue) - (int)((c2).blue)))
375
376
 
377
#define PNG_ROWBYTES(pixel_bits, width) \
378
    ((pixel_bits) >= 8 ? \
379
    ((png_size_t)(width) * (((png_size_t)(pixel_bits)) >> 3)) : \
380
    (( ((png_size_t)(width) * ((png_size_t)(pixel_bits))) + 7) >> 3) )
381
382
 
383
 * ideal-delta..ideal+delta.  Each argument is evaluated twice.
384
 * "ideal" and "delta" should be constants, normally simple
385
 * integers, "value" a variable. Added to libpng-1.2.6 JB
386
 */
387
#define PNG_OUT_OF_RANGE(value, ideal, delta) \
388
   ( (value) < (ideal)-(delta) || (value) > (ideal)+(delta) )
389
390
 
391
 * required (to make sure the code doesn't accidentally use float
392
 * when it is supposedly disabled.)
393
 */
394
#ifdef PNG_FLOATING_POINT_SUPPORTED
395
/* The floating point conversion can't overflow, though it can and
396
 * does lose accuracy relative to the original fixed point value.
397
 * In practice this doesn't matter because png_fixed_point only
398
 * stores numbers with very low precision.  The png_ptr and s
399
 * arguments are unused by default but are there in case error
400
 * checking becomes a requirement.
401
 */
402
#define png_float(png_ptr, fixed, s) (.00001 * (fixed))
403
404
 
405
 * its argument multiple times, so must be used with care.  The
406
 * range checking uses the PNG specification values for a signed
407
 * 32 bit fixed point value except that the values are deliberately
408
 * rounded-to-zero to an integral value - 21474 (21474.83 is roughly
409
 * (2^31-1) * 100000). 's' is a string that describes the value being
410
 * converted.
411
 *
412
 * NOTE: this macro will raise a png_error if the range check fails,
413
 * therefore it is normally only appropriate to use this on values
414
 * that come from API calls or other sources where an out of range
415
 * error indicates a programming error, not a data error!
416
 *
417
 * NOTE: by default this is off - the macro is not used - because the
418
 * function call saves a lot of code.
419
 */
420
#ifdef PNG_FIXED_POINT_MACRO_SUPPORTED
421
#define png_fixed(png_ptr, fp, s) ((fp) <= 21474 && (fp) >= -21474 ?\
422
    ((png_fixed_point)(100000 * (fp))) : (png_fixed_error(png_ptr, s),0))
423
#else
424
PNG_EXTERN png_fixed_point png_fixed PNGARG((png_structp png_ptr, double fp,
425
   png_const_charp text));
426
#endif
427
#endif
428
429
 
430
 * define the name here, and add an invocation of the macro wherever it's
431
 * needed.
432
 */
433
#define PNG_IHDR PNG_CONST png_byte png_IHDR[5] = { 73,  72,  68,  82, '\0'}
434
#define PNG_IDAT PNG_CONST png_byte png_IDAT[5] = { 73,  68,  65,  84, '\0'}
435
#define PNG_IEND PNG_CONST png_byte png_IEND[5] = { 73,  69,  78,  68, '\0'}
436
#define PNG_PLTE PNG_CONST png_byte png_PLTE[5] = { 80,  76,  84,  69, '\0'}
437
#define PNG_bKGD PNG_CONST png_byte png_bKGD[5] = { 98,  75,  71,  68, '\0'}
438
#define PNG_cHRM PNG_CONST png_byte png_cHRM[5] = { 99,  72,  82,  77, '\0'}
439
#define PNG_gAMA PNG_CONST png_byte png_gAMA[5] = {103,  65,  77,  65, '\0'}
440
#define PNG_hIST PNG_CONST png_byte png_hIST[5] = {104,  73,  83,  84, '\0'}
441
#define PNG_iCCP PNG_CONST png_byte png_iCCP[5] = {105,  67,  67,  80, '\0'}
442
#define PNG_iTXt PNG_CONST png_byte png_iTXt[5] = {105,  84,  88, 116, '\0'}
443
#define PNG_oFFs PNG_CONST png_byte png_oFFs[5] = {111,  70,  70, 115, '\0'}
444
#define PNG_pCAL PNG_CONST png_byte png_pCAL[5] = {112,  67,  65,  76, '\0'}
445
#define PNG_sCAL PNG_CONST png_byte png_sCAL[5] = {115,  67,  65,  76, '\0'}
446
#define PNG_pHYs PNG_CONST png_byte png_pHYs[5] = {112,  72,  89, 115, '\0'}
447
#define PNG_sBIT PNG_CONST png_byte png_sBIT[5] = {115,  66,  73,  84, '\0'}
448
#define PNG_sPLT PNG_CONST png_byte png_sPLT[5] = {115,  80,  76,  84, '\0'}
449
#define PNG_sRGB PNG_CONST png_byte png_sRGB[5] = {115,  82,  71,  66, '\0'}
450
#define PNG_sTER PNG_CONST png_byte png_sTER[5] = {115,  84,  69,  82, '\0'}
451
#define PNG_tEXt PNG_CONST png_byte png_tEXt[5] = {116,  69,  88, 116, '\0'}
452
#define PNG_tIME PNG_CONST png_byte png_tIME[5] = {116,  73,  77,  69, '\0'}
453
#define PNG_tRNS PNG_CONST png_byte png_tRNS[5] = {116,  82,  78,  83, '\0'}
454
#define PNG_zTXt PNG_CONST png_byte png_zTXt[5] = {122,  84,  88, 116, '\0'}
455
456
 
457
 
458
#ifdef __cplusplus
459
extern "C" {
460
#endif /* __cplusplus */
461
462
 
463
 * shouldn't be used unless you are writing code to add or replace some
464
 * functionality in libpng.  More information about most functions can
465
 * be found in the files where the functions are located.
466
 */
467
468
 
469
PNG_EXTERN PNG_FUNCTION(png_voidp,png_create_struct,PNGARG((int type)),
470
   PNG_ALLOCATED);
471
472
 
473
PNG_EXTERN void png_destroy_struct PNGARG((png_voidp struct_ptr));
474
475
 
476
   PNGARG((int type, png_malloc_ptr malloc_fn, png_voidp mem_ptr)),
477
   PNG_ALLOCATED);
478
PNG_EXTERN void png_destroy_struct_2 PNGARG((png_voidp struct_ptr,
479
    png_free_ptr free_fn, png_voidp mem_ptr));
480
481
 
482
PNG_EXTERN void png_info_destroy PNGARG((png_structp png_ptr,
483
    png_infop info_ptr));
484
485
 
486
PNG_EXTERN PNG_FUNCTION(voidpf,png_zalloc,PNGARG((voidpf png_ptr, uInt items,
487
   uInt size)),PNG_ALLOCATED);
488
489
 
490
PNG_EXTERN void png_zfree PNGARG((voidpf png_ptr, voidpf ptr));
491
492
 
493
 * but not PNG_EXPORT.  PNGAPI added at libpng version 1.2.3, changed to
494
 * PNGCBAPI at 1.5.0
495
 */
496
497
 
498
    png_bytep data, png_size_t length));
499
500
 
501
PNG_EXTERN void PNGCBAPI png_push_fill_buffer PNGARG((png_structp png_ptr,
502
    png_bytep buffer, png_size_t length));
503
#endif
504
505
 
506
    png_bytep data, png_size_t length));
507
508
 
509
#  ifdef PNG_STDIO_SUPPORTED
510
PNG_EXTERN void PNGCBAPI png_default_flush PNGARG((png_structp png_ptr));
511
#  endif
512
#endif
513
514
 
515
PNG_EXTERN void png_reset_crc PNGARG((png_structp png_ptr));
516
517
 
518
PNG_EXTERN void png_write_data PNGARG((png_structp png_ptr,
519
    png_const_bytep data, png_size_t length));
520
521
 
522
PNG_EXTERN void png_read_sig PNGARG((png_structp png_ptr, png_infop info_ptr));
523
524
 
525
PNG_EXTERN png_uint_32 png_read_chunk_header PNGARG((png_structp png_ptr));
526
527
 
528
PNG_EXTERN void png_read_data PNGARG((png_structp png_ptr, png_bytep data,
529
    png_size_t length));
530
531
 
532
PNG_EXTERN void png_crc_read PNGARG((png_structp png_ptr, png_bytep buf,
533
    png_size_t length));
534
535
 
536
#if defined(PNG_zTXt_SUPPORTED) || defined(PNG_iTXt_SUPPORTED) || \
537
    defined(PNG_iCCP_SUPPORTED) || defined(PNG_sPLT_SUPPORTED)
538
PNG_EXTERN void png_decompress_chunk PNGARG((png_structp png_ptr,
539
    int comp_type, png_size_t chunklength, png_size_t prefix_length,
540
    png_size_t *data_length));
541
#endif
542
543
 
544
PNG_EXTERN int png_crc_finish PNGARG((png_structp png_ptr, png_uint_32 skip));
545
546
 
547
PNG_EXTERN int png_crc_error PNGARG((png_structp png_ptr));
548
549
 
550
 * passing a maximum of 64K on systems that have this as a memory limit,
551
 * since this is the maximum buffer size we can specify.
552
 */
553
PNG_EXTERN void png_calculate_crc PNGARG((png_structp png_ptr,
554
    png_const_bytep ptr, png_size_t length));
555
556
 
557
PNG_EXTERN void png_flush PNGARG((png_structp png_ptr));
558
#endif
559
560
 
561
562
 
563
 * information.
564
 */
565
PNG_EXTERN void png_write_IHDR PNGARG((png_structp png_ptr, png_uint_32 width,
566
    png_uint_32 height,
567
    int bit_depth, int color_type, int compression_method, int filter_method,
568
    int interlace_method));
569
570
 
571
    png_const_colorp palette, png_uint_32 num_pal));
572
573
 
574
    png_size_t length));
575
576
 
577
578
 
579
#  ifdef PNG_FLOATING_POINT_SUPPORTED
580
PNG_EXTERN void png_write_gAMA PNGARG((png_structp png_ptr, double file_gamma));
581
#  endif
582
#  ifdef PNG_FIXED_POINT_SUPPORTED
583
PNG_EXTERN void png_write_gAMA_fixed PNGARG((png_structp png_ptr,
584
    png_fixed_point file_gamma));
585
#  endif
586
#endif
587
588
 
589
PNG_EXTERN void png_write_sBIT PNGARG((png_structp png_ptr,
590
    png_const_color_8p sbit, int color_type));
591
#endif
592
593
 
594
#  ifdef PNG_FLOATING_POINT_SUPPORTED
595
PNG_EXTERN void png_write_cHRM PNGARG((png_structp png_ptr,
596
    double white_x, double white_y,
597
    double red_x, double red_y, double green_x, double green_y,
598
    double blue_x, double blue_y));
599
#  endif
600
PNG_EXTERN void png_write_cHRM_fixed PNGARG((png_structp png_ptr,
601
    png_fixed_point int_white_x, png_fixed_point int_white_y,
602
    png_fixed_point int_red_x, png_fixed_point int_red_y, png_fixed_point
603
    int_green_x, png_fixed_point int_green_y, png_fixed_point int_blue_x,
604
    png_fixed_point int_blue_y));
605
#endif
606
607
 
608
PNG_EXTERN void png_write_sRGB PNGARG((png_structp png_ptr,
609
    int intent));
610
#endif
611
612
 
613
PNG_EXTERN void png_write_iCCP PNGARG((png_structp png_ptr,
614
    png_const_charp name, int compression_type,
615
    png_const_charp profile, int proflen));
616
   /* Note to maintainer: profile should be png_bytep */
617
#endif
618
619
 
620
PNG_EXTERN void png_write_sPLT PNGARG((png_structp png_ptr,
621
    png_const_sPLT_tp palette));
622
#endif
623
624
 
625
PNG_EXTERN void png_write_tRNS PNGARG((png_structp png_ptr,
626
    png_const_bytep trans, png_const_color_16p values, int number,
627
    int color_type));
628
#endif
629
630
 
631
PNG_EXTERN void png_write_bKGD PNGARG((png_structp png_ptr,
632
    png_const_color_16p values, int color_type));
633
#endif
634
635
 
636
PNG_EXTERN void png_write_hIST PNGARG((png_structp png_ptr,
637
    png_const_uint_16p hist, int num_hist));
638
#endif
639
640
 
641
    defined(PNG_WRITE_iCCP_SUPPORTED) || defined(PNG_WRITE_sPLT_SUPPORTED)
642
PNG_EXTERN png_size_t png_check_keyword PNGARG((png_structp png_ptr,
643
    png_const_charp key, png_charpp new_key));
644
#endif
645
646
 
647
PNG_EXTERN void png_write_tEXt PNGARG((png_structp png_ptr, png_const_charp key,
648
    png_const_charp text, png_size_t text_len));
649
#endif
650
651
 
652
PNG_EXTERN void png_write_zTXt PNGARG((png_structp png_ptr, png_const_charp key,
653
    png_const_charp text, png_size_t text_len, int compression));
654
#endif
655
656
 
657
PNG_EXTERN void png_write_iTXt PNGARG((png_structp png_ptr,
658
    int compression, png_const_charp key, png_const_charp lang,
659
    png_const_charp lang_key, png_const_charp text));
660
#endif
661
662
 
663
PNG_EXTERN int png_set_text_2 PNGARG((png_structp png_ptr,
664
    png_infop info_ptr, png_const_textp text_ptr, int num_text));
665
#endif
666
667
 
668
PNG_EXTERN void png_write_oFFs PNGARG((png_structp png_ptr,
669
    png_int_32 x_offset, png_int_32 y_offset, int unit_type));
670
#endif
671
672
 
673
PNG_EXTERN void png_write_pCAL PNGARG((png_structp png_ptr, png_charp purpose,
674
    png_int_32 X0, png_int_32 X1, int type, int nparams,
675
    png_const_charp units, png_charpp params));
676
#endif
677
678
 
679
PNG_EXTERN void png_write_pHYs PNGARG((png_structp png_ptr,
680
    png_uint_32 x_pixels_per_unit, png_uint_32 y_pixels_per_unit,
681
    int unit_type));
682
#endif
683
684
 
685
PNG_EXTERN void png_write_tIME PNGARG((png_structp png_ptr,
686
    png_const_timep mod_time));
687
#endif
688
689
 
690
PNG_EXTERN void png_write_sCAL_s PNGARG((png_structp png_ptr,
691
    int unit, png_const_charp width, png_const_charp height));
692
#endif
693
694
 
695
PNG_EXTERN void png_write_finish_row PNGARG((png_structp png_ptr));
696
697
 
698
PNG_EXTERN void png_write_start_row PNGARG((png_structp png_ptr));
699
700
 
701
PNG_EXTERN void png_combine_row PNGARG((png_structp png_ptr, png_bytep row,
702
    int mask));
703
704
 
705
/* Expand an interlaced row */
706
/* OLD pre-1.0.9 interface:
707
PNG_EXTERN void png_do_read_interlace PNGARG((png_row_infop row_info,
708
    png_bytep row, int pass, png_uint_32 transformations));
709
 */
710
PNG_EXTERN void png_do_read_interlace PNGARG((png_structp png_ptr));
711
#endif
712
713
 
714
715
 
716
/* Grab pixels out of a row for an interlaced pass */
717
PNG_EXTERN void png_do_write_interlace PNGARG((png_row_infop row_info,
718
    png_bytep row, int pass));
719
#endif
720
721
 
722
PNG_EXTERN void png_read_filter_row PNGARG((png_structp png_ptr,
723
    png_row_infop row_info, png_bytep row, png_const_bytep prev_row,
724
    int filter));
725
726
 
727
PNG_EXTERN void png_write_find_filter PNGARG((png_structp png_ptr,
728
    png_row_infop row_info));
729
730
 
731
PNG_EXTERN void png_write_filtered_row PNGARG((png_structp png_ptr,
732
    png_bytep filtered_row));
733
/* Finish a row while reading, dealing with interlacing passes, etc. */
734
PNG_EXTERN void png_read_finish_row PNGARG((png_structp png_ptr));
735
736
 
737
PNG_EXTERN void png_read_start_row PNGARG((png_structp png_ptr));
738
/* Optional call to update the users info structure */
739
PNG_EXTERN void png_read_transform_info PNGARG((png_structp png_ptr,
740
    png_infop info_ptr));
741
742
 
743
#ifdef PNG_READ_FILLER_SUPPORTED
744
PNG_EXTERN void png_do_read_filler PNGARG((png_row_infop row_info,
745
    png_bytep row, png_uint_32 filler, png_uint_32 flags));
746
#endif
747
748
 
749
PNG_EXTERN void png_do_read_swap_alpha PNGARG((png_row_infop row_info,
750
    png_bytep row));
751
#endif
752
753
 
754
PNG_EXTERN void png_do_write_swap_alpha PNGARG((png_row_infop row_info,
755
    png_bytep row));
756
#endif
757
758
 
759
PNG_EXTERN void png_do_read_invert_alpha PNGARG((png_row_infop row_info,
760
    png_bytep row));
761
#endif
762
763
 
764
PNG_EXTERN void png_do_write_invert_alpha PNGARG((png_row_infop row_info,
765
    png_bytep row));
766
#endif
767
768
 
769
    defined(PNG_READ_STRIP_ALPHA_SUPPORTED)
770
PNG_EXTERN void png_do_strip_filler PNGARG((png_row_infop row_info,
771
    png_bytep row, png_uint_32 flags));
772
#endif
773
774
 
775
#if defined(PNG_READ_SWAP_SUPPORTED) || defined(PNG_WRITE_SWAP_SUPPORTED)
776
PNG_EXTERN void png_do_swap PNGARG((png_row_infop row_info,
777
    png_bytep row));
778
#endif
779
#endif
780
781
 
782
    defined(PNG_WRITE_PACKSWAP_SUPPORTED)
783
PNG_EXTERN void png_do_packswap PNGARG((png_row_infop row_info,
784
    png_bytep row));
785
#endif
786
787
 
788
PNG_EXTERN int png_do_rgb_to_gray PNGARG((png_structp png_ptr,
789
    png_row_infop row_info, png_bytep row));
790
#endif
791
792
 
793
PNG_EXTERN void png_do_gray_to_rgb PNGARG((png_row_infop row_info,
794
    png_bytep row));
795
#endif
796
797
 
798
PNG_EXTERN void png_do_unpack PNGARG((png_row_infop row_info,
799
    png_bytep row));
800
#endif
801
802
 
803
PNG_EXTERN void png_do_unshift PNGARG((png_row_infop row_info,
804
    png_bytep row, png_const_color_8p sig_bits));
805
#endif
806
807
 
808
PNG_EXTERN void png_do_invert PNGARG((png_row_infop row_info,
809
    png_bytep row));
810
#endif
811
812
 
813
PNG_EXTERN void png_do_chop PNGARG((png_row_infop row_info,
814
    png_bytep row));
815
#endif
816
817
 
818
PNG_EXTERN void png_do_quantize PNGARG((png_row_infop row_info,
819
    png_bytep row, png_const_bytep palette_lookup,
820
    png_const_bytep quantize_lookup));
821
822
 
823
PNG_EXTERN void png_correct_palette PNGARG((png_structp png_ptr,
824
    png_colorp palette, int num_palette));
825
#  endif
826
#endif
827
828
 
829
PNG_EXTERN void png_do_bgr PNGARG((png_row_infop row_info,
830
    png_bytep row));
831
#endif
832
833
 
834
PNG_EXTERN void png_do_pack PNGARG((png_row_infop row_info,
835
   png_bytep row, png_uint_32 bit_depth));
836
#endif
837
838
 
839
PNG_EXTERN void png_do_shift PNGARG((png_row_infop row_info,
840
    png_bytep row, png_const_color_8p bit_depth));
841
#endif
842
843
 
844
#  ifdef PNG_READ_GAMMA_SUPPORTED
845
PNG_EXTERN void png_do_background PNGARG((png_row_infop row_info,
846
    png_bytep row, png_const_color_16p trans_color,
847
    png_const_color_16p background, png_const_color_16p background_1,
848
    png_const_bytep gamma_table, png_const_bytep gamma_from_1,
849
    png_const_bytep gamma_to_1, png_const_uint_16pp gamma_16,
850
    png_const_uint_16pp gamma_16_from_1, png_const_uint_16pp gamma_16_to_1,
851
    int gamma_shift));
852
#  else
853
PNG_EXTERN void png_do_background PNGARG((png_row_infop row_info,
854
    png_bytep row, png_const_color_16p trans_color,
855
    png_const_color_16p background));
856
#  endif
857
#endif
858
859
 
860
PNG_EXTERN void png_do_gamma PNGARG((png_row_infop row_info,
861
    png_bytep row, png_const_bytep gamma_table,
862
    png_const_uint_16pp gamma_16_table, int gamma_shift));
863
#endif
864
865
 
866
PNG_EXTERN void png_do_expand_palette PNGARG((png_row_infop row_info,
867
    png_bytep row, png_const_colorp palette, png_const_bytep trans,
868
    int num_trans));
869
PNG_EXTERN void png_do_expand PNGARG((png_row_infop row_info,
870
    png_bytep row, png_const_color_16p trans_color));
871
#endif
872
873
 
874
 * then calls the appropriate callback for the chunk if it is valid.
875
 */
876
877
 
878
PNG_EXTERN void png_handle_IHDR PNGARG((png_structp png_ptr, png_infop info_ptr,
879
    png_uint_32 length));
880
PNG_EXTERN void png_handle_PLTE PNGARG((png_structp png_ptr, png_infop info_ptr,
881
    png_uint_32 length));
882
PNG_EXTERN void png_handle_IEND PNGARG((png_structp png_ptr, png_infop info_ptr,
883
    png_uint_32 length));
884
885
 
886
PNG_EXTERN void png_handle_bKGD PNGARG((png_structp png_ptr, png_infop info_ptr,
887
    png_uint_32 length));
888
#endif
889
890
 
891
PNG_EXTERN void png_handle_cHRM PNGARG((png_structp png_ptr, png_infop info_ptr,
892
    png_uint_32 length));
893
#endif
894
895
 
896
PNG_EXTERN void png_handle_gAMA PNGARG((png_structp png_ptr, png_infop info_ptr,
897
    png_uint_32 length));
898
#endif
899
900
 
901
PNG_EXTERN void png_handle_hIST PNGARG((png_structp png_ptr, png_infop info_ptr,
902
    png_uint_32 length));
903
#endif
904
905
 
906
PNG_EXTERN void png_handle_iCCP PNGARG((png_structp png_ptr, png_infop info_ptr,
907
    png_uint_32 length));
908
#endif /* PNG_READ_iCCP_SUPPORTED */
909
910
 
911
PNG_EXTERN void png_handle_iTXt PNGARG((png_structp png_ptr, png_infop info_ptr,
912
    png_uint_32 length));
913
#endif
914
915
 
916
PNG_EXTERN void png_handle_oFFs PNGARG((png_structp png_ptr, png_infop info_ptr,
917
    png_uint_32 length));
918
#endif
919
920
 
921
PNG_EXTERN void png_handle_pCAL PNGARG((png_structp png_ptr, png_infop info_ptr,
922
    png_uint_32 length));
923
#endif
924
925
 
926
PNG_EXTERN void png_handle_pHYs PNGARG((png_structp png_ptr, png_infop info_ptr,
927
    png_uint_32 length));
928
#endif
929
930
 
931
PNG_EXTERN void png_handle_sBIT PNGARG((png_structp png_ptr, png_infop info_ptr,
932
    png_uint_32 length));
933
#endif
934
935
 
936
PNG_EXTERN void png_handle_sCAL PNGARG((png_structp png_ptr, png_infop info_ptr,
937
    png_uint_32 length));
938
#endif
939
940
 
941
PNG_EXTERN void png_handle_sPLT PNGARG((png_structp png_ptr, png_infop info_ptr,
942
    png_uint_32 length));
943
#endif /* PNG_READ_sPLT_SUPPORTED */
944
945
 
946
PNG_EXTERN void png_handle_sRGB PNGARG((png_structp png_ptr, png_infop info_ptr,
947
    png_uint_32 length));
948
#endif
949
950
 
951
PNG_EXTERN void png_handle_tEXt PNGARG((png_structp png_ptr, png_infop info_ptr,
952
    png_uint_32 length));
953
#endif
954
955
 
956
PNG_EXTERN void png_handle_tIME PNGARG((png_structp png_ptr, png_infop info_ptr,
957
    png_uint_32 length));
958
#endif
959
960
 
961
PNG_EXTERN void png_handle_tRNS PNGARG((png_structp png_ptr, png_infop info_ptr,
962
    png_uint_32 length));
963
#endif
964
965
 
966
PNG_EXTERN void png_handle_zTXt PNGARG((png_structp png_ptr, png_infop info_ptr,
967
    png_uint_32 length));
968
#endif
969
970
 
971
    png_infop info_ptr, png_uint_32 length));
972
973
 
974
    png_const_bytep chunk_name));
975
976
 
977
PNG_EXTERN void png_do_read_transformations PNGARG((png_structp png_ptr));
978
PNG_EXTERN void png_do_write_transformations PNGARG((png_structp png_ptr));
979
980
 
981
982
 
983
PNG_EXTERN void png_push_read_chunk PNGARG((png_structp png_ptr,
984
    png_infop info_ptr));
985
PNG_EXTERN void png_push_read_sig PNGARG((png_structp png_ptr,
986
    png_infop info_ptr));
987
PNG_EXTERN void png_push_check_crc PNGARG((png_structp png_ptr));
988
PNG_EXTERN void png_push_crc_skip PNGARG((png_structp png_ptr,
989
    png_uint_32 length));
990
PNG_EXTERN void png_push_crc_finish PNGARG((png_structp png_ptr));
991
PNG_EXTERN void png_push_save_buffer PNGARG((png_structp png_ptr));
992
PNG_EXTERN void png_push_restore_buffer PNGARG((png_structp png_ptr,
993
    png_bytep buffer, png_size_t buffer_length));
994
PNG_EXTERN void png_push_read_IDAT PNGARG((png_structp png_ptr));
995
PNG_EXTERN void png_process_IDAT_data PNGARG((png_structp png_ptr,
996
    png_bytep buffer, png_size_t buffer_length));
997
PNG_EXTERN void png_push_process_row PNGARG((png_structp png_ptr));
998
PNG_EXTERN void png_push_handle_unknown PNGARG((png_structp png_ptr,
999
   png_infop info_ptr, png_uint_32 length));
1000
PNG_EXTERN void png_push_have_info PNGARG((png_structp png_ptr,
1001
   png_infop info_ptr));
1002
PNG_EXTERN void png_push_have_end PNGARG((png_structp png_ptr,
1003
   png_infop info_ptr));
1004
PNG_EXTERN void png_push_have_row PNGARG((png_structp png_ptr, png_bytep row));
1005
PNG_EXTERN void png_push_read_end PNGARG((png_structp png_ptr,
1006
    png_infop info_ptr));
1007
PNG_EXTERN void png_process_some_data PNGARG((png_structp png_ptr,
1008
    png_infop info_ptr));
1009
PNG_EXTERN void png_read_push_finish_row PNGARG((png_structp png_ptr));
1010
#  ifdef PNG_READ_tEXt_SUPPORTED
1011
PNG_EXTERN void png_push_handle_tEXt PNGARG((png_structp png_ptr,
1012
    png_infop info_ptr, png_uint_32 length));
1013
PNG_EXTERN void png_push_read_tEXt PNGARG((png_structp png_ptr,
1014
    png_infop info_ptr));
1015
#  endif
1016
#  ifdef PNG_READ_zTXt_SUPPORTED
1017
PNG_EXTERN void png_push_handle_zTXt PNGARG((png_structp png_ptr,
1018
    png_infop info_ptr, png_uint_32 length));
1019
PNG_EXTERN void png_push_read_zTXt PNGARG((png_structp png_ptr,
1020
    png_infop info_ptr));
1021
#  endif
1022
#  ifdef PNG_READ_iTXt_SUPPORTED
1023
PNG_EXTERN void png_push_handle_iTXt PNGARG((png_structp png_ptr,
1024
    png_infop info_ptr, png_uint_32 length));
1025
PNG_EXTERN void png_push_read_iTXt PNGARG((png_structp png_ptr,
1026
    png_infop info_ptr));
1027
#  endif
1028
1029
 
1030
1031
 
1032
PNG_EXTERN void png_do_read_intrapixel PNGARG((png_row_infop row_info,
1033
    png_bytep row));
1034
PNG_EXTERN void png_do_write_intrapixel PNGARG((png_row_infop row_info,
1035
    png_bytep row));
1036
#endif
1037
1038
 
1039
#ifdef PNG_CHECK_cHRM_SUPPORTED
1040
PNG_EXTERN int png_check_cHRM_fixed PNGARG((png_structp png_ptr,
1041
    png_fixed_point int_white_x, png_fixed_point int_white_y,
1042
    png_fixed_point int_red_x, png_fixed_point int_red_y, png_fixed_point
1043
    int_green_x, png_fixed_point int_green_y, png_fixed_point int_blue_x,
1044
    png_fixed_point int_blue_y));
1045
#endif
1046
1047
 
1048
/* Added at libpng version 1.2.34 and 1.4.0 */
1049
/* Currently only used by png_check_cHRM_fixed */
1050
PNG_EXTERN void png_64bit_product PNGARG((long v1, long v2,
1051
    unsigned long *hi_product, unsigned long *lo_product));
1052
#endif
1053
1054
 
1055
PNG_EXTERN void png_check_IHDR PNGARG((png_structp png_ptr,
1056
    png_uint_32 width, png_uint_32 height, int bit_depth,
1057
    int color_type, int interlace_type, int compression_type,
1058
    int filter_type));
1059
1060
 
1061
PNG_EXTERN void png_read_destroy PNGARG((png_structp png_ptr,
1062
    png_infop info_ptr, png_infop end_info_ptr));
1063
1064
 
1065
PNG_EXTERN void png_write_destroy PNGARG((png_structp png_ptr));
1066
1067
 
1068
PNG_EXTERN void *png_far_to_near PNGARG((png_structp png_ptr, png_voidp ptr,
1069
    int check));
1070
#endif /* USE_FAR_KEYWORD */
1071
1072
 
1073
PNG_EXTERN PNG_FUNCTION(void, png_fixed_error, (png_structp png_ptr,
1074
   png_const_charp name),PNG_NORETURN);
1075
#endif
1076
1077
 
1078
 * support is required.
1079
 */
1080
#if defined(PNG_READ_sCAL_SUPPORTED)
1081
/* MAX_DIGITS is actually the maximum number of characters in an sCAL
1082
 * width or height, derived from the precision (number of significant
1083
 * digits - a build time settable option) and assumpitions about the
1084
 * maximum ridiculous exponent.
1085
 */
1086
#define PNG_sCAL_MAX_DIGITS (PNG_sCAL_PRECISION+1/*.*/+1/*E*/+10/*exponent*/)
1087
1088
 
1089
PNG_EXTERN void png_ascii_from_fp PNGARG((png_structp png_ptr, png_charp ascii,
1090
    png_size_t size, double fp, unsigned int precision));
1091
#endif /* FLOATING_POINT */
1092
1093
 
1094
PNG_EXTERN void png_ascii_from_fixed PNGARG((png_structp png_ptr,
1095
    png_charp ascii, png_size_t size, png_fixed_point fp));
1096
#endif /* FIXED_POINT */
1097
#endif /* READ_sCAL */
1098
1099
 
1100
/* An internal API to validate the format of a floating point number.
1101
 * The result is the index of the next character.  If the number is
1102
 * not valid it will be the index of a character in the supposed number.
1103
 *
1104
 * The format of a number is defined in the PNG extensions specification
1105
 * and this API is strictly conformant to that spec, not anyone elses!
1106
 *
1107
 * The format as a regular expression is:
1108
 *
1109
 * [+-]?[0-9]+.?([Ee][+-]?[0-9]+)?
1110
 *
1111
 * or:
1112
 *
1113
 * [+-]?.[0-9]+(.[0-9]+)?([Ee][+-]?[0-9]+)?
1114
 *
1115
 * The complexity is that either integer or fraction must be present and the
1116
 * fraction is permitted to have no digits only if the integer is present.
1117
 *
1118
 * NOTE: The dangling E problem.
1119
 *   There is a PNG valid floating point number in the following:
1120
 *
1121
 *       PNG floating point numb1.ers are not greedy.
1122
 *
1123
 *   Working this out requires *TWO* character lookahead (because of the
1124
 *   sign), the parser does not do this - it will fail at the 'r' - this
1125
 *   doesn't matter for PNG sCAL chunk values, but it requires more care
1126
 *   if the value were ever to be embedded in something more complex.  Use
1127
 *   ANSI-C strtod if you need the lookahead.
1128
 */
1129
/* State table for the parser. */
1130
#define PNG_FP_INTEGER    0  /* before or in integer */
1131
#define PNG_FP_FRACTION   1  /* before or in fraction */
1132
#define PNG_FP_EXPONENT   2  /* before or in exponent */
1133
#define PNG_FP_STATE      3  /* mask for the above */
1134
#define PNG_FP_SAW_SIGN   4  /* Saw +/- in current state */
1135
#define PNG_FP_SAW_DIGIT  8  /* Saw a digit in current state */
1136
#define PNG_FP_SAW_DOT   16  /* Saw a dot in current state */
1137
#define PNG_FP_SAW_E     32  /* Saw an E (or e) in current state */
1138
#define PNG_FP_SAW_ANY   60  /* Saw any of the above 4 */
1139
#define PNG_FP_WAS_VALID 64  /* Preceding substring is a valid fp number */
1140
#define PNG_FP_INVALID  128  /* Available for callers as a distinct value */
1141
1142
 
1143
 * not ok yet.)
1144
 */
1145
#define PNG_FP_MAYBE      0  /* The number may be valid in the future */
1146
#define PNG_FP_OK         1  /* The number is valid */
1147
1148
 
1149
 * the index into the string and the state variable (which must
1150
 * be initialzed to 0).  It returns a result code, as above.  There
1151
 * is no point calling the parser any more if it fails to advance to
1152
 * the end of the string - it is stuck on an invalid character (or
1153
 * terminated by '\0').
1154
 *
1155
 * Note that the pointer will consume an E or even an E+ then leave
1156
 * a 'maybe' state even though a preceding integer.fraction is valid.
1157
 * The PNG_FP_WAS_VALID flag indicates that a preceding substring was
1158
 * a valid number.  It's possible to recover from this by calling
1159
 * the parser again (from the start, with state 0) but with a string
1160
 * that omits the last character (i.e. set the size to the index of
1161
 * the problem character.)  This has not been tested within libpng.
1162
 */
1163
PNG_EXTERN int png_check_fp_number PNGARG((png_const_charp string,
1164
    png_size_t size, int *statep, png_size_tp whereami));
1165
1166
 
1167
 * only if it just contains a floating point number.
1168
 */
1169
PNG_EXTERN int png_check_fp_string PNGARG((png_const_charp string,
1170
    png_size_t size));
1171
#endif /* pCAL || sCAL */
1172
1173
 
1174
    defined(PNG_INCH_CONVERSIONS_SUPPORTED) || defined(PNG_READ_pHYs_SUPPORTED)
1175
/* Added at libpng version 1.5.0 */
1176
/* This is a utility to provide a*times/div (rounded) and indicate
1177
 * if there is an overflow.  The result is a boolean - false (0)
1178
 * for overflow, true (1) if no overflow, in which case *res
1179
 * holds the result.
1180
 */
1181
PNG_EXTERN int png_muldiv PNGARG((png_fixed_point_p res, png_fixed_point a,
1182
    png_int_32 times, png_int_32 div));
1183
#endif
1184
1185
 
1186
/* Same deal, but issue a warning on overflow and return 0. */
1187
PNG_EXTERN png_fixed_point png_muldiv_warn PNGARG((png_structp png_ptr,
1188
    png_fixed_point a, png_int_32 times, png_int_32 div));
1189
#endif
1190
1191
 
1192
/* Calculate a reciprocal - used for gamma values.  This returns
1193
 * 0 if the argument is 0 in order to maintain an undefined value,
1194
 * there are no warnings.
1195
 */
1196
PNG_EXTERN png_fixed_point png_reciprocal PNGARG((png_fixed_point a));
1197
1198
 
1199
 * values.  Accuracy is suitable for gamma calculations but this is
1200
 * not exact - use png_muldiv for that.
1201
 */
1202
PNG_EXTERN png_fixed_point png_reciprocal2 PNGARG((png_fixed_point a,
1203
    png_fixed_point b));
1204
#endif
1205
1206
 
1207
/* Internal fixed point gamma correction.  These APIs are called as
1208
 * required to convert single values - they don't need to be fast,
1209
 * they are not used when processing image pixel values.
1210
 *
1211
 * While the input is an 'unsigned' value it must actually be the
1212
 * correct bit value - 0..255 or 0..65535 as required.
1213
 */
1214
PNG_EXTERN png_uint_16 png_gamma_correct PNGARG((png_structp png_ptr,
1215
    unsigned int value, png_fixed_point gamma));
1216
PNG_EXTERN int png_gamma_significant PNGARG((png_fixed_point gamma));
1217
PNG_EXTERN png_uint_16 png_gamma_16bit_correct PNGARG((unsigned int value,
1218
    png_fixed_point gamma));
1219
PNG_EXTERN png_byte png_gamma_8bit_correct PNGARG((unsigned int value,
1220
    png_fixed_point gamma));
1221
PNG_EXTERN void png_build_gamma_table PNGARG((png_structp png_ptr,
1222
    int bit_depth));
1223
#endif
1224
1225
 
1226
1227
 
1228
 
1229
1230
 
1231
}
1232
#endif
1233
1234
 
1235