png.h 150.9 KB
Newer Older
A
Andreas Dilger 已提交
1
/* png.h - header file for PNG reference library
2
 *
3
 * libpng version 1.2.39beta04 - August 1, 2009
4
 * Copyright (c) 1998-2009 Glenn Randers-Pehrson
5 6
 * (Version 0.96 Copyright (c) 1996, 1997 Andreas Dilger)
 * (Version 0.88 Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.)
7
 *
8 9
 * This code is released under the libpng license (See LICENSE, below)
 *
10
 * Authors and maintainers:
11 12
 *  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
13
 *  libpng versions 0.97, January 1998, through 1.2.39beta04 - August 1, 2009: Glenn
14 15
 *  See also "Contributing Authors", below.
 *
16
 * Note about libpng version numbers:
17
 *
18 19 20 21 22 23
 *    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:
 *
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 55
 *    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)
56 57 58 59 60 61 62 63 64 65 66
 *    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
67
 *    1.0.9                    1    10009  2.1.0.9
68
 *    1.0.10beta1              1    10010  2.1.0.10beta1
69
 *    1.0.10rc1                1    10010  2.1.0.10rc1
70
 *    1.0.10                   1    10010  2.1.0.10
71
 *    1.0.11beta1-3            1    10011  2.1.0.11beta1-3
72
 *    1.0.11rc1                1    10011  2.1.0.11rc1
73
 *    1.0.11                   1    10011  2.1.0.11
74 75 76 77
 *    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)
78
 *    1.2.0beta1-2             2    10200  2.1.2.0beta1-2
79 80 81
 *    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
82
 *    1.2.1beta1-4             3    10201  3.1.2.1beta1-4
83 84
 *    1.2.1rc1-2               3    10201  3.1.2.1rc1-2
 *    1.2.1                    3    10201  3.1.2.1
85
 *    1.2.2beta1-6            12    10202  12.so.0.1.2.2beta1-6
86 87 88
 *    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
89 90
 *    1.0.13                  10    10013  10.so.0.1.0.13
 *    1.2.2                   12    10202  12.so.0.1.2.2
91 92
 *    1.2.3rc1-6              12    10203  12.so.0.1.2.3rc1-6
 *    1.2.3                   12    10203  12.so.0.1.2.3
93
 *    1.2.4beta1-3            13    10204  12.so.0.1.2.4beta1-3
94 95
 *    1.0.14rc1               13    10014  10.so.0.1.0.14rc1
 *    1.2.4rc1                13    10204  12.so.0.1.2.4rc1
96 97
 *    1.0.14                  10    10014  10.so.0.1.0.14
 *    1.2.4                   13    10204  12.so.0.1.2.4
98
 *    1.2.5beta1-2            13    10205  12.so.0.1.2.5beta1-2
99
 *    1.0.15rc1-3             10    10015  10.so.0.1.0.15rc1-3
100 101 102
 *    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
103
 *    1.2.6beta1-4            13    10206  12.so.0.1.2.6beta1-4
104 105
 *    1.0.16                  10    10016  10.so.0.1.0.16
 *    1.2.6                   13    10206  12.so.0.1.2.6
106
 *    1.2.7beta1-2            13    10207  12.so.0.1.2.7beta1-2
107
 *    1.0.17rc1               10    10017  10.so.0.1.0.17rc1
108
 *    1.2.7rc1                13    10207  12.so.0.1.2.7rc1
109
 *    1.0.17                  10    10017  10.so.0.1.0.17
110
 *    1.2.7                   13    10207  12.so.0.1.2.7
111
 *    1.2.8beta1-5            13    10208  12.so.0.1.2.8beta1-5
112
 *    1.0.18rc1-5             10    10018  10.so.0.1.0.18rc1-5
113
 *    1.2.8rc1-5              13    10208  12.so.0.1.2.8rc1-5
114
 *    1.0.18                  10    10018  10.so.0.1.0.18
115
 *    1.2.8                   13    10208  12.so.0.1.2.8
116
 *    1.2.9beta1-3            13    10209  12.so.0.1.2.9beta1-3
117
 *    1.2.9beta4-11           13    10209  12.so.0.9[.0]
118
 *    1.2.9rc1                13    10209  12.so.0.9[.0]
119
 *    1.2.9                   13    10209  12.so.0.9[.0]
120
 *    1.2.10beta1-8           13    10210  12.so.0.10[.0]
121 122
 *    1.2.10rc1-3             13    10210  12.so.0.10[.0]
 *    1.2.10                  13    10210  12.so.0.10[.0]
123
 *    1.2.11beta1-4           13    10211  12.so.0.11[.0]
124 125 126 127
 *    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]
128 129
 *    1.0.20                  10    10020  10.so.0.20[.0]
 *    1.2.12                  13    10212  12.so.0.12[.0]
130
 *    1.2.13beta1             13    10213  12.so.0.13[.0]
131 132
 *    1.0.21                  10    10021  10.so.0.21[.0]
 *    1.2.13                  13    10213  12.so.0.13[.0]
133 134 135
 *    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]
136 137
 *    1.0.22                  10    10022  10.so.0.22[.0]
 *    1.2.14                  13    10214  12.so.0.14[.0]
138
 *    1.2.15beta1-6           13    10215  12.so.0.15[.0]
139 140
 *    1.0.23rc1-5             10    10023  10.so.0.23[.0]
 *    1.2.15rc1-5             13    10215  12.so.0.15[.0]
141 142
 *    1.0.23                  10    10023  10.so.0.23[.0]
 *    1.2.15                  13    10215  12.so.0.15[.0]
143
 *    1.2.16beta1-2           13    10216  12.so.0.16[.0]
144
 *    1.2.16rc1               13    10216  12.so.0.16[.0]
145 146
 *    1.0.24                  10    10024  10.so.0.24[.0]
 *    1.2.16                  13    10216  12.so.0.16[.0]
147
 *    1.2.17beta1-2           13    10217  12.so.0.17[.0]
148 149
 *    1.0.25rc1               10    10025  10.so.0.25[.0]
 *    1.2.17rc1-3             13    10217  12.so.0.17[.0]
150 151
 *    1.0.25                  10    10025  10.so.0.25[.0]
 *    1.2.17                  13    10217  12.so.0.17[.0]
152 153
 *    1.0.26                  10    10026  10.so.0.26[.0]
 *    1.2.18                  13    10218  12.so.0.18[.0]
154
 *    1.2.19beta1-31          13    10219  12.so.0.19[.0]
155 156
 *    1.0.27rc1-6             10    10027  10.so.0.27[.0]
 *    1.2.19rc1-6             13    10219  12.so.0.19[.0]
157 158
 *    1.0.27                  10    10027  10.so.0.27[.0]
 *    1.2.19                  13    10219  12.so.0.19[.0]
159
 *    1.2.20beta01-04         13    10220  12.so.0.20[.0]
160 161
 *    1.0.28rc1-6             10    10028  10.so.0.28[.0]
 *    1.2.20rc1-6             13    10220  12.so.0.20[.0]
162 163
 *    1.0.28                  10    10028  10.so.0.28[.0]
 *    1.2.20                  13    10220  12.so.0.20[.0]
164
 *    1.2.21beta1-2           13    10221  12.so.0.21[.0]
165
 *    1.2.21rc1-3             13    10221  12.so.0.21[.0]
166 167
 *    1.0.29                  10    10029  10.so.0.29[.0]
 *    1.2.21                  13    10221  12.so.0.21[.0]
168
 *    1.2.22beta1-4           13    10222  12.so.0.22[.0]
169
 *    1.0.30rc1               10    10030  10.so.0.30[.0]
170
 *    1.2.22rc1               13    10222  12.so.0.22[.0]
171 172
 *    1.0.30                  10    10030  10.so.0.30[.0]
 *    1.2.22                  13    10222  12.so.0.22[.0]
173
 *    1.2.23beta01-05         13    10223  12.so.0.23[.0]
174
 *    1.2.23rc01              13    10223  12.so.0.23[.0]
175
 *    1.2.23                  13    10223  12.so.0.23[.0]
176
 *    1.2.24beta01-02         13    10224  12.so.0.24[.0]
177
 *    1.2.24rc01              13    10224  12.so.0.24[.0]
178
 *    1.2.24                  13    10224  12.so.0.24[.0]
179
 *    1.2.25beta01-06         13    10225  12.so.0.25[.0]
180
 *    1.2.25rc01-02           13    10225  12.so.0.25[.0]
181 182
 *    1.0.31                  10    10031  10.so.0.31[.0]
 *    1.2.25                  13    10225  12.so.0.25[.0]
183
 *    1.2.26beta01-06         13    10226  12.so.0.26[.0]
184
 *    1.2.26rc01              13    10226  12.so.0.26[.0]
185 186
 *    1.2.26                  13    10226  12.so.0.26[.0]
 *    1.0.32                  10    10032  10.so.0.32[.0]
187
 *    1.2.27beta01-06         13    10227  12.so.0.27[.0]
188
 *    1.2.27rc01              13    10227  12.so.0.27[.0]
189
 *    1.0.33                  10    10033  10.so.0.33[.0]
190
 *    1.2.27                  13    10227  12.so.0.27[.0]
191 192
 *    1.0.34                  10    10034  10.so.0.34[.0]
 *    1.2.28                  13    10228  12.so.0.28[.0]
193
 *    1.2.29beta01-03         13    10229  12.so.0.29[.0]
194
 *    1.2.29rc01              13    10229  12.so.0.29[.0]
195 196
 *    1.0.35                  10    10035  10.so.0.35[.0]
 *    1.2.29                  13    10229  12.so.0.29[.0]
197
 *    1.0.37                  10    10037  10.so.0.37[.0]
198
 *    1.2.30beta01-04         13    10230  12.so.0.30[.0]
199 200
 *    1.0.38rc01-08           10    10038  10.so.0.38[.0]
 *    1.2.30rc01-08           13    10230  12.so.0.30[.0]
201 202
 *    1.0.38                  10    10038  10.so.0.38[.0]
 *    1.2.30                  13    10230  12.so.0.30[.0]
203 204
 *    1.0.39rc01-03           10    10039  10.so.0.39[.0]
 *    1.2.31rc01-03           13    10231  12.so.0.31[.0]
205
 *    1.0.39                  10    10039  10.so.0.39[.0]
206
 *    1.2.31                  13    10231  12.so.0.31[.0]
207
 *    1.2.32beta01-02         13    10232  12.so.0.32[.0]
208 209
 *    1.0.40rc01              10    10040  10.so.0.40[.0]
 *    1.2.32rc01              13    10232  12.so.0.32[.0]
210 211
 *    1.0.40                  10    10040  10.so.0.40[.0]
 *    1.2.32                  13    10232  12.so.0.32[.0]
212
 *    1.2.33beta01-02         13    10233  12.so.0.33[.0]
213 214
 *    1.2.33rc01-02           13    10233  12.so.0.33[.0]
 *    1.0.41rc01              10    10041  10.so.0.41[.0]
215 216
 *    1.2.33                  13    10233  12.so.0.33[.0]
 *    1.0.41                  10    10041  10.so.0.41[.0]
217
 *    1.2.34beta01-07         13    10234  12.so.0.34[.0]
218 219
 *    1.0.42rc01              10    10042  10.so.0.42[.0]
 *    1.2.34rc01              13    10234  12.so.0.34[.0]
220 221
 *    1.0.42                  10    10042  10.so.0.42[.0]
 *    1.2.34                  13    10234  12.so.0.34[.0]
222
 *    1.2.35beta01-03         13    10235  12.so.0.35[.0]
223 224
 *    1.0.43rc01-02           10    10043  10.so.0.43[.0]
 *    1.2.35rc01-02           13    10235  12.so.0.35[.0]
225 226
 *    1.0.43                  10    10043  10.so.0.43[.0]
 *    1.2.35                  13    10235  12.so.0.35[.0]
227
 *    1.2.36beta01-05         13    10236  12.so.0.36[.0]
228
 *    1.2.36rc01              13    10236  12.so.0.36[.0]
229 230
 *    1.0.44                  10    10044  10.so.0.44[.0]
 *    1.2.36                  13    10236  12.so.0.36[.0]
231
 *    1.2.37beta01-03         13    10237  12.so.0.37[.0]
232
 *    1.2.37rc01              13    10237  12.so.0.37[.0]
233
 *    1.2.37                  13    10237  12.so.0.37[.0]
234
 *    1.2.45                  10    10045  12.so.0.45[.0]
235
 *    1.0.46                  10    10046  10.so.0.46[.0]
236
 *    1.2.38beta01            13    10238  12.so.0.38[.0]
237
 *    1.2.38rc01-03           13    10238  12.so.0.38[.0]
238
 *    1.0.47                  10    10047  10.so.0.47[.0]
239
 *    1.2.38                  13    10238  12.so.0.38[.0]
240
 *    1.2.39beta01-04         13    10239  12.so.0.39[.0]
241
 *
242 243
 *    Henceforth the source version will match the shared-library major
 *    and minor numbers; the shared-library major version number will be
244
 *    used for changes in backward compatibility, as it is intended.  The
245
 *    PNG_LIBPNG_VER macro, which is not used within libpng but is available
246
 *    for applications, is an unsigned integer of the form xyyzz corresponding
247
 *    to the source version x.y.z (leading zeros in y and z).  Beta versions
248 249
 *    were given the previous public release number plus a letter, until
 *    version 1.0.6j; from then on they were given the upcoming public
250
 *    release number plus "betaNN" or "rcNN".
251
 *
252 253 254 255
 *    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.
 *
256 257 258
 *    DLLNUM will change each time there are forward or backward changes
 *    in binary compatibility (e.g., when a new feature is added).
 *
259
 * See libpng.txt or libpng.3 for more information.  The PNG specification
260 261
 * is available as a W3C Recommendation and as an ISO Specification,
 * <http://www.w3.org/TR/2003/REC-PNG-20031110/
262 263 264
 */

/*
265 266
 * COPYRIGHT NOTICE, DISCLAIMER, and LICENSE:
 *
267 268
 * If you modify libpng you may insert additional notices immediately following
 * this sentence.
269
 *
270 271
 * This code is released under the libpng license.
 *
272
 * libpng versions 1.2.6, August 15, 2004, through 1.2.39beta04, August 1, 2009, are
273
 * Copyright (c) 2004, 2006-2009 Glenn Randers-Pehrson, and are
274
 * distributed according to the same disclaimer and license as libpng-1.2.5
275
 * with the following individual added to the list of Contributing Authors:
276 277 278
 *
 *    Cosmin Truta
 *
279
 * libpng versions 1.0.7, July 1, 2000, through 1.2.5, October 3, 2002, are
280
 * Copyright (c) 2000-2002 Glenn Randers-Pehrson, and are
281
 * distributed according to the same disclaimer and license as libpng-1.0.6
282
 * with the following individuals added to the list of Contributing Authors:
283
 *
284 285 286 287
 *    Simon-Pierre Cadieux
 *    Eric S. Raymond
 *    Gilles Vollant
 *
288 289 290 291 292 293 294 295 296 297
 * 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
298 299
 * Copyright (c) 1998, 1999, 2000 Glenn Randers-Pehrson, and are
 * distributed according to the same disclaimer and license as libpng-0.96,
300 301 302 303 304 305 306 307 308 309
 * 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:
310
 *
311 312
 *    John Bowler
 *    Kevin Bracey
313
 *    Sam Bushell
314 315
 *    Magnus Holmgren
 *    Greg Roelofs
316 317 318 319 320 321 322 323 324 325
 *    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
326 327 328 329 330 331 332 333 334 335 336 337 338 339 340
 *    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:
341
 *
342
 * 1. The origin of this source code must not be misrepresented.
343
 *
344 345
 * 2. Altered versions must be plainly marked as such and
 * must not be misrepresented as being the original source.
346
 *
347 348
 * 3. This Copyright notice may not be removed or altered from
 *    any source or altered source distribution.
349 350 351 352 353 354 355
 *
 * 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 已提交
356

357
/*
358 359
 * A "png_get_copyright" function is available, for convenient use in "about"
 * boxes and the like:
360
 *
361
 * printf("%s",png_get_copyright(NULL));
362
 *
363
 * Also, the PNG logo (in PNG format, of course) is supplied in the
364
 * files "pngbar.png" and "pngbar.jpg (88x31) and "pngnow.png" (98x31).
365 366 367
 */

/*
368 369 370 371 372 373 374 375 376 377 378 379
 * 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.
 */

380 381 382 383
/*
 * Y2K compliance in libpng:
 * =========================
 *
384
 *    August 1, 2009
385 386 387 388 389
 *
 *    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
390
 *    upward through 1.2.39beta04 are Y2K compliant.  It is my belief that earlier
391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435
 *    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
 */

436 437
#ifndef PNG_H
#define PNG_H
G
Guy Schalnat 已提交
438 439

/* This is not the place to learn how to use libpng.  The file libpng.txt
A
Andreas Dilger 已提交
440 441 442 443
 * 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 已提交
444

445
/* Version information for png.h - this should match the version in png.c */
446
#define PNG_LIBPNG_VER_STRING "1.2.39beta04"
447
#define PNG_HEADER_VERSION_STRING \
448
   " libpng version 1.2.39beta04 - August 1, 2009\n"
449

450
#define PNG_LIBPNG_VER_SONUM   0
451
#define PNG_LIBPNG_VER_DLLNUM  13
452 453 454

/* These should match the first 3 components of PNG_LIBPNG_VER_STRING: */
#define PNG_LIBPNG_VER_MAJOR   1
455
#define PNG_LIBPNG_VER_MINOR   2
456
#define PNG_LIBPNG_VER_RELEASE 39
457
/* This should match the numeric part of the final component of
458 459
 * PNG_LIBPNG_VER_STRING, omitting any leading zero:
 */
460

461
#define PNG_LIBPNG_VER_BUILD  04
462

463
/* Release Status */
464 465 466 467
#define PNG_LIBPNG_BUILD_ALPHA    1
#define PNG_LIBPNG_BUILD_BETA     2
#define PNG_LIBPNG_BUILD_RC       3
#define PNG_LIBPNG_BUILD_STABLE   4
468
#define PNG_LIBPNG_BUILD_RELEASE_STATUS_MASK 7
469

470 471 472 473 474 475 476
/* 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 */
477

478
#define PNG_LIBPNG_BUILD_BASE_TYPE PNG_LIBPNG_BUILD_BETA
479

480 481 482 483
/* 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
484 485
 * version 1.0.1 it's    xxyyzz, where x=major, y=minor, z=release
 */
486
#define PNG_LIBPNG_VER 10239 /* 1.2.39 */
487 488

#ifndef PNG_VERSION_INFO_ONLY
G
Guy Schalnat 已提交
489 490
/* include the compression library's header */
#include "zlib.h"
491
#endif
G
Guy Schalnat 已提交
492

493
/* include all user configurable info, including optional assembler routines */
G
Guy Schalnat 已提交
494
#include "pngconf.h"
G
Guy Schalnat 已提交
495

496 497 498 499 500
/*
 * 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
501
 * contain a PrivateBuild string.
502 503 504 505
 *
 * 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
506
 * StringFileInfo block must contain a SpecialBuild string.
507 508 509
 */

#if defined(PNG_USER_PRIVATEBUILD)
510 511
#  define PNG_LIBPNG_BUILD_TYPE \
          (PNG_LIBPNG_BUILD_BASE_TYPE | PNG_LIBPNG_BUILD_PRIVATE)
512 513
#else
#  if defined(PNG_LIBPNG_SPECIALBUILD)
514 515
#    define PNG_LIBPNG_BUILD_TYPE \
            (PNG_LIBPNG_BUILD_BASE_TYPE | PNG_LIBPNG_BUILD_SPECIAL)
516
#  else
517
#    define PNG_LIBPNG_BUILD_TYPE (PNG_LIBPNG_BUILD_BASE_TYPE)
518 519 520 521 522
#  endif
#endif

#ifndef PNG_VERSION_INFO_ONLY

523 524 525 526 527
/* Inhibit C++ name-mangling for libpng functions but not for system calls. */
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */

A
Andreas Dilger 已提交
528 529 530 531 532 533
/* 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.
 */

534
#ifndef PNG_NO_TYPECAST_NULL
535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566
#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
567

568
/* Variables declared in png.c - only it needs to define PNG_NO_EXTERN */
569
#if !defined(PNG_NO_EXTERN) || defined(PNG_ALWAYS_EXTERN)
A
Andreas Dilger 已提交
570 571 572
/* Version information for C files, stored in png.c.  This had better match
 * the version above.
 */
573
#ifdef PNG_USE_GLOBAL_ARRAYS
574
PNG_EXPORT_VAR (PNG_CONST char) png_libpng_ver[18];
575
  /* need room for 99.99.99beta99z */
576 577 578
#else
#define png_libpng_ver png_get_header_ver(NULL)
#endif
G
Guy Schalnat 已提交
579

580
#ifdef PNG_USE_GLOBAL_ARRAYS
581
/* This was removed in version 1.0.5c */
A
Andreas Dilger 已提交
582
/* Structures to facilitate easy interlacing.  See png.c for more details */
583 584 585 586 587 588
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];
589
/* This isn't currently used.  If you need it, see png.c for more details.
590
PNG_EXPORT_VAR (PNG_CONST int FARDATA) png_pass_height[7];
A
Andreas Dilger 已提交
591
*/
592
#endif
593

A
Andreas Dilger 已提交
594 595 596 597 598 599
#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 已提交
600 601
typedef struct png_color_struct
{
G
Guy Schalnat 已提交
602
   png_byte red;
G
Guy Schalnat 已提交
603 604 605
   png_byte green;
   png_byte blue;
} png_color;
A
Andreas Dilger 已提交
606 607
typedef png_color FAR * png_colorp;
typedef png_color FAR * FAR * png_colorpp;
G
Guy Schalnat 已提交
608 609 610

typedef struct png_color_16_struct
{
A
Andreas Dilger 已提交
611 612
   png_byte index;    /* used for palette files */
   png_uint_16 red;   /* for use in red green blue files */
G
Guy Schalnat 已提交
613 614
   png_uint_16 green;
   png_uint_16 blue;
A
Andreas Dilger 已提交
615
   png_uint_16 gray;  /* for use in grayscale files */
G
Guy Schalnat 已提交
616
} png_color_16;
A
Andreas Dilger 已提交
617 618
typedef png_color_16 FAR * png_color_16p;
typedef png_color_16 FAR * FAR * png_color_16pp;
G
Guy Schalnat 已提交
619 620 621

typedef struct png_color_8_struct
{
A
Andreas Dilger 已提交
622
   png_byte red;   /* for use in red green blue files */
G
Guy Schalnat 已提交
623 624
   png_byte green;
   png_byte blue;
A
Andreas Dilger 已提交
625
   png_byte gray;  /* for use in grayscale files */
G
Guy Schalnat 已提交
626 627
   png_byte alpha; /* for alpha channel files */
} png_color_8;
A
Andreas Dilger 已提交
628 629
typedef png_color_8 FAR * png_color_8p;
typedef png_color_8 FAR * FAR * png_color_8pp;
G
Guy Schalnat 已提交
630

631 632 633 634
/*
 * The following two structures are used for the in-core representation
 * of sPLT chunks.
 */
635
typedef struct png_sPLT_entry_struct
636 637 638 639 640 641
{
   png_uint_16 red;
   png_uint_16 green;
   png_uint_16 blue;
   png_uint_16 alpha;
   png_uint_16 frequency;
642 643 644
} png_sPLT_entry;
typedef png_sPLT_entry FAR * png_sPLT_entryp;
typedef png_sPLT_entry FAR * FAR * png_sPLT_entrypp;
645

646 647 648 649 650
/*  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.
 */

651
typedef struct png_sPLT_struct
652
{
653 654 655 656
   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 */
657 658 659
} png_sPLT_t;
typedef png_sPLT_t FAR * png_sPLT_tp;
typedef png_sPLT_t FAR * FAR * png_sPLT_tpp;
660 661

#ifdef PNG_TEXT_SUPPORTED
662 663
/* 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
664 665 666 667 668 669
 * 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 已提交
670 671
typedef struct png_text_struct
{
672 673 674 675 676
   int  compression;       /* compression value:
                             -1: tEXt, none
                              0: zTXt, deflate
                              1: iTXt, none
                              2: iTXt, deflate  */
A
Andreas Dilger 已提交
677
   png_charp key;          /* keyword, 1-79 character description of "text" */
678 679
   png_charp text;         /* comment, may be an empty string (ie "")
                              or a NULL pointer */
680
   png_size_t text_length; /* length of the text string */
681
#ifdef PNG_iTXt_SUPPORTED
682
   png_size_t itxt_length; /* length of the itxt string */
683 684
   png_charp lang;         /* language code, 0-79 characters
                              or a NULL pointer */
685
   png_charp lang_key;     /* keyword translated UTF-8 string, 0 or more
686
                              chars or a NULL pointer */
687
#endif
G
Guy Schalnat 已提交
688
} png_text;
A
Andreas Dilger 已提交
689 690
typedef png_text FAR * png_textp;
typedef png_text FAR * FAR * png_textpp;
691
#endif
A
Andreas Dilger 已提交
692 693

/* Supported compression types for text in PNG files (tEXt, and zTXt).
694 695
 * The values of the PNG_TEXT_COMPRESSION_ defines should NOT be changed.
 */
A
Andreas Dilger 已提交
696 697 698 699
#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
700 701 702
#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 已提交
703 704

/* png_time is a way to hold the time in an machine independent way.
705 706 707
 * 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
708
 * note - PNG has always been Year 2000 compliant!
709
 */
G
Guy Schalnat 已提交
710 711 712
typedef struct png_time_struct
{
   png_uint_16 year; /* full year, as in, 1995 */
A
Andreas Dilger 已提交
713 714 715 716 717
   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 已提交
718
} png_time;
A
Andreas Dilger 已提交
719 720 721
typedef png_time FAR * png_timep;
typedef png_time FAR * FAR * png_timepp;

722 723
#if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED) || \
 defined(PNG_HANDLE_AS_UNKNOWN_SUPPORTED)
724 725 726 727 728
/* 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.
 */
729
#define PNG_CHUNK_NAME_LENGTH 5
730 731
typedef struct png_unknown_chunk_t
{
732
    png_byte name[PNG_CHUNK_NAME_LENGTH];
733 734 735
    png_byte *data;
    png_size_t size;

736
    /* libpng-using applications should NOT directly modify this byte. */
737 738 739 740 741 742 743
    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 已提交
744 745 746 747 748 749 750 751 752 753 754
/* 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,
755
 * however, there are now functions that abstract the contents of
A
Andreas Dilger 已提交
756 757 758 759 760 761 762 763
 * 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.
764 765
 *
 * The following members may have allocated storage attached that should be
766 767
 * cleaned up before the structure is discarded: palette, trans, text,
 * pcal_purpose, pcal_units, pcal_params, hist, iccp_name, iccp_profile,
768 769
 * splt_palettes, scal_unit, row_pointers, and unknowns.   By default, these
 * are automatically freed when the info structure is deallocated, if they were
770 771
 * allocated internally by libpng.  This behavior can be changed by means
 * of the png_data_freer() function.
772
 *
773 774 775 776 777 778 779 780 781
 * 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 已提交
782
 */
G
Guy Schalnat 已提交
783 784
typedef struct png_info_struct
{
A
Andreas Dilger 已提交
785 786 787 788
   /* 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) */
789
   png_uint_32 rowbytes;    /* bytes needed to hold an untransformed row */
A
Andreas Dilger 已提交
790 791 792 793 794
   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) */
795
   /* The following three should have been named *_method not *_type */
A
Andreas Dilger 已提交
796 797 798 799 800
   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. */
801
   png_byte channels;       /* number of data channels per pixel (1, 2, 3, 4) */
A
Andreas Dilger 已提交
802 803 804 805 806 807 808 809 810 811
   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.
    */

812
#if defined(PNG_gAMA_SUPPORTED) && defined(PNG_FLOATING_POINT_SUPPORTED)
A
Andreas Dilger 已提交
813 814 815 816 817
   /* 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) */
818
#endif
819

820
#if defined(PNG_sRGB_SUPPORTED)
821 822 823
    /* 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] */
824 825 826 827 828 829 830 831 832 833
#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 已提交
834 835 836 837
    */
   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 */
838 839 840
#endif /* PNG_TEXT_SUPPORTED */

#if defined(PNG_tIME_SUPPORTED)
A
Andreas Dilger 已提交
841 842 843 844
   /* 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;
845 846 847
#endif

#if defined(PNG_sBIT_SUPPORTED)
A
Andreas Dilger 已提交
848 849 850 851 852 853 854
   /* 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 */
855 856 857 858
#endif

#if defined(PNG_tRNS_SUPPORTED) || defined(PNG_READ_EXPAND_SUPPORTED) || \
defined(PNG_READ_BACKGROUND_SUPPORTED)
A
Andreas Dilger 已提交
859 860 861 862 863 864
   /* 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
865
    * single color specified that should be treated as fully transparent.
A
Andreas Dilger 已提交
866 867 868 869
    * 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 */
870 871 872
#endif

#if defined(PNG_bKGD_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED)
A
Andreas Dilger 已提交
873 874 875 876 877 878 879
   /* 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;
880 881 882
#endif

#if defined(PNG_oFFs_SUPPORTED)
A
Andreas Dilger 已提交
883 884 885 886 887
   /* 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.
    */
888 889
   png_int_32 x_offset; /* x offset on page */
   png_int_32 y_offset; /* y offset on page */
G
Guy Schalnat 已提交
890
   png_byte offset_unit_type; /* offset units type */
891 892 893
#endif

#if defined(PNG_pHYs_SUPPORTED)
A
Andreas Dilger 已提交
894 895 896 897 898 899 900
   /* 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) */
901 902 903
#endif

#if defined(PNG_hIST_SUPPORTED)
A
Andreas Dilger 已提交
904 905 906 907 908 909 910
   /* 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;
911 912
#endif

913
#ifdef PNG_cHRM_SUPPORTED
A
Andreas Dilger 已提交
914 915 916 917 918 919
   /* 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.
    */
920
#ifdef PNG_FLOATING_POINT_SUPPORTED
A
Andreas Dilger 已提交
921
   float x_white;
G
Guy Schalnat 已提交
922 923 924 925 926 927 928
   float y_white;
   float x_red;
   float y_red;
   float x_green;
   float y_green;
   float x_blue;
   float y_blue;
929 930 931 932
#endif
#endif

#if defined(PNG_pCAL_SUPPORTED)
A
Andreas Dilger 已提交
933
   /* The pCAL chunk describes a transformation between the stored pixel
934
    * values and original physical data values used to create the image.
A
Andreas Dilger 已提交
935 936 937 938
    * 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_
939 940 941 942
    * 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 已提交
943 944 945 946 947 948 949 950
    */
   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 */
951 952
#endif

953
/* New members added in libpng-1.0.6 */
954 955 956 957
#ifdef PNG_FREE_ME_SUPPORTED
   png_uint_32 free_me;     /* flags items libpng is responsible for freeing */
#endif

958 959
#if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED) || \
 defined(PNG_HANDLE_AS_UNKNOWN_SUPPORTED)
960
   /* Storage for unknown chunks that the library doesn't recognize. */
961 962 963 964
   png_unknown_chunkp unknown_chunks;
   png_size_t unknown_chunks_num;
#endif

965 966 967 968
#if defined(PNG_iCCP_SUPPORTED)
   /* iCCP chunk data. */
   png_charp iccp_name;     /* profile name */
   png_charp iccp_profile;  /* International Color Consortium profile data */
969
                            /* Note to maintainer: should be png_bytep */
970 971 972 973 974
   png_uint_32 iccp_proflen;  /* ICC profile data length */
   png_byte iccp_compression; /* Always zero */
#endif

#if defined(PNG_sPLT_SUPPORTED)
975
   /* Data on sPLT chunks (there may be more than one). */
976
   png_sPLT_tp splt_palettes;
977 978 979 980 981 982
   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
983
    * a byte value, and two ASCII strings representing floating-point
984 985 986 987
    * 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.
    */
988
   png_byte scal_unit;         /* unit of physical scale */
989 990 991
#ifdef PNG_FLOATING_POINT_SUPPORTED
   double scal_pixel_width;    /* width of one pixel */
   double scal_pixel_height;   /* height of one pixel */
992
#endif
993 994 995 996
#ifdef PNG_FIXED_POINT_SUPPORTED
   png_charp scal_s_width;     /* string containing height */
   png_charp scal_s_height;    /* string containing width */
#endif
997 998
#endif

999
#if defined(PNG_INFO_IMAGE_SUPPORTED)
1000
   /* Memory has been allocated if (valid & PNG_ALLOCATED_INFO_ROWS) non-zero */
1001 1002 1003
   /* Data valid if (valid & PNG_INFO_IDAT) non-zero */
   png_bytepp row_pointers;        /* the image bits */
#endif
1004

1005
#if defined(PNG_FIXED_POINT_SUPPORTED) && defined(PNG_gAMA_SUPPORTED)
1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019
   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 已提交
1020
} png_info;
1021

A
Andreas Dilger 已提交
1022 1023
typedef png_info FAR * png_infop;
typedef png_info FAR * FAR * png_infopp;
G
Guy Schalnat 已提交
1024

1025
/* Maximum positive integer used in PNG is (2^31)-1 */
1026
#define PNG_UINT_31_MAX ((png_uint_32)0x7fffffffL)
1027 1028
#define PNG_UINT_32_MAX ((png_uint_32)(-1))
#define PNG_SIZE_MAX ((png_size_t)(-1))
1029
#if defined(PNG_1_0_X) || defined (PNG_1_2_X)
1030 1031
/* PNG_MAX_UINT is deprecated; use PNG_UINT_31_MAX instead. */
#define PNG_MAX_UINT PNG_UINT_31_MAX
1032
#endif
1033

A
Andreas Dilger 已提交
1034
/* These describe the color_type field in png_info. */
G
Guy Schalnat 已提交
1035
/* color type masks */
A
Andreas Dilger 已提交
1036 1037 1038
#define PNG_COLOR_MASK_PALETTE    1
#define PNG_COLOR_MASK_COLOR      2
#define PNG_COLOR_MASK_ALPHA      4
G
Guy Schalnat 已提交
1039 1040

/* color types.  Note that not all combinations are legal */
G
Guy Schalnat 已提交
1041
#define PNG_COLOR_TYPE_GRAY 0
A
Andreas Dilger 已提交
1042 1043 1044
#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 已提交
1045
#define PNG_COLOR_TYPE_GRAY_ALPHA (PNG_COLOR_MASK_ALPHA)
1046 1047 1048
/* aliases */
#define PNG_COLOR_TYPE_RGBA  PNG_COLOR_TYPE_RGB_ALPHA
#define PNG_COLOR_TYPE_GA  PNG_COLOR_TYPE_GRAY_ALPHA
G
Guy Schalnat 已提交
1049

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

1054
/* This is for filter type. PNG 1.0-1.2 only define the single type. */
A
Andreas Dilger 已提交
1055
#define PNG_FILTER_TYPE_BASE      0 /* Single row per-byte filtering */
1056
#define PNG_INTRAPIXEL_DIFFERENCING 64 /* Used only in MNG datastreams */
A
Andreas Dilger 已提交
1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075
#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 */

1076 1077 1078 1079 1080 1081
/* 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 已提交
1082 1083 1084 1085 1086
/* 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 */

1087
/* These are for the sRGB chunk.  These values should NOT be changed. */
1088 1089 1090 1091
#define PNG_sRGB_INTENT_PERCEPTUAL 0
#define PNG_sRGB_INTENT_RELATIVE   1
#define PNG_sRGB_INTENT_SATURATION 2
#define PNG_sRGB_INTENT_ABSOLUTE   3
1092
#define PNG_sRGB_INTENT_LAST       4 /* Not a valid value */
1093

1094 1095
/* This is for text chunks */
#define PNG_KEYWORD_MAX_LENGTH     79
1096

1097
/* Maximum number of entries in PLTE/sPLT/tRNS arrays */
1098
#define PNG_MAX_PALETTE_LENGTH    256
1099

A
Andreas Dilger 已提交
1100 1101 1102 1103 1104
/* 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 已提交
1105 1106 1107 1108 1109 1110 1111 1112 1113 1114
#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 已提交
1115
#define PNG_INFO_pCAL 0x0400
1116
#define PNG_INFO_sRGB 0x0800   /* GR-P, 0.96a */
1117 1118 1119
#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 */
1120
#define PNG_INFO_IDAT 0x8000L  /* ESR, 1.0.6 */
G
Guy Schalnat 已提交
1121

A
Andreas Dilger 已提交
1122 1123 1124 1125
/* 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 已提交
1126 1127
typedef struct png_row_info_struct
{
G
Guy Schalnat 已提交
1128
   png_uint_32 width; /* width of row */
1129
   png_uint_32 rowbytes; /* number of bytes in row */
G
Guy Schalnat 已提交
1130 1131 1132 1133
   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 已提交
1134 1135
} png_row_info;

A
Andreas Dilger 已提交
1136 1137
typedef png_row_info FAR * png_row_infop;
typedef png_row_info FAR * FAR * png_row_infopp;
G
Guy Schalnat 已提交
1138

1139 1140 1141 1142 1143
/* 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 已提交
1144
 */
G
Guy Schalnat 已提交
1145 1146 1147
typedef struct png_struct_def png_struct;
typedef png_struct FAR * png_structp;

1148 1149 1150 1151 1152 1153 1154
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));
1155

G
Guy Schalnat 已提交
1156
#ifdef PNG_PROGRESSIVE_READ_SUPPORTED
1157 1158 1159
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 已提交
1160
   png_uint_32, int));
1161
#endif
G
Guy Schalnat 已提交
1162

1163
#if defined(PNG_READ_USER_TRANSFORM_SUPPORTED) || \
1164 1165
    defined(PNG_WRITE_USER_TRANSFORM_SUPPORTED) || \
    defined(PNG_LEGACY_SUPPORTED)
1166
typedef void (PNGAPI *png_user_transform_ptr) PNGARG((png_structp,
1167
    png_row_infop, png_bytep));
1168
#endif
1169

1170
#if defined(PNG_USER_CHUNKS_SUPPORTED)
1171
typedef int (PNGAPI *png_user_chunk_ptr) PNGARG((png_structp, png_unknown_chunkp));
1172
#endif
1173
#if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED)
1174
typedef void (PNGAPI *png_unknown_chunk_ptr) PNGARG((png_structp));
1175 1176 1177
#endif

/* Transform masks for the high-level interface */
1178 1179
#define PNG_TRANSFORM_IDENTITY       0x0000    /* read and write */
#define PNG_TRANSFORM_STRIP_16       0x0001    /* read only */
1180 1181
#define PNG_TRANSFORM_STRIP_ALPHA    0x0002    /* read only */
#define PNG_TRANSFORM_PACKING        0x0004    /* read and write */
1182 1183
#define PNG_TRANSFORM_PACKSWAP       0x0008    /* read and write */
#define PNG_TRANSFORM_EXPAND         0x0010    /* read only */
1184
#define PNG_TRANSFORM_INVERT_MONO    0x0020    /* read and write */
1185 1186 1187
#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 */
1188
#define PNG_TRANSFORM_SWAP_ENDIAN    0x0200    /* read and write */
1189
#define PNG_TRANSFORM_INVERT_ALPHA   0x0400    /* read and write */
1190 1191 1192 1193
#define PNG_TRANSFORM_STRIP_FILLER   0x0800    /* WRITE only, deprecated */
/* Added to libpng-1.2.34 */
#define PNG_TRANSFORM_STRIP_FILLER_BEFORE 0x0800  /* WRITE only */
#define PNG_TRANSFORM_STRIP_FILLER_AFTER  0x1000  /* WRITE only */
1194

1195
/* Flags for MNG supported features */
1196 1197
#define PNG_FLAG_MNG_EMPTY_PLTE     0x01
#define PNG_FLAG_MNG_FILTER_64      0x04
1198
#define PNG_ALL_MNG_FEATURES        0x05
1199

1200
typedef png_voidp (*png_malloc_ptr) PNGARG((png_structp, png_size_t));
1201
typedef void (*png_free_ptr) PNGARG((png_structp, png_voidp));
1202

A
Andreas Dilger 已提交
1203 1204 1205 1206 1207 1208
/* 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 已提交
1209

G
Guy Schalnat 已提交
1210
struct png_struct_def
G
Guy Schalnat 已提交
1211
{
1212
#ifdef PNG_SETJMP_SUPPORTED
A
Andreas Dilger 已提交
1213
   jmp_buf jmpbuf;            /* used in png_error */
1214
#endif
A
Andreas Dilger 已提交
1215 1216
   png_error_ptr error_fn;    /* function for printing errors and aborting */
   png_error_ptr warning_fn;  /* function for printing warnings */
G
Guy Schalnat 已提交
1217
   png_voidp error_ptr;       /* user supplied struct for error functions */
A
Andreas Dilger 已提交
1218 1219
   png_rw_ptr write_data_fn;  /* function for writing output data */
   png_rw_ptr read_data_fn;   /* function for reading input data */
1220
   png_voidp io_ptr;          /* ptr to application struct for I/O functions */
1221

1222
#if defined(PNG_READ_USER_TRANSFORM_SUPPORTED)
1223
   png_user_transform_ptr read_user_transform_fn; /* user read transform */
1224
#endif
1225

1226
#if defined(PNG_WRITE_USER_TRANSFORM_SUPPORTED)
1227 1228
   png_user_transform_ptr write_user_transform_fn; /* user write transform */
#endif
1229

1230 1231
/* These were added in libpng-1.0.2 */
#if defined(PNG_USER_TRANSFORM_PTR_SUPPORTED)
1232 1233 1234
#if defined(PNG_READ_USER_TRANSFORM_SUPPORTED) || \
    defined(PNG_WRITE_USER_TRANSFORM_SUPPORTED)
   png_voidp user_transform_ptr; /* user supplied struct for user transform */
1235 1236
   png_byte user_transform_depth;    /* bit depth of user transformed pixels */
   png_byte user_transform_channels; /* channels in user transformed pixels */
1237
#endif
1238
#endif
G
Guy Schalnat 已提交
1239

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

A
Andreas Dilger 已提交
1244 1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256
   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 */
1257 1258
   png_uint_32 rowbytes;      /* size of row in bytes */
   png_uint_32 irowbytes;     /* size of current interlaced row in bytes */
A
Andreas Dilger 已提交
1259 1260 1261 1262
   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 */
1263
#ifndef PNG_NO_WRITE_FILTER
A
Andreas Dilger 已提交
1264 1265 1266 1267
   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 */
1268
#endif
A
Andreas Dilger 已提交
1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288
   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 已提交
1289

G
Guy Schalnat 已提交
1290
#if defined(PNG_READ_FILLER_SUPPORTED) || defined(PNG_WRITE_FILLER_SUPPORTED)
1291 1292 1293
#ifdef PNG_LEGACY_SUPPORTED
   png_byte filler;           /* filler byte for pixel expansion */
#else
1294
   png_uint_16 filler;           /* filler bytes for pixel expansion */
1295
#endif
1296
#endif
1297

1298
#if defined(PNG_bKGD_SUPPORTED)
G
Guy Schalnat 已提交
1299
   png_byte background_gamma_type;
1300
#  ifdef PNG_FLOATING_POINT_SUPPORTED
G
Guy Schalnat 已提交
1301
   float background_gamma;
1302
#  endif
A
Andreas Dilger 已提交
1303
   png_color_16 background;   /* background color in screen gamma space */
1304 1305 1306
#if defined(PNG_READ_GAMMA_SUPPORTED)
   png_color_16 background_1; /* background normalized to gamma 1.0 */
#endif
1307
#endif /* PNG_bKGD_SUPPORTED */
1308

G
Guy Schalnat 已提交
1309
#if defined(PNG_WRITE_FLUSH_SUPPORTED)
1310
   png_flush_ptr output_flush_fn; /* Function for flushing output */
A
Andreas Dilger 已提交
1311 1312
   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 */
1313 1314
#endif

1315
#if defined(PNG_READ_GAMMA_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED)
1316
   int gamma_shift;      /* number of "insignificant" bits 16-bit gamma */
1317
#ifdef PNG_FLOATING_POINT_SUPPORTED
1318
   float gamma;          /* file gamma value */
1319
   float screen_gamma;   /* screen gamma value (display_exponent) */
1320 1321 1322
#endif
#endif

G
Guy Schalnat 已提交
1323
#if defined(PNG_READ_GAMMA_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED)
1324
   png_bytep gamma_table;     /* gamma table for 8-bit depth files */
A
Andreas Dilger 已提交
1325 1326
   png_bytep gamma_from_1;    /* converts from 1.0 to screen */
   png_bytep gamma_to_1;      /* converts from file to 1.0 */
1327
   png_uint_16pp gamma_16_table; /* gamma table for 16-bit depth files */
G
Guy Schalnat 已提交
1328 1329
   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 */
1330 1331
#endif

1332
#if defined(PNG_READ_GAMMA_SUPPORTED) || defined(PNG_sBIT_SUPPORTED)
A
Andreas Dilger 已提交
1333
   png_color_8 sig_bit;       /* significant bits in each available channel */
1334 1335
#endif

A
Andreas Dilger 已提交
1336 1337
#if defined(PNG_READ_SHIFT_SUPPORTED) || defined(PNG_WRITE_SHIFT_SUPPORTED)
   png_color_8 shift;         /* shift for significant bit tranformation */
1338 1339
#endif

1340
#if defined(PNG_tRNS_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED) \
1341
 || defined(PNG_READ_EXPAND_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED)
A
Andreas Dilger 已提交
1342
   png_bytep trans;           /* transparency values for paletted files */
G
Guy Schalnat 已提交
1343
   png_color_16 trans_values; /* transparency values for non-paletted files */
1344 1345
#endif

1346 1347
   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 已提交
1348
#ifdef PNG_PROGRESSIVE_READ_SUPPORTED
A
Andreas Dilger 已提交
1349
   png_progressive_info_ptr info_fn; /* called after header data fully read */
1350
   png_progressive_row_ptr row_fn;   /* called after each prog. row is decoded */
A
Andreas Dilger 已提交
1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363
   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 */
1364

1365
#  if defined(PNG_TEXT_SUPPORTED)
1366 1367 1368 1369
     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 */
1370
#  endif /* PNG_TEXT_SUPPORTED */
1371
#endif /* PNG_PROGRESSIVE_READ_SUPPORTED */
1372

G
Guy Schalnat 已提交
1373 1374 1375 1376 1377 1378 1379
#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;
1380 1381
#endif

G
Guy Schalnat 已提交
1382
#if defined(PNG_READ_DITHER_SUPPORTED)
A
Andreas Dilger 已提交
1383 1384
   png_bytep palette_lookup;         /* lookup table for dithering */
   png_bytep dither_index;           /* index translation for palette files */
1385 1386
#endif

1387
#if defined(PNG_READ_DITHER_SUPPORTED) || defined(PNG_hIST_SUPPORTED)
1388 1389
   png_uint_16p hist;                /* histogram */
#endif
1390

A
Andreas Dilger 已提交
1391 1392 1393 1394 1395 1396 1397 1398
#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 */
1399 1400
#endif

1401 1402
#if defined(PNG_TIME_RFC1123_SUPPORTED)
   png_charp time_buffer;            /* String to hold RFC 1123 time text */
1403 1404
#endif

1405 1406 1407
/* New members added in libpng-1.0.6 */

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

1411
#if defined(PNG_USER_CHUNKS_SUPPORTED)
1412 1413 1414 1415
   png_voidp user_chunk_ptr;
   png_user_chunk_ptr read_user_chunk_fn; /* user read chunk handler */
#endif

1416
#ifdef PNG_HANDLE_AS_UNKNOWN_SUPPORTED
1417 1418 1419 1420
   int num_chunk_list;
   png_bytep chunk_list;
#endif

1421
/* New members added in libpng-1.0.3 */
1422 1423
#if defined(PNG_READ_RGB_TO_GRAY_SUPPORTED)
   png_byte rgb_to_gray_status;
1424
   /* These were changed from png_byte in libpng-1.0.6 */
1425 1426 1427
   png_uint_16 rgb_to_gray_red_coeff;
   png_uint_16 rgb_to_gray_green_coeff;
   png_uint_16 rgb_to_gray_blue_coeff;
1428
#endif
1429

1430
/* New member added in libpng-1.0.4 (renamed in 1.0.9) */
1431 1432
#if defined(PNG_MNG_FEATURES_SUPPORTED) || \
    defined(PNG_READ_EMPTY_PLTE_SUPPORTED) || \
1433
    defined(PNG_WRITE_EMPTY_PLTE_SUPPORTED)
1434
/* changed from png_byte to png_uint_32 at version 1.2.0 */
1435 1436 1437
#ifdef PNG_1_0_X
   png_byte mng_features_permitted;
#else
1438
   png_uint_32 mng_features_permitted;
1439
#endif /* PNG_1_0_X */
1440
#endif
1441

1442
/* New member added in libpng-1.0.7 */
1443 1444 1445 1446
#if defined(PNG_READ_GAMMA_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED)
   png_fixed_point int_gamma;
#endif

1447 1448
/* 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)
1449
   png_byte filter_type;
1450
#endif
1451

1452
#if defined(PNG_1_0_X)
1453 1454 1455 1456 1457
/* 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 */
1458 1459 1460
#if defined(PNG_ASSEMBLER_CODE_SUPPORTED)
#  if !defined(PNG_1_0_X)
#    if defined(PNG_MMX_CODE_SUPPORTED)
1461 1462
   png_byte     mmx_bitdepth_threshold;
   png_uint_32  mmx_rowbytes_threshold;
1463
#    endif
1464
   png_uint_32  asm_flags;
1465
#  endif
1466 1467
#endif

1468 1469
/* New members added in libpng-1.0.2 but first enabled by default in 1.2.0 */
#ifdef PNG_USER_MEM_SUPPORTED
1470 1471 1472
   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 */
1473
#endif
1474

1475
/* New member added in libpng-1.0.13 and 1.2.0 */
1476
   png_bytep big_row_buf;        /* buffer to save current (unfiltered) row */
1477

1478
#if defined(PNG_READ_DITHER_SUPPORTED)
1479
/* The following three members were added at version 1.0.14 and 1.2.4 */
1480 1481 1482 1483 1484
   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 */
1485
#endif
1486 1487

/* New members added in libpng-1.0.16 and 1.2.6 */
1488
   png_byte compression_type;
1489

1490 1491 1492 1493 1494
#ifdef PNG_SET_USER_LIMITS_SUPPORTED
   png_uint_32 user_width_max;
   png_uint_32 user_height_max;
#endif

1495 1496
/* New member added in libpng-1.0.25 and 1.2.17 */
#if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED)
1497
   /* Storage for unknown chunk that the library doesn't recognize. */
1498 1499
   png_unknown_chunk unknown_chunk;
#endif
1500 1501 1502

/* New members added in libpng-1.2.26 */
  png_uint_32 old_big_row_buf_size, old_prev_row_size;
1503

1504 1505 1506
/* New member added in libpng-1.2.30 */
  png_charp chunkdata;  /* buffer for reading chunk data */

G
Guy Schalnat 已提交
1507
};
G
Guy Schalnat 已提交
1508

1509

1510 1511
/* This triggers a compiler error in png.c, if png.c and png.h
 * do not agree upon the version number.
1512
 */
1513
typedef png_structp version_1_2_39beta04;
1514

A
Andreas Dilger 已提交
1515
typedef png_struct FAR * FAR * png_structpp;
G
Guy Schalnat 已提交
1516

G
Guy Schalnat 已提交
1517
/* Here are the function definitions most commonly used.  This is not
A
Andreas Dilger 已提交
1518 1519
 * 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
1520
 * a simple one line description of the use of each function.
A
Andreas Dilger 已提交
1521
 */
G
Guy Schalnat 已提交
1522

1523 1524 1525
/* Returns the version number of the library */
extern PNG_EXPORT(png_uint_32,png_access_version_number) PNGARG((void));

A
Andreas Dilger 已提交
1526
/* Tell lib we have already handled the first <num_bytes> magic bytes.
A
Andreas Dilger 已提交
1527 1528 1529 1530 1531 1532 1533 1534 1535 1536 1537 1538 1539 1540 1541 1542 1543
 * 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 已提交
1544

A
Andreas Dilger 已提交
1545 1546
/* Allocate and initialize png_ptr struct for reading, and any other memory. */
extern PNG_EXPORT(png_structp,png_create_read_struct)
1547
   PNGARG((png_const_charp user_png_ver, png_voidp error_ptr,
1548
   png_error_ptr error_fn, png_error_ptr warn_fn));
A
Andreas Dilger 已提交
1549

1550
/* Allocate and initialize png_ptr struct for writing, and any other memory */
A
Andreas Dilger 已提交
1551
extern PNG_EXPORT(png_structp,png_create_write_struct)
1552
   PNGARG((png_const_charp user_png_ver, png_voidp error_ptr,
A
Andreas Dilger 已提交
1553
   png_error_ptr error_fn, png_error_ptr warn_fn));
G
Guy Schalnat 已提交
1554

1555
#ifdef PNG_WRITE_SUPPORTED
1556 1557
extern PNG_EXPORT(png_uint_32,png_get_compression_buffer_size)
   PNGARG((png_structp png_ptr));
1558
#endif
1559

1560
#ifdef PNG_WRITE_SUPPORTED
1561 1562
extern PNG_EXPORT(void,png_set_compression_buffer_size)
   PNGARG((png_structp png_ptr, png_uint_32 size));
1563
#endif
1564 1565 1566 1567

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

1568
/* New functions added in libpng-1.0.2 (not enabled by default until 1.2.0) */
1569 1570 1571 1572 1573 1574
#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)
1575
   PNGARG((png_const_charp user_png_ver, png_voidp error_ptr,
1576 1577 1578 1579
   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

1580 1581 1582 1583 1584 1585 1586 1587 1588 1589 1590 1591 1592 1593 1594
/* 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 已提交
1595 1596 1597
/* Allocate and initialize the info structure */
extern PNG_EXPORT(png_infop,png_create_info_struct)
   PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
1598

1599
#if defined(PNG_1_0_X) || defined (PNG_1_2_X)
1600 1601
/* Initialize the info structure (old interface - DEPRECATED) */
extern PNG_EXPORT(void,png_info_init) PNGARG((png_infop info_ptr));
1602
#undef png_info_init
1603 1604
#define png_info_init(info_ptr) png_info_init_3(&info_ptr,\
    png_sizeof(png_info));
1605 1606
#endif

1607 1608
extern PNG_EXPORT(void,png_info_init_3) PNGARG((png_infopp info_ptr,
    png_size_t png_info_struct_size));
G
Guy Schalnat 已提交
1609

A
Andreas Dilger 已提交
1610
/* Writes all the PNG information before the image. */
1611 1612
extern PNG_EXPORT(void,png_write_info_before_PLTE) PNGARG((png_structp png_ptr,
   png_infop info_ptr));
A
Andreas Dilger 已提交
1613 1614
extern PNG_EXPORT(void,png_write_info) PNGARG((png_structp png_ptr,
   png_infop info_ptr));
G
Guy Schalnat 已提交
1615

1616
#ifndef PNG_NO_SEQUENTIAL_READ_SUPPORTED
1617
/* Read the information before the actual image data. */
A
Andreas Dilger 已提交
1618 1619
extern PNG_EXPORT(void,png_read_info) PNGARG((png_structp png_ptr,
   png_infop info_ptr));
1620
#endif
G
Guy Schalnat 已提交
1621

1622 1623
#if defined(PNG_TIME_RFC1123_SUPPORTED)
extern PNG_EXPORT(png_charp,png_convert_to_rfc1123)
1624
   PNGARG((png_structp png_ptr, png_timep ptime));
1625
#endif
1626

1627 1628
#if !defined(_WIN32_WCE)
/* "time.h" functions are not supported on WindowsCE */
G
Guy Schalnat 已提交
1629
#if defined(PNG_WRITE_tIME_SUPPORTED)
1630
/* Convert from a struct tm to png_time */
A
Andreas Dilger 已提交
1631
extern PNG_EXPORT(void,png_convert_from_struct_tm) PNGARG((png_timep ptime,
G
Guy Schalnat 已提交
1632
   struct tm FAR * ttime));
G
Guy Schalnat 已提交
1633

1634
/* Convert from time_t to png_time.  Uses gmtime() */
A
Andreas Dilger 已提交
1635 1636 1637
extern PNG_EXPORT(void,png_convert_from_time_t) PNGARG((png_timep ptime,
   time_t ttime));
#endif /* PNG_WRITE_tIME_SUPPORTED */
1638
#endif /* _WIN32_WCE */
G
Guy Schalnat 已提交
1639

G
Guy Schalnat 已提交
1640
#if defined(PNG_READ_EXPAND_SUPPORTED)
1641
/* Expand data to 24-bit RGB, or 8-bit grayscale, with alpha if available. */
A
Andreas Dilger 已提交
1642
extern PNG_EXPORT(void,png_set_expand) PNGARG((png_structp png_ptr));
1643 1644 1645 1646
#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
1647 1648
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));
1649 1650 1651 1652
#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
1653
#endif
G
Guy Schalnat 已提交
1654

G
Guy Schalnat 已提交
1655
#if defined(PNG_READ_BGR_SUPPORTED) || defined(PNG_WRITE_BGR_SUPPORTED)
G
Guy Schalnat 已提交
1656
/* Use blue, green, red order for pixels. */
A
Andreas Dilger 已提交
1657
extern PNG_EXPORT(void,png_set_bgr) PNGARG((png_structp png_ptr));
1658
#endif
G
Guy Schalnat 已提交
1659

G
Guy Schalnat 已提交
1660
#if defined(PNG_READ_GRAY_TO_RGB_SUPPORTED)
1661
/* Expand the grayscale to 24-bit RGB if necessary. */
A
Andreas Dilger 已提交
1662
extern PNG_EXPORT(void,png_set_gray_to_rgb) PNGARG((png_structp png_ptr));
1663
#endif
G
Guy Schalnat 已提交
1664

A
Andreas Dilger 已提交
1665
#if defined(PNG_READ_RGB_TO_GRAY_SUPPORTED)
1666
/* Reduce RGB to grayscale. */
1667
#ifdef PNG_FLOATING_POINT_SUPPORTED
1668
extern PNG_EXPORT(void,png_set_rgb_to_gray) PNGARG((png_structp png_ptr,
1669
   int error_action, double red, double green ));
1670
#endif
1671 1672
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 ));
1673 1674
extern PNG_EXPORT(png_byte,png_get_rgb_to_gray_status) PNGARG((png_structp
   png_ptr));
1675
#endif
A
Andreas Dilger 已提交
1676

A
Andreas Dilger 已提交
1677
extern PNG_EXPORT(void,png_build_grayscale_palette) PNGARG((int bit_depth,
A
Andreas Dilger 已提交
1678 1679
   png_colorp palette));

A
Andreas Dilger 已提交
1680 1681
#if defined(PNG_READ_STRIP_ALPHA_SUPPORTED)
extern PNG_EXPORT(void,png_set_strip_alpha) PNGARG((png_structp png_ptr));
1682
#endif
G
Guy Schalnat 已提交
1683

A
Andreas Dilger 已提交
1684 1685 1686
#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));
1687
#endif
G
Guy Schalnat 已提交
1688

1689 1690 1691
#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));
1692
#endif
1693

A
Andreas Dilger 已提交
1694
#if defined(PNG_READ_FILLER_SUPPORTED) || defined(PNG_WRITE_FILLER_SUPPORTED)
1695
/* Add a filler byte to 8-bit Gray or 24-bit RGB images. */
A
Andreas Dilger 已提交
1696 1697 1698 1699 1700
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
1701 1702 1703 1704 1705
/* 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 已提交
1706
#endif /* PNG_READ_FILLER_SUPPORTED || PNG_WRITE_FILLER_SUPPORTED */
G
Guy Schalnat 已提交
1707

G
Guy Schalnat 已提交
1708
#if defined(PNG_READ_SWAP_SUPPORTED) || defined(PNG_WRITE_SWAP_SUPPORTED)
1709
/* Swap bytes in 16-bit depth files. */
A
Andreas Dilger 已提交
1710
extern PNG_EXPORT(void,png_set_swap) PNGARG((png_structp png_ptr));
1711
#endif
G
Guy Schalnat 已提交
1712

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

1718
#if defined(PNG_READ_PACKSWAP_SUPPORTED) || defined(PNG_WRITE_PACKSWAP_SUPPORTED)
A
Andreas Dilger 已提交
1719 1720
/* Swap packing order of pixels in bytes. */
extern PNG_EXPORT(void,png_set_packswap) PNGARG((png_structp png_ptr));
1721
#endif
G
Guy Schalnat 已提交
1722

G
Guy Schalnat 已提交
1723
#if defined(PNG_READ_SHIFT_SUPPORTED) || defined(PNG_WRITE_SHIFT_SUPPORTED)
G
Guy Schalnat 已提交
1724
/* Converts files to legal bit depths. */
A
Andreas Dilger 已提交
1725
extern PNG_EXPORT(void,png_set_shift) PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
1726
   png_color_8p true_bits));
1727
#endif
G
Guy Schalnat 已提交
1728

G
Guy Schalnat 已提交
1729 1730
#if defined(PNG_READ_INTERLACING_SUPPORTED) || \
    defined(PNG_WRITE_INTERLACING_SUPPORTED)
G
Guy Schalnat 已提交
1731
/* Have the code handle the interlacing.  Returns the number of passes. */
A
Andreas Dilger 已提交
1732
extern PNG_EXPORT(int,png_set_interlace_handling) PNGARG((png_structp png_ptr));
1733
#endif
G
Guy Schalnat 已提交
1734

G
Guy Schalnat 已提交
1735
#if defined(PNG_READ_INVERT_SUPPORTED) || defined(PNG_WRITE_INVERT_SUPPORTED)
1736
/* Invert monochrome files */
A
Andreas Dilger 已提交
1737
extern PNG_EXPORT(void,png_set_invert_mono) PNGARG((png_structp png_ptr));
1738
#endif
G
Guy Schalnat 已提交
1739

G
Guy Schalnat 已提交
1740
#if defined(PNG_READ_BACKGROUND_SUPPORTED)
G
Guy Schalnat 已提交
1741
/* Handle alpha and tRNS by replacing with a background color. */
1742
#ifdef PNG_FLOATING_POINT_SUPPORTED
A
Andreas Dilger 已提交
1743 1744 1745
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));
1746
#endif
G
Guy Schalnat 已提交
1747 1748 1749 1750
#define PNG_BACKGROUND_GAMMA_UNKNOWN 0
#define PNG_BACKGROUND_GAMMA_SCREEN  1
#define PNG_BACKGROUND_GAMMA_FILE    2
#define PNG_BACKGROUND_GAMMA_UNIQUE  3
1751
#endif
G
Guy Schalnat 已提交
1752

G
Guy Schalnat 已提交
1753
#if defined(PNG_READ_16_TO_8_SUPPORTED)
1754
/* Strip the second byte of information from a 16-bit depth file. */
A
Andreas Dilger 已提交
1755
extern PNG_EXPORT(void,png_set_strip_16) PNGARG((png_structp png_ptr));
1756
#endif
G
Guy Schalnat 已提交
1757

G
Guy Schalnat 已提交
1758
#if defined(PNG_READ_DITHER_SUPPORTED)
G
Guy Schalnat 已提交
1759
/* Turn on dithering, and reduce the palette to the number of colors available. */
A
Andreas Dilger 已提交
1760 1761 1762
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));
1763
#endif
G
Guy Schalnat 已提交
1764

G
Guy Schalnat 已提交
1765
#if defined(PNG_READ_GAMMA_SUPPORTED)
1766
/* Handle gamma correction. Screen_gamma=(display_exponent) */
1767
#ifdef PNG_FLOATING_POINT_SUPPORTED
A
Andreas Dilger 已提交
1768 1769
extern PNG_EXPORT(void,png_set_gamma) PNGARG((png_structp png_ptr,
   double screen_gamma, double default_file_gamma));
1770 1771
#endif
#endif
G
Guy Schalnat 已提交
1772

1773
#if defined(PNG_1_0_X) || defined (PNG_1_2_X)
1774 1775 1776
#if defined(PNG_READ_EMPTY_PLTE_SUPPORTED) || \
    defined(PNG_WRITE_EMPTY_PLTE_SUPPORTED)
/* Permit or disallow empty PLTE (0: not permitted, 1: permitted) */
1777
/* Deprecated and will be removed.  Use png_permit_mng_features() instead. */
1778 1779
extern PNG_EXPORT(void,png_permit_empty_plte) PNGARG((png_structp png_ptr,
   int empty_plte_permitted));
1780
#endif
1781
#endif
1782

G
Guy Schalnat 已提交
1783 1784
#if defined(PNG_WRITE_FLUSH_SUPPORTED)
/* Set how many lines between output flushes - 0 for no flushing */
A
Andreas Dilger 已提交
1785
extern PNG_EXPORT(void,png_set_flush) PNGARG((png_structp png_ptr, int nrows));
G
Guy Schalnat 已提交
1786
/* Flush the current PNG output buffer */
A
Andreas Dilger 已提交
1787
extern PNG_EXPORT(void,png_write_flush) PNGARG((png_structp png_ptr));
1788
#endif
G
Guy Schalnat 已提交
1789

1790
/* Optional update palette with requested transformations */
A
Andreas Dilger 已提交
1791
extern PNG_EXPORT(void,png_start_read_image) PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
1792

1793
/* Optional call to update the users info structure */
A
Andreas Dilger 已提交
1794
extern PNG_EXPORT(void,png_read_update_info) PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
1795
   png_infop info_ptr));
G
Guy Schalnat 已提交
1796

1797
#ifndef PNG_NO_SEQUENTIAL_READ_SUPPORTED
1798
/* Read one or more rows of image data. */
A
Andreas Dilger 已提交
1799 1800
extern PNG_EXPORT(void,png_read_rows) PNGARG((png_structp png_ptr,
   png_bytepp row, png_bytepp display_row, png_uint_32 num_rows));
1801
#endif
G
Guy Schalnat 已提交
1802

1803
#ifndef PNG_NO_SEQUENTIAL_READ_SUPPORTED
1804
/* Read a row of data. */
A
Andreas Dilger 已提交
1805
extern PNG_EXPORT(void,png_read_row) PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
1806 1807
   png_bytep row,
   png_bytep display_row));
1808
#endif
G
Guy Schalnat 已提交
1809

1810
#ifndef PNG_NO_SEQUENTIAL_READ_SUPPORTED
1811
/* Read the whole image into memory at once. */
A
Andreas Dilger 已提交
1812
extern PNG_EXPORT(void,png_read_image) PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
1813
   png_bytepp image));
1814
#endif
G
Guy Schalnat 已提交
1815

1816
/* Write a row of image data */
A
Andreas Dilger 已提交
1817
extern PNG_EXPORT(void,png_write_row) PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
1818
   png_bytep row));
G
Guy Schalnat 已提交
1819

1820
/* Write a few rows of image data */
A
Andreas Dilger 已提交
1821 1822
extern PNG_EXPORT(void,png_write_rows) PNGARG((png_structp png_ptr,
   png_bytepp row, png_uint_32 num_rows));
G
Guy Schalnat 已提交
1823

1824
/* Write the image data */
A
Andreas Dilger 已提交
1825 1826
extern PNG_EXPORT(void,png_write_image) PNGARG((png_structp png_ptr,
   png_bytepp image));
G
Guy Schalnat 已提交
1827

1828
/* Writes the end of the PNG file. */
A
Andreas Dilger 已提交
1829 1830
extern PNG_EXPORT(void,png_write_end) PNGARG((png_structp png_ptr,
   png_infop info_ptr));
G
Guy Schalnat 已提交
1831

1832
#ifndef PNG_NO_SEQUENTIAL_READ_SUPPORTED
1833
/* Read the end of the PNG file. */
A
Andreas Dilger 已提交
1834 1835
extern PNG_EXPORT(void,png_read_end) PNGARG((png_structp png_ptr,
   png_infop info_ptr));
1836
#endif
G
Guy Schalnat 已提交
1837

1838
/* Free any memory associated with the png_info_struct */
A
Andreas Dilger 已提交
1839
extern PNG_EXPORT(void,png_destroy_info_struct) PNGARG((png_structp png_ptr,
A
Andreas Dilger 已提交
1840
   png_infopp info_ptr_ptr));
G
Guy Schalnat 已提交
1841

1842
/* Free any memory associated with the png_struct and the png_info_structs */
A
Andreas Dilger 已提交
1843 1844
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 已提交
1845

1846
/* Free all memory used by the read (old method - NOT DLL EXPORTED) */
A
Andreas Dilger 已提交
1847 1848
extern void png_read_destroy PNGARG((png_structp png_ptr, png_infop info_ptr,
   png_infop end_info_ptr));
G
Guy Schalnat 已提交
1849

1850
/* Free any memory associated with the png_struct and the png_info_structs */
A
Andreas Dilger 已提交
1851 1852
extern PNG_EXPORT(void,png_destroy_write_struct)
   PNGARG((png_structpp png_ptr_ptr, png_infopp info_ptr_ptr));
G
Guy Schalnat 已提交
1853

1854
/* Free any memory used in png_ptr struct (old method - NOT DLL EXPORTED) */
G
Guy Schalnat 已提交
1855
extern void png_write_destroy PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
1856

1857
/* Set the libpng method of handling chunk CRC errors */
A
Andreas Dilger 已提交
1858 1859
extern PNG_EXPORT(void,png_set_crc_action) PNGARG((png_structp png_ptr,
   int crit_action, int ancil_action));
A
Andreas Dilger 已提交
1860 1861

/* Values for png_set_crc_action() to say how to handle CRC errors in
A
Andreas Dilger 已提交
1862 1863 1864 1865 1866 1867 1868
 * 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 已提交
1869 1870 1871 1872 1873 1874 1875 1876
 */
#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 已提交
1877 1878 1879 1880 1881
/* 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
1882 1883
 * header file (zlib.h) for an explination of the compression functions.
 */
A
Andreas Dilger 已提交
1884

1885
/* Set the filtering method(s) used by libpng.  Currently, the only valid
1886 1887
 * value for "method" is 0.
 */
A
Andreas Dilger 已提交
1888
extern PNG_EXPORT(void,png_set_filter) PNGARG((png_structp png_ptr, int method,
G
Guy Schalnat 已提交
1889
   int filters));
G
Guy Schalnat 已提交
1890

A
Andreas Dilger 已提交
1891
/* Flags for png_set_filter() to say which filters to use.  The flags
A
Andreas Dilger 已提交
1892 1893 1894
 * 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 已提交
1895 1896 1897 1898 1899 1900 1901 1902 1903 1904
 */
#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 已提交
1905 1906 1907 1908 1909 1910 1911 1912 1913 1914 1915 1916 1917 1918 1919 1920 1921 1922 1923 1924 1925 1926 1927 1928 1929 1930 1931 1932 1933 1934 1935 1936 1937 1938 1939 1940 1941 1942 1943
/* 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.
 */
1944
#ifdef PNG_FLOATING_POINT_SUPPORTED
A
Andreas Dilger 已提交
1945 1946 1947
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));
1948
#endif
A
Andreas Dilger 已提交
1949 1950 1951 1952 1953 1954 1955 1956 1957 1958 1959 1960 1961 1962 1963 1964 1965 1966
#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 已提交
1967 1968
   int level));

A
Andreas Dilger 已提交
1969 1970
extern PNG_EXPORT(void,png_set_compression_mem_level)
   PNGARG((png_structp png_ptr, int mem_level));
G
Guy Schalnat 已提交
1971

A
Andreas Dilger 已提交
1972 1973
extern PNG_EXPORT(void,png_set_compression_strategy)
   PNGARG((png_structp png_ptr, int strategy));
G
Guy Schalnat 已提交
1974

A
Andreas Dilger 已提交
1975 1976
extern PNG_EXPORT(void,png_set_compression_window_bits)
   PNGARG((png_structp png_ptr, int window_bits));
G
Guy Schalnat 已提交
1977

A
Andreas Dilger 已提交
1978
extern PNG_EXPORT(void,png_set_compression_method) PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
1979
   int method));
G
Guy Schalnat 已提交
1980

G
Guy Schalnat 已提交
1981
/* These next functions are called for input/output, memory, and error
A
Andreas Dilger 已提交
1982 1983 1984 1985 1986 1987 1988
 * 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 已提交
1989

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

A
Andreas Dilger 已提交
1995
/* Replace the (error and abort), and warning functions with user
A
Andreas Dilger 已提交
1996 1997 1998 1999 2000 2001
 * 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.
 */
2002

A
Andreas Dilger 已提交
2003 2004
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 已提交
2005

G
Guy Schalnat 已提交
2006
/* Return the user pointer associated with the error functions */
A
Andreas Dilger 已提交
2007
extern PNG_EXPORT(png_voidp,png_get_error_ptr) PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
2008 2009

/* Replace the default data output functions with a user supplied one(s).
A
Andreas Dilger 已提交
2010 2011 2012
 * 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).
2013 2014 2015 2016 2017
 * It is probably a mistake to use NULL for output_flush_fn if
 * write_data_fn is not also NULL unless you have built libpng with
 * PNG_WRITE_FLUSH_SUPPORTED undefined, because in this case libpng's
 * default flush function, which uses the standard *FILE structure, will
 * be used.
A
Andreas Dilger 已提交
2018 2019 2020
 */
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 已提交
2021 2022

/* Replace the default data input function with a user supplied one. */
A
Andreas Dilger 已提交
2023 2024
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 已提交
2025 2026

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

2029 2030 2031 2032 2033 2034
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));

2035 2036 2037 2038 2039 2040
#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));
2041
#endif
2042

2043 2044
#if defined(PNG_READ_USER_TRANSFORM_SUPPORTED) || \
    defined(PNG_LEGACY_SUPPORTED)
2045 2046 2047 2048
extern PNG_EXPORT(void,png_set_read_user_transform_fn) PNGARG((png_structp
   png_ptr, png_user_transform_ptr read_user_transform_fn));
#endif

2049 2050
#if defined(PNG_WRITE_USER_TRANSFORM_SUPPORTED) || \
    defined(PNG_LEGACY_SUPPORTED)
2051 2052 2053 2054
extern PNG_EXPORT(void,png_set_write_user_transform_fn) PNGARG((png_structp
   png_ptr, png_user_transform_ptr write_user_transform_fn));
#endif

2055
#if defined(PNG_READ_USER_TRANSFORM_SUPPORTED) || \
2056 2057
    defined(PNG_WRITE_USER_TRANSFORM_SUPPORTED) || \
    defined(PNG_LEGACY_SUPPORTED)
2058 2059 2060 2061 2062 2063 2064 2065
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

2066
#ifdef PNG_USER_CHUNKS_SUPPORTED
2067 2068 2069 2070 2071 2072
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 已提交
2073
#ifdef PNG_PROGRESSIVE_READ_SUPPORTED
A
Andreas Dilger 已提交
2074 2075 2076 2077 2078
/* 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 已提交
2079 2080
   png_progressive_info_ptr info_fn, png_progressive_row_ptr row_fn,
   png_progressive_end_ptr end_fn));
G
Guy Schalnat 已提交
2081

2082
/* Returns the user pointer associated with the push read functions */
A
Andreas Dilger 已提交
2083 2084 2085
extern PNG_EXPORT(png_voidp,png_get_progressive_ptr)
   PNGARG((png_structp png_ptr));

2086
/* Function to be called when data becomes available */
A
Andreas Dilger 已提交
2087 2088 2089
extern PNG_EXPORT(void,png_process_data) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_bytep buffer, png_size_t buffer_size));

2090
/* function that combines rows.  Not very much different than the
A
Andreas Dilger 已提交
2091 2092 2093 2094
 * 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 已提交
2095
#endif /* PNG_PROGRESSIVE_READ_SUPPORTED */
G
Guy Schalnat 已提交
2096

A
Andreas Dilger 已提交
2097
extern PNG_EXPORT(png_voidp,png_malloc) PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
2098
   png_uint_32 size));
G
Guy Schalnat 已提交
2099

2100 2101 2102
#if defined(PNG_1_0_X)
#  define png_malloc_warn png_malloc
#else
2103 2104 2105
/* Added at libpng version 1.2.4 */
extern PNG_EXPORT(png_voidp,png_malloc_warn) PNGARG((png_structp png_ptr,
   png_uint_32 size));
2106
#endif
2107

2108
/* Frees a pointer allocated by png_malloc() */
A
Andreas Dilger 已提交
2109 2110
extern PNG_EXPORT(void,png_free) PNGARG((png_structp png_ptr, png_voidp ptr));

2111 2112 2113 2114 2115 2116 2117 2118 2119
#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

2120
/* Free data that was allocated internally */
2121 2122
extern PNG_EXPORT(void,png_free_data) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_uint_32 free_me, int num));
2123
#ifdef PNG_FREE_ME_SUPPORTED
2124
/* Reassign responsibility for freeing existing data, whether allocated
2125 2126
 * by libpng or by the application
 */
2127 2128
extern PNG_EXPORT(void,png_data_freer) PNGARG((png_structp png_ptr,
   png_infop info_ptr, int freer, png_uint_32 mask));
2129
#endif
2130
/* Assignments for png_data_freer */
2131 2132 2133 2134
#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 */
2135 2136 2137 2138
#define PNG_FREE_HIST 0x0008
#define PNG_FREE_ICCP 0x0010
#define PNG_FREE_SPLT 0x0020
#define PNG_FREE_ROWS 0x0040
2139 2140
#define PNG_FREE_PCAL 0x0080
#define PNG_FREE_SCAL 0x0100
2141 2142
#define PNG_FREE_UNKN 0x0200
#define PNG_FREE_LIST 0x0400
2143 2144 2145
#define PNG_FREE_PLTE 0x1000
#define PNG_FREE_TRNS 0x2000
#define PNG_FREE_TEXT 0x4000
2146
#define PNG_FREE_ALL  0x7fff
2147
#define PNG_FREE_MUL  0x4220 /* PNG_FREE_SPLT|PNG_FREE_TEXT|PNG_FREE_UNKN */
2148

2149 2150 2151 2152 2153
#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));
2154
#endif
2155

2156
extern PNG_EXPORT(png_voidp,png_memcpy_check) PNGARG((png_structp png_ptr,
2157 2158
   png_voidp s1, png_voidp s2, png_uint_32 size));

2159
extern PNG_EXPORT(png_voidp,png_memset_check) PNGARG((png_structp png_ptr,
2160 2161
   png_voidp s1, int value, png_uint_32 size));

A
Andreas Dilger 已提交
2162
#if defined(USE_FAR_KEYWORD)  /* memory model conversion function */
2163 2164
extern void *png_far_to_near PNGARG((png_structp png_ptr,png_voidp ptr,
   int check));
A
Andreas Dilger 已提交
2165
#endif /* USE_FAR_KEYWORD */
G
Guy Schalnat 已提交
2166

2167
#ifndef PNG_NO_ERROR_TEXT
A
Andreas Dilger 已提交
2168 2169
/* Fatal error in PNG image of libpng - can't continue */
extern PNG_EXPORT(void,png_error) PNGARG((png_structp png_ptr,
2170
   png_const_charp error_message));
G
Guy Schalnat 已提交
2171

2172 2173
/* The same, but the chunk name is prepended to the error string. */
extern PNG_EXPORT(void,png_chunk_error) PNGARG((png_structp png_ptr,
2174
   png_const_charp error_message));
2175 2176 2177 2178
#else
/* Fatal error in PNG image of libpng - can't continue */
extern PNG_EXPORT(void,png_err) PNGARG((png_structp png_ptr));
#endif
2179

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

2185
#ifdef PNG_READ_SUPPORTED
2186 2187
/* Non-fatal error in libpng, chunk name is prepended to message. */
extern PNG_EXPORT(void,png_chunk_warning) PNGARG((png_structp png_ptr,
2188
   png_const_charp warning_message));
2189 2190
#endif /* PNG_READ_SUPPORTED */
#endif /* PNG_NO_WARNINGS */
2191

A
Andreas Dilger 已提交
2192 2193 2194 2195 2196 2197 2198 2199 2200 2201 2202 2203
/* 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.
 */
2204
/* Returns "flag" if chunk data is valid in info_ptr. */
A
Andreas Dilger 已提交
2205 2206 2207
extern PNG_EXPORT(png_uint_32,png_get_valid) PNGARG((png_structp png_ptr,
png_infop info_ptr, png_uint_32 flag));

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

2212 2213
#if defined(PNG_INFO_IMAGE_SUPPORTED)
/* Returns row_pointers, which is an array of pointers to scanlines that was
2214 2215
 * returned from png_read_png().
 */
2216 2217 2218
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
2219 2220
 * by png_write_png().
 */
2221 2222 2223 2224
extern PNG_EXPORT(void,png_set_rows) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_bytepp row_pointers));
#endif

2225
/* Returns number of color channels in image. */
A
Andreas Dilger 已提交
2226 2227 2228
extern PNG_EXPORT(png_byte,png_get_channels) PNGARG((png_structp png_ptr,
png_infop info_ptr));

2229 2230 2231 2232 2233 2234 2235 2236 2237 2238 2239 2240 2241 2242 2243 2244 2245 2246 2247 2248 2249 2250 2251 2252 2253 2254 2255 2256 2257 2258 2259 2260
#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));
2261 2262 2263 2264
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));
2265 2266

/* Returns pixel aspect ratio, computed from pHYs chunk data.  */
2267
#ifdef PNG_FLOATING_POINT_SUPPORTED
2268 2269
extern PNG_EXPORT(float, png_get_pixel_aspect_ratio) PNGARG((png_structp
png_ptr, png_infop info_ptr));
2270
#endif
2271 2272

/* Returns image x, y offset in pixels or microns, from oFFs chunk data. */
2273
extern PNG_EXPORT(png_int_32, png_get_x_offset_pixels) PNGARG((png_structp
2274
png_ptr, png_infop info_ptr));
2275
extern PNG_EXPORT(png_int_32, png_get_y_offset_pixels) PNGARG((png_structp
2276
png_ptr, png_infop info_ptr));
2277
extern PNG_EXPORT(png_int_32, png_get_x_offset_microns) PNGARG((png_structp
2278
png_ptr, png_infop info_ptr));
2279
extern PNG_EXPORT(png_int_32, png_get_y_offset_microns) PNGARG((png_structp
2280 2281 2282 2283
png_ptr, png_infop info_ptr));

#endif /* PNG_EASY_ACCESS_SUPPORTED */

A
Andreas Dilger 已提交
2284 2285 2286 2287
/* 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));

2288
#if defined(PNG_bKGD_SUPPORTED)
A
Andreas Dilger 已提交
2289 2290
extern PNG_EXPORT(png_uint_32,png_get_bKGD) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_color_16p *background));
2291
#endif
A
Andreas Dilger 已提交
2292

2293
#if defined(PNG_bKGD_SUPPORTED)
A
Andreas Dilger 已提交
2294 2295
extern PNG_EXPORT(void,png_set_bKGD) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_color_16p background));
2296
#endif
A
Andreas Dilger 已提交
2297

2298
#if defined(PNG_cHRM_SUPPORTED)
2299
#ifdef PNG_FLOATING_POINT_SUPPORTED
A
Andreas Dilger 已提交
2300 2301 2302 2303
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));
2304 2305 2306
#endif
#ifdef PNG_FIXED_POINT_SUPPORTED
extern PNG_EXPORT(png_uint_32,png_get_cHRM_fixed) PNGARG((png_structp png_ptr,
2307 2308 2309 2310
   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));
2311 2312
#endif
#endif
A
Andreas Dilger 已提交
2313

2314 2315
#if defined(PNG_cHRM_SUPPORTED)
#ifdef PNG_FLOATING_POINT_SUPPORTED
A
Andreas Dilger 已提交
2316 2317 2318
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));
2319 2320 2321
#endif
#ifdef PNG_FIXED_POINT_SUPPORTED
extern PNG_EXPORT(void,png_set_cHRM_fixed) PNGARG((png_structp png_ptr,
2322 2323 2324 2325
   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));
2326 2327
#endif
#endif
A
Andreas Dilger 已提交
2328

2329
#if defined(PNG_gAMA_SUPPORTED)
2330
#ifdef PNG_FLOATING_POINT_SUPPORTED
A
Andreas Dilger 已提交
2331 2332
extern PNG_EXPORT(png_uint_32,png_get_gAMA) PNGARG((png_structp png_ptr,
   png_infop info_ptr, double *file_gamma));
2333 2334
#endif
extern PNG_EXPORT(png_uint_32,png_get_gAMA_fixed) PNGARG((png_structp png_ptr,
2335
   png_infop info_ptr, png_fixed_point *int_file_gamma));
2336
#endif
G
Guy Schalnat 已提交
2337

2338 2339
#if defined(PNG_gAMA_SUPPORTED)
#ifdef PNG_FLOATING_POINT_SUPPORTED
A
Andreas Dilger 已提交
2340 2341
extern PNG_EXPORT(void,png_set_gAMA) PNGARG((png_structp png_ptr,
   png_infop info_ptr, double file_gamma));
2342 2343
#endif
extern PNG_EXPORT(void,png_set_gAMA_fixed) PNGARG((png_structp png_ptr,
2344
   png_infop info_ptr, png_fixed_point int_file_gamma));
2345
#endif
A
Andreas Dilger 已提交
2346

2347
#if defined(PNG_hIST_SUPPORTED)
A
Andreas Dilger 已提交
2348 2349
extern PNG_EXPORT(png_uint_32,png_get_hIST) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_uint_16p *hist));
2350
#endif
A
Andreas Dilger 已提交
2351

2352
#if defined(PNG_hIST_SUPPORTED)
A
Andreas Dilger 已提交
2353 2354
extern PNG_EXPORT(void,png_set_hIST) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_uint_16p hist));
2355
#endif
A
Andreas Dilger 已提交
2356 2357 2358

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,
2359 2360
   int *bit_depth, int *color_type, int *interlace_method,
   int *compression_method, int *filter_method));
2361

A
Andreas Dilger 已提交
2362 2363
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,
2364 2365
   int color_type, int interlace_method, int compression_method,
   int filter_method));
A
Andreas Dilger 已提交
2366

2367
#if defined(PNG_oFFs_SUPPORTED)
A
Andreas Dilger 已提交
2368
extern PNG_EXPORT(png_uint_32,png_get_oFFs) PNGARG((png_structp png_ptr,
2369
   png_infop info_ptr, png_int_32 *offset_x, png_int_32 *offset_y,
A
Andreas Dilger 已提交
2370
   int *unit_type));
2371
#endif
A
Andreas Dilger 已提交
2372

2373
#if defined(PNG_oFFs_SUPPORTED)
A
Andreas Dilger 已提交
2374
extern PNG_EXPORT(void,png_set_oFFs) PNGARG((png_structp png_ptr,
2375
   png_infop info_ptr, png_int_32 offset_x, png_int_32 offset_y,
A
Andreas Dilger 已提交
2376
   int unit_type));
2377
#endif
A
Andreas Dilger 已提交
2378

2379
#if defined(PNG_pCAL_SUPPORTED)
A
Andreas Dilger 已提交
2380 2381 2382
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));
2383
#endif
A
Andreas Dilger 已提交
2384

2385
#if defined(PNG_pCAL_SUPPORTED)
A
Andreas Dilger 已提交
2386 2387 2388
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));
2389 2390
#endif

2391
#if defined(PNG_pHYs_SUPPORTED)
A
Andreas Dilger 已提交
2392 2393
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));
2394
#endif
A
Andreas Dilger 已提交
2395

2396
#if defined(PNG_pHYs_SUPPORTED)
A
Andreas Dilger 已提交
2397 2398
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));
2399
#endif
A
Andreas Dilger 已提交
2400 2401 2402 2403 2404 2405 2406

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));

2407
#if defined(PNG_sBIT_SUPPORTED)
A
Andreas Dilger 已提交
2408 2409
extern PNG_EXPORT(png_uint_32,png_get_sBIT) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_color_8p *sig_bit));
2410
#endif
A
Andreas Dilger 已提交
2411

2412
#if defined(PNG_sBIT_SUPPORTED)
A
Andreas Dilger 已提交
2413 2414
extern PNG_EXPORT(void,png_set_sBIT) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_color_8p sig_bit));
2415
#endif
A
Andreas Dilger 已提交
2416

2417
#if defined(PNG_sRGB_SUPPORTED)
2418
extern PNG_EXPORT(png_uint_32,png_get_sRGB) PNGARG((png_structp png_ptr,
2419
   png_infop info_ptr, int *intent));
2420
#endif
2421

2422
#if defined(PNG_sRGB_SUPPORTED)
2423
extern PNG_EXPORT(void,png_set_sRGB) PNGARG((png_structp png_ptr,
2424
   png_infop info_ptr, int intent));
2425
extern PNG_EXPORT(void,png_set_sRGB_gAMA_and_cHRM) PNGARG((png_structp png_ptr,
2426
   png_infop info_ptr, int intent));
2427 2428
#endif

2429
#if defined(PNG_iCCP_SUPPORTED)
2430 2431
extern PNG_EXPORT(png_uint_32,png_get_iCCP) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_charpp name, int *compression_type,
2432
   png_charpp profile, png_uint_32 *proflen));
2433
   /* Note to maintainer: profile should be png_bytepp */
2434 2435 2436 2437 2438
#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,
2439
   png_charp profile, png_uint_32 proflen));
2440
   /* Note to maintainer: profile should be png_bytep */
2441 2442
#endif

2443
#if defined(PNG_sPLT_SUPPORTED)
2444
extern PNG_EXPORT(png_uint_32,png_get_sPLT) PNGARG((png_structp png_ptr,
2445
   png_infop info_ptr, png_sPLT_tpp entries));
2446 2447 2448
#endif

#if defined(PNG_sPLT_SUPPORTED)
2449
extern PNG_EXPORT(void,png_set_sPLT) PNGARG((png_structp png_ptr,
2450
   png_infop info_ptr, png_sPLT_tp entries, int nentries));
2451 2452
#endif

2453
#if defined(PNG_TEXT_SUPPORTED)
2454
/* png_get_text also returns the number of text chunks in *num_text */
A
Andreas Dilger 已提交
2455 2456
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));
2457
#endif
A
Andreas Dilger 已提交
2458

2459 2460 2461 2462 2463 2464 2465 2466
/*
 *  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.
 */

2467
#if defined(PNG_TEXT_SUPPORTED)
A
Andreas Dilger 已提交
2468 2469
extern PNG_EXPORT(void,png_set_text) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_textp text_ptr, int num_text));
2470
#endif
A
Andreas Dilger 已提交
2471

2472
#if defined(PNG_tIME_SUPPORTED)
A
Andreas Dilger 已提交
2473 2474
extern PNG_EXPORT(png_uint_32,png_get_tIME) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_timep *mod_time));
2475
#endif
A
Andreas Dilger 已提交
2476

2477
#if defined(PNG_tIME_SUPPORTED)
A
Andreas Dilger 已提交
2478 2479
extern PNG_EXPORT(void,png_set_tIME) PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_timep mod_time));
2480
#endif
A
Andreas Dilger 已提交
2481

2482
#if defined(PNG_tRNS_SUPPORTED)
A
Andreas Dilger 已提交
2483 2484 2485
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));
2486
#endif
A
Andreas Dilger 已提交
2487

2488
#if defined(PNG_tRNS_SUPPORTED)
A
Andreas Dilger 已提交
2489 2490 2491
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));
2492 2493
#endif

2494 2495 2496
#if defined(PNG_tRNS_SUPPORTED)
#endif

2497
#if defined(PNG_sCAL_SUPPORTED)
2498 2499
#ifdef PNG_FLOATING_POINT_SUPPORTED
extern PNG_EXPORT(png_uint_32,png_get_sCAL) PNGARG((png_structp png_ptr,
2500 2501 2502
   png_infop info_ptr, int *unit, double *width, double *height));
#else
#ifdef PNG_FIXED_POINT_SUPPORTED
2503
extern PNG_EXPORT(png_uint_32,png_get_sCAL_s) PNGARG((png_structp png_ptr,
2504 2505 2506
   png_infop info_ptr, int *unit, png_charpp swidth, png_charpp sheight));
#endif
#endif
2507
#endif /* PNG_sCAL_SUPPORTED */
2508

2509
#if defined(PNG_sCAL_SUPPORTED)
2510 2511
#ifdef PNG_FLOATING_POINT_SUPPORTED
extern PNG_EXPORT(void,png_set_sCAL) PNGARG((png_structp png_ptr,
2512
   png_infop info_ptr, int unit, double width, double height));
2513
#else
2514
#ifdef PNG_FIXED_POINT_SUPPORTED
2515
extern PNG_EXPORT(void,png_set_sCAL_s) PNGARG((png_structp png_ptr,
2516 2517
   png_infop info_ptr, int unit, png_charp swidth, png_charp sheight));
#endif
2518
#endif
2519
#endif /* PNG_sCAL_SUPPORTED || PNG_WRITE_sCAL_SUPPORTED */
2520

2521
#ifdef PNG_HANDLE_AS_UNKNOWN_SUPPORTED
2522
/* Provide a list of chunks and how they are to be handled, if the built-in
2523 2524 2525
   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.
2526
      keep = 0: follow default behaviour
2527 2528 2529 2530 2531 2532
           = 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));
2533 2534 2535 2536
PNG_EXPORT(int,png_handle_as_unknown) PNGARG((png_structp png_ptr, png_bytep
   chunk_name));
#endif
#if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED)
2537
extern PNG_EXPORT(void, png_set_unknown_chunks) PNGARG((png_structp png_ptr,
2538
   png_infop info_ptr, png_unknown_chunkp unknowns, int num_unknowns));
2539 2540
extern PNG_EXPORT(void, png_set_unknown_chunk_location)
   PNGARG((png_structp png_ptr, png_infop info_ptr, int chunk, int location));
2541 2542 2543 2544
extern PNG_EXPORT(png_uint_32,png_get_unknown_chunks) PNGARG((png_structp
   png_ptr, png_infop info_ptr, png_unknown_chunkpp entries));
#endif

2545
/* Png_free_data() will turn off the "valid" flag for anything it frees.
2546 2547 2548
 * 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);
 */
2549 2550 2551
extern PNG_EXPORT(void, png_set_invalid) PNGARG((png_structp png_ptr,
   png_infop info_ptr, int mask));

2552
#if defined(PNG_INFO_IMAGE_SUPPORTED)
2553
/* The "params" pointer is currently not used and is for future expansion. */
2554 2555 2556
extern PNG_EXPORT(void, png_read_png) PNGARG((png_structp png_ptr,
                        png_infop info_ptr,
                        int transforms,
2557
                        png_voidp params));
2558 2559 2560
extern PNG_EXPORT(void, png_write_png) PNGARG((png_structp png_ptr,
                        png_infop info_ptr,
                        int transforms,
2561
                        png_voidp params));
2562
#endif
A
Andreas Dilger 已提交
2563 2564 2565 2566 2567 2568

/* 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.
 */
2569
#ifdef PNG_DEBUG
A
Andreas Dilger 已提交
2570
#if (PNG_DEBUG > 0)
2571 2572
#if !defined(PNG_DEBUG_FILE) && defined(_MSC_VER)
#include <crtdbg.h>
2573
#if (PNG_DEBUG > 1)
2574 2575 2576 2577 2578 2579 2580 2581 2582 2583 2584 2585
#ifndef _DEBUG
#  define _DEBUG
#endif
#ifndef png_debug
#define png_debug(l,m)  _RPT0(_CRT_WARN,m PNG_STRING_NEWLINE)
#endif
#ifndef png_debug1
#define png_debug1(l,m,p1)  _RPT1(_CRT_WARN,m PNG_STRING_NEWLINE,p1)
#endif
#ifndef png_debug2
#define png_debug2(l,m,p1,p2) _RPT2(_CRT_WARN,m PNG_STRING_NEWLINE,p1,p2)
#endif
2586
#endif
2587
#else /* PNG_DEBUG_FILE || !_MSC_VER */
A
Andreas Dilger 已提交
2588 2589 2590
#ifndef PNG_DEBUG_FILE
#define PNG_DEBUG_FILE stderr
#endif /* PNG_DEBUG_FILE */
2591

2592
#if (PNG_DEBUG > 1)
2593 2594 2595
/* Note: ["%s"m PNG_STRING_NEWLINE] probably does not work on non-ISO
 * compilers.
 */
2596 2597 2598 2599 2600 2601 2602 2603 2604 2605 2606 2607 2608 2609 2610 2611 2612 2613 2614 2615 2616 2617 2618 2619 2620 2621 2622 2623 2624 2625 2626 2627 2628 2629 2630 2631 2632 2633 2634 2635 2636 2637 2638 2639 2640 2641 2642 2643 2644 2645 2646 2647 2648 2649 2650 2651 2652 2653 2654 2655
#  ifdef __STDC__
#    ifndef png_debug
#      define png_debug(l,m) \
       { \
       int num_tabs=l; \
       fprintf(PNG_DEBUG_FILE,"%s"m PNG_STRING_NEWLINE,(num_tabs==1 ? "\t" : \
         (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":"")))); \
       }
#    endif
#    ifndef png_debug1
#      define png_debug1(l,m,p1) \
       { \
       int num_tabs=l; \
       fprintf(PNG_DEBUG_FILE,"%s"m PNG_STRING_NEWLINE,(num_tabs==1 ? "\t" : \
         (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":""))),p1); \
       }
#    endif
#    ifndef png_debug2
#      define png_debug2(l,m,p1,p2) \
       { \
       int num_tabs=l; \
       fprintf(PNG_DEBUG_FILE,"%s"m PNG_STRING_NEWLINE,(num_tabs==1 ? "\t" : \
         (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":""))),p1,p2); \
       }
#    endif
#  else /* __STDC __ */
#    ifndef png_debug
#      define png_debug(l,m) \
       { \
       int num_tabs=l; \
       char format[256]; \
       snprintf(format,256,"%s%s%s",(num_tabs==1 ? "\t" : \
         (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":""))), \
         m,PNG_STRING_NEWLINE); \
       fprintf(PNG_DEBUG_FILE,format); \
       }
#    endif
#    ifndef png_debug1
#      define png_debug1(l,m,p1) \
       { \
       int num_tabs=l; \
       char format[256]; \
       snprintf(format,256,"%s%s%s",(num_tabs==1 ? "\t" : \
         (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":""))), \
         m,PNG_STRING_NEWLINE); \
       fprintf(PNG_DEBUG_FILE,format,p1); \
       }
#    endif
#    ifndef png_debug2
#      define png_debug2(l,m,p1,p2) \
       { \
       int num_tabs=l; \
       char format[256]; \
       snprintf(format,256,"%s%s%s",(num_tabs==1 ? "\t" : \
         (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":""))), \
         m,PNG_STRING_NEWLINE); \
       fprintf(PNG_DEBUG_FILE,format,p1,p2); \
       }
#    endif
#  endif /* __STDC __ */
2656
#endif /* (PNG_DEBUG > 1) */
2657

2658
#endif /* _MSC_VER */
2659 2660 2661
#endif /* (PNG_DEBUG > 0) */
#endif /* PNG_DEBUG */
#ifndef png_debug
A
Andreas Dilger 已提交
2662
#define png_debug(l, m)
2663 2664
#endif
#ifndef png_debug1
A
Andreas Dilger 已提交
2665
#define png_debug1(l, m, p1)
2666 2667
#endif
#ifndef png_debug2
A
Andreas Dilger 已提交
2668
#define png_debug2(l, m, p1, p2)
2669 2670 2671
#endif

extern PNG_EXPORT(png_charp,png_get_copyright) PNGARG((png_structp png_ptr));
2672
extern PNG_EXPORT(png_charp,png_get_header_ver) PNGARG((png_structp png_ptr));
2673
extern PNG_EXPORT(png_charp,png_get_header_version) PNGARG((png_structp png_ptr));
2674
extern PNG_EXPORT(png_charp,png_get_libpng_ver) PNGARG((png_structp png_ptr));
2675

2676 2677 2678 2679 2680
#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

2681 2682 2683 2684 2685 2686
/* 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

2687 2688
/* Added to version 1.2.0 */
#if defined(PNG_ASSEMBLER_CODE_SUPPORTED)
2689
#if defined(PNG_MMX_CODE_SUPPORTED)
2690 2691
#define PNG_ASM_FLAG_MMX_SUPPORT_COMPILED  0x01  /* not user-settable */
#define PNG_ASM_FLAG_MMX_SUPPORT_IN_CPU    0x02  /* not user-settable */
2692 2693 2694 2695 2696 2697
#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
2698
#define PNG_ASM_FLAGS_INITIALIZED          0x80000000  /* not user-settable */
2699 2700 2701 2702 2703 2704 2705 2706 2707 2708 2709 2710 2711 2712 2713 2714

#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
2715
#endif /* PNG_MMX_CODE_SUPPORTED */
2716

2717
#if !defined(PNG_1_0_X)
2718 2719 2720 2721 2722 2723 2724 2725 2726 2727 2728 2729 2730 2731 2732 2733 2734 2735 2736 2737 2738 2739 2740 2741 2742 2743 2744 2745 2746
/* 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));

2747
#endif /* PNG_1_0_X */
2748

2749
#if !defined(PNG_1_0_X)
2750 2751
/* png.c, pnggccrd.c, or pngvcrd.c */
extern PNG_EXPORT(int,png_mmx_support) PNGARG((void));
2752
#endif /* PNG_1_0_X */
2753
#endif /* PNG_ASSEMBLER_CODE_SUPPORTED */
2754 2755

/* Strip the prepended error numbers ("#nnn ") from error and warning
2756 2757
 * messages before passing them to the error or warning handler.
 */
2758 2759 2760
#ifdef PNG_ERROR_NUMBERS_SUPPORTED
extern PNG_EXPORT(void,png_set_strip_error_numbers) PNGARG((png_structp
   png_ptr, png_uint_32 strip_mode));
2761
#endif
2762 2763 2764 2765 2766 2767 2768 2769 2770 2771 2772

/* 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

2773

2774 2775 2776
/* Maintainer: Put new public prototypes here ^, in libpng.3, and in
 * project defs
 */
2777

2778
#ifdef PNG_READ_COMPOSITE_NODIV_SUPPORTED
2779 2780 2781
/* 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
2782 2783 2784 2785 2786 2787 2788 2789 2790
 * 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. :-) ]
 */

2791 2792 2793
 /* fg and bg should be in `gamma 1.0' space; alpha is the opacity          */

#  define png_composite(composite, fg, alpha, bg)                            \
2794 2795
     { png_uint_16 temp = (png_uint_16)((png_uint_16)(fg) * (png_uint_16)(alpha) \
                        +        (png_uint_16)(bg)*(png_uint_16)(255 -       \
2796
                        (png_uint_16)(alpha)) + (png_uint_16)128);           \
2797
       (composite) = (png_byte)((temp + (temp >> 8)) >> 8); }
2798 2799

#  define png_composite_16(composite, fg, alpha, bg)                         \
2800 2801
     { png_uint_32 temp = (png_uint_32)((png_uint_32)(fg) * (png_uint_32)(alpha) \
                        + (png_uint_32)(bg)*(png_uint_32)(65535L -           \
2802
                        (png_uint_32)(alpha)) + (png_uint_32)32768L);        \
2803 2804
       (composite) = (png_uint_16)((temp + (temp >> 16)) >> 16); }

2805
#else  /* Standard method using integer division */
2806

2807 2808 2809
#  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)) +       \
2810
       (png_uint_16)127) / 255)
2811 2812

#  define png_composite_16(composite, fg, alpha, bg)                         \
2813
     (composite) = (png_uint_16)(((png_uint_32)(fg) * (png_uint_32)(alpha) + \
2814
       (png_uint_32)(bg)*(png_uint_32)(65535L - (png_uint_32)(alpha)) +      \
2815 2816 2817 2818
       (png_uint_32)32767) / (png_uint_32)65535L)

#endif /* PNG_READ_COMPOSITE_NODIV_SUPPORTED */

2819 2820 2821 2822 2823 2824 2825 2826 2827 2828 2829 2830 2831 2832 2833 2834 2835 2836 2837 2838 2839 2840 2841 2842 2843 2844 2845 2846 2847 2848 2849 2850 2851 2852 2853 2854 2855 2856
/* 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 已提交
2857 2858 2859 2860 2861
/* 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 已提交
2862 2863


2864 2865
/* Various modes of operation, that are visible to applications because
 * they are used for unknown chunk location.
2866
 */
2867 2868 2869
#define PNG_HAVE_IHDR               0x01
#define PNG_HAVE_PLTE               0x02
#define PNG_HAVE_IDAT               0x04
2870
#define PNG_AFTER_IDAT              0x08 /* Have complete zlib datastream */
2871
#define PNG_HAVE_IEND               0x10
2872 2873 2874 2875 2876 2877

#if defined(PNG_INTERNAL)

/* More modes of operation.  Note that after an init, mode is set to
 * zero automatically when the structure is created.
 */
2878 2879 2880 2881 2882 2883 2884
#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
2885
#define PNG_HAVE_PNG_SIGNATURE    0x1000
2886
#define PNG_HAVE_CHUNK_AFTER_IDAT 0x2000 /* Have another chunk after IDAT */
G
Guy Schalnat 已提交
2887

2888
/* Flags for the transformations the PNG library does on the image data */
G
Guy Schalnat 已提交
2889 2890 2891 2892 2893 2894 2895 2896 2897
#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
2898
                          /*   0x0200 unused */
G
Guy Schalnat 已提交
2899 2900 2901 2902 2903
#define PNG_16_TO_8            0x0400
#define PNG_RGBA               0x0800
#define PNG_EXPAND             0x1000
#define PNG_GAMMA              0x2000
#define PNG_GRAY_TO_RGB        0x4000
2904
#define PNG_FILLER             0x8000L
2905
#define PNG_PACKSWAP          0x10000L
2906 2907 2908
#define PNG_SWAP_ALPHA        0x20000L
#define PNG_STRIP_ALPHA       0x40000L
#define PNG_INVERT_ALPHA      0x80000L
2909
#define PNG_USER_TRANSFORM   0x100000L
2910 2911 2912
#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 */
2913
                       /*    0x800000L     Unused */
2914
#define PNG_ADD_ALPHA       0x1000000L  /* Added to libpng-1.2.7 */
2915
#define PNG_EXPAND_tRNS     0x2000000L  /* Added to libpng-1.2.9 */
2916 2917 2918 2919 2920
                       /*   0x4000000L  unused */
                       /*   0x8000000L  unused */
                       /*  0x10000000L  unused */
                       /*  0x20000000L  unused */
                       /*  0x40000000L  unused */
G
Guy Schalnat 已提交
2921

2922
/* Flags for png_create_struct */
G
Guy Schalnat 已提交
2923 2924 2925
#define PNG_STRUCT_PNG   0x0001
#define PNG_STRUCT_INFO  0x0002

A
Andreas Dilger 已提交
2926 2927 2928 2929 2930 2931
/* 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))

2932
/* Flags for the png_ptr->flags rather than declaring a byte for each one */
A
Andreas Dilger 已提交
2933 2934 2935 2936 2937 2938 2939 2940 2941 2942 2943 2944
#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
2945 2946 2947 2948 2949
#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
2950
#define PNG_FLAG_LIBRARY_MISMATCH         0x20000L
2951 2952
#define PNG_FLAG_STRIP_ERROR_NUMBERS      0x40000L
#define PNG_FLAG_STRIP_ERROR_TEXT         0x80000L
2953
#define PNG_FLAG_MALLOC_NULL_MEM_OK       0x100000L
2954 2955 2956 2957 2958 2959 2960 2961 2962 2963
#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 */
2964

A
Andreas Dilger 已提交
2965 2966 2967 2968 2969 2970 2971 2972
#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 已提交
2973

2974
/* Save typing and make code easier to understand */
2975

2976 2977 2978 2979 2980
#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 */
2981 2982 2983 2984 2985
#define PNG_ROWBYTES(pixel_bits, width) \
    ((pixel_bits) >= 8 ? \
    ((width) * (((png_uint_32)(pixel_bits)) >> 3)) : \
    (( ((width) * ((png_uint_32)(pixel_bits))) + 7) >> 3) )

2986
/* PNG_OUT_OF_RANGE returns true if value is outside the range
2987 2988 2989 2990
 * 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
 */
2991 2992
#define PNG_OUT_OF_RANGE(value, ideal, delta) \
        ( (value) < (ideal)-(delta) || (value) > (ideal)+(delta) )
G
Guy Schalnat 已提交
2993

2994
/* Variables declared in png.c - only it needs to define PNG_NO_EXTERN */
2995
#if !defined(PNG_NO_EXTERN) || defined(PNG_ALWAYS_EXTERN)
2996
/* place to hold the signature string for a PNG file. */
2997
#ifdef PNG_USE_GLOBAL_ARRAYS
2998
   PNG_EXPORT_VAR (PNG_CONST png_byte FARDATA) png_sig[8];
2999
#else
3000
#endif
3001
#endif /* PNG_NO_EXTERN */
G
Guy Schalnat 已提交
3002

3003
/* Constant strings for known chunk types.  If you need to add a chunk,
3004 3005
 * define the name here, and add an invocation of the macro in png.c and
 * wherever it's needed.
3006
 */
3007 3008 3009 3010 3011 3012 3013 3014 3015 3016 3017 3018 3019 3020 3021 3022 3023 3024 3025 3026 3027
#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'}
3028 3029

#ifdef PNG_USE_GLOBAL_ARRAYS
3030 3031 3032 3033 3034 3035 3036 3037 3038 3039 3040 3041 3042 3043 3044 3045 3046 3047 3048 3049 3050
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];
3051
#endif /* PNG_USE_GLOBAL_ARRAYS */
G
Guy Schalnat 已提交
3052

3053
#if defined(PNG_1_0_X) || defined (PNG_1_2_X)
3054
/* Initialize png_ptr struct for reading, and allocate any other memory.
3055
 * (old interface - DEPRECATED - use png_create_read_struct instead).
3056
 */
3057
extern PNG_EXPORT(void,png_read_init) PNGARG((png_structp png_ptr));
3058
#undef png_read_init
3059
#define png_read_init(png_ptr) png_read_init_3(&png_ptr, \
3060
    PNG_LIBPNG_VER_STRING,  png_sizeof(png_struct));
3061
#endif
3062

3063 3064
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));
3065
#if defined(PNG_1_0_X) || defined (PNG_1_2_X)
3066
extern PNG_EXPORT(void,png_read_init_2) PNGARG((png_structp png_ptr,
3067 3068
    png_const_charp user_png_ver, png_size_t png_struct_size, png_size_t
    png_info_size));
3069
#endif
A
Andreas Dilger 已提交
3070

3071
#if defined(PNG_1_0_X) || defined (PNG_1_2_X)
3072
/* Initialize png_ptr struct for writing, and allocate any other memory.
3073
 * (old interface - DEPRECATED - use png_create_write_struct instead).
3074
 */
3075
extern PNG_EXPORT(void,png_write_init) PNGARG((png_structp png_ptr));
3076
#undef png_write_init
3077
#define png_write_init(png_ptr) png_write_init_3(&png_ptr, \
3078
    PNG_LIBPNG_VER_STRING, png_sizeof(png_struct));
3079 3080
#endif

3081 3082
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));
3083
extern PNG_EXPORT(void,png_write_init_2) PNGARG((png_structp png_ptr,
3084 3085
    png_const_charp user_png_ver, png_size_t png_struct_size, png_size_t
    png_info_size));
A
Andreas Dilger 已提交
3086

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

3090
/* Free memory from internal libpng struct */
A
Andreas Dilger 已提交
3091
PNG_EXTERN void png_destroy_struct PNGARG((png_voidp struct_ptr));
A
Andreas Dilger 已提交
3092

3093
PNG_EXTERN png_voidp png_create_struct_2 PNGARG((int type, png_malloc_ptr
3094
  malloc_fn, png_voidp mem_ptr));
3095
PNG_EXTERN void png_destroy_struct_2 PNGARG((png_voidp struct_ptr,
3096
   png_free_ptr free_fn, png_voidp mem_ptr));
3097

3098
/* Free any memory that info_ptr points to and reset struct. */
A
Andreas Dilger 已提交
3099
PNG_EXTERN void png_info_destroy PNGARG((png_structp png_ptr,
A
Andreas Dilger 已提交
3100 3101
   png_infop info_ptr));

3102
#ifndef PNG_1_0_X
3103 3104 3105 3106 3107 3108
/* 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));

3109 3110 3111 3112 3113
#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

3114
/* Next four functions are used internally as callbacks.  PNGAPI is required
3115 3116
 * but not PNG_EXPORT.  PNGAPI added at libpng version 1.2.3.
 */
3117 3118 3119 3120 3121 3122 3123 3124 3125 3126 3127 3128 3129 3130 3131 3132 3133

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
3134 3135 3136 3137 3138 3139
#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 */
3140

3141
/* Reset the CRC variable */
A
Andreas Dilger 已提交
3142 3143 3144 3145 3146 3147 3148 3149 3150
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 已提交
3151

3152
/* Read bytes into buf, and update png_ptr->crc */
A
Andreas Dilger 已提交
3153 3154
PNG_EXTERN void png_crc_read PNGARG((png_structp png_ptr, png_bytep buf,
   png_size_t length));
A
Andreas Dilger 已提交
3155

3156
/* Decompress data in a chunk that uses compression */
3157 3158
#if defined(PNG_zTXt_SUPPORTED) || defined(PNG_iTXt_SUPPORTED) || \
    defined(PNG_iCCP_SUPPORTED) || defined(PNG_sPLT_SUPPORTED)
3159 3160
PNG_EXTERN void png_decompress_chunk PNGARG((png_structp png_ptr,
   int comp_type, png_size_t chunklength,
3161
   png_size_t prefix_length, png_size_t *data_length));
3162 3163 3164
#endif

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

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

A
Andreas Dilger 已提交
3170 3171 3172 3173 3174 3175
/* 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 已提交
3176 3177

#if defined(PNG_WRITE_FLUSH_SUPPORTED)
A
Andreas Dilger 已提交
3178
PNG_EXTERN void png_flush PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
3179
#endif
G
Guy Schalnat 已提交
3180

3181
/* Simple function to write the signature */
3182 3183
PNG_EXTERN void png_write_sig PNGARG((png_structp png_ptr));

3184
/* Write various chunks */
G
Guy Schalnat 已提交
3185 3186

/* Write the IHDR chunk, and update the png_struct with the necessary
3187 3188
 * information.
 */
A
Andreas Dilger 已提交
3189
PNG_EXTERN void png_write_IHDR PNGARG((png_structp png_ptr, png_uint_32 width,
G
Guy Schalnat 已提交
3190
   png_uint_32 height,
3191 3192
   int bit_depth, int color_type, int compression_method, int filter_method,
   int interlace_method));
G
Guy Schalnat 已提交
3193

A
Andreas Dilger 已提交
3194 3195
PNG_EXTERN void png_write_PLTE PNGARG((png_structp png_ptr, png_colorp palette,
   png_uint_32 num_pal));
G
Guy Schalnat 已提交
3196

A
Andreas Dilger 已提交
3197 3198
PNG_EXTERN void png_write_IDAT PNGARG((png_structp png_ptr, png_bytep data,
   png_size_t length));
G
Guy Schalnat 已提交
3199

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

G
Guy Schalnat 已提交
3202
#if defined(PNG_WRITE_gAMA_SUPPORTED)
3203
#ifdef PNG_FLOATING_POINT_SUPPORTED
A
Andreas Dilger 已提交
3204
PNG_EXTERN void png_write_gAMA PNGARG((png_structp png_ptr, double file_gamma));
G
Guy Schalnat 已提交
3205
#endif
3206
#ifdef PNG_FIXED_POINT_SUPPORTED
3207
PNG_EXTERN void png_write_gAMA_fixed PNGARG((png_structp png_ptr, png_fixed_point
3208 3209 3210
    file_gamma));
#endif
#endif
G
Guy Schalnat 已提交
3211

G
Guy Schalnat 已提交
3212
#if defined(PNG_WRITE_sBIT_SUPPORTED)
A
Andreas Dilger 已提交
3213
PNG_EXTERN void png_write_sBIT PNGARG((png_structp png_ptr, png_color_8p sbit,
G
Guy Schalnat 已提交
3214
   int color_type));
G
Guy Schalnat 已提交
3215
#endif
G
Guy Schalnat 已提交
3216

G
Guy Schalnat 已提交
3217
#if defined(PNG_WRITE_cHRM_SUPPORTED)
3218
#ifdef PNG_FLOATING_POINT_SUPPORTED
A
Andreas Dilger 已提交
3219
PNG_EXTERN void png_write_cHRM PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
3220 3221 3222
   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 已提交
3223
#endif
3224 3225
#ifdef PNG_FIXED_POINT_SUPPORTED
PNG_EXTERN void png_write_cHRM_fixed PNGARG((png_structp png_ptr,
3226 3227 3228 3229
   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));
3230 3231
#endif
#endif
G
Guy Schalnat 已提交
3232

3233 3234
#if defined(PNG_WRITE_sRGB_SUPPORTED)
PNG_EXTERN void png_write_sRGB PNGARG((png_structp png_ptr,
3235
   int intent));
3236 3237
#endif

3238 3239 3240 3241
#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));
3242
   /* Note to maintainer: profile should be png_bytep */
3243 3244 3245 3246
#endif

#if defined(PNG_WRITE_sPLT_SUPPORTED)
PNG_EXTERN void png_write_sPLT PNGARG((png_structp png_ptr,
3247
   png_sPLT_tp palette));
3248 3249
#endif

G
Guy Schalnat 已提交
3250
#if defined(PNG_WRITE_tRNS_SUPPORTED)
A
Andreas Dilger 已提交
3251
PNG_EXTERN void png_write_tRNS PNGARG((png_structp png_ptr, png_bytep trans,
G
Guy Schalnat 已提交
3252
   png_color_16p values, int number, int color_type));
G
Guy Schalnat 已提交
3253
#endif
G
Guy Schalnat 已提交
3254

G
Guy Schalnat 已提交
3255
#if defined(PNG_WRITE_bKGD_SUPPORTED)
A
Andreas Dilger 已提交
3256 3257
PNG_EXTERN void png_write_bKGD PNGARG((png_structp png_ptr,
   png_color_16p values, int color_type));
G
Guy Schalnat 已提交
3258
#endif
G
Guy Schalnat 已提交
3259

G
Guy Schalnat 已提交
3260
#if defined(PNG_WRITE_hIST_SUPPORTED)
A
Andreas Dilger 已提交
3261
PNG_EXTERN void png_write_hIST PNGARG((png_structp png_ptr, png_uint_16p hist,
3262
   int num_hist));
G
Guy Schalnat 已提交
3263
#endif
G
Guy Schalnat 已提交
3264

3265 3266
#if defined(PNG_WRITE_TEXT_SUPPORTED) || defined(PNG_WRITE_pCAL_SUPPORTED) || \
    defined(PNG_WRITE_iCCP_SUPPORTED) || defined(PNG_WRITE_sPLT_SUPPORTED)
A
Andreas Dilger 已提交
3267
PNG_EXTERN png_size_t png_check_keyword PNGARG((png_structp png_ptr,
3268
   png_charp key, png_charpp new_key));
A
Andreas Dilger 已提交
3269 3270
#endif

G
Guy Schalnat 已提交
3271
#if defined(PNG_WRITE_tEXt_SUPPORTED)
A
Andreas Dilger 已提交
3272 3273
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 已提交
3274
#endif
G
Guy Schalnat 已提交
3275

G
Guy Schalnat 已提交
3276
#if defined(PNG_WRITE_zTXt_SUPPORTED)
A
Andreas Dilger 已提交
3277 3278
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 已提交
3279
#endif
G
Guy Schalnat 已提交
3280

3281 3282
#if defined(PNG_WRITE_iTXt_SUPPORTED)
PNG_EXTERN void png_write_iTXt PNGARG((png_structp png_ptr,
3283
   int compression, png_charp key, png_charp lang, png_charp lang_key,
3284 3285 3286
   png_charp text));
#endif

3287
#if defined(PNG_TEXT_SUPPORTED)  /* Added at version 1.0.14 and 1.2.4 */
3288 3289 3290 3291
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 已提交
3292
#if defined(PNG_WRITE_oFFs_SUPPORTED)
A
Andreas Dilger 已提交
3293
PNG_EXTERN void png_write_oFFs PNGARG((png_structp png_ptr,
3294
   png_int_32 x_offset, png_int_32 y_offset, int unit_type));
G
Guy Schalnat 已提交
3295
#endif
G
Guy Schalnat 已提交
3296

A
Andreas Dilger 已提交
3297 3298 3299 3300
#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 已提交
3301
#endif
G
Guy Schalnat 已提交
3302

A
Andreas Dilger 已提交
3303 3304 3305 3306
#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 已提交
3307 3308
#endif

A
Andreas Dilger 已提交
3309 3310
#if defined(PNG_WRITE_tIME_SUPPORTED)
PNG_EXTERN void png_write_tIME PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
3311
   png_timep mod_time));
G
Guy Schalnat 已提交
3312 3313
#endif

3314
#if defined(PNG_WRITE_sCAL_SUPPORTED)
3315
#if defined(PNG_FLOATING_POINT_SUPPORTED) && !defined(PNG_NO_STDIO)
3316
PNG_EXTERN void png_write_sCAL PNGARG((png_structp png_ptr,
3317 3318 3319
   int unit, double width, double height));
#else
#ifdef PNG_FIXED_POINT_SUPPORTED
3320
PNG_EXTERN void png_write_sCAL_s PNGARG((png_structp png_ptr,
3321 3322 3323
   int unit, png_charp width, png_charp height));
#endif
#endif
3324 3325
#endif

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

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

G
Guy Schalnat 已提交
3332
#if defined(PNG_READ_GAMMA_SUPPORTED)
A
Andreas Dilger 已提交
3333
PNG_EXTERN void png_build_gamma_table PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
3334
#endif
G
Guy Schalnat 已提交
3335

3336
/* Combine a row of data, dealing with alpha, etc. if requested */
A
Andreas Dilger 已提交
3337
PNG_EXTERN void png_combine_row PNGARG((png_structp png_ptr, png_bytep row,
G
Guy Schalnat 已提交
3338
   int mask));
G
Guy Schalnat 已提交
3339 3340

#if defined(PNG_READ_INTERLACING_SUPPORTED)
3341
/* Expand an interlaced row */
3342
/* OLD pre-1.0.9 interface:
A
Andreas Dilger 已提交
3343 3344
PNG_EXTERN void png_do_read_interlace PNGARG((png_row_infop row_info,
   png_bytep row, int pass, png_uint_32 transformations));
3345 3346
 */
PNG_EXTERN void png_do_read_interlace PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
3347 3348
#endif

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

G
Guy Schalnat 已提交
3351
#if defined(PNG_WRITE_INTERLACING_SUPPORTED)
3352
/* Grab pixels out of a row for an interlaced pass */
A
Andreas Dilger 已提交
3353
PNG_EXTERN void png_do_write_interlace PNGARG((png_row_infop row_info,
G
Guy Schalnat 已提交
3354
   png_bytep row, int pass));
G
Guy Schalnat 已提交
3355
#endif
G
Guy Schalnat 已提交
3356

3357
/* Unfilter a row */
A
Andreas Dilger 已提交
3358
PNG_EXTERN void png_read_filter_row PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
3359
   png_row_infop row_info, png_bytep row, png_bytep prev_row, int filter));
A
Andreas Dilger 已提交
3360 3361 3362

/* 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 已提交
3363
   png_row_infop row_info));
A
Andreas Dilger 已提交
3364 3365 3366

/* Write out the filtered row. */
PNG_EXTERN void png_write_filtered_row PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
3367
   png_bytep filtered_row));
3368
/* Finish a row while reading, dealing with interlacing passes, etc. */
A
Andreas Dilger 已提交
3369 3370
PNG_EXTERN void png_read_finish_row PNGARG((png_structp png_ptr));

3371
/* Initialize the row buffers, etc. */
A
Andreas Dilger 已提交
3372
PNG_EXTERN void png_read_start_row PNGARG((png_structp png_ptr));
3373
/* Optional call to update the users info structure */
A
Andreas Dilger 已提交
3374
PNG_EXTERN void png_read_transform_info PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
3375
   png_infop info_ptr));
G
Guy Schalnat 已提交
3376

3377
/* These are the functions that do the transformations */
G
Guy Schalnat 已提交
3378
#if defined(PNG_READ_FILLER_SUPPORTED)
A
Andreas Dilger 已提交
3379 3380 3381 3382 3383 3384 3385 3386 3387 3388 3389 3390
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 已提交
3391 3392
#endif

3393 3394 3395 3396 3397 3398 3399 3400 3401 3402
#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 已提交
3403 3404 3405
#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,
3406
   png_bytep row, png_uint_32 flags));
G
Guy Schalnat 已提交
3407 3408 3409
#endif

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

3413
#if defined(PNG_READ_PACKSWAP_SUPPORTED) || defined(PNG_WRITE_PACKSWAP_SUPPORTED)
A
Andreas Dilger 已提交
3414
PNG_EXTERN void png_do_packswap PNGARG((png_row_infop row_info, png_bytep row));
G
Guy Schalnat 已提交
3415 3416
#endif

A
Andreas Dilger 已提交
3417
#if defined(PNG_READ_RGB_TO_GRAY_SUPPORTED)
3418 3419
PNG_EXTERN int png_do_rgb_to_gray PNGARG((png_structp png_ptr, png_row_infop
   row_info, png_bytep row));
A
Andreas Dilger 已提交
3420 3421 3422
#endif

#if defined(PNG_READ_GRAY_TO_RGB_SUPPORTED)
A
Andreas Dilger 已提交
3423 3424
PNG_EXTERN void png_do_gray_to_rgb PNGARG((png_row_infop row_info,
   png_bytep row));
A
Andreas Dilger 已提交
3425 3426
#endif

G
Guy Schalnat 已提交
3427
#if defined(PNG_READ_PACK_SUPPORTED)
A
Andreas Dilger 已提交
3428
PNG_EXTERN void png_do_unpack PNGARG((png_row_infop row_info, png_bytep row));
G
Guy Schalnat 已提交
3429 3430 3431
#endif

#if defined(PNG_READ_SHIFT_SUPPORTED)
A
Andreas Dilger 已提交
3432
PNG_EXTERN void png_do_unshift PNGARG((png_row_infop row_info, png_bytep row,
G
Guy Schalnat 已提交
3433
   png_color_8p sig_bits));
G
Guy Schalnat 已提交
3434 3435 3436
#endif

#if defined(PNG_READ_INVERT_SUPPORTED) || defined(PNG_WRITE_INVERT_SUPPORTED)
A
Andreas Dilger 已提交
3437
PNG_EXTERN void png_do_invert PNGARG((png_row_infop row_info, png_bytep row));
G
Guy Schalnat 已提交
3438 3439 3440
#endif

#if defined(PNG_READ_16_TO_8_SUPPORTED)
A
Andreas Dilger 已提交
3441
PNG_EXTERN void png_do_chop PNGARG((png_row_infop row_info, png_bytep row));
G
Guy Schalnat 已提交
3442 3443 3444
#endif

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

A
Andreas Dilger 已提交
3448
#  if defined(PNG_CORRECT_PALETTE_SUPPORTED)
A
Andreas Dilger 已提交
3449
PNG_EXTERN void png_correct_palette PNGARG((png_structp png_ptr,
G
Guy Schalnat 已提交
3450
   png_colorp palette, int num_palette));
A
Andreas Dilger 已提交
3451
#  endif
G
Guy Schalnat 已提交
3452 3453
#endif

G
Guy Schalnat 已提交
3454
#if defined(PNG_READ_BGR_SUPPORTED) || defined(PNG_WRITE_BGR_SUPPORTED)
A
Andreas Dilger 已提交
3455
PNG_EXTERN void png_do_bgr PNGARG((png_row_infop row_info, png_bytep row));
G
Guy Schalnat 已提交
3456 3457 3458
#endif

#if defined(PNG_WRITE_PACK_SUPPORTED)
A
Andreas Dilger 已提交
3459 3460
PNG_EXTERN void png_do_pack PNGARG((png_row_infop row_info,
   png_bytep row, png_uint_32 bit_depth));
G
Guy Schalnat 已提交
3461 3462 3463
#endif

#if defined(PNG_WRITE_SHIFT_SUPPORTED)
A
Andreas Dilger 已提交
3464
PNG_EXTERN void png_do_shift PNGARG((png_row_infop row_info, png_bytep row,
G
Guy Schalnat 已提交
3465
   png_color_8p bit_depth));
G
Guy Schalnat 已提交
3466 3467 3468
#endif

#if defined(PNG_READ_BACKGROUND_SUPPORTED)
3469
#if defined(PNG_READ_GAMMA_SUPPORTED)
3470 3471 3472
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 已提交
3473 3474
   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,
3475 3476 3477 3478
   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));
3479
#endif
G
Guy Schalnat 已提交
3480 3481 3482
#endif

#if defined(PNG_READ_GAMMA_SUPPORTED)
A
Andreas Dilger 已提交
3483
PNG_EXTERN void png_do_gamma PNGARG((png_row_infop row_info, png_bytep row,
G
Guy Schalnat 已提交
3484
   png_bytep gamma_table, png_uint_16pp gamma_16_table,
G
Guy Schalnat 已提交
3485
   int gamma_shift));
G
Guy Schalnat 已提交
3486 3487 3488
#endif

#if defined(PNG_READ_EXPAND_SUPPORTED)
A
Andreas Dilger 已提交
3489
PNG_EXTERN void png_do_expand_palette PNGARG((png_row_infop row_info,
G
Guy Schalnat 已提交
3490
   png_bytep row, png_colorp palette, png_bytep trans, int num_trans));
A
Andreas Dilger 已提交
3491
PNG_EXTERN void png_do_expand PNGARG((png_row_infop row_info,
G
Guy Schalnat 已提交
3492
   png_bytep row, png_color_16p trans_value));
G
Guy Schalnat 已提交
3493
#endif
G
Guy Schalnat 已提交
3494

A
Andreas Dilger 已提交
3495
/* The following decodes the appropriate chunks, and does error correction,
3496 3497
 * then calls the appropriate callback for the chunk if it is valid.
 */
G
Guy Schalnat 已提交
3498

3499
/* Decode the IHDR chunk */
A
Andreas Dilger 已提交
3500
PNG_EXTERN void png_handle_IHDR PNGARG((png_structp png_ptr, png_infop info_ptr,
A
Andreas Dilger 已提交
3501
   png_uint_32 length));
A
Andreas Dilger 已提交
3502
PNG_EXTERN void png_handle_PLTE PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3503
   png_uint_32 length));
A
Andreas Dilger 已提交
3504
PNG_EXTERN void png_handle_IEND PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3505
   png_uint_32 length));
A
Andreas Dilger 已提交
3506

3507 3508
#if defined(PNG_READ_bKGD_SUPPORTED)
PNG_EXTERN void png_handle_bKGD PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3509
   png_uint_32 length));
G
Guy Schalnat 已提交
3510 3511
#endif

3512 3513
#if defined(PNG_READ_cHRM_SUPPORTED)
PNG_EXTERN void png_handle_cHRM PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3514
   png_uint_32 length));
G
Guy Schalnat 已提交
3515 3516
#endif

3517 3518
#if defined(PNG_READ_gAMA_SUPPORTED)
PNG_EXTERN void png_handle_gAMA PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3519
   png_uint_32 length));
G
Guy Schalnat 已提交
3520 3521
#endif

3522 3523
#if defined(PNG_READ_hIST_SUPPORTED)
PNG_EXTERN void png_handle_hIST PNGARG((png_structp png_ptr, png_infop info_ptr,
3524 3525 3526
   png_uint_32 length));
#endif

3527 3528 3529 3530 3531
#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 */

3532 3533
#if defined(PNG_READ_iTXt_SUPPORTED)
PNG_EXTERN void png_handle_iTXt PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3534
   png_uint_32 length));
G
Guy Schalnat 已提交
3535 3536
#endif

3537 3538
#if defined(PNG_READ_oFFs_SUPPORTED)
PNG_EXTERN void png_handle_oFFs PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3539
   png_uint_32 length));
G
Guy Schalnat 已提交
3540 3541
#endif

3542 3543
#if defined(PNG_READ_pCAL_SUPPORTED)
PNG_EXTERN void png_handle_pCAL PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3544
   png_uint_32 length));
G
Guy Schalnat 已提交
3545 3546
#endif

3547 3548
#if defined(PNG_READ_pHYs_SUPPORTED)
PNG_EXTERN void png_handle_pHYs PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3549
   png_uint_32 length));
G
Guy Schalnat 已提交
3550 3551
#endif

3552 3553
#if defined(PNG_READ_sBIT_SUPPORTED)
PNG_EXTERN void png_handle_sBIT PNGARG((png_structp png_ptr, png_infop info_ptr,
A
Andreas Dilger 已提交
3554 3555 3556
   png_uint_32 length));
#endif

3557 3558 3559 3560 3561
#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

3562 3563 3564 3565 3566 3567 3568 3569 3570 3571 3572 3573
#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 已提交
3574
   png_uint_32 length));
G
Guy Schalnat 已提交
3575 3576 3577
#endif

#if defined(PNG_READ_tIME_SUPPORTED)
A
Andreas Dilger 已提交
3578
PNG_EXTERN void png_handle_tIME PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3579
   png_uint_32 length));
G
Guy Schalnat 已提交
3580 3581
#endif

3582 3583
#if defined(PNG_READ_tRNS_SUPPORTED)
PNG_EXTERN void png_handle_tRNS PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3584
   png_uint_32 length));
G
Guy Schalnat 已提交
3585 3586 3587
#endif

#if defined(PNG_READ_zTXt_SUPPORTED)
A
Andreas Dilger 已提交
3588
PNG_EXTERN void png_handle_zTXt PNGARG((png_structp png_ptr, png_infop info_ptr,
G
Guy Schalnat 已提交
3589
   png_uint_32 length));
G
Guy Schalnat 已提交
3590
#endif
G
Guy Schalnat 已提交
3591

A
Andreas Dilger 已提交
3592 3593
PNG_EXTERN void png_handle_unknown PNGARG((png_structp png_ptr,
   png_infop info_ptr, png_uint_32 length));
A
Andreas Dilger 已提交
3594

A
Andreas Dilger 已提交
3595
PNG_EXTERN void png_check_chunk_name PNGARG((png_structp png_ptr,
A
Andreas Dilger 已提交
3596 3597
   png_bytep chunk_name));

3598
/* Handle the transformations for reading and writing */
A
Andreas Dilger 已提交
3599 3600
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 已提交
3601

A
Andreas Dilger 已提交
3602
PNG_EXTERN void png_init_read_transformations PNGARG((png_structp png_ptr));
G
Guy Schalnat 已提交
3603 3604

#ifdef PNG_PROGRESSIVE_READ_SUPPORTED
A
Andreas Dilger 已提交
3605 3606 3607 3608 3609 3610
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 已提交
3611
   png_uint_32 length));
A
Andreas Dilger 已提交
3612 3613 3614 3615 3616 3617 3618 3619 3620 3621 3622 3623 3624 3625 3626 3627
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 已提交
3628
   png_infop info_ptr));
A
Andreas Dilger 已提交
3629 3630 3631
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 已提交
3632
#if defined(PNG_READ_tEXt_SUPPORTED)
A
Andreas Dilger 已提交
3633 3634 3635 3636
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 已提交
3637 3638
#endif
#if defined(PNG_READ_zTXt_SUPPORTED)
A
Andreas Dilger 已提交
3639 3640 3641 3642
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 已提交
3643
#endif
3644 3645 3646 3647 3648 3649
#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 已提交
3650

G
Guy Schalnat 已提交
3651
#endif /* PNG_PROGRESSIVE_READ_SUPPORTED */
G
Guy Schalnat 已提交
3652

3653 3654 3655 3656 3657 3658 3659
#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

3660
#if defined(PNG_ASSEMBLER_CODE_SUPPORTED)
3661
#if defined(PNG_MMX_CODE_SUPPORTED)
3662 3663 3664
/* png.c */ /* PRIVATE */
PNG_EXTERN void png_init_mmx_flags PNGARG((png_structp png_ptr));
#endif
3665
#endif
3666 3667 3668 3669 3670 3671 3672 3673 3674 3675 3676 3677 3678 3679 3680 3681 3682 3683 3684 3685 3686 3687 3688

#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 */

3689 3690 3691
/* Read the chunk header (length + type name) */
PNG_EXTERN png_uint_32 png_read_chunk_header PNGARG((png_structp png_ptr));

3692 3693 3694 3695 3696 3697 3698 3699 3700
/* Added at libpng version 1.2.34 */
#if defined(PNG_cHRM_SUPPORTED)
PNG_EXTERN int png_check_cHRM_fixed  PNGARG((png_structp png_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));
#endif

3701 3702 3703 3704 3705 3706 3707 3708
#if defined(PNG_cHRM_SUPPORTED)
#if !defined(PNG_NO_CHECK_cHRM)
/* Added at libpng version 1.2.34 */
PNG_EXTERN void png_64bit_product (long v1, long v2, unsigned long *hi_product,
   unsigned long *lo_product);
#endif
#endif

3709 3710
/* Maintainer: Put new private prototypes here ^ and in libpngpf.3 */

G
Guy Schalnat 已提交
3711 3712
#endif /* PNG_INTERNAL */

A
Andreas Dilger 已提交
3713 3714 3715 3716
#ifdef __cplusplus
}
#endif

3717
#endif /* PNG_VERSION_INFO_ONLY */
3718
/* Do not put anything past this line */
3719
#endif /* PNG_H */