png.h 143.4 KB
Newer Older
1

A
Andreas Dilger 已提交
2
/* png.h - header file for PNG reference library
3
 *
4
 * libpng version 1.2.21beta1 - September 14, 2007
5
 * Copyright (c) 1998-2007 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
 * Authors and maintainers:
10 11
 *  libpng versions 0.71, May 1995, through 0.88, January 1996: Guy Schalnat
 *  libpng versions 0.89c, June 1996, through 0.96, May 1997: Andreas Dilger
12
 *  libpng versions 0.97, January 1998, through 1.2.21beta1 - September 14, 2007: Glenn
13 14
 *  See also "Contributing Authors", below.
 *
15
 * Note about libpng version numbers:
16
 *
17 18 19 20 21 22
 *    Due to various miscommunications, unforeseen code incompatibilities
 *    and occasional factors outside the authors' control, version numbering
 *    on the library has not always been consistent and straightforward.
 *    The following table summarizes matters since version 0.89c, which was
 *    the first widely used release:
 *
23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54
 *    source                 png.h  png.h  shared-lib
 *    version                string   int  version
 *    -------                ------ -----  ----------
 *    0.89c "1.0 beta 3"     0.89      89  1.0.89
 *    0.90  "1.0 beta 4"     0.90      90  0.90  [should have been 2.0.90]
 *    0.95  "1.0 beta 5"     0.95      95  0.95  [should have been 2.0.95]
 *    0.96  "1.0 beta 6"     0.96      96  0.96  [should have been 2.0.96]
 *    0.97b "1.00.97 beta 7" 1.00.97   97  1.0.1 [should have been 2.0.97]
 *    0.97c                  0.97      97  2.0.97
 *    0.98                   0.98      98  2.0.98
 *    0.99                   0.99      98  2.0.99
 *    0.99a-m                0.99      99  2.0.99
 *    1.00                   1.00     100  2.1.0 [100 should be 10000]
 *    1.0.0      (from here on, the   100  2.1.0 [100 should be 10000]
 *    1.0.1       png.h string is   10001  2.1.0
 *    1.0.1a-e    identical to the  10002  from here on, the shared library
 *    1.0.2       source version)   10002  is 2.V where V is the source code
 *    1.0.2a-b                      10003  version, except as noted.
 *    1.0.3                         10003
 *    1.0.3a-d                      10004
 *    1.0.4                         10004
 *    1.0.4a-f                      10005
 *    1.0.5 (+ 2 patches)           10005
 *    1.0.5a-d                      10006
 *    1.0.5e-r                      10100 (not source compatible)
 *    1.0.5s-v                      10006 (not binary compatible)
 *    1.0.6 (+ 3 patches)           10006 (still binary incompatible)
 *    1.0.6d-f                      10007 (still binary incompatible)
 *    1.0.6g                        10007
 *    1.0.6h                        10007  10.6h (testing xy.z so-numbering)
 *    1.0.6i                        10007  10.6i
 *    1.0.6j                        10007  2.1.0.6j (incompatible with 1.0.0)
55 56 57 58 59 60 61 62 63 64 65
 *    1.0.7beta11-14        DLLNUM  10007  2.1.0.7beta11-14 (binary compatible)
 *    1.0.7beta15-18           1    10007  2.1.0.7beta15-18 (binary compatible)
 *    1.0.7rc1-2               1    10007  2.1.0.7rc1-2 (binary compatible)
 *    1.0.7                    1    10007  (still compatible)
 *    1.0.8beta1-4             1    10008  2.1.0.8beta1-4
 *    1.0.8rc1                 1    10008  2.1.0.8rc1
 *    1.0.8                    1    10008  2.1.0.8
 *    1.0.9beta1-6             1    10009  2.1.0.9beta1-6
 *    1.0.9rc1                 1    10009  2.1.0.9rc1
 *    1.0.9beta7-10            1    10009  2.1.0.9beta7-10
 *    1.0.9rc2                 1    10009  2.1.0.9rc2
66
 *    1.0.9                    1    10009  2.1.0.9
67
 *    1.0.10beta1              1    10010  2.1.0.10beta1
68
 *    1.0.10rc1                1    10010  2.1.0.10rc1
69
 *    1.0.10                   1    10010  2.1.0.10
70
 *    1.0.11beta1-3            1    10011  2.1.0.11beta1-3
71
 *    1.0.11rc1                1    10011  2.1.0.11rc1
72
 *    1.0.11                   1    10011  2.1.0.11
73 74 75 76
 *    1.0.12beta1-2            2    10012  2.1.0.12beta1-2
 *    1.0.12rc1                2    10012  2.1.0.12rc1
 *    1.0.12                   2    10012  2.1.0.12
 *    1.1.0a-f                 -    10100  2.1.1.0a-f (branch abandoned)
77
 *    1.2.0beta1-2             2    10200  2.1.2.0beta1-2
78 79 80
 *    1.2.0beta3-5             3    10200  3.1.2.0beta3-5
 *    1.2.0rc1                 3    10200  3.1.2.0rc1
 *    1.2.0                    3    10200  3.1.2.0
81
 *    1.2.1beta1-4             3    10201  3.1.2.1beta1-4
82 83
 *    1.2.1rc1-2               3    10201  3.1.2.1rc1-2
 *    1.2.1                    3    10201  3.1.2.1
84
 *    1.2.2beta1-6            12    10202  12.so.0.1.2.2beta1-6
85 86 87
 *    1.0.13beta1             10    10013  10.so.0.1.0.13beta1
 *    1.0.13rc1               10    10013  10.so.0.1.0.13rc1
 *    1.2.2rc1                12    10202  12.so.0.1.2.2rc1
88 89
 *    1.0.13                  10    10013  10.so.0.1.0.13
 *    1.2.2                   12    10202  12.so.0.1.2.2
90 91
 *    1.2.3rc1-6              12    10203  12.so.0.1.2.3rc1-6
 *    1.2.3                   12    10203  12.so.0.1.2.3
92
 *    1.2.4beta1-3            13    10204  12.so.0.1.2.4beta1-3
93 94
 *    1.0.14rc1               13    10014  10.so.0.1.0.14rc1
 *    1.2.4rc1                13    10204  12.so.0.1.2.4rc1
95 96
 *    1.0.14                  10    10014  10.so.0.1.0.14
 *    1.2.4                   13    10204  12.so.0.1.2.4
97
 *    1.2.5beta1-2            13    10205  12.so.0.1.2.5beta1-2
98
 *    1.0.15rc1-3             10    10015  10.so.0.1.0.15rc1-3
99 100 101
 *    1.2.5rc1-3              13    10205  12.so.0.1.2.5rc1-3
 *    1.0.15                  10    10015  10.so.0.1.0.15
 *    1.2.5                   13    10205  12.so.0.1.2.5
102
 *    1.2.6beta1-4            13    10206  12.so.0.1.2.6beta1-4
103 104
 *    1.0.16                  10    10016  10.so.0.1.0.16
 *    1.2.6                   13    10206  12.so.0.1.2.6
105
 *    1.2.7beta1-2            13    10207  12.so.0.1.2.7beta1-2
106
 *    1.0.17rc1               10    10017  10.so.0.1.0.17rc1
107
 *    1.2.7rc1                13    10207  12.so.0.1.2.7rc1
108
 *    1.0.17                  10    10017  10.so.0.1.0.17
109
 *    1.2.7                   13    10207  12.so.0.1.2.7
110
 *    1.2.8beta1-5            13    10208  12.so.0.1.2.8beta1-5
111
 *    1.0.18rc1-5             10    10018  10.so.0.1.0.18rc1-5
112
 *    1.2.8rc1-5              13    10208  12.so.0.1.2.8rc1-5
113
 *    1.0.18                  10    10018  10.so.0.1.0.18
114
 *    1.2.8                   13    10208  12.so.0.1.2.8
115
 *    1.2.9beta1-3            13    10209  12.so.0.1.2.9beta1-3
116
 *    1.2.9beta4-11           13    10209  12.so.0.9[.0]
117
 *    1.2.9rc1                13    10209  12.so.0.9[.0]
118
 *    1.2.9                   13    10209  12.so.0.9[.0]
119
 *    1.2.10beta1-8           13    10210  12.so.0.10[.0]
120 121
 *    1.2.10rc1-3             13    10210  12.so.0.10[.0]
 *    1.2.10                  13    10210  12.so.0.10[.0]
122
 *    1.2.11beta1-4           13    10211  12.so.0.11[.0]
123 124 125 126
 *    1.0.19rc1-5             10    10019  10.so.0.19[.0]
 *    1.2.11rc1-5             13    10211  12.so.0.11[.0]
 *    1.0.19                  10    10019  10.so.0.19[.0]
 *    1.2.11                  13    10211  12.so.0.11[.0]
127 128
 *    1.0.20                  10    10020  10.so.0.20[.0]
 *    1.2.12                  13    10212  12.so.0.12[.0]
129
 *    1.2.13beta1             13    10213  12.so.0.13[.0]
130 131
 *    1.0.21                  10    10021  10.so.0.21[.0]
 *    1.2.13                  13    10213  12.so.0.13[.0]
132 133 134
 *    1.2.14beta1-2           13    10214  12.so.0.14[.0]
 *    1.0.22rc1               10    10022  10.so.0.22[.0]
 *    1.2.14rc1               13    10214  12.so.0.14[.0]
135 136
 *    1.0.22                  10    10022  10.so.0.22[.0]
 *    1.2.14                  13    10214  12.so.0.14[.0]
137
 *    1.2.15beta1-6           13    10215  12.so.0.15[.0]
138 139
 *    1.0.23rc1-5             10    10023  10.so.0.23[.0]
 *    1.2.15rc1-5             13    10215  12.so.0.15[.0]
140 141
 *    1.0.23                  10    10023  10.so.0.23[.0]
 *    1.2.15                  13    10215  12.so.0.15[.0]
142
 *    1.2.16beta1-2           13    10216  12.so.0.16[.0]
143
 *    1.2.16rc1               13    10216  12.so.0.16[.0]
144 145
 *    1.0.24                  10    10024  10.so.0.24[.0]
 *    1.2.16                  13    10216  12.so.0.16[.0]
146
 *    1.2.17beta1-2           13    10217  12.so.0.17[.0]
147 148
 *    1.0.25rc1               10    10025  10.so.0.25[.0]
 *    1.2.17rc1-3             13    10217  12.so.0.17[.0]
149 150
 *    1.0.25                  10    10025  10.so.0.25[.0]
 *    1.2.17                  13    10217  12.so.0.17[.0]
151 152
 *    1.0.26                  10    10026  10.so.0.26[.0]
 *    1.2.18                  13    10218  12.so.0.18[.0]
153
 *    1.2.19beta1-31          13    10219  12.so.0.19[.0]
154 155
 *    1.0.27rc1-6             10    10027  10.so.0.27[.0]
 *    1.2.19rc1-6             13    10219  12.so.0.19[.0]
156 157
 *    1.0.27                  10    10027  10.so.0.27[.0]
 *    1.2.19                  13    10219  12.so.0.19[.0]
158
 *    1.2.20beta01-04         13    10220  12.so.0.20[.0]
159 160
 *    1.0.28rc1-6             10    10028  10.so.0.28[.0]
 *    1.2.20rc1-6             13    10220  12.so.0.20[.0]
161 162
 *    1.0.28                  10    10028  10.so.0.28[.0]
 *    1.2.20                  13    10220  12.so.0.20[.0]
163
 *
164 165
 *    Henceforth the source version will match the shared-library major
 *    and minor numbers; the shared-library major version number will be
166
 *    used for changes in backward compatibility, as it is intended.  The
167
 *    PNG_LIBPNG_VER macro, which is not used within libpng but is available
168
 *    for applications, is an unsigned integer of the form xyyzz corresponding
169
 *    to the source version x.y.z (leading zeros in y and z).  Beta versions
170 171
 *    were given the previous public release number plus a letter, until
 *    version 1.0.6j; from then on they were given the upcoming public
172
 *    release number plus "betaNN" or "rcN".
173
 *
174 175 176 177
 *    Binary incompatibility exists only when applications make direct access
 *    to the info_ptr or png_ptr members through png.h, and the compiled
 *    application is loaded with a different version of the library.
 *
178 179 180
 *    DLLNUM will change each time there are forward or backward changes
 *    in binary compatibility (e.g., when a new feature is added).
 *
181
 * See libpng.txt or libpng.3 for more information.  The PNG specification
182 183
 * is available as a W3C Recommendation and as an ISO Specification,
 * <http://www.w3.org/TR/2003/REC-PNG-20031110/
184 185 186
 */

/*
187 188
 * COPYRIGHT NOTICE, DISCLAIMER, and LICENSE:
 *
189 190
 * If you modify libpng you may insert additional notices immediately following
 * this sentence.
191
 *
192
 * libpng versions 1.2.6, August 15, 2004, through 1.2.21beta1, September 14, 2007, are
193
 * Copyright (c) 2004, 2006-2007 Glenn Randers-Pehrson, and are
194
 * distributed according to the same disclaimer and license as libpng-1.2.5
195
 * with the following individual added to the list of Contributing Authors:
196 197 198
 *
 *    Cosmin Truta
 *
199
 * libpng versions 1.0.7, July 1, 2000, through 1.2.5, October 3, 2002, are
200
 * Copyright (c) 2000-2002 Glenn Randers-Pehrson, and are
201
 * distributed according to the same disclaimer and license as libpng-1.0.6
202
 * with the following individuals added to the list of Contributing Authors:
203
 *
204 205 206 207
 *    Simon-Pierre Cadieux
 *    Eric S. Raymond
 *    Gilles Vollant
 *
208 209 210 211 212 213 214 215 216 217
 * and with the following additions to the disclaimer:
 *
 *    There is no warranty against interference with your enjoyment of the
 *    library or against infringement.  There is no warranty that our
 *    efforts or the library will fulfill any of your particular purposes
 *    or needs.  This library is provided with all faults, and the entire
 *    risk of satisfactory quality, performance, accuracy, and effort is with
 *    the user.
 *
 * libpng versions 0.97, January 1998, through 1.0.6, March 20, 2000, are
218 219
 * Copyright (c) 1998, 1999, 2000 Glenn Randers-Pehrson, and are
 * distributed according to the same disclaimer and license as libpng-0.96,
220 221 222 223 224 225 226 227 228 229
 * with the following individuals added to the list of Contributing Authors:
 *
 *    Tom Lane
 *    Glenn Randers-Pehrson
 *    Willem van Schaik
 *
 * libpng versions 0.89, June 1996, through 0.96, May 1997, are
 * Copyright (c) 1996, 1997 Andreas Dilger
 * Distributed according to the same disclaimer and license as libpng-0.88,
 * with the following individuals added to the list of Contributing Authors:
230
 *
231 232
 *    John Bowler
 *    Kevin Bracey
233
 *    Sam Bushell
234 235
 *    Magnus Holmgren
 *    Greg Roelofs
236 237 238 239 240 241 242 243 244 245
 *    Tom Tanner
 *
 * libpng versions 0.5, May 1995, through 0.88, January 1996, are
 * Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.
 *
 * For the purposes of this copyright and license, "Contributing Authors"
 * is defined as the following set of individuals:
 *
 *    Andreas Dilger
 *    Dave Martindale
246 247 248 249 250 251 252 253 254 255 256 257 258 259 260
 *    Guy Eric Schalnat
 *    Paul Schmidt
 *    Tim Wegner
 *
 * The PNG Reference Library is supplied "AS IS".  The Contributing Authors
 * and Group 42, Inc. disclaim all warranties, expressed or implied,
 * including, without limitation, the warranties of merchantability and of
 * fitness for any purpose.  The Contributing Authors and Group 42, Inc.
 * assume no liability for direct, indirect, incidental, special, exemplary,
 * or consequential damages, which may result from the use of the PNG
 * Reference Library, even if advised of the possibility of such damage.
 *
 * Permission is hereby granted to use, copy, modify, and distribute this
 * source code, or portions hereof, for any purpose, without fee, subject
 * to the following restrictions:
261
 *
262
 * 1. The origin of this source code must not be misrepresented.
263
 *
264 265
 * 2. Altered versions must be plainly marked as such and
 * must not be misrepresented as being the original source.
266
 *
267 268
 * 3. This Copyright notice may not be removed or altered from
 *    any source or altered source distribution.
269 270 271 272 273 274 275
 *
 * The Contributing Authors and Group 42, Inc. specifically permit, without
 * fee, and encourage the use of this source code as a component to
 * supporting the PNG file format in commercial products.  If you use this
 * source code in a product, acknowledgment is not required but would be
 * appreciated.
 */
G
Guy Schalnat 已提交
276

277
/*
278 279
 * A "png_get_copyright" function is available, for convenient use in "about"
 * boxes and the like:
280
 *
281
 * printf("%s",png_get_copyright(NULL));
282
 *
283
 * Also, the PNG logo (in PNG format, of course) is supplied in the
284
 * files "pngbar.png" and "pngbar.jpg (88x31) and "pngnow.png" (98x31).
285 286 287
 */

/*
288 289 290 291 292 293 294 295 296 297 298 299
 * Libpng is OSI Certified Open Source Software.  OSI Certified is a
 * certification mark of the Open Source Initiative.
 */

/*
 * The contributing authors would like to thank all those who helped
 * with testing, bug fixes, and patience.  This wouldn't have been
 * possible without all of you.
 *
 * Thanks to Frank J. T. Wojcik for helping with the documentation.
 */

300 301 302 303
/*
 * Y2K compliance in libpng:
 * =========================
 *
304
 *    September 14, 2007
305 306 307 308 309
 *
 *    Since the PNG Development group is an ad-hoc body, we can't make
 *    an official declaration.
 *
 *    This is your unofficial assurance that libpng from version 0.71 and
310
 *    upward through 1.2.21beta1 are Y2K compliant.  It is my belief that earlier
311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355
 *    versions were also Y2K compliant.
 *
 *    Libpng only has three year fields.  One is a 2-byte unsigned integer
 *    that will hold years up to 65535.  The other two hold the date in text
 *    format, and will hold years up to 9999.
 *
 *    The integer is
 *        "png_uint_16 year" in png_time_struct.
 *
 *    The strings are
 *        "png_charp time_buffer" in png_struct and
 *        "near_time_buffer", which is a local character string in png.c.
 *
 *    There are seven time-related functions:
 *        png.c: png_convert_to_rfc_1123() in png.c
 *          (formerly png_convert_to_rfc_1152() in error)
 *        png_convert_from_struct_tm() in pngwrite.c, called in pngwrite.c
 *        png_convert_from_time_t() in pngwrite.c
 *        png_get_tIME() in pngget.c
 *        png_handle_tIME() in pngrutil.c, called in pngread.c
 *        png_set_tIME() in pngset.c
 *        png_write_tIME() in pngwutil.c, called in pngwrite.c
 *
 *    All handle dates properly in a Y2K environment.  The
 *    png_convert_from_time_t() function calls gmtime() to convert from system
 *    clock time, which returns (year - 1900), which we properly convert to
 *    the full 4-digit year.  There is a possibility that applications using
 *    libpng are not passing 4-digit years into the png_convert_to_rfc_1123()
 *    function, or that they are incorrectly passing only a 2-digit year
 *    instead of "year - 1900" into the png_convert_from_struct_tm() function,
 *    but this is not under our control.  The libpng documentation has always
 *    stated that it works with 4-digit years, and the APIs have been
 *    documented as such.
 *
 *    The tIME chunk itself is also Y2K compliant.  It uses a 2-byte unsigned
 *    integer to hold the year, and can hold years as large as 65535.
 *
 *    zlib, upon which libpng depends, is also Y2K compliant.  It contains
 *    no date-related code.
 *
 *       Glenn Randers-Pehrson
 *       libpng maintainer
 *       PNG Development Group
 */

356 357
#ifndef PNG_H
#define PNG_H
G
Guy Schalnat 已提交
358 359

/* This is not the place to learn how to use libpng.  The file libpng.txt
A
Andreas Dilger 已提交
360 361 362 363
 * describes how to use libpng, and the file example.c summarizes it
 * with some code on which to build.  This file is useful for looking
 * at the actual function definitions and structure components.
 */
G
Guy Schalnat 已提交
364

365
/* Version information for png.h - this should match the version in png.c */
366
#define PNG_LIBPNG_VER_STRING "1.2.21beta1"
367
#define PNG_HEADER_VERSION_STRING \
368
   " libpng version 1.2.21beta1 - September 14, 2007\n"
369

370
#define PNG_LIBPNG_VER_SONUM   0
371
#define PNG_LIBPNG_VER_DLLNUM  13
372 373 374

/* These should match the first 3 components of PNG_LIBPNG_VER_STRING: */
#define PNG_LIBPNG_VER_MAJOR   1
375
#define PNG_LIBPNG_VER_MINOR   2
376
#define PNG_LIBPNG_VER_RELEASE 21
377 378
/* This should match the numeric part of the final component of
 * PNG_LIBPNG_VER_STRING, omitting any leading zero: */
379

380
#define PNG_LIBPNG_VER_BUILD  1
381

382
/* Release Status */
383 384 385 386
#define PNG_LIBPNG_BUILD_ALPHA    1
#define PNG_LIBPNG_BUILD_BETA     2
#define PNG_LIBPNG_BUILD_RC       3
#define PNG_LIBPNG_BUILD_STABLE   4
387 388 389 390 391 392 393 394 395
#define PNG_LIBPNG_BUILD_RELEASE_STATUS_MASK 7
  
/* Release-Specific Flags */
#define PNG_LIBPNG_BUILD_PATCH    8 /* Can be OR'ed with
                                       PNG_LIBPNG_BUILD_STABLE only */
#define PNG_LIBPNG_BUILD_PRIVATE 16 /* Cannot be OR'ed with
                                       PNG_LIBPNG_BUILD_SPECIAL */
#define PNG_LIBPNG_BUILD_SPECIAL 32 /* Cannot be OR'ed with
                                       PNG_LIBPNG_BUILD_PRIVATE */
396

397
#define PNG_LIBPNG_BUILD_BASE_TYPE PNG_LIBPNG_BUILD_BETA
398

399 400 401 402 403
/* Careful here.  At one time, Guy wanted to use 082, but that would be octal.
 * We must not include leading zeros.
 * Versions 0.7 through 1.0.0 were in the range 0 to 100 here (only
 * version 1.0.0 was mis-numbered 100 instead of 10000).  From
 * version 1.0.1 it's    xxyyzz, where x=major, y=minor, z=release */
404
#define PNG_LIBPNG_VER 10221 /* 1.2.21 */
405 406

#ifndef PNG_VERSION_INFO_ONLY
G
Guy Schalnat 已提交
407 408
/* include the compression library's header */
#include "zlib.h"
409
#endif
G
Guy Schalnat 已提交
410

411
/* include all user configurable info, including optional assembler routines */
G
Guy Schalnat 已提交
412
#include "pngconf.h"
G
Guy Schalnat 已提交
413

414 415 416 417 418 419 420 421 422 423 424 425 426 427
/*
 * Added at libpng-1.2.8 */
/* Ref MSDN: Private as priority over Special
 * VS_FF_PRIVATEBUILD File *was not* built using standard release
 * procedures. If this value is given, the StringFileInfo block must
 * contain a PrivateBuild string. 
 *
 * VS_FF_SPECIALBUILD File *was* built by the original company using
 * standard release procedures but is a variation of the standard
 * file of the same version number. If this value is given, the
 * StringFileInfo block must contain a SpecialBuild string. 
 */

#if defined(PNG_USER_PRIVATEBUILD)
428 429
#  define PNG_LIBPNG_BUILD_TYPE \
          (PNG_LIBPNG_BUILD_BASE_TYPE | PNG_LIBPNG_BUILD_PRIVATE)
430 431
#else
#  if defined(PNG_LIBPNG_SPECIALBUILD)
432 433
#    define PNG_LIBPNG_BUILD_TYPE \
            (PNG_LIBPNG_BUILD_BASE_TYPE | PNG_LIBPNG_BUILD_SPECIAL)
434
#  else
435
#    define PNG_LIBPNG_BUILD_TYPE (PNG_LIBPNG_BUILD_BASE_TYPE)
436 437 438 439 440
#  endif
#endif

#ifndef PNG_VERSION_INFO_ONLY

441 442 443 444 445
/* Inhibit C++ name-mangling for libpng functions but not for system calls. */
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */

A
Andreas Dilger 已提交
446 447 448 449 450 451
/* This file is arranged in several sections.  The first section contains
 * structure and type definitions.  The second section contains the external
 * library functions, while the third has the internal library functions,
 * which applications aren't expected to use directly.
 */

452
#ifndef PNG_NO_TYPECAST_NULL
453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484
#define int_p_NULL                (int *)NULL
#define png_bytep_NULL            (png_bytep)NULL
#define png_bytepp_NULL           (png_bytepp)NULL
#define png_doublep_NULL          (png_doublep)NULL
#define png_error_ptr_NULL        (png_error_ptr)NULL
#define png_flush_ptr_NULL        (png_flush_ptr)NULL
#define png_free_ptr_NULL         (png_free_ptr)NULL
#define png_infopp_NULL           (png_infopp)NULL
#define png_malloc_ptr_NULL       (png_malloc_ptr)NULL
#define png_read_status_ptr_NULL  (png_read_status_ptr)NULL
#define png_rw_ptr_NULL           (png_rw_ptr)NULL
#define png_structp_NULL          (png_structp)NULL
#define png_uint_16p_NULL         (png_uint_16p)NULL
#define png_voidp_NULL            (png_voidp)NULL
#define png_write_status_ptr_NULL (png_write_status_ptr)NULL
#else
#define int_p_NULL                NULL
#define png_bytep_NULL            NULL
#define png_bytepp_NULL           NULL
#define png_doublep_NULL          NULL
#define png_error_ptr_NULL        NULL
#define png_flush_ptr_NULL        NULL
#define png_free_ptr_NULL         NULL
#define png_infopp_NULL           NULL
#define png_malloc_ptr_NULL       NULL
#define png_read_status_ptr_NULL  NULL
#define png_rw_ptr_NULL           NULL
#define png_structp_NULL          NULL
#define png_uint_16p_NULL         NULL
#define png_voidp_NULL            NULL
#define png_write_status_ptr_NULL NULL
#endif
485

A
Andreas Dilger 已提交
486
/* variables declared in png.c - only it needs to define PNG_NO_EXTERN */
487
#if !defined(PNG_NO_EXTERN) || defined(PNG_ALWAYS_EXTERN)
A
Andreas Dilger 已提交
488 489 490
/* Version information for C files, stored in png.c.  This had better match
 * the version above.
 */
491
#ifdef PNG_USE_GLOBAL_ARRAYS
492
PNG_EXPORT_VAR (PNG_CONST char) png_libpng_ver[18];
493
  /* need room for 99.99.99beta99z */
494 495 496
#else
#define png_libpng_ver png_get_header_ver(NULL)
#endif
G
Guy Schalnat 已提交
497

498
#ifdef PNG_USE_GLOBAL_ARRAYS
499
/* This was removed in version 1.0.5c */
A
Andreas Dilger 已提交
500
/* Structures to facilitate easy interlacing.  See png.c for more details */
501 502 503 504 505 506
PNG_EXPORT_VAR (PNG_CONST int FARDATA) png_pass_start[7];
PNG_EXPORT_VAR (PNG_CONST int FARDATA) png_pass_inc[7];
PNG_EXPORT_VAR (PNG_CONST int FARDATA) png_pass_ystart[7];
PNG_EXPORT_VAR (PNG_CONST int FARDATA) png_pass_yinc[7];
PNG_EXPORT_VAR (PNG_CONST int FARDATA) png_pass_mask[7];
PNG_EXPORT_VAR (PNG_CONST int FARDATA) png_pass_dsp_mask[7];
507
/* This isn't currently used.  If you need it, see png.c for more details.
508
PNG_EXPORT_VAR (PNG_CONST int FARDATA) png_pass_height[7];
A
Andreas Dilger 已提交
509
*/
510
#endif
511

A
Andreas Dilger 已提交
512 513 514 515 516 517
#endif /* PNG_NO_EXTERN */

/* Three color definitions.  The order of the red, green, and blue, (and the
 * exact size) is not important, although the size of the fields need to
 * be png_byte or png_uint_16 (as defined below).
 */
G
Guy Schalnat 已提交
518 519
typedef struct png_color_struct
{
G
Guy Schalnat 已提交
520
   png_byte red;
G
Guy Schalnat 已提交
521 522 523
   png_byte green;
   png_byte blue;
} png_color;
A
Andreas Dilger 已提交
524 525
typedef png_color FAR * png_colorp;
typedef png_color FAR * FAR * png_colorpp;
G
Guy Schalnat 已提交
526 527 528

typedef struct png_color_16_struct
{
A
Andreas Dilger 已提交
529 530
   png_byte index;    /* used for palette files */
   png_uint_16 red;   /* for use in red green blue files */
G
Guy Schalnat 已提交
531 532
   png_uint_16 green;
   png_uint_16 blue;
A
Andreas Dilger 已提交
533
   png_uint_16 gray;  /* for use in grayscale files */
G
Guy Schalnat 已提交
534
} png_color_16;
A
Andreas Dilger 已提交
535 536
typedef png_color_16 FAR * png_color_16p;
typedef png_color_16 FAR * FAR * png_color_16pp;
G
Guy Schalnat 已提交
537 538 539

typedef struct png_color_8_struct
{
A
Andreas Dilger 已提交
540
   png_byte red;   /* for use in red green blue files */
G
Guy Schalnat 已提交
541 542
   png_byte green;
   png_byte blue;
A
Andreas Dilger 已提交
543
   png_byte gray;  /* for use in grayscale files */
G
Guy Schalnat 已提交
544 545
   png_byte alpha; /* for alpha channel files */
} png_color_8;
A
Andreas Dilger 已提交
546 547
typedef png_color_8 FAR * png_color_8p;
typedef png_color_8 FAR * FAR * png_color_8pp;
G
Guy Schalnat 已提交
548

549 550 551 552
/*
 * The following two structures are used for the in-core representation
 * of sPLT chunks.
 */
553
typedef struct png_sPLT_entry_struct
554 555 556 557 558 559
{
   png_uint_16 red;
   png_uint_16 green;
   png_uint_16 blue;
   png_uint_16 alpha;
   png_uint_16 frequency;
560 561 562
} png_sPLT_entry;
typedef png_sPLT_entry FAR * png_sPLT_entryp;
typedef png_sPLT_entry FAR * FAR * png_sPLT_entrypp;
563

564 565 566 567 568
/*  When the depth of the sPLT palette is 8 bits, the color and alpha samples
 *  occupy the LSB of their respective members, and the MSB of each member
 *  is zero-filled.  The frequency member always occupies the full 16 bits.
 */

569
typedef struct png_sPLT_struct
570
{
571 572 573 574
   png_charp name;           /* palette name */
   png_byte depth;           /* depth of palette samples */
   png_sPLT_entryp entries;  /* palette entries */
   png_int_32 nentries;      /* number of palette entries */
575 576 577
} png_sPLT_t;
typedef png_sPLT_t FAR * png_sPLT_tp;
typedef png_sPLT_t FAR * FAR * png_sPLT_tpp;
578 579

#ifdef PNG_TEXT_SUPPORTED
580 581
/* png_text holds the contents of a text/ztxt/itxt chunk in a PNG file,
 * and whether that contents is compressed or not.  The "key" field
582 583 584 585 586 587
 * points to a regular zero-terminated C string.  The "text", "lang", and
 * "lang_key" fields can be regular C strings, empty strings, or NULL pointers.
 * However, the * structure returned by png_get_text() will always contain
 * regular zero-terminated C strings (possibly empty), never NULL pointers,
 * so they can be safely used in printf() and other string-handling functions.
 */
G
Guy Schalnat 已提交
588 589
typedef struct png_text_struct
{
590 591 592 593 594
   int  compression;       /* compression value:
                             -1: tEXt, none
                              0: zTXt, deflate
                              1: iTXt, none
                              2: iTXt, deflate  */
A
Andreas Dilger 已提交
595
   png_charp key;          /* keyword, 1-79 character description of "text" */
596 597
   png_charp text;         /* comment, may be an empty string (ie "")
                              or a NULL pointer */
598
   png_size_t text_length; /* length of the text string */
599
#ifdef PNG_iTXt_SUPPORTED
600
   png_size_t itxt_length; /* length of the itxt string */
601 602
   png_charp lang;         /* language code, 0-79 characters
                              or a NULL pointer */
603
   png_charp lang_key;     /* keyword translated UTF-8 string, 0 or more
604
                              chars or a NULL pointer */
605
#endif
G
Guy Schalnat 已提交
606
} png_text;
A
Andreas Dilger 已提交
607 608
typedef png_text FAR * png_textp;
typedef png_text FAR * FAR * png_textpp;
609
#endif
A
Andreas Dilger 已提交
610 611 612 613 614 615 616

/* Supported compression types for text in PNG files (tEXt, and zTXt).
 * The values of the PNG_TEXT_COMPRESSION_ defines should NOT be changed. */
#define PNG_TEXT_COMPRESSION_NONE_WR -3
#define PNG_TEXT_COMPRESSION_zTXt_WR -2
#define PNG_TEXT_COMPRESSION_NONE    -1
#define PNG_TEXT_COMPRESSION_zTXt     0
617 618 619
#define PNG_ITXT_COMPRESSION_NONE     1
#define PNG_ITXT_COMPRESSION_zTXt     2
#define PNG_TEXT_COMPRESSION_LAST     3  /* Not a valid value */
G
Guy Schalnat 已提交
620 621

/* png_time is a way to hold the time in an machine independent way.
622 623 624
 * Two conversions are provided, both from time_t and struct tm.  There
 * is no portable way to convert to either of these structures, as far
 * as I know.  If you know of a portable way, send it to me.  As a side
625
 * note - PNG has always been Year 2000 compliant!
626
 */
G
Guy Schalnat 已提交
627 628 629
typedef struct png_time_struct
{
   png_uint_16 year; /* full year, as in, 1995 */
A
Andreas Dilger 已提交
630 631 632 633 634
   png_byte month;   /* month of year, 1 - 12 */
   png_byte day;     /* day of month, 1 - 31 */
   png_byte hour;    /* hour of day, 0 - 23 */
   png_byte minute;  /* minute of hour, 0 - 59 */
   png_byte second;  /* second of minute, 0 - 60 (for leap seconds) */
G
Guy Schalnat 已提交
635
} png_time;
A
Andreas Dilger 已提交
636 637 638
typedef png_time FAR * png_timep;
typedef png_time FAR * FAR * png_timepp;

639 640 641 642 643 644 645 646 647 648 649 650
#if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED)
/* png_unknown_chunk is a structure to hold queued chunks for which there is
 * no specific support.  The idea is that we can use this to queue
 * up private chunks for output even though the library doesn't actually
 * know about their semantics.
 */
typedef struct png_unknown_chunk_t
{
    png_byte name[5];
    png_byte *data;
    png_size_t size;

651
    /* libpng-using applications should NOT directly modify this byte. */
652 653 654 655 656 657 658
    png_byte location; /* mode of operation at read time */
}
png_unknown_chunk;
typedef png_unknown_chunk FAR * png_unknown_chunkp;
typedef png_unknown_chunk FAR * FAR * png_unknown_chunkpp;
#endif

A
Andreas Dilger 已提交
659 660 661 662 663 664 665 666 667 668 669
/* png_info is a structure that holds the information in a PNG file so
 * that the application can find out the characteristics of the image.
 * If you are reading the file, this structure will tell you what is
 * in the PNG file.  If you are writing the file, fill in the information
 * you want to put into the PNG file, then call png_write_info().
 * The names chosen should be very close to the PNG specification, so
 * consult that document for information about the meaning of each field.
 *
 * With libpng < 0.95, it was only possible to directly set and read the
 * the values in the png_info_struct, which meant that the contents and
 * order of the values had to remain fixed.  With libpng 0.95 and later,
670
 * however, there are now functions that abstract the contents of
A
Andreas Dilger 已提交
671 672 673 674 675 676 677 678
 * png_info_struct from the application, so this makes it easier to use
 * libpng with dynamic libraries, and even makes it possible to use
 * libraries that don't have all of the libpng ancillary chunk-handing
 * functionality.
 *
 * In any case, the order of the parameters in png_info_struct should NOT
 * be changed for as long as possible to keep compatibility with applications
 * that use the old direct-access method with png_info_struct.
679 680
 *
 * The following members may have allocated storage attached that should be
681 682
 * cleaned up before the structure is discarded: palette, trans, text,
 * pcal_purpose, pcal_units, pcal_params, hist, iccp_name, iccp_profile,
683 684
 * splt_palettes, scal_unit, row_pointers, and unknowns.   By default, these
 * are automatically freed when the info structure is deallocated, if they were
685 686
 * allocated internally by libpng.  This behavior can be changed by means
 * of the png_data_freer() function.
687
 *
688 689 690 691 692 693 694 695 696
 * More allocation details: all the chunk-reading functions that
 * change these members go through the corresponding png_set_*
 * functions.  A function to clear these members is available: see
 * png_free_data().  The png_set_* functions do not depend on being
 * able to point info structure members to any of the storage they are
 * passed (they make their own copies), EXCEPT that the png_set_text
 * functions use the same storage passed to them in the text_ptr or
 * itxt_ptr structure argument, and the png_set_rows and png_set_unknowns
 * functions do not make their own copies.
A
Andreas Dilger 已提交
697
 */
G
Guy Schalnat 已提交
698 699
typedef struct png_info_struct
{
A
Andreas Dilger 已提交
700 701 702 703
   /* the following are necessary for every PNG file */
   png_uint_32 width;       /* width of image in pixels (from IHDR) */
   png_uint_32 height;      /* height of image in pixels (from IHDR) */
   png_uint_32 valid;       /* valid chunk data (see PNG_INFO_ below) */
704
   png_uint_32 rowbytes;    /* bytes needed to hold an untransformed row */
A
Andreas Dilger 已提交
705 706 707 708 709
   png_colorp palette;      /* array of color values (valid & PNG_INFO_PLTE) */
   png_uint_16 num_palette; /* number of color entries in "palette" (PLTE) */
   png_uint_16 num_trans;   /* number of transparent palette color (tRNS) */
   png_byte bit_depth;      /* 1, 2, 4, 8, or 16 bits/channel (from IHDR) */
   png_byte color_type;     /* see PNG_COLOR_TYPE_ below (from IHDR) */
710
   /* The following three should have been named *_method not *_type */
A
Andreas Dilger 已提交
711 712 713 714 715
   png_byte compression_type; /* must be PNG_COMPRESSION_TYPE_BASE (IHDR) */
   png_byte filter_type;    /* must be PNG_FILTER_TYPE_BASE (from IHDR) */
   png_byte interlace_type; /* One of PNG_INTERLACE_NONE, PNG_INTERLACE_ADAM7 */

   /* The following is informational only on read, and not used on writes. */
716
   png_byte channels;       /* number of data channels per pixel (1, 2, 3, 4) */
A
Andreas Dilger 已提交
717 718 719 720 721 722 723 724 725 726
   png_byte pixel_depth;    /* number of bits per pixel */
   png_byte spare_byte;     /* to align the data, and for future use */
   png_byte signature[8];   /* magic bytes read by libpng from start of file */

   /* The rest of the data is optional.  If you are reading, check the
    * valid field to see if the information in these are valid.  If you
    * are writing, set the valid field to those chunks you want written,
    * and initialize the appropriate fields below.
    */

727
#if defined(PNG_gAMA_SUPPORTED) && defined(PNG_FLOATING_POINT_SUPPORTED)
A
Andreas Dilger 已提交
728 729 730 731 732
   /* The gAMA chunk describes the gamma characteristics of the system
    * on which the image was created, normally in the range [1.0, 2.5].
    * Data is valid if (valid & PNG_INFO_gAMA) is non-zero.
    */
   float gamma; /* gamma value of image, if (valid & PNG_INFO_gAMA) */
733
#endif
734

735
#if defined(PNG_sRGB_SUPPORTED)
736 737 738
    /* GR-P, 0.96a */
    /* Data valid if (valid & PNG_INFO_sRGB) non-zero. */
   png_byte srgb_intent; /* sRGB rendering intent [0, 1, 2, or 3] */
739 740 741 742 743 744 745 746 747 748
#endif

#if defined(PNG_TEXT_SUPPORTED)
   /* The tEXt, and zTXt chunks contain human-readable textual data in
    * uncompressed, compressed, and optionally compressed forms, respectively.
    * The data in "text" is an array of pointers to uncompressed,
    * null-terminated C strings. Each chunk has a keyword that describes the
    * textual data contained in that chunk.  Keywords are not required to be
    * unique, and the text string may be empty.  Any number of text chunks may
    * be in an image.
A
Andreas Dilger 已提交
749 750 751 752
    */
   int num_text; /* number of comments read/to write */
   int max_text; /* current size of text array */
   png_textp text; /* array of comments read/to write */
753 754 755
#endif /* PNG_TEXT_SUPPORTED */

#if defined(PNG_tIME_SUPPORTED)
A
Andreas Dilger 已提交
756 757 758 759
   /* The tIME chunk holds the last time the displayed image data was
    * modified.  See the png_time struct for the contents of this struct.
    */
   png_time mod_time;
760 761 762
#endif

#if defined(PNG_sBIT_SUPPORTED)
A
Andreas Dilger 已提交
763 764 765 766 767 768 769
   /* The sBIT chunk specifies the number of significant high-order bits
    * in the pixel data.  Values are in the range [1, bit_depth], and are
    * only specified for the channels in the pixel data.  The contents of
    * the low-order bits is not specified.  Data is valid if
    * (valid & PNG_INFO_sBIT) is non-zero.
    */
   png_color_8 sig_bit; /* significant bits in color channels */
770 771 772 773
#endif

#if defined(PNG_tRNS_SUPPORTED) || defined(PNG_READ_EXPAND_SUPPORTED) || \
defined(PNG_READ_BACKGROUND_SUPPORTED)
A
Andreas Dilger 已提交
774 775 776 777 778 779
   /* The tRNS chunk supplies transparency data for paletted images and
    * other image types that don't need a full alpha channel.  There are
    * "num_trans" transparency values for a paletted image, stored in the
    * same order as the palette colors, starting from index 0.  Values
    * for the data are in the range [0, 255], ranging from fully transparent
    * to fully opaque, respectively.  For non-paletted images, there is a
780
    * single color specified that should be treated as fully transparent.
A
Andreas Dilger 已提交
781 782 783 784
    * Data is valid if (valid & PNG_INFO_tRNS) is non-zero.
    */
   png_bytep trans; /* transparent values for paletted image */
   png_color_16 trans_values; /* transparent color for non-palette image */
785 786 787
#endif

#if defined(PNG_bKGD_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED)
A
Andreas Dilger 已提交
788 789 790 791 792 793 794
   /* The bKGD chunk gives the suggested image background color if the
    * display program does not have its own background color and the image
    * is needs to composited onto a background before display.  The colors
    * in "background" are normally in the same color space/depth as the
    * pixel data.  Data is valid if (valid & PNG_INFO_bKGD) is non-zero.
    */
   png_color_16 background;
795 796 797
#endif

#if defined(PNG_oFFs_SUPPORTED)
A
Andreas Dilger 已提交
798 799 800 801 802
   /* The oFFs chunk gives the offset in "offset_unit_type" units rightwards
    * and downwards from the top-left corner of the display, page, or other
    * application-specific co-ordinate space.  See the PNG_OFFSET_ defines
    * below for the unit types.  Valid if (valid & PNG_INFO_oFFs) non-zero.
    */
803 804
   png_int_32 x_offset; /* x offset on page */
   png_int_32 y_offset; /* y offset on page */
G
Guy Schalnat 已提交
805
   png_byte offset_unit_type; /* offset units type */
806 807 808
#endif

#if defined(PNG_pHYs_SUPPORTED)
A
Andreas Dilger 已提交
809 810 811 812 813 814 815
   /* The pHYs chunk gives the physical pixel density of the image for
    * display or printing in "phys_unit_type" units (see PNG_RESOLUTION_
    * defines below).  Data is valid if (valid & PNG_INFO_pHYs) is non-zero.
    */
   png_uint_32 x_pixels_per_unit; /* horizontal pixel density */
   png_uint_32 y_pixels_per_unit; /* vertical pixel density */
   png_byte phys_unit_type; /* resolution type (see PNG_RESOLUTION_ below) */
816 817 818
#endif

#if defined(PNG_hIST_SUPPORTED)
A
Andreas Dilger 已提交
819 820 821 822 823 824 825
   /* The hIST chunk contains the relative frequency or importance of the
    * various palette entries, so that a viewer can intelligently select a
    * reduced-color palette, if required.  Data is an array of "num_palette"
    * values in the range [0,65535]. Data valid if (valid & PNG_INFO_hIST)
    * is non-zero.
    */
   png_uint_16p hist;
826 827
#endif

828
#ifdef PNG_cHRM_SUPPORTED
A
Andreas Dilger 已提交
829 830 831 832 833 834
   /* The cHRM chunk describes the CIE color characteristics of the monitor
    * on which the PNG was created.  This data allows the viewer to do gamut
    * mapping of the input image to ensure that the viewer sees the same
    * colors in the image as the creator.  Values are in the range
    * [0.0, 0.8].  Data valid if (valid & PNG_INFO_cHRM) non-zero.
    */
835
#ifdef PNG_FLOATING_POINT_SUPPORTED
A
Andreas Dilger 已提交
836
   float x_white;
G
Guy Schalnat 已提交
837 838 839 840 841 842 843
   float y_white;
   float x_red;
   float y_red;
   float x_green;
   float y_green;
   float x_blue;
   float y_blue;
844 845 846 847
#endif
#endif

#if defined(PNG_pCAL_SUPPORTED)
A
Andreas Dilger 已提交
848
   /* The pCAL chunk describes a transformation between the stored pixel
849
    * values and original physical data values used to create the image.
A
Andreas Dilger 已提交
850 851 852 853
    * The integer range [0, 2^bit_depth - 1] maps to the floating-point
    * range given by [pcal_X0, pcal_X1], and are further transformed by a
    * (possibly non-linear) transformation function given by "pcal_type"
    * and "pcal_params" into "pcal_units".  Please see the PNG_EQUATION_
854 855 856 857
    * defines below, and the PNG-Group's PNG extensions document for a
    * complete description of the transformations and how they should be
    * implemented, and for a description of the ASCII parameter strings.
    * Data values are valid if (valid & PNG_INFO_pCAL) non-zero.
A
Andreas Dilger 已提交
858 859 860 861 862 863 864 865
    */
   png_charp pcal_purpose;  /* pCAL chunk description string */
   png_int_32 pcal_X0;      /* minimum value */
   png_int_32 pcal_X1;      /* maximum value */
   png_charp pcal_units;    /* Latin-1 string giving physical units */
   png_charpp pcal_params;  /* ASCII strings containing parameter values */
   png_byte pcal_type;      /* equation type (see PNG_EQUATION_ below) */
   png_byte pcal_nparams;   /* number of parameters given in pcal_params */
866 867
#endif

868
/* New members added in libpng-1.0.6 */
869 870 871 872 873 874 875 876 877 878
#ifdef PNG_FREE_ME_SUPPORTED
   png_uint_32 free_me;     /* flags items libpng is responsible for freeing */
#endif

#if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED)
   /* storage for unknown chunks that the library doesn't recognize. */
   png_unknown_chunkp unknown_chunks;
   png_size_t unknown_chunks_num;
#endif

879 880 881 882
#if defined(PNG_iCCP_SUPPORTED)
   /* iCCP chunk data. */
   png_charp iccp_name;     /* profile name */
   png_charp iccp_profile;  /* International Color Consortium profile data */
883
                            /* Note to maintainer: should be png_bytep */
884 885 886 887 888 889
   png_uint_32 iccp_proflen;  /* ICC profile data length */
   png_byte iccp_compression; /* Always zero */
#endif

#if defined(PNG_sPLT_SUPPORTED)
   /* data on sPLT chunks (there may be more than one). */
890
   png_sPLT_tp splt_palettes;
891 892 893 894 895 896
   png_uint_32 splt_palettes_num;
#endif

#if defined(PNG_sCAL_SUPPORTED)
   /* The sCAL chunk describes the actual physical dimensions of the
    * subject matter of the graphic.  The chunk contains a unit specification
897
    * a byte value, and two ASCII strings representing floating-point
898 899 900 901
    * values.  The values are width and height corresponsing to one pixel
    * in the image.  This external representation is converted to double
    * here.  Data values are valid if (valid & PNG_INFO_sCAL) is non-zero.
    */
902
   png_byte scal_unit;         /* unit of physical scale */
903 904 905
#ifdef PNG_FLOATING_POINT_SUPPORTED
   double scal_pixel_width;    /* width of one pixel */
   double scal_pixel_height;   /* height of one pixel */
906
#endif
907 908 909 910
#ifdef PNG_FIXED_POINT_SUPPORTED
   png_charp scal_s_width;     /* string containing height */
   png_charp scal_s_height;    /* string containing width */
#endif
911 912
#endif

913
#if defined(PNG_INFO_IMAGE_SUPPORTED)
914
   /* Memory has been allocated if (valid & PNG_ALLOCATED_INFO_ROWS) non-zero */
915 916 917
   /* Data valid if (valid & PNG_INFO_IDAT) non-zero */
   png_bytepp row_pointers;        /* the image bits */
#endif
918

919
#if defined(PNG_FIXED_POINT_SUPPORTED) && defined(PNG_gAMA_SUPPORTED)
920 921 922 923 924 925 926 927 928 929 930 931 932 933
   png_fixed_point int_gamma; /* gamma of image, if (valid & PNG_INFO_gAMA) */
#endif

#if defined(PNG_cHRM_SUPPORTED) && defined(PNG_FIXED_POINT_SUPPORTED)
   png_fixed_point int_x_white;
   png_fixed_point int_y_white;
   png_fixed_point int_x_red;
   png_fixed_point int_y_red;
   png_fixed_point int_x_green;
   png_fixed_point int_y_green;
   png_fixed_point int_x_blue;
   png_fixed_point int_y_blue;
#endif

G
Guy Schalnat 已提交
934
} png_info;
935

A
Andreas Dilger 已提交
936 937
typedef png_info FAR * png_infop;
typedef png_info FAR * FAR * png_infopp;
G
Guy Schalnat 已提交
938

939
/* Maximum positive integer used in PNG is (2^31)-1 */
940
#define PNG_UINT_31_MAX ((png_uint_32)0x7fffffffL)
941 942
#define PNG_UINT_32_MAX ((png_uint_32)(-1))
#define PNG_SIZE_MAX ((png_size_t)(-1))
943
#if defined(PNG_1_0_X) || defined (PNG_1_2_X)
944 945
/* PNG_MAX_UINT is deprecated; use PNG_UINT_31_MAX instead. */
#define PNG_MAX_UINT PNG_UINT_31_MAX
946
#endif
947

A
Andreas Dilger 已提交
948
/* These describe the color_type field in png_info. */
G
Guy Schalnat 已提交
949
/* color type masks */
A
Andreas Dilger 已提交
950 951 952
#define PNG_COLOR_MASK_PALETTE    1
#define PNG_COLOR_MASK_COLOR      2
#define PNG_COLOR_MASK_ALPHA      4
G
Guy Schalnat 已提交
953 954

/* color types.  Note that not all combinations are legal */
G
Guy Schalnat 已提交
955
#define PNG_COLOR_TYPE_GRAY 0
A
Andreas Dilger 已提交
956 957 958
#define PNG_COLOR_TYPE_PALETTE  (PNG_COLOR_MASK_COLOR | PNG_COLOR_MASK_PALETTE)
#define PNG_COLOR_TYPE_RGB        (PNG_COLOR_MASK_COLOR)
#define PNG_COLOR_TYPE_RGB_ALPHA  (PNG_COLOR_MASK_COLOR | PNG_COLOR_MASK_ALPHA)
G
Guy Schalnat 已提交
959
#define PNG_COLOR_TYPE_GRAY_ALPHA (PNG_COLOR_MASK_ALPHA)
960 961 962
/* aliases */
#define PNG_COLOR_TYPE_RGBA  PNG_COLOR_TYPE_RGB_ALPHA
#define PNG_COLOR_TYPE_GA  PNG_COLOR_TYPE_GRAY_ALPHA
G
Guy Schalnat 已提交
963

964
/* This is for compression type. PNG 1.0-1.2 only define the single type. */
A
Andreas Dilger 已提交
965 966 967
#define PNG_COMPRESSION_TYPE_BASE 0 /* Deflate method 8, 32K window */
#define PNG_COMPRESSION_TYPE_DEFAULT PNG_COMPRESSION_TYPE_BASE

968
/* This is for filter type. PNG 1.0-1.2 only define the single type. */
A
Andreas Dilger 已提交
969
#define PNG_FILTER_TYPE_BASE      0 /* Single row per-byte filtering */
970
#define PNG_INTRAPIXEL_DIFFERENCING 64 /* Used only in MNG datastreams */
A
Andreas Dilger 已提交
971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989
#define PNG_FILTER_TYPE_DEFAULT   PNG_FILTER_TYPE_BASE

/* These are for the interlacing type.  These values should NOT be changed. */
#define PNG_INTERLACE_NONE        0 /* Non-interlaced image */
#define PNG_INTERLACE_ADAM7       1 /* Adam7 interlacing */
#define PNG_INTERLACE_LAST        2 /* Not a valid value */

/* These are for the oFFs chunk.  These values should NOT be changed. */
#define PNG_OFFSET_PIXEL          0 /* Offset in pixels */
#define PNG_OFFSET_MICROMETER     1 /* Offset in micrometers (1/10^6 meter) */
#define PNG_OFFSET_LAST           2 /* Not a valid value */

/* These are for the pCAL chunk.  These values should NOT be changed. */
#define PNG_EQUATION_LINEAR       0 /* Linear transformation */
#define PNG_EQUATION_BASE_E       1 /* Exponential base e transform */
#define PNG_EQUATION_ARBITRARY    2 /* Arbitrary base exponential transform */
#define PNG_EQUATION_HYPERBOLIC   3 /* Hyperbolic sine transformation */
#define PNG_EQUATION_LAST         4 /* Not a valid value */

990 991 992 993 994 995
/* These are for the sCAL chunk.  These values should NOT be changed. */
#define PNG_SCALE_UNKNOWN         0 /* unknown unit (image scale) */
#define PNG_SCALE_METER           1 /* meters per pixel */
#define PNG_SCALE_RADIAN          2 /* radians per pixel */
#define PNG_SCALE_LAST            3 /* Not a valid value */

A
Andreas Dilger 已提交
996 997 998 999 1000
/* These are for the pHYs chunk.  These values should NOT be changed. */
#define PNG_RESOLUTION_UNKNOWN    0 /* pixels/unknown unit (aspect ratio) */
#define PNG_RESOLUTION_METER      1 /* pixels/meter */
#define PNG_RESOLUTION_LAST       2 /* Not a valid value */

1001
/* These are for the sRGB chunk.  These values should NOT be changed. */
1002 1003 1004 1005
#define PNG_sRGB_INTENT_PERCEPTUAL 0
#define PNG_sRGB_INTENT_RELATIVE   1
#define PNG_sRGB_INTENT_SATURATION 2
#define PNG_sRGB_INTENT_ABSOLUTE   3
1006
#define PNG_sRGB_INTENT_LAST       4 /* Not a valid value */
1007

1008 1009
/* This is for text chunks */
#define PNG_KEYWORD_MAX_LENGTH     79
1010

1011
/* Maximum number of entries in PLTE/sPLT/tRNS arrays */
1012
#define PNG_MAX_PALETTE_LENGTH    256
1013

A
Andreas Dilger 已提交
1014 1015 1016 1017 1018
/* These determine if an ancillary chunk's data has been successfully read
 * from the PNG header, or if the application has filled in the corresponding
 * data in the info_struct to be written into the output file.  The values
 * of the PNG_INFO_<chunk> defines should NOT be changed.
 */
G
Guy Schalnat 已提交
1019 1020 1021 1022 1023 1024 1025 1026 1027 1028
#define PNG_INFO_gAMA 0x0001
#define PNG_INFO_sBIT 0x0002
#define PNG_INFO_cHRM 0x0004
#define PNG_INFO_PLTE 0x0008
#define PNG_INFO_tRNS 0x0010
#define PNG_INFO_bKGD 0x0020
#define PNG_INFO_hIST 0x0040
#define PNG_INFO_pHYs 0x0080
#define PNG_INFO_oFFs 0x0100
#define PNG_INFO_tIME 0x0200
A
Andreas Dilger 已提交
1029
#define PNG_INFO_pCAL 0x0400
1030
#define PNG_INFO_sRGB 0x0800   /* GR-P, 0.96a */
1031 1032 1033
#define PNG_INFO_iCCP 0x1000   /* ESR, 1.0.6 */
#define PNG_INFO_sPLT 0x2000   /* ESR, 1.0.6 */
#define PNG_INFO_sCAL 0x4000   /* ESR, 1.0.6 */
1034
#define PNG_INFO_IDAT 0x8000L  /* ESR, 1.0.6 */
G
Guy Schalnat 已提交
1035

A
Andreas Dilger 已提交
1036 1037 1038 1039
/* This is used for the transformation routines, as some of them
 * change these values for the row.  It also should enable using
 * the routines for other purposes.
 */
G
Guy Schalnat 已提交
1040 1041
typedef struct png_row_info_struct
{
G
Guy Schalnat 已提交
1042
   png_uint_32 width; /* width of row */
1043
   png_uint_32 rowbytes; /* number of bytes in row */
G
Guy Schalnat 已提交
1044 1045 1046 1047
   png_byte color_type; /* color type of row */
   png_byte bit_depth; /* bit depth of row */
   png_byte channels; /* number of channels (1, 2, 3, or 4) */
   png_byte pixel_depth; /* bits per pixel (depth * channels) */
G
Guy Schalnat 已提交
1048 1049
} png_row_info;

A
Andreas Dilger 已提交
1050 1051
typedef png_row_info FAR * png_row_infop;
typedef png_row_info FAR * FAR * png_row_infopp;
G
Guy Schalnat 已提交
1052

1053 1054 1055 1056 1057
/* These are the function types for the I/O functions and for the functions
 * that allow the user to override the default I/O functions with his or her
 * own.  The png_error_ptr type should match that of user-supplied warning
 * and error functions, while the png_rw_ptr type should match that of the
 * user read/write data functions.
G
Guy Schalnat 已提交
1058
 */
G
Guy Schalnat 已提交
1059 1060 1061
typedef struct png_struct_def png_struct;
typedef png_struct FAR * png_structp;

1062 1063 1064 1065 1066 1067 1068
typedef void (PNGAPI *png_error_ptr) PNGARG((png_structp, png_const_charp));
typedef void (PNGAPI *png_rw_ptr) PNGARG((png_structp, png_bytep, png_size_t));
typedef void (PNGAPI *png_flush_ptr) PNGARG((png_structp));
typedef void (PNGAPI *png_read_status_ptr) PNGARG((png_structp, png_uint_32,
   int));
typedef void (PNGAPI *png_write_status_ptr) PNGARG((png_structp, png_uint_32,
   int));
1069

G
Guy Schalnat 已提交
1070
#ifdef PNG_PROGRESSIVE_READ_SUPPORTED
1071 1072 1073
typedef void (PNGAPI *png_progressive_info_ptr) PNGARG((png_structp, png_infop));
typedef void (PNGAPI *png_progressive_end_ptr) PNGARG((png_structp, png_infop));
typedef void (PNGAPI *png_progressive_row_ptr) PNGARG((png_structp, png_bytep,
G
Guy Schalnat 已提交
1074
   png_uint_32, int));
1075
#endif
G
Guy Schalnat 已提交
1076

1077
#if defined(PNG_READ_USER_TRANSFORM_SUPPORTED) || \
1078 1079
    defined(PNG_WRITE_USER_TRANSFORM_SUPPORTED) || \
    defined(PNG_LEGACY_SUPPORTED)
1080
typedef void (PNGAPI *png_user_transform_ptr) PNGARG((png_structp,
1081
    png_row_infop, png_bytep));
1082
#endif
1083

1084
#if defined(PNG_USER_CHUNKS_SUPPORTED)
1085
typedef int (PNGAPI *png_user_chunk_ptr) PNGARG((png_structp, png_unknown_chunkp));
1086
#endif
1087
#if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED)
1088
typedef void (PNGAPI *png_unknown_chunk_ptr) PNGARG((png_structp));
1089 1090 1091
#endif

/* Transform masks for the high-level interface */
1092 1093
#define PNG_TRANSFORM_IDENTITY       0x0000    /* read and write */
#define PNG_TRANSFORM_STRIP_16       0x0001    /* read only */
1094 1095
#define PNG_TRANSFORM_STRIP_ALPHA    0x0002    /* read only */
#define PNG_TRANSFORM_PACKING        0x0004    /* read and write */
1096 1097
#define PNG_TRANSFORM_PACKSWAP       0x0008    /* read and write */
#define PNG_TRANSFORM_EXPAND         0x0010    /* read only */
1098
#define PNG_TRANSFORM_INVERT_MONO    0x0020    /* read and write */
1099 1100 1101
#define PNG_TRANSFORM_SHIFT          0x0040    /* read and write */
#define PNG_TRANSFORM_BGR            0x0080    /* read and write */
#define PNG_TRANSFORM_SWAP_ALPHA     0x0100    /* read and write */
1102
#define PNG_TRANSFORM_SWAP_ENDIAN    0x0200    /* read and write */
1103
#define PNG_TRANSFORM_INVERT_ALPHA   0x0400    /* read and write */
1104
#define PNG_TRANSFORM_STRIP_FILLER   0x0800    /* WRITE only */
1105

1106
/* Flags for MNG supported features */
1107 1108
#define PNG_FLAG_MNG_EMPTY_PLTE     0x01
#define PNG_FLAG_MNG_FILTER_64      0x04
1109
#define PNG_ALL_MNG_FEATURES        0x05
1110

1111
typedef png_voidp (*png_malloc_ptr) PNGARG((png_structp, png_size_t));
1112
typedef void (*png_free_ptr) PNGARG((png_structp, png_voidp));
1113

A
Andreas Dilger 已提交
1114 1115 1116 1117 1118 1119
/* The structure that holds the information to read and write PNG files.
 * The only people who need to care about what is inside of this are the
 * people who will be modifying the library for their own special needs.
 * It should NOT be accessed directly by an application, except to store
 * the jmp_buf.
 */
G
Guy Schalnat 已提交
1120

G
Guy Schalnat 已提交
1121
struct png_struct_def
G
Guy Schalnat 已提交
1122
{
1123
#ifdef PNG_SETJMP_SUPPORTED
A
Andreas Dilger 已提交
1124
   jmp_buf jmpbuf;            /* used in png_error */
1125
#endif
A
Andreas Dilger 已提交
1126 1127
   png_error_ptr error_fn;    /* function for printing errors and aborting */
   png_error_ptr warning_fn;  /* function for printing warnings */
G
Guy Schalnat 已提交
1128
   png_voidp error_ptr;       /* user supplied struct for error functions */
A
Andreas Dilger 已提交
1129 1130
   png_rw_ptr write_data_fn;  /* function for writing output data */
   png_rw_ptr read_data_fn;   /* function for reading input data */
1131
   png_voidp io_ptr;          /* ptr to application struct for I/O functions */
1132

1133
#if defined(PNG_READ_USER_TRANSFORM_SUPPORTED)
1134
   png_user_transform_ptr read_user_transform_fn; /* user read transform */
1135
#endif
1136

1137
#if defined(PNG_WRITE_USER_TRANSFORM_SUPPORTED)
1138 1139
   png_user_transform_ptr write_user_transform_fn; /* user write transform */
#endif
1140

1141 1142
/* These were added in libpng-1.0.2 */
#if defined(PNG_USER_TRANSFORM_PTR_SUPPORTED)
1143 1144 1145
#if defined(PNG_READ_USER_TRANSFORM_SUPPORTED) || \
    defined(PNG_WRITE_USER_TRANSFORM_SUPPORTED)
   png_voidp user_transform_ptr; /* user supplied struct for user transform */
1146 1147
   png_byte user_transform_depth;    /* bit depth of user transformed pixels */
   png_byte user_transform_channels; /* channels in user transformed pixels */
1148
#endif
1149
#endif
G
Guy Schalnat 已提交
1150

1151
   png_uint_32 mode;          /* tells us where we are in the PNG file */
A
Andreas Dilger 已提交
1152
   png_uint_32 flags;         /* flags indicating various things to libpng */
G
Guy Schalnat 已提交
1153 1154
   png_uint_32 transformations; /* which transformations to perform */

A
Andreas Dilger 已提交
1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167
   z_stream zstream;          /* pointer to decompression structure (below) */
   png_bytep zbuf;            /* buffer for zlib */
   png_size_t zbuf_size;      /* size of zbuf */
   int zlib_level;            /* holds zlib compression level */
   int zlib_method;           /* holds zlib compression method */
   int zlib_window_bits;      /* holds zlib compression window bits */
   int zlib_mem_level;        /* holds zlib compression memory level */
   int zlib_strategy;         /* holds zlib compression strategy */

   png_uint_32 width;         /* width of image in pixels */
   png_uint_32 height;        /* height of image in pixels */
   png_uint_32 num_rows;      /* number of rows in current pass */
   png_uint_32 usr_width;     /* width of row at start of write */
1168 1169
   png_uint_32 rowbytes;      /* size of row in bytes */
   png_uint_32 irowbytes;     /* size of current interlaced row in bytes */
A
Andreas Dilger 已提交
1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197
   png_uint_32 iwidth;        /* width of current interlaced row in pixels */
   png_uint_32 row_number;    /* current row in interlace pass */
   png_bytep prev_row;        /* buffer to save previous (unfiltered) row */
   png_bytep row_buf;         /* buffer to save current (unfiltered) row */
   png_bytep sub_row;         /* buffer to save "sub" row when filtering */
   png_bytep up_row;          /* buffer to save "up" row when filtering */
   png_bytep avg_row;         /* buffer to save "avg" row when filtering */
   png_bytep paeth_row;       /* buffer to save "Paeth" row when filtering */
   png_row_info row_info;     /* used for transformation routines */

   png_uint_32 idat_size;     /* current IDAT size for read */
   png_uint_32 crc;           /* current chunk CRC value */
   png_colorp palette;        /* palette from the input file */
   png_uint_16 num_palette;   /* number of color entries in palette */
   png_uint_16 num_trans;     /* number of transparency values */
   png_byte chunk_name[5];    /* null-terminated name of current chunk */
   png_byte compression;      /* file compression type (always 0) */
   png_byte filter;           /* file filter type (always 0) */
   png_byte interlaced;       /* PNG_INTERLACE_NONE, PNG_INTERLACE_ADAM7 */
   png_byte pass;             /* current interlace pass (0 - 6) */
   png_byte do_filter;        /* row filter flags (see PNG_FILTER_ below ) */
   png_byte color_type;       /* color type of file */
   png_byte bit_depth;        /* bit depth of file */
   png_byte usr_bit_depth;    /* bit depth of users row */
   png_byte pixel_depth;      /* number of bits per pixel */
   png_byte channels;         /* number of channels in file */
   png_byte usr_channels;     /* channels at start of write */
   png_byte sig_bytes;        /* magic bytes read/written from start of file */
A
Andreas Dilger 已提交
1198

G
Guy Schalnat 已提交
1199
#if defined(PNG_READ_FILLER_SUPPORTED) || defined(PNG_WRITE_FILLER_SUPPORTED)
1200 1201 1202
#ifdef PNG_LEGACY_SUPPORTED
   png_byte filler;           /* filler byte for pixel expansion */
#else
1203
   png_uint_16 filler;           /* filler bytes for pixel expansion */
1204
#endif
1205
#endif
1206

1207
#if defined(PNG_bKGD_SUPPORTED)
G
Guy Schalnat 已提交
1208
   png_byte background_gamma_type;
1209
#  ifdef PNG_FLOATING_POINT_SUPPORTED
G
Guy Schalnat 已提交
1210
   float background_gamma;
1211
#  endif
A
Andreas Dilger 已提交
1212
   png_color_16 background;   /* background color in screen gamma space */
1213 1214 1215
#if defined(PNG_READ_GAMMA_SUPPORTED)
   png_color_16 background_1; /* background normalized to gamma 1.0 */
#endif
1216
#endif /* PNG_bKGD_SUPPORTED */
1217

G
Guy Schalnat 已提交
1218
#if defined(PNG_WRITE_FLUSH_SUPPORTED)
G
Guy Schalnat 已提交
1219
   png_flush_ptr output_flush_fn;/* Function for flushing output */
A
Andreas Dilger 已提交
1220 1221
   png_uint_32 flush_dist;    /* how many rows apart to flush, 0 - no flush */
   png_uint_32 flush_rows;    /* number of rows written since last flush */
1222 1223
#endif

1224
#if defined(PNG_READ_GAMMA_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED)
1225
   int gamma_shift;      /* number of "insignificant" bits 16-bit gamma */
1226
#ifdef PNG_FLOATING_POINT_SUPPORTED
1227
   float gamma;          /* file gamma value */
1228
   float screen_gamma;   /* screen gamma value (display_exponent) */
1229 1230 1231
#endif
#endif

G
Guy Schalnat 已提交
1232
#if defined(PNG_READ_GAMMA_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED)
1233
   png_bytep gamma_table;     /* gamma table for 8-bit depth files */
A
Andreas Dilger 已提交
1234 1235
   png_bytep gamma_from_1;    /* converts from 1.0 to screen */
   png_bytep gamma_to_1;      /* converts from file to 1.0 */
1236
   png_uint_16pp gamma_16_table; /* gamma table for 16-bit depth files */
G
Guy Schalnat 已提交
1237 1238
   png_uint_16pp gamma_16_from_1; /* converts from 1.0 to screen */
   png_uint_16pp gamma_16_to_1; /* converts from file to 1.0 */
1239 1240
#endif

1241
#if defined(PNG_READ_GAMMA_SUPPORTED) || defined(PNG_sBIT_SUPPORTED)
A
Andreas Dilger 已提交
1242
   png_color_8 sig_bit;       /* significant bits in each available channel */
1243 1244
#endif

A
Andreas Dilger 已提交
1245 1246
#if defined(PNG_READ_SHIFT_SUPPORTED) || defined(PNG_WRITE_SHIFT_SUPPORTED)
   png_color_8 shift;         /* shift for significant bit tranformation */
1247 1248
#endif

1249
#if defined(PNG_tRNS_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED) \
1250
 || defined(PNG_READ_EXPAND_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED)
A
Andreas Dilger 已提交
1251
   png_bytep trans;           /* transparency values for paletted files */
G
Guy Schalnat 已提交
1252
   png_color_16 trans_values; /* transparency values for non-paletted files */
1253 1254
#endif

1255 1256
   png_read_status_ptr read_row_fn;   /* called after each row is decoded */
   png_write_status_ptr write_row_fn; /* called after each row is encoded */
G
Guy Schalnat 已提交
1257
#ifdef PNG_PROGRESSIVE_READ_SUPPORTED
A
Andreas Dilger 已提交
1258
   png_progressive_info_ptr info_fn; /* called after header data fully read */
1259
   png_progressive_row_ptr row_fn;   /* called after each prog. row is decoded */
A
Andreas Dilger 已提交
1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272
   png_progressive_end_ptr end_fn;   /* called after image is complete */
   png_bytep save_buffer_ptr;        /* current location in save_buffer */
   png_bytep save_buffer;            /* buffer for previously read data */
   png_bytep current_buffer_ptr;     /* current location in current_buffer */
   png_bytep current_buffer;         /* buffer for recently used data */
   png_uint_32 push_length;          /* size of current input chunk */
   png_uint_32 skip_length;          /* bytes to skip in input data */
   png_size_t save_buffer_size;      /* amount of data now in save_buffer */
   png_size_t save_buffer_max;       /* total size of save_buffer */
   png_size_t buffer_size;           /* total amount of available input data */
   png_size_t current_buffer_size;   /* amount of data now in current_buffer */
   int process_mode;                 /* what push library is currently doing */
   int cur_palette;                  /* current push library palette index */
1273

1274
#  if defined(PNG_TEXT_SUPPORTED)
1275 1276 1277 1278
     png_size_t current_text_size;   /* current size of text input data */
     png_size_t current_text_left;   /* how much text left to read in input */
     png_charp current_text;         /* current text chunk buffer */
     png_charp current_text_ptr;     /* current location in current_text */
1279
#  endif /* PNG_TEXT_SUPPORTED */
1280
#endif /* PNG_PROGRESSIVE_READ_SUPPORTED */
1281

G
Guy Schalnat 已提交
1282 1283 1284 1285 1286 1287 1288
#if defined(__TURBOC__) && !defined(_Windows) && !defined(__FLAT__)
/* for the Borland special 64K segment handler */
   png_bytepp offset_table_ptr;
   png_bytep offset_table;
   png_uint_16 offset_table_number;
   png_uint_16 offset_table_count;
   png_uint_16 offset_table_count_free;
1289 1290
#endif

G
Guy Schalnat 已提交
1291
#if defined(PNG_READ_DITHER_SUPPORTED)
A
Andreas Dilger 已提交
1292 1293
   png_bytep palette_lookup;         /* lookup table for dithering */
   png_bytep dither_index;           /* index translation for palette files */
1294 1295
#endif

1296
#if defined(PNG_READ_DITHER_SUPPORTED) || defined(PNG_hIST_SUPPORTED)
1297 1298
   png_uint_16p hist;                /* histogram */
#endif
1299

A
Andreas Dilger 已提交
1300 1301 1302 1303 1304 1305 1306 1307
#if defined(PNG_WRITE_WEIGHTED_FILTER_SUPPORTED)
   png_byte heuristic_method;        /* heuristic for row filter selection */
   png_byte num_prev_filters;        /* number of weights for previous rows */
   png_bytep prev_filters;           /* filter type(s) of previous row(s) */
   png_uint_16p filter_weights;      /* weight(s) for previous line(s) */
   png_uint_16p inv_filter_weights;  /* 1/weight(s) for previous line(s) */
   png_uint_16p filter_costs;        /* relative filter calculation cost */
   png_uint_16p inv_filter_costs;    /* 1/relative filter calculation cost */
1308 1309
#endif

1310 1311
#if defined(PNG_TIME_RFC1123_SUPPORTED)
   png_charp time_buffer;            /* String to hold RFC 1123 time text */
1312 1313
#endif

1314 1315 1316 1317 1318 1319
/* New members added in libpng-1.0.6 */

#ifdef PNG_FREE_ME_SUPPORTED
   png_uint_32 free_me;       /* flags items libpng is responsible for freeing */
#endif

1320
#if defined(PNG_USER_CHUNKS_SUPPORTED)
1321 1322 1323 1324 1325 1326 1327 1328 1329
   png_voidp user_chunk_ptr;
   png_user_chunk_ptr read_user_chunk_fn; /* user read chunk handler */
#endif

#if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED)
   int num_chunk_list;
   png_bytep chunk_list;
#endif

1330
/* New members added in libpng-1.0.3 */
1331 1332
#if defined(PNG_READ_RGB_TO_GRAY_SUPPORTED)
   png_byte rgb_to_gray_status;
1333
   /* These were changed from png_byte in libpng-1.0.6 */
1334 1335 1336
   png_uint_16 rgb_to_gray_red_coeff;
   png_uint_16 rgb_to_gray_green_coeff;
   png_uint_16 rgb_to_gray_blue_coeff;
1337
#endif
1338

1339
/* New member added in libpng-1.0.4 (renamed in 1.0.9) */
1340 1341
#if defined(PNG_MNG_FEATURES_SUPPORTED) || \
    defined(PNG_READ_EMPTY_PLTE_SUPPORTED) || \
1342
    defined(PNG_WRITE_EMPTY_PLTE_SUPPORTED)
1343
/* changed from png_byte to png_uint_32 at version 1.2.0 */
1344 1345 1346
#ifdef PNG_1_0_X
   png_byte mng_features_permitted;
#else
1347
   png_uint_32 mng_features_permitted;
1348
#endif /* PNG_1_0_X */
1349
#endif
1350

1351
/* New member added in libpng-1.0.7 */
1352 1353 1354 1355
#if defined(PNG_READ_GAMMA_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED)
   png_fixed_point int_gamma;
#endif

1356 1357
/* New member added in libpng-1.0.9, ifdef'ed out in 1.0.12, enabled in 1.2.0 */
#if defined(PNG_MNG_FEATURES_SUPPORTED)
1358
   png_byte filter_type;
1359
#endif
1360

1361
#if defined(PNG_1_0_X)
1362 1363 1364 1365 1366
/* New member added in libpng-1.0.10, ifdef'ed out in 1.2.0 */
   png_uint_32 row_buf_size;
#endif

/* New members added in libpng-1.2.0 */
1367 1368 1369
#if defined(PNG_ASSEMBLER_CODE_SUPPORTED)
#  if !defined(PNG_1_0_X)
#    if defined(PNG_MMX_CODE_SUPPORTED)
1370 1371
   png_byte     mmx_bitdepth_threshold;
   png_uint_32  mmx_rowbytes_threshold;
1372
#    endif
1373
   png_uint_32  asm_flags;
1374
#  endif
1375 1376
#endif

1377 1378 1379 1380 1381 1382
/* New members added in libpng-1.0.2 but first enabled by default in 1.2.0 */
#ifdef PNG_USER_MEM_SUPPORTED
   png_voidp mem_ptr;                /* user supplied struct for mem functions */
   png_malloc_ptr malloc_fn;         /* function for allocating memory */
   png_free_ptr free_fn;             /* function for freeing memory */
#endif
1383

1384
/* New member added in libpng-1.0.13 and 1.2.0 */
1385 1386
   png_bytep big_row_buf;         /* buffer to save current (unfiltered) row */

1387
#if defined(PNG_READ_DITHER_SUPPORTED)
1388
/* The following three members were added at version 1.0.14 and 1.2.4 */
1389 1390 1391 1392 1393 1394
   png_bytep dither_sort;            /* working sort array */
   png_bytep index_to_palette;       /* where the original index currently is */
                                     /* in the palette */
   png_bytep palette_to_index;       /* which original index points to this */
                                     /* palette color */
#endif
1395 1396

/* New members added in libpng-1.0.16 and 1.2.6 */
1397
   png_byte compression_type;
1398

1399 1400 1401 1402 1403
#ifdef PNG_SET_USER_LIMITS_SUPPORTED
   png_uint_32 user_width_max;
   png_uint_32 user_height_max;
#endif

1404 1405 1406 1407 1408
/* New member added in libpng-1.0.25 and 1.2.17 */
#if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED)
   /* storage for unknown chunk that the library doesn't recognize. */
   png_unknown_chunk unknown_chunk;
#endif
G
Guy Schalnat 已提交
1409
};
G
Guy Schalnat 已提交
1410

1411

1412 1413
/* This triggers a compiler error in png.c, if png.c and png.h
 * do not agree upon the version number.
1414
 */
1415
typedef png_structp version_1_2_21beta1;
1416

A
Andreas Dilger 已提交
1417
typedef png_struct FAR * FAR * png_structpp;
G
Guy Schalnat 已提交
1418

G
Guy Schalnat 已提交
1419
/* Here are the function definitions most commonly used.  This is not
A
Andreas Dilger 已提交
1420 1421
 * the place to find out how to use libpng.  See libpng.txt for the
 * full explanation, see example.c for the summary.  This just provides
1422
 * a simple one line description of the use of each function.
A
Andreas Dilger 已提交
1423
 */
G
Guy Schalnat 已提交
1424

1425 1426 1427
/* Returns the version number of the library */
extern PNG_EXPORT(png_uint_32,png_access_version_number) PNGARG((void));

A
Andreas Dilger 已提交
1428
/* Tell lib we have already handled the first <num_bytes> magic bytes.
A
Andreas Dilger 已提交
1429 1430 1431 1432 1433 1434 1435 1436 1437 1438 1439 1440 1441 1442 1443 1444 1445
 * Handling more than 8 bytes from the beginning of the file is an error.
 */
extern PNG_EXPORT(void,png_set_sig_bytes) PNGARG((png_structp png_ptr,
   int num_bytes));

/* Check sig[start] through sig[start + num_to_check - 1] to see if it's a
 * PNG file.  Returns zero if the supplied bytes match the 8-byte PNG
 * signature, and non-zero otherwise.  Having num_to_check == 0 or
 * start > 7 will always fail (ie return non-zero).
 */
extern PNG_EXPORT(int,png_sig_cmp) PNGARG((png_bytep sig, png_size_t start,
   png_size_t num_to_check));

/* Simple signature checking function.  This is the same as calling
 * png_check_sig(sig, n) := !png_sig_cmp(sig, 0, n).
 */
extern PNG_EXPORT(int,png_check_sig) PNGARG((png_bytep sig, int num));
G
Guy Schalnat 已提交
1446

A
Andreas Dilger 已提交
1447 1448
/* Allocate and initialize png_ptr struct for reading, and any other memory. */
extern PNG_EXPORT(png_structp,png_create_read_struct)
1449
   PNGARG((png_const_charp user_png_ver, png_voidp error_ptr,
1450
   png_error_ptr error_fn, png_error_ptr warn_fn));
A
Andreas Dilger 已提交
1451

1452
/* Allocate and initialize png_ptr struct for writing, and any other memory */
A
Andreas Dilger 已提交
1453
extern PNG_EXPORT(png_structp,png_create_write_struct)
1454
   PNGARG((png_const_charp user_png_ver, png_voidp error_ptr,
A
Andreas Dilger 已提交
1455
   png_error_ptr error_fn, png_error_ptr warn_fn));
G
Guy Schalnat 已提交
1456

1457
#ifdef PNG_WRITE_SUPPORTED
1458 1459
extern PNG_EXPORT(png_uint_32,png_get_compression_buffer_size)
   PNGARG((png_structp png_ptr));
1460
#endif
1461

1462
#ifdef PNG_WRITE_SUPPORTED
1463 1464
extern PNG_EXPORT(void,png_set_compression_buffer_size)
   PNGARG((png_structp png_ptr, png_uint_32 size));
1465
#endif
1466 1467 1468 1469

/* Reset the compression stream */
extern PNG_EXPORT(int,png_reset_zstream) PNGARG((png_structp png_ptr));

1470
/* New functions added in libpng-1.0.2 (not enabled by default until 1.2.0) */
1471 1472 1473 1474 1475 1476
#ifdef PNG_USER_MEM_SUPPORTED
extern PNG_EXPORT(png_structp,png_create_read_struct_2)
   PNGARG((png_const_charp user_png_ver, png_voidp error_ptr,
   png_error_ptr error_fn, png_error_ptr warn_fn, png_voidp mem_ptr,
   png_malloc_ptr malloc_fn, png_free_ptr free_fn));
extern PNG_EXPORT(png_structp,png_create_write_struct_2)
1477
   PNGARG((png_const_charp user_png_ver, png_voidp error_ptr,
1478 1479 1480 1481
   png_error_ptr error_fn, png_error_ptr warn_fn, png_voidp mem_ptr,
   png_malloc_ptr malloc_fn, png_free_ptr free_fn));
#endif

1482 1483 1484 1485 1486 1487 1488 1489 1490 1491 1492 1493 1494 1495 1496
/* Write a PNG chunk - size, type, (optional) data, CRC. */
extern PNG_EXPORT(void,png_write_chunk) PNGARG((png_structp png_ptr,
   png_bytep chunk_name, png_bytep data, png_size_t length));

/* Write the start of a PNG chunk - length and chunk name. */
extern PNG_EXPORT(void,png_write_chunk_start) PNGARG((png_structp png_ptr,
   png_bytep chunk_name, png_uint_32 length));

/* Write the data of a PNG chunk started with png_write_chunk_start(). */
extern PNG_EXPORT(void,png_write_chunk_data) PNGARG((png_structp png_ptr,
   png_bytep data, png_size_t length));

/* Finish a chunk started with png_write_chunk_start() (includes CRC). */
extern PNG_EXPORT(void,png_write_chunk_end) PNGARG((png_structp png_ptr));

A
Andreas Dilger 已提交
1497 1498 1499
/* Allocate and initialize the info structure */
extern PNG_EXPORT(png_infop,png_create_info_struct)
   PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
1500

1501
#if defined(PNG_1_0_X) || defined (PNG_1_2_X)
1502 1503
/* Initialize the info structure (old interface - DEPRECATED) */
extern PNG_EXPORT(void,png_info_init) PNGARG((png_infop info_ptr));
1504
#undef png_info_init
1505 1506
#define png_info_init(info_ptr) png_info_init_3(&info_ptr,\
    png_sizeof(png_info));
1507 1508
#endif

1509 1510
extern PNG_EXPORT(void,png_info_init_3) PNGARG((png_infopp info_ptr,
    png_size_t png_info_struct_size));
G
Guy Schalnat 已提交
1511

A
Andreas Dilger 已提交
1512
/* Writes all the PNG information before the image. */
1513 1514
extern PNG_EXPORT(void,png_write_info_before_PLTE) PNGARG((png_structp png_ptr,
   png_infop info_ptr));
A
Andreas Dilger 已提交
1515 1516
extern PNG_EXPORT(void,png_write_info) PNGARG((png_structp png_ptr,
   png_infop info_ptr));
G
Guy Schalnat 已提交
1517

1518
#ifndef PNG_NO_SEQUENTIAL_READ_SUPPORTED
G
Guy Schalnat 已提交
1519
/* read the information before the actual image data. */
A
Andreas Dilger 已提交
1520 1521
extern PNG_EXPORT(void,png_read_info) PNGARG((png_structp png_ptr,
   png_infop info_ptr));
1522
#endif
G
Guy Schalnat 已提交
1523

1524 1525
#if defined(PNG_TIME_RFC1123_SUPPORTED)
extern PNG_EXPORT(png_charp,png_convert_to_rfc1123)
1526
   PNGARG((png_structp png_ptr, png_timep ptime));
1527
#endif
1528

1529 1530
#if !defined(_WIN32_WCE)
/* "time.h" functions are not supported on WindowsCE */
G
Guy Schalnat 已提交
1531
#if defined(PNG_WRITE_tIME_SUPPORTED)
G
Guy Schalnat 已提交
1532
/* convert from a struct tm to png_time */
A
Andreas Dilger 已提交
1533
extern PNG_EXPORT(void,png_convert_from_struct_tm) PNGARG((png_timep ptime,
G
Guy Schalnat 已提交
1534
   struct tm FAR * ttime));
G
Guy Schalnat 已提交
1535 1536

/* convert from time_t to png_time.  Uses gmtime() */
A
Andreas Dilger 已提交
1537 1538 1539
extern PNG_EXPORT(void,png_convert_from_time_t) PNGARG((png_timep ptime,
   time_t ttime));
#endif /* PNG_WRITE_tIME_SUPPORTED */
1540
#endif /* _WIN32_WCE */
G
Guy Schalnat 已提交
1541

G
Guy Schalnat 已提交
1542
#if defined(PNG_READ_EXPAND_SUPPORTED)
1543
/* Expand data to 24-bit RGB, or 8-bit grayscale, with alpha if available. */
A
Andreas Dilger 已提交
1544
extern PNG_EXPORT(void,png_set_expand) PNGARG((png_structp png_ptr));
1545 1546 1547 1548
#if !defined(PNG_1_0_X)
extern PNG_EXPORT(void,png_set_expand_gray_1_2_4_to_8) PNGARG((png_structp
  png_ptr));
#endif
1549 1550
extern PNG_EXPORT(void,png_set_palette_to_rgb) PNGARG((png_structp png_ptr));
extern PNG_EXPORT(void,png_set_tRNS_to_alpha) PNGARG((png_structp png_ptr));
1551 1552 1553 1554
#if defined(PNG_1_0_X) || defined (PNG_1_2_X)
/* Deprecated */
extern PNG_EXPORT(void,png_set_gray_1_2_4_to_8) PNGARG((png_structp png_ptr));
#endif
1555
#endif
G
Guy Schalnat 已提交
1556

G
Guy Schalnat 已提交
1557
#if defined(PNG_READ_BGR_SUPPORTED) || defined(PNG_WRITE_BGR_SUPPORTED)
G
Guy Schalnat 已提交
1558
/* Use blue, green, red order for pixels. */
A
Andreas Dilger 已提交
1559
extern PNG_EXPORT(void,png_set_bgr) PNGARG((png_structp png_ptr));
1560
#endif
G
Guy Schalnat 已提交
1561

G
Guy Schalnat 已提交
1562
#if defined(PNG_READ_GRAY_TO_RGB_SUPPORTED)
1563
/* Expand the grayscale to 24-bit RGB if necessary. */
A
Andreas Dilger 已提交
1564
extern PNG_EXPORT(void,png_set_gray_to_rgb) PNGARG((png_structp png_ptr));
1565
#endif
G
Guy Schalnat 已提交
1566

A
Andreas Dilger 已提交
1567
#if defined(PNG_READ_RGB_TO_GRAY_SUPPORTED)
1568
/* Reduce RGB to grayscale. */
1569
#ifdef PNG_FLOATING_POINT_SUPPORTED
1570
extern PNG_EXPORT(void,png_set_rgb_to_gray) PNGARG((png_structp png_ptr,
1571
   int error_action, double red, double green ));
1572
#endif
1573 1574
extern PNG_EXPORT(void,png_set_rgb_to_gray_fixed) PNGARG((png_structp png_ptr,
   int error_action, png_fixed_point red, png_fixed_point green ));
1575 1576
extern PNG_EXPORT(png_byte,png_get_rgb_to_gray_status) PNGARG((png_structp
   png_ptr));
1577
#endif
A
Andreas Dilger 已提交
1578

A
Andreas Dilger 已提交
1579
extern PNG_EXPORT(void,png_build_grayscale_palette) PNGARG((int bit_depth,
A
Andreas Dilger 已提交
1580 1581
   png_colorp palette));

A
Andreas Dilger 已提交
1582 1583
#if defined(PNG_READ_STRIP_ALPHA_SUPPORTED)
extern PNG_EXPORT(void,png_set_strip_alpha) PNGARG((png_structp png_ptr));
1584
#endif
G
Guy Schalnat 已提交
1585

A
Andreas Dilger 已提交
1586 1587 1588
#if defined(PNG_READ_SWAP_ALPHA_SUPPORTED) || \
    defined(PNG_WRITE_SWAP_ALPHA_SUPPORTED)
extern PNG_EXPORT(void,png_set_swap_alpha) PNGARG((png_structp png_ptr));
1589
#endif
G
Guy Schalnat 已提交
1590

1591 1592 1593
#if defined(PNG_READ_INVERT_ALPHA_SUPPORTED) || \
    defined(PNG_WRITE_INVERT_ALPHA_SUPPORTED)
extern PNG_EXPORT(void,png_set_invert_alpha) PNGARG((png_structp png_ptr));
1594
#endif
1595

A
Andreas Dilger 已提交
1596
#if defined(PNG_READ_FILLER_SUPPORTED) || defined(PNG_WRITE_FILLER_SUPPORTED)
1597
/* Add a filler byte to 8-bit Gray or 24-bit RGB images. */
A
Andreas Dilger 已提交
1598 1599 1600 1601 1602
extern PNG_EXPORT(void,png_set_filler) PNGARG((png_structp png_ptr,
   png_uint_32 filler, int flags));
/* The values of the PNG_FILLER_ defines should NOT be changed */
#define PNG_FILLER_BEFORE 0
#define PNG_FILLER_AFTER 1
1603 1604 1605 1606 1607
/* Add an alpha byte to 8-bit Gray or 24-bit RGB images. */
#if !defined(PNG_1_0_X)
extern PNG_EXPORT(void,png_set_add_alpha) PNGARG((png_structp png_ptr,
   png_uint_32 filler, int flags));
#endif
A
Andreas Dilger 已提交
1608
#endif /* PNG_READ_FILLER_SUPPORTED || PNG_WRITE_FILLER_SUPPORTED */
G
Guy Schalnat 已提交
1609

G
Guy Schalnat 已提交
1610
#if defined(PNG_READ_SWAP_SUPPORTED) || defined(PNG_WRITE_SWAP_SUPPORTED)
1611
/* Swap bytes in 16-bit depth files. */
A
Andreas Dilger 已提交
1612
extern PNG_EXPORT(void,png_set_swap) PNGARG((png_structp png_ptr));
1613
#endif
G
Guy Schalnat 已提交
1614

G
Guy Schalnat 已提交
1615
#if defined(PNG_READ_PACK_SUPPORTED) || defined(PNG_WRITE_PACK_SUPPORTED)
1616
/* Use 1 byte per pixel in 1, 2, or 4-bit depth files. */
A
Andreas Dilger 已提交
1617
extern PNG_EXPORT(void,png_set_packing) PNGARG((png_structp png_ptr));
1618
#endif
A
Andreas Dilger 已提交
1619

1620
#if defined(PNG_READ_PACKSWAP_SUPPORTED) || defined(PNG_WRITE_PACKSWAP_SUPPORTED)
A
Andreas Dilger 已提交
1621 1622
/* Swap packing order of pixels in bytes. */
extern PNG_EXPORT(void,png_set_packswap) PNGARG((png_structp png_ptr));
1623
#endif
G
Guy Schalnat 已提交
1624

G
Guy Schalnat 已提交
1625
#if defined(PNG_READ_SHIFT_SUPPORTED) || defined(PNG_WRITE_SHIFT_SUPPORTED)
G
Guy Schalnat 已提交
1626
/* Converts files to legal bit depths. */
A
Andreas Dilger 已提交
1627
extern PNG_EXPORT(void,png_set_shift) PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
1628
   png_color_8p true_bits));
1629
#endif
G
Guy Schalnat 已提交
1630

G
Guy Schalnat 已提交
1631 1632
#if defined(PNG_READ_INTERLACING_SUPPORTED) || \
    defined(PNG_WRITE_INTERLACING_SUPPORTED)
G
Guy Schalnat 已提交
1633
/* Have the code handle the interlacing.  Returns the number of passes. */
A
Andreas Dilger 已提交
1634
extern PNG_EXPORT(int,png_set_interlace_handling) PNGARG((png_structp png_ptr));
1635
#endif
G
Guy Schalnat 已提交
1636

G
Guy Schalnat 已提交
1637
#if defined(PNG_READ_INVERT_SUPPORTED) || defined(PNG_WRITE_INVERT_SUPPORTED)
1638
/* Invert monochrome files */
A
Andreas Dilger 已提交
1639
extern PNG_EXPORT(void,png_set_invert_mono) PNGARG((png_structp png_ptr));
1640
#endif
G
Guy Schalnat 已提交
1641

G
Guy Schalnat 已提交
1642
#if defined(PNG_READ_BACKGROUND_SUPPORTED)
G
Guy Schalnat 已提交
1643
/* Handle alpha and tRNS by replacing with a background color. */
1644
#ifdef PNG_FLOATING_POINT_SUPPORTED
A
Andreas Dilger 已提交
1645 1646 1647
extern PNG_EXPORT(void,png_set_background) PNGARG((png_structp png_ptr,
   png_color_16p background_color, int background_gamma_code,
   int need_expand, double background_gamma));
1648
#endif
G
Guy Schalnat 已提交
1649 1650 1651 1652
#define PNG_BACKGROUND_GAMMA_UNKNOWN 0
#define PNG_BACKGROUND_GAMMA_SCREEN  1
#define PNG_BACKGROUND_GAMMA_FILE    2
#define PNG_BACKGROUND_GAMMA_UNIQUE  3
1653
#endif
G
Guy Schalnat 已提交
1654

G
Guy Schalnat 已提交
1655
#if defined(PNG_READ_16_TO_8_SUPPORTED)
1656
/* strip the second byte of information from a 16-bit depth file. */
A
Andreas Dilger 已提交
1657
extern PNG_EXPORT(void,png_set_strip_16) PNGARG((png_structp png_ptr));
1658
#endif
G
Guy Schalnat 已提交
1659

G
Guy Schalnat 已提交
1660
#if defined(PNG_READ_DITHER_SUPPORTED)
G
Guy Schalnat 已提交
1661
/* Turn on dithering, and reduce the palette to the number of colors available. */
A
Andreas Dilger 已提交
1662 1663 1664
extern PNG_EXPORT(void,png_set_dither) PNGARG((png_structp png_ptr,
   png_colorp palette, int num_palette, int maximum_colors,
   png_uint_16p histogram, int full_dither));
1665
#endif
G
Guy Schalnat 已提交
1666

G
Guy Schalnat 已提交
1667
#if defined(PNG_READ_GAMMA_SUPPORTED)
1668
/* Handle gamma correction. Screen_gamma=(display_exponent) */
1669
#ifdef PNG_FLOATING_POINT_SUPPORTED
A
Andreas Dilger 已提交
1670 1671
extern PNG_EXPORT(void,png_set_gamma) PNGARG((png_structp png_ptr,
   double screen_gamma, double default_file_gamma));
1672 1673
#endif
#endif
G
Guy Schalnat 已提交
1674

1675
#if defined(PNG_1_0_X) || defined (PNG_1_2_X)
1676 1677 1678
#if defined(PNG_READ_EMPTY_PLTE_SUPPORTED) || \
    defined(PNG_WRITE_EMPTY_PLTE_SUPPORTED)
/* Permit or disallow empty PLTE (0: not permitted, 1: permitted) */
1679
/* Deprecated and will be removed.  Use png_permit_mng_features() instead. */
1680 1681
extern PNG_EXPORT(void,png_permit_empty_plte) PNGARG((png_structp png_ptr,
   int empty_plte_permitted));
1682
#endif
1683
#endif
1684

G
Guy Schalnat 已提交
1685 1686
#if defined(PNG_WRITE_FLUSH_SUPPORTED)
/* Set how many lines between output flushes - 0 for no flushing */
A
Andreas Dilger 已提交
1687
extern PNG_EXPORT(void,png_set_flush) PNGARG((png_structp png_ptr, int nrows));
G
Guy Schalnat 已提交
1688
/* Flush the current PNG output buffer */
A
Andreas Dilger 已提交
1689
extern PNG_EXPORT(void,png_write_flush) PNGARG((png_structp png_ptr));
1690
#endif
G
Guy Schalnat 已提交
1691

G
Guy Schalnat 已提交
1692
/* optional update palette with requested transformations */
A
Andreas Dilger 已提交
1693
extern PNG_EXPORT(void,png_start_read_image) PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
1694 1695

/* optional call to update the users info structure */
A
Andreas Dilger 已提交
1696
extern PNG_EXPORT(void,png_read_update_info) PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
1697
   png_infop info_ptr));
G
Guy Schalnat 已提交
1698

1699
#ifndef PNG_NO_SEQUENTIAL_READ_SUPPORTED
1700
/* read one or more rows of image data. */
A
Andreas Dilger 已提交
1701 1702
extern PNG_EXPORT(void,png_read_rows) PNGARG((png_structp png_ptr,
   png_bytepp row, png_bytepp display_row, png_uint_32 num_rows));
1703
#endif
G
Guy Schalnat 已提交
1704

1705
#ifndef PNG_NO_SEQUENTIAL_READ_SUPPORTED
1706
/* read a row of data. */
A
Andreas Dilger 已提交
1707
extern PNG_EXPORT(void,png_read_row) PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
1708 1709
   png_bytep row,
   png_bytep display_row));
1710
#endif
G
Guy Schalnat 已提交
1711

1712
#ifndef PNG_NO_SEQUENTIAL_READ_SUPPORTED
G
Guy Schalnat 已提交
1713
/* read the whole image into memory at once. */
A
Andreas Dilger 已提交
1714
extern PNG_EXPORT(void,png_read_image) PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
1715
   png_bytepp image));
1716
#endif
G
Guy Schalnat 已提交
1717 1718

/* write a row of image data */
A
Andreas Dilger 已提交
1719
extern PNG_EXPORT(void,png_write_row) PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
1720
   png_bytep row));
G
Guy Schalnat 已提交
1721 1722

/* write a few rows of image data */
A
Andreas Dilger 已提交
1723 1724
extern PNG_EXPORT(void,png_write_rows) PNGARG((png_structp png_ptr,
   png_bytepp row, png_uint_32 num_rows));
G
Guy Schalnat 已提交
1725 1726

/* write the image data */
A
Andreas Dilger 已提交
1727 1728
extern PNG_EXPORT(void,png_write_image) PNGARG((png_structp png_ptr,
   png_bytepp image));
G
Guy Schalnat 已提交
1729

A
Andreas Dilger 已提交
1730 1731 1732
/* writes the end of the PNG file. */
extern PNG_EXPORT(void,png_write_end) PNGARG((png_structp png_ptr,
   png_infop info_ptr));
G
Guy Schalnat 已提交
1733

1734
#ifndef PNG_NO_SEQUENTIAL_READ_SUPPORTED
A
Andreas Dilger 已提交
1735 1736 1737
/* read the end of the PNG file. */
extern PNG_EXPORT(void,png_read_end) PNGARG((png_structp png_ptr,
   png_infop info_ptr));
1738
#endif
G
Guy Schalnat 已提交
1739

A
Andreas Dilger 已提交
1740 1741
/* free any memory associated with the png_info_struct */
extern PNG_EXPORT(void,png_destroy_info_struct) PNGARG((png_structp png_ptr,
A
Andreas Dilger 已提交
1742
   png_infopp info_ptr_ptr));
G
Guy Schalnat 已提交
1743

A
Andreas Dilger 已提交
1744 1745 1746
/* free any memory associated with the png_struct and the png_info_structs */
extern PNG_EXPORT(void,png_destroy_read_struct) PNGARG((png_structpp
   png_ptr_ptr, png_infopp info_ptr_ptr, png_infopp end_info_ptr_ptr));
G
Guy Schalnat 已提交
1747

A
Andreas Dilger 已提交
1748
/* free all memory used by the read (old method - NOT DLL EXPORTED) */
A
Andreas Dilger 已提交
1749 1750
extern void png_read_destroy PNGARG((png_structp png_ptr, png_infop info_ptr,
   png_infop end_info_ptr));
G
Guy Schalnat 已提交
1751

A
Andreas Dilger 已提交
1752 1753 1754
/* free any memory associated with the png_struct and the png_info_structs */
extern PNG_EXPORT(void,png_destroy_write_struct)
   PNGARG((png_structpp png_ptr_ptr, png_infopp info_ptr_ptr));
G
Guy Schalnat 已提交
1755

A
Andreas Dilger 已提交
1756
/* free any memory used in png_ptr struct (old method - NOT DLL EXPORTED) */
G
Guy Schalnat 已提交
1757
extern void png_write_destroy PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
1758

A
Andreas Dilger 已提交
1759
/* set the libpng method of handling chunk CRC errors */
A
Andreas Dilger 已提交
1760 1761
extern PNG_EXPORT(void,png_set_crc_action) PNGARG((png_structp png_ptr,
   int crit_action, int ancil_action));
A
Andreas Dilger 已提交
1762 1763

/* Values for png_set_crc_action() to say how to handle CRC errors in
A
Andreas Dilger 已提交
1764 1765 1766 1767 1768 1769 1770
 * ancillary and critical chunks, and whether to use the data contained
 * therein.  Note that it is impossible to "discard" data in a critical
 * chunk.  For versions prior to 0.90, the action was always error/quit,
 * whereas in version 0.90 and later, the action for CRC errors in ancillary
 * chunks is warn/discard.  These values should NOT be changed.
 *
 *      value                       action:critical     action:ancillary
A
Andreas Dilger 已提交
1771 1772 1773 1774 1775 1776 1777 1778
 */
#define PNG_CRC_DEFAULT       0  /* error/quit          warn/discard data */
#define PNG_CRC_ERROR_QUIT    1  /* error/quit          error/quit        */
#define PNG_CRC_WARN_DISCARD  2  /* (INVALID)           warn/discard data */
#define PNG_CRC_WARN_USE      3  /* warn/use data       warn/use data     */
#define PNG_CRC_QUIET_USE     4  /* quiet/use data      quiet/use data    */
#define PNG_CRC_NO_CHANGE     5  /* use current value   use current value */

A
Andreas Dilger 已提交
1779 1780 1781 1782 1783
/* These functions give the user control over the scan-line filtering in
 * libpng and the compression methods used by zlib.  These functions are
 * mainly useful for testing, as the defaults should work with most users.
 * Those users who are tight on memory or want faster performance at the
 * expense of compression can modify them.  See the compression library
1784 1785
 * header file (zlib.h) for an explination of the compression functions.
 */
A
Andreas Dilger 已提交
1786

A
Andreas Dilger 已提交
1787
/* set the filtering method(s) used by libpng.  Currently, the only valid
1788 1789
 * value for "method" is 0.
 */
A
Andreas Dilger 已提交
1790
extern PNG_EXPORT(void,png_set_filter) PNGARG((png_structp png_ptr, int method,
G
Guy Schalnat 已提交
1791
   int filters));
G
Guy Schalnat 已提交
1792

A
Andreas Dilger 已提交
1793
/* Flags for png_set_filter() to say which filters to use.  The flags
A
Andreas Dilger 已提交
1794 1795 1796
 * are chosen so that they don't conflict with real filter types
 * below, in case they are supplied instead of the #defined constants.
 * These values should NOT be changed.
A
Andreas Dilger 已提交
1797 1798 1799 1800 1801 1802 1803 1804 1805 1806
 */
#define PNG_NO_FILTERS     0x00
#define PNG_FILTER_NONE    0x08
#define PNG_FILTER_SUB     0x10
#define PNG_FILTER_UP      0x20
#define PNG_FILTER_AVG     0x40
#define PNG_FILTER_PAETH   0x80
#define PNG_ALL_FILTERS (PNG_FILTER_NONE | PNG_FILTER_SUB | PNG_FILTER_UP | \
                         PNG_FILTER_AVG | PNG_FILTER_PAETH)

A
Andreas Dilger 已提交
1807 1808 1809 1810 1811 1812 1813 1814 1815 1816 1817 1818 1819 1820 1821 1822 1823 1824 1825 1826 1827 1828 1829 1830 1831 1832 1833 1834 1835 1836 1837 1838 1839 1840 1841 1842 1843 1844 1845
/* Filter values (not flags) - used in pngwrite.c, pngwutil.c for now.
 * These defines should NOT be changed.
 */
#define PNG_FILTER_VALUE_NONE  0
#define PNG_FILTER_VALUE_SUB   1
#define PNG_FILTER_VALUE_UP    2
#define PNG_FILTER_VALUE_AVG   3
#define PNG_FILTER_VALUE_PAETH 4
#define PNG_FILTER_VALUE_LAST  5

#if defined(PNG_WRITE_WEIGHTED_FILTER_SUPPORTED) /* EXPERIMENTAL */
/* The "heuristic_method" is given by one of the PNG_FILTER_HEURISTIC_
 * defines, either the default (minimum-sum-of-absolute-differences), or
 * the experimental method (weighted-minimum-sum-of-absolute-differences).
 *
 * Weights are factors >= 1.0, indicating how important it is to keep the
 * filter type consistent between rows.  Larger numbers mean the current
 * filter is that many times as likely to be the same as the "num_weights"
 * previous filters.  This is cumulative for each previous row with a weight.
 * There needs to be "num_weights" values in "filter_weights", or it can be
 * NULL if the weights aren't being specified.  Weights have no influence on
 * the selection of the first row filter.  Well chosen weights can (in theory)
 * improve the compression for a given image.
 *
 * Costs are factors >= 1.0 indicating the relative decoding costs of a
 * filter type.  Higher costs indicate more decoding expense, and are
 * therefore less likely to be selected over a filter with lower computational
 * costs.  There needs to be a value in "filter_costs" for each valid filter
 * type (given by PNG_FILTER_VALUE_LAST), or it can be NULL if you aren't
 * setting the costs.  Costs try to improve the speed of decompression without
 * unduly increasing the compressed image size.
 *
 * A negative weight or cost indicates the default value is to be used, and
 * values in the range [0.0, 1.0) indicate the value is to remain unchanged.
 * The default values for both weights and costs are currently 1.0, but may
 * change if good general weighting/cost heuristics can be found.  If both
 * the weights and costs are set to 1.0, this degenerates the WEIGHTED method
 * to the UNWEIGHTED method, but with added encoding time/computation.
 */
1846
#ifdef PNG_FLOATING_POINT_SUPPORTED
A
Andreas Dilger 已提交
1847 1848 1849
extern PNG_EXPORT(void,png_set_filter_heuristics) PNGARG((png_structp png_ptr,
   int heuristic_method, int num_weights, png_doublep filter_weights,
   png_doublep filter_costs));
1850
#endif
A
Andreas Dilger 已提交
1851 1852 1853 1854 1855 1856 1857 1858 1859 1860 1861 1862 1863 1864 1865 1866 1867 1868
#endif /*  PNG_WRITE_WEIGHTED_FILTER_SUPPORTED */

/* Heuristic used for row filter selection.  These defines should NOT be
 * changed.
 */
#define PNG_FILTER_HEURISTIC_DEFAULT    0  /* Currently "UNWEIGHTED" */
#define PNG_FILTER_HEURISTIC_UNWEIGHTED 1  /* Used by libpng < 0.95 */
#define PNG_FILTER_HEURISTIC_WEIGHTED   2  /* Experimental feature */
#define PNG_FILTER_HEURISTIC_LAST       3  /* Not a valid value */

/* Set the library compression level.  Currently, valid values range from
 * 0 - 9, corresponding directly to the zlib compression levels 0 - 9
 * (0 - no compression, 9 - "maximal" compression).  Note that tests have
 * shown that zlib compression levels 3-6 usually perform as well as level 9
 * for PNG images, and do considerably fewer caclulations.  In the future,
 * these values may not correspond directly to the zlib compression levels.
 */
extern PNG_EXPORT(void,png_set_compression_level) PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
1869 1870
   int level));

A
Andreas Dilger 已提交
1871 1872
extern PNG_EXPORT(void,png_set_compression_mem_level)
   PNGARG((png_structp png_ptr, int mem_level));
G
Guy Schalnat 已提交
1873

A
Andreas Dilger 已提交
1874 1875
extern PNG_EXPORT(void,png_set_compression_strategy)
   PNGARG((png_structp png_ptr, int strategy));
G
Guy Schalnat 已提交
1876

A
Andreas Dilger 已提交
1877 1878
extern PNG_EXPORT(void,png_set_compression_window_bits)
   PNGARG((png_structp png_ptr, int window_bits));
G
Guy Schalnat 已提交
1879

A
Andreas Dilger 已提交
1880
extern PNG_EXPORT(void,png_set_compression_method) PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
1881
   int method));
G
Guy Schalnat 已提交
1882

G
Guy Schalnat 已提交
1883
/* These next functions are called for input/output, memory, and error
A
Andreas Dilger 已提交
1884 1885 1886 1887 1888 1889 1890
 * handling.  They are in the file pngrio.c, pngwio.c, and pngerror.c,
 * and call standard C I/O routines such as fread(), fwrite(), and
 * fprintf().  These functions can be made to use other I/O routines
 * at run time for those applications that need to handle I/O in a
 * different manner by calling png_set_???_fn().  See libpng.txt for
 * more information.
 */
G
Guy Schalnat 已提交
1891

1892
#if !defined(PNG_NO_STDIO)
A
Andreas Dilger 已提交
1893
/* Initialize the input/output for the PNG file to the default functions. */
1894
extern PNG_EXPORT(void,png_init_io) PNGARG((png_structp png_ptr, png_FILE_p fp));
1895
#endif
G
Guy Schalnat 已提交
1896

A
Andreas Dilger 已提交
1897
/* Replace the (error and abort), and warning functions with user
A
Andreas Dilger 已提交
1898 1899 1900 1901 1902 1903
 * supplied functions.  If no messages are to be printed you must still
 * write and use replacement functions. The replacement error_fn should
 * still do a longjmp to the last setjmp location if you are using this
 * method of error handling.  If error_fn or warning_fn is NULL, the
 * default function will be used.
 */
1904

A
Andreas Dilger 已提交
1905 1906
extern PNG_EXPORT(void,png_set_error_fn) PNGARG((png_structp png_ptr,
   png_voidp error_ptr, png_error_ptr error_fn, png_error_ptr warning_fn));
G
Guy Schalnat 已提交
1907

G
Guy Schalnat 已提交
1908
/* Return the user pointer associated with the error functions */
A
Andreas Dilger 已提交
1909
extern PNG_EXPORT(png_voidp,png_get_error_ptr) PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
1910 1911

/* Replace the default data output functions with a user supplied one(s).
A
Andreas Dilger 已提交
1912 1913 1914 1915 1916 1917
 * If buffered output is not used, then output_flush_fn can be set to NULL.
 * If PNG_WRITE_FLUSH_SUPPORTED is not defined at libpng compile time
 * output_flush_fn will be ignored (and thus can be NULL).
 */
extern PNG_EXPORT(void,png_set_write_fn) PNGARG((png_structp png_ptr,
   png_voidp io_ptr, png_rw_ptr write_data_fn, png_flush_ptr output_flush_fn));
G
Guy Schalnat 已提交
1918 1919

/* Replace the default data input function with a user supplied one. */
A
Andreas Dilger 已提交
1920 1921
extern PNG_EXPORT(void,png_set_read_fn) PNGARG((png_structp png_ptr,
   png_voidp io_ptr, png_rw_ptr read_data_fn));
G
Guy Schalnat 已提交
1922 1923

/* Return the user pointer associated with the I/O functions */
A
Andreas Dilger 已提交
1924
extern PNG_EXPORT(png_voidp,png_get_io_ptr) PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
1925

1926 1927 1928 1929 1930 1931
extern PNG_EXPORT(void,png_set_read_status_fn) PNGARG((png_structp png_ptr,
   png_read_status_ptr read_row_fn));

extern PNG_EXPORT(void,png_set_write_status_fn) PNGARG((png_structp png_ptr,
   png_write_status_ptr write_row_fn));

1932 1933 1934 1935 1936 1937
#ifdef PNG_USER_MEM_SUPPORTED
/* Replace the default memory allocation functions with user supplied one(s). */
extern PNG_EXPORT(void,png_set_mem_fn) PNGARG((png_structp png_ptr,
   png_voidp mem_ptr, png_malloc_ptr malloc_fn, png_free_ptr free_fn));
/* Return the user pointer associated with the memory functions */
extern PNG_EXPORT(png_voidp,png_get_mem_ptr) PNGARG((png_structp png_ptr));
1938
#endif
1939

1940 1941
#if defined(PNG_READ_USER_TRANSFORM_SUPPORTED) || \
    defined(PNG_LEGACY_SUPPORTED)
1942 1943 1944 1945
extern PNG_EXPORT(void,png_set_read_user_transform_fn) PNGARG((png_structp
   png_ptr, png_user_transform_ptr read_user_transform_fn));
#endif

1946 1947
#if defined(PNG_WRITE_USER_TRANSFORM_SUPPORTED) || \
    defined(PNG_LEGACY_SUPPORTED)
1948 1949 1950 1951
extern PNG_EXPORT(void,png_set_write_user_transform_fn) PNGARG((png_structp
   png_ptr, png_user_transform_ptr write_user_transform_fn));
#endif

1952
#if defined(PNG_READ_USER_TRANSFORM_SUPPORTED) || \
1953 1954
    defined(PNG_WRITE_USER_TRANSFORM_SUPPORTED) || \
    defined(PNG_LEGACY_SUPPORTED)
1955 1956 1957 1958 1959 1960 1961 1962
extern PNG_EXPORT(void,png_set_user_transform_info) PNGARG((png_structp
   png_ptr, png_voidp user_transform_ptr, int user_transform_depth,
   int user_transform_channels));
/* Return the user pointer associated with the user transform functions */
extern PNG_EXPORT(png_voidp,png_get_user_transform_ptr)
   PNGARG((png_structp png_ptr));
#endif

1963
#ifdef PNG_USER_CHUNKS_SUPPORTED
1964 1965 1966 1967 1968 1969
extern PNG_EXPORT(void,png_set_read_user_chunk_fn) PNGARG((png_structp png_ptr,
   png_voidp user_chunk_ptr, png_user_chunk_ptr read_user_chunk_fn));
extern PNG_EXPORT(png_voidp,png_get_user_chunk_ptr) PNGARG((png_structp
   png_ptr));
#endif

G
Guy Schalnat 已提交
1970
#ifdef PNG_PROGRESSIVE_READ_SUPPORTED
A
Andreas Dilger 已提交
1971 1972 1973 1974 1975
/* Sets the function callbacks for the push reader, and a pointer to a
 * user-defined structure available to the callback functions.
 */
extern PNG_EXPORT(void,png_set_progressive_read_fn) PNGARG((png_structp png_ptr,
   png_voidp progressive_ptr,
G
Guy Schalnat 已提交
1976 1977
   png_progressive_info_ptr info_fn, png_progressive_row_ptr row_fn,
   png_progressive_end_ptr end_fn));
G
Guy Schalnat 已提交
1978

G
Guy Schalnat 已提交
1979
/* returns the user pointer associated with the push read functions */
A
Andreas Dilger 已提交
1980 1981 1982 1983 1984 1985 1986
extern PNG_EXPORT(png_voidp,png_get_progressive_ptr)
   PNGARG((png_structp png_ptr));

/* function to be called when data becomes available */
extern PNG_EXPORT(void,png_process_data) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_bytep buffer, png_size_t buffer_size));

1987
/* function that combines rows.  Not very much different than the
A
Andreas Dilger 已提交
1988 1989 1990 1991
 * png_combine_row() call.  Is this even used?????
 */
extern PNG_EXPORT(void,png_progressive_combine_row) PNGARG((png_structp png_ptr,
   png_bytep old_row, png_bytep new_row));
G
Guy Schalnat 已提交
1992
#endif /* PNG_PROGRESSIVE_READ_SUPPORTED */
G
Guy Schalnat 已提交
1993

A
Andreas Dilger 已提交
1994
extern PNG_EXPORT(png_voidp,png_malloc) PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
1995
   png_uint_32 size));
G
Guy Schalnat 已提交
1996

1997 1998 1999
#if defined(PNG_1_0_X)
#  define png_malloc_warn png_malloc
#else
2000 2001 2002
/* Added at libpng version 1.2.4 */
extern PNG_EXPORT(png_voidp,png_malloc_warn) PNGARG((png_structp png_ptr,
   png_uint_32 size));
2003
#endif
2004

2005
/* frees a pointer allocated by png_malloc() */
A
Andreas Dilger 已提交
2006 2007
extern PNG_EXPORT(void,png_free) PNGARG((png_structp png_ptr, png_voidp ptr));

2008 2009 2010 2011 2012 2013 2014 2015 2016
#if defined(PNG_1_0_X)
/* Function to allocate memory for zlib. */
extern PNG_EXPORT(voidpf,png_zalloc) PNGARG((voidpf png_ptr, uInt items,
   uInt size));

/* Function to free memory for zlib */
extern PNG_EXPORT(void,png_zfree) PNGARG((voidpf png_ptr, voidpf ptr));
#endif

2017
/* Free data that was allocated internally */
2018 2019
extern PNG_EXPORT(void,png_free_data) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_uint_32 free_me, int num));
2020
#ifdef PNG_FREE_ME_SUPPORTED
2021 2022 2023 2024
/* Reassign responsibility for freeing existing data, whether allocated
 * by libpng or by the application */
extern PNG_EXPORT(void,png_data_freer) PNGARG((png_structp png_ptr,
   png_infop info_ptr, int freer, png_uint_32 mask));
2025
#endif
2026 2027 2028 2029 2030
/* assignments for png_data_freer */
#define PNG_DESTROY_WILL_FREE_DATA 1
#define PNG_SET_WILL_FREE_DATA 1
#define PNG_USER_WILL_FREE_DATA 2
/* Flags for png_ptr->free_me and info_ptr->free_me */
2031 2032 2033 2034
#define PNG_FREE_HIST 0x0008
#define PNG_FREE_ICCP 0x0010
#define PNG_FREE_SPLT 0x0020
#define PNG_FREE_ROWS 0x0040
2035 2036
#define PNG_FREE_PCAL 0x0080
#define PNG_FREE_SCAL 0x0100
2037 2038
#define PNG_FREE_UNKN 0x0200
#define PNG_FREE_LIST 0x0400
2039 2040 2041
#define PNG_FREE_PLTE 0x1000
#define PNG_FREE_TRNS 0x2000
#define PNG_FREE_TEXT 0x4000
2042
#define PNG_FREE_ALL  0x7fff
2043
#define PNG_FREE_MUL  0x4220 /* PNG_FREE_SPLT|PNG_FREE_TEXT|PNG_FREE_UNKN */
2044

2045 2046 2047 2048 2049
#ifdef PNG_USER_MEM_SUPPORTED
extern PNG_EXPORT(png_voidp,png_malloc_default) PNGARG((png_structp png_ptr,
   png_uint_32 size));
extern PNG_EXPORT(void,png_free_default) PNGARG((png_structp png_ptr,
   png_voidp ptr));
2050
#endif
2051

2052
extern PNG_EXPORT(png_voidp,png_memcpy_check) PNGARG((png_structp png_ptr,
2053 2054
   png_voidp s1, png_voidp s2, png_uint_32 size));

2055
extern PNG_EXPORT(png_voidp,png_memset_check) PNGARG((png_structp png_ptr,
2056 2057
   png_voidp s1, int value, png_uint_32 size));

A
Andreas Dilger 已提交
2058
#if defined(USE_FAR_KEYWORD)  /* memory model conversion function */
2059 2060
extern void *png_far_to_near PNGARG((png_structp png_ptr,png_voidp ptr,
   int check));
A
Andreas Dilger 已提交
2061
#endif /* USE_FAR_KEYWORD */
G
Guy Schalnat 已提交
2062

2063
#ifndef PNG_NO_ERROR_TEXT
A
Andreas Dilger 已提交
2064 2065
/* Fatal error in PNG image of libpng - can't continue */
extern PNG_EXPORT(void,png_error) PNGARG((png_structp png_ptr,
2066
   png_const_charp error_message));
G
Guy Schalnat 已提交
2067

2068 2069
/* The same, but the chunk name is prepended to the error string. */
extern PNG_EXPORT(void,png_chunk_error) PNGARG((png_structp png_ptr,
2070
   png_const_charp error_message));
2071 2072 2073 2074
#else
/* Fatal error in PNG image of libpng - can't continue */
extern PNG_EXPORT(void,png_err) PNGARG((png_structp png_ptr));
#endif
2075

2076
#ifndef PNG_NO_WARNINGS
G
Guy Schalnat 已提交
2077
/* Non-fatal error in libpng.  Can continue, but may have a problem. */
A
Andreas Dilger 已提交
2078
extern PNG_EXPORT(void,png_warning) PNGARG((png_structp png_ptr,
2079
   png_const_charp warning_message));
A
Andreas Dilger 已提交
2080

2081
#ifdef PNG_READ_SUPPORTED
2082 2083
/* Non-fatal error in libpng, chunk name is prepended to message. */
extern PNG_EXPORT(void,png_chunk_warning) PNGARG((png_structp png_ptr,
2084
   png_const_charp warning_message));
2085 2086
#endif /* PNG_READ_SUPPORTED */
#endif /* PNG_NO_WARNINGS */
2087

A
Andreas Dilger 已提交
2088 2089 2090 2091 2092 2093 2094 2095 2096 2097 2098 2099
/* The png_set_<chunk> functions are for storing values in the png_info_struct.
 * Similarly, the png_get_<chunk> calls are used to read values from the
 * png_info_struct, either storing the parameters in the passed variables, or
 * setting pointers into the png_info_struct where the data is stored.  The
 * png_get_<chunk> functions return a non-zero value if the data was available
 * in info_ptr, or return zero and do not change any of the parameters if the
 * data was not available.
 *
 * These functions should be used instead of directly accessing png_info
 * to avoid problems with future changes in the size and internal layout of
 * png_info_struct.
 */
2100
/* Returns "flag" if chunk data is valid in info_ptr. */
A
Andreas Dilger 已提交
2101 2102 2103
extern PNG_EXPORT(png_uint_32,png_get_valid) PNGARG((png_structp png_ptr,
png_infop info_ptr, png_uint_32 flag));

2104
/* Returns number of bytes needed to hold a transformed row. */
A
Andreas Dilger 已提交
2105 2106 2107
extern PNG_EXPORT(png_uint_32,png_get_rowbytes) PNGARG((png_structp png_ptr,
png_infop info_ptr));

2108 2109 2110 2111 2112 2113 2114 2115 2116 2117 2118
#if defined(PNG_INFO_IMAGE_SUPPORTED)
/* Returns row_pointers, which is an array of pointers to scanlines that was
returned from png_read_png(). */
extern PNG_EXPORT(png_bytepp,png_get_rows) PNGARG((png_structp png_ptr,
png_infop info_ptr));
/* Set row_pointers, which is an array of pointers to scanlines for use
by png_write_png(). */
extern PNG_EXPORT(void,png_set_rows) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_bytepp row_pointers));
#endif

2119
/* Returns number of color channels in image. */
A
Andreas Dilger 已提交
2120 2121 2122
extern PNG_EXPORT(png_byte,png_get_channels) PNGARG((png_structp png_ptr,
png_infop info_ptr));

2123 2124 2125 2126 2127 2128 2129 2130 2131 2132 2133 2134 2135 2136 2137 2138 2139 2140 2141 2142 2143 2144 2145 2146 2147 2148 2149 2150 2151 2152 2153 2154
#ifdef PNG_EASY_ACCESS_SUPPORTED
/* Returns image width in pixels. */
extern PNG_EXPORT(png_uint_32, png_get_image_width) PNGARG((png_structp
png_ptr, png_infop info_ptr));

/* Returns image height in pixels. */
extern PNG_EXPORT(png_uint_32, png_get_image_height) PNGARG((png_structp
png_ptr, png_infop info_ptr));

/* Returns image bit_depth. */
extern PNG_EXPORT(png_byte, png_get_bit_depth) PNGARG((png_structp
png_ptr, png_infop info_ptr));

/* Returns image color_type. */
extern PNG_EXPORT(png_byte, png_get_color_type) PNGARG((png_structp
png_ptr, png_infop info_ptr));

/* Returns image filter_type. */
extern PNG_EXPORT(png_byte, png_get_filter_type) PNGARG((png_structp
png_ptr, png_infop info_ptr));

/* Returns image interlace_type. */
extern PNG_EXPORT(png_byte, png_get_interlace_type) PNGARG((png_structp
png_ptr, png_infop info_ptr));

/* Returns image compression_type. */
extern PNG_EXPORT(png_byte, png_get_compression_type) PNGARG((png_structp
png_ptr, png_infop info_ptr));

/* Returns image resolution in pixels per meter, from pHYs chunk data. */
extern PNG_EXPORT(png_uint_32, png_get_pixels_per_meter) PNGARG((png_structp
png_ptr, png_infop info_ptr));
2155 2156 2157 2158
extern PNG_EXPORT(png_uint_32, png_get_x_pixels_per_meter) PNGARG((png_structp
png_ptr, png_infop info_ptr));
extern PNG_EXPORT(png_uint_32, png_get_y_pixels_per_meter) PNGARG((png_structp
png_ptr, png_infop info_ptr));
2159 2160

/* Returns pixel aspect ratio, computed from pHYs chunk data.  */
2161
#ifdef PNG_FLOATING_POINT_SUPPORTED
2162 2163
extern PNG_EXPORT(float, png_get_pixel_aspect_ratio) PNGARG((png_structp
png_ptr, png_infop info_ptr));
2164
#endif
2165 2166

/* Returns image x, y offset in pixels or microns, from oFFs chunk data. */
2167
extern PNG_EXPORT(png_int_32, png_get_x_offset_pixels) PNGARG((png_structp
2168
png_ptr, png_infop info_ptr));
2169
extern PNG_EXPORT(png_int_32, png_get_y_offset_pixels) PNGARG((png_structp
2170
png_ptr, png_infop info_ptr));
2171
extern PNG_EXPORT(png_int_32, png_get_x_offset_microns) PNGARG((png_structp
2172
png_ptr, png_infop info_ptr));
2173
extern PNG_EXPORT(png_int_32, png_get_y_offset_microns) PNGARG((png_structp
2174 2175 2176 2177
png_ptr, png_infop info_ptr));

#endif /* PNG_EASY_ACCESS_SUPPORTED */

A
Andreas Dilger 已提交
2178 2179 2180 2181
/* Returns pointer to signature string read from PNG header */
extern PNG_EXPORT(png_bytep,png_get_signature) PNGARG((png_structp png_ptr,
png_infop info_ptr));

2182
#if defined(PNG_bKGD_SUPPORTED)
A
Andreas Dilger 已提交
2183 2184
extern PNG_EXPORT(png_uint_32,png_get_bKGD) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_color_16p *background));
2185
#endif
A
Andreas Dilger 已提交
2186

2187
#if defined(PNG_bKGD_SUPPORTED)
A
Andreas Dilger 已提交
2188 2189
extern PNG_EXPORT(void,png_set_bKGD) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_color_16p background));
2190
#endif
A
Andreas Dilger 已提交
2191

2192
#if defined(PNG_cHRM_SUPPORTED)
2193
#ifdef PNG_FLOATING_POINT_SUPPORTED
A
Andreas Dilger 已提交
2194 2195 2196 2197
extern PNG_EXPORT(png_uint_32,png_get_cHRM) PNGARG((png_structp png_ptr,
   png_infop info_ptr, double *white_x, double *white_y, double *red_x,
   double *red_y, double *green_x, double *green_y, double *blue_x,
   double *blue_y));
2198 2199 2200
#endif
#ifdef PNG_FIXED_POINT_SUPPORTED
extern PNG_EXPORT(png_uint_32,png_get_cHRM_fixed) PNGARG((png_structp png_ptr,
2201 2202 2203 2204
   png_infop info_ptr, png_fixed_point *int_white_x, png_fixed_point
   *int_white_y, png_fixed_point *int_red_x, png_fixed_point *int_red_y,
   png_fixed_point *int_green_x, png_fixed_point *int_green_y, png_fixed_point
   *int_blue_x, png_fixed_point *int_blue_y));
2205 2206
#endif
#endif
A
Andreas Dilger 已提交
2207

2208 2209
#if defined(PNG_cHRM_SUPPORTED)
#ifdef PNG_FLOATING_POINT_SUPPORTED
A
Andreas Dilger 已提交
2210 2211 2212
extern PNG_EXPORT(void,png_set_cHRM) PNGARG((png_structp png_ptr,
   png_infop info_ptr, double white_x, double white_y, double red_x,
   double red_y, double green_x, double green_y, double blue_x, double blue_y));
2213 2214 2215
#endif
#ifdef PNG_FIXED_POINT_SUPPORTED
extern PNG_EXPORT(void,png_set_cHRM_fixed) PNGARG((png_structp png_ptr,
2216 2217 2218 2219
   png_infop info_ptr, png_fixed_point int_white_x, png_fixed_point int_white_y,
   png_fixed_point int_red_x, png_fixed_point int_red_y, png_fixed_point
   int_green_x, png_fixed_point int_green_y, png_fixed_point int_blue_x,
   png_fixed_point int_blue_y));
2220 2221
#endif
#endif
A
Andreas Dilger 已提交
2222

2223
#if defined(PNG_gAMA_SUPPORTED)
2224
#ifdef PNG_FLOATING_POINT_SUPPORTED
A
Andreas Dilger 已提交
2225 2226
extern PNG_EXPORT(png_uint_32,png_get_gAMA) PNGARG((png_structp png_ptr,
   png_infop info_ptr, double *file_gamma));
2227 2228
#endif
extern PNG_EXPORT(png_uint_32,png_get_gAMA_fixed) PNGARG((png_structp png_ptr,
2229
   png_infop info_ptr, png_fixed_point *int_file_gamma));
2230
#endif
G
Guy Schalnat 已提交
2231

2232 2233
#if defined(PNG_gAMA_SUPPORTED)
#ifdef PNG_FLOATING_POINT_SUPPORTED
A
Andreas Dilger 已提交
2234 2235
extern PNG_EXPORT(void,png_set_gAMA) PNGARG((png_structp png_ptr,
   png_infop info_ptr, double file_gamma));
2236 2237
#endif
extern PNG_EXPORT(void,png_set_gAMA_fixed) PNGARG((png_structp png_ptr,
2238
   png_infop info_ptr, png_fixed_point int_file_gamma));
2239
#endif
A
Andreas Dilger 已提交
2240

2241
#if defined(PNG_hIST_SUPPORTED)
A
Andreas Dilger 已提交
2242 2243
extern PNG_EXPORT(png_uint_32,png_get_hIST) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_uint_16p *hist));
2244
#endif
A
Andreas Dilger 已提交
2245

2246
#if defined(PNG_hIST_SUPPORTED)
A
Andreas Dilger 已提交
2247 2248
extern PNG_EXPORT(void,png_set_hIST) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_uint_16p hist));
2249
#endif
A
Andreas Dilger 已提交
2250 2251 2252

extern PNG_EXPORT(png_uint_32,png_get_IHDR) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_uint_32 *width, png_uint_32 *height,
2253 2254
   int *bit_depth, int *color_type, int *interlace_method,
   int *compression_method, int *filter_method));
2255

A
Andreas Dilger 已提交
2256 2257
extern PNG_EXPORT(void,png_set_IHDR) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_uint_32 width, png_uint_32 height, int bit_depth,
2258 2259
   int color_type, int interlace_method, int compression_method,
   int filter_method));
A
Andreas Dilger 已提交
2260

2261
#if defined(PNG_oFFs_SUPPORTED)
A
Andreas Dilger 已提交
2262
extern PNG_EXPORT(png_uint_32,png_get_oFFs) PNGARG((png_structp png_ptr,
2263
   png_infop info_ptr, png_int_32 *offset_x, png_int_32 *offset_y,
A
Andreas Dilger 已提交
2264
   int *unit_type));
2265
#endif
A
Andreas Dilger 已提交
2266

2267
#if defined(PNG_oFFs_SUPPORTED)
A
Andreas Dilger 已提交
2268
extern PNG_EXPORT(void,png_set_oFFs) PNGARG((png_structp png_ptr,
2269
   png_infop info_ptr, png_int_32 offset_x, png_int_32 offset_y,
A
Andreas Dilger 已提交
2270
   int unit_type));
2271
#endif
A
Andreas Dilger 已提交
2272

2273
#if defined(PNG_pCAL_SUPPORTED)
A
Andreas Dilger 已提交
2274 2275 2276
extern PNG_EXPORT(png_uint_32,png_get_pCAL) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_charp *purpose, png_int_32 *X0, png_int_32 *X1,
   int *type, int *nparams, png_charp *units, png_charpp *params));
2277
#endif
A
Andreas Dilger 已提交
2278

2279
#if defined(PNG_pCAL_SUPPORTED)
A
Andreas Dilger 已提交
2280 2281 2282
extern PNG_EXPORT(void,png_set_pCAL) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_charp purpose, png_int_32 X0, png_int_32 X1,
   int type, int nparams, png_charp units, png_charpp params));
2283 2284
#endif

2285
#if defined(PNG_pHYs_SUPPORTED)
A
Andreas Dilger 已提交
2286 2287
extern PNG_EXPORT(png_uint_32,png_get_pHYs) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_uint_32 *res_x, png_uint_32 *res_y, int *unit_type));
2288
#endif
A
Andreas Dilger 已提交
2289

2290
#if defined(PNG_pHYs_SUPPORTED)
A
Andreas Dilger 已提交
2291 2292
extern PNG_EXPORT(void,png_set_pHYs) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_uint_32 res_x, png_uint_32 res_y, int unit_type));
2293
#endif
A
Andreas Dilger 已提交
2294 2295 2296 2297 2298 2299 2300

extern PNG_EXPORT(png_uint_32,png_get_PLTE) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_colorp *palette, int *num_palette));

extern PNG_EXPORT(void,png_set_PLTE) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_colorp palette, int num_palette));

2301
#if defined(PNG_sBIT_SUPPORTED)
A
Andreas Dilger 已提交
2302 2303
extern PNG_EXPORT(png_uint_32,png_get_sBIT) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_color_8p *sig_bit));
2304
#endif
A
Andreas Dilger 已提交
2305

2306
#if defined(PNG_sBIT_SUPPORTED)
A
Andreas Dilger 已提交
2307 2308
extern PNG_EXPORT(void,png_set_sBIT) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_color_8p sig_bit));
2309
#endif
A
Andreas Dilger 已提交
2310

2311
#if defined(PNG_sRGB_SUPPORTED)
2312
extern PNG_EXPORT(png_uint_32,png_get_sRGB) PNGARG((png_structp png_ptr,
2313
   png_infop info_ptr, int *intent));
2314
#endif
2315

2316
#if defined(PNG_sRGB_SUPPORTED)
2317
extern PNG_EXPORT(void,png_set_sRGB) PNGARG((png_structp png_ptr,
2318
   png_infop info_ptr, int intent));
2319
extern PNG_EXPORT(void,png_set_sRGB_gAMA_and_cHRM) PNGARG((png_structp png_ptr,
2320
   png_infop info_ptr, int intent));
2321 2322
#endif

2323
#if defined(PNG_iCCP_SUPPORTED)
2324 2325
extern PNG_EXPORT(png_uint_32,png_get_iCCP) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_charpp name, int *compression_type,
2326
   png_charpp profile, png_uint_32 *proflen));
2327
   /* Note to maintainer: profile should be png_bytepp */
2328 2329 2330 2331 2332
#endif

#if defined(PNG_iCCP_SUPPORTED)
extern PNG_EXPORT(void,png_set_iCCP) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_charp name, int compression_type,
2333
   png_charp profile, png_uint_32 proflen));
2334
   /* Note to maintainer: profile should be png_bytep */
2335 2336
#endif

2337
#if defined(PNG_sPLT_SUPPORTED)
2338
extern PNG_EXPORT(png_uint_32,png_get_sPLT) PNGARG((png_structp png_ptr,
2339
   png_infop info_ptr, png_sPLT_tpp entries));
2340 2341 2342
#endif

#if defined(PNG_sPLT_SUPPORTED)
2343
extern PNG_EXPORT(void,png_set_sPLT) PNGARG((png_structp png_ptr,
2344
   png_infop info_ptr, png_sPLT_tp entries, int nentries));
2345 2346
#endif

2347
#if defined(PNG_TEXT_SUPPORTED)
2348
/* png_get_text also returns the number of text chunks in *num_text */
A
Andreas Dilger 已提交
2349 2350
extern PNG_EXPORT(png_uint_32,png_get_text) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_textp *text_ptr, int *num_text));
2351
#endif
A
Andreas Dilger 已提交
2352

2353 2354 2355 2356 2357 2358 2359 2360
/*
 *  Note while png_set_text() will accept a structure whose text,
 *  language, and  translated keywords are NULL pointers, the structure
 *  returned by png_get_text will always contain regular
 *  zero-terminated C strings.  They might be empty strings but
 *  they will never be NULL pointers.
 */

2361
#if defined(PNG_TEXT_SUPPORTED)
A
Andreas Dilger 已提交
2362 2363
extern PNG_EXPORT(void,png_set_text) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_textp text_ptr, int num_text));
2364
#endif
A
Andreas Dilger 已提交
2365

2366
#if defined(PNG_tIME_SUPPORTED)
A
Andreas Dilger 已提交
2367 2368
extern PNG_EXPORT(png_uint_32,png_get_tIME) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_timep *mod_time));
2369
#endif
A
Andreas Dilger 已提交
2370

2371
#if defined(PNG_tIME_SUPPORTED)
A
Andreas Dilger 已提交
2372 2373
extern PNG_EXPORT(void,png_set_tIME) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_timep mod_time));
2374
#endif
A
Andreas Dilger 已提交
2375

2376
#if defined(PNG_tRNS_SUPPORTED)
A
Andreas Dilger 已提交
2377 2378 2379
extern PNG_EXPORT(png_uint_32,png_get_tRNS) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_bytep *trans, int *num_trans,
   png_color_16p *trans_values));
2380
#endif
A
Andreas Dilger 已提交
2381

2382
#if defined(PNG_tRNS_SUPPORTED)
A
Andreas Dilger 已提交
2383 2384 2385
extern PNG_EXPORT(void,png_set_tRNS) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_bytep trans, int num_trans,
   png_color_16p trans_values));
2386 2387
#endif

2388 2389 2390
#if defined(PNG_tRNS_SUPPORTED)
#endif

2391
#if defined(PNG_sCAL_SUPPORTED)
2392 2393
#ifdef PNG_FLOATING_POINT_SUPPORTED
extern PNG_EXPORT(png_uint_32,png_get_sCAL) PNGARG((png_structp png_ptr,
2394 2395 2396
   png_infop info_ptr, int *unit, double *width, double *height));
#else
#ifdef PNG_FIXED_POINT_SUPPORTED
2397
extern PNG_EXPORT(png_uint_32,png_get_sCAL_s) PNGARG((png_structp png_ptr,
2398 2399 2400
   png_infop info_ptr, int *unit, png_charpp swidth, png_charpp sheight));
#endif
#endif
2401
#endif /* PNG_sCAL_SUPPORTED */
2402

2403
#if defined(PNG_sCAL_SUPPORTED)
2404 2405
#ifdef PNG_FLOATING_POINT_SUPPORTED
extern PNG_EXPORT(void,png_set_sCAL) PNGARG((png_structp png_ptr,
2406
   png_infop info_ptr, int unit, double width, double height));
2407
#else
2408
#ifdef PNG_FIXED_POINT_SUPPORTED
2409
extern PNG_EXPORT(void,png_set_sCAL_s) PNGARG((png_structp png_ptr,
2410 2411
   png_infop info_ptr, int unit, png_charp swidth, png_charp sheight));
#endif
2412
#endif
2413
#endif /* PNG_sCAL_SUPPORTED || PNG_WRITE_sCAL_SUPPORTED */
2414 2415

#if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED)
2416 2417 2418 2419
/* provide a list of chunks and how they are to be handled, if the built-in
   handling or default unknown chunk handling is not desired.  Any chunks not
   listed will be handled in the default manner.  The IHDR and IEND chunks
   must not be listed.
2420
      keep = 0: follow default behaviour
2421 2422 2423 2424 2425 2426
           = 1: do not keep
           = 2: keep only if safe-to-copy
           = 3: keep even if unsafe-to-copy
*/
extern PNG_EXPORT(void, png_set_keep_unknown_chunks) PNGARG((png_structp
   png_ptr, int keep, png_bytep chunk_list, int num_chunks));
2427
extern PNG_EXPORT(void, png_set_unknown_chunks) PNGARG((png_structp png_ptr,
2428
   png_infop info_ptr, png_unknown_chunkp unknowns, int num_unknowns));
2429 2430
extern PNG_EXPORT(void, png_set_unknown_chunk_location)
   PNGARG((png_structp png_ptr, png_infop info_ptr, int chunk, int location));
2431 2432 2433
extern PNG_EXPORT(png_uint_32,png_get_unknown_chunks) PNGARG((png_structp
   png_ptr, png_infop info_ptr, png_unknown_chunkpp entries));
#endif
2434 2435 2436 2437
#ifdef PNG_HANDLE_AS_UNKNOWN_SUPPORTED
PNG_EXPORT(int,png_handle_as_unknown) PNGARG((png_structp png_ptr, png_bytep
   chunk_name));
#endif
2438

2439 2440 2441 2442 2443 2444
/* Png_free_data() will turn off the "valid" flag for anything it frees.
   If you need to turn it off for a chunk that your application has freed,
   you can use png_set_invalid(png_ptr, info_ptr, PNG_INFO_CHNK); */
extern PNG_EXPORT(void, png_set_invalid) PNGARG((png_structp png_ptr,
   png_infop info_ptr, int mask));

2445
#if defined(PNG_INFO_IMAGE_SUPPORTED)
2446
/* The "params" pointer is currently not used and is for future expansion. */
2447 2448 2449
extern PNG_EXPORT(void, png_read_png) PNGARG((png_structp png_ptr,
                        png_infop info_ptr,
                        int transforms,
2450
                        png_voidp params));
2451 2452 2453
extern PNG_EXPORT(void, png_write_png) PNGARG((png_structp png_ptr,
                        png_infop info_ptr,
                        int transforms,
2454
                        png_voidp params));
2455
#endif
A
Andreas Dilger 已提交
2456 2457 2458 2459 2460 2461

/* Define PNG_DEBUG at compile time for debugging information.  Higher
 * numbers for PNG_DEBUG mean more debugging information.  This has
 * only been added since version 0.95 so it is not implemented throughout
 * libpng yet, but more support will be added as needed.
 */
2462
#ifdef PNG_DEBUG
A
Andreas Dilger 已提交
2463
#if (PNG_DEBUG > 0)
2464 2465
#if !defined(PNG_DEBUG_FILE) && defined(_MSC_VER)
#include <crtdbg.h>
2466 2467 2468 2469 2470
#if (PNG_DEBUG > 1)
#define png_debug(l,m)  _RPT0(_CRT_WARN,m)
#define png_debug1(l,m,p1)  _RPT1(_CRT_WARN,m,p1)
#define png_debug2(l,m,p1,p2) _RPT2(_CRT_WARN,m,p1,p2)
#endif
2471
#else /* PNG_DEBUG_FILE || !_MSC_VER */
A
Andreas Dilger 已提交
2472 2473 2474
#ifndef PNG_DEBUG_FILE
#define PNG_DEBUG_FILE stderr
#endif /* PNG_DEBUG_FILE */
2475
#if (PNG_DEBUG > 1)
2476
#define png_debug(l,m) \
2477 2478 2479 2480 2481
{ \
     int num_tabs=l; \
     fprintf(PNG_DEBUG_FILE,"%s"m,(num_tabs==1 ? "\t" : \
       (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":"")))); \
}
2482
#define png_debug1(l,m,p1) \
2483 2484 2485 2486 2487
{ \
     int num_tabs=l; \
     fprintf(PNG_DEBUG_FILE,"%s"m,(num_tabs==1 ? "\t" : \
       (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":""))),p1); \
}
2488
#define png_debug2(l,m,p1,p2) \
2489 2490 2491 2492 2493 2494
{ \
     int num_tabs=l; \
     fprintf(PNG_DEBUG_FILE,"%s"m,(num_tabs==1 ? "\t" : \
       (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":""))),p1,p2); \
}
#endif /* (PNG_DEBUG > 1) */
2495
#endif /* _MSC_VER */
2496 2497 2498
#endif /* (PNG_DEBUG > 0) */
#endif /* PNG_DEBUG */
#ifndef png_debug
A
Andreas Dilger 已提交
2499
#define png_debug(l, m)
2500 2501
#endif
#ifndef png_debug1
A
Andreas Dilger 已提交
2502
#define png_debug1(l, m, p1)
2503 2504
#endif
#ifndef png_debug2
A
Andreas Dilger 已提交
2505
#define png_debug2(l, m, p1, p2)
2506 2507 2508
#endif

extern PNG_EXPORT(png_charp,png_get_copyright) PNGARG((png_structp png_ptr));
2509
extern PNG_EXPORT(png_charp,png_get_header_ver) PNGARG((png_structp png_ptr));
2510
extern PNG_EXPORT(png_charp,png_get_header_version) PNGARG((png_structp png_ptr));
2511
extern PNG_EXPORT(png_charp,png_get_libpng_ver) PNGARG((png_structp png_ptr));
2512

2513 2514 2515 2516 2517
#ifdef PNG_MNG_FEATURES_SUPPORTED
extern PNG_EXPORT(png_uint_32,png_permit_mng_features) PNGARG((png_structp
   png_ptr, png_uint_32 mng_features_permitted));
#endif

2518 2519 2520 2521 2522 2523
/* For use in png_set_keep_unknown, added to version 1.2.6 */
#define PNG_HANDLE_CHUNK_AS_DEFAULT   0
#define PNG_HANDLE_CHUNK_NEVER        1
#define PNG_HANDLE_CHUNK_IF_SAFE      2
#define PNG_HANDLE_CHUNK_ALWAYS       3

2524 2525
/* Added to version 1.2.0 */
#if defined(PNG_ASSEMBLER_CODE_SUPPORTED)
2526
#if defined(PNG_MMX_CODE_SUPPORTED)
2527 2528
#define PNG_ASM_FLAG_MMX_SUPPORT_COMPILED  0x01  /* not user-settable */
#define PNG_ASM_FLAG_MMX_SUPPORT_IN_CPU    0x02  /* not user-settable */
2529 2530 2531 2532 2533 2534
#define PNG_ASM_FLAG_MMX_READ_COMBINE_ROW  0x04
#define PNG_ASM_FLAG_MMX_READ_INTERLACE    0x08
#define PNG_ASM_FLAG_MMX_READ_FILTER_SUB   0x10
#define PNG_ASM_FLAG_MMX_READ_FILTER_UP    0x20
#define PNG_ASM_FLAG_MMX_READ_FILTER_AVG   0x40
#define PNG_ASM_FLAG_MMX_READ_FILTER_PAETH 0x80
2535
#define PNG_ASM_FLAGS_INITIALIZED          0x80000000  /* not user-settable */
2536 2537 2538 2539 2540 2541 2542 2543 2544 2545 2546 2547 2548 2549 2550 2551

#define PNG_MMX_READ_FLAGS ( PNG_ASM_FLAG_MMX_READ_COMBINE_ROW  \
                           | PNG_ASM_FLAG_MMX_READ_INTERLACE    \
                           | PNG_ASM_FLAG_MMX_READ_FILTER_SUB   \
                           | PNG_ASM_FLAG_MMX_READ_FILTER_UP    \
                           | PNG_ASM_FLAG_MMX_READ_FILTER_AVG   \
                           | PNG_ASM_FLAG_MMX_READ_FILTER_PAETH )
#define PNG_MMX_WRITE_FLAGS ( 0 )

#define PNG_MMX_FLAGS ( PNG_ASM_FLAG_MMX_SUPPORT_COMPILED \
                      | PNG_ASM_FLAG_MMX_SUPPORT_IN_CPU   \
                      | PNG_MMX_READ_FLAGS                \
                      | PNG_MMX_WRITE_FLAGS )

#define PNG_SELECT_READ   1
#define PNG_SELECT_WRITE  2
2552
#endif /* PNG_MMX_CODE_SUPPORTED */
2553

2554
#if !defined(PNG_1_0_X)
2555 2556 2557 2558 2559 2560 2561 2562 2563 2564 2565 2566 2567 2568 2569 2570 2571 2572 2573 2574 2575 2576 2577 2578 2579 2580 2581 2582 2583
/* pngget.c */
extern PNG_EXPORT(png_uint_32,png_get_mmx_flagmask)
   PNGARG((int flag_select, int *compilerID));

/* pngget.c */
extern PNG_EXPORT(png_uint_32,png_get_asm_flagmask)
   PNGARG((int flag_select));

/* pngget.c */
extern PNG_EXPORT(png_uint_32,png_get_asm_flags)
   PNGARG((png_structp png_ptr));

/* pngget.c */
extern PNG_EXPORT(png_byte,png_get_mmx_bitdepth_threshold)
   PNGARG((png_structp png_ptr));

/* pngget.c */
extern PNG_EXPORT(png_uint_32,png_get_mmx_rowbytes_threshold)
   PNGARG((png_structp png_ptr));

/* pngset.c */
extern PNG_EXPORT(void,png_set_asm_flags)
   PNGARG((png_structp png_ptr, png_uint_32 asm_flags));

/* pngset.c */
extern PNG_EXPORT(void,png_set_mmx_thresholds)
   PNGARG((png_structp png_ptr, png_byte mmx_bitdepth_threshold,
   png_uint_32 mmx_rowbytes_threshold));

2584
#endif /* PNG_1_0_X */
2585

2586
#if !defined(PNG_1_0_X)
2587 2588
/* png.c, pnggccrd.c, or pngvcrd.c */
extern PNG_EXPORT(int,png_mmx_support) PNGARG((void));
2589
#endif /* PNG_ASSEMBLER_CODE_SUPPORTED */
2590 2591 2592 2593 2594 2595

/* Strip the prepended error numbers ("#nnn ") from error and warning
 * messages before passing them to the error or warning handler. */
#ifdef PNG_ERROR_NUMBERS_SUPPORTED
extern PNG_EXPORT(void,png_set_strip_error_numbers) PNGARG((png_structp
   png_ptr, png_uint_32 strip_mode));
2596
#endif
2597

2598
#endif /* PNG_1_0_X */
2599

2600 2601 2602 2603 2604 2605 2606 2607 2608 2609
/* Added at libpng-1.2.6 */
#ifdef PNG_SET_USER_LIMITS_SUPPORTED
extern PNG_EXPORT(void,png_set_user_limits) PNGARG((png_structp
   png_ptr, png_uint_32 user_width_max, png_uint_32 user_height_max));
extern PNG_EXPORT(png_uint_32,png_get_user_width_max) PNGARG((png_structp
   png_ptr));
extern PNG_EXPORT(png_uint_32,png_get_user_height_max) PNGARG((png_structp
   png_ptr));
#endif

2610
/* Maintainer: Put new public prototypes here ^, in libpng.3, and project defs */
2611

2612
#ifdef PNG_READ_COMPOSITE_NODIV_SUPPORTED
2613 2614 2615
/* With these routines we avoid an integer divide, which will be slower on
 * most machines.  However, it does take more operations than the corresponding
 * divide method, so it may be slower on a few RISC systems.  There are two
2616 2617 2618 2619 2620 2621 2622 2623 2624
 * shifts (by 8 or 16 bits) and an addition, versus a single integer divide.
 *
 * Note that the rounding factors are NOT supposed to be the same!  128 and
 * 32768 are correct for the NODIV code; 127 and 32767 are correct for the
 * standard method.
 *
 * [Optimized code by Greg Roelofs and Mark Adler...blame us for bugs. :-) ]
 */

2625 2626 2627
 /* fg and bg should be in `gamma 1.0' space; alpha is the opacity          */

#  define png_composite(composite, fg, alpha, bg)                            \
2628 2629
     { png_uint_16 temp = (png_uint_16)((png_uint_16)(fg) * (png_uint_16)(alpha) \
                        +        (png_uint_16)(bg)*(png_uint_16)(255 -       \
2630
                        (png_uint_16)(alpha)) + (png_uint_16)128);           \
2631
       (composite) = (png_byte)((temp + (temp >> 8)) >> 8); }
2632 2633

#  define png_composite_16(composite, fg, alpha, bg)                         \
2634 2635
     { png_uint_32 temp = (png_uint_32)((png_uint_32)(fg) * (png_uint_32)(alpha) \
                        + (png_uint_32)(bg)*(png_uint_32)(65535L -           \
2636
                        (png_uint_32)(alpha)) + (png_uint_32)32768L);        \
2637 2638 2639 2640
       (composite) = (png_uint_16)((temp + (temp >> 16)) >> 16); }

#else  /* standard method using integer division */

2641 2642 2643
#  define png_composite(composite, fg, alpha, bg)                            \
     (composite) = (png_byte)(((png_uint_16)(fg) * (png_uint_16)(alpha) +    \
       (png_uint_16)(bg) * (png_uint_16)(255 - (png_uint_16)(alpha)) +       \
2644
       (png_uint_16)127) / 255)
2645 2646

#  define png_composite_16(composite, fg, alpha, bg)                         \
2647
     (composite) = (png_uint_16)(((png_uint_32)(fg) * (png_uint_32)(alpha) + \
2648
       (png_uint_32)(bg)*(png_uint_32)(65535L - (png_uint_32)(alpha)) +      \
2649 2650 2651 2652
       (png_uint_32)32767) / (png_uint_32)65535L)

#endif /* PNG_READ_COMPOSITE_NODIV_SUPPORTED */

2653 2654 2655 2656 2657 2658 2659 2660 2661 2662 2663 2664 2665 2666 2667 2668 2669 2670 2671 2672 2673 2674 2675 2676 2677 2678 2679 2680 2681 2682 2683 2684 2685 2686 2687 2688 2689 2690
/* Inline macros to do direct reads of bytes from the input buffer.  These
 * require that you are using an architecture that uses PNG byte ordering
 * (MSB first) and supports unaligned data storage.  I think that PowerPC
 * in big-endian mode and 680x0 are the only ones that will support this.
 * The x86 line of processors definitely do not.  The png_get_int_32()
 * routine also assumes we are using two's complement format for negative
 * values, which is almost certainly true.
 */
#if defined(PNG_READ_BIG_ENDIAN_SUPPORTED)
#  define png_get_uint_32(buf) ( *((png_uint_32p) (buf)))
#  define png_get_uint_16(buf) ( *((png_uint_16p) (buf)))
#  define png_get_int_32(buf)  ( *((png_int_32p)  (buf)))
#else
extern PNG_EXPORT(png_uint_32,png_get_uint_32) PNGARG((png_bytep buf));
extern PNG_EXPORT(png_uint_16,png_get_uint_16) PNGARG((png_bytep buf));
extern PNG_EXPORT(png_int_32,png_get_int_32) PNGARG((png_bytep buf));
#endif /* !PNG_READ_BIG_ENDIAN_SUPPORTED */
extern PNG_EXPORT(png_uint_32,png_get_uint_31)
  PNGARG((png_structp png_ptr, png_bytep buf));
/* No png_get_int_16 -- may be added if there's a real need for it. */

/* Place a 32-bit number into a buffer in PNG byte order (big-endian).
 */
extern PNG_EXPORT(void,png_save_uint_32)
   PNGARG((png_bytep buf, png_uint_32 i));
extern PNG_EXPORT(void,png_save_int_32)
   PNGARG((png_bytep buf, png_int_32 i));

/* Place a 16-bit number into a buffer in PNG byte order.
 * The parameter is declared unsigned int, not png_uint_16,
 * just to avoid potential problems on pre-ANSI C compilers.
 */
extern PNG_EXPORT(void,png_save_uint_16)
   PNGARG((png_bytep buf, unsigned int i));
/* No png_save_int_16 -- may be added if there's a real need for it. */

/* ************************************************************************* */

A
Andreas Dilger 已提交
2691 2692 2693 2694 2695
/* These next functions are used internally in the code.  They generally
 * shouldn't be used unless you are writing code to add or replace some
 * functionality in libpng.  More information about most functions can
 * be found in the files where the functions are located.
 */
G
Guy Schalnat 已提交
2696 2697


2698 2699
/* Various modes of operation, that are visible to applications because
 * they are used for unknown chunk location.
2700
 */
2701 2702 2703
#define PNG_HAVE_IHDR               0x01
#define PNG_HAVE_PLTE               0x02
#define PNG_HAVE_IDAT               0x04
2704
#define PNG_AFTER_IDAT              0x08 /* Have complete zlib datastream */
2705
#define PNG_HAVE_IEND               0x10
2706 2707 2708 2709 2710 2711

#if defined(PNG_INTERNAL)

/* More modes of operation.  Note that after an init, mode is set to
 * zero automatically when the structure is created.
 */
2712 2713 2714 2715 2716 2717 2718
#define PNG_HAVE_gAMA               0x20
#define PNG_HAVE_cHRM               0x40
#define PNG_HAVE_sRGB               0x80
#define PNG_HAVE_CHUNK_HEADER      0x100
#define PNG_WROTE_tIME             0x200
#define PNG_WROTE_INFO_BEFORE_PLTE 0x400
#define PNG_BACKGROUND_IS_GRAY     0x800
2719
#define PNG_HAVE_PNG_SIGNATURE    0x1000
2720
#define PNG_HAVE_CHUNK_AFTER_IDAT 0x2000 /* Have another chunk after IDAT */
G
Guy Schalnat 已提交
2721

A
Andreas Dilger 已提交
2722
/* flags for the transformations the PNG library does on the image data */
G
Guy Schalnat 已提交
2723 2724 2725 2726 2727 2728 2729 2730 2731
#define PNG_BGR                0x0001
#define PNG_INTERLACE          0x0002
#define PNG_PACK               0x0004
#define PNG_SHIFT              0x0008
#define PNG_SWAP_BYTES         0x0010
#define PNG_INVERT_MONO        0x0020
#define PNG_DITHER             0x0040
#define PNG_BACKGROUND         0x0080
#define PNG_BACKGROUND_EXPAND  0x0100
2732
                          /*   0x0200 unused */
G
Guy Schalnat 已提交
2733 2734 2735 2736 2737
#define PNG_16_TO_8            0x0400
#define PNG_RGBA               0x0800
#define PNG_EXPAND             0x1000
#define PNG_GAMMA              0x2000
#define PNG_GRAY_TO_RGB        0x4000
2738
#define PNG_FILLER             0x8000L
2739
#define PNG_PACKSWAP          0x10000L
2740 2741 2742
#define PNG_SWAP_ALPHA        0x20000L
#define PNG_STRIP_ALPHA       0x40000L
#define PNG_INVERT_ALPHA      0x80000L
2743
#define PNG_USER_TRANSFORM   0x100000L
2744 2745 2746
#define PNG_RGB_TO_GRAY_ERR  0x200000L
#define PNG_RGB_TO_GRAY_WARN 0x400000L
#define PNG_RGB_TO_GRAY      0x600000L  /* two bits, RGB_TO_GRAY_ERR|WARN */
2747
                       /*    0x800000L     Unused */
2748
#define PNG_ADD_ALPHA       0x1000000L  /* Added to libpng-1.2.7 */
2749
#define PNG_EXPAND_tRNS     0x2000000L  /* Added to libpng-1.2.9 */
2750 2751 2752 2753 2754
                       /*   0x4000000L  unused */
                       /*   0x8000000L  unused */
                       /*  0x10000000L  unused */
                       /*  0x20000000L  unused */
                       /*  0x40000000L  unused */
G
Guy Schalnat 已提交
2755 2756 2757 2758 2759

/* flags for png_create_struct */
#define PNG_STRUCT_PNG   0x0001
#define PNG_STRUCT_INFO  0x0002

A
Andreas Dilger 已提交
2760 2761 2762 2763 2764 2765 2766
/* Scaling factor for filter heuristic weighting calculations */
#define PNG_WEIGHT_SHIFT 8
#define PNG_WEIGHT_FACTOR (1<<(PNG_WEIGHT_SHIFT))
#define PNG_COST_SHIFT 3
#define PNG_COST_FACTOR (1<<(PNG_COST_SHIFT))

/* flags for the png_ptr->flags rather than declaring a byte for each one */
A
Andreas Dilger 已提交
2767 2768 2769 2770 2771 2772 2773 2774 2775 2776 2777 2778
#define PNG_FLAG_ZLIB_CUSTOM_STRATEGY     0x0001
#define PNG_FLAG_ZLIB_CUSTOM_LEVEL        0x0002
#define PNG_FLAG_ZLIB_CUSTOM_MEM_LEVEL    0x0004
#define PNG_FLAG_ZLIB_CUSTOM_WINDOW_BITS  0x0008
#define PNG_FLAG_ZLIB_CUSTOM_METHOD       0x0010
#define PNG_FLAG_ZLIB_FINISHED            0x0020
#define PNG_FLAG_ROW_INIT                 0x0040
#define PNG_FLAG_FILLER_AFTER             0x0080
#define PNG_FLAG_CRC_ANCILLARY_USE        0x0100
#define PNG_FLAG_CRC_ANCILLARY_NOWARN     0x0200
#define PNG_FLAG_CRC_CRITICAL_USE         0x0400
#define PNG_FLAG_CRC_CRITICAL_IGNORE      0x0800
2779 2780 2781 2782 2783
#define PNG_FLAG_FREE_PLTE                0x1000
#define PNG_FLAG_FREE_TRNS                0x2000
#define PNG_FLAG_FREE_HIST                0x4000
#define PNG_FLAG_KEEP_UNKNOWN_CHUNKS      0x8000L
#define PNG_FLAG_KEEP_UNSAFE_CHUNKS       0x10000L
2784
#define PNG_FLAG_LIBRARY_MISMATCH         0x20000L
2785 2786
#define PNG_FLAG_STRIP_ERROR_NUMBERS      0x40000L
#define PNG_FLAG_STRIP_ERROR_TEXT         0x80000L
2787
#define PNG_FLAG_MALLOC_NULL_MEM_OK       0x100000L
2788 2789 2790 2791 2792 2793 2794 2795 2796 2797
#define PNG_FLAG_ADD_ALPHA                0x200000L  /* Added to libpng-1.2.8 */
#define PNG_FLAG_STRIP_ALPHA              0x400000L  /* Added to libpng-1.2.8 */
                                  /*      0x800000L  unused */
                                  /*     0x1000000L  unused */
                                  /*     0x2000000L  unused */
                                  /*     0x4000000L  unused */
                                  /*     0x8000000L  unused */
                                  /*    0x10000000L  unused */
                                  /*    0x20000000L  unused */
                                  /*    0x40000000L  unused */
2798

A
Andreas Dilger 已提交
2799 2800 2801 2802 2803 2804 2805 2806
#define PNG_FLAG_CRC_ANCILLARY_MASK (PNG_FLAG_CRC_ANCILLARY_USE | \
                                     PNG_FLAG_CRC_ANCILLARY_NOWARN)

#define PNG_FLAG_CRC_CRITICAL_MASK  (PNG_FLAG_CRC_CRITICAL_USE | \
                                     PNG_FLAG_CRC_CRITICAL_IGNORE)

#define PNG_FLAG_CRC_MASK           (PNG_FLAG_CRC_ANCILLARY_MASK | \
                                     PNG_FLAG_CRC_CRITICAL_MASK)
G
Guy Schalnat 已提交
2807 2808

/* save typing and make code easier to understand */
2809

2810 2811 2812 2813 2814
#define PNG_COLOR_DIST(c1, c2) (abs((int)((c1).red) - (int)((c2).red)) + \
   abs((int)((c1).green) - (int)((c2).green)) + \
   abs((int)((c1).blue) - (int)((c2).blue)))

/* Added to libpng-1.2.6 JB */
2815 2816 2817 2818 2819
#define PNG_ROWBYTES(pixel_bits, width) \
    ((pixel_bits) >= 8 ? \
    ((width) * (((png_uint_32)(pixel_bits)) >> 3)) : \
    (( ((width) * ((png_uint_32)(pixel_bits))) + 7) >> 3) )

2820 2821 2822 2823 2824 2825
/* PNG_OUT_OF_RANGE returns true if value is outside the range
   ideal-delta..ideal+delta.  Each argument is evaluated twice.
   "ideal" and "delta" should be constants, normally simple
   integers, "value" a variable. Added to libpng-1.2.6 JB */
#define PNG_OUT_OF_RANGE(value, ideal, delta) \
        ( (value) < (ideal)-(delta) || (value) > (ideal)+(delta) )
G
Guy Schalnat 已提交
2826

A
Andreas Dilger 已提交
2827
/* variables declared in png.c - only it needs to define PNG_NO_EXTERN */
2828
#if !defined(PNG_NO_EXTERN) || defined(PNG_ALWAYS_EXTERN)
2829
/* place to hold the signature string for a PNG file. */
2830
#ifdef PNG_USE_GLOBAL_ARRAYS
2831
   PNG_EXPORT_VAR (PNG_CONST png_byte FARDATA) png_sig[8];
2832
#else
2833
#endif
2834
#endif /* PNG_NO_EXTERN */
G
Guy Schalnat 已提交
2835

2836
/* Constant strings for known chunk types.  If you need to add a chunk,
2837 2838
 * define the name here, and add an invocation of the macro in png.c and
 * wherever it's needed.
2839
 */
2840 2841 2842 2843 2844 2845 2846 2847 2848 2849 2850 2851 2852 2853 2854 2855 2856 2857 2858 2859 2860
#define PNG_IHDR png_byte png_IHDR[5] = { 73,  72,  68,  82, '\0'}
#define PNG_IDAT png_byte png_IDAT[5] = { 73,  68,  65,  84, '\0'}
#define PNG_IEND png_byte png_IEND[5] = { 73,  69,  78,  68, '\0'}
#define PNG_PLTE png_byte png_PLTE[5] = { 80,  76,  84,  69, '\0'}
#define PNG_bKGD png_byte png_bKGD[5] = { 98,  75,  71,  68, '\0'}
#define PNG_cHRM png_byte png_cHRM[5] = { 99,  72,  82,  77, '\0'}
#define PNG_gAMA png_byte png_gAMA[5] = {103,  65,  77,  65, '\0'}
#define PNG_hIST png_byte png_hIST[5] = {104,  73,  83,  84, '\0'}
#define PNG_iCCP png_byte png_iCCP[5] = {105,  67,  67,  80, '\0'}
#define PNG_iTXt png_byte png_iTXt[5] = {105,  84,  88, 116, '\0'}
#define PNG_oFFs png_byte png_oFFs[5] = {111,  70,  70, 115, '\0'}
#define PNG_pCAL png_byte png_pCAL[5] = {112,  67,  65,  76, '\0'}
#define PNG_sCAL png_byte png_sCAL[5] = {115,  67,  65,  76, '\0'}
#define PNG_pHYs png_byte png_pHYs[5] = {112,  72,  89, 115, '\0'}
#define PNG_sBIT png_byte png_sBIT[5] = {115,  66,  73,  84, '\0'}
#define PNG_sPLT png_byte png_sPLT[5] = {115,  80,  76,  84, '\0'}
#define PNG_sRGB png_byte png_sRGB[5] = {115,  82,  71,  66, '\0'}
#define PNG_tEXt png_byte png_tEXt[5] = {116,  69,  88, 116, '\0'}
#define PNG_tIME png_byte png_tIME[5] = {116,  73,  77,  69, '\0'}
#define PNG_tRNS png_byte png_tRNS[5] = {116,  82,  78,  83, '\0'}
#define PNG_zTXt png_byte png_zTXt[5] = {122,  84,  88, 116, '\0'}
2861 2862

#ifdef PNG_USE_GLOBAL_ARRAYS
2863 2864 2865 2866 2867 2868 2869 2870 2871 2872 2873 2874 2875 2876 2877 2878 2879 2880 2881 2882 2883
PNG_EXPORT_VAR (png_byte FARDATA) png_IHDR[5];
PNG_EXPORT_VAR (png_byte FARDATA) png_IDAT[5];
PNG_EXPORT_VAR (png_byte FARDATA) png_IEND[5];
PNG_EXPORT_VAR (png_byte FARDATA) png_PLTE[5];
PNG_EXPORT_VAR (png_byte FARDATA) png_bKGD[5];
PNG_EXPORT_VAR (png_byte FARDATA) png_cHRM[5];
PNG_EXPORT_VAR (png_byte FARDATA) png_gAMA[5];
PNG_EXPORT_VAR (png_byte FARDATA) png_hIST[5];
PNG_EXPORT_VAR (png_byte FARDATA) png_iCCP[5];
PNG_EXPORT_VAR (png_byte FARDATA) png_iTXt[5];
PNG_EXPORT_VAR (png_byte FARDATA) png_oFFs[5];
PNG_EXPORT_VAR (png_byte FARDATA) png_pCAL[5];
PNG_EXPORT_VAR (png_byte FARDATA) png_sCAL[5];
PNG_EXPORT_VAR (png_byte FARDATA) png_pHYs[5];
PNG_EXPORT_VAR (png_byte FARDATA) png_sBIT[5];
PNG_EXPORT_VAR (png_byte FARDATA) png_sPLT[5];
PNG_EXPORT_VAR (png_byte FARDATA) png_sRGB[5];
PNG_EXPORT_VAR (png_byte FARDATA) png_tEXt[5];
PNG_EXPORT_VAR (png_byte FARDATA) png_tIME[5];
PNG_EXPORT_VAR (png_byte FARDATA) png_tRNS[5];
PNG_EXPORT_VAR (png_byte FARDATA) png_zTXt[5];
2884
#endif /* PNG_USE_GLOBAL_ARRAYS */
G
Guy Schalnat 已提交
2885

2886
#if defined(PNG_1_0_X) || defined (PNG_1_2_X)
2887
/* Initialize png_ptr struct for reading, and allocate any other memory.
2888
 * (old interface - DEPRECATED - use png_create_read_struct instead).
2889
 */
2890
extern PNG_EXPORT(void,png_read_init) PNGARG((png_structp png_ptr));
2891
#undef png_read_init
2892
#define png_read_init(png_ptr) png_read_init_3(&png_ptr, \
2893
    PNG_LIBPNG_VER_STRING,  png_sizeof(png_struct));
2894
#endif
2895

2896 2897
extern PNG_EXPORT(void,png_read_init_3) PNGARG((png_structpp ptr_ptr,
    png_const_charp user_png_ver, png_size_t png_struct_size));
2898
#if defined(PNG_1_0_X) || defined (PNG_1_2_X)
2899
extern PNG_EXPORT(void,png_read_init_2) PNGARG((png_structp png_ptr,
2900 2901
    png_const_charp user_png_ver, png_size_t png_struct_size, png_size_t
    png_info_size));
2902
#endif
A
Andreas Dilger 已提交
2903

2904
#if defined(PNG_1_0_X) || defined (PNG_1_2_X)
2905
/* Initialize png_ptr struct for writing, and allocate any other memory.
2906
 * (old interface - DEPRECATED - use png_create_write_struct instead).
2907
 */
2908
extern PNG_EXPORT(void,png_write_init) PNGARG((png_structp png_ptr));
2909
#undef png_write_init
2910
#define png_write_init(png_ptr) png_write_init_3(&png_ptr, \
2911
    PNG_LIBPNG_VER_STRING, png_sizeof(png_struct));
2912 2913
#endif

2914 2915
extern PNG_EXPORT(void,png_write_init_3) PNGARG((png_structpp ptr_ptr,
    png_const_charp user_png_ver, png_size_t png_struct_size));
2916
extern PNG_EXPORT(void,png_write_init_2) PNGARG((png_structp png_ptr,
2917 2918
    png_const_charp user_png_ver, png_size_t png_struct_size, png_size_t
    png_info_size));
A
Andreas Dilger 已提交
2919

2920
/* Allocate memory for an internal libpng struct */
A
Andreas Dilger 已提交
2921
PNG_EXTERN png_voidp png_create_struct PNGARG((int type));
A
Andreas Dilger 已提交
2922

2923
/* Free memory from internal libpng struct */
A
Andreas Dilger 已提交
2924
PNG_EXTERN void png_destroy_struct PNGARG((png_voidp struct_ptr));
A
Andreas Dilger 已提交
2925

2926
PNG_EXTERN png_voidp png_create_struct_2 PNGARG((int type, png_malloc_ptr
2927
  malloc_fn, png_voidp mem_ptr));
2928
PNG_EXTERN void png_destroy_struct_2 PNGARG((png_voidp struct_ptr,
2929
   png_free_ptr free_fn, png_voidp mem_ptr));
2930

2931
/* Free any memory that info_ptr points to and reset struct. */
A
Andreas Dilger 已提交
2932
PNG_EXTERN void png_info_destroy PNGARG((png_structp png_ptr,
A
Andreas Dilger 已提交
2933 2934
   png_infop info_ptr));

2935
#ifndef PNG_1_0_X
2936 2937 2938 2939 2940 2941
/* Function to allocate memory for zlib. */
PNG_EXTERN voidpf png_zalloc PNGARG((voidpf png_ptr, uInt items, uInt size));

/* Function to free memory for zlib */
PNG_EXTERN void png_zfree PNGARG((voidpf png_ptr, voidpf ptr));

2942 2943 2944 2945 2946
#ifdef PNG_SIZE_T
/* Function to convert a sizeof an item to png_sizeof item */
   PNG_EXTERN png_size_t PNGAPI png_convert_size PNGARG((size_t size));
#endif

2947 2948 2949 2950 2951 2952 2953 2954 2955 2956 2957 2958 2959 2960 2961 2962 2963 2964 2965
/* Next four functions are used internally as callbacks.  PNGAPI is required
 * but not PNG_EXPORT.  PNGAPI added at libpng version 1.2.3. */

PNG_EXTERN void PNGAPI png_default_read_data PNGARG((png_structp png_ptr,
   png_bytep data, png_size_t length));

#ifdef PNG_PROGRESSIVE_READ_SUPPORTED
PNG_EXTERN void PNGAPI png_push_fill_buffer PNGARG((png_structp png_ptr,
   png_bytep buffer, png_size_t length));
#endif

PNG_EXTERN void PNGAPI png_default_write_data PNGARG((png_structp png_ptr,
   png_bytep data, png_size_t length));

#if defined(PNG_WRITE_FLUSH_SUPPORTED)
#if !defined(PNG_NO_STDIO)
PNG_EXTERN void PNGAPI png_default_flush PNGARG((png_structp png_ptr));
#endif
#endif
2966 2967 2968 2969 2970 2971
#else /* PNG_1_0_X */
#ifdef PNG_PROGRESSIVE_READ_SUPPORTED
PNG_EXTERN void png_push_fill_buffer PNGARG((png_structp png_ptr,
   png_bytep buffer, png_size_t length));
#endif
#endif /* PNG_1_0_X */
2972

2973
/* Reset the CRC variable */
A
Andreas Dilger 已提交
2974 2975 2976 2977 2978 2979 2980 2981 2982
PNG_EXTERN void png_reset_crc PNGARG((png_structp png_ptr));

/* Write the "data" buffer to whatever output you are using. */
PNG_EXTERN void png_write_data PNGARG((png_structp png_ptr, png_bytep data,
   png_size_t length));

/* Read data from whatever input you are using into the "data" buffer */
PNG_EXTERN void png_read_data PNGARG((png_structp png_ptr, png_bytep data,
   png_size_t length));
G
Guy Schalnat 已提交
2983

2984
/* Read bytes into buf, and update png_ptr->crc */
A
Andreas Dilger 已提交
2985 2986
PNG_EXTERN void png_crc_read PNGARG((png_structp png_ptr, png_bytep buf,
   png_size_t length));
A
Andreas Dilger 已提交
2987

2988
/* Decompress data in a chunk that uses compression */
2989 2990
#if defined(PNG_zTXt_SUPPORTED) || defined(PNG_iTXt_SUPPORTED) || \
    defined(PNG_iCCP_SUPPORTED) || defined(PNG_sPLT_SUPPORTED)
2991 2992
PNG_EXTERN png_charp png_decompress_chunk PNGARG((png_structp png_ptr,
   int comp_type, png_charp chunkdata, png_size_t chunklength,
2993
   png_size_t prefix_length, png_size_t *data_length));
2994 2995 2996
#endif

/* Read "skip" bytes, read the file crc, and (optionally) verify png_ptr->crc */
A
Andreas Dilger 已提交
2997
PNG_EXTERN int png_crc_finish PNGARG((png_structp png_ptr, png_uint_32 skip));
A
Andreas Dilger 已提交
2998

2999
/* Read the CRC from the file and compare it to the libpng calculated CRC */
A
Andreas Dilger 已提交
3000
PNG_EXTERN int png_crc_error PNGARG((png_structp png_ptr));
A
Andreas Dilger 已提交
3001

A
Andreas Dilger 已提交
3002 3003 3004 3005 3006 3007
/* Calculate the CRC over a section of data.  Note that we are only
 * passing a maximum of 64K on systems that have this as a memory limit,
 * since this is the maximum buffer size we can specify.
 */
PNG_EXTERN void png_calculate_crc PNGARG((png_structp png_ptr, png_bytep ptr,
   png_size_t length));
G
Guy Schalnat 已提交
3008 3009

#if defined(PNG_WRITE_FLUSH_SUPPORTED)
A
Andreas Dilger 已提交
3010
PNG_EXTERN void png_flush PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
3011
#endif
G
Guy Schalnat 已提交
3012

3013 3014 3015
/* simple function to write the signature */
PNG_EXTERN void png_write_sig PNGARG((png_structp png_ptr));

G
Guy Schalnat 已提交
3016 3017 3018
/* write various chunks */

/* Write the IHDR chunk, and update the png_struct with the necessary
3019 3020
 * information.
 */
A
Andreas Dilger 已提交
3021
PNG_EXTERN void png_write_IHDR PNGARG((png_structp png_ptr, png_uint_32 width,
G
Guy Schalnat 已提交
3022
   png_uint_32 height,
3023 3024
   int bit_depth, int color_type, int compression_method, int filter_method,
   int interlace_method));
G
Guy Schalnat 已提交
3025

A
Andreas Dilger 已提交
3026 3027
PNG_EXTERN void png_write_PLTE PNGARG((png_structp png_ptr, png_colorp palette,
   png_uint_32 num_pal));
G
Guy Schalnat 已提交
3028

A
Andreas Dilger 已提交
3029 3030
PNG_EXTERN void png_write_IDAT PNGARG((png_structp png_ptr, png_bytep data,
   png_size_t length));
G
Guy Schalnat 已提交
3031

A
Andreas Dilger 已提交
3032
PNG_EXTERN void png_write_IEND PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
3033

G
Guy Schalnat 已提交
3034
#if defined(PNG_WRITE_gAMA_SUPPORTED)
3035
#ifdef PNG_FLOATING_POINT_SUPPORTED
A
Andreas Dilger 已提交
3036
PNG_EXTERN void png_write_gAMA PNGARG((png_structp png_ptr, double file_gamma));
G
Guy Schalnat 已提交
3037
#endif
3038
#ifdef PNG_FIXED_POINT_SUPPORTED
3039
PNG_EXTERN void png_write_gAMA_fixed PNGARG((png_structp png_ptr, png_fixed_point
3040 3041 3042
    file_gamma));
#endif
#endif
G
Guy Schalnat 已提交
3043

G
Guy Schalnat 已提交
3044
#if defined(PNG_WRITE_sBIT_SUPPORTED)
A
Andreas Dilger 已提交
3045
PNG_EXTERN void png_write_sBIT PNGARG((png_structp png_ptr, png_color_8p sbit,
G
Guy Schalnat 已提交
3046
   int color_type));
G
Guy Schalnat 已提交
3047
#endif
G
Guy Schalnat 已提交
3048

G
Guy Schalnat 已提交
3049
#if defined(PNG_WRITE_cHRM_SUPPORTED)
3050
#ifdef PNG_FLOATING_POINT_SUPPORTED
A
Andreas Dilger 已提交
3051
PNG_EXTERN void png_write_cHRM PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
3052 3053 3054
   double white_x, double white_y,
   double red_x, double red_y, double green_x, double green_y,
   double blue_x, double blue_y));
G
Guy Schalnat 已提交
3055
#endif
3056 3057
#ifdef PNG_FIXED_POINT_SUPPORTED
PNG_EXTERN void png_write_cHRM_fixed PNGARG((png_structp png_ptr,
3058 3059 3060 3061
   png_fixed_point int_white_x, png_fixed_point int_white_y,
   png_fixed_point int_red_x, png_fixed_point int_red_y, png_fixed_point
   int_green_x, png_fixed_point int_green_y, png_fixed_point int_blue_x,
   png_fixed_point int_blue_y));
3062 3063
#endif
#endif
G
Guy Schalnat 已提交
3064

3065 3066
#if defined(PNG_WRITE_sRGB_SUPPORTED)
PNG_EXTERN void png_write_sRGB PNGARG((png_structp png_ptr,
3067
   int intent));
3068 3069
#endif

3070 3071 3072 3073
#if defined(PNG_WRITE_iCCP_SUPPORTED)
PNG_EXTERN void png_write_iCCP PNGARG((png_structp png_ptr,
   png_charp name, int compression_type,
   png_charp profile, int proflen));
3074
   /* Note to maintainer: profile should be png_bytep */
3075 3076 3077 3078
#endif

#if defined(PNG_WRITE_sPLT_SUPPORTED)
PNG_EXTERN void png_write_sPLT PNGARG((png_structp png_ptr,
3079
   png_sPLT_tp palette));
3080 3081
#endif

G
Guy Schalnat 已提交
3082
#if defined(PNG_WRITE_tRNS_SUPPORTED)
A
Andreas Dilger 已提交
3083
PNG_EXTERN void png_write_tRNS PNGARG((png_structp png_ptr, png_bytep trans,
G
Guy Schalnat 已提交
3084
   png_color_16p values, int number, int color_type));
G
Guy Schalnat 已提交
3085
#endif
G
Guy Schalnat 已提交
3086

G
Guy Schalnat 已提交
3087
#if defined(PNG_WRITE_bKGD_SUPPORTED)
A
Andreas Dilger 已提交
3088 3089
PNG_EXTERN void png_write_bKGD PNGARG((png_structp png_ptr,
   png_color_16p values, int color_type));
G
Guy Schalnat 已提交
3090
#endif
G
Guy Schalnat 已提交
3091

G
Guy Schalnat 已提交
3092
#if defined(PNG_WRITE_hIST_SUPPORTED)
A
Andreas Dilger 已提交
3093
PNG_EXTERN void png_write_hIST PNGARG((png_structp png_ptr, png_uint_16p hist,
3094
   int num_hist));
G
Guy Schalnat 已提交
3095
#endif
G
Guy Schalnat 已提交
3096

3097 3098
#if defined(PNG_WRITE_TEXT_SUPPORTED) || defined(PNG_WRITE_pCAL_SUPPORTED) || \
    defined(PNG_WRITE_iCCP_SUPPORTED) || defined(PNG_WRITE_sPLT_SUPPORTED)
A
Andreas Dilger 已提交
3099
PNG_EXTERN png_size_t png_check_keyword PNGARG((png_structp png_ptr,
3100
   png_charp key, png_charpp new_key));
A
Andreas Dilger 已提交
3101 3102
#endif

G
Guy Schalnat 已提交
3103
#if defined(PNG_WRITE_tEXt_SUPPORTED)
A
Andreas Dilger 已提交
3104 3105
PNG_EXTERN void png_write_tEXt PNGARG((png_structp png_ptr, png_charp key,
   png_charp text, png_size_t text_len));
G
Guy Schalnat 已提交
3106
#endif
G
Guy Schalnat 已提交
3107

G
Guy Schalnat 已提交
3108
#if defined(PNG_WRITE_zTXt_SUPPORTED)
A
Andreas Dilger 已提交
3109 3110
PNG_EXTERN void png_write_zTXt PNGARG((png_structp png_ptr, png_charp key,
   png_charp text, png_size_t text_len, int compression));
G
Guy Schalnat 已提交
3111
#endif
G
Guy Schalnat 已提交
3112

3113 3114
#if defined(PNG_WRITE_iTXt_SUPPORTED)
PNG_EXTERN void png_write_iTXt PNGARG((png_structp png_ptr,
3115
   int compression, png_charp key, png_charp lang, png_charp lang_key,
3116 3117 3118
   png_charp text));
#endif

3119
#if defined(PNG_TEXT_SUPPORTED)  /* Added at version 1.0.14 and 1.2.4 */
3120 3121 3122 3123
PNG_EXTERN int png_set_text_2 PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_textp text_ptr, int num_text));
#endif

G
Guy Schalnat 已提交
3124
#if defined(PNG_WRITE_oFFs_SUPPORTED)
A
Andreas Dilger 已提交
3125
PNG_EXTERN void png_write_oFFs PNGARG((png_structp png_ptr,
3126
   png_int_32 x_offset, png_int_32 y_offset, int unit_type));
G
Guy Schalnat 已提交
3127
#endif
G
Guy Schalnat 已提交
3128

A
Andreas Dilger 已提交
3129 3130 3131 3132
#if defined(PNG_WRITE_pCAL_SUPPORTED)
PNG_EXTERN void png_write_pCAL PNGARG((png_structp png_ptr, png_charp purpose,
   png_int_32 X0, png_int_32 X1, int type, int nparams,
   png_charp units, png_charpp params));
G
Guy Schalnat 已提交
3133
#endif
G
Guy Schalnat 已提交
3134

A
Andreas Dilger 已提交
3135 3136 3137 3138
#if defined(PNG_WRITE_pHYs_SUPPORTED)
PNG_EXTERN void png_write_pHYs PNGARG((png_structp png_ptr,
   png_uint_32 x_pixels_per_unit, png_uint_32 y_pixels_per_unit,
   int unit_type));
G
Guy Schalnat 已提交
3139 3140
#endif

A
Andreas Dilger 已提交
3141 3142
#if defined(PNG_WRITE_tIME_SUPPORTED)
PNG_EXTERN void png_write_tIME PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
3143
   png_timep mod_time));
G
Guy Schalnat 已提交
3144 3145
#endif

3146
#if defined(PNG_WRITE_sCAL_SUPPORTED)
3147
#if defined(PNG_FLOATING_POINT_SUPPORTED) && !defined(PNG_NO_STDIO)
3148
PNG_EXTERN void png_write_sCAL PNGARG((png_structp png_ptr,
3149 3150 3151
   int unit, double width, double height));
#else
#ifdef PNG_FIXED_POINT_SUPPORTED
3152
PNG_EXTERN void png_write_sCAL_s PNGARG((png_structp png_ptr,
3153 3154 3155
   int unit, png_charp width, png_charp height));
#endif
#endif
3156 3157
#endif

A
Andreas Dilger 已提交
3158 3159
/* Called when finished processing a row of data */
PNG_EXTERN void png_write_finish_row PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
3160

A
Andreas Dilger 已提交
3161 3162
/* Internal use only.   Called before first row of data */
PNG_EXTERN void png_write_start_row PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
3163

G
Guy Schalnat 已提交
3164
#if defined(PNG_READ_GAMMA_SUPPORTED)
A
Andreas Dilger 已提交
3165
PNG_EXTERN void png_build_gamma_table PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
3166
#endif
G
Guy Schalnat 已提交
3167 3168

/* combine a row of data, dealing with alpha, etc. if requested */
A
Andreas Dilger 已提交
3169
PNG_EXTERN void png_combine_row PNGARG((png_structp png_ptr, png_bytep row,
G
Guy Schalnat 已提交
3170
   int mask));
G
Guy Schalnat 已提交
3171 3172

#if defined(PNG_READ_INTERLACING_SUPPORTED)
G
Guy Schalnat 已提交
3173
/* expand an interlaced row */
3174
/* OLD pre-1.0.9 interface:
A
Andreas Dilger 已提交
3175 3176
PNG_EXTERN void png_do_read_interlace PNGARG((png_row_infop row_info,
   png_bytep row, int pass, png_uint_32 transformations));
3177 3178
 */
PNG_EXTERN void png_do_read_interlace PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
3179 3180
#endif

3181 3182
/* GRR TO DO (2.0 or whenever):  simplify other internal calling interfaces */

G
Guy Schalnat 已提交
3183
#if defined(PNG_WRITE_INTERLACING_SUPPORTED)
G
Guy Schalnat 已提交
3184
/* grab pixels out of a row for an interlaced pass */
A
Andreas Dilger 已提交
3185
PNG_EXTERN void png_do_write_interlace PNGARG((png_row_infop row_info,
G
Guy Schalnat 已提交
3186
   png_bytep row, int pass));
G
Guy Schalnat 已提交
3187
#endif
G
Guy Schalnat 已提交
3188 3189

/* unfilter a row */
A
Andreas Dilger 已提交
3190
PNG_EXTERN void png_read_filter_row PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
3191
   png_row_infop row_info, png_bytep row, png_bytep prev_row, int filter));
A
Andreas Dilger 已提交
3192 3193 3194

/* Choose the best filter to use and filter the row data */
PNG_EXTERN void png_write_find_filter PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
3195
   png_row_infop row_info));
A
Andreas Dilger 已提交
3196 3197 3198

/* Write out the filtered row. */
PNG_EXTERN void png_write_filtered_row PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
3199
   png_bytep filtered_row));
G
Guy Schalnat 已提交
3200
/* finish a row while reading, dealing with interlacing passes, etc. */
A
Andreas Dilger 已提交
3201 3202
PNG_EXTERN void png_read_finish_row PNGARG((png_structp png_ptr));

G
Guy Schalnat 已提交
3203
/* initialize the row buffers, etc. */
A
Andreas Dilger 已提交
3204
PNG_EXTERN void png_read_start_row PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
3205
/* optional call to update the users info structure */
A
Andreas Dilger 已提交
3206
PNG_EXTERN void png_read_transform_info PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
3207
   png_infop info_ptr));
G
Guy Schalnat 已提交
3208 3209

/* these are the functions that do the transformations */
G
Guy Schalnat 已提交
3210
#if defined(PNG_READ_FILLER_SUPPORTED)
A
Andreas Dilger 已提交
3211 3212 3213 3214 3215 3216 3217 3218 3219 3220 3221 3222
PNG_EXTERN void png_do_read_filler PNGARG((png_row_infop row_info,
   png_bytep row, png_uint_32 filler, png_uint_32 flags));
#endif

#if defined(PNG_READ_SWAP_ALPHA_SUPPORTED)
PNG_EXTERN void png_do_read_swap_alpha PNGARG((png_row_infop row_info,
   png_bytep row));
#endif

#if defined(PNG_WRITE_SWAP_ALPHA_SUPPORTED)
PNG_EXTERN void png_do_write_swap_alpha PNGARG((png_row_infop row_info,
   png_bytep row));
G
Guy Schalnat 已提交
3223 3224
#endif

3225 3226 3227 3228 3229 3230 3231 3232 3233 3234
#if defined(PNG_READ_INVERT_ALPHA_SUPPORTED)
PNG_EXTERN void png_do_read_invert_alpha PNGARG((png_row_infop row_info,
   png_bytep row));
#endif

#if defined(PNG_WRITE_INVERT_ALPHA_SUPPORTED)
PNG_EXTERN void png_do_write_invert_alpha PNGARG((png_row_infop row_info,
   png_bytep row));
#endif

A
Andreas Dilger 已提交
3235 3236 3237
#if defined(PNG_WRITE_FILLER_SUPPORTED) || \
    defined(PNG_READ_STRIP_ALPHA_SUPPORTED)
PNG_EXTERN void png_do_strip_filler PNGARG((png_row_infop row_info,
3238
   png_bytep row, png_uint_32 flags));
G
Guy Schalnat 已提交
3239 3240 3241
#endif

#if defined(PNG_READ_SWAP_SUPPORTED) || defined(PNG_WRITE_SWAP_SUPPORTED)
A
Andreas Dilger 已提交
3242 3243 3244
PNG_EXTERN void png_do_swap PNGARG((png_row_infop row_info, png_bytep row));
#endif

3245
#if defined(PNG_READ_PACKSWAP_SUPPORTED) || defined(PNG_WRITE_PACKSWAP_SUPPORTED)
A
Andreas Dilger 已提交
3246
PNG_EXTERN void png_do_packswap PNGARG((png_row_infop row_info, png_bytep row));
G
Guy Schalnat 已提交
3247 3248
#endif

A
Andreas Dilger 已提交
3249
#if defined(PNG_READ_RGB_TO_GRAY_SUPPORTED)
3250 3251
PNG_EXTERN int png_do_rgb_to_gray PNGARG((png_structp png_ptr, png_row_infop
   row_info, png_bytep row));
A
Andreas Dilger 已提交
3252 3253 3254
#endif

#if defined(PNG_READ_GRAY_TO_RGB_SUPPORTED)
A
Andreas Dilger 已提交
3255 3256
PNG_EXTERN void png_do_gray_to_rgb PNGARG((png_row_infop row_info,
   png_bytep row));
A
Andreas Dilger 已提交
3257 3258
#endif

G
Guy Schalnat 已提交
3259
#if defined(PNG_READ_PACK_SUPPORTED)
A
Andreas Dilger 已提交
3260
PNG_EXTERN void png_do_unpack PNGARG((png_row_infop row_info, png_bytep row));
G
Guy Schalnat 已提交
3261 3262 3263
#endif

#if defined(PNG_READ_SHIFT_SUPPORTED)
A
Andreas Dilger 已提交
3264
PNG_EXTERN void png_do_unshift PNGARG((png_row_infop row_info, png_bytep row,
G
Guy Schalnat 已提交
3265
   png_color_8p sig_bits));
G
Guy Schalnat 已提交
3266 3267 3268
#endif

#if defined(PNG_READ_INVERT_SUPPORTED) || defined(PNG_WRITE_INVERT_SUPPORTED)
A
Andreas Dilger 已提交
3269
PNG_EXTERN void png_do_invert PNGARG((png_row_infop row_info, png_bytep row));
G
Guy Schalnat 已提交
3270 3271 3272
#endif

#if defined(PNG_READ_16_TO_8_SUPPORTED)
A
Andreas Dilger 已提交
3273
PNG_EXTERN void png_do_chop PNGARG((png_row_infop row_info, png_bytep row));
G
Guy Schalnat 已提交
3274 3275 3276
#endif

#if defined(PNG_READ_DITHER_SUPPORTED)
A
Andreas Dilger 已提交
3277
PNG_EXTERN void png_do_dither PNGARG((png_row_infop row_info,
G
Guy Schalnat 已提交
3278
   png_bytep row, png_bytep palette_lookup, png_bytep dither_lookup));
A
Andreas Dilger 已提交
3279

A
Andreas Dilger 已提交
3280
#  if defined(PNG_CORRECT_PALETTE_SUPPORTED)
A
Andreas Dilger 已提交
3281
PNG_EXTERN void png_correct_palette PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
3282
   png_colorp palette, int num_palette));
A
Andreas Dilger 已提交
3283
#  endif
G
Guy Schalnat 已提交
3284 3285
#endif

G
Guy Schalnat 已提交
3286
#if defined(PNG_READ_BGR_SUPPORTED) || defined(PNG_WRITE_BGR_SUPPORTED)
A
Andreas Dilger 已提交
3287
PNG_EXTERN void png_do_bgr PNGARG((png_row_infop row_info, png_bytep row));
G
Guy Schalnat 已提交
3288 3289 3290
#endif

#if defined(PNG_WRITE_PACK_SUPPORTED)
A
Andreas Dilger 已提交
3291 3292
PNG_EXTERN void png_do_pack PNGARG((png_row_infop row_info,
   png_bytep row, png_uint_32 bit_depth));
G
Guy Schalnat 已提交
3293 3294 3295
#endif

#if defined(PNG_WRITE_SHIFT_SUPPORTED)
A
Andreas Dilger 已提交
3296
PNG_EXTERN void png_do_shift PNGARG((png_row_infop row_info, png_bytep row,
G
Guy Schalnat 已提交
3297
   png_color_8p bit_depth));
G
Guy Schalnat 已提交
3298 3299 3300
#endif

#if defined(PNG_READ_BACKGROUND_SUPPORTED)
3301
#if defined(PNG_READ_GAMMA_SUPPORTED)
3302 3303 3304
PNG_EXTERN void png_do_background PNGARG((png_row_infop row_info, png_bytep row,
   png_color_16p trans_values, png_color_16p background,
   png_color_16p background_1,
G
Guy Schalnat 已提交
3305 3306
   png_bytep gamma_table, png_bytep gamma_from_1, png_bytep gamma_to_1,
   png_uint_16pp gamma_16, png_uint_16pp gamma_16_from_1,
3307 3308 3309 3310
   png_uint_16pp gamma_16_to_1, int gamma_shift));
#else
PNG_EXTERN void png_do_background PNGARG((png_row_infop row_info, png_bytep row,
   png_color_16p trans_values, png_color_16p background));
3311
#endif
G
Guy Schalnat 已提交
3312 3313 3314
#endif

#if defined(PNG_READ_GAMMA_SUPPORTED)
A
Andreas Dilger 已提交
3315
PNG_EXTERN void png_do_gamma PNGARG((png_row_infop row_info, png_bytep row,
G
Guy Schalnat 已提交
3316
   png_bytep gamma_table, png_uint_16pp gamma_16_table,
G
Guy Schalnat 已提交
3317
   int gamma_shift));
G
Guy Schalnat 已提交
3318 3319 3320
#endif

#if defined(PNG_READ_EXPAND_SUPPORTED)
A
Andreas Dilger 已提交
3321
PNG_EXTERN void png_do_expand_palette PNGARG((png_row_infop row_info,
G
Guy Schalnat 已提交
3322
   png_bytep row, png_colorp palette, png_bytep trans, int num_trans));
A
Andreas Dilger 已提交
3323
PNG_EXTERN void png_do_expand PNGARG((png_row_infop row_info,
G
Guy Schalnat 已提交
3324
   png_bytep row, png_color_16p trans_value));
G
Guy Schalnat 已提交
3325
#endif
G
Guy Schalnat 已提交
3326

A
Andreas Dilger 已提交
3327
/* The following decodes the appropriate chunks, and does error correction,
3328 3329
 * then calls the appropriate callback for the chunk if it is valid.
 */
G
Guy Schalnat 已提交
3330 3331

/* decode the IHDR chunk */
A
Andreas Dilger 已提交
3332
PNG_EXTERN void png_handle_IHDR PNGARG((png_structp png_ptr, png_infop info_ptr,
A
Andreas Dilger 已提交
3333
   png_uint_32 length));
A
Andreas Dilger 已提交
3334
PNG_EXTERN void png_handle_PLTE PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3335
   png_uint_32 length));
A
Andreas Dilger 已提交
3336
PNG_EXTERN void png_handle_IEND PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3337
   png_uint_32 length));
A
Andreas Dilger 已提交
3338

3339 3340
#if defined(PNG_READ_bKGD_SUPPORTED)
PNG_EXTERN void png_handle_bKGD PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3341
   png_uint_32 length));
G
Guy Schalnat 已提交
3342 3343
#endif

3344 3345
#if defined(PNG_READ_cHRM_SUPPORTED)
PNG_EXTERN void png_handle_cHRM PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3346
   png_uint_32 length));
G
Guy Schalnat 已提交
3347 3348
#endif

3349 3350
#if defined(PNG_READ_gAMA_SUPPORTED)
PNG_EXTERN void png_handle_gAMA PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3351
   png_uint_32 length));
G
Guy Schalnat 已提交
3352 3353
#endif

3354 3355
#if defined(PNG_READ_hIST_SUPPORTED)
PNG_EXTERN void png_handle_hIST PNGARG((png_structp png_ptr, png_infop info_ptr,
3356 3357 3358
   png_uint_32 length));
#endif

3359 3360 3361 3362 3363
#if defined(PNG_READ_iCCP_SUPPORTED)
extern void png_handle_iCCP PNGARG((png_structp png_ptr, png_infop info_ptr,
   png_uint_32 length));
#endif /* PNG_READ_iCCP_SUPPORTED */

3364 3365
#if defined(PNG_READ_iTXt_SUPPORTED)
PNG_EXTERN void png_handle_iTXt PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3366
   png_uint_32 length));
G
Guy Schalnat 已提交
3367 3368
#endif

3369 3370
#if defined(PNG_READ_oFFs_SUPPORTED)
PNG_EXTERN void png_handle_oFFs PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3371
   png_uint_32 length));
G
Guy Schalnat 已提交
3372 3373
#endif

3374 3375
#if defined(PNG_READ_pCAL_SUPPORTED)
PNG_EXTERN void png_handle_pCAL PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3376
   png_uint_32 length));
G
Guy Schalnat 已提交
3377 3378
#endif

3379 3380
#if defined(PNG_READ_pHYs_SUPPORTED)
PNG_EXTERN void png_handle_pHYs PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3381
   png_uint_32 length));
G
Guy Schalnat 已提交
3382 3383
#endif

3384 3385
#if defined(PNG_READ_sBIT_SUPPORTED)
PNG_EXTERN void png_handle_sBIT PNGARG((png_structp png_ptr, png_infop info_ptr,
A
Andreas Dilger 已提交
3386 3387 3388
   png_uint_32 length));
#endif

3389 3390 3391 3392 3393
#if defined(PNG_READ_sCAL_SUPPORTED)
PNG_EXTERN void png_handle_sCAL PNGARG((png_structp png_ptr, png_infop info_ptr,
   png_uint_32 length));
#endif

3394 3395 3396 3397 3398 3399 3400 3401 3402 3403 3404 3405
#if defined(PNG_READ_sPLT_SUPPORTED)
extern void png_handle_sPLT PNGARG((png_structp png_ptr, png_infop info_ptr,
   png_uint_32 length));
#endif /* PNG_READ_sPLT_SUPPORTED */

#if defined(PNG_READ_sRGB_SUPPORTED)
PNG_EXTERN void png_handle_sRGB PNGARG((png_structp png_ptr, png_infop info_ptr,
   png_uint_32 length));
#endif

#if defined(PNG_READ_tEXt_SUPPORTED)
PNG_EXTERN void png_handle_tEXt PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3406
   png_uint_32 length));
G
Guy Schalnat 已提交
3407 3408 3409
#endif

#if defined(PNG_READ_tIME_SUPPORTED)
A
Andreas Dilger 已提交
3410
PNG_EXTERN void png_handle_tIME PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3411
   png_uint_32 length));
G
Guy Schalnat 已提交
3412 3413
#endif

3414 3415
#if defined(PNG_READ_tRNS_SUPPORTED)
PNG_EXTERN void png_handle_tRNS PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3416
   png_uint_32 length));
G
Guy Schalnat 已提交
3417 3418 3419
#endif

#if defined(PNG_READ_zTXt_SUPPORTED)
A
Andreas Dilger 已提交
3420
PNG_EXTERN void png_handle_zTXt PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3421
   png_uint_32 length));
G
Guy Schalnat 已提交
3422
#endif
G
Guy Schalnat 已提交
3423

A
Andreas Dilger 已提交
3424 3425
PNG_EXTERN void png_handle_unknown PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_uint_32 length));
A
Andreas Dilger 已提交
3426

A
Andreas Dilger 已提交
3427
PNG_EXTERN void png_check_chunk_name PNGARG((png_structp png_ptr,
A
Andreas Dilger 已提交
3428 3429
   png_bytep chunk_name));

G
Guy Schalnat 已提交
3430
/* handle the transformations for reading and writing */
A
Andreas Dilger 已提交
3431 3432
PNG_EXTERN void png_do_read_transformations PNGARG((png_structp png_ptr));
PNG_EXTERN void png_do_write_transformations PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
3433

A
Andreas Dilger 已提交
3434
PNG_EXTERN void png_init_read_transformations PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
3435 3436

#ifdef PNG_PROGRESSIVE_READ_SUPPORTED
A
Andreas Dilger 已提交
3437 3438 3439 3440 3441 3442
PNG_EXTERN void png_push_read_chunk PNGARG((png_structp png_ptr,
   png_infop info_ptr));
PNG_EXTERN void png_push_read_sig PNGARG((png_structp png_ptr,
   png_infop info_ptr));
PNG_EXTERN void png_push_check_crc PNGARG((png_structp png_ptr));
PNG_EXTERN void png_push_crc_skip PNGARG((png_structp png_ptr,
A
Andreas Dilger 已提交
3443
   png_uint_32 length));
A
Andreas Dilger 已提交
3444 3445 3446 3447 3448 3449 3450 3451 3452 3453 3454 3455 3456 3457 3458 3459
PNG_EXTERN void png_push_crc_finish PNGARG((png_structp png_ptr));
PNG_EXTERN void png_push_save_buffer PNGARG((png_structp png_ptr));
PNG_EXTERN void png_push_restore_buffer PNGARG((png_structp png_ptr,
   png_bytep buffer, png_size_t buffer_length));
PNG_EXTERN void png_push_read_IDAT PNGARG((png_structp png_ptr));
PNG_EXTERN void png_process_IDAT_data PNGARG((png_structp png_ptr,
   png_bytep buffer, png_size_t buffer_length));
PNG_EXTERN void png_push_process_row PNGARG((png_structp png_ptr));
PNG_EXTERN void png_push_handle_unknown PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_uint_32 length));
PNG_EXTERN void png_push_have_info PNGARG((png_structp png_ptr,
   png_infop info_ptr));
PNG_EXTERN void png_push_have_end PNGARG((png_structp png_ptr,
   png_infop info_ptr));
PNG_EXTERN void png_push_have_row PNGARG((png_structp png_ptr, png_bytep row));
PNG_EXTERN void png_push_read_end PNGARG((png_structp png_ptr,
A
Andreas Dilger 已提交
3460
   png_infop info_ptr));
A
Andreas Dilger 已提交
3461 3462 3463
PNG_EXTERN void png_process_some_data PNGARG((png_structp png_ptr,
   png_infop info_ptr));
PNG_EXTERN void png_read_push_finish_row PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
3464
#if defined(PNG_READ_tEXt_SUPPORTED)
A
Andreas Dilger 已提交
3465 3466 3467 3468
PNG_EXTERN void png_push_handle_tEXt PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_uint_32 length));
PNG_EXTERN void png_push_read_tEXt PNGARG((png_structp png_ptr,
   png_infop info_ptr));
G
Guy Schalnat 已提交
3469 3470
#endif
#if defined(PNG_READ_zTXt_SUPPORTED)
A
Andreas Dilger 已提交
3471 3472 3473 3474
PNG_EXTERN void png_push_handle_zTXt PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_uint_32 length));
PNG_EXTERN void png_push_read_zTXt PNGARG((png_structp png_ptr,
   png_infop info_ptr));
G
Guy Schalnat 已提交
3475
#endif
3476 3477 3478 3479 3480 3481
#if defined(PNG_READ_iTXt_SUPPORTED)
PNG_EXTERN void png_push_handle_iTXt PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_uint_32 length));
PNG_EXTERN void png_push_read_iTXt PNGARG((png_structp png_ptr,
   png_infop info_ptr));
#endif
G
Guy Schalnat 已提交
3482

G
Guy Schalnat 已提交
3483
#endif /* PNG_PROGRESSIVE_READ_SUPPORTED */
G
Guy Schalnat 已提交
3484

3485 3486 3487 3488 3489 3490 3491
#ifdef PNG_MNG_FEATURES_SUPPORTED
PNG_EXTERN void png_do_read_intrapixel PNGARG((png_row_infop row_info,
   png_bytep row));
PNG_EXTERN void png_do_write_intrapixel PNGARG((png_row_infop row_info,
   png_bytep row));
#endif

3492
#if defined(PNG_ASSEMBLER_CODE_SUPPORTED)
3493
#if defined(PNG_MMX_CODE_SUPPORTED)
3494 3495 3496
/* png.c */ /* PRIVATE */
PNG_EXTERN void png_init_mmx_flags PNGARG((png_structp png_ptr));
#endif
3497
#endif
3498 3499 3500 3501 3502 3503 3504 3505 3506 3507 3508 3509 3510 3511 3512 3513 3514 3515 3516 3517 3518 3519 3520

#if defined(PNG_INCH_CONVERSIONS) && defined(PNG_FLOATING_POINT_SUPPORTED)
PNG_EXTERN png_uint_32 png_get_pixels_per_inch PNGARG((png_structp png_ptr,
png_infop info_ptr));

PNG_EXTERN png_uint_32 png_get_x_pixels_per_inch PNGARG((png_structp png_ptr,
png_infop info_ptr));

PNG_EXTERN png_uint_32 png_get_y_pixels_per_inch PNGARG((png_structp png_ptr,
png_infop info_ptr));

PNG_EXTERN float png_get_x_offset_inches PNGARG((png_structp png_ptr,
png_infop info_ptr));

PNG_EXTERN float png_get_y_offset_inches PNGARG((png_structp png_ptr,
png_infop info_ptr));

#if defined(PNG_pHYs_SUPPORTED)
PNG_EXTERN png_uint_32 png_get_pHYs_dpi PNGARG((png_structp png_ptr,
png_infop info_ptr, png_uint_32 *res_x, png_uint_32 *res_y, int *unit_type));
#endif /* PNG_pHYs_SUPPORTED */
#endif  /* PNG_INCH_CONVERSIONS && PNG_FLOATING_POINT_SUPPORTED */

3521 3522
/* Maintainer: Put new private prototypes here ^ and in libpngpf.3 */

G
Guy Schalnat 已提交
3523 3524
#endif /* PNG_INTERNAL */

A
Andreas Dilger 已提交
3525 3526 3527 3528
#ifdef __cplusplus
}
#endif

3529
#endif /* PNG_VERSION_INFO_ONLY */
G
Guy Schalnat 已提交
3530
/* do not put anything past this line */
3531
#endif /* PNG_H */