png.h
Go to the documentation of this file.
1 /* png.h - header file for PNG reference library
2  *
3  * libpng version 1.2.32 - September 18, 2008
4  * Copyright (c) 1998-2008 Glenn Randers-Pehrson
5  * (Version 0.96 Copyright (c) 1996, 1997 Andreas Dilger)
6  * (Version 0.88 Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.)
7  *
8  * Authors and maintainers:
9  * libpng versions 0.71, May 1995, through 0.88, January 1996: Guy Schalnat
10  * libpng versions 0.89c, June 1996, through 0.96, May 1997: Andreas Dilger
11  * libpng versions 0.97, January 1998, through 1.2.32 - September 18, 2008: Glenn
12  * See also "Contributing Authors", below.
13  *
14  * Note about libpng version numbers:
15  *
16  * Due to various miscommunications, unforeseen code incompatibilities
17  * and occasional factors outside the authors' control, version numbering
18  * on the library has not always been consistent and straightforward.
19  * The following table summarizes matters since version 0.89c, which was
20  * the first widely used release:
21  *
22  * source png.h png.h shared-lib
23  * version string int version
24  * ------- ------ ----- ----------
25  * 0.89c "1.0 beta 3" 0.89 89 1.0.89
26  * 0.90 "1.0 beta 4" 0.90 90 0.90 [should have been 2.0.90]
27  * 0.95 "1.0 beta 5" 0.95 95 0.95 [should have been 2.0.95]
28  * 0.96 "1.0 beta 6" 0.96 96 0.96 [should have been 2.0.96]
29  * 0.97b "1.00.97 beta 7" 1.00.97 97 1.0.1 [should have been 2.0.97]
30  * 0.97c 0.97 97 2.0.97
31  * 0.98 0.98 98 2.0.98
32  * 0.99 0.99 98 2.0.99
33  * 0.99a-m 0.99 99 2.0.99
34  * 1.00 1.00 100 2.1.0 [100 should be 10000]
35  * 1.0.0 (from here on, the 100 2.1.0 [100 should be 10000]
36  * 1.0.1 png.h string is 10001 2.1.0
37  * 1.0.1a-e identical to the 10002 from here on, the shared library
38  * 1.0.2 source version) 10002 is 2.V where V is the source code
39  * 1.0.2a-b 10003 version, except as noted.
40  * 1.0.3 10003
41  * 1.0.3a-d 10004
42  * 1.0.4 10004
43  * 1.0.4a-f 10005
44  * 1.0.5 (+ 2 patches) 10005
45  * 1.0.5a-d 10006
46  * 1.0.5e-r 10100 (not source compatible)
47  * 1.0.5s-v 10006 (not binary compatible)
48  * 1.0.6 (+ 3 patches) 10006 (still binary incompatible)
49  * 1.0.6d-f 10007 (still binary incompatible)
50  * 1.0.6g 10007
51  * 1.0.6h 10007 10.6h (testing xy.z so-numbering)
52  * 1.0.6i 10007 10.6i
53  * 1.0.6j 10007 2.1.0.6j (incompatible with 1.0.0)
54  * 1.0.7beta11-14 DLLNUM 10007 2.1.0.7beta11-14 (binary compatible)
55  * 1.0.7beta15-18 1 10007 2.1.0.7beta15-18 (binary compatible)
56  * 1.0.7rc1-2 1 10007 2.1.0.7rc1-2 (binary compatible)
57  * 1.0.7 1 10007 (still compatible)
58  * 1.0.8beta1-4 1 10008 2.1.0.8beta1-4
59  * 1.0.8rc1 1 10008 2.1.0.8rc1
60  * 1.0.8 1 10008 2.1.0.8
61  * 1.0.9beta1-6 1 10009 2.1.0.9beta1-6
62  * 1.0.9rc1 1 10009 2.1.0.9rc1
63  * 1.0.9beta7-10 1 10009 2.1.0.9beta7-10
64  * 1.0.9rc2 1 10009 2.1.0.9rc2
65  * 1.0.9 1 10009 2.1.0.9
66  * 1.0.10beta1 1 10010 2.1.0.10beta1
67  * 1.0.10rc1 1 10010 2.1.0.10rc1
68  * 1.0.10 1 10010 2.1.0.10
69  * 1.0.11beta1-3 1 10011 2.1.0.11beta1-3
70  * 1.0.11rc1 1 10011 2.1.0.11rc1
71  * 1.0.11 1 10011 2.1.0.11
72  * 1.0.12beta1-2 2 10012 2.1.0.12beta1-2
73  * 1.0.12rc1 2 10012 2.1.0.12rc1
74  * 1.0.12 2 10012 2.1.0.12
75  * 1.1.0a-f - 10100 2.1.1.0a-f (branch abandoned)
76  * 1.2.0beta1-2 2 10200 2.1.2.0beta1-2
77  * 1.2.0beta3-5 3 10200 3.1.2.0beta3-5
78  * 1.2.0rc1 3 10200 3.1.2.0rc1
79  * 1.2.0 3 10200 3.1.2.0
80  * 1.2.1beta1-4 3 10201 3.1.2.1beta1-4
81  * 1.2.1rc1-2 3 10201 3.1.2.1rc1-2
82  * 1.2.1 3 10201 3.1.2.1
83  * 1.2.2beta1-6 12 10202 12.so.0.1.2.2beta1-6
84  * 1.0.13beta1 10 10013 10.so.0.1.0.13beta1
85  * 1.0.13rc1 10 10013 10.so.0.1.0.13rc1
86  * 1.2.2rc1 12 10202 12.so.0.1.2.2rc1
87  * 1.0.13 10 10013 10.so.0.1.0.13
88  * 1.2.2 12 10202 12.so.0.1.2.2
89  * 1.2.3rc1-6 12 10203 12.so.0.1.2.3rc1-6
90  * 1.2.3 12 10203 12.so.0.1.2.3
91  * 1.2.4beta1-3 13 10204 12.so.0.1.2.4beta1-3
92  * 1.0.14rc1 13 10014 10.so.0.1.0.14rc1
93  * 1.2.4rc1 13 10204 12.so.0.1.2.4rc1
94  * 1.0.14 10 10014 10.so.0.1.0.14
95  * 1.2.4 13 10204 12.so.0.1.2.4
96  * 1.2.5beta1-2 13 10205 12.so.0.1.2.5beta1-2
97  * 1.0.15rc1-3 10 10015 10.so.0.1.0.15rc1-3
98  * 1.2.5rc1-3 13 10205 12.so.0.1.2.5rc1-3
99  * 1.0.15 10 10015 10.so.0.1.0.15
100  * 1.2.5 13 10205 12.so.0.1.2.5
101  * 1.2.6beta1-4 13 10206 12.so.0.1.2.6beta1-4
102  * 1.0.16 10 10016 10.so.0.1.0.16
103  * 1.2.6 13 10206 12.so.0.1.2.6
104  * 1.2.7beta1-2 13 10207 12.so.0.1.2.7beta1-2
105  * 1.0.17rc1 10 10017 10.so.0.1.0.17rc1
106  * 1.2.7rc1 13 10207 12.so.0.1.2.7rc1
107  * 1.0.17 10 10017 10.so.0.1.0.17
108  * 1.2.7 13 10207 12.so.0.1.2.7
109  * 1.2.8beta1-5 13 10208 12.so.0.1.2.8beta1-5
110  * 1.0.18rc1-5 10 10018 10.so.0.1.0.18rc1-5
111  * 1.2.8rc1-5 13 10208 12.so.0.1.2.8rc1-5
112  * 1.0.18 10 10018 10.so.0.1.0.18
113  * 1.2.8 13 10208 12.so.0.1.2.8
114  * 1.2.9beta1-3 13 10209 12.so.0.1.2.9beta1-3
115  * 1.2.9beta4-11 13 10209 12.so.0.9[.0]
116  * 1.2.9rc1 13 10209 12.so.0.9[.0]
117  * 1.2.9 13 10209 12.so.0.9[.0]
118  * 1.2.10beta1-8 13 10210 12.so.0.10[.0]
119  * 1.2.10rc1-3 13 10210 12.so.0.10[.0]
120  * 1.2.10 13 10210 12.so.0.10[.0]
121  * 1.2.11beta1-4 13 10211 12.so.0.11[.0]
122  * 1.0.19rc1-5 10 10019 10.so.0.19[.0]
123  * 1.2.11rc1-5 13 10211 12.so.0.11[.0]
124  * 1.0.19 10 10019 10.so.0.19[.0]
125  * 1.2.11 13 10211 12.so.0.11[.0]
126  * 1.0.20 10 10020 10.so.0.20[.0]
127  * 1.2.12 13 10212 12.so.0.12[.0]
128  * 1.2.13beta1 13 10213 12.so.0.13[.0]
129  * 1.0.21 10 10021 10.so.0.21[.0]
130  * 1.2.13 13 10213 12.so.0.13[.0]
131  * 1.2.14beta1-2 13 10214 12.so.0.14[.0]
132  * 1.0.22rc1 10 10022 10.so.0.22[.0]
133  * 1.2.14rc1 13 10214 12.so.0.14[.0]
134  * 1.0.22 10 10022 10.so.0.22[.0]
135  * 1.2.14 13 10214 12.so.0.14[.0]
136  * 1.2.15beta1-6 13 10215 12.so.0.15[.0]
137  * 1.0.23rc1-5 10 10023 10.so.0.23[.0]
138  * 1.2.15rc1-5 13 10215 12.so.0.15[.0]
139  * 1.0.23 10 10023 10.so.0.23[.0]
140  * 1.2.15 13 10215 12.so.0.15[.0]
141  * 1.2.16beta1-2 13 10216 12.so.0.16[.0]
142  * 1.2.16rc1 13 10216 12.so.0.16[.0]
143  * 1.0.24 10 10024 10.so.0.24[.0]
144  * 1.2.16 13 10216 12.so.0.16[.0]
145  * 1.2.17beta1-2 13 10217 12.so.0.17[.0]
146  * 1.0.25rc1 10 10025 10.so.0.25[.0]
147  * 1.2.17rc1-3 13 10217 12.so.0.17[.0]
148  * 1.0.25 10 10025 10.so.0.25[.0]
149  * 1.2.17 13 10217 12.so.0.17[.0]
150  * 1.0.26 10 10026 10.so.0.26[.0]
151  * 1.2.18 13 10218 12.so.0.18[.0]
152  * 1.2.19beta1-31 13 10219 12.so.0.19[.0]
153  * 1.0.27rc1-6 10 10027 10.so.0.27[.0]
154  * 1.2.19rc1-6 13 10219 12.so.0.19[.0]
155  * 1.0.27 10 10027 10.so.0.27[.0]
156  * 1.2.19 13 10219 12.so.0.19[.0]
157  * 1.2.20beta01-04 13 10220 12.so.0.20[.0]
158  * 1.0.28rc1-6 10 10028 10.so.0.28[.0]
159  * 1.2.20rc1-6 13 10220 12.so.0.20[.0]
160  * 1.0.28 10 10028 10.so.0.28[.0]
161  * 1.2.20 13 10220 12.so.0.20[.0]
162  * 1.2.21beta1-2 13 10221 12.so.0.21[.0]
163  * 1.2.21rc1-3 13 10221 12.so.0.21[.0]
164  * 1.0.29 10 10029 10.so.0.29[.0]
165  * 1.2.21 13 10221 12.so.0.21[.0]
166  * 1.2.22beta1-4 13 10222 12.so.0.22[.0]
167  * 1.0.30rc1 10 10030 10.so.0.30[.0]
168  * 1.2.22rc1 13 10222 12.so.0.22[.0]
169  * 1.0.30 10 10030 10.so.0.30[.0]
170  * 1.2.22 13 10222 12.so.0.22[.0]
171  * 1.2.23beta01-05 13 10223 12.so.0.23[.0]
172  * 1.2.23rc01 13 10223 12.so.0.23[.0]
173  * 1.2.23 13 10223 12.so.0.23[.0]
174  * 1.2.24beta01-02 13 10224 12.so.0.24[.0]
175  * 1.2.24rc01 13 10224 12.so.0.24[.0]
176  * 1.2.24 13 10224 12.so.0.24[.0]
177  * 1.2.25beta01-06 13 10225 12.so.0.25[.0]
178  * 1.2.25rc01-02 13 10225 12.so.0.25[.0]
179  * 1.0.31 10 10031 10.so.0.31[.0]
180  * 1.2.25 13 10225 12.so.0.25[.0]
181  * 1.2.26beta01-06 13 10226 12.so.0.26[.0]
182  * 1.2.26rc01 13 10226 12.so.0.26[.0]
183  * 1.2.26 13 10226 12.so.0.26[.0]
184  * 1.0.32 10 10032 10.so.0.32[.0]
185  * 1.2.27beta01-06 13 10227 12.so.0.27[.0]
186  * 1.2.27rc01 13 10227 12.so.0.27[.0]
187  * 1.0.33 10 10033 10.so.0.33[.0]
188  * 1.2.27 13 10227 12.so.0.27[.0]
189  * 1.0.34 10 10034 10.so.0.34[.0]
190  * 1.2.28 13 10228 12.so.0.28[.0]
191  * 1.2.29beta01-03 13 10229 12.so.0.29[.0]
192  * 1.2.29rc01 13 10229 12.so.0.29[.0]
193  * 1.0.35 10 10035 10.so.0.35[.0]
194  * 1.2.29 13 10229 12.so.0.29[.0]
195  * 1.0.37 10 10037 10.so.0.37[.0]
196  * 1.2.30beta01-04 13 10230 12.so.0.30[.0]
197  * 1.0.38rc01-08 10 10038 10.so.0.38[.0]
198  * 1.2.30rc01-08 13 10230 12.so.0.30[.0]
199  * 1.0.38 10 10038 10.so.0.38[.0]
200  * 1.2.30 13 10230 12.so.0.30[.0]
201  * 1.0.39rc01-03 10 10039 10.so.0.39[.0]
202  * 1.2.31rc01-03 13 10231 12.so.0.31[.0]
203  * 1.0.39 10 10039 10.so.0.39[.0]
204  * 1.2.31 13 10231 12.so.0.31[.0]
205  * 1.2.32beta01-02 13 10232 12.so.0.32[.0]
206  * 1.0.40rc01 10 10040 10.so.0.40[.0]
207  * 1.2.32rc01 13 10232 12.so.0.32[.0]
208  * 1.0.40 10 10040 10.so.0.40[.0]
209  * 1.2.32 13 10232 12.so.0.32[.0]
210  *
211  * Henceforth the source version will match the shared-library major
212  * and minor numbers; the shared-library major version number will be
213  * used for changes in backward compatibility, as it is intended. The
214  * PNG_LIBPNG_VER macro, which is not used within libpng but is available
215  * for applications, is an unsigned integer of the form xyyzz corresponding
216  * to the source version x.y.z (leading zeros in y and z). Beta versions
217  * were given the previous public release number plus a letter, until
218  * version 1.0.6j; from then on they were given the upcoming public
219  * release number plus "betaNN" or "rcNN".
220  *
221  * Binary incompatibility exists only when applications make direct access
222  * to the info_ptr or png_ptr members through png.h, and the compiled
223  * application is loaded with a different version of the library.
224  *
225  * DLLNUM will change each time there are forward or backward changes
226  * in binary compatibility (e.g., when a new feature is added).
227  *
228  * See libpng.txt or libpng.3 for more information. The PNG specification
229  * is available as a W3C Recommendation and as an ISO Specification,
230  * <http://www.w3.org/TR/2003/REC-PNG-20031110/
231  */
232 
233 /*
234  * COPYRIGHT NOTICE, DISCLAIMER, and LICENSE:
235  *
236  * If you modify libpng you may insert additional notices immediately following
237  * this sentence.
238  *
239  * libpng versions 1.2.6, August 15, 2004, through 1.2.32, September 18, 2008, are
240  * Copyright (c) 2004, 2006-2008 Glenn Randers-Pehrson, and are
241  * distributed according to the same disclaimer and license as libpng-1.2.5
242  * with the following individual added to the list of Contributing Authors:
243  *
244  * Cosmin Truta
245  *
246  * libpng versions 1.0.7, July 1, 2000, through 1.2.5, October 3, 2002, are
247  * Copyright (c) 2000-2002 Glenn Randers-Pehrson, and are
248  * distributed according to the same disclaimer and license as libpng-1.0.6
249  * with the following individuals added to the list of Contributing Authors:
250  *
251  * Simon-Pierre Cadieux
252  * Eric S. Raymond
253  * Gilles Vollant
254  *
255  * and with the following additions to the disclaimer:
256  *
257  * There is no warranty against interference with your enjoyment of the
258  * library or against infringement. There is no warranty that our
259  * efforts or the library will fulfill any of your particular purposes
260  * or needs. This library is provided with all faults, and the entire
261  * risk of satisfactory quality, performance, accuracy, and effort is with
262  * the user.
263  *
264  * libpng versions 0.97, January 1998, through 1.0.6, March 20, 2000, are
265  * Copyright (c) 1998, 1999, 2000 Glenn Randers-Pehrson, and are
266  * distributed according to the same disclaimer and license as libpng-0.96,
267  * with the following individuals added to the list of Contributing Authors:
268  *
269  * Tom Lane
270  * Glenn Randers-Pehrson
271  * Willem van Schaik
272  *
273  * libpng versions 0.89, June 1996, through 0.96, May 1997, are
274  * Copyright (c) 1996, 1997 Andreas Dilger
275  * Distributed according to the same disclaimer and license as libpng-0.88,
276  * with the following individuals added to the list of Contributing Authors:
277  *
278  * John Bowler
279  * Kevin Bracey
280  * Sam Bushell
281  * Magnus Holmgren
282  * Greg Roelofs
283  * Tom Tanner
284  *
285  * libpng versions 0.5, May 1995, through 0.88, January 1996, are
286  * Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.
287  *
288  * For the purposes of this copyright and license, "Contributing Authors"
289  * is defined as the following set of individuals:
290  *
291  * Andreas Dilger
292  * Dave Martindale
293  * Guy Eric Schalnat
294  * Paul Schmidt
295  * Tim Wegner
296  *
297  * The PNG Reference Library is supplied "AS IS". The Contributing Authors
298  * and Group 42, Inc. disclaim all warranties, expressed or implied,
299  * including, without limitation, the warranties of merchantability and of
300  * fitness for any purpose. The Contributing Authors and Group 42, Inc.
301  * assume no liability for direct, indirect, incidental, special, exemplary,
302  * or consequential damages, which may result from the use of the PNG
303  * Reference Library, even if advised of the possibility of such damage.
304  *
305  * Permission is hereby granted to use, copy, modify, and distribute this
306  * source code, or portions hereof, for any purpose, without fee, subject
307  * to the following restrictions:
308  *
309  * 1. The origin of this source code must not be misrepresented.
310  *
311  * 2. Altered versions must be plainly marked as such and
312  * must not be misrepresented as being the original source.
313  *
314  * 3. This Copyright notice may not be removed or altered from
315  * any source or altered source distribution.
316  *
317  * The Contributing Authors and Group 42, Inc. specifically permit, without
318  * fee, and encourage the use of this source code as a component to
319  * supporting the PNG file format in commercial products. If you use this
320  * source code in a product, acknowledgment is not required but would be
321  * appreciated.
322  */
323 
324 /*
325  * A "png_get_copyright" function is available, for convenient use in "about"
326  * boxes and the like:
327  *
328  * printf("%s",png_get_copyright(NULL));
329  *
330  * Also, the PNG logo (in PNG format, of course) is supplied in the
331  * files "pngbar.png" and "pngbar.jpg (88x31) and "pngnow.png" (98x31).
332  */
333 
334 /*
335  * Libpng is OSI Certified Open Source Software. OSI Certified is a
336  * certification mark of the Open Source Initiative.
337  */
338 
339 /*
340  * The contributing authors would like to thank all those who helped
341  * with testing, bug fixes, and patience. This wouldn't have been
342  * possible without all of you.
343  *
344  * Thanks to Frank J. T. Wojcik for helping with the documentation.
345  */
346 
347 /*
348  * Y2K compliance in libpng:
349  * =========================
350  *
351  * September 18, 2008
352  *
353  * Since the PNG Development group is an ad-hoc body, we can't make
354  * an official declaration.
355  *
356  * This is your unofficial assurance that libpng from version 0.71 and
357  * upward through 1.2.32 are Y2K compliant. It is my belief that earlier
358  * versions were also Y2K compliant.
359  *
360  * Libpng only has three year fields. One is a 2-byte unsigned integer
361  * that will hold years up to 65535. The other two hold the date in text
362  * format, and will hold years up to 9999.
363  *
364  * The integer is
365  * "png_uint_16 year" in png_time_struct.
366  *
367  * The strings are
368  * "png_charp time_buffer" in png_struct and
369  * "near_time_buffer", which is a local character string in png.c.
370  *
371  * There are seven time-related functions:
372  * png.c: png_convert_to_rfc_1123() in png.c
373  * (formerly png_convert_to_rfc_1152() in error)
374  * png_convert_from_struct_tm() in pngwrite.c, called in pngwrite.c
375  * png_convert_from_time_t() in pngwrite.c
376  * png_get_tIME() in pngget.c
377  * png_handle_tIME() in pngrutil.c, called in pngread.c
378  * png_set_tIME() in pngset.c
379  * png_write_tIME() in pngwutil.c, called in pngwrite.c
380  *
381  * All handle dates properly in a Y2K environment. The
382  * png_convert_from_time_t() function calls gmtime() to convert from system
383  * clock time, which returns (year - 1900), which we properly convert to
384  * the full 4-digit year. There is a possibility that applications using
385  * libpng are not passing 4-digit years into the png_convert_to_rfc_1123()
386  * function, or that they are incorrectly passing only a 2-digit year
387  * instead of "year - 1900" into the png_convert_from_struct_tm() function,
388  * but this is not under our control. The libpng documentation has always
389  * stated that it works with 4-digit years, and the APIs have been
390  * documented as such.
391  *
392  * The tIME chunk itself is also Y2K compliant. It uses a 2-byte unsigned
393  * integer to hold the year, and can hold years as large as 65535.
394  *
395  * zlib, upon which libpng depends, is also Y2K compliant. It contains
396  * no date-related code.
397  *
398  * Glenn Randers-Pehrson
399  * libpng maintainer
400  * PNG Development Group
401  */
402 
403 #ifndef PNG_H
404 #define PNG_H
405 
406 /* This is not the place to learn how to use libpng. The file libpng.txt
407  * describes how to use libpng, and the file example.c summarizes it
408  * with some code on which to build. This file is useful for looking
409  * at the actual function definitions and structure components.
410  */
411 
412 /* Version information for png.h - this should match the version in png.c */
413 #define PNG_LIBPNG_VER_STRING "1.2.32"
414 #define PNG_HEADER_VERSION_STRING \
415  " libpng version 1.2.32 - September 18, 2008\n"
416 
417 #define PNG_LIBPNG_VER_SONUM 0
418 #define PNG_LIBPNG_VER_DLLNUM 13
419 
420 /* These should match the first 3 components of PNG_LIBPNG_VER_STRING: */
421 #define PNG_LIBPNG_VER_MAJOR 1
422 #define PNG_LIBPNG_VER_MINOR 2
423 #define PNG_LIBPNG_VER_RELEASE 32
424 /* This should match the numeric part of the final component of
425  * PNG_LIBPNG_VER_STRING, omitting any leading zero: */
426 
427 #define PNG_LIBPNG_VER_BUILD 0
428 
429 /* Release Status */
430 #define PNG_LIBPNG_BUILD_ALPHA 1
431 #define PNG_LIBPNG_BUILD_BETA 2
432 #define PNG_LIBPNG_BUILD_RC 3
433 #define PNG_LIBPNG_BUILD_STABLE 4
434 #define PNG_LIBPNG_BUILD_RELEASE_STATUS_MASK 7
435 
436 /* Release-Specific Flags */
437 #define PNG_LIBPNG_BUILD_PATCH 8 /* Can be OR'ed with
438  PNG_LIBPNG_BUILD_STABLE only */
439 #define PNG_LIBPNG_BUILD_PRIVATE 16 /* Cannot be OR'ed with
440  PNG_LIBPNG_BUILD_SPECIAL */
441 #define PNG_LIBPNG_BUILD_SPECIAL 32 /* Cannot be OR'ed with
442  PNG_LIBPNG_BUILD_PRIVATE */
443 
444 #define PNG_LIBPNG_BUILD_BASE_TYPE PNG_LIBPNG_BUILD_STABLE
445 
446 /* Careful here. At one time, Guy wanted to use 082, but that would be octal.
447  * We must not include leading zeros.
448  * Versions 0.7 through 1.0.0 were in the range 0 to 100 here (only
449  * version 1.0.0 was mis-numbered 100 instead of 10000). From
450  * version 1.0.1 it's xxyyzz, where x=major, y=minor, z=release */
451 #define PNG_LIBPNG_VER 10232 /* 1.2.32 */
452 
453 #ifndef PNG_VERSION_INFO_ONLY
454 /* include the compression library's header */
455 #include "zlib.h"
456 #endif
457 
458 /* include all user configurable info, including optional assembler routines */
459 #include "pngconf.h"
460 
461 /*
462  * Added at libpng-1.2.8 */
463 /* Ref MSDN: Private as priority over Special
464  * VS_FF_PRIVATEBUILD File *was not* built using standard release
465  * procedures. If this value is given, the StringFileInfo block must
466  * contain a PrivateBuild string.
467  *
468  * VS_FF_SPECIALBUILD File *was* built by the original company using
469  * standard release procedures but is a variation of the standard
470  * file of the same version number. If this value is given, the
471  * StringFileInfo block must contain a SpecialBuild string.
472  */
473 
474 #if defined(PNG_USER_PRIVATEBUILD)
475 # define PNG_LIBPNG_BUILD_TYPE \
476  (PNG_LIBPNG_BUILD_BASE_TYPE | PNG_LIBPNG_BUILD_PRIVATE)
477 #else
478 # if defined(PNG_LIBPNG_SPECIALBUILD)
479 # define PNG_LIBPNG_BUILD_TYPE \
480  (PNG_LIBPNG_BUILD_BASE_TYPE | PNG_LIBPNG_BUILD_SPECIAL)
481 # else
482 # define PNG_LIBPNG_BUILD_TYPE (PNG_LIBPNG_BUILD_BASE_TYPE)
483 # endif
484 #endif
485 
486 #ifndef PNG_VERSION_INFO_ONLY
487 
488 /* Inhibit C++ name-mangling for libpng functions but not for system calls. */
489 #ifdef __cplusplus
490 extern "C" {
491 #endif /* __cplusplus */
492 
493 /* This file is arranged in several sections. The first section contains
494  * structure and type definitions. The second section contains the external
495  * library functions, while the third has the internal library functions,
496  * which applications aren't expected to use directly.
497  */
498 
499 #ifndef PNG_NO_TYPECAST_NULL
500 #define int_p_NULL (int *)NULL
501 #define png_bytep_NULL (png_bytep)NULL
502 #define png_bytepp_NULL (png_bytepp)NULL
503 #define png_doublep_NULL (png_doublep)NULL
504 #define png_error_ptr_NULL (png_error_ptr)NULL
505 #define png_flush_ptr_NULL (png_flush_ptr)NULL
506 #define png_free_ptr_NULL (png_free_ptr)NULL
507 #define png_infopp_NULL (png_infopp)NULL
508 #define png_malloc_ptr_NULL (png_malloc_ptr)NULL
509 #define png_read_status_ptr_NULL (png_read_status_ptr)NULL
510 #define png_rw_ptr_NULL (png_rw_ptr)NULL
511 #define png_structp_NULL (png_structp)NULL
512 #define png_uint_16p_NULL (png_uint_16p)NULL
513 #define png_voidp_NULL (png_voidp)NULL
514 #define png_write_status_ptr_NULL (png_write_status_ptr)NULL
515 #else
516 #define int_p_NULL NULL
517 #define png_bytep_NULL NULL
518 #define png_bytepp_NULL NULL
519 #define png_doublep_NULL NULL
520 #define png_error_ptr_NULL NULL
521 #define png_flush_ptr_NULL NULL
522 #define png_free_ptr_NULL NULL
523 #define png_infopp_NULL NULL
524 #define png_malloc_ptr_NULL NULL
525 #define png_read_status_ptr_NULL NULL
526 #define png_rw_ptr_NULL NULL
527 #define png_structp_NULL NULL
528 #define png_uint_16p_NULL NULL
529 #define png_voidp_NULL NULL
530 #define png_write_status_ptr_NULL NULL
531 #endif
532 
533 /* variables declared in png.c - only it needs to define PNG_NO_EXTERN */
534 #if !defined(PNG_NO_EXTERN) || defined(PNG_ALWAYS_EXTERN)
535 /* Version information for C files, stored in png.c. This had better match
536  * the version above.
537  */
538 #ifdef PNG_USE_GLOBAL_ARRAYS
540  /* need room for 99.99.99beta99z */
541 #else
542 #define png_libpng_ver png_get_header_ver(NULL)
543 #endif
544 
545 #ifdef PNG_USE_GLOBAL_ARRAYS
546 /* This was removed in version 1.0.5c */
547 /* Structures to facilitate easy interlacing. See png.c for more details */
554 /* This isn't currently used. If you need it, see png.c for more details.
555 PNG_EXPORT_VAR (PNG_CONST int FARDATA) png_pass_height[7];
556 */
557 #endif
558 
559 #endif /* PNG_NO_EXTERN */
560 
561 /* Three color definitions. The order of the red, green, and blue, (and the
562  * exact size) is not important, although the size of the fields need to
563  * be png_byte or png_uint_16 (as defined below).
564  */
565 typedef struct png_color_struct
566 {
570 } png_color;
573 
574 typedef struct png_color_16_struct
575 {
576  png_byte index; /* used for palette files */
577  png_uint_16 red; /* for use in red green blue files */
580  png_uint_16 gray; /* for use in grayscale files */
581 } png_color_16;
584 
585 typedef struct png_color_8_struct
586 {
587  png_byte red; /* for use in red green blue files */
590  png_byte gray; /* for use in grayscale files */
591  png_byte alpha; /* for alpha channel files */
592 } png_color_8;
595 
596 /*
597  * The following two structures are used for the in-core representation
598  * of sPLT chunks.
599  */
600 typedef struct png_sPLT_entry_struct
601 {
610 
611 /* When the depth of the sPLT palette is 8 bits, the color and alpha samples
612  * occupy the LSB of their respective members, and the MSB of each member
613  * is zero-filled. The frequency member always occupies the full 16 bits.
614  */
615 
616 typedef struct png_sPLT_struct
617 {
618  png_charp name; /* palette name */
619  png_byte depth; /* depth of palette samples */
620  png_sPLT_entryp entries; /* palette entries */
621  png_int_32 nentries; /* number of palette entries */
622 } png_sPLT_t;
625 
626 #ifdef PNG_TEXT_SUPPORTED
627 /* png_text holds the contents of a text/ztxt/itxt chunk in a PNG file,
628  * and whether that contents is compressed or not. The "key" field
629  * points to a regular zero-terminated C string. The "text", "lang", and
630  * "lang_key" fields can be regular C strings, empty strings, or NULL pointers.
631  * However, the * structure returned by png_get_text() will always contain
632  * regular zero-terminated C strings (possibly empty), never NULL pointers,
633  * so they can be safely used in printf() and other string-handling functions.
634  */
635 typedef struct png_text_struct
636 {
637  int compression; /* compression value:
638  -1: tEXt, none
639  0: zTXt, deflate
640  1: iTXt, none
641  2: iTXt, deflate */
642  png_charp key; /* keyword, 1-79 character description of "text" */
643  png_charp text; /* comment, may be an empty string (ie "")
644  or a NULL pointer */
645  png_size_t text_length; /* length of the text string */
646 #ifdef PNG_iTXt_SUPPORTED
647  png_size_t itxt_length; /* length of the itxt string */
648  png_charp lang; /* language code, 0-79 characters
649  or a NULL pointer */
650  png_charp lang_key; /* keyword translated UTF-8 string, 0 or more
651  chars or a NULL pointer */
652 #endif
653 } png_text;
656 #endif
657 
658 /* Supported compression types for text in PNG files (tEXt, and zTXt).
659  * The values of the PNG_TEXT_COMPRESSION_ defines should NOT be changed. */
660 #define PNG_TEXT_COMPRESSION_NONE_WR -3
661 #define PNG_TEXT_COMPRESSION_zTXt_WR -2
662 #define PNG_TEXT_COMPRESSION_NONE -1
663 #define PNG_TEXT_COMPRESSION_zTXt 0
664 #define PNG_ITXT_COMPRESSION_NONE 1
665 #define PNG_ITXT_COMPRESSION_zTXt 2
666 #define PNG_TEXT_COMPRESSION_LAST 3 /* Not a valid value */
667 
668 /* png_time is a way to hold the time in an machine independent way.
669  * Two conversions are provided, both from time_t and struct tm. There
670  * is no portable way to convert to either of these structures, as far
671  * as I know. If you know of a portable way, send it to me. As a side
672  * note - PNG has always been Year 2000 compliant!
673  */
674 typedef struct png_time_struct
675 {
676  png_uint_16 year; /* full year, as in, 1995 */
677  png_byte month; /* month of year, 1 - 12 */
678  png_byte day; /* day of month, 1 - 31 */
679  png_byte hour; /* hour of day, 0 - 23 */
680  png_byte minute; /* minute of hour, 0 - 59 */
681  png_byte second; /* second of minute, 0 - 60 (for leap seconds) */
682 } png_time;
685 
686 #if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED)
687 /* png_unknown_chunk is a structure to hold queued chunks for which there is
688  * no specific support. The idea is that we can use this to queue
689  * up private chunks for output even though the library doesn't actually
690  * know about their semantics.
691  */
692 #define PNG_CHUNK_NAME_LENGTH 5
693 typedef struct png_unknown_chunk_t
694 {
698 
699  /* libpng-using applications should NOT directly modify this byte. */
700  png_byte location; /* mode of operation at read time */
701 }
705 #endif
706 
707 /* png_info is a structure that holds the information in a PNG file so
708  * that the application can find out the characteristics of the image.
709  * If you are reading the file, this structure will tell you what is
710  * in the PNG file. If you are writing the file, fill in the information
711  * you want to put into the PNG file, then call png_write_info().
712  * The names chosen should be very close to the PNG specification, so
713  * consult that document for information about the meaning of each field.
714  *
715  * With libpng < 0.95, it was only possible to directly set and read the
716  * the values in the png_info_struct, which meant that the contents and
717  * order of the values had to remain fixed. With libpng 0.95 and later,
718  * however, there are now functions that abstract the contents of
719  * png_info_struct from the application, so this makes it easier to use
720  * libpng with dynamic libraries, and even makes it possible to use
721  * libraries that don't have all of the libpng ancillary chunk-handing
722  * functionality.
723  *
724  * In any case, the order of the parameters in png_info_struct should NOT
725  * be changed for as long as possible to keep compatibility with applications
726  * that use the old direct-access method with png_info_struct.
727  *
728  * The following members may have allocated storage attached that should be
729  * cleaned up before the structure is discarded: palette, trans, text,
730  * pcal_purpose, pcal_units, pcal_params, hist, iccp_name, iccp_profile,
731  * splt_palettes, scal_unit, row_pointers, and unknowns. By default, these
732  * are automatically freed when the info structure is deallocated, if they were
733  * allocated internally by libpng. This behavior can be changed by means
734  * of the png_data_freer() function.
735  *
736  * More allocation details: all the chunk-reading functions that
737  * change these members go through the corresponding png_set_*
738  * functions. A function to clear these members is available: see
739  * png_free_data(). The png_set_* functions do not depend on being
740  * able to point info structure members to any of the storage they are
741  * passed (they make their own copies), EXCEPT that the png_set_text
742  * functions use the same storage passed to them in the text_ptr or
743  * itxt_ptr structure argument, and the png_set_rows and png_set_unknowns
744  * functions do not make their own copies.
745  */
746 typedef struct png_info_struct
747 {
748  /* the following are necessary for every PNG file */
749  png_uint_32 width; /* width of image in pixels (from IHDR) */
750  png_uint_32 height; /* height of image in pixels (from IHDR) */
751  png_uint_32 valid; /* valid chunk data (see PNG_INFO_ below) */
752  png_uint_32 rowbytes; /* bytes needed to hold an untransformed row */
753  png_colorp palette; /* array of color values (valid & PNG_INFO_PLTE) */
754  png_uint_16 num_palette; /* number of color entries in "palette" (PLTE) */
755  png_uint_16 num_trans; /* number of transparent palette color (tRNS) */
756  png_byte bit_depth; /* 1, 2, 4, 8, or 16 bits/channel (from IHDR) */
757  png_byte color_type; /* see PNG_COLOR_TYPE_ below (from IHDR) */
758  /* The following three should have been named *_method not *_type */
759  png_byte compression_type; /* must be PNG_COMPRESSION_TYPE_BASE (IHDR) */
760  png_byte filter_type; /* must be PNG_FILTER_TYPE_BASE (from IHDR) */
761  png_byte interlace_type; /* One of PNG_INTERLACE_NONE, PNG_INTERLACE_ADAM7 */
762 
763  /* The following is informational only on read, and not used on writes. */
764  png_byte channels; /* number of data channels per pixel (1, 2, 3, 4) */
765  png_byte pixel_depth; /* number of bits per pixel */
766  png_byte spare_byte; /* to align the data, and for future use */
767  png_byte signature[8]; /* magic bytes read by libpng from start of file */
768 
769  /* The rest of the data is optional. If you are reading, check the
770  * valid field to see if the information in these are valid. If you
771  * are writing, set the valid field to those chunks you want written,
772  * and initialize the appropriate fields below.
773  */
774 
775 #if defined(PNG_gAMA_SUPPORTED) && defined(PNG_FLOATING_POINT_SUPPORTED)
776  /* The gAMA chunk describes the gamma characteristics of the system
777  * on which the image was created, normally in the range [1.0, 2.5].
778  * Data is valid if (valid & PNG_INFO_gAMA) is non-zero.
779  */
780  float gamma; /* gamma value of image, if (valid & PNG_INFO_gAMA) */
781 #endif
782 
783 #if defined(PNG_sRGB_SUPPORTED)
784  /* GR-P, 0.96a */
785  /* Data valid if (valid & PNG_INFO_sRGB) non-zero. */
786  png_byte srgb_intent; /* sRGB rendering intent [0, 1, 2, or 3] */
787 #endif
788 
789 #if defined(PNG_TEXT_SUPPORTED)
790  /* The tEXt, and zTXt chunks contain human-readable textual data in
791  * uncompressed, compressed, and optionally compressed forms, respectively.
792  * The data in "text" is an array of pointers to uncompressed,
793  * null-terminated C strings. Each chunk has a keyword that describes the
794  * textual data contained in that chunk. Keywords are not required to be
795  * unique, and the text string may be empty. Any number of text chunks may
796  * be in an image.
797  */
798  int num_text; /* number of comments read/to write */
799  int max_text; /* current size of text array */
800  png_textp text; /* array of comments read/to write */
801 #endif /* PNG_TEXT_SUPPORTED */
802 
803 #if defined(PNG_tIME_SUPPORTED)
804  /* The tIME chunk holds the last time the displayed image data was
805  * modified. See the png_time struct for the contents of this struct.
806  */
808 #endif
809 
810 #if defined(PNG_sBIT_SUPPORTED)
811  /* The sBIT chunk specifies the number of significant high-order bits
812  * in the pixel data. Values are in the range [1, bit_depth], and are
813  * only specified for the channels in the pixel data. The contents of
814  * the low-order bits is not specified. Data is valid if
815  * (valid & PNG_INFO_sBIT) is non-zero.
816  */
817  png_color_8 sig_bit; /* significant bits in color channels */
818 #endif
819 
820 #if defined(PNG_tRNS_SUPPORTED) || defined(PNG_READ_EXPAND_SUPPORTED) || \
821 defined(PNG_READ_BACKGROUND_SUPPORTED)
822  /* The tRNS chunk supplies transparency data for paletted images and
823  * other image types that don't need a full alpha channel. There are
824  * "num_trans" transparency values for a paletted image, stored in the
825  * same order as the palette colors, starting from index 0. Values
826  * for the data are in the range [0, 255], ranging from fully transparent
827  * to fully opaque, respectively. For non-paletted images, there is a
828  * single color specified that should be treated as fully transparent.
829  * Data is valid if (valid & PNG_INFO_tRNS) is non-zero.
830  */
831  png_bytep trans; /* transparent values for paletted image */
832  png_color_16 trans_values; /* transparent color for non-palette image */
833 #endif
834 
835 #if defined(PNG_bKGD_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED)
836  /* The bKGD chunk gives the suggested image background color if the
837  * display program does not have its own background color and the image
838  * is needs to composited onto a background before display. The colors
839  * in "background" are normally in the same color space/depth as the
840  * pixel data. Data is valid if (valid & PNG_INFO_bKGD) is non-zero.
841  */
843 #endif
844 
845 #if defined(PNG_oFFs_SUPPORTED)
846  /* The oFFs chunk gives the offset in "offset_unit_type" units rightwards
847  * and downwards from the top-left corner of the display, page, or other
848  * application-specific co-ordinate space. See the PNG_OFFSET_ defines
849  * below for the unit types. Valid if (valid & PNG_INFO_oFFs) non-zero.
850  */
851  png_int_32 x_offset; /* x offset on page */
852  png_int_32 y_offset; /* y offset on page */
853  png_byte offset_unit_type; /* offset units type */
854 #endif
855 
856 #if defined(PNG_pHYs_SUPPORTED)
857  /* The pHYs chunk gives the physical pixel density of the image for
858  * display or printing in "phys_unit_type" units (see PNG_RESOLUTION_
859  * defines below). Data is valid if (valid & PNG_INFO_pHYs) is non-zero.
860  */
861  png_uint_32 x_pixels_per_unit; /* horizontal pixel density */
862  png_uint_32 y_pixels_per_unit; /* vertical pixel density */
863  png_byte phys_unit_type; /* resolution type (see PNG_RESOLUTION_ below) */
864 #endif
865 
866 #if defined(PNG_hIST_SUPPORTED)
867  /* The hIST chunk contains the relative frequency or importance of the
868  * various palette entries, so that a viewer can intelligently select a
869  * reduced-color palette, if required. Data is an array of "num_palette"
870  * values in the range [0,65535]. Data valid if (valid & PNG_INFO_hIST)
871  * is non-zero.
872  */
874 #endif
875 
876 #ifdef PNG_cHRM_SUPPORTED
877  /* The cHRM chunk describes the CIE color characteristics of the monitor
878  * on which the PNG was created. This data allows the viewer to do gamut
879  * mapping of the input image to ensure that the viewer sees the same
880  * colors in the image as the creator. Values are in the range
881  * [0.0, 0.8]. Data valid if (valid & PNG_INFO_cHRM) non-zero.
882  */
883 #ifdef PNG_FLOATING_POINT_SUPPORTED
884  float x_white;
885  float y_white;
886  float x_red;
887  float y_red;
888  float x_green;
889  float y_green;
890  float x_blue;
891  float y_blue;
892 #endif
893 #endif
894 
895 #if defined(PNG_pCAL_SUPPORTED)
896  /* The pCAL chunk describes a transformation between the stored pixel
897  * values and original physical data values used to create the image.
898  * The integer range [0, 2^bit_depth - 1] maps to the floating-point
899  * range given by [pcal_X0, pcal_X1], and are further transformed by a
900  * (possibly non-linear) transformation function given by "pcal_type"
901  * and "pcal_params" into "pcal_units". Please see the PNG_EQUATION_
902  * defines below, and the PNG-Group's PNG extensions document for a
903  * complete description of the transformations and how they should be
904  * implemented, and for a description of the ASCII parameter strings.
905  * Data values are valid if (valid & PNG_INFO_pCAL) non-zero.
906  */
907  png_charp pcal_purpose; /* pCAL chunk description string */
908  png_int_32 pcal_X0; /* minimum value */
909  png_int_32 pcal_X1; /* maximum value */
910  png_charp pcal_units; /* Latin-1 string giving physical units */
911  png_charpp pcal_params; /* ASCII strings containing parameter values */
912  png_byte pcal_type; /* equation type (see PNG_EQUATION_ below) */
913  png_byte pcal_nparams; /* number of parameters given in pcal_params */
914 #endif
915 
916 /* New members added in libpng-1.0.6 */
917 #ifdef PNG_FREE_ME_SUPPORTED
918  png_uint_32 free_me; /* flags items libpng is responsible for freeing */
919 #endif
920 
921 #if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED)
922  /* storage for unknown chunks that the library doesn't recognize. */
923  png_unknown_chunkp unknown_chunks;
925 #endif
926 
927 #if defined(PNG_iCCP_SUPPORTED)
928  /* iCCP chunk data. */
929  png_charp iccp_name; /* profile name */
930  png_charp iccp_profile; /* International Color Consortium profile data */
931  /* Note to maintainer: should be png_bytep */
932  png_uint_32 iccp_proflen; /* ICC profile data length */
933  png_byte iccp_compression; /* Always zero */
934 #endif
935 
936 #if defined(PNG_sPLT_SUPPORTED)
937  /* data on sPLT chunks (there may be more than one). */
938  png_sPLT_tp splt_palettes;
940 #endif
941 
942 #if defined(PNG_sCAL_SUPPORTED)
943  /* The sCAL chunk describes the actual physical dimensions of the
944  * subject matter of the graphic. The chunk contains a unit specification
945  * a byte value, and two ASCII strings representing floating-point
946  * values. The values are width and height corresponsing to one pixel
947  * in the image. This external representation is converted to double
948  * here. Data values are valid if (valid & PNG_INFO_sCAL) is non-zero.
949  */
950  png_byte scal_unit; /* unit of physical scale */
951 #ifdef PNG_FLOATING_POINT_SUPPORTED
952  double scal_pixel_width; /* width of one pixel */
953  double scal_pixel_height; /* height of one pixel */
954 #endif
955 #ifdef PNG_FIXED_POINT_SUPPORTED
956  png_charp scal_s_width; /* string containing height */
957  png_charp scal_s_height; /* string containing width */
958 #endif
959 #endif
960 
961 #if defined(PNG_INFO_IMAGE_SUPPORTED)
962  /* Memory has been allocated if (valid & PNG_ALLOCATED_INFO_ROWS) non-zero */
963  /* Data valid if (valid & PNG_INFO_IDAT) non-zero */
964  png_bytepp row_pointers; /* the image bits */
965 #endif
966 
967 #if defined(PNG_FIXED_POINT_SUPPORTED) && defined(PNG_gAMA_SUPPORTED)
968  png_fixed_point int_gamma; /* gamma of image, if (valid & PNG_INFO_gAMA) */
969 #endif
970 
971 #if defined(PNG_cHRM_SUPPORTED) && defined(PNG_FIXED_POINT_SUPPORTED)
980 #endif
981 
982 } png_info;
983 
986 
987 /* Maximum positive integer used in PNG is (2^31)-1 */
988 #define PNG_UINT_31_MAX ((png_uint_32)0x7fffffffL)
989 #define PNG_UINT_32_MAX ((png_uint_32)(-1))
990 #define PNG_SIZE_MAX ((png_size_t)(-1))
991 #if defined(PNG_1_0_X) || defined (PNG_1_2_X)
992 /* PNG_MAX_UINT is deprecated; use PNG_UINT_31_MAX instead. */
993 #define PNG_MAX_UINT PNG_UINT_31_MAX
994 #endif
995 
996 /* These describe the color_type field in png_info. */
997 /* color type masks */
998 #define PNG_COLOR_MASK_PALETTE 1
999 #define PNG_COLOR_MASK_COLOR 2
1000 #define PNG_COLOR_MASK_ALPHA 4
1001 
1002 /* color types. Note that not all combinations are legal */
1003 #define PNG_COLOR_TYPE_GRAY 0
1004 #define PNG_COLOR_TYPE_PALETTE (PNG_COLOR_MASK_COLOR | PNG_COLOR_MASK_PALETTE)
1005 #define PNG_COLOR_TYPE_RGB (PNG_COLOR_MASK_COLOR)
1006 #define PNG_COLOR_TYPE_RGB_ALPHA (PNG_COLOR_MASK_COLOR | PNG_COLOR_MASK_ALPHA)
1007 #define PNG_COLOR_TYPE_GRAY_ALPHA (PNG_COLOR_MASK_ALPHA)
1008 /* aliases */
1009 #define PNG_COLOR_TYPE_RGBA PNG_COLOR_TYPE_RGB_ALPHA
1010 #define PNG_COLOR_TYPE_GA PNG_COLOR_TYPE_GRAY_ALPHA
1011 
1012 /* This is for compression type. PNG 1.0-1.2 only define the single type. */
1013 #define PNG_COMPRESSION_TYPE_BASE 0 /* Deflate method 8, 32K window */
1014 #define PNG_COMPRESSION_TYPE_DEFAULT PNG_COMPRESSION_TYPE_BASE
1015 
1016 /* This is for filter type. PNG 1.0-1.2 only define the single type. */
1017 #define PNG_FILTER_TYPE_BASE 0 /* Single row per-byte filtering */
1018 #define PNG_INTRAPIXEL_DIFFERENCING 64 /* Used only in MNG datastreams */
1019 #define PNG_FILTER_TYPE_DEFAULT PNG_FILTER_TYPE_BASE
1020 
1021 /* These are for the interlacing type. These values should NOT be changed. */
1022 #define PNG_INTERLACE_NONE 0 /* Non-interlaced image */
1023 #define PNG_INTERLACE_ADAM7 1 /* Adam7 interlacing */
1024 #define PNG_INTERLACE_LAST 2 /* Not a valid value */
1025 
1026 /* These are for the oFFs chunk. These values should NOT be changed. */
1027 #define PNG_OFFSET_PIXEL 0 /* Offset in pixels */
1028 #define PNG_OFFSET_MICROMETER 1 /* Offset in micrometers (1/10^6 meter) */
1029 #define PNG_OFFSET_LAST 2 /* Not a valid value */
1030 
1031 /* These are for the pCAL chunk. These values should NOT be changed. */
1032 #define PNG_EQUATION_LINEAR 0 /* Linear transformation */
1033 #define PNG_EQUATION_BASE_E 1 /* Exponential base e transform */
1034 #define PNG_EQUATION_ARBITRARY 2 /* Arbitrary base exponential transform */
1035 #define PNG_EQUATION_HYPERBOLIC 3 /* Hyperbolic sine transformation */
1036 #define PNG_EQUATION_LAST 4 /* Not a valid value */
1037 
1038 /* These are for the sCAL chunk. These values should NOT be changed. */
1039 #define PNG_SCALE_UNKNOWN 0 /* unknown unit (image scale) */
1040 #define PNG_SCALE_METER 1 /* meters per pixel */
1041 #define PNG_SCALE_RADIAN 2 /* radians per pixel */
1042 #define PNG_SCALE_LAST 3 /* Not a valid value */
1043 
1044 /* These are for the pHYs chunk. These values should NOT be changed. */
1045 #define PNG_RESOLUTION_UNKNOWN 0 /* pixels/unknown unit (aspect ratio) */
1046 #define PNG_RESOLUTION_METER 1 /* pixels/meter */
1047 #define PNG_RESOLUTION_LAST 2 /* Not a valid value */
1048 
1049 /* These are for the sRGB chunk. These values should NOT be changed. */
1050 #define PNG_sRGB_INTENT_PERCEPTUAL 0
1051 #define PNG_sRGB_INTENT_RELATIVE 1
1052 #define PNG_sRGB_INTENT_SATURATION 2
1053 #define PNG_sRGB_INTENT_ABSOLUTE 3
1054 #define PNG_sRGB_INTENT_LAST 4 /* Not a valid value */
1055 
1056 /* This is for text chunks */
1057 #define PNG_KEYWORD_MAX_LENGTH 79
1058 
1059 /* Maximum number of entries in PLTE/sPLT/tRNS arrays */
1060 #define PNG_MAX_PALETTE_LENGTH 256
1061 
1062 /* These determine if an ancillary chunk's data has been successfully read
1063  * from the PNG header, or if the application has filled in the corresponding
1064  * data in the info_struct to be written into the output file. The values
1065  * of the PNG_INFO_<chunk> defines should NOT be changed.
1066  */
1067 #define PNG_INFO_gAMA 0x0001
1068 #define PNG_INFO_sBIT 0x0002
1069 #define PNG_INFO_cHRM 0x0004
1070 #define PNG_INFO_PLTE 0x0008
1071 #define PNG_INFO_tRNS 0x0010
1072 #define PNG_INFO_bKGD 0x0020
1073 #define PNG_INFO_hIST 0x0040
1074 #define PNG_INFO_pHYs 0x0080
1075 #define PNG_INFO_oFFs 0x0100
1076 #define PNG_INFO_tIME 0x0200
1077 #define PNG_INFO_pCAL 0x0400
1078 #define PNG_INFO_sRGB 0x0800 /* GR-P, 0.96a */
1079 #define PNG_INFO_iCCP 0x1000 /* ESR, 1.0.6 */
1080 #define PNG_INFO_sPLT 0x2000 /* ESR, 1.0.6 */
1081 #define PNG_INFO_sCAL 0x4000 /* ESR, 1.0.6 */
1082 #define PNG_INFO_IDAT 0x8000L /* ESR, 1.0.6 */
1083 
1084 /* This is used for the transformation routines, as some of them
1085  * change these values for the row. It also should enable using
1086  * the routines for other purposes.
1087  */
1088 typedef struct png_row_info_struct
1089 {
1090  png_uint_32 width; /* width of row */
1091  png_uint_32 rowbytes; /* number of bytes in row */
1092  png_byte color_type; /* color type of row */
1093  png_byte bit_depth; /* bit depth of row */
1094  png_byte channels; /* number of channels (1, 2, 3, or 4) */
1095  png_byte pixel_depth; /* bits per pixel (depth * channels) */
1096 } png_row_info;
1097 
1100 
1101 /* These are the function types for the I/O functions and for the functions
1102  * that allow the user to override the default I/O functions with his or her
1103  * own. The png_error_ptr type should match that of user-supplied warning
1104  * and error functions, while the png_rw_ptr type should match that of the
1105  * user read/write data functions.
1106  */
1109 
1110 typedef void (PNGAPI *png_error_ptr) PNGARG((png_structp, png_const_charp));
1111 typedef void (PNGAPI *png_rw_ptr) PNGARG((png_structp, png_bytep, png_size_t));
1112 typedef void (PNGAPI *png_flush_ptr) PNGARG((png_structp));
1113 typedef void (PNGAPI *png_read_status_ptr) PNGARG((png_structp, png_uint_32,
1114  int));
1115 typedef void (PNGAPI *png_write_status_ptr) PNGARG((png_structp, png_uint_32,
1116  int));
1117 
1118 #ifdef PNG_PROGRESSIVE_READ_SUPPORTED
1119 typedef void (PNGAPI *png_progressive_info_ptr) PNGARG((png_structp, png_infop));
1120 typedef void (PNGAPI *png_progressive_end_ptr) PNGARG((png_structp, png_infop));
1121 typedef void (PNGAPI *png_progressive_row_ptr) PNGARG((png_structp, png_bytep,
1122  png_uint_32, int));
1123 #endif
1124 
1125 #if defined(PNG_READ_USER_TRANSFORM_SUPPORTED) || \
1126  defined(PNG_WRITE_USER_TRANSFORM_SUPPORTED) || \
1127  defined(PNG_LEGACY_SUPPORTED)
1128 typedef void (PNGAPI *png_user_transform_ptr) PNGARG((png_structp,
1129  png_row_infop, png_bytep));
1130 #endif
1131 
1132 #if defined(PNG_USER_CHUNKS_SUPPORTED)
1133 typedef int (PNGAPI *png_user_chunk_ptr) PNGARG((png_structp, png_unknown_chunkp));
1134 #endif
1135 #if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED)
1136 typedef void (PNGAPI *png_unknown_chunk_ptr) PNGARG((png_structp));
1137 #endif
1138 
1139 /* Transform masks for the high-level interface */
1140 #define PNG_TRANSFORM_IDENTITY 0x0000 /* read and write */
1141 #define PNG_TRANSFORM_STRIP_16 0x0001 /* read only */
1142 #define PNG_TRANSFORM_STRIP_ALPHA 0x0002 /* read only */
1143 #define PNG_TRANSFORM_PACKING 0x0004 /* read and write */
1144 #define PNG_TRANSFORM_PACKSWAP 0x0008 /* read and write */
1145 #define PNG_TRANSFORM_EXPAND 0x0010 /* read only */
1146 #define PNG_TRANSFORM_INVERT_MONO 0x0020 /* read and write */
1147 #define PNG_TRANSFORM_SHIFT 0x0040 /* read and write */
1148 #define PNG_TRANSFORM_BGR 0x0080 /* read and write */
1149 #define PNG_TRANSFORM_SWAP_ALPHA 0x0100 /* read and write */
1150 #define PNG_TRANSFORM_SWAP_ENDIAN 0x0200 /* read and write */
1151 #define PNG_TRANSFORM_INVERT_ALPHA 0x0400 /* read and write */
1152 #define PNG_TRANSFORM_STRIP_FILLER 0x0800 /* WRITE only */
1153 
1154 /* Flags for MNG supported features */
1155 #define PNG_FLAG_MNG_EMPTY_PLTE 0x01
1156 #define PNG_FLAG_MNG_FILTER_64 0x04
1157 #define PNG_ALL_MNG_FEATURES 0x05
1158 
1159 typedef png_voidp (*png_malloc_ptr) PNGARG((png_structp, png_size_t));
1160 typedef void (*png_free_ptr) PNGARG((png_structp, png_voidp));
1161 
1162 /* The structure that holds the information to read and write PNG files.
1163  * The only people who need to care about what is inside of this are the
1164  * people who will be modifying the library for their own special needs.
1165  * It should NOT be accessed directly by an application, except to store
1166  * the jmp_buf.
1167  */
1168 
1170 {
1171 #ifdef PNG_SETJMP_SUPPORTED
1172  jmp_buf jmpbuf; /* used in png_error */
1173 #endif
1174  png_error_ptr error_fn; /* function for printing errors and aborting */
1175  png_error_ptr warning_fn; /* function for printing warnings */
1176  png_voidp error_ptr; /* user supplied struct for error functions */
1177  png_rw_ptr write_data_fn; /* function for writing output data */
1178  png_rw_ptr read_data_fn; /* function for reading input data */
1179  png_voidp io_ptr; /* ptr to application struct for I/O functions */
1180 
1181 #if defined(PNG_READ_USER_TRANSFORM_SUPPORTED)
1182  png_user_transform_ptr read_user_transform_fn; /* user read transform */
1183 #endif
1184 
1185 #if defined(PNG_WRITE_USER_TRANSFORM_SUPPORTED)
1186  png_user_transform_ptr write_user_transform_fn; /* user write transform */
1187 #endif
1188 
1189 /* These were added in libpng-1.0.2 */
1190 #if defined(PNG_USER_TRANSFORM_PTR_SUPPORTED)
1191 #if defined(PNG_READ_USER_TRANSFORM_SUPPORTED) || \
1192  defined(PNG_WRITE_USER_TRANSFORM_SUPPORTED)
1193  png_voidp user_transform_ptr; /* user supplied struct for user transform */
1194  png_byte user_transform_depth; /* bit depth of user transformed pixels */
1195  png_byte user_transform_channels; /* channels in user transformed pixels */
1196 #endif
1197 #endif
1198 
1199  png_uint_32 mode; /* tells us where we are in the PNG file */
1200  png_uint_32 flags; /* flags indicating various things to libpng */
1201  png_uint_32 transformations; /* which transformations to perform */
1202 
1203  z_stream zstream; /* pointer to decompression structure (below) */
1204  png_bytep zbuf; /* buffer for zlib */
1205  png_size_t zbuf_size; /* size of zbuf */
1206  int zlib_level; /* holds zlib compression level */
1207  int zlib_method; /* holds zlib compression method */
1208  int zlib_window_bits; /* holds zlib compression window bits */
1209  int zlib_mem_level; /* holds zlib compression memory level */
1210  int zlib_strategy; /* holds zlib compression strategy */
1211 
1212  png_uint_32 width; /* width of image in pixels */
1213  png_uint_32 height; /* height of image in pixels */
1214  png_uint_32 num_rows; /* number of rows in current pass */
1215  png_uint_32 usr_width; /* width of row at start of write */
1216  png_uint_32 rowbytes; /* size of row in bytes */
1217  png_uint_32 irowbytes; /* size of current interlaced row in bytes */
1218  png_uint_32 iwidth; /* width of current interlaced row in pixels */
1219  png_uint_32 row_number; /* current row in interlace pass */
1220  png_bytep prev_row; /* buffer to save previous (unfiltered) row */
1221  png_bytep row_buf; /* buffer to save current (unfiltered) row */
1222 #ifndef PNG_NO_WRITE_FILTER
1223  png_bytep sub_row; /* buffer to save "sub" row when filtering */
1224  png_bytep up_row; /* buffer to save "up" row when filtering */
1225  png_bytep avg_row; /* buffer to save "avg" row when filtering */
1226  png_bytep paeth_row; /* buffer to save "Paeth" row when filtering */
1227 #endif
1228  png_row_info row_info; /* used for transformation routines */
1229 
1230  png_uint_32 idat_size; /* current IDAT size for read */
1231  png_uint_32 crc; /* current chunk CRC value */
1232  png_colorp palette; /* palette from the input file */
1233  png_uint_16 num_palette; /* number of color entries in palette */
1234  png_uint_16 num_trans; /* number of transparency values */
1235  png_byte chunk_name[5]; /* null-terminated name of current chunk */
1236  png_byte compression; /* file compression type (always 0) */
1237  png_byte filter; /* file filter type (always 0) */
1238  png_byte interlaced; /* PNG_INTERLACE_NONE, PNG_INTERLACE_ADAM7 */
1239  png_byte pass; /* current interlace pass (0 - 6) */
1240  png_byte do_filter; /* row filter flags (see PNG_FILTER_ below ) */
1241  png_byte color_type; /* color type of file */
1242  png_byte bit_depth; /* bit depth of file */
1243  png_byte usr_bit_depth; /* bit depth of users row */
1244  png_byte pixel_depth; /* number of bits per pixel */
1245  png_byte channels; /* number of channels in file */
1246  png_byte usr_channels; /* channels at start of write */
1247  png_byte sig_bytes; /* magic bytes read/written from start of file */
1248 
1249 #if defined(PNG_READ_FILLER_SUPPORTED) || defined(PNG_WRITE_FILLER_SUPPORTED)
1250 #ifdef PNG_LEGACY_SUPPORTED
1251  png_byte filler; /* filler byte for pixel expansion */
1252 #else
1253  png_uint_16 filler; /* filler bytes for pixel expansion */
1254 #endif
1255 #endif
1256 
1257 #if defined(PNG_bKGD_SUPPORTED)
1259 # ifdef PNG_FLOATING_POINT_SUPPORTED
1261 # endif
1262  png_color_16 background; /* background color in screen gamma space */
1263 #if defined(PNG_READ_GAMMA_SUPPORTED)
1264  png_color_16 background_1; /* background normalized to gamma 1.0 */
1265 #endif
1266 #endif /* PNG_bKGD_SUPPORTED */
1267 
1268 #if defined(PNG_WRITE_FLUSH_SUPPORTED)
1269  png_flush_ptr output_flush_fn;/* Function for flushing output */
1270  png_uint_32 flush_dist; /* how many rows apart to flush, 0 - no flush */
1271  png_uint_32 flush_rows; /* number of rows written since last flush */
1272 #endif
1273 
1274 #if defined(PNG_READ_GAMMA_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED)
1275  int gamma_shift; /* number of "insignificant" bits 16-bit gamma */
1276 #ifdef PNG_FLOATING_POINT_SUPPORTED
1277  float gamma; /* file gamma value */
1278  float screen_gamma; /* screen gamma value (display_exponent) */
1279 #endif
1280 #endif
1281 
1282 #if defined(PNG_READ_GAMMA_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED)
1283  png_bytep gamma_table; /* gamma table for 8-bit depth files */
1284  png_bytep gamma_from_1; /* converts from 1.0 to screen */
1285  png_bytep gamma_to_1; /* converts from file to 1.0 */
1286  png_uint_16pp gamma_16_table; /* gamma table for 16-bit depth files */
1287  png_uint_16pp gamma_16_from_1; /* converts from 1.0 to screen */
1288  png_uint_16pp gamma_16_to_1; /* converts from file to 1.0 */
1289 #endif
1290 
1291 #if defined(PNG_READ_GAMMA_SUPPORTED) || defined(PNG_sBIT_SUPPORTED)
1292  png_color_8 sig_bit; /* significant bits in each available channel */
1293 #endif
1294 
1295 #if defined(PNG_READ_SHIFT_SUPPORTED) || defined(PNG_WRITE_SHIFT_SUPPORTED)
1296  png_color_8 shift; /* shift for significant bit tranformation */
1297 #endif
1298 
1299 #if defined(PNG_tRNS_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED) \
1300  || defined(PNG_READ_EXPAND_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED)
1301  png_bytep trans; /* transparency values for paletted files */
1302  png_color_16 trans_values; /* transparency values for non-paletted files */
1303 #endif
1304 
1305  png_read_status_ptr read_row_fn; /* called after each row is decoded */
1306  png_write_status_ptr write_row_fn; /* called after each row is encoded */
1307 #ifdef PNG_PROGRESSIVE_READ_SUPPORTED
1308  png_progressive_info_ptr info_fn; /* called after header data fully read */
1309  png_progressive_row_ptr row_fn; /* called after each prog. row is decoded */
1310  png_progressive_end_ptr end_fn; /* called after image is complete */
1311  png_bytep save_buffer_ptr; /* current location in save_buffer */
1312  png_bytep save_buffer; /* buffer for previously read data */
1313  png_bytep current_buffer_ptr; /* current location in current_buffer */
1314  png_bytep current_buffer; /* buffer for recently used data */
1315  png_uint_32 push_length; /* size of current input chunk */
1316  png_uint_32 skip_length; /* bytes to skip in input data */
1317  png_size_t save_buffer_size; /* amount of data now in save_buffer */
1318  png_size_t save_buffer_max; /* total size of save_buffer */
1319  png_size_t buffer_size; /* total amount of available input data */
1320  png_size_t current_buffer_size; /* amount of data now in current_buffer */
1321  int process_mode; /* what push library is currently doing */
1322  int cur_palette; /* current push library palette index */
1323 
1324 # if defined(PNG_TEXT_SUPPORTED)
1325  png_size_t current_text_size; /* current size of text input data */
1326  png_size_t current_text_left; /* how much text left to read in input */
1327  png_charp current_text; /* current text chunk buffer */
1328  png_charp current_text_ptr; /* current location in current_text */
1329 # endif /* PNG_TEXT_SUPPORTED */
1330 #endif /* PNG_PROGRESSIVE_READ_SUPPORTED */
1331 
1332 #if defined(__TURBOC__) && !defined(_Windows) && !defined(__FLAT__)
1333 /* for the Borland special 64K segment handler */
1334  png_bytepp offset_table_ptr;
1335  png_bytep offset_table;
1336  png_uint_16 offset_table_number;
1337  png_uint_16 offset_table_count;
1338  png_uint_16 offset_table_count_free;
1339 #endif
1340 
1341 #if defined(PNG_READ_DITHER_SUPPORTED)
1342  png_bytep palette_lookup; /* lookup table for dithering */
1343  png_bytep dither_index; /* index translation for palette files */
1344 #endif
1345 
1346 #if defined(PNG_READ_DITHER_SUPPORTED) || defined(PNG_hIST_SUPPORTED)
1347  png_uint_16p hist; /* histogram */
1348 #endif
1349 
1350 #if defined(PNG_WRITE_WEIGHTED_FILTER_SUPPORTED)
1351  png_byte heuristic_method; /* heuristic for row filter selection */
1352  png_byte num_prev_filters; /* number of weights for previous rows */
1353  png_bytep prev_filters; /* filter type(s) of previous row(s) */
1354  png_uint_16p filter_weights; /* weight(s) for previous line(s) */
1355  png_uint_16p inv_filter_weights; /* 1/weight(s) for previous line(s) */
1356  png_uint_16p filter_costs; /* relative filter calculation cost */
1357  png_uint_16p inv_filter_costs; /* 1/relative filter calculation cost */
1358 #endif
1359 
1360 #if defined(PNG_TIME_RFC1123_SUPPORTED)
1361  png_charp time_buffer; /* String to hold RFC 1123 time text */
1362 #endif
1363 
1364 /* New members added in libpng-1.0.6 */
1365 
1366 #ifdef PNG_FREE_ME_SUPPORTED
1367  png_uint_32 free_me; /* flags items libpng is responsible for freeing */
1368 #endif
1369 
1370 #if defined(PNG_USER_CHUNKS_SUPPORTED)
1371  png_voidp user_chunk_ptr;
1372  png_user_chunk_ptr read_user_chunk_fn; /* user read chunk handler */
1373 #endif
1374 
1375 #if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED)
1378 #endif
1379 
1380 /* New members added in libpng-1.0.3 */
1381 #if defined(PNG_READ_RGB_TO_GRAY_SUPPORTED)
1383  /* These were changed from png_byte in libpng-1.0.6 */
1387 #endif
1388 
1389 /* New member added in libpng-1.0.4 (renamed in 1.0.9) */
1390 #if defined(PNG_MNG_FEATURES_SUPPORTED) || \
1391  defined(PNG_READ_EMPTY_PLTE_SUPPORTED) || \
1392  defined(PNG_WRITE_EMPTY_PLTE_SUPPORTED)
1393 /* changed from png_byte to png_uint_32 at version 1.2.0 */
1394 #ifdef PNG_1_0_X
1396 #else
1398 #endif /* PNG_1_0_X */
1399 #endif
1400 
1401 /* New member added in libpng-1.0.7 */
1402 #if defined(PNG_READ_GAMMA_SUPPORTED) || defined(PNG_READ_BACKGROUND_SUPPORTED)
1404 #endif
1405 
1406 /* New member added in libpng-1.0.9, ifdef'ed out in 1.0.12, enabled in 1.2.0 */
1407 #if defined(PNG_MNG_FEATURES_SUPPORTED)
1409 #endif
1410 
1411 #if defined(PNG_1_0_X)
1412 /* New member added in libpng-1.0.10, ifdef'ed out in 1.2.0 */
1413  png_uint_32 row_buf_size;
1414 #endif
1415 
1416 /* New members added in libpng-1.2.0 */
1417 #if defined(PNG_ASSEMBLER_CODE_SUPPORTED)
1418 # if !defined(PNG_1_0_X)
1419 # if defined(PNG_MMX_CODE_SUPPORTED)
1422 # endif
1424 # endif
1425 #endif
1426 
1427 /* New members added in libpng-1.0.2 but first enabled by default in 1.2.0 */
1428 #ifdef PNG_USER_MEM_SUPPORTED
1429  png_voidp mem_ptr; /* user supplied struct for mem functions */
1430  png_malloc_ptr malloc_fn; /* function for allocating memory */
1431  png_free_ptr free_fn; /* function for freeing memory */
1432 #endif
1433 
1434 /* New member added in libpng-1.0.13 and 1.2.0 */
1435  png_bytep big_row_buf; /* buffer to save current (unfiltered) row */
1436 
1437 #if defined(PNG_READ_DITHER_SUPPORTED)
1438 /* The following three members were added at version 1.0.14 and 1.2.4 */
1439  png_bytep dither_sort; /* working sort array */
1440  png_bytep index_to_palette; /* where the original index currently is */
1441  /* in the palette */
1442  png_bytep palette_to_index; /* which original index points to this */
1443  /* palette color */
1444 #endif
1445 
1446 /* New members added in libpng-1.0.16 and 1.2.6 */
1448 
1449 #ifdef PNG_SET_USER_LIMITS_SUPPORTED
1452 #endif
1453 
1454 /* New member added in libpng-1.0.25 and 1.2.17 */
1455 #if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED)
1456  /* storage for unknown chunk that the library doesn't recognize. */
1458 #endif
1459 
1460 /* New members added in libpng-1.2.26 */
1462 
1463 /* New member added in libpng-1.2.30 */
1464  png_charp chunkdata; /* buffer for reading chunk data */
1465 
1466 };
1467 
1468 
1469 /* This triggers a compiler error in png.c, if png.c and png.h
1470  * do not agree upon the version number.
1471  */
1472 typedef png_structp version_1_2_32;
1473 
1475 
1476 /* Here are the function definitions most commonly used. This is not
1477  * the place to find out how to use libpng. See libpng.txt for the
1478  * full explanation, see example.c for the summary. This just provides
1479  * a simple one line description of the use of each function.
1480  */
1481 
1482 /* Returns the version number of the library */
1484 
1485 /* Tell lib we have already handled the first <num_bytes> magic bytes.
1486  * Handling more than 8 bytes from the beginning of the file is an error.
1487  */
1488 extern PNG_EXPORT(void,png_set_sig_bytes) PNGARG((png_structp png_ptr,
1489  int num_bytes));
1490 
1491 /* Check sig[start] through sig[start + num_to_check - 1] to see if it's a
1492  * PNG file. Returns zero if the supplied bytes match the 8-byte PNG
1493  * signature, and non-zero otherwise. Having num_to_check == 0 or
1494  * start > 7 will always fail (ie return non-zero).
1495  */
1498 
1499 /* Simple signature checking function. This is the same as calling
1500  * png_check_sig(sig, n) := !png_sig_cmp(sig, 0, n).
1501  */
1502 extern PNG_EXPORT(int,png_check_sig) PNGARG((png_bytep sig, int num));
1503 
1504 /* Allocate and initialize png_ptr struct for reading, and any other memory. */
1505 extern PNG_EXPORT(png_structp,png_create_read_struct)
1507  png_error_ptr error_fn, png_error_ptr warn_fn));
1508 
1509 /* Allocate and initialize png_ptr struct for writing, and any other memory */
1510 extern PNG_EXPORT(png_structp,png_create_write_struct)
1511  PNGARG((png_const_charp user_png_ver, png_voidp error_ptr,
1512  png_error_ptr error_fn, png_error_ptr warn_fn));
1513 
1514 #ifdef PNG_WRITE_SUPPORTED
1516  PNGARG((png_structp png_ptr));
1517 #endif
1518 
1519 #ifdef PNG_WRITE_SUPPORTED
1521  PNGARG((png_structp png_ptr, png_uint_32 size));
1522 #endif
1523 
1524 /* Reset the compression stream */
1525 extern PNG_EXPORT(int,png_reset_zstream) PNGARG((png_structp png_ptr));
1526 
1527 /* New functions added in libpng-1.0.2 (not enabled by default until 1.2.0) */
1528 #ifdef PNG_USER_MEM_SUPPORTED
1529 extern PNG_EXPORT(png_structp,png_create_read_struct_2)
1530  PNGARG((png_const_charp user_png_ver, png_voidp error_ptr,
1531  png_error_ptr error_fn, png_error_ptr warn_fn, png_voidp mem_ptr,
1532  png_malloc_ptr malloc_fn, png_free_ptr free_fn));
1533 extern PNG_EXPORT(png_structp,png_create_write_struct_2)
1534  PNGARG((png_const_charp user_png_ver, png_voidp error_ptr,
1535  png_error_ptr error_fn, png_error_ptr warn_fn, png_voidp mem_ptr,
1536  png_malloc_ptr malloc_fn, png_free_ptr free_fn));
1537 #endif
1538 
1539 /* Write a PNG chunk - size, type, (optional) data, CRC. */
1540 extern PNG_EXPORT(void,png_write_chunk) PNGARG((png_structp png_ptr,
1542 
1543 /* Write the start of a PNG chunk - length and chunk name. */
1544 extern PNG_EXPORT(void,png_write_chunk_start) PNGARG((png_structp png_ptr,
1545  png_bytep chunk_name, png_uint_32 length));
1546 
1547 /* Write the data of a PNG chunk started with png_write_chunk_start(). */
1548 extern PNG_EXPORT(void,png_write_chunk_data) PNGARG((png_structp png_ptr,
1549  png_bytep data, png_size_t length));
1550 
1551 /* Finish a chunk started with png_write_chunk_start() (includes CRC). */
1552 extern PNG_EXPORT(void,png_write_chunk_end) PNGARG((png_structp png_ptr));
1553 
1554 /* Allocate and initialize the info structure */
1555 extern PNG_EXPORT(png_infop,png_create_info_struct)
1556  PNGARG((png_structp png_ptr));
1557 
1558 #if defined(PNG_1_0_X) || defined (PNG_1_2_X)
1559 /* Initialize the info structure (old interface - DEPRECATED) */
1560 extern PNG_EXPORT(void,png_info_init) PNGARG((png_infop info_ptr));
1561 #undef png_info_init
1562 #define png_info_init(info_ptr) png_info_init_3(&info_ptr,\
1563  png_sizeof(png_info));
1564 #endif
1565 
1566 extern PNG_EXPORT(void,png_info_init_3) PNGARG((png_infopp info_ptr,
1568 
1569 /* Writes all the PNG information before the image. */
1570 extern PNG_EXPORT(void,png_write_info_before_PLTE) PNGARG((png_structp png_ptr,
1571  png_infop info_ptr));
1572 extern PNG_EXPORT(void,png_write_info) PNGARG((png_structp png_ptr,
1573  png_infop info_ptr));
1574 
1575 #ifndef PNG_NO_SEQUENTIAL_READ_SUPPORTED
1576 /* read the information before the actual image data. */
1577 extern PNG_EXPORT(void,png_read_info) PNGARG((png_structp png_ptr,
1578  png_infop info_ptr));
1579 #endif
1580 
1581 #if defined(PNG_TIME_RFC1123_SUPPORTED)
1583  PNGARG((png_structp png_ptr, png_timep ptime));
1584 #endif
1585 
1586 #if !defined(_WIN32_WCE)
1587 /* "time.h" functions are not supported on WindowsCE */
1588 #if defined(PNG_WRITE_tIME_SUPPORTED)
1589 /* convert from a struct tm to png_time */
1590 extern PNG_EXPORT(void,png_convert_from_struct_tm) PNGARG((png_timep ptime,
1591  struct tm FAR * ttime));
1592 
1593 /* convert from time_t to png_time. Uses gmtime() */
1594 extern PNG_EXPORT(void,png_convert_from_time_t) PNGARG((png_timep ptime,
1595  time_t ttime));
1596 #endif /* PNG_WRITE_tIME_SUPPORTED */
1597 #endif /* _WIN32_WCE */
1598 
1599 #if defined(PNG_READ_EXPAND_SUPPORTED)
1600 /* Expand data to 24-bit RGB, or 8-bit grayscale, with alpha if available. */
1601 extern PNG_EXPORT(void,png_set_expand) PNGARG((png_structp png_ptr));
1602 #if !defined(PNG_1_0_X)
1603 extern PNG_EXPORT(void,png_set_expand_gray_1_2_4_to_8) PNGARG((png_structp
1604  png_ptr));
1605 #endif
1606 extern PNG_EXPORT(void,png_set_palette_to_rgb) PNGARG((png_structp png_ptr));
1607 extern PNG_EXPORT(void,png_set_tRNS_to_alpha) PNGARG((png_structp png_ptr));
1608 #if defined(PNG_1_0_X) || defined (PNG_1_2_X)
1609 /* Deprecated */
1610 extern PNG_EXPORT(void,png_set_gray_1_2_4_to_8) PNGARG((png_structp png_ptr));
1611 #endif
1612 #endif
1613 
1614 #if defined(PNG_READ_BGR_SUPPORTED) || defined(PNG_WRITE_BGR_SUPPORTED)
1615 /* Use blue, green, red order for pixels. */
1616 extern PNG_EXPORT(void,png_set_bgr) PNGARG((png_structp png_ptr));
1617 #endif
1618 
1619 #if defined(PNG_READ_GRAY_TO_RGB_SUPPORTED)
1620 /* Expand the grayscale to 24-bit RGB if necessary. */
1621 extern PNG_EXPORT(void,png_set_gray_to_rgb) PNGARG((png_structp png_ptr));
1622 #endif
1623 
1624 #if defined(PNG_READ_RGB_TO_GRAY_SUPPORTED)
1625 /* Reduce RGB to grayscale. */
1626 #ifdef PNG_FLOATING_POINT_SUPPORTED
1627 extern PNG_EXPORT(void,png_set_rgb_to_gray) PNGARG((png_structp png_ptr,
1628  int error_action, double red, double green ));
1629 #endif
1630 extern PNG_EXPORT(void,png_set_rgb_to_gray_fixed) PNGARG((png_structp png_ptr,
1631  int error_action, png_fixed_point red, png_fixed_point green ));
1633  png_ptr));
1634 #endif
1635 
1637  png_colorp palette));
1638 
1639 #if defined(PNG_READ_STRIP_ALPHA_SUPPORTED)
1640 extern PNG_EXPORT(void,png_set_strip_alpha) PNGARG((png_structp png_ptr));
1641 #endif
1642 
1643 #if defined(PNG_READ_SWAP_ALPHA_SUPPORTED) || \
1644  defined(PNG_WRITE_SWAP_ALPHA_SUPPORTED)
1645 extern PNG_EXPORT(void,png_set_swap_alpha) PNGARG((png_structp png_ptr));
1646 #endif
1647 
1648 #if defined(PNG_READ_INVERT_ALPHA_SUPPORTED) || \
1649  defined(PNG_WRITE_INVERT_ALPHA_SUPPORTED)
1650 extern PNG_EXPORT(void,png_set_invert_alpha) PNGARG((png_structp png_ptr));
1651 #endif
1652 
1653 #if defined(PNG_READ_FILLER_SUPPORTED) || defined(PNG_WRITE_FILLER_SUPPORTED)
1654 /* Add a filler byte to 8-bit Gray or 24-bit RGB images. */
1655 extern PNG_EXPORT(void,png_set_filler) PNGARG((png_structp png_ptr,
1657 /* The values of the PNG_FILLER_ defines should NOT be changed */
1658 #define PNG_FILLER_BEFORE 0
1659 #define PNG_FILLER_AFTER 1
1660 /* Add an alpha byte to 8-bit Gray or 24-bit RGB images. */
1661 #if !defined(PNG_1_0_X)
1662 extern PNG_EXPORT(void,png_set_add_alpha) PNGARG((png_structp png_ptr,
1663  png_uint_32 filler, int flags));
1664 #endif
1665 #endif /* PNG_READ_FILLER_SUPPORTED || PNG_WRITE_FILLER_SUPPORTED */
1666 
1667 #if defined(PNG_READ_SWAP_SUPPORTED) || defined(PNG_WRITE_SWAP_SUPPORTED)
1668 /* Swap bytes in 16-bit depth files. */
1669 extern PNG_EXPORT(void,png_set_swap) PNGARG((png_structp png_ptr));
1670 #endif
1671 
1672 #if defined(PNG_READ_PACK_SUPPORTED) || defined(PNG_WRITE_PACK_SUPPORTED)
1673 /* Use 1 byte per pixel in 1, 2, or 4-bit depth files. */
1674 extern PNG_EXPORT(void,png_set_packing) PNGARG((png_structp png_ptr));
1675 #endif
1676 
1677 #if defined(PNG_READ_PACKSWAP_SUPPORTED) || defined(PNG_WRITE_PACKSWAP_SUPPORTED)
1678 /* Swap packing order of pixels in bytes. */
1679 extern PNG_EXPORT(void,png_set_packswap) PNGARG((png_structp png_ptr));
1680 #endif
1681 
1682 #if defined(PNG_READ_SHIFT_SUPPORTED) || defined(PNG_WRITE_SHIFT_SUPPORTED)
1683 /* Converts files to legal bit depths. */
1684 extern PNG_EXPORT(void,png_set_shift) PNGARG((png_structp png_ptr,
1685  png_color_8p true_bits));
1686 #endif
1687 
1688 #if defined(PNG_READ_INTERLACING_SUPPORTED) || \
1689  defined(PNG_WRITE_INTERLACING_SUPPORTED)
1690 /* Have the code handle the interlacing. Returns the number of passes. */
1691 extern PNG_EXPORT(int,png_set_interlace_handling) PNGARG((png_structp png_ptr));
1692 #endif
1693 
1694 #if defined(PNG_READ_INVERT_SUPPORTED) || defined(PNG_WRITE_INVERT_SUPPORTED)
1695 /* Invert monochrome files */
1696 extern PNG_EXPORT(void,png_set_invert_mono) PNGARG((png_structp png_ptr));
1697 #endif
1698 
1699 #if defined(PNG_READ_BACKGROUND_SUPPORTED)
1700 /* Handle alpha and tRNS by replacing with a background color. */
1701 #ifdef PNG_FLOATING_POINT_SUPPORTED
1702 extern PNG_EXPORT(void,png_set_background) PNGARG((png_structp png_ptr,
1704  int need_expand, double background_gamma));
1705 #endif
1706 #define PNG_BACKGROUND_GAMMA_UNKNOWN 0
1707 #define PNG_BACKGROUND_GAMMA_SCREEN 1
1708 #define PNG_BACKGROUND_GAMMA_FILE 2
1709 #define PNG_BACKGROUND_GAMMA_UNIQUE 3
1710 #endif
1711 
1712 #if defined(PNG_READ_16_TO_8_SUPPORTED)
1713 /* strip the second byte of information from a 16-bit depth file. */
1714 extern PNG_EXPORT(void,png_set_strip_16) PNGARG((png_structp png_ptr));
1715 #endif
1716 
1717 #if defined(PNG_READ_DITHER_SUPPORTED)
1718 /* Turn on dithering, and reduce the palette to the number of colors available. */
1719 extern PNG_EXPORT(void,png_set_dither) PNGARG((png_structp png_ptr,
1720  png_colorp palette, int num_palette, int maximum_colors,
1722 #endif
1723 
1724 #if defined(PNG_READ_GAMMA_SUPPORTED)
1725 /* Handle gamma correction. Screen_gamma=(display_exponent) */
1726 #ifdef PNG_FLOATING_POINT_SUPPORTED
1727 extern PNG_EXPORT(void,png_set_gamma) PNGARG((png_structp png_ptr,
1729 #endif
1730 #endif
1731 
1732 #if defined(PNG_1_0_X) || defined (PNG_1_2_X)
1733 #if defined(PNG_READ_EMPTY_PLTE_SUPPORTED) || \
1734  defined(PNG_WRITE_EMPTY_PLTE_SUPPORTED)
1735 /* Permit or disallow empty PLTE (0: not permitted, 1: permitted) */
1736 /* Deprecated and will be removed. Use png_permit_mng_features() instead. */
1737 extern PNG_EXPORT(void,png_permit_empty_plte) PNGARG((png_structp png_ptr,
1739 #endif
1740 #endif
1741 
1742 #if defined(PNG_WRITE_FLUSH_SUPPORTED)
1743 /* Set how many lines between output flushes - 0 for no flushing */
1744 extern PNG_EXPORT(void,png_set_flush) PNGARG((png_structp png_ptr, int nrows));
1745 /* Flush the current PNG output buffer */
1746 extern PNG_EXPORT(void,png_write_flush) PNGARG((png_structp png_ptr));
1747 #endif
1748 
1749 /* optional update palette with requested transformations */
1750 extern PNG_EXPORT(void,png_start_read_image) PNGARG((png_structp png_ptr));
1751 
1752 /* optional call to update the users info structure */
1753 extern PNG_EXPORT(void,png_read_update_info) PNGARG((png_structp png_ptr,
1754  png_infop info_ptr));
1755 
1756 #ifndef PNG_NO_SEQUENTIAL_READ_SUPPORTED
1757 /* read one or more rows of image data. */
1758 extern PNG_EXPORT(void,png_read_rows) PNGARG((png_structp png_ptr,
1760 #endif
1761 
1762 #ifndef PNG_NO_SEQUENTIAL_READ_SUPPORTED
1763 /* read a row of data. */
1764 extern PNG_EXPORT(void,png_read_row) PNGARG((png_structp png_ptr,
1765  png_bytep row,
1766  png_bytep display_row));
1767 #endif
1768 
1769 #ifndef PNG_NO_SEQUENTIAL_READ_SUPPORTED
1770 /* read the whole image into memory at once. */
1771 extern PNG_EXPORT(void,png_read_image) PNGARG((png_structp png_ptr,
1773 #endif
1774 
1775 /* write a row of image data */
1776 extern PNG_EXPORT(void,png_write_row) PNGARG((png_structp png_ptr,
1777  png_bytep row));
1778 
1779 /* write a few rows of image data */
1780 extern PNG_EXPORT(void,png_write_rows) PNGARG((png_structp png_ptr,
1781  png_bytepp row, png_uint_32 num_rows));
1782 
1783 /* write the image data */
1784 extern PNG_EXPORT(void,png_write_image) PNGARG((png_structp png_ptr,
1785  png_bytepp image));
1786 
1787 /* writes the end of the PNG file. */
1788 extern PNG_EXPORT(void,png_write_end) PNGARG((png_structp png_ptr,
1789  png_infop info_ptr));
1790 
1791 #ifndef PNG_NO_SEQUENTIAL_READ_SUPPORTED
1792 /* read the end of the PNG file. */
1793 extern PNG_EXPORT(void,png_read_end) PNGARG((png_structp png_ptr,
1794  png_infop info_ptr));
1795 #endif
1796 
1797 /* free any memory associated with the png_info_struct */
1798 extern PNG_EXPORT(void,png_destroy_info_struct) PNGARG((png_structp png_ptr,
1799  png_infopp info_ptr_ptr));
1800 
1801 /* free any memory associated with the png_struct and the png_info_structs */
1802 extern PNG_EXPORT(void,png_destroy_read_struct) PNGARG((png_structpp
1803  png_ptr_ptr, png_infopp info_ptr_ptr, png_infopp end_info_ptr_ptr));
1804 
1805 /* free all memory used by the read (old method - NOT DLL EXPORTED) */
1806 extern void png_read_destroy PNGARG((png_structp png_ptr, png_infop info_ptr,
1807  png_infop end_info_ptr));
1808 
1809 /* free any memory associated with the png_struct and the png_info_structs */
1811  PNGARG((png_structpp png_ptr_ptr, png_infopp info_ptr_ptr));
1812 
1813 /* free any memory used in png_ptr struct (old method - NOT DLL EXPORTED) */
1814 extern void png_write_destroy PNGARG((png_structp png_ptr));
1815 
1816 /* set the libpng method of handling chunk CRC errors */
1817 extern PNG_EXPORT(void,png_set_crc_action) PNGARG((png_structp png_ptr,
1819 
1820 /* Values for png_set_crc_action() to say how to handle CRC errors in
1821  * ancillary and critical chunks, and whether to use the data contained
1822  * therein. Note that it is impossible to "discard" data in a critical
1823  * chunk. For versions prior to 0.90, the action was always error/quit,
1824  * whereas in version 0.90 and later, the action for CRC errors in ancillary
1825  * chunks is warn/discard. These values should NOT be changed.
1826  *
1827  * value action:critical action:ancillary
1828  */
1829 #define PNG_CRC_DEFAULT 0 /* error/quit warn/discard data */
1830 #define PNG_CRC_ERROR_QUIT 1 /* error/quit error/quit */
1831 #define PNG_CRC_WARN_DISCARD 2 /* (INVALID) warn/discard data */
1832 #define PNG_CRC_WARN_USE 3 /* warn/use data warn/use data */
1833 #define PNG_CRC_QUIET_USE 4 /* quiet/use data quiet/use data */
1834 #define PNG_CRC_NO_CHANGE 5 /* use current value use current value */
1835 
1836 /* These functions give the user control over the scan-line filtering in
1837  * libpng and the compression methods used by zlib. These functions are
1838  * mainly useful for testing, as the defaults should work with most users.
1839  * Those users who are tight on memory or want faster performance at the
1840  * expense of compression can modify them. See the compression library
1841  * header file (zlib.h) for an explination of the compression functions.
1842  */
1843 
1844 /* set the filtering method(s) used by libpng. Currently, the only valid
1845  * value for "method" is 0.
1846  */
1847 extern PNG_EXPORT(void,png_set_filter) PNGARG((png_structp png_ptr, int method,
1848  int filters));
1849 
1850 /* Flags for png_set_filter() to say which filters to use. The flags
1851  * are chosen so that they don't conflict with real filter types
1852  * below, in case they are supplied instead of the #defined constants.
1853  * These values should NOT be changed.
1854  */
1855 #define PNG_NO_FILTERS 0x00
1856 #define PNG_FILTER_NONE 0x08
1857 #define PNG_FILTER_SUB 0x10
1858 #define PNG_FILTER_UP 0x20
1859 #define PNG_FILTER_AVG 0x40
1860 #define PNG_FILTER_PAETH 0x80
1861 #define PNG_ALL_FILTERS (PNG_FILTER_NONE | PNG_FILTER_SUB | PNG_FILTER_UP | \
1862  PNG_FILTER_AVG | PNG_FILTER_PAETH)
1863 
1864 /* Filter values (not flags) - used in pngwrite.c, pngwutil.c for now.
1865  * These defines should NOT be changed.
1866  */
1867 #define PNG_FILTER_VALUE_NONE 0
1868 #define PNG_FILTER_VALUE_SUB 1
1869 #define PNG_FILTER_VALUE_UP 2
1870 #define PNG_FILTER_VALUE_AVG 3
1871 #define PNG_FILTER_VALUE_PAETH 4
1872 #define PNG_FILTER_VALUE_LAST 5
1873 
1874 #if defined(PNG_WRITE_WEIGHTED_FILTER_SUPPORTED) /* EXPERIMENTAL */
1875 /* The "heuristic_method" is given by one of the PNG_FILTER_HEURISTIC_
1876  * defines, either the default (minimum-sum-of-absolute-differences), or
1877  * the experimental method (weighted-minimum-sum-of-absolute-differences).
1878  *
1879  * Weights are factors >= 1.0, indicating how important it is to keep the
1880  * filter type consistent between rows. Larger numbers mean the current
1881  * filter is that many times as likely to be the same as the "num_weights"
1882  * previous filters. This is cumulative for each previous row with a weight.
1883  * There needs to be "num_weights" values in "filter_weights", or it can be
1884  * NULL if the weights aren't being specified. Weights have no influence on
1885  * the selection of the first row filter. Well chosen weights can (in theory)
1886  * improve the compression for a given image.
1887  *
1888  * Costs are factors >= 1.0 indicating the relative decoding costs of a
1889  * filter type. Higher costs indicate more decoding expense, and are
1890  * therefore less likely to be selected over a filter with lower computational
1891  * costs. There needs to be a value in "filter_costs" for each valid filter
1892  * type (given by PNG_FILTER_VALUE_LAST), or it can be NULL if you aren't
1893  * setting the costs. Costs try to improve the speed of decompression without
1894  * unduly increasing the compressed image size.
1895  *
1896  * A negative weight or cost indicates the default value is to be used, and
1897  * values in the range [0.0, 1.0) indicate the value is to remain unchanged.
1898  * The default values for both weights and costs are currently 1.0, but may
1899  * change if good general weighting/cost heuristics can be found. If both
1900  * the weights and costs are set to 1.0, this degenerates the WEIGHTED method
1901  * to the UNWEIGHTED method, but with added encoding time/computation.
1902  */
1903 #ifdef PNG_FLOATING_POINT_SUPPORTED
1904 extern PNG_EXPORT(void,png_set_filter_heuristics) PNGARG((png_structp png_ptr,
1907 #endif
1908 #endif /* PNG_WRITE_WEIGHTED_FILTER_SUPPORTED */
1909 
1910 /* Heuristic used for row filter selection. These defines should NOT be
1911  * changed.
1912  */
1913 #define PNG_FILTER_HEURISTIC_DEFAULT 0 /* Currently "UNWEIGHTED" */
1914 #define PNG_FILTER_HEURISTIC_UNWEIGHTED 1 /* Used by libpng < 0.95 */
1915 #define PNG_FILTER_HEURISTIC_WEIGHTED 2 /* Experimental feature */
1916 #define PNG_FILTER_HEURISTIC_LAST 3 /* Not a valid value */
1917 
1918 /* Set the library compression level. Currently, valid values range from
1919  * 0 - 9, corresponding directly to the zlib compression levels 0 - 9
1920  * (0 - no compression, 9 - "maximal" compression). Note that tests have
1921  * shown that zlib compression levels 3-6 usually perform as well as level 9
1922  * for PNG images, and do considerably fewer caclulations. In the future,
1923  * these values may not correspond directly to the zlib compression levels.
1924  */
1925 extern PNG_EXPORT(void,png_set_compression_level) PNGARG((png_structp png_ptr,
1926  int level));
1927 
1929  PNGARG((png_structp png_ptr, int mem_level));
1930 
1932  PNGARG((png_structp png_ptr, int strategy));
1933 
1935  PNGARG((png_structp png_ptr, int window_bits));
1936 
1937 extern PNG_EXPORT(void,png_set_compression_method) PNGARG((png_structp png_ptr,
1938  int method));
1939 
1940 /* These next functions are called for input/output, memory, and error
1941  * handling. They are in the file pngrio.c, pngwio.c, and pngerror.c,
1942  * and call standard C I/O routines such as fread(), fwrite(), and
1943  * fprintf(). These functions can be made to use other I/O routines
1944  * at run time for those applications that need to handle I/O in a
1945  * different manner by calling png_set_???_fn(). See libpng.txt for
1946  * more information.
1947  */
1948 
1949 #if !defined(PNG_NO_STDIO)
1950 /* Initialize the input/output for the PNG file to the default functions. */
1951 extern PNG_EXPORT(void,png_init_io) PNGARG((png_structp png_ptr, png_FILE_p fp));
1952 #endif
1953 
1954 /* Replace the (error and abort), and warning functions with user
1955  * supplied functions. If no messages are to be printed you must still
1956  * write and use replacement functions. The replacement error_fn should
1957  * still do a longjmp to the last setjmp location if you are using this
1958  * method of error handling. If error_fn or warning_fn is NULL, the
1959  * default function will be used.
1960  */
1961 
1962 extern PNG_EXPORT(void,png_set_error_fn) PNGARG((png_structp png_ptr,
1963  png_voidp error_ptr, png_error_ptr error_fn, png_error_ptr warning_fn));
1964 
1965 /* Return the user pointer associated with the error functions */
1966 extern PNG_EXPORT(png_voidp,png_get_error_ptr) PNGARG((png_structp png_ptr));
1967 
1968 /* Replace the default data output functions with a user supplied one(s).
1969  * If buffered output is not used, then output_flush_fn can be set to NULL.
1970  * If PNG_WRITE_FLUSH_SUPPORTED is not defined at libpng compile time
1971  * output_flush_fn will be ignored (and thus can be NULL).
1972  */
1973 extern PNG_EXPORT(void,png_set_write_fn) PNGARG((png_structp png_ptr,
1974  png_voidp io_ptr, png_rw_ptr write_data_fn, png_flush_ptr output_flush_fn));
1975 
1976 /* Replace the default data input function with a user supplied one. */
1977 extern PNG_EXPORT(void,png_set_read_fn) PNGARG((png_structp png_ptr,
1978  png_voidp io_ptr, png_rw_ptr read_data_fn));
1979 
1980 /* Return the user pointer associated with the I/O functions */
1981 extern PNG_EXPORT(png_voidp,png_get_io_ptr) PNGARG((png_structp png_ptr));
1982 
1983 extern PNG_EXPORT(void,png_set_read_status_fn) PNGARG((png_structp png_ptr,
1984  png_read_status_ptr read_row_fn));
1985 
1986 extern PNG_EXPORT(void,png_set_write_status_fn) PNGARG((png_structp png_ptr,
1987  png_write_status_ptr write_row_fn));
1988 
1989 #ifdef PNG_USER_MEM_SUPPORTED
1990 /* Replace the default memory allocation functions with user supplied one(s). */
1991 extern PNG_EXPORT(void,png_set_mem_fn) PNGARG((png_structp png_ptr,
1992  png_voidp mem_ptr, png_malloc_ptr malloc_fn, png_free_ptr free_fn));
1993 /* Return the user pointer associated with the memory functions */
1994 extern PNG_EXPORT(png_voidp,png_get_mem_ptr) PNGARG((png_structp png_ptr));
1995 #endif
1996 
1997 #if defined(PNG_READ_USER_TRANSFORM_SUPPORTED) || \
1998  defined(PNG_LEGACY_SUPPORTED)
1999 extern PNG_EXPORT(void,png_set_read_user_transform_fn) PNGARG((png_structp
2000  png_ptr, png_user_transform_ptr read_user_transform_fn));
2001 #endif
2002 
2003 #if defined(PNG_WRITE_USER_TRANSFORM_SUPPORTED) || \
2004  defined(PNG_LEGACY_SUPPORTED)
2005 extern PNG_EXPORT(void,png_set_write_user_transform_fn) PNGARG((png_structp
2006  png_ptr, png_user_transform_ptr write_user_transform_fn));
2007 #endif
2008 
2009 #if defined(PNG_READ_USER_TRANSFORM_SUPPORTED) || \
2010  defined(PNG_WRITE_USER_TRANSFORM_SUPPORTED) || \
2011  defined(PNG_LEGACY_SUPPORTED)
2012 extern PNG_EXPORT(void,png_set_user_transform_info) PNGARG((png_structp
2013  png_ptr, png_voidp user_transform_ptr, int user_transform_depth,
2015 /* Return the user pointer associated with the user transform functions */
2016 extern PNG_EXPORT(png_voidp,png_get_user_transform_ptr)
2017  PNGARG((png_structp png_ptr));
2018 #endif
2019 
2020 #ifdef PNG_USER_CHUNKS_SUPPORTED
2021 extern PNG_EXPORT(void,png_set_read_user_chunk_fn) PNGARG((png_structp png_ptr,
2022  png_voidp user_chunk_ptr, png_user_chunk_ptr read_user_chunk_fn));
2023 extern PNG_EXPORT(png_voidp,png_get_user_chunk_ptr) PNGARG((png_structp
2024  png_ptr));
2025 #endif
2026 
2027 #ifdef PNG_PROGRESSIVE_READ_SUPPORTED
2028 /* Sets the function callbacks for the push reader, and a pointer to a
2029  * user-defined structure available to the callback functions.
2030  */
2031 extern PNG_EXPORT(void,png_set_progressive_read_fn) PNGARG((png_structp png_ptr,
2032  png_voidp progressive_ptr,
2033  png_progressive_info_ptr info_fn, png_progressive_row_ptr row_fn,
2034  png_progressive_end_ptr end_fn));
2035 
2036 /* returns the user pointer associated with the push read functions */
2037 extern PNG_EXPORT(png_voidp,png_get_progressive_ptr)
2038  PNGARG((png_structp png_ptr));
2039 
2040 /* function to be called when data becomes available */
2041 extern PNG_EXPORT(void,png_process_data) PNGARG((png_structp png_ptr,
2042  png_infop info_ptr, png_bytep buffer, png_size_t buffer_size));
2043 
2044 /* function that combines rows. Not very much different than the
2045  * png_combine_row() call. Is this even used?????
2046  */
2047 extern PNG_EXPORT(void,png_progressive_combine_row) PNGARG((png_structp png_ptr,
2049 #endif /* PNG_PROGRESSIVE_READ_SUPPORTED */
2050 
2051 extern PNG_EXPORT(png_voidp,png_malloc) PNGARG((png_structp png_ptr,
2052  png_uint_32 size));
2053 
2054 #if defined(PNG_1_0_X)
2055 # define png_malloc_warn png_malloc
2056 #else
2057 /* Added at libpng version 1.2.4 */
2058 extern PNG_EXPORT(png_voidp,png_malloc_warn) PNGARG((png_structp png_ptr,
2059  png_uint_32 size));
2060 #endif
2061 
2062 /* frees a pointer allocated by png_malloc() */
2063 extern PNG_EXPORT(void,png_free) PNGARG((png_structp png_ptr, png_voidp ptr));
2064 
2065 #if defined(PNG_1_0_X)
2066 /* Function to allocate memory for zlib. */
2067 extern PNG_EXPORT(voidpf,png_zalloc) PNGARG((voidpf png_ptr, uInt items,
2068  uInt size));
2069 
2070 /* Function to free memory for zlib */
2071 extern PNG_EXPORT(void,png_zfree) PNGARG((voidpf png_ptr, voidpf ptr));
2072 #endif
2073 
2074 /* Free data that was allocated internally */
2075 extern PNG_EXPORT(void,png_free_data) PNGARG((png_structp png_ptr,
2076  png_infop info_ptr, png_uint_32 free_me, int num));
2077 #ifdef PNG_FREE_ME_SUPPORTED
2078 /* Reassign responsibility for freeing existing data, whether allocated
2079  * by libpng or by the application */
2080 extern PNG_EXPORT(void,png_data_freer) PNGARG((png_structp png_ptr,
2081  png_infop info_ptr, int freer, png_uint_32 mask));
2082 #endif
2083 /* assignments for png_data_freer */
2084 #define PNG_DESTROY_WILL_FREE_DATA 1
2085 #define PNG_SET_WILL_FREE_DATA 1
2086 #define PNG_USER_WILL_FREE_DATA 2
2087 /* Flags for png_ptr->free_me and info_ptr->free_me */
2088 #define PNG_FREE_HIST 0x0008
2089 #define PNG_FREE_ICCP 0x0010
2090 #define PNG_FREE_SPLT 0x0020
2091 #define PNG_FREE_ROWS 0x0040
2092 #define PNG_FREE_PCAL 0x0080
2093 #define PNG_FREE_SCAL 0x0100
2094 #define PNG_FREE_UNKN 0x0200
2095 #define PNG_FREE_LIST 0x0400
2096 #define PNG_FREE_PLTE 0x1000
2097 #define PNG_FREE_TRNS 0x2000
2098 #define PNG_FREE_TEXT 0x4000
2099 #define PNG_FREE_ALL 0x7fff
2100 #define PNG_FREE_MUL 0x4220 /* PNG_FREE_SPLT|PNG_FREE_TEXT|PNG_FREE_UNKN */
2101 
2102 #ifdef PNG_USER_MEM_SUPPORTED
2103 extern PNG_EXPORT(png_voidp,png_malloc_default) PNGARG((png_structp png_ptr,
2104  png_uint_32 size));
2105 extern PNG_EXPORT(void,png_free_default) PNGARG((png_structp png_ptr,
2106  png_voidp ptr));
2107 #endif
2108 
2109 extern PNG_EXPORT(png_voidp,png_memcpy_check) PNGARG((png_structp png_ptr,
2110  png_voidp s1, png_voidp s2, png_uint_32 size));
2111 
2112 extern PNG_EXPORT(png_voidp,png_memset_check) PNGARG((png_structp png_ptr,
2113  png_voidp s1, int value, png_uint_32 size));
2114 
2115 #if defined(USE_FAR_KEYWORD) /* memory model conversion function */
2116 extern void *png_far_to_near PNGARG((png_structp png_ptr,png_voidp ptr,
2117  int check));
2118 #endif /* USE_FAR_KEYWORD */
2119 
2120 #ifndef PNG_NO_ERROR_TEXT
2121 /* Fatal error in PNG image of libpng - can't continue */
2122 extern PNG_EXPORT(void,png_error) PNGARG((png_structp png_ptr,
2124 
2125 /* The same, but the chunk name is prepended to the error string. */
2126 extern PNG_EXPORT(void,png_chunk_error) PNGARG((png_structp png_ptr,
2127  png_const_charp error_message));
2128 #else
2129 /* Fatal error in PNG image of libpng - can't continue */
2130 extern PNG_EXPORT(void,png_err) PNGARG((png_structp png_ptr));
2131 #endif
2132 
2133 #ifndef PNG_NO_WARNINGS
2134 /* Non-fatal error in libpng. Can continue, but may have a problem. */
2135 extern PNG_EXPORT(void,png_warning) PNGARG((png_structp png_ptr,
2137 
2138 #ifdef PNG_READ_SUPPORTED
2139 /* Non-fatal error in libpng, chunk name is prepended to message. */
2140 extern PNG_EXPORT(void,png_chunk_warning) PNGARG((png_structp png_ptr,
2141  png_const_charp warning_message));
2142 #endif /* PNG_READ_SUPPORTED */
2143 #endif /* PNG_NO_WARNINGS */
2144 
2145 /* The png_set_<chunk> functions are for storing values in the png_info_struct.
2146  * Similarly, the png_get_<chunk> calls are used to read values from the
2147  * png_info_struct, either storing the parameters in the passed variables, or
2148  * setting pointers into the png_info_struct where the data is stored. The
2149  * png_get_<chunk> functions return a non-zero value if the data was available
2150  * in info_ptr, or return zero and do not change any of the parameters if the
2151  * data was not available.
2152  *
2153  * These functions should be used instead of directly accessing png_info
2154  * to avoid problems with future changes in the size and internal layout of
2155  * png_info_struct.
2156  */
2157 /* Returns "flag" if chunk data is valid in info_ptr. */
2158 extern PNG_EXPORT(png_uint_32,png_get_valid) PNGARG((png_structp png_ptr,
2159 png_infop info_ptr, png_uint_32 flag));
2160 
2161 /* Returns number of bytes needed to hold a transformed row. */
2162 extern PNG_EXPORT(png_uint_32,png_get_rowbytes) PNGARG((png_structp png_ptr,
2163 png_infop info_ptr));
2164 
2165 #if defined(PNG_INFO_IMAGE_SUPPORTED)
2166 /* Returns row_pointers, which is an array of pointers to scanlines that was
2167 returned from png_read_png(). */
2168 extern PNG_EXPORT(png_bytepp,png_get_rows) PNGARG((png_structp png_ptr,
2169 png_infop info_ptr));
2170 /* Set row_pointers, which is an array of pointers to scanlines for use
2171 by png_write_png(). */
2172 extern PNG_EXPORT(void,png_set_rows) PNGARG((png_structp png_ptr,
2173  png_infop info_ptr, png_bytepp row_pointers));
2174 #endif
2175 
2176 /* Returns number of color channels in image. */
2177 extern PNG_EXPORT(png_byte,png_get_channels) PNGARG((png_structp png_ptr,
2178 png_infop info_ptr));
2179 
2180 #ifdef PNG_EASY_ACCESS_SUPPORTED
2181 /* Returns image width in pixels. */
2182 extern PNG_EXPORT(png_uint_32, png_get_image_width) PNGARG((png_structp
2183 png_ptr, png_infop info_ptr));
2184 
2185 /* Returns image height in pixels. */
2186 extern PNG_EXPORT(png_uint_32, png_get_image_height) PNGARG((png_structp
2187 png_ptr, png_infop info_ptr));
2188 
2189 /* Returns image bit_depth. */
2190 extern PNG_EXPORT(png_byte, png_get_bit_depth) PNGARG((png_structp
2191 png_ptr, png_infop info_ptr));
2192 
2193 /* Returns image color_type. */
2194 extern PNG_EXPORT(png_byte, png_get_color_type) PNGARG((png_structp
2195 png_ptr, png_infop info_ptr));
2196 
2197 /* Returns image filter_type. */
2198 extern PNG_EXPORT(png_byte, png_get_filter_type) PNGARG((png_structp
2199 png_ptr, png_infop info_ptr));
2200 
2201 /* Returns image interlace_type. */
2202 extern PNG_EXPORT(png_byte, png_get_interlace_type) PNGARG((png_structp
2203 png_ptr, png_infop info_ptr));
2204 
2205 /* Returns image compression_type. */
2206 extern PNG_EXPORT(png_byte, png_get_compression_type) PNGARG((png_structp
2207 png_ptr, png_infop info_ptr));
2208 
2209 /* Returns image resolution in pixels per meter, from pHYs chunk data. */
2210 extern PNG_EXPORT(png_uint_32, png_get_pixels_per_meter) PNGARG((png_structp
2211 png_ptr, png_infop info_ptr));
2212 extern PNG_EXPORT(png_uint_32, png_get_x_pixels_per_meter) PNGARG((png_structp
2213 png_ptr, png_infop info_ptr));
2214 extern PNG_EXPORT(png_uint_32, png_get_y_pixels_per_meter) PNGARG((png_structp
2215 png_ptr, png_infop info_ptr));
2216 
2217 /* Returns pixel aspect ratio, computed from pHYs chunk data. */
2218 #ifdef PNG_FLOATING_POINT_SUPPORTED
2219 extern PNG_EXPORT(float, png_get_pixel_aspect_ratio) PNGARG((png_structp
2220 png_ptr, png_infop info_ptr));
2221 #endif
2222 
2223 /* Returns image x, y offset in pixels or microns, from oFFs chunk data. */
2225 png_ptr, png_infop info_ptr));
2227 png_ptr, png_infop info_ptr));
2228 extern PNG_EXPORT(png_int_32, png_get_x_offset_microns) PNGARG((png_structp
2229 png_ptr, png_infop info_ptr));
2230 extern PNG_EXPORT(png_int_32, png_get_y_offset_microns) PNGARG((png_structp
2231 png_ptr, png_infop info_ptr));
2232 
2233 #endif /* PNG_EASY_ACCESS_SUPPORTED */
2234 
2235 /* Returns pointer to signature string read from PNG header */
2236 extern PNG_EXPORT(png_bytep,png_get_signature) PNGARG((png_structp png_ptr,
2237 png_infop info_ptr));
2238 
2239 #if defined(PNG_bKGD_SUPPORTED)
2240 extern PNG_EXPORT(png_uint_32,png_get_bKGD) PNGARG((png_structp png_ptr,
2241  png_infop info_ptr, png_color_16p *background));
2242 #endif
2243 
2244 #if defined(PNG_bKGD_SUPPORTED)
2245 extern PNG_EXPORT(void,png_set_bKGD) PNGARG((png_structp png_ptr,
2246  png_infop info_ptr, png_color_16p background));
2247 #endif
2248 
2249 #if defined(PNG_cHRM_SUPPORTED)
2250 #ifdef PNG_FLOATING_POINT_SUPPORTED
2251 extern PNG_EXPORT(png_uint_32,png_get_cHRM) PNGARG((png_structp png_ptr,
2252  png_infop info_ptr, double *white_x, double *white_y, double *red_x,
2253  double *red_y, double *green_x, double *green_y, double *blue_x,
2254  double *blue_y));
2255 #endif
2256 #ifdef PNG_FIXED_POINT_SUPPORTED
2257 extern PNG_EXPORT(png_uint_32,png_get_cHRM_fixed) PNGARG((png_structp png_ptr,
2262 #endif
2263 #endif
2264 
2265 #if defined(PNG_cHRM_SUPPORTED)
2266 #ifdef PNG_FLOATING_POINT_SUPPORTED
2267 extern PNG_EXPORT(void,png_set_cHRM) PNGARG((png_structp png_ptr,
2268  png_infop info_ptr, double white_x, double white_y, double red_x,
2269  double red_y, double green_x, double green_y, double blue_x, double blue_y));
2270 #endif
2271 #ifdef PNG_FIXED_POINT_SUPPORTED
2272 extern PNG_EXPORT(void,png_set_cHRM_fixed) PNGARG((png_structp png_ptr,
2273  png_infop info_ptr, png_fixed_point int_white_x, png_fixed_point int_white_y,
2274  png_fixed_point int_red_x, png_fixed_point int_red_y, png_fixed_point
2275  int_green_x, png_fixed_point int_green_y, png_fixed_point int_blue_x,
2276  png_fixed_point int_blue_y));
2277 #endif
2278 #endif
2279 
2280 #if defined(PNG_gAMA_SUPPORTED)
2281 #ifdef PNG_FLOATING_POINT_SUPPORTED
2282 extern PNG_EXPORT(png_uint_32,png_get_gAMA) PNGARG((png_structp png_ptr,
2283  png_infop info_ptr, double *file_gamma));
2284 #endif
2285 extern PNG_EXPORT(png_uint_32,png_get_gAMA_fixed) PNGARG((png_structp png_ptr,
2286  png_infop info_ptr, png_fixed_point *int_file_gamma));
2287 #endif
2288 
2289 #if defined(PNG_gAMA_SUPPORTED)
2290 #ifdef PNG_FLOATING_POINT_SUPPORTED
2291 extern PNG_EXPORT(void,png_set_gAMA) PNGARG((png_structp png_ptr,
2292  png_infop info_ptr, double file_gamma));
2293 #endif
2294 extern PNG_EXPORT(void,png_set_gAMA_fixed) PNGARG((png_structp png_ptr,
2295  png_infop info_ptr, png_fixed_point int_file_gamma));
2296 #endif
2297 
2298 #if defined(PNG_hIST_SUPPORTED)
2299 extern PNG_EXPORT(png_uint_32,png_get_hIST) PNGARG((png_structp png_ptr,
2300  png_infop info_ptr, png_uint_16p *hist));
2301 #endif
2302 
2303 #if defined(PNG_hIST_SUPPORTED)
2304 extern PNG_EXPORT(void,png_set_hIST) PNGARG((png_structp png_ptr,
2305  png_infop info_ptr, png_uint_16p hist));
2306 #endif
2307 
2308 extern PNG_EXPORT(png_uint_32,png_get_IHDR) PNGARG((png_structp png_ptr,
2309  png_infop info_ptr, png_uint_32 *width, png_uint_32 *height,
2310  int *bit_depth, int *color_type, int *interlace_method,
2311  int *compression_method, int *filter_method));
2312 
2313 extern PNG_EXPORT(void,png_set_IHDR) PNGARG((png_structp png_ptr,
2314  png_infop info_ptr, png_uint_32 width, png_uint_32 height, int bit_depth,
2315  int color_type, int interlace_method, int compression_method,
2316  int filter_method));
2317 
2318 #if defined(PNG_oFFs_SUPPORTED)
2319 extern PNG_EXPORT(png_uint_32,png_get_oFFs) PNGARG((png_structp png_ptr,
2320  png_infop info_ptr, png_int_32 *offset_x, png_int_32 *offset_y,
2321  int *unit_type));
2322 #endif
2323 
2324 #if defined(PNG_oFFs_SUPPORTED)
2325 extern PNG_EXPORT(void,png_set_oFFs) PNGARG((png_structp png_ptr,
2326  png_infop info_ptr, png_int_32 offset_x, png_int_32 offset_y,
2327  int unit_type));
2328 #endif
2329 
2330 #if defined(PNG_pCAL_SUPPORTED)
2331 extern PNG_EXPORT(png_uint_32,png_get_pCAL) PNGARG((png_structp png_ptr,
2332  png_infop info_ptr, png_charp *purpose, png_int_32 *X0, png_int_32 *X1,
2333  int *type, int *nparams, png_charp *units, png_charpp *params));
2334 #endif
2335 
2336 #if defined(PNG_pCAL_SUPPORTED)
2337 extern PNG_EXPORT(void,png_set_pCAL) PNGARG((png_structp png_ptr,
2338  png_infop info_ptr, png_charp purpose, png_int_32 X0, png_int_32 X1,
2339  int type, int nparams, png_charp units, png_charpp params));
2340 #endif
2341 
2342 #if defined(PNG_pHYs_SUPPORTED)
2343 extern PNG_EXPORT(png_uint_32,png_get_pHYs) PNGARG((png_structp png_ptr,
2344  png_infop info_ptr, png_uint_32 *res_x, png_uint_32 *res_y, int *unit_type));
2345 #endif
2346 
2347 #if defined(PNG_pHYs_SUPPORTED)
2348 extern PNG_EXPORT(void,png_set_pHYs) PNGARG((png_structp png_ptr,
2349  png_infop info_ptr, png_uint_32 res_x, png_uint_32 res_y, int unit_type));
2350 #endif
2351 
2352 extern PNG_EXPORT(png_uint_32,png_get_PLTE) PNGARG((png_structp png_ptr,
2353  png_infop info_ptr, png_colorp *palette, int *num_palette));
2354 
2355 extern PNG_EXPORT(void,png_set_PLTE) PNGARG((png_structp png_ptr,
2356  png_infop info_ptr, png_colorp palette, int num_palette));
2357 
2358 #if defined(PNG_sBIT_SUPPORTED)
2359 extern PNG_EXPORT(png_uint_32,png_get_sBIT) PNGARG((png_structp png_ptr,
2360  png_infop info_ptr, png_color_8p *sig_bit));
2361 #endif
2362 
2363 #if defined(PNG_sBIT_SUPPORTED)
2364 extern PNG_EXPORT(void,png_set_sBIT) PNGARG((png_structp png_ptr,
2365  png_infop info_ptr, png_color_8p sig_bit));
2366 #endif
2367 
2368 #if defined(PNG_sRGB_SUPPORTED)
2369 extern PNG_EXPORT(png_uint_32,png_get_sRGB) PNGARG((png_structp png_ptr,
2370  png_infop info_ptr, int *intent));
2371 #endif
2372 
2373 #if defined(PNG_sRGB_SUPPORTED)
2374 extern PNG_EXPORT(void,png_set_sRGB) PNGARG((png_structp png_ptr,
2375  png_infop info_ptr, int intent));
2376 extern PNG_EXPORT(void,png_set_sRGB_gAMA_and_cHRM) PNGARG((png_structp png_ptr,
2377  png_infop info_ptr, int intent));
2378 #endif
2379 
2380 #if defined(PNG_iCCP_SUPPORTED)
2381 extern PNG_EXPORT(png_uint_32,png_get_iCCP) PNGARG((png_structp png_ptr,
2382  png_infop info_ptr, png_charpp name, int *compression_type,
2383  png_charpp profile, png_uint_32 *proflen));
2384  /* Note to maintainer: profile should be png_bytepp */
2385 #endif
2386 
2387 #if defined(PNG_iCCP_SUPPORTED)
2388 extern PNG_EXPORT(void,png_set_iCCP) PNGARG((png_structp png_ptr,
2389  png_infop info_ptr, png_charp name, int compression_type,
2390  png_charp profile, png_uint_32 proflen));
2391  /* Note to maintainer: profile should be png_bytep */
2392 #endif
2393 
2394 #if defined(PNG_sPLT_SUPPORTED)
2395 extern PNG_EXPORT(png_uint_32,png_get_sPLT) PNGARG((png_structp png_ptr,
2396  png_infop info_ptr, png_sPLT_tpp entries));
2397 #endif
2398 
2399 #if defined(PNG_sPLT_SUPPORTED)
2400 extern PNG_EXPORT(void,png_set_sPLT) PNGARG((png_structp png_ptr,
2401  png_infop info_ptr, png_sPLT_tp entries, int nentries));
2402 #endif
2403 
2404 #if defined(PNG_TEXT_SUPPORTED)
2405 /* png_get_text also returns the number of text chunks in *num_text */
2406 extern PNG_EXPORT(png_uint_32,png_get_text) PNGARG((png_structp png_ptr,
2407  png_infop info_ptr, png_textp *text_ptr, int *num_text));
2408 #endif
2409 
2410 /*
2411  * Note while png_set_text() will accept a structure whose text,
2412  * language, and translated keywords are NULL pointers, the structure
2413  * returned by png_get_text will always contain regular
2414  * zero-terminated C strings. They might be empty strings but
2415  * they will never be NULL pointers.
2416  */
2417 
2418 #if defined(PNG_TEXT_SUPPORTED)
2419 extern PNG_EXPORT(void,png_set_text) PNGARG((png_structp png_ptr,
2420  png_infop info_ptr, png_textp text_ptr, int num_text));
2421 #endif
2422 
2423 #if defined(PNG_tIME_SUPPORTED)
2424 extern PNG_EXPORT(png_uint_32,png_get_tIME) PNGARG((png_structp png_ptr,
2425  png_infop info_ptr, png_timep *mod_time));
2426 #endif
2427 
2428 #if defined(PNG_tIME_SUPPORTED)
2429 extern PNG_EXPORT(void,png_set_tIME) PNGARG((png_structp png_ptr,
2430  png_infop info_ptr, png_timep mod_time));
2431 #endif
2432 
2433 #if defined(PNG_tRNS_SUPPORTED)
2434 extern PNG_EXPORT(png_uint_32,png_get_tRNS) PNGARG((png_structp png_ptr,
2435  png_infop info_ptr, png_bytep *trans, int *num_trans,
2436  png_color_16p *trans_values));
2437 #endif
2438 
2439 #if defined(PNG_tRNS_SUPPORTED)
2440 extern PNG_EXPORT(void,png_set_tRNS) PNGARG((png_structp png_ptr,
2441  png_infop info_ptr, png_bytep trans, int num_trans,
2442  png_color_16p trans_values));
2443 #endif
2444 
2445 #if defined(PNG_tRNS_SUPPORTED)
2446 #endif
2447 
2448 #if defined(PNG_sCAL_SUPPORTED)
2449 #ifdef PNG_FLOATING_POINT_SUPPORTED
2450 extern PNG_EXPORT(png_uint_32,png_get_sCAL) PNGARG((png_structp png_ptr,
2451  png_infop info_ptr, int *unit, double *width, double *height));
2452 #else
2453 #ifdef PNG_FIXED_POINT_SUPPORTED
2454 extern PNG_EXPORT(png_uint_32,png_get_sCAL_s) PNGARG((png_structp png_ptr,
2455  png_infop info_ptr, int *unit, png_charpp swidth, png_charpp sheight));
2456 #endif
2457 #endif
2458 #endif /* PNG_sCAL_SUPPORTED */
2459 
2460 #if defined(PNG_sCAL_SUPPORTED)
2461 #ifdef PNG_FLOATING_POINT_SUPPORTED
2462 extern PNG_EXPORT(void,png_set_sCAL) PNGARG((png_structp png_ptr,
2463  png_infop info_ptr, int unit, double width, double height));
2464 #else
2465 #ifdef PNG_FIXED_POINT_SUPPORTED
2466 extern PNG_EXPORT(void,png_set_sCAL_s) PNGARG((png_structp png_ptr,
2467  png_infop info_ptr, int unit, png_charp swidth, png_charp sheight));
2468 #endif
2469 #endif
2470 #endif /* PNG_sCAL_SUPPORTED || PNG_WRITE_sCAL_SUPPORTED */
2471 
2472 #if defined(PNG_UNKNOWN_CHUNKS_SUPPORTED)
2473 /* provide a list of chunks and how they are to be handled, if the built-in
2474  handling or default unknown chunk handling is not desired. Any chunks not
2475  listed will be handled in the default manner. The IHDR and IEND chunks
2476  must not be listed.
2477  keep = 0: follow default behaviour
2478  = 1: do not keep
2479  = 2: keep only if safe-to-copy
2480  = 3: keep even if unsafe-to-copy
2481 */
2482 extern PNG_EXPORT(void, png_set_keep_unknown_chunks) PNGARG((png_structp
2483  png_ptr, int keep, png_bytep chunk_list, int num_chunks));
2484 extern PNG_EXPORT(void, png_set_unknown_chunks) PNGARG((png_structp png_ptr,
2485  png_infop info_ptr, png_unknown_chunkp unknowns, int num_unknowns));
2487  PNGARG((png_structp png_ptr, png_infop info_ptr, int chunk, int location));
2488 extern PNG_EXPORT(png_uint_32,png_get_unknown_chunks) PNGARG((png_structp
2489  png_ptr, png_infop info_ptr, png_unknown_chunkpp entries));
2490 #endif
2491 #ifdef PNG_HANDLE_AS_UNKNOWN_SUPPORTED
2492 PNG_EXPORT(int,png_handle_as_unknown) PNGARG((png_structp png_ptr, png_bytep
2493  chunk_name));
2494 #endif
2495 
2496 /* Png_free_data() will turn off the "valid" flag for anything it frees.
2497  If you need to turn it off for a chunk that your application has freed,
2498  you can use png_set_invalid(png_ptr, info_ptr, PNG_INFO_CHNK); */
2499 extern PNG_EXPORT(void, png_set_invalid) PNGARG((png_structp png_ptr,
2500  png_infop info_ptr, int mask));
2501 
2502 #if defined(PNG_INFO_IMAGE_SUPPORTED)
2503 /* The "params" pointer is currently not used and is for future expansion. */
2504 extern PNG_EXPORT(void, png_read_png) PNGARG((png_structp png_ptr,
2505  png_infop info_ptr,
2506  int transforms,
2507  png_voidp params));
2508 extern PNG_EXPORT(void, png_write_png) PNGARG((png_structp png_ptr,
2509  png_infop info_ptr,
2510  int transforms,
2511  png_voidp params));
2512 #endif
2513 
2514 /* Define PNG_DEBUG at compile time for debugging information. Higher
2515  * numbers for PNG_DEBUG mean more debugging information. This has
2516  * only been added since version 0.95 so it is not implemented throughout
2517  * libpng yet, but more support will be added as needed.
2518  */
2519 #ifdef PNG_DEBUG
2520 #if (PNG_DEBUG > 0)
2521 #if !defined(PNG_DEBUG_FILE) && defined(_MSC_VER)
2522 #include <crtdbg.h>
2523 #if (PNG_DEBUG > 1)
2524 #define png_debug(l,m) _RPT0(_CRT_WARN,m)
2525 #define png_debug1(l,m,p1) _RPT1(_CRT_WARN,m,p1)
2526 #define png_debug2(l,m,p1,p2) _RPT2(_CRT_WARN,m,p1,p2)
2527 #endif
2528 #else /* PNG_DEBUG_FILE || !_MSC_VER */
2529 #ifndef PNG_DEBUG_FILE
2530 #define PNG_DEBUG_FILE stderr
2531 #endif /* PNG_DEBUG_FILE */
2532 #if (PNG_DEBUG > 1)
2533 #define png_debug(l,m) \
2534 { \
2535  int num_tabs=l; \
2536  fprintf(PNG_DEBUG_FILE,"%s"m,(num_tabs==1 ? "\t" : \
2537  (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":"")))); \
2538 }
2539 #define png_debug1(l,m,p1) \
2540 { \
2541  int num_tabs=l; \
2542  fprintf(PNG_DEBUG_FILE,"%s"m,(num_tabs==1 ? "\t" : \
2543  (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":""))),p1); \
2544 }
2545 #define png_debug2(l,m,p1,p2) \
2546 { \
2547  int num_tabs=l; \
2548  fprintf(PNG_DEBUG_FILE,"%s"m,(num_tabs==1 ? "\t" : \
2549  (num_tabs==2 ? "\t\t":(num_tabs>2 ? "\t\t\t":""))),p1,p2); \
2550 }
2551 #endif /* (PNG_DEBUG > 1) */
2552 #endif /* _MSC_VER */
2553 #endif /* (PNG_DEBUG > 0) */
2554 #endif /* PNG_DEBUG */
2555 #ifndef png_debug
2556 #define png_debug(l, m)
2557 #endif
2558 #ifndef png_debug1
2559 #define png_debug1(l, m, p1)
2560 #endif
2561 #ifndef png_debug2
2562 #define png_debug2(l, m, p1, p2)
2563 #endif
2564 
2565 extern PNG_EXPORT(png_charp,png_get_copyright) PNGARG((png_structp png_ptr));
2566 extern PNG_EXPORT(png_charp,png_get_header_ver) PNGARG((png_structp png_ptr));
2567 extern PNG_EXPORT(png_charp,png_get_header_version) PNGARG((png_structp png_ptr));
2568 extern PNG_EXPORT(png_charp,png_get_libpng_ver) PNGARG((png_structp png_ptr));
2569 
2570 #ifdef PNG_MNG_FEATURES_SUPPORTED
2571 extern PNG_EXPORT(png_uint_32,png_permit_mng_features) PNGARG((png_structp
2572  png_ptr, png_uint_32 mng_features_permitted));
2573 #endif
2574 
2575 /* For use in png_set_keep_unknown, added to version 1.2.6 */
2576 #define PNG_HANDLE_CHUNK_AS_DEFAULT 0
2577 #define PNG_HANDLE_CHUNK_NEVER 1
2578 #define PNG_HANDLE_CHUNK_IF_SAFE 2
2579 #define PNG_HANDLE_CHUNK_ALWAYS 3
2580 
2581 /* Added to version 1.2.0 */
2582 #if defined(PNG_ASSEMBLER_CODE_SUPPORTED)
2583 #if defined(PNG_MMX_CODE_SUPPORTED)
2584 #define PNG_ASM_FLAG_MMX_SUPPORT_COMPILED 0x01 /* not user-settable */
2585 #define PNG_ASM_FLAG_MMX_SUPPORT_IN_CPU 0x02 /* not user-settable */
2586 #define PNG_ASM_FLAG_MMX_READ_COMBINE_ROW 0x04
2587 #define PNG_ASM_FLAG_MMX_READ_INTERLACE 0x08
2588 #define PNG_ASM_FLAG_MMX_READ_FILTER_SUB 0x10
2589 #define PNG_ASM_FLAG_MMX_READ_FILTER_UP 0x20
2590 #define PNG_ASM_FLAG_MMX_READ_FILTER_AVG 0x40
2591 #define PNG_ASM_FLAG_MMX_READ_FILTER_PAETH 0x80
2592 #define PNG_ASM_FLAGS_INITIALIZED 0x80000000 /* not user-settable */
2593 
2594 #define PNG_MMX_READ_FLAGS ( PNG_ASM_FLAG_MMX_READ_COMBINE_ROW \
2595  | PNG_ASM_FLAG_MMX_READ_INTERLACE \
2596  | PNG_ASM_FLAG_MMX_READ_FILTER_SUB \
2597  | PNG_ASM_FLAG_MMX_READ_FILTER_UP \
2598  | PNG_ASM_FLAG_MMX_READ_FILTER_AVG \
2599  | PNG_ASM_FLAG_MMX_READ_FILTER_PAETH )
2600 #define PNG_MMX_WRITE_FLAGS ( 0 )
2601 
2602 #define PNG_MMX_FLAGS ( PNG_ASM_FLAG_MMX_SUPPORT_COMPILED \
2603  | PNG_ASM_FLAG_MMX_SUPPORT_IN_CPU \
2604  | PNG_MMX_READ_FLAGS \
2605  | PNG_MMX_WRITE_FLAGS )
2606 
2607 #define PNG_SELECT_READ 1
2608 #define PNG_SELECT_WRITE 2
2609 #endif /* PNG_MMX_CODE_SUPPORTED */
2610 
2611 #if !defined(PNG_1_0_X)
2612 /* pngget.c */
2613 extern PNG_EXPORT(png_uint_32,png_get_mmx_flagmask)
2614  PNGARG((int flag_select, int *compilerID));
2615 
2616 /* pngget.c */
2617 extern PNG_EXPORT(png_uint_32,png_get_asm_flagmask)
2618  PNGARG((int flag_select));
2619 
2620 /* pngget.c */
2621 extern PNG_EXPORT(png_uint_32,png_get_asm_flags)
2622  PNGARG((png_structp png_ptr));
2623 
2624 /* pngget.c */
2626  PNGARG((png_structp png_ptr));
2627 
2628 /* pngget.c */
2629 extern PNG_EXPORT(png_uint_32,png_get_mmx_rowbytes_threshold)
2630  PNGARG((png_structp png_ptr));
2631 
2632 /* pngset.c */
2633 extern PNG_EXPORT(void,png_set_asm_flags)
2634  PNGARG((png_structp png_ptr, png_uint_32 asm_flags));
2635 
2636 /* pngset.c */
2638  PNGARG((png_structp png_ptr, png_byte mmx_bitdepth_threshold,
2639  png_uint_32 mmx_rowbytes_threshold));
2640 
2641 #endif /* PNG_1_0_X */
2642 
2643 #if !defined(PNG_1_0_X)
2644 /* png.c, pnggccrd.c, or pngvcrd.c */
2645 extern PNG_EXPORT(int,png_mmx_support) PNGARG((void));
2646 #endif /* PNG_ASSEMBLER_CODE_SUPPORTED */
2647 
2648 /* Strip the prepended error numbers ("#nnn ") from error and warning
2649  * messages before passing them to the error or warning handler. */
2650 #ifdef PNG_ERROR_NUMBERS_SUPPORTED
2651 extern PNG_EXPORT(void,png_set_strip_error_numbers) PNGARG((png_structp
2652  png_ptr, png_uint_32 strip_mode));
2653 #endif
2654 
2655 #endif /* PNG_1_0_X */
2656 
2657 /* Added at libpng-1.2.6 */
2658 #ifdef PNG_SET_USER_LIMITS_SUPPORTED
2659 extern PNG_EXPORT(void,png_set_user_limits) PNGARG((png_structp
2660  png_ptr, png_uint_32 user_width_max, png_uint_32 user_height_max));
2661 extern PNG_EXPORT(png_uint_32,png_get_user_width_max) PNGARG((png_structp
2662  png_ptr));
2663 extern PNG_EXPORT(png_uint_32,png_get_user_height_max) PNGARG((png_structp
2664  png_ptr));
2665 #endif
2666 
2667 
2668 /* Maintainer: Put new public prototypes here ^, in libpng.3, and project defs */
2669 
2670 #ifdef PNG_READ_COMPOSITE_NODIV_SUPPORTED
2671 /* With these routines we avoid an integer divide, which will be slower on
2672  * most machines. However, it does take more operations than the corresponding
2673  * divide method, so it may be slower on a few RISC systems. There are two
2674  * shifts (by 8 or 16 bits) and an addition, versus a single integer divide.
2675  *
2676  * Note that the rounding factors are NOT supposed to be the same! 128 and
2677  * 32768 are correct for the NODIV code; 127 and 32767 are correct for the
2678  * standard method.
2679  *
2680  * [Optimized code by Greg Roelofs and Mark Adler...blame us for bugs. :-) ]
2681  */
2682 
2683  /* fg and bg should be in `gamma 1.0' space; alpha is the opacity */
2684 
2685 # define png_composite(composite, fg, alpha, bg) \
2686  { png_uint_16 temp = (png_uint_16)((png_uint_16)(fg) * (png_uint_16)(alpha) \
2687  + (png_uint_16)(bg)*(png_uint_16)(255 - \
2688  (png_uint_16)(alpha)) + (png_uint_16)128); \
2689  (composite) = (png_byte)((temp + (temp >> 8)) >> 8); }
2690 
2691 # define png_composite_16(composite, fg, alpha, bg) \
2692  { png_uint_32 temp = (png_uint_32)((png_uint_32)(fg) * (png_uint_32)(alpha) \
2693  + (png_uint_32)(bg)*(png_uint_32)(65535L - \
2694  (png_uint_32)(alpha)) + (png_uint_32)32768L); \
2695  (composite) = (png_uint_16)((temp + (temp >> 16)) >> 16); }
2696 
2697 #else /* standard method using integer division */
2698 
2699 # define png_composite(composite, fg, alpha, bg) \
2700  (composite) = (png_byte)(((png_uint_16)(fg) * (png_uint_16)(alpha) + \
2701  (png_uint_16)(bg) * (png_uint_16)(255 - (png_uint_16)(alpha)) + \
2702  (png_uint_16)127) / 255)
2703 
2704 # define png_composite_16(composite, fg, alpha, bg) \
2705  (composite) = (png_uint_16)(((png_uint_32)(fg) * (png_uint_32)(alpha) + \
2706  (png_uint_32)(bg)*(png_uint_32)(65535L - (png_uint_32)(alpha)) + \
2707  (png_uint_32)32767) / (png_uint_32)65535L)
2708 
2709 #endif /* PNG_READ_COMPOSITE_NODIV_SUPPORTED */
2710 
2711 /* Inline macros to do direct reads of bytes from the input buffer. These
2712  * require that you are using an architecture that uses PNG byte ordering
2713  * (MSB first) and supports unaligned data storage. I think that PowerPC
2714  * in big-endian mode and 680x0 are the only ones that will support this.
2715  * The x86 line of processors definitely do not. The png_get_int_32()
2716  * routine also assumes we are using two's complement format for negative
2717  * values, which is almost certainly true.
2718  */
2719 #if defined(PNG_READ_BIG_ENDIAN_SUPPORTED)
2720 # define png_get_uint_32(buf) ( *((png_uint_32p) (buf)))
2721 # define png_get_uint_16(buf) ( *((png_uint_16p) (buf)))
2722 # define png_get_int_32(buf) ( *((png_int_32p) (buf)))
2723 #else
2724 extern PNG_EXPORT(png_uint_32,png_get_uint_32) PNGARG((png_bytep buf));
2726 extern PNG_EXPORT(png_int_32,png_get_int_32) PNGARG((png_bytep buf));
2727 #endif /* !PNG_READ_BIG_ENDIAN_SUPPORTED */
2728 extern PNG_EXPORT(png_uint_32,png_get_uint_31)
2729  PNGARG((png_structp png_ptr, png_bytep buf));
2730 /* No png_get_int_16 -- may be added if there's a real need for it. */
2731 
2732 /* Place a 32-bit number into a buffer in PNG byte order (big-endian).
2733  */
2734 extern PNG_EXPORT(void,png_save_uint_32)
2735  PNGARG((png_bytep buf, png_uint_32 i));
2736 extern PNG_EXPORT(void,png_save_int_32)
2737  PNGARG((png_bytep buf, png_int_32 i));
2738 
2739 /* Place a 16-bit number into a buffer in PNG byte order.
2740  * The parameter is declared unsigned int, not png_uint_16,
2741  * just to avoid potential problems on pre-ANSI C compilers.
2742  */
2743 extern PNG_EXPORT(void,png_save_uint_16)
2744  PNGARG((png_bytep buf, unsigned int i));
2745 /* No png_save_int_16 -- may be added if there's a real need for it. */
2746 
2747 /* ************************************************************************* */
2748 
2749 /* These next functions are used internally in the code. They generally
2750  * shouldn't be used unless you are writing code to add or replace some
2751  * functionality in libpng. More information about most functions can
2752  * be found in the files where the functions are located.
2753  */
2754 
2755 
2756 /* Various modes of operation, that are visible to applications because
2757  * they are used for unknown chunk location.
2758  */
2759 #define PNG_HAVE_IHDR 0x01
2760 #define PNG_HAVE_PLTE 0x02
2761 #define PNG_HAVE_IDAT 0x04
2762 #define PNG_AFTER_IDAT 0x08 /* Have complete zlib datastream */
2763 #define PNG_HAVE_IEND 0x10
2764 
2765 #if defined(PNG_INTERNAL)
2766 
2767 /* More modes of operation. Note that after an init, mode is set to
2768  * zero automatically when the structure is created.
2769  */
2770 #define PNG_HAVE_gAMA 0x20
2771 #define PNG_HAVE_cHRM 0x40
2772 #define PNG_HAVE_sRGB 0x80
2773 #define PNG_HAVE_CHUNK_HEADER 0x100
2774 #define PNG_WROTE_tIME 0x200
2775 #define PNG_WROTE_INFO_BEFORE_PLTE 0x400
2776 #define PNG_BACKGROUND_IS_GRAY 0x800
2777 #define PNG_HAVE_PNG_SIGNATURE 0x1000
2778 #define PNG_HAVE_CHUNK_AFTER_IDAT 0x2000 /* Have another chunk after IDAT */
2779 
2780 /* flags for the transformations the PNG library does on the image data */
2781 #define PNG_BGR 0x0001
2782 #define PNG_INTERLACE 0x0002
2783 #define PNG_PACK 0x0004
2784 #define PNG_SHIFT 0x0008
2785 #define PNG_SWAP_BYTES 0x0010
2786 #define PNG_INVERT_MONO 0x0020
2787 #define PNG_DITHER 0x0040
2788 #define PNG_BACKGROUND 0x0080
2789 #define PNG_BACKGROUND_EXPAND 0x0100
2790  /* 0x0200 unused */
2791 #define PNG_16_TO_8 0x0400
2792 #define PNG_RGBA 0x0800
2793 #define PNG_EXPAND 0x1000
2794 #define PNG_GAMMA 0x2000
2795 #define PNG_GRAY_TO_RGB 0x4000
2796 #define PNG_FILLER 0x8000L
2797 #define PNG_PACKSWAP 0x10000L
2798 #define PNG_SWAP_ALPHA 0x20000L
2799 #define PNG_STRIP_ALPHA 0x40000L
2800 #define PNG_INVERT_ALPHA 0x80000L
2801 #define PNG_USER_TRANSFORM 0x100000L
2802 #define PNG_RGB_TO_GRAY_ERR 0x200000L
2803 #define PNG_RGB_TO_GRAY_WARN 0x400000L
2804 #define PNG_RGB_TO_GRAY 0x600000L /* two bits, RGB_TO_GRAY_ERR|WARN */
2805  /* 0x800000L Unused */
2806 #define PNG_ADD_ALPHA 0x1000000L /* Added to libpng-1.2.7 */
2807 #define PNG_EXPAND_tRNS 0x2000000L /* Added to libpng-1.2.9 */
2808  /* 0x4000000L unused */
2809  /* 0x8000000L unused */
2810  /* 0x10000000L unused */
2811  /* 0x20000000L unused */
2812  /* 0x40000000L unused */
2813 
2814 /* flags for png_create_struct */
2815 #define PNG_STRUCT_PNG 0x0001
2816 #define PNG_STRUCT_INFO 0x0002
2817 
2818 /* Scaling factor for filter heuristic weighting calculations */
2819 #define PNG_WEIGHT_SHIFT 8
2820 #define PNG_WEIGHT_FACTOR (1<<(PNG_WEIGHT_SHIFT))
2821 #define PNG_COST_SHIFT 3
2822 #define PNG_COST_FACTOR (1<<(PNG_COST_SHIFT))
2823 
2824 /* flags for the png_ptr->flags rather than declaring a byte for each one */
2825 #define PNG_FLAG_ZLIB_CUSTOM_STRATEGY 0x0001
2826 #define PNG_FLAG_ZLIB_CUSTOM_LEVEL 0x0002
2827 #define PNG_FLAG_ZLIB_CUSTOM_MEM_LEVEL 0x0004
2828 #define PNG_FLAG_ZLIB_CUSTOM_WINDOW_BITS 0x0008
2829 #define PNG_FLAG_ZLIB_CUSTOM_METHOD 0x0010
2830 #define PNG_FLAG_ZLIB_FINISHED 0x0020
2831 #define PNG_FLAG_ROW_INIT 0x0040
2832 #define PNG_FLAG_FILLER_AFTER 0x0080
2833 #define PNG_FLAG_CRC_ANCILLARY_USE 0x0100
2834 #define PNG_FLAG_CRC_ANCILLARY_NOWARN 0x0200
2835 #define PNG_FLAG_CRC_CRITICAL_USE 0x0400
2836 #define PNG_FLAG_CRC_CRITICAL_IGNORE 0x0800
2837 #define PNG_FLAG_FREE_PLTE 0x1000
2838 #define PNG_FLAG_FREE_TRNS 0x2000
2839 #define PNG_FLAG_FREE_HIST 0x4000
2840 #define PNG_FLAG_KEEP_UNKNOWN_CHUNKS 0x8000L
2841 #define PNG_FLAG_KEEP_UNSAFE_CHUNKS 0x10000L
2842 #define PNG_FLAG_LIBRARY_MISMATCH 0x20000L
2843 #define PNG_FLAG_STRIP_ERROR_NUMBERS 0x40000L
2844 #define PNG_FLAG_STRIP_ERROR_TEXT 0x80000L
2845 #define PNG_FLAG_MALLOC_NULL_MEM_OK 0x100000L
2846 #define PNG_FLAG_ADD_ALPHA 0x200000L /* Added to libpng-1.2.8 */
2847 #define PNG_FLAG_STRIP_ALPHA 0x400000L /* Added to libpng-1.2.8 */
2848  /* 0x800000L unused */
2849  /* 0x1000000L unused */
2850  /* 0x2000000L unused */
2851  /* 0x4000000L unused */
2852  /* 0x8000000L unused */
2853  /* 0x10000000L unused */
2854  /* 0x20000000L unused */
2855  /* 0x40000000L unused */
2856 
2857 #define PNG_FLAG_CRC_ANCILLARY_MASK (PNG_FLAG_CRC_ANCILLARY_USE | \
2858  PNG_FLAG_CRC_ANCILLARY_NOWARN)
2859 
2860 #define PNG_FLAG_CRC_CRITICAL_MASK (PNG_FLAG_CRC_CRITICAL_USE | \
2861  PNG_FLAG_CRC_CRITICAL_IGNORE)
2862 
2863 #define PNG_FLAG_CRC_MASK (PNG_FLAG_CRC_ANCILLARY_MASK | \
2864  PNG_FLAG_CRC_CRITICAL_MASK)
2865 
2866 /* save typing and make code easier to understand */
2867 
2868 #define PNG_COLOR_DIST(c1, c2) (abs((int)((c1).red) - (int)((c2).red)) + \
2869  abs((int)((c1).green) - (int)((c2).green)) + \
2870  abs((int)((c1).blue) - (int)((c2).blue)))
2871 
2872 /* Added to libpng-1.2.6 JB */
2873 #define PNG_ROWBYTES(pixel_bits, width) \
2874  ((pixel_bits) >= 8 ? \
2875  ((width) * (((png_uint_32)(pixel_bits)) >> 3)) : \
2876  (( ((width) * ((png_uint_32)(pixel_bits))) + 7) >> 3) )
2877 
2878 /* PNG_OUT_OF_RANGE returns true if value is outside the range
2879  ideal-delta..ideal+delta. Each argument is evaluated twice.
2880  "ideal" and "delta" should be constants, normally simple
2881  integers, "value" a variable. Added to libpng-1.2.6 JB */
2882 #define PNG_OUT_OF_RANGE(value, ideal, delta) \
2883  ( (value) < (ideal)-(delta) || (value) > (ideal)+(delta) )
2884 
2885 /* variables declared in png.c - only it needs to define PNG_NO_EXTERN */
2886 #if !defined(PNG_NO_EXTERN) || defined(PNG_ALWAYS_EXTERN)
2887 /* place to hold the signature string for a PNG file. */
2888 #ifdef PNG_USE_GLOBAL_ARRAYS
2889  PNG_EXPORT_VAR (PNG_CONST png_byte FARDATA) png_sig[8];
2890 #else
2891 #endif
2892 #endif /* PNG_NO_EXTERN */
2893 
2894 /* Constant strings for known chunk types. If you need to add a chunk,
2895  * define the name here, and add an invocation of the macro in png.c and
2896  * wherever it's needed.
2897  */
2898 #define PNG_IHDR png_byte png_IHDR[5] = { 73, 72, 68, 82, '\0'}
2899 #define PNG_IDAT png_byte png_IDAT[5] = { 73, 68, 65, 84, '\0'}
2900 #define PNG_IEND png_byte png_IEND[5] = { 73, 69, 78, 68, '\0'}
2901 #define PNG_PLTE png_byte png_PLTE[5] = { 80, 76, 84, 69, '\0'}
2902 #define PNG_bKGD png_byte png_bKGD[5] = { 98, 75, 71, 68, '\0'}
2903 #define PNG_cHRM png_byte png_cHRM[5] = { 99, 72, 82, 77, '\0'}
2904 #define PNG_gAMA png_byte png_gAMA[5] = {103, 65, 77, 65, '\0'}
2905 #define PNG_hIST png_byte png_hIST[5] = {104, 73, 83, 84, '\0'}
2906 #define PNG_iCCP png_byte png_iCCP[5] = {105, 67, 67, 80, '\0'}
2907 #define PNG_iTXt png_byte png_iTXt[5] = {105, 84, 88, 116, '\0'}
2908 #define PNG_oFFs png_byte png_oFFs[5] = {111, 70, 70, 115, '\0'}
2909 #define PNG_pCAL png_byte png_pCAL[5] = {112, 67, 65, 76, '\0'}
2910 #define PNG_sCAL png_byte png_sCAL[5] = {115, 67, 65, 76, '\0'}
2911 #define PNG_pHYs png_byte png_pHYs[5] = {112, 72, 89, 115, '\0'}
2912 #define PNG_sBIT png_byte png_sBIT[5] = {115, 66, 73, 84, '\0'}
2913 #define PNG_sPLT png_byte png_sPLT[5] = {115, 80, 76, 84, '\0'}
2914 #define PNG_sRGB png_byte png_sRGB[5] = {115, 82, 71, 66, '\0'}
2915 #define PNG_tEXt png_byte png_tEXt[5] = {116, 69, 88, 116, '\0'}
2916 #define PNG_tIME png_byte png_tIME[5] = {116, 73, 77, 69, '\0'}
2917 #define PNG_tRNS png_byte png_tRNS[5] = {116, 82, 78, 83, '\0'}
2918 #define PNG_zTXt png_byte png_zTXt[5] = {122, 84, 88, 116, '\0'}
2919 
2920 #ifdef PNG_USE_GLOBAL_ARRAYS
2921 PNG_EXPORT_VAR (png_byte FARDATA) png_IHDR[5];
2922 PNG_EXPORT_VAR (png_byte FARDATA) png_IDAT[5];
2923 PNG_EXPORT_VAR (png_byte FARDATA) png_IEND[5];
2924 PNG_EXPORT_VAR (png_byte FARDATA) png_PLTE[5];
2925 PNG_EXPORT_VAR (png_byte FARDATA) png_bKGD[5];
2926 PNG_EXPORT_VAR (png_byte FARDATA) png_cHRM[5];
2927 PNG_EXPORT_VAR (png_byte FARDATA) png_gAMA[5];
2928 PNG_EXPORT_VAR (png_byte FARDATA) png_hIST[5];
2929 PNG_EXPORT_VAR (png_byte FARDATA) png_iCCP[5];
2930 PNG_EXPORT_VAR (png_byte FARDATA) png_iTXt[5];
2931 PNG_EXPORT_VAR (png_byte FARDATA) png_oFFs[5];
2932 PNG_EXPORT_VAR (png_byte FARDATA) png_pCAL[5];
2933 PNG_EXPORT_VAR (png_byte FARDATA) png_sCAL[5];
2934 PNG_EXPORT_VAR (png_byte FARDATA) png_pHYs[5];
2935 PNG_EXPORT_VAR (png_byte FARDATA) png_sBIT[5];
2936 PNG_EXPORT_VAR (png_byte FARDATA) png_sPLT[5];
2937 PNG_EXPORT_VAR (png_byte FARDATA) png_sRGB[5];
2938 PNG_EXPORT_VAR (png_byte FARDATA) png_tEXt[5];
2939 PNG_EXPORT_VAR (png_byte FARDATA) png_tIME[5];
2940 PNG_EXPORT_VAR (png_byte FARDATA) png_tRNS[5];
2941 PNG_EXPORT_VAR (png_byte FARDATA) png_zTXt[5];
2942 #endif /* PNG_USE_GLOBAL_ARRAYS */
2943 
2944 #if defined(PNG_1_0_X) || defined (PNG_1_2_X)
2945 /* Initialize png_ptr struct for reading, and allocate any other memory.
2946  * (old interface - DEPRECATED - use png_create_read_struct instead).
2947  */
2948 extern PNG_EXPORT(void,png_read_init) PNGARG((png_structp png_ptr));
2949 #undef png_read_init
2950 #define png_read_init(png_ptr) png_read_init_3(&png_ptr, \
2951  PNG_LIBPNG_VER_STRING, png_sizeof(png_struct));
2952 #endif
2953 
2954 extern PNG_EXPORT(void,png_read_init_3) PNGARG((png_structpp ptr_ptr,
2955  png_const_charp user_png_ver, png_size_t png_struct_size));
2956 #if defined(PNG_1_0_X) || defined (PNG_1_2_X)
2957 extern PNG_EXPORT(void,png_read_init_2) PNGARG((png_structp png_ptr,
2958  png_const_charp user_png_ver, png_size_t png_struct_size, png_size_t
2959  png_info_size));
2960 #endif
2961 
2962 #if defined(PNG_1_0_X) || defined (PNG_1_2_X)
2963 /* Initialize png_ptr struct for writing, and allocate any other memory.
2964  * (old interface - DEPRECATED - use png_create_write_struct instead).
2965  */
2966 extern PNG_EXPORT(void,png_write_init) PNGARG((png_structp png_ptr));
2967 #undef png_write_init
2968 #define png_write_init(png_ptr) png_write_init_3(&png_ptr, \
2969  PNG_LIBPNG_VER_STRING, png_sizeof(png_struct));
2970 #endif
2971 
2972 extern PNG_EXPORT(void,png_write_init_3) PNGARG((png_structpp ptr_ptr,
2973  png_const_charp user_png_ver, png_size_t png_struct_size));
2974 extern PNG_EXPORT(void,png_write_init_2) PNGARG((png_structp png_ptr,
2975  png_const_charp user_png_ver, png_size_t png_struct_size, png_size_t
2976  png_info_size));
2977 
2978 /* Allocate memory for an internal libpng struct */
2979 PNG_EXTERN png_voidp png_create_struct PNGARG((int type));
2980 
2981 /* Free memory from internal libpng struct */
2982 PNG_EXTERN void png_destroy_struct PNGARG((png_voidp struct_ptr));
2983 
2984 PNG_EXTERN png_voidp png_create_struct_2 PNGARG((int type, png_malloc_ptr
2985  malloc_fn, png_voidp mem_ptr));
2986 PNG_EXTERN void png_destroy_struct_2 PNGARG((png_voidp struct_ptr,
2987  png_free_ptr free_fn, png_voidp mem_ptr));
2988 
2989 /* Free any memory that info_ptr points to and reset struct. */
2990 PNG_EXTERN void png_info_destroy PNGARG((png_structp png_ptr,
2991  png_infop info_ptr));
2992 
2993 #ifndef PNG_1_0_X
2994 /* Function to allocate memory for zlib. */
2995 PNG_EXTERN voidpf png_zalloc PNGARG((voidpf png_ptr, uInt items, uInt size));
2996 
2997 /* Function to free memory for zlib */
2998 PNG_EXTERN void png_zfree PNGARG((voidpf png_ptr, voidpf ptr));
2999 
3000 #ifdef PNG_SIZE_T
3001 /* Function to convert a sizeof an item to png_sizeof item */
3002  PNG_EXTERN png_size_t PNGAPI png_convert_size PNGARG((size_t size));
3003 #endif
3004 
3005 /* Next four functions are used internally as callbacks. PNGAPI is required
3006  * but not PNG_EXPORT. PNGAPI added at libpng version 1.2.3. */
3007 
3008 PNG_EXTERN void PNGAPI png_default_read_data PNGARG((png_structp png_ptr,
3009  png_bytep data, png_size_t length));
3010 
3011 #ifdef PNG_PROGRESSIVE_READ_SUPPORTED
3012 PNG_EXTERN void PNGAPI png_push_fill_buffer PNGARG((png_structp png_ptr,
3013  png_bytep buffer, png_size_t length));
3014 #endif
3015 
3016 PNG_EXTERN void PNGAPI png_default_write_data PNGARG((png_structp png_ptr,
3017  png_bytep data, png_size_t length));
3018 
3019 #if defined(PNG_WRITE_FLUSH_SUPPORTED)
3020 #if !defined(PNG_NO_STDIO)
3021 PNG_EXTERN void PNGAPI png_default_flush PNGARG((png_structp png_ptr));
3022 #endif
3023 #endif
3024 #else /* PNG_1_0_X */
3025 #ifdef PNG_PROGRESSIVE_READ_SUPPORTED
3026 PNG_EXTERN void png_push_fill_buffer PNGARG((png_structp png_ptr,
3027  png_bytep buffer, png_size_t length));
3028 #endif
3029 #endif /* PNG_1_0_X */
3030 
3031 /* Reset the CRC variable */
3032 PNG_EXTERN void png_reset_crc PNGARG((png_structp png_ptr));
3033 
3034 /* Write the "data" buffer to whatever output you are using. */
3035 PNG_EXTERN void png_write_data PNGARG((png_structp png_ptr, png_bytep data,
3036  png_size_t length));
3037 
3038 /* Read data from whatever input you are using into the "data" buffer */
3039 PNG_EXTERN void png_read_data PNGARG((png_structp png_ptr, png_bytep data,
3040  png_size_t length));
3041 
3042 /* Read bytes into buf, and update png_ptr->crc */
3043 PNG_EXTERN void png_crc_read PNGARG((png_structp png_ptr, png_bytep buf,
3044  png_size_t length));
3045 
3046 /* Decompress data in a chunk that uses compression */
3047 #if defined(PNG_zTXt_SUPPORTED) || defined(PNG_iTXt_SUPPORTED) || \
3048  defined(PNG_iCCP_SUPPORTED) || defined(PNG_sPLT_SUPPORTED)
3049 PNG_EXTERN void png_decompress_chunk PNGARG((png_structp png_ptr,
3050  int comp_type, png_size_t chunklength,
3051  png_size_t prefix_length, png_size_t *data_length));
3052 #endif
3053 
3054 /* Read "skip" bytes, read the file crc, and (optionally) verify png_ptr->crc */
3055 PNG_EXTERN int png_crc_finish PNGARG((png_structp png_ptr, png_uint_32 skip));
3056 
3057 /* Read the CRC from the file and compare it to the libpng calculated CRC */
3058 PNG_EXTERN int png_crc_error PNGARG((png_structp png_ptr));
3059 
3060 /* Calculate the CRC over a section of data. Note that we are only
3061  * passing a maximum of 64K on systems that have this as a memory limit,
3062  * since this is the maximum buffer size we can specify.
3063  */
3064 PNG_EXTERN void png_calculate_crc PNGARG((png_structp png_ptr, png_bytep ptr,
3065  png_size_t length));
3066 
3067 #if defined(PNG_WRITE_FLUSH_SUPPORTED)
3068 PNG_EXTERN void png_flush PNGARG((png_structp png_ptr));
3069 #endif
3070 
3071 /* simple function to write the signature */
3072 PNG_EXTERN void png_write_sig PNGARG((png_structp png_ptr));
3073 
3074 /* write various chunks */
3075 
3076 /* Write the IHDR chunk, and update the png_struct with the necessary
3077  * information.
3078  */
3079 PNG_EXTERN void png_write_IHDR PNGARG((png_structp png_ptr, png_uint_32 width,
3080  png_uint_32 height,
3081  int bit_depth, int color_type, int compression_method, int filter_method,
3082  int interlace_method));
3083 
3084 PNG_EXTERN void png_write_PLTE PNGARG((png_structp png_ptr, png_colorp palette,
3085  png_uint_32 num_pal));
3086 
3087 PNG_EXTERN void png_write_IDAT PNGARG((png_structp png_ptr, png_bytep data,
3088  png_size_t length));
3089 
3090 PNG_EXTERN void png_write_IEND PNGARG((png_structp png_ptr));
3091 
3092 #if defined(PNG_WRITE_gAMA_SUPPORTED)
3093 #ifdef PNG_FLOATING_POINT_SUPPORTED
3094 PNG_EXTERN void png_write_gAMA PNGARG((png_structp png_ptr, double file_gamma));
3095 #endif
3096 #ifdef PNG_FIXED_POINT_SUPPORTED
3097 PNG_EXTERN void png_write_gAMA_fixed PNGARG((png_structp png_ptr, png_fixed_point
3098  file_gamma));
3099 #endif
3100 #endif
3101 
3102 #if defined(PNG_WRITE_sBIT_SUPPORTED)
3103 PNG_EXTERN void png_write_sBIT PNGARG((png_structp png_ptr, png_color_8p sbit,
3104  int color_type));
3105 #endif
3106 
3107 #if defined(PNG_WRITE_cHRM_SUPPORTED)
3108 #ifdef PNG_FLOATING_POINT_SUPPORTED
3109 PNG_EXTERN void png_write_cHRM PNGARG((png_structp png_ptr,
3110  double white_x, double white_y,
3111  double red_x, double red_y, double green_x, double green_y,
3112  double blue_x, double blue_y));
3113 #endif
3114 #ifdef PNG_FIXED_POINT_SUPPORTED
3115 PNG_EXTERN void png_write_cHRM_fixed PNGARG((png_structp png_ptr,
3116  png_fixed_point int_white_x, png_fixed_point int_white_y,
3117  png_fixed_point int_red_x, png_fixed_point int_red_y, png_fixed_point
3118  int_green_x, png_fixed_point int_green_y, png_fixed_point int_blue_x,
3119  png_fixed_point int_blue_y));
3120 #endif
3121 #endif
3122 
3123 #if defined(PNG_WRITE_sRGB_SUPPORTED)
3124 PNG_EXTERN void png_write_sRGB PNGARG((png_structp png_ptr,
3125  int intent));
3126 #endif
3127 
3128 #if defined(PNG_WRITE_iCCP_SUPPORTED)
3129 PNG_EXTERN void png_write_iCCP PNGARG((png_structp png_ptr,
3130  png_charp name, int compression_type,
3131  png_charp profile, int proflen));
3132  /* Note to maintainer: profile should be png_bytep */
3133 #endif
3134 
3135 #if defined(PNG_WRITE_sPLT_SUPPORTED)
3136 PNG_EXTERN void png_write_sPLT PNGARG((png_structp png_ptr,
3137  png_sPLT_tp palette));
3138 #endif
3139 
3140 #if defined(PNG_WRITE_tRNS_SUPPORTED)
3141 PNG_EXTERN void png_write_tRNS PNGARG((png_structp png_ptr, png_bytep trans,
3142  png_color_16p values, int number, int color_type));
3143 #endif
3144 
3145 #if defined(PNG_WRITE_bKGD_SUPPORTED)
3146 PNG_EXTERN void png_write_bKGD PNGARG((png_structp png_ptr,
3147  png_color_16p values, int color_type));
3148 #endif
3149 
3150 #if defined(PNG_WRITE_hIST_SUPPORTED)
3151 PNG_EXTERN void png_write_hIST PNGARG((png_structp png_ptr, png_uint_16p hist,
3152  int num_hist));
3153 #endif
3154 
3155 #if defined(PNG_WRITE_TEXT_SUPPORTED) || defined(PNG_WRITE_pCAL_SUPPORTED) || \
3156  defined(PNG_WRITE_iCCP_SUPPORTED) || defined(PNG_WRITE_sPLT_SUPPORTED)
3157 PNG_EXTERN png_size_t png_check_keyword PNGARG((png_structp png_ptr,
3158  png_charp key, png_charpp new_key));
3159 #endif
3160 
3161 #if defined(PNG_WRITE_tEXt_SUPPORTED)
3162 PNG_EXTERN void png_write_tEXt PNGARG((png_structp png_ptr, png_charp key,
3163  png_charp text, png_size_t text_len));
3164 #endif
3165 
3166 #if defined(PNG_WRITE_zTXt_SUPPORTED)
3167 PNG_EXTERN void png_write_zTXt PNGARG((png_structp png_ptr, png_charp key,
3168  png_charp text, png_size_t text_len, int compression));
3169 #endif
3170 
3171 #if defined(PNG_WRITE_iTXt_SUPPORTED)
3172 PNG_EXTERN void png_write_iTXt PNGARG((png_structp png_ptr,
3173  int compression, png_charp key, png_charp lang, png_charp lang_key,
3174  png_charp text));
3175 #endif
3176 
3177 #if defined(PNG_TEXT_SUPPORTED) /* Added at version 1.0.14 and 1.2.4 */
3178 PNG_EXTERN int png_set_text_2 PNGARG((png_structp png_ptr,
3179  png_infop info_ptr, png_textp text_ptr, int num_text));
3180 #endif
3181 
3182 #if defined(PNG_WRITE_oFFs_SUPPORTED)
3183 PNG_EXTERN void png_write_oFFs PNGARG((png_structp png_ptr,
3184  png_int_32 x_offset, png_int_32 y_offset, int unit_type));
3185 #endif
3186 
3187 #if defined(PNG_WRITE_pCAL_SUPPORTED)
3188 PNG_EXTERN void png_write_pCAL PNGARG((png_structp png_ptr, png_charp purpose,
3189  png_int_32 X0, png_int_32 X1, int type, int nparams,
3190  png_charp units, png_charpp params));
3191 #endif
3192 
3193 #if defined(PNG_WRITE_pHYs_SUPPORTED)
3194 PNG_EXTERN void png_write_pHYs PNGARG((png_structp png_ptr,
3195  png_uint_32 x_pixels_per_unit, png_uint_32 y_pixels_per_unit,
3196  int unit_type));
3197 #endif
3198 
3199 #if defined(PNG_WRITE_tIME_SUPPORTED)
3200 PNG_EXTERN void png_write_tIME PNGARG((png_structp png_ptr,
3201  png_timep mod_time));
3202 #endif
3203 
3204 #if defined(PNG_WRITE_sCAL_SUPPORTED)
3205 #if defined(PNG_FLOATING_POINT_SUPPORTED) && !defined(PNG_NO_STDIO)
3206 PNG_EXTERN void png_write_sCAL PNGARG((png_structp png_ptr,
3207  int unit, double width, double height));
3208 #else
3209 #ifdef PNG_FIXED_POINT_SUPPORTED
3210 PNG_EXTERN void png_write_sCAL_s PNGARG((png_structp png_ptr,
3211  int unit, png_charp width, png_charp height));
3212 #endif
3213 #endif
3214 #endif
3215 
3216 /* Called when finished processing a row of data */
3217 PNG_EXTERN void png_write_finish_row PNGARG((png_structp png_ptr));
3218 
3219 /* Internal use only. Called before first row of data */
3220 PNG_EXTERN void png_write_start_row PNGARG((png_structp png_ptr));
3221 
3222 #if defined(PNG_READ_GAMMA_SUPPORTED)
3223 PNG_EXTERN void png_build_gamma_table PNGARG((png_structp png_ptr));
3224 #endif
3225 
3226 /* combine a row of data, dealing with alpha, etc. if requested */
3227 PNG_EXTERN void png_combine_row PNGARG((png_structp png_ptr, png_bytep row,
3228  int mask));
3229 
3230 #if defined(PNG_READ_INTERLACING_SUPPORTED)
3231 /* expand an interlaced row */
3232 /* OLD pre-1.0.9 interface:
3233 PNG_EXTERN void png_do_read_interlace PNGARG((png_row_infop row_info,
3234  png_bytep row, int pass, png_uint_32 transformations));
3235  */
3236 PNG_EXTERN void png_do_read_interlace PNGARG((png_structp png_ptr));
3237 #endif
3238 
3239 /* GRR TO DO (2.0 or whenever): simplify other internal calling interfaces */
3240 
3241 #if defined(PNG_WRITE_INTERLACING_SUPPORTED)
3242 /* grab pixels out of a row for an interlaced pass */
3243 PNG_EXTERN void png_do_write_interlace PNGARG((png_row_infop row_info,
3244  png_bytep row, int pass));
3245 #endif
3246 
3247 /* unfilter a row */
3248 PNG_EXTERN void png_read_filter_row PNGARG((png_structp png_ptr,
3249  png_row_infop row_info, png_bytep row, png_bytep prev_row, int filter));
3250 
3251 /* Choose the best filter to use and filter the row data */
3252 PNG_EXTERN void png_write_find_filter PNGARG((png_structp png_ptr,
3253  png_row_infop row_info));
3254 
3255 /* Write out the filtered row. */
3256 PNG_EXTERN void png_write_filtered_row PNGARG((png_structp png_ptr,
3257  png_bytep filtered_row));
3258 /* finish a row while reading, dealing with interlacing passes, etc. */
3259 PNG_EXTERN void png_read_finish_row PNGARG((png_structp png_ptr));
3260 
3261 /* initialize the row buffers, etc. */
3262 PNG_EXTERN void png_read_start_row PNGARG((png_structp png_ptr));
3263 /* optional call to update the users info structure */
3264 PNG_EXTERN void png_read_transform_info PNGARG((png_structp png_ptr,
3265  png_infop info_ptr));
3266 
3267 /* these are the functions that do the transformations */
3268 #if defined(PNG_READ_FILLER_SUPPORTED)
3269 PNG_EXTERN void png_do_read_filler PNGARG((png_row_infop row_info,
3270  png_bytep row, png_uint_32 filler, png_uint_32 flags));
3271 #endif
3272 
3273 #if defined(PNG_READ_SWAP_ALPHA_SUPPORTED)
3274 PNG_EXTERN void png_do_read_swap_alpha PNGARG((png_row_infop row_info,
3275  png_bytep row));
3276 #endif
3277 
3278 #if defined(PNG_WRITE_SWAP_ALPHA_SUPPORTED)
3279 PNG_EXTERN void png_do_write_swap_alpha PNGARG((png_row_infop row_info,
3280  png_bytep row));
3281 #endif
3282 
3283 #if defined(PNG_READ_INVERT_ALPHA_SUPPORTED)
3284 PNG_EXTERN void png_do_read_invert_alpha PNGARG((png_row_infop row_info,
3285  png_bytep row));
3286 #endif
3287 
3288 #if defined(PNG_WRITE_INVERT_ALPHA_SUPPORTED)
3289 PNG_EXTERN void png_do_write_invert_alpha PNGARG((png_row_infop row_info,
3290  png_bytep row));
3291 #endif
3292 
3293 #if defined(PNG_WRITE_FILLER_SUPPORTED) || \
3294  defined(PNG_READ_STRIP_ALPHA_SUPPORTED)
3295 PNG_EXTERN void png_do_strip_filler PNGARG((png_row_infop row_info,
3296  png_bytep row, png_uint_32 flags));
3297 #endif
3298 
3299 #if defined(PNG_READ_SWAP_SUPPORTED) || defined(PNG_WRITE_SWAP_SUPPORTED)
3300 PNG_EXTERN void png_do_swap PNGARG((png_row_infop row_info, png_bytep row));
3301 #endif
3302 
3303 #if defined(PNG_READ_PACKSWAP_SUPPORTED) || defined(PNG_WRITE_PACKSWAP_SUPPORTED)
3304 PNG_EXTERN void png_do_packswap PNGARG((png_row_infop row_info, png_bytep row));
3305 #endif
3306 
3307 #if defined(PNG_READ_RGB_TO_GRAY_SUPPORTED)
3308 PNG_EXTERN int png_do_rgb_to_gray PNGARG((png_structp png_ptr, png_row_infop
3309  row_info, png_bytep row));
3310 #endif
3311 
3312 #if defined(PNG_READ_GRAY_TO_RGB_SUPPORTED)
3313 PNG_EXTERN void png_do_gray_to_rgb PNGARG((png_row_infop row_info,
3314  png_bytep row));
3315 #endif
3316 
3317 #if defined(PNG_READ_PACK_SUPPORTED)
3318 PNG_EXTERN void png_do_unpack PNGARG((png_row_infop row_info, png_bytep row));
3319 #endif
3320 
3321 #if defined(PNG_READ_SHIFT_SUPPORTED)
3322 PNG_EXTERN void png_do_unshift PNGARG((png_row_infop row_info, png_bytep row,
3323  png_color_8p sig_bits));
3324 #endif
3325 
3326 #if defined(PNG_READ_INVERT_SUPPORTED) || defined(PNG_WRITE_INVERT_SUPPORTED)
3327 PNG_EXTERN void png_do_invert PNGARG((png_row_infop row_info, png_bytep row));
3328 #endif
3329 
3330 #if defined(PNG_READ_16_TO_8_SUPPORTED)
3331 PNG_EXTERN void png_do_chop PNGARG((png_row_infop row_info, png_bytep row));
3332 #endif
3333 
3334 #if defined(PNG_READ_DITHER_SUPPORTED)
3335 PNG_EXTERN void png_do_dither PNGARG((png_row_infop row_info,
3336  png_bytep row, png_bytep palette_lookup, png_bytep dither_lookup));
3337 
3338 # if defined(PNG_CORRECT_PALETTE_SUPPORTED)
3339 PNG_EXTERN void png_correct_palette PNGARG((png_structp png_ptr,
3340  png_colorp palette, int num_palette));
3341 # endif
3342 #endif
3343 
3344 #if defined(PNG_READ_BGR_SUPPORTED) || defined(PNG_WRITE_BGR_SUPPORTED)
3345 PNG_EXTERN void png_do_bgr PNGARG((png_row_infop row_info, png_bytep row));
3346 #endif
3347 
3348 #if defined(PNG_WRITE_PACK_SUPPORTED)
3349 PNG_EXTERN void png_do_pack PNGARG((png_row_infop row_info,
3350  png_bytep row, png_uint_32 bit_depth));
3351 #endif
3352 
3353 #if defined(PNG_WRITE_SHIFT_SUPPORTED)
3354 PNG_EXTERN void png_do_shift PNGARG((png_row_infop row_info, png_bytep row,
3355  png_color_8p bit_depth));
3356 #endif
3357 
3358 #if defined(PNG_READ_BACKGROUND_SUPPORTED)
3359 #if defined(PNG_READ_GAMMA_SUPPORTED)
3360 PNG_EXTERN void png_do_background PNGARG((png_row_infop row_info, png_bytep row,
3361  png_color_16p trans_values, png_color_16p background,
3362  png_color_16p background_1,
3366 #else
3367 PNG_EXTERN void png_do_background PNGARG((png_row_infop row_info, png_bytep row,
3368  png_color_16p trans_values, png_color_16p background));
3369 #endif
3370 #endif
3371 
3372 #if defined(PNG_READ_GAMMA_SUPPORTED)
3373 PNG_EXTERN void png_do_gamma PNGARG((png_row_infop row_info, png_bytep row,
3375  int gamma_shift));
3376 #endif
3377 
3378 #if defined(PNG_READ_EXPAND_SUPPORTED)
3379 PNG_EXTERN void png_do_expand_palette PNGARG((png_row_infop row_info,
3380  png_bytep row, png_colorp palette, png_bytep trans, int num_trans));
3381 PNG_EXTERN void png_do_expand PNGARG((png_row_infop row_info,
3382  png_bytep row, png_color_16p trans_value));
3383 #endif
3384 
3385 /* The following decodes the appropriate chunks, and does error correction,
3386  * then calls the appropriate callback for the chunk if it is valid.
3387  */
3388 
3389 /* decode the IHDR chunk */
3390 PNG_EXTERN void png_handle_IHDR PNGARG((png_structp png_ptr, png_infop info_ptr,
3391  png_uint_32 length));
3392 PNG_EXTERN void png_handle_PLTE PNGARG((png_structp png_ptr, png_infop info_ptr,
3393  png_uint_32 length));
3394 PNG_EXTERN void png_handle_IEND PNGARG((png_structp png_ptr, png_infop info_ptr,
3395  png_uint_32 length));
3396 
3397 #if defined(PNG_READ_bKGD_SUPPORTED)
3398 PNG_EXTERN void png_handle_bKGD PNGARG((png_structp png_ptr, png_infop info_ptr,
3399  png_uint_32 length));
3400 #endif
3401 
3402 #if defined(PNG_READ_cHRM_SUPPORTED)
3403 PNG_EXTERN void png_handle_cHRM PNGARG((png_structp png_ptr, png_infop info_ptr,
3404  png_uint_32 length));
3405 #endif
3406 
3407 #if defined(PNG_READ_gAMA_SUPPORTED)
3408 PNG_EXTERN void png_handle_gAMA PNGARG((png_structp png_ptr, png_infop info_ptr,
3409  png_uint_32 length));
3410 #endif
3411 
3412 #if defined(PNG_READ_hIST_SUPPORTED)
3413 PNG_EXTERN void png_handle_hIST PNGARG((png_structp png_ptr, png_infop info_ptr,
3414  png_uint_32 length));
3415 #endif
3416 
3417 #if defined(PNG_READ_iCCP_SUPPORTED)
3418 extern void png_handle_iCCP PNGARG((png_structp png_ptr, png_infop info_ptr,
3419  png_uint_32 length));
3420 #endif /* PNG_READ_iCCP_SUPPORTED */
3421 
3422 #if defined(PNG_READ_iTXt_SUPPORTED)
3423 PNG_EXTERN void png_handle_iTXt PNGARG((png_structp png_ptr, png_infop info_ptr,
3424  png_uint_32 length));
3425 #endif
3426 
3427 #if defined(PNG_READ_oFFs_SUPPORTED)
3428 PNG_EXTERN void png_handle_oFFs PNGARG((png_structp png_ptr, png_infop info_ptr,
3429  png_uint_32 length));
3430 #endif
3431 
3432 #if defined(PNG_READ_pCAL_SUPPORTED)
3433 PNG_EXTERN void png_handle_pCAL PNGARG((png_structp png_ptr, png_infop info_ptr,
3434  png_uint_32 length));
3435 #endif
3436 
3437 #if defined(PNG_READ_pHYs_SUPPORTED)
3438 PNG_EXTERN void png_handle_pHYs PNGARG((png_structp png_ptr, png_infop info_ptr,
3439  png_uint_32 length));
3440 #endif
3441 
3442 #if defined(PNG_READ_sBIT_SUPPORTED)
3443 PNG_EXTERN void png_handle_sBIT PNGARG((png_structp png_ptr, png_infop info_ptr,
3444  png_uint_32 length));
3445 #endif
3446 
3447 #if defined(PNG_READ_sCAL_SUPPORTED)
3448 PNG_EXTERN void png_handle_sCAL PNGARG((png_structp png_ptr, png_infop info_ptr,
3449  png_uint_32 length));
3450 #endif
3451 
3452 #if defined(PNG_READ_sPLT_SUPPORTED)
3453 extern void png_handle_sPLT PNGARG((png_structp png_ptr, png_infop info_ptr,
3454  png_uint_32 length));
3455 #endif /* PNG_READ_sPLT_SUPPORTED */
3456 
3457 #if defined(PNG_READ_sRGB_SUPPORTED)
3458 PNG_EXTERN void png_handle_sRGB PNGARG((png_structp png_ptr, png_infop info_ptr,
3459  png_uint_32 length));
3460 #endif
3461 
3462 #if defined(PNG_READ_tEXt_SUPPORTED)
3463 PNG_EXTERN void png_handle_tEXt PNGARG((png_structp png_ptr, png_infop info_ptr,
3464  png_uint_32 length));
3465 #endif
3466 
3467 #if defined(PNG_READ_tIME_SUPPORTED)
3468 PNG_EXTERN void png_handle_tIME PNGARG((png_structp png_ptr, png_infop info_ptr,
3469  png_uint_32 length));
3470 #endif
3471 
3472 #if defined(PNG_READ_tRNS_SUPPORTED)
3473 PNG_EXTERN void png_handle_tRNS PNGARG((png_structp png_ptr, png_infop info_ptr,
3474  png_uint_32 length));
3475 #endif
3476 
3477 #if defined(PNG_READ_zTXt_SUPPORTED)
3478 PNG_EXTERN void png_handle_zTXt PNGARG((png_structp png_ptr, png_infop info_ptr,
3479  png_uint_32 length));
3480 #endif
3481 
3482 PNG_EXTERN void png_handle_unknown PNGARG((png_structp png_ptr,
3483  png_infop info_ptr, png_uint_32 length));
3484 
3485 PNG_EXTERN void png_check_chunk_name PNGARG((png_structp png_ptr,
3486  png_bytep chunk_name));
3487 
3488 /* handle the transformations for reading and writing */
3489 PNG_EXTERN void png_do_read_transformations PNGARG((png_structp png_ptr));
3490 PNG_EXTERN void png_do_write_transformations PNGARG((png_structp png_ptr));
3491 
3492 PNG_EXTERN void png_init_read_transformations PNGARG((png_structp png_ptr));
3493 
3494 #ifdef PNG_PROGRESSIVE_READ_SUPPORTED
3495 PNG_EXTERN void png_push_read_chunk PNGARG((png_structp png_ptr,
3496  png_infop info_ptr));
3497 PNG_EXTERN void png_push_read_sig PNGARG((png_structp png_ptr,
3498  png_infop info_ptr));
3499 PNG_EXTERN void png_push_check_crc PNGARG((png_structp png_ptr));
3500 PNG_EXTERN void png_push_crc_skip PNGARG((png_structp png_ptr,
3501  png_uint_32 length));
3502 PNG_EXTERN void png_push_crc_finish PNGARG((png_structp png_ptr));
3503 PNG_EXTERN void png_push_save_buffer PNGARG((png_structp png_ptr));
3504 PNG_EXTERN void png_push_restore_buffer PNGARG((png_structp png_ptr,
3505  png_bytep buffer, png_size_t buffer_length));
3506 PNG_EXTERN void png_push_read_IDAT PNGARG((png_structp png_ptr));
3507 PNG_EXTERN void png_process_IDAT_data PNGARG((png_structp png_ptr,
3508  png_bytep buffer, png_size_t buffer_length));
3509 PNG_EXTERN void png_push_process_row PNGARG((png_structp png_ptr));
3510 PNG_EXTERN void png_push_handle_unknown PNGARG((png_structp png_ptr,
3511  png_infop info_ptr, png_uint_32 length));
3512 PNG_EXTERN void png_push_have_info PNGARG((png_structp png_ptr,
3513  png_infop info_ptr));
3514 PNG_EXTERN void png_push_have_end PNGARG((png_structp png_ptr,
3515  png_infop info_ptr));
3516 PNG_EXTERN void png_push_have_row PNGARG((png_structp png_ptr, png_bytep row));
3517 PNG_EXTERN void png_push_read_end PNGARG((png_structp png_ptr,
3518  png_infop info_ptr));
3519 PNG_EXTERN void png_process_some_data PNGARG((png_structp png_ptr,
3520  png_infop info_ptr));
3521 PNG_EXTERN void png_read_push_finish_row PNGARG((png_structp png_ptr));
3522 #if defined(PNG_READ_tEXt_SUPPORTED)
3523 PNG_EXTERN void png_push_handle_tEXt PNGARG((png_structp png_ptr,
3524  png_infop info_ptr, png_uint_32 length));
3525 PNG_EXTERN void png_push_read_tEXt PNGARG((png_structp png_ptr,
3526  png_infop info_ptr));
3527 #endif
3528 #if defined(PNG_READ_zTXt_SUPPORTED)
3529 PNG_EXTERN void png_push_handle_zTXt PNGARG((png_structp png_ptr,
3530  png_infop info_ptr, png_uint_32 length));
3531 PNG_EXTERN void png_push_read_zTXt PNGARG((png_structp png_ptr,
3532  png_infop info_ptr));
3533 #endif
3534 #if defined(PNG_READ_iTXt_SUPPORTED)
3535 PNG_EXTERN void png_push_handle_iTXt PNGARG((png_structp png_ptr,
3536  png_infop info_ptr, png_uint_32 length));
3537 PNG_EXTERN void png_push_read_iTXt PNGARG((png_structp png_ptr,
3538  png_infop info_ptr));
3539 #endif
3540 
3541 #endif /* PNG_PROGRESSIVE_READ_SUPPORTED */
3542 
3543 #ifdef PNG_MNG_FEATURES_SUPPORTED
3544 PNG_EXTERN void png_do_read_intrapixel PNGARG((png_row_infop row_info,
3545  png_bytep row));
3546 PNG_EXTERN void png_do_write_intrapixel PNGARG((png_row_infop row_info,
3547  png_bytep row));
3548 #endif
3549 
3550 #if defined(PNG_ASSEMBLER_CODE_SUPPORTED)
3551 #if defined(PNG_MMX_CODE_SUPPORTED)
3552 /* png.c */ /* PRIVATE */
3553 PNG_EXTERN void png_init_mmx_flags PNGARG((png_structp png_ptr));
3554 #endif
3555 #endif
3556 
3557 #if defined(PNG_INCH_CONVERSIONS) && defined(PNG_FLOATING_POINT_SUPPORTED)
3558 PNG_EXTERN png_uint_32 png_get_pixels_per_inch PNGARG((png_structp png_ptr,
3559 png_infop info_ptr));
3560 
3561 PNG_EXTERN png_uint_32 png_get_x_pixels_per_inch PNGARG((png_structp png_ptr,
3562 png_infop info_ptr));
3563 
3564 PNG_EXTERN png_uint_32 png_get_y_pixels_per_inch PNGARG((png_structp png_ptr,
3565 png_infop info_ptr));
3566 
3567 PNG_EXTERN float png_get_x_offset_inches PNGARG((png_structp png_ptr,
3568 png_infop info_ptr));
3569 
3570 PNG_EXTERN float png_get_y_offset_inches PNGARG((png_structp png_ptr,
3571 png_infop info_ptr));
3572 
3573 #if defined(PNG_pHYs_SUPPORTED)
3574 PNG_EXTERN png_uint_32 png_get_pHYs_dpi PNGARG((png_structp png_ptr,
3575 png_infop info_ptr, png_uint_32 *res_x, png_uint_32 *res_y, int *unit_type));
3576 #endif /* PNG_pHYs_SUPPORTED */
3577 #endif /* PNG_INCH_CONVERSIONS && PNG_FLOATING_POINT_SUPPORTED */
3578 
3579 /* Read the chunk header (length + type name) */
3580 PNG_EXTERN png_uint_32 png_read_chunk_header PNGARG((png_structp png_ptr));
3581 
3582 /* Maintainer: Put new private prototypes here ^ and in libpngpf.3 */
3583 
3584 #endif /* PNG_INTERNAL */
3585 
3586 #ifdef __cplusplus
3587 }
3588 #endif
3589 
3590 #endif /* PNG_VERSION_INFO_ONLY */
3591 /* do not put anything past this line */
3592 #endif /* PNG_H */
png_uint_32 mng_features_permitted
Definition: png.h:2572
void png_do_read_intrapixel(png_row_infop row_info, png_bytep row)
Definition: pngrtran.c:4239
png_uint_16p inv_filter_weights
Definition: png.h:1355
void png_write_sCAL(png_structp png_ptr, int unit, double width, double height)
Definition: pngwutil.c:1632
int heuristic_method
Definition: png.h:1905
void png_do_write_intrapixel(png_row_infop row_info, png_bytep row)
Definition: pngwtran.c:515
png_int_32 PNGAPI png_get_y_offset_microns(png_structp png_ptr, png_infop info_ptr)
Definition: pngget.c:212
void png_push_read_IDAT(png_structp png_ptr)
Definition: pngpread.c:662
png_color_8 shift
Definition: png.h:1296
void PNGAPI png_set_iCCP(png_structp png_ptr, png_infop info_ptr, png_charp name, int compression_type, png_charp profile, png_uint_32 proflen)
Definition: pngset.c:684
png_textp text
Definition: png.h:800
png_infop png_charpp int png_charpp profile
Definition: png.h:2382
png_uint_32 PNGAPI png_get_image_width(png_structp png_ptr, png_infop info_ptr)
Definition: pngget.c:47
png_bytep up_row
Definition: png.h:1224
void PNGAPI png_write_chunk(png_structp png_ptr, png_bytep chunk_name, png_bytep data, png_size_t length)
Definition: pngwutil.c:80
png_infop png_charpp int png_charpp png_uint_32 * proflen
Definition: png.h:2382
void PNGAPI png_set_packing(png_structp png_ptr)
Definition: pngtrans.c:41
void PNGAPI png_set_add_alpha(png_structp png_ptr, png_uint_32 filler, int filler_loc)
Definition: pngtrans.c:132
png_byte filter_type
Definition: png.h:1408
PNG_CONST char png_libpng_ver[18]
Definition: png.c:23
void png_do_packswap(png_row_infop row_info, png_bytep row)
Definition: pngtrans.c:362
void PNGAPI png_set_IHDR(png_structp png_ptr, png_infop info_ptr, png_uint_32 width, png_uint_32 height, int bit_depth, int color_type, int interlace_type, int compression_type, int filter_type)
Definition: pngset.c:261
png_infop png_uint_32 * res_x
Definition: png.h:2344
void PNGAPI png_set_filter_heuristics(png_structp png_ptr, int heuristic_method, int num_weights, png_doublep filter_weights, png_doublep filter_costs)
Definition: pngwrite.c:1261
png_infop png_charp png_int_32 png_int_32 int int png_charp * units
Definition: png.h:2332
png_charp scal_s_width
Definition: png.h:956
png_unknown_chunk FAR * png_unknown_chunkp
Definition: png.h:703
png_uint_32 PNGAPI png_get_tRNS(png_structp png_ptr, png_infop info_ptr, png_bytep *trans, int *num_trans, png_color_16p *trans_values)
Definition: pngget.c:762
PNG_CONST int FARDATA png_pass_start[]
Definition: png.c:59
void png_write_start_row(png_structp png_ptr)
Definition: pngwutil.c:1760
png_error_ptr error_fn
Definition: png.h:1174
png_voidp png_error_ptr png_error_ptr png_voidp png_malloc_ptr malloc_fn
Definition: png.h:1530
int zlib_mem_level
Definition: png.h:1209
png_byte blue
Definition: png.h:589
void png_zfree(voidpf png_ptr, voidpf ptr)
Definition: png.c:192
void PNGAPI png_set_rgb_to_gray_fixed(png_structp png_ptr, int error_action, png_fixed_point red, png_fixed_point green)
Definition: pngrtran.c:644
struct png_time_struct png_time
png_color_16p int int double background_gamma
Definition: png.h:1703
png_user_transform_ptr write_user_transform_fn
Definition: png.h:1186
void PNGAPI png_set_bKGD(png_structp png_ptr, png_infop info_ptr, png_color_16p background)
Definition: pngset.c:22
void PNGAPI png_free_data(png_structp png_ptr, png_infop info_ptr, png_uint_32 mask, int num)
Definition: png.c:339
png_fixed_point int_y_blue
Definition: png.h:979
void PNGAPI png_write_image(png_structp png_ptr, png_bytepp image)
Definition: pngwrite.c:732
void PNGAPI png_set_cHRM_fixed(png_structp png_ptr, png_infop info_ptr, png_fixed_point white_x, png_fixed_point white_y, png_fixed_point red_x, png_fixed_point red_y, png_fixed_point green_x, png_fixed_point green_y, png_fixed_point blue_x, png_fixed_point blue_y)
Definition: pngset.c:92
png_voidp png_create_struct(int type)
Definition: pngmem.c:332
png_voidp error_ptr
Definition: png.h:1506
png_colorp int int png_uint_16p int full_dither
Definition: png.h:1720
png_bytep current_buffer_ptr
Definition: png.h:1313
void PNGAPI png_write_png(png_structp png_ptr, png_infop info_ptr, int transforms, voidp params)
Definition: pngwrite.c:1465
png_charp text
Definition: png.h:643
int process_mode
Definition: png.h:1321
png_color FAR *FAR * png_colorpp
Definition: png.h:572
Byte FAR * voidpf
Definition: zconf.h:283
png_bytep png_bytep new_row
Definition: png.h:2048
png_uint_32 irowbytes
Definition: png.h:1217
void png_push_have_row(png_structp png_ptr, png_bytep row)
Definition: pngpread.c:1555
void PNGAPI png_set_expand_gray_1_2_4_to_8(png_structp png_ptr)
Definition: pngrtran.c:584
void png_do_background(png_row_infop row_info, png_bytep row, png_color_16p trans_values, png_color_16p background, png_color_16p background_1, 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, png_uint_16pp gamma_16_to_1, int gamma_shift)
Definition: pngrtran.c:2705
png_infop png_uint_32 png_uint_32 int int int * interlace_method
Definition: png.h:2309
png_size_t save_buffer_size
Definition: png.h:1317
png_uint_32 PNGAPI png_get_hIST(png_structp png_ptr, png_infop info_ptr, png_uint_16p *hist)
Definition: pngget.c:524
void png_write_hIST(png_structp png_ptr, png_uint_16p hist, int num_hist)
Definition: pngwutil.c:1190
void PNGAPI png_set_hIST(png_structp png_ptr, png_infop info_ptr, png_uint_16p hist)
Definition: pngset.c:219
png_byte filter
Definition: png.h:1237
png_voidp png_malloc_ptr PNGARG((png_structp, png_size_t))
Definition: png.h:1159
void png_handle_IEND(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngrutil.c:597
png_uint_32 flush_dist
Definition: png.h:1270
void png_do_gamma(png_row_infop row_info, png_bytep row, png_bytep gamma_table, png_uint_16pp gamma_16_table, int gamma_shift)
Definition: pngrtran.c:3394
void PNGAPI png_set_flush(png_structp png_ptr, int nrows)
Definition: pngwrite.c:939
png_uint_32 PNGAPI png_get_oFFs(png_structp png_ptr, png_infop info_ptr, png_int_32 *offset_x, png_int_32 *offset_y, int *unit_type)
Definition: pngget.c:585
png_uint_32 PNGAPI png_get_cHRM(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)
Definition: pngget.c:378
struct png_sPLT_entry_struct png_sPLT_entry
png_uint_16 rgb_to_gray_blue_coeff
Definition: png.h:1386
png_bytep PNGAPI png_get_signature(png_structp png_ptr, png_infop info_ptr)
Definition: pngget.c:351
z_stream zstream
Definition: png.h:1203
png_uint_32 PNGAPI png_get_pHYs(png_structp png_ptr, png_infop info_ptr, png_uint_32 *res_x, png_uint_32 *res_y, int *unit_type)
Definition: pngget.c:663
png_infop png_charp png_int_32 png_int_32 int * type
Definition: png.h:2332
png_infop int transforms
Definition: png.h:2505
int zlib_strategy
Definition: png.h:1210
png_byte num_prev_filters
Definition: png.h:1352
void PNGAPI png_set_asm_flags(png_structp png_ptr, png_uint_32 asm_flags)
Definition: pngset.c:1253
png_bytep index_to_palette
Definition: png.h:1440
png_byte filter_type
Definition: png.h:760
void PNGAPI png_default_write_data(png_structp png_ptr, png_bytep data, png_size_t length)
Definition: pngwio.c:44
void PNGAPI png_process_data(png_structp png_ptr, png_infop info_ptr, png_bytep buffer, png_size_t buffer_size)
Definition: pngpread.c:27
void png_do_invert(png_row_infop row_info, png_bytep row)
Definition: pngtrans.c:176
png_infop png_uint_32 png_uint_32 * res_y
Definition: png.h:2344
png_voidp user_chunk_ptr
Definition: png.h:2022
png_uint_32 PNGAPI png_get_unknown_chunks(png_structp png_ptr, png_infop info_ptr, png_unknown_chunkpp unknowns)
Definition: pngget.c:801
png_voidp s1
Definition: png.h:2110
png_infop PNGAPI png_create_info_struct(png_structp png_ptr)
Definition: png.c:239
png_voidp int int user_transform_channels
Definition: png.h:2013
png_charp chunkdata
Definition: png.h:1464
void PNGAPI png_set_compression_level(png_structp png_ptr, int level)
Definition: pngwrite.c:1379
void png_do_expand(png_row_infop row_info, png_bytep row, png_color_16p trans_value)
Definition: pngrtran.c:3719
png_byte red
Definition: png.h:587
int compression
Definition: png.h:637
double scal_pixel_height
Definition: png.h:953
png_infop double double double double double double double double * blue_y
Definition: png.h:2252
png_byte pixel_depth
Definition: png.h:765
int int png_doublep filter_weights
Definition: png.h:1905
png_uint_32 user_height_max
Definition: png.h:1451
void PNGAPI png_set_strip_error_numbers(png_structp png_ptr, png_uint_32 strip_mode)
Definition: pngerror.c:336
void png_do_read_filler(png_row_infop row_info, png_bytep row, png_uint_32 filler, png_uint_32 flags)
Definition: pngrtran.c:1956
void PNGAPI png_set_read_status_fn(png_structp png_ptr, png_read_status_ptr read_row_fn)
Definition: pngread.c:1297
void PNGAPI png_set_mmx_thresholds(png_structp png_ptr, png_byte mmx_bitdepth_threshold, png_uint_32 mmx_rowbytes_threshold)
Definition: pngset.c:1263
png_uint_32 iwidth
Definition: png.h:1218
png_infop png_textp * text_ptr
Definition: png.h:2407
png_colorp int num_palette
Definition: png.h:1720
float y_white
Definition: png.h:885
png_byte color_type
Definition: png.h:757
png_charp current_text_ptr
Definition: png.h:1328
png_infop double double double double double double double * blue_x
Definition: png.h:2252
void PNGAPI png_save_int_32(png_bytep buf, png_int_32 i)
Definition: pngwutil.c:33
png_byte scal_unit
Definition: png.h:950
struct png_info_struct png_info
png_rw_ptr read_data_fn
Definition: png.h:1178
png_byte mmx_bitdepth_threshold
Definition: png.h:1420
png_uint_32 row_number
Definition: png.h:1219
int max_text
Definition: png.h:799
png_voidp error_ptr
Definition: png.h:1176
png_uint_32 rowbytes
Definition: png.h:752
png_uint_16pp gamma_16_to_1
Definition: png.h:1288
void png_push_read_sig(png_structp png_ptr, png_infop info_ptr)
Definition: pngpread.c:104
png_infopp info_ptr_ptr
Definition: png.h:1799
png_voidp png_rw_ptr write_data_fn
Definition: png.h:1974
png_sPLT_tp splt_palettes
Definition: png.h:938
png_fixed_point int_x_green
Definition: png.h:976
png_voidp user_transform_ptr
Definition: png.h:2013
png_voidp png_error_ptr png_error_ptr png_voidp png_malloc_ptr png_free_ptr free_fn
Definition: png.h:1530
void PNGAPI png_set_rows(png_structp png_ptr, png_infop info_ptr, png_bytepp row_pointers)
Definition: pngset.c:1211
void PNGAPI png_set_palette_to_rgb(png_structp png_ptr)
Definition: pngrtran.c:573
png_write_status_ptr write_row_fn
Definition: png.h:1306
png_user_transform_ptr write_user_transform_fn
Definition: png.h:2006
png_uint_32 PNGAPI png_get_valid(png_structp png_ptr, png_infop info_ptr, png_uint_32 flag)
Definition: pngget.c:16
png_user_chunk_ptr read_user_chunk_fn
Definition: png.h:1372
png_color_16 FAR * png_color_16p
Definition: png.h:582
png_color_8 FAR *FAR * png_color_8pp
Definition: png.h:594
void PNGAPI png_set_mem_fn(png_structp png_ptr, png_voidp mem_ptr, png_malloc_ptr malloc_fn, png_free_ptr free_fn)
Definition: pngmem.c:587
void png_push_have_end(png_structp png_ptr, png_infop info_ptr)
Definition: pngpread.c:1548
void PNGAPI png_chunk_warning(png_structp png_ptr, png_const_charp warning_message)
Definition: pngerror.c:194
png_infop int * unit
Definition: png.h:2451
png_voidp ptr
Definition: png.h:2063
void png_build_gamma_table(png_structp png_ptr)
Definition: pngrtran.c:4026
void PNGAPI png_set_invert_alpha(png_structp png_ptr)
Definition: pngtrans.c:157
png_voidp PNGAPI png_get_error_ptr(png_structp png_ptr)
Definition: pngerror.c:326
double scal_pixel_width
Definition: png.h:952
png_bytep prev_filters
Definition: png.h:1353
png_infop png_fixed_point png_fixed_point png_fixed_point * int_red_x
Definition: png.h:2258
png_byte user_transform_depth
Definition: png.h:1194
png_voidp progressive_ptr
Definition: png.h:2032
png_structp version_1_2_32
Definition: png.h:1472
void png_write_gAMA_fixed(png_structp png_ptr, png_fixed_point file_gamma)
Definition: pngwutil.c:711
void PNGAPI png_set_unknown_chunks(png_structp png_ptr, png_infop info_ptr, png_unknown_chunkp unknowns, int num_unknowns)
Definition: pngset.c:1048
png_infop png_fixed_point png_fixed_point png_fixed_point png_fixed_point png_fixed_point png_fixed_point png_fixed_point png_fixed_point * int_blue_y
Definition: png.h:2258
void PNGAPI png_write_rows(png_structp png_ptr, png_bytepp row, png_uint_32 num_rows)
Definition: pngwrite.c:710
png_const_charp error_message
Definition: png.h:2123
png_uint_16 rgb_to_gray_red_coeff
Definition: png.h:1384
png_byte FAR * png_bytep
Definition: pngconf.h:1197
int zlib_method
Definition: png.h:1207
png_infop png_color_16p * background
Definition: png.h:2241
png_uint_32 width
Definition: png.h:1212
char FAR * png_charp
Definition: pngconf.h:1203
png_uint_16 blue
Definition: png.h:579
void png_do_strip_filler(png_row_infop row_info, png_bytep row, png_uint_32 flags)
Definition: pngtrans.c:394
void png_do_pack(png_row_infop row_info, png_bytep row, png_uint_32 bit_depth)
Definition: pngwtran.c:87
void png_write_sig(png_structp png_ptr)
Definition: pngwutil.c:59
png_uint_32 size
Definition: png.h:1521
void png_handle_IHDR(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngrutil.c:388
png_colorp int int png_uint_16p histogram
Definition: png.h:1720
void PNGAPI png_set_sRGB_gAMA_and_cHRM(png_structp png_ptr, png_infop info_ptr, int intent)
Definition: pngset.c:612
void PNGAPI png_set_dither(png_structp png_ptr, png_colorp palette, int num_palette, int maximum_colors, png_uint_16p histogram, int full_dither)
Definition: pngrtran.c:141
PNG_CONST int FARDATA png_pass_yinc[]
Definition: png.c:68
png_uint_32 PNGAPI png_get_gAMA(png_structp png_ptr, png_infop info_ptr, double *file_gamma)
Definition: pngget.c:442
png_uint_16 gray
Definition: png.h:580
void png_handle_sPLT(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngrutil.c:1128
png_infop png_charp png_int_32 png_int_32 * X1
Definition: png.h:2332
png_bytep gamma_to_1
Definition: png.h:1285
png_voidp mem_ptr
Definition: png.h:1429
png_uint_16 num_trans
Definition: png.h:755
void PNGAPI png_set_background(png_structp png_ptr, png_color_16p background_color, int background_gamma_code, int need_expand, double background_gamma)
Definition: pngrtran.c:79
void PNGAPI png_read_rows(png_structp png_ptr, png_bytepp row, png_bytepp display_row, png_uint_32 num_rows)
Definition: pngread.c:818
png_infop png_charpp name
Definition: png.h:2382
png_uint_16p hist
Definition: png.h:1347
png_fixed_point int_x_red
Definition: png.h:974
png_fixed_point int_x_blue
Definition: png.h:978
png_size_t zbuf_size
Definition: png.h:1205
void png_do_read_invert_alpha(png_row_infop row_info, png_bytep row)
Definition: pngrtran.c:1857
float x_white
Definition: png.h:884
png_size_t png_size_t num_to_check
Definition: png.h:1496
void PNGAPI png_set_user_limits(png_structp png_ptr, png_uint_32 user_width_max, png_uint_32 user_height_max)
Definition: pngset.c:1279
png_uint_32 PNGAPI png_get_uint_32(png_bytep buf)
Definition: pngrutil.c:67
png_byte green
Definition: png.h:588
png_voidp int value
Definition: png.h:2113
png_size_t buffer_size
Definition: png.h:1319
int PNGAPI png_check_sig(png_bytep sig, int num)
Definition: png.c:135
void PNGAPI png_set_tIME(png_structp png_ptr, png_infop info_ptr, png_timep mod_time)
Definition: pngset.c:904
png_byte red
Definition: png.h:567
void PNGAPI png_progressive_combine_row(png_structp png_ptr, png_bytep old_row, png_bytep new_row)
Definition: pngpread.c:1563
png_uint_32 valid
Definition: png.h:751
png_charp PNGAPI png_get_libpng_ver(png_structp png_ptr)
Definition: png.c:712
png_voidp png_progressive_info_ptr png_progressive_row_ptr row_fn
Definition: png.h:2032
void PNGAPI png_set_sig_bytes(png_structp png_ptr, int num_bytes)
Definition: png.c:93
png_infop png_charp png_int_32 png_int_32 int int png_charp png_charpp * params
Definition: png.h:2332
png_byte compression_type
Definition: png.h:759
png_infop png_int_32 png_int_32 * offset_y
Definition: png.h:2320
png_progressive_info_ptr info_fn
Definition: png.h:1308
png_infop png_unknown_chunkp int num_unknowns
Definition: png.h:2485
png_byte heuristic_method
Definition: png.h:1351
png_byte background_gamma_type
Definition: png.h:1258
png_uint_16 frequency
Definition: png.h:606
long png_int_32
Definition: pngconf.h:1117
float x_red
Definition: png.h:886
void png_do_read_transformations(png_structp png_ptr)
Definition: pngrtran.c:1269
png_infop png_int_32 * offset_x
Definition: png.h:2320
png_color_16 background
Definition: png.h:842
void png_write_sBIT(png_structp png_ptr, png_color_8p sbit, int color_type)
Definition: pngwutil.c:907
int PNGAPI png_handle_as_unknown(png_structp png_ptr, png_bytep chunk_name)
Definition: png.c:742
void png_do_write_transformations(png_structp png_ptr)
Definition: pngwtran.c:19
png_color_16p int int need_expand
Definition: png.h:1703
PNG_CONST char FAR * png_const_charp
Definition: pngconf.h:1202
png_bytep dither_index
Definition: png.h:1343
float PNGAPI png_get_pixel_aspect_ratio(png_structp png_ptr, png_infop info_ptr)
Definition: pngget.c:173
png_size_t current_text_size
Definition: png.h:1325
png_bytep trans
Definition: png.h:1301
void PNGAPI png_set_compression_strategy(png_structp png_ptr, int strategy)
Definition: pngwrite.c:1399
double double default_file_gamma
Definition: png.h:1728
png_uint_16 PNGAPI png_get_uint_16(png_bytep buf)
Definition: pngrutil.c:93
png_uint_32 rowbytes
Definition: png.h:1216
void png_write_oFFs(png_structp png_ptr, png_int_32 x_offset, png_int_32 y_offset, int unit_type)
Definition: pngwutil.c:1547
png_uint_32 crc
Definition: png.h:1231
void PNGAPI png_set_strip_16(png_structp png_ptr)
Definition: pngrtran.c:103
void png_crc_read(png_structp png_ptr, png_bytep buf, png_size_t length)
Definition: pngrutil.c:133
PNG_CONST int FARDATA png_pass_ystart[]
Definition: png.c:65
png_infopp png_infopp end_info_ptr_ptr
Definition: png.h:1803
void png_write_IDAT(png_structp png_ptr, png_bytep data, png_size_t length)
Definition: pngwutil.c:627
png_unknown_chunk unknown_chunk
Definition: png.h:1457
png_uint_32 splt_palettes_num
Definition: png.h:939
png_int_32 pcal_X0
Definition: png.h:908
png_infop int * intent
Definition: png.h:2370
png_uint_32 push_length
Definition: png.h:1315
png_voidp png_progressive_info_ptr info_fn
Definition: png.h:2032
void PNGAPI png_set_write_fn(png_structp png_ptr, png_voidp io_ptr, png_rw_ptr write_data_fn, png_flush_ptr output_flush_fn)
Definition: pngwio.c:170
void png_do_chop(png_row_infop row_info, png_bytep row)
Definition: pngrtran.c:1711
void png_write_data(png_structp png_ptr, png_bytep data, png_size_t length)
Definition: pngwio.c:29
void png_read_destroy(png_structp png_ptr, png_infop info_ptr, png_infop end_info_ptr)
Definition: pngread.c:1152
void png_handle_sCAL(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngrutil.c:1731
png_voidp png_error_ptr png_error_ptr warning_fn
Definition: png.h:1963
void PNGAPI png_set_sCAL(png_structp png_ptr, png_infop info_ptr, int unit, double width, double height)
Definition: pngset.c:459
float x_blue
Definition: png.h:890
png_bytep png_bytep png_size_t length
Definition: png.h:1541
png_fixed_point int_y_white
Definition: png.h:973
png_uint_32 i
Definition: png.h:2735
png_row_info FAR *FAR * png_row_infopp
Definition: png.h:1099
void PNGAPI png_set_unknown_chunk_location(png_structp png_ptr, png_infop info_ptr, int chunk, int location)
Definition: pngset.c:1109
void png_write_iCCP(png_structp png_ptr, png_charp name, int compression_type, png_charp profile, int profile_len)
Definition: pngwutil.c:748
png_voidp int user_transform_depth
Definition: png.h:2013
png_infop double double double double * red_y
Definition: png.h:2252
png_uint_32 free_me
Definition: png.h:1367
int num_bytes
Definition: png.h:1489
int png_do_rgb_to_gray(png_structp png_ptr, png_row_infop row_info, png_bytep row)
Definition: pngrtran.c:2235
png_malloc_ptr malloc_fn
Definition: png.h:1430
png_struct FAR *FAR * png_structpp
Definition: png.h:1474
png_bytep chunk_list
Definition: png.h:1377
png_uint_16 blue
Definition: png.h:604
void PNGAPI png_set_gAMA(png_structp png_ptr, png_infop info_ptr, double file_gamma)
Definition: pngset.c:156
png_uint_32 PNGAPI png_permit_mng_features(png_structp png_ptr, png_uint_32 mng_features)
Definition: pngset.c:1138
void PNGAPI png_info_init_3(png_infopp ptr_ptr, png_size_t png_info_struct_size)
Definition: png.c:301
void PNGAPI png_set_oFFs(png_structp png_ptr, png_infop info_ptr, png_int_32 offset_x, png_int_32 offset_y, int unit_type)
Definition: pngset.c:370
png_text FAR * png_textp
Definition: png.h:654
png_voidp PNGAPI png_get_progressive_ptr(png_structp png_ptr)
Definition: pngpread.c:1589
png_byte do_filter
Definition: png.h:1240
png_infop png_bytep * trans
Definition: png.h:2435
void PNGAPI png_set_sBIT(png_structp png_ptr, png_infop info_ptr, png_color_8p sig_bit)
Definition: pngset.c:587
png_infop png_fixed_point png_fixed_point png_fixed_point png_fixed_point png_fixed_point * int_green_x
Definition: png.h:2258
int empty_plte_permitted
Definition: png.h:1738
png_bytepp image
Definition: png.h:1772
png_uint_32 strip_mode
Definition: png.h:2652
png_unknown_chunk FAR *FAR * png_unknown_chunkpp
Definition: png.h:704
png_uint_32 user_width_max
Definition: png.h:1450
void PNGAPI png_destroy_info_struct(png_structp png_ptr, png_infopp info_ptr_ptr)
Definition: png.c:263
png_byte hour
Definition: png.h:679
float screen_gamma
Definition: png.h:1278
void png_read_finish_row(png_structp png_ptr)
Definition: pngrutil.c:2899
png_uint_32 int flags
Definition: png.h:1656
voidpf png_zalloc(voidpf png_ptr, uInt items, uInt size)
Definition: png.c:149
png_byte interlace_type
Definition: png.h:761
void png_push_read_chunk(png_structp png_ptr, png_infop info_ptr)
Definition: pngpread.c:136
png_uint_32 iccp_proflen
Definition: png.h:932
png_user_transform_ptr read_user_transform_fn
Definition: png.h:1182
void PNGAPI png_set_sPLT(png_structp png_ptr, png_infop info_ptr, png_sPLT_tp entries, int nentries)
Definition: pngset.c:976
png_bytep chunk_name
Definition: png.h:1541
png_byte color_type
Definition: png.h:1241
png_infop png_charp png_int_32 * X0
Definition: png.h:2332
png_uint_32 skip_length
Definition: png.h:1316
void PNGAPI png_set_user_transform_info(png_structp png_ptr, png_voidp user_transform_ptr, int user_transform_depth, int user_transform_channels)
Definition: pngtrans.c:630
void png_flush(png_structp png_ptr)
Definition: pngwio.c:124
int int png_doublep png_doublep filter_costs
Definition: png.h:1905
png_uint_32 free_me
Definition: png.h:918
png_charp iccp_name
Definition: png.h:929
png_infop png_uint_32 * width
Definition: png.h:2309
void PNGAPI png_set_gray_1_2_4_to_8(png_structp png_ptr)
Definition: pngrtran.c:597
png_write_status_ptr write_row_fn
Definition: png.h:1987
png_byte spare_byte
Definition: png.h:766
png_uint_32 PNGAPI png_get_mmx_flagmask(int flag_select, int *compilerID)
Definition: pngget.c:859
png_color_8 sig_bit
Definition: png.h:1292
void png_write_tEXt(png_structp png_ptr, png_charp key, png_charp text, png_size_t text_len)
Definition: pngwutil.c:1352
png_uint_32 PNGAPI png_get_gAMA_fixed(png_structp png_ptr, png_infop info_ptr, png_fixed_point *int_file_gamma)
Definition: pngget.c:456
void png_write_pHYs(png_structp png_ptr, png_uint_32 x_pixels_per_unit, png_uint_32 y_pixels_per_unit, int unit_type)
Definition: pngwutil.c:1705
void png_calculate_crc(png_structp png_ptr, png_bytep ptr, png_size_t length)
Definition: png.c:212
void png_handle_zTXt(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngrutil.c:1996
png_uint_32 PNGAPI png_get_text(png_structp png_ptr, png_infop info_ptr, png_textp *text_ptr, int *num_text)
Definition: pngget.c:725
void PNGAPI png_default_flush(png_structp png_ptr)
Definition: pngwio.c:132
#define png_info_init(info_ptr)
Definition: png.h:1562
png_uint_32 PNGAPI png_get_sCAL(png_structp png_ptr, png_infop info_ptr, int *unit, double *width, double *height)
Definition: pngget.c:628
png_infop png_bytep int png_color_16p * trans_values
Definition: png.h:2435
void png_do_gray_to_rgb(png_row_infop row_info, png_bytep row)
Definition: pngrtran.c:2132
float x_green
Definition: png.h:888
void PNGAPI png_read_row(png_structp png_ptr, png_bytep row, png_bytep dsp_row)
Definition: pngread.c:564
png_uint_32 width
Definition: png.h:1090
png_color_16 background_1
Definition: png.h:1264
void PNGAPI png_set_bgr(png_structp png_ptr)
Definition: pngtrans.c:18
void png_init_read_transformations(png_structp png_ptr)
Definition: pngrtran.c:718
png_byte PNGAPI png_get_mmx_bitdepth_threshold(png_structp png_ptr)
Definition: pngget.c:869
png_FILE_p fp
Definition: png.h:1951
png_byte FAR *FAR * png_bytepp
Definition: pngconf.h:1219
png_infop png_charpp int * compression_type
Definition: png.h:2382
png_uint_32 PNGAPI png_get_user_height_max(png_structp png_ptr)
Definition: pngget.c:893
png_charp key
Definition: png.h:642
void PNGAPI png_set_write_user_transform_fn(png_structp png_ptr, png_user_transform_ptr write_user_transform_fn)
Definition: pngwrite.c:1451
png_infop png_fixed_point * int_white_x
Definition: png.h:2258
void png_handle_cHRM(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngrutil.c:766
png_infop png_uint_16p * hist
Definition: png.h:2300
struct png_color_8_struct png_color_8
png_fixed_point int_gamma
Definition: png.h:968
png_charp pcal_purpose
Definition: png.h:907
png_uint_32 PNGAPI png_get_compression_buffer_size(png_structp png_ptr)
Definition: pngget.c:831
png_free_ptr free_fn
Definition: png.h:1431
png_uint_32 flush_rows
Definition: png.h:1271
png_byte usr_channels
Definition: png.h:1246
png_bytepp png_bytepp display_row
Definition: png.h:1759
void png_handle_hIST(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngrutil.c:1456
void png_do_dither(png_row_infop row_info, png_bytep row, png_bytep palette_lookup, png_bytep dither_lookup)
Definition: pngrtran.c:3926
png_byte second
Definition: png.h:681
png_byte pcal_nparams
Definition: png.h:913
void png_push_handle_zTXt(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngpread.c:1152
png_byte compression_type
Definition: png.h:1447
void png_push_save_buffer(png_structp png_ptr)
Definition: pngpread.c:603
void png_write_sPLT(png_structp png_ptr, png_sPLT_tp spalette)
Definition: pngwutil.c:823
png_infop png_bytepp row_pointers
Definition: png.h:2173
png_byte color_type
Definition: png.h:1092
int cur_palette
Definition: png.h:1322
png_uint_16 rgb_to_gray_green_coeff
Definition: png.h:1385
png_uint_16p inv_filter_costs
Definition: png.h:1357
png_uint_32 PNGAPI png_get_sBIT(png_structp png_ptr, png_infop info_ptr, png_color_8p *sig_bit)
Definition: pngget.c:710
png_uint_16 green
Definition: png.h:578
png_bytep prev_row
Definition: png.h:1220
png_voidp user_transform_ptr
Definition: png.h:1193
void PNGAPI png_build_grayscale_palette(int bit_depth, png_colorp palette)
Definition: pngrtran.c:2474
png_byte depth
Definition: png.h:619
png_bytep big_row_buf
Definition: png.h:1435
void png_read_transform_info(png_structp png_ptr, png_infop info_ptr)
Definition: pngrtran.c:1125
png_byte PNGAPI png_get_interlace_type(png_structp png_ptr, png_infop info_ptr)
Definition: pngget.c:97
png_byte channels
Definition: png.h:1094
#define PNGAPI
Definition: pngconf.h:1386
png_color_16 trans_values
Definition: png.h:1302
png_struct FAR * png_structp
Definition: png.h:1108
void png_read_start_row(png_structp png_ptr)
Definition: pngrutil.c:3031
void PNGAPI png_write_info(png_structp png_ptr, png_infop info_ptr)
Definition: pngwrite.c:127
void PNGAPI png_read_end(png_structp png_ptr, png_infop info_ptr)
Definition: pngread.c:908
png_colorp palette
Definition: png.h:1232
png_voidp PNGAPI png_get_user_transform_ptr(png_structp png_ptr)
Definition: pngtrans.c:653
png_uint_32 usr_width
Definition: png.h:1215
void PNGAPI png_set_filler(png_structp png_ptr, png_uint_32 filler, int filler_loc)
Definition: pngtrans.c:99
png_charp current_text
Definition: png.h:1327
void png_write_cHRM_fixed(png_structp png_ptr, png_fixed_point white_x, png_fixed_point white_y, png_fixed_point red_x, png_fixed_point red_y, png_fixed_point green_x, png_fixed_point green_y, png_fixed_point blue_x, png_fixed_point blue_y)
Definition: pngwutil.c:1025
png_time mod_time
Definition: png.h:807
png_read_status_ptr read_row_fn
Definition: png.h:1984
void png_info_destroy(png_structp png_ptr, png_infop info_ptr)
Definition: png.c:594
png_byte compression
Definition: png.h:1236
png_uint_32 PNGAPI png_get_PLTE(png_structp png_ptr, png_infop info_ptr, png_colorp *palette, int *num_palette)
Definition: pngget.c:693
void PNGAPI png_error(png_structp png_ptr, png_const_charp error_message)
Definition: pngerror.c:36
png_time FAR * png_timep
Definition: png.h:683
PNG_EXPORT(png_uint_32, png_access_version_number) PNGARG((void))
void PNGAPI png_set_packswap(png_structp png_ptr)
Definition: pngtrans.c:56
png_color_16 trans_values
Definition: png.h:832
#define PNG_CONST
Definition: pngconf.h:445
void png_handle_tEXt(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngrutil.c:1917
struct png_text_struct png_text
png_uint_32 PNGAPI png_get_cHRM_fixed(png_structp png_ptr, png_infop info_ptr, png_fixed_point *white_x, png_fixed_point *white_y, png_fixed_point *red_x, png_fixed_point *red_y, png_fixed_point *green_x, png_fixed_point *green_y, png_fixed_point *blue_x, png_fixed_point *blue_y)
Definition: pngget.c:408
void png_destroy_struct(png_voidp struct_ptr)
Definition: pngmem.c:386
png_infop png_uint_32 png_uint_32 * height
Definition: png.h:2309
void png_do_read_swap_alpha(png_row_infop row_info, png_bytep row)
Definition: pngrtran.c:1765
png_infop png_uint_32 png_uint_32 int int int int int * filter_method
Definition: png.h:2309
png_uint_32 PNGAPI png_get_pixels_per_meter(png_structp png_ptr, png_infop info_ptr)
Definition: pngget.c:153
png_infop png_uint_32 free_me
Definition: png.h:2076
png_uint_32 PNGAPI png_get_IHDR(png_structp png_ptr, png_infop info_ptr, png_uint_32 *width, png_uint_32 *height, int *bit_depth, int *color_type, int *interlace_type, int *compression_type, int *filter_type)
Definition: pngget.c:538
void PNGAPI png_set_swap(png_structp png_ptr)
Definition: pngtrans.c:29
void PNGAPI png_write_flush(png_structp png_ptr)
Definition: pngwrite.c:949
int method
Definition: png.h:1847
png_color_16 background
Definition: png.h:1262
void png_write_find_filter(png_structp png_ptr, png_row_infop row_info)
Definition: pngwutil.c:2150
png_rw_ptr write_data_fn
Definition: png.h:1177
png_byte minute
Definition: png.h:680
void png_push_crc_finish(png_structp png_ptr)
Definition: pngpread.c:516
png_voidp png_error_ptr error_fn
Definition: png.h:1506
png_byte png_uint_32 mmx_rowbytes_threshold
Definition: png.h:2638
int strategy
Definition: png.h:1932
png_int_32 PNGAPI png_get_int_32(png_bytep buf)
Definition: pngrutil.c:81
png_voidp png_rw_ptr png_flush_ptr output_flush_fn
Definition: png.h:1974
png_timep ptime
Definition: png.h:1583
int int filters
Definition: png.h:1847
png_byte channels
Definition: png.h:764
png_byte PNGAPI png_get_rgb_to_gray_status(png_structp png_ptr)
Definition: pngget.c:815
unsigned char png_byte
Definition: pngconf.h:1120
unsigned short png_uint_16
Definition: pngconf.h:1118
void PNGAPI png_set_cHRM(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)
Definition: pngset.c:36
png_infop int png_uint_32 mask
Definition: png.h:2081
void png_handle_pCAL(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngrutil.c:1597
png_charpp pcal_params
Definition: png.h:911
void png_do_read_interlace(png_structp png_ptr)
Definition: pngrutil.c:2554
png_uint_16pp gamma_16_table
Definition: png.h:1286
void PNGAPI png_set_pCAL(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)
Definition: pngset.c:386
void PNGAPI png_set_compression_mem_level(png_structp png_ptr, int mem_level)
Definition: pngwrite.c:1389
struct png_sPLT_struct png_sPLT_t
png_fixed_point int_x_white
Definition: png.h:972
void png_write_IHDR(png_structp png_ptr, png_uint_32 width, png_uint_32 height, int bit_depth, int color_type, int compression_type, int filter_type, int interlace_type)
Definition: pngwutil.c:384
png_uint_32 flags
Definition: png.h:1200
void png_write_tRNS(png_structp png_ptr, png_bytep trans, png_color_16p tran, int num_trans, int color_type)
Definition: pngwutil.c:1081
png_byte mmx_bitdepth_threshold
Definition: png.h:2638
png_infop png_bytep int * num_trans
Definition: png.h:2435
png_bytep row_buf
Definition: png.h:1221
png_charp pcal_units
Definition: png.h:910
void png_write_filtered_row(png_structp png_ptr, png_bytep filtered_row)
Definition: pngwutil.c:2769
void PNGAPI png_write_init_2(png_structp png_ptr, png_const_charp user_png_ver, png_size_t png_struct_size, png_size_t png_info_size)
Definition: pngwrite.c:586
png_sPLT_entry FAR * png_sPLT_entryp
Definition: png.h:608
void PNGAPI png_warning(png_structp png_ptr, png_const_charp warning_message)
Definition: pngerror.c:102
int * compilerID
Definition: png.h:2614
png_infop png_fixed_point * int_file_gamma
Definition: png.h:2286
void png_combine_row(png_structp png_ptr, png_bytep row, int mask)
Definition: pngrutil.c:2348
#define PNG_CHUNK_NAME_LENGTH
Definition: png.h:692
typedef void(PNGAPI *png_error_ptr) PNGARG((png_structp
png_voidp PNGAPI png_get_io_ptr(png_structp png_ptr)
Definition: png.c:618
PNG_CONST int FARDATA png_pass_dsp_mask[]
Definition: png.c:80
png_uint_16 num_palette
Definition: png.h:1233
void PNGAPI png_set_write_status_fn(png_structp png_ptr, png_write_status_ptr write_row_fn)
Definition: pngwrite.c:1442
png_uint_32 PNGAPI png_get_user_width_max(png_structp png_ptr)
Definition: pngget.c:888
struct png_color_16_struct png_color_16
#define FAR
Definition: jmorecfg.h:215
png_byte iccp_compression
Definition: png.h:933
png_bytep palette_to_index
Definition: png.h:1442
void png_write_pCAL(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)
Definition: pngwutil.c:1569
void png_do_bgr(png_row_infop row_info, png_bytep row)
Definition: pngtrans.c:552
png_size_t current_buffer_size
Definition: png.h:1320
void png_write_gAMA(png_structp png_ptr, double file_gamma)
Definition: pngwutil.c:694
png_uint_32 PNGAPI png_get_mmx_rowbytes_threshold(png_structp png_ptr)
Definition: pngget.c:877
png_uint_16 FAR * png_uint_16p
Definition: pngconf.h:1200
void PNGAPI png_convert_from_struct_tm(png_timep ptime, struct tm FAR *ttime)
Definition: pngwrite.c:414
png_structp PNGAPI png_create_write_struct_2(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)
Definition: pngwrite.c:449
png_byte phys_unit_type
Definition: png.h:863
png_colorp palette
Definition: png.h:1637
void PNGAPI png_write_end(png_structp png_ptr, png_infop info_ptr)
Definition: pngwrite.c:297
png_fixed_point int_y_red
Definition: png.h:975
png_bytepp row
Definition: png.h:1759
png_colorp palette
Definition: png.h:753
int nrows
Definition: png.h:1744
png_byte pixel_depth
Definition: png.h:1095
void PNGAPI png_set_PLTE(png_structp png_ptr, png_infop info_ptr, png_colorp palette, int num_palette)
Definition: pngset.c:537
png_charp iccp_profile
Definition: png.h:930
png_uint_32 png_uint_32 user_height_max
Definition: png.h:2660
void png_push_handle_tEXt(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngpread.c:1056
png_read_status_ptr read_row_fn
Definition: png.h:1305
void png_push_crc_skip(png_structp png_ptr, png_uint_32 skip)
Definition: pngpread.c:509
png_size_t save_buffer_max
Definition: png.h:1318
void PNGAPI png_set_gamma(png_structp png_ptr, double scrn_gamma, double file_gamma)
Definition: pngrtran.c:527
void png_process_IDAT_data(png_structp png_ptr, png_bytep buffer, png_size_t buffer_length)
Definition: pngpread.c:753
png_int_32 nentries
Definition: png.h:621
void png_read_push_finish_row(png_structp png_ptr)
Definition: pngpread.c:989
png_voidp png_progressive_info_ptr png_progressive_row_ptr png_progressive_end_ptr end_fn
Definition: png.h:2032
png_byte user_transform_channels
Definition: png.h:1195
void png_handle_unknown(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngrutil.c:2229
int PNGAPI png_sig_cmp(png_bytep sig, png_size_t start, png_size_t num_to_check)
Definition: png.c:112
png_infop png_fixed_point png_fixed_point * int_white_y
Definition: png.h:2258
png_byte srgb_intent
Definition: png.h:786
png_bytep save_buffer_ptr
Definition: png.h:1311
png_uint_16p filter_weights
Definition: png.h:1354
void PNGAPI png_set_strip_alpha(png_structp png_ptr)
Definition: pngrtran.c:113
png_bytep current_buffer
Definition: png.h:1314
png_bytep buf
Definition: png.h:2729
void PNGAPI png_set_compression_window_bits(png_structp png_ptr, int window_bits)
Definition: pngwrite.c:1409
png_byte location
Definition: png.h:700
int png_crc_finish(png_structp png_ptr, png_uint_32 skip)
Definition: pngrutil.c:145
void PNGAPI png_read_info(png_structp png_ptr, png_infop info_ptr)
Definition: pngread.c:327
png_infop int int location
Definition: png.h:2487
void PNGAPI png_chunk_error(png_structp png_ptr, png_const_charp error_message)
Definition: pngerror.c:178
void PNGAPI png_set_read_fn(png_structp png_ptr, png_voidp io_ptr, png_rw_ptr read_data_fn)
Definition: pngrio.c:137
png_uint_16 num_palette
Definition: png.h:754
png_size_t start
Definition: png.h:1496
png_int_32 x_offset
Definition: png.h:851
png_byte rgb_to_gray_status
Definition: png.h:1382
png_bytep dither_sort
Definition: png.h:1439
void PNGAPI png_save_uint_32(png_bytep buf, png_uint_32 i)
Definition: pngwutil.c:20
void PNGAPI png_set_invert_mono(png_structp png_ptr)
Definition: pngtrans.c:167
png_byte bit_depth
Definition: png.h:756
png_bytep save_buffer
Definition: png.h:1312
png_uint_16 red
Definition: png.h:602
png_sPLT_entry FAR *FAR * png_sPLT_entrypp
Definition: png.h:609
png_uint_32 mmx_rowbytes_threshold
Definition: png.h:1421
void png_do_expand_palette(png_row_infop row_info, png_bytep row, png_colorp palette, png_bytep trans, int num_trans)
Definition: pngrtran.c:3576
void PNGAPI png_start_read_image(png_structp png_ptr)
Definition: pngread.c:553
png_bytep zbuf
Definition: png.h:1204
png_byte pixel_depth
Definition: png.h:1244
png_infop png_uint_32 png_uint_32 int * bit_depth
Definition: png.h:2309
png_voidp io_ptr
Definition: png.h:1179
int zlib_level
Definition: png.h:1206
png_uint_32 old_prev_row_size
Definition: png.h:1461
png_voidp PNGAPI png_malloc_default(png_structp png_ptr, png_uint_32 size)
Definition: pngmem.c:447
png_infop png_fixed_point png_fixed_point png_fixed_point png_fixed_point * int_red_y
Definition: png.h:2258
png_infop double * file_gamma
Definition: png.h:2283
png_uint_32 PNGAPI png_get_y_pixels_per_meter(png_structp png_ptr, png_infop info_ptr)
Definition: pngget.c:135
png_uint_32 PNGAPI png_get_iCCP(png_structp png_ptr, png_infop info_ptr, png_charpp name, int *compression_type, png_charpp profile, png_uint_32 *proflen)
Definition: pngget.c:488
png_charp PNGAPI png_get_header_ver(png_structp png_ptr)
Definition: png.c:720
png_voidp user_chunk_ptr
Definition: png.h:1371
void PNGAPI png_read_init(png_structp png_ptr)
Definition: pngread.c:184
png_bytep gamma_table
Definition: png.h:1283
int png_set_text_2(png_structp png_ptr, png_infop info_ptr, png_textp text_ptr, int num_text)
Definition: pngset.c:741
png_voidp io_ptr
Definition: png.h:1974
png_uint_16 filler
Definition: png.h:1253
png_bytepp row_pointers
Definition: png.h:964
png_uint_16p hist
Definition: png.h:873
png_uint_32 PNGAPI png_get_x_pixels_per_meter(png_structp png_ptr, png_infop info_ptr)
Definition: pngget.c:117
void png_do_shift(png_row_infop row_info, png_bytep row, png_color_8p bit_depth)
Definition: pngwtran.c:213
png_voidp png_voidp s2
Definition: png.h:2110
int png_bytep chunk_list
Definition: png.h:2483
void PNGAPI png_set_compression_buffer_size(png_structp png_ptr, png_uint_32 size)
Definition: pngset.c:1228
#define FARDATA
Definition: pngconf.h:1188
png_uint_32 PNGAPI png_get_uint_31(png_structp png_ptr, png_bytep buf)
Definition: pngrutil.c:49
png_bytepp png_bytepp png_uint_32 num_rows
Definition: png.h:1759
png_uint_32 PNGAPI png_get_pCAL(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)
Definition: pngget.c:603
png_infop png_textp int * num_text
Definition: png.h:2407
png_voidp PNGAPI png_get_mem_ptr(png_structp png_ptr)
Definition: pngmem.c:603
void PNGAPI png_write_chunk_end(png_structp png_ptr)
Definition: pngwutil.c:136
png_bytep old_row
Definition: png.h:2048
void png_handle_tRNS(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngrutil.c:1272
png_bytep paeth_row
Definition: png.h:1226
png_infop png_sPLT_tpp entries
Definition: png.h:2396
void png_push_restore_buffer(png_structp png_ptr, png_bytep buffer, png_size_t buffer_length)
Definition: pngpread.c:652
void png_do_unpack(png_row_infop row_info, png_bytep row)
Definition: pngrtran.c:1515
void png_handle_sRGB(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngrutil.c:911
png_byte PNGAPI png_get_bit_depth(png_structp png_ptr, png_infop info_ptr)
Definition: pngget.c:67
void png_read_data(png_structp png_ptr, png_bytep data, png_size_t length)
Definition: pngrio.c:28
png_byte bit_depth
Definition: png.h:1242
png_byte sig_bytes
Definition: png.h:1247
png_byte index
Definition: png.h:576
void png_write_destroy(png_structp png_ptr)
Definition: pngwrite.c:1075
void png_write_tIME(png_structp png_ptr, png_timep mod_time)
Definition: pngwutil.c:1731
png_byte channels
Definition: png.h:1245
float gamma
Definition: png.h:780
float background_gamma
Definition: png.h:1260
png_uint_16 FAR *FAR * png_uint_16pp
Definition: pngconf.h:1222
typedef int
Definition: png.h:1113
PNG_CONST int FARDATA png_pass_inc[]
Definition: png.c:62
png_structp PNGAPI png_create_read_struct_2(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)
Definition: pngread.c:31
PNG_CONST png_byte FARDATA png_sig[8]
Definition: png.c:29
png_color_16 FAR *FAR * png_color_16pp
Definition: png.h:583
png_byte pcal_type
Definition: png.h:912
png_bytep png_bytep data
Definition: png.h:1541
png_color_8p true_bits
Definition: png.h:1685
png_charp scal_s_height
Definition: png.h:957
png_voidp png_create_struct_2(int type, png_malloc_ptr malloc_fn, png_voidp mem_ptr)
Definition: pngmem.c:342
png_bytep gamma_from_1
Definition: png.h:1284
int png_bytep int num_chunks
Definition: png.h:2483
PNG_CONST int FARDATA png_pass_mask[]
Definition: png.c:76
png_uint_32 PNGAPI png_get_asm_flags(png_structp png_ptr)
Definition: pngget.c:841
void png_read_filter_row(png_structp png_ptr, png_row_infop row_info, png_bytep row, png_bytep prev_row, int filter)
Definition: pngrutil.c:2776
png_progressive_row_ptr row_fn
Definition: png.h:1309
png_byte day
Definition: png.h:678
png_structp PNGAPI png_create_read_struct(png_const_charp user_png_ver, png_voidp error_ptr, png_error_ptr error_fn, png_error_ptr warn_fn)
Definition: pngread.c:20
void PNGAPI png_data_freer(png_structp png_ptr, png_infop info_ptr, int freer, png_uint_32 mask)
Definition: png.c:322
png_infop png_charp * purpose
Definition: png.h:2332
void PNGAPI png_free_default(png_structp png_ptr, png_voidp ptr)
Definition: pngmem.c:512
void png_write_PLTE(png_structp png_ptr, png_colorp palette, png_uint_32 num_pal)
Definition: pngwutil.c:563
png_voidp png_user_chunk_ptr read_user_chunk_fn
Definition: png.h:2022
png_uint_32 num_rows
Definition: png.h:1214
png_byte offset_unit_type
Definition: png.h:853
int crit_action
Definition: png.h:1818
png_uint_32 asm_flags
Definition: png.h:2634
void png_write_sRGB(png_structp png_ptr, int srgb_intent)
Definition: pngwutil.c:729
void png_do_swap(png_row_infop row_info, png_bytep row)
Definition: pngtrans.c:231
png_charp PNGAPI png_convert_to_rfc1123(png_structp png_ptr, png_timep ptime)
Definition: png.c:646
void PNGAPI png_write_info_before_PLTE(png_structp png_ptr, png_infop info_ptr)
Definition: pngwrite.c:26
png_int_32 PNGAPI png_get_x_offset_pixels(png_structp png_ptr, png_infop info_ptr)
Definition: pngget.c:230
png_infop png_uint_32 png_uint_32 int int * color_type
Definition: png.h:2309
png_voidp png_error_ptr png_error_ptr warn_fn
Definition: png.h:1506
png_voidp png_rw_ptr read_data_fn
Definition: png.h:1978
png_voidp PNGAPI png_memcpy_check(png_structp png_ptr, png_voidp s1, png_voidp s2, png_uint_32 length)
Definition: pngmem.c:556
void PNGAPI png_convert_from_time_t(png_timep ptime, time_t ttime)
Definition: pngwrite.c:426
png_infop double double double double double double * green_y
Definition: png.h:2252
png_uint_16p filter_costs
Definition: png.h:1356
png_sPLT_t FAR * png_sPLT_tp
Definition: png.h:623
png_infop double double * white_y
Definition: png.h:2252
png_const_charp warning_message
Definition: png.h:2136
png_error_ptr warning_fn
Definition: png.h:1175
struct tm FAR * ttime
Definition: png.h:1591
png_int_32 PNGAPI png_get_y_offset_pixels(png_structp png_ptr, png_infop info_ptr)
Definition: pngget.c:248
void PNGAPI png_write_chunk_data(png_structp png_ptr, png_bytep data, png_size_t length)
Definition: pngwutil.c:120
png_size_t png_info_struct_size
Definition: png.h:1567
png_infop png_bytep png_size_t buffer_size
Definition: png.h:2042
png_uint_32 mode
Definition: png.h:1199
png_byte PNGAPI png_get_compression_type(png_structp png_ptr, png_infop info_ptr)
Definition: pngget.c:107
void PNGAPI png_set_expand(png_structp png_ptr)
Definition: pngrtran.c:546
struct png_unknown_chunk_t png_unknown_chunk
png_uint_32 PNGAPI png_get_bKGD(png_structp png_ptr, png_infop info_ptr, png_color_16p *background)
Definition: pngget.c:361
png_infop png_charp png_int_32 png_int_32 int int * nparams
Definition: png.h:2332
float y_green
Definition: png.h:889
void PNGAPI png_destroy_write_struct(png_structpp png_ptr_ptr, png_infopp info_ptr_ptr)
Definition: pngwrite.c:1004
png_infop png_bytep buffer
Definition: png.h:2042
int level
Definition: png.h:1926
png_color_8 FAR * png_color_8p
Definition: png.h:593
png_uint_32 rowbytes
Definition: png.h:1091
int int ancil_action
Definition: png.h:1818
png_uint_32 PNGAPI png_get_asm_flagmask(int flag_select)
Definition: pngget.c:849
void png_handle_tIME(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngrutil.c:1873
int PNGAPI png_set_interlace_handling(png_structp png_ptr)
Definition: pngtrans.c:79
void png_handle_oFFs(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngrutil.c:1553
double screen_gamma
Definition: png.h:1728
png_text FAR *FAR * png_textpp
Definition: png.h:655
void PNGAPI png_set_crc_action(png_structp png_ptr, int crit_action, int ancil_action)
Definition: pngrtran.c:22
png_uint_16 alpha
Definition: png.h:605
png_uint_16 num_trans
Definition: png.h:1234
png_uint_32 width
Definition: png.h:749
png_infop png_sPLT_tp int nentries
Definition: png.h:2401
void png_process_some_data(png_structp png_ptr, png_infop info_ptr)
Definition: pngpread.c:43
png_uint_32 user_width_max
Definition: png.h:2660
void FAR * png_voidp
Definition: pngconf.h:1196
void PNGAPI png_set_tRNS_to_alpha(png_structp png_ptr)
Definition: pngrtran.c:608
void png_write_IEND(png_structp png_ptr)
Definition: pngwutil.c:679
void PNGAPI png_write_row(png_structp png_ptr, png_bytep row)
Definition: pngwrite.c:762
void PNGAPI png_read_png(png_structp png_ptr, png_infop info_ptr, int transforms, voidp params)
Definition: pngread.c:1307
png_uint_32 idat_size
Definition: png.h:1230
png_int_32 png_fixed_point
Definition: pngconf.h:1193
png_infop double double double * red_x
Definition: png.h:2252
void PNGAPI png_set_shift(png_structp png_ptr, png_color_8p true_bits)
Definition: pngtrans.c:67
char FAR *FAR * png_charpp
Definition: pngconf.h:1225
int int num_weights
Definition: png.h:1905
png_flush_ptr output_flush_fn
Definition: png.h:1269
void PNGAPI png_push_fill_buffer(png_structp png_ptr, png_bytep buffer, png_size_t length)
Definition: pngpread.c:564
void png_handle_bKGD(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngrutil.c:1367
void png_write_bKGD(png_structp png_ptr, png_color_16p back, int color_type)
Definition: pngwutil.c:1137
png_color_16p background_color
Definition: png.h:1703
void png_destroy_struct_2(png_voidp struct_ptr, png_free_ptr free_fn, png_voidp mem_ptr)
Definition: pngmem.c:394
png_voidp PNGAPI png_memset_check(png_structp png_ptr, png_voidp s1, int value, png_uint_32 length)
Definition: pngmem.c:569
void PNGAPI png_read_image(png_structp png_ptr, png_bytepp image)
Definition: pngread.c:868
png_structp PNGAPI png_create_write_struct(png_const_charp user_png_ver, png_voidp error_ptr, png_error_ptr error_fn, png_error_ptr warn_fn)
Definition: pngwrite.c:439
int PNGAPI png_mmx_support(void)
Definition: png.c:779
png_byte month
Definition: png.h:677
void png_handle_gAMA(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngrutil.c:619
float y_red
Definition: png.h:887
png_byte usr_bit_depth
Definition: png.h:1243
size_t png_size_t
Definition: pngconf.h:1128
png_uint_32 PNGAPI png_get_sPLT(png_structp png_ptr, png_infop info_ptr, png_sPLT_tpp spalettes)
Definition: pngget.c:510
int png_crc_error(png_structp png_ptr)
Definition: pngrutil.c:181
void PNGAPI png_write_init(png_structp png_ptr)
Definition: pngwrite.c:579
png_infop png_int_32 png_int_32 int * unit_type
Definition: png.h:2320
void png_handle_sBIT(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngrutil.c:700
void PNGAPI png_save_uint_16(png_bytep buf, unsigned int i)
Definition: pngwutil.c:46
double FAR * png_doublep
Definition: pngconf.h:1215
png_uint_16 green
Definition: png.h:603
void png_push_process_row(png_structp png_ptr)
Definition: pngpread.c:810
png_charp name
Definition: png.h:618
void PNGAPI png_set_invalid(png_structp png_ptr, png_infop info_ptr, int mask)
Definition: pngset.c:1242
png_byte alpha
Definition: png.h:591
int num
Definition: png.h:1502
png_size_t text_length
Definition: png.h:645
void png_push_handle_unknown(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngpread.c:1463
void PNGAPI png_set_compression_method(png_structp png_ptr, int method)
Definition: pngwrite.c:1430
void PNGAPI png_set_text(png_structp png_ptr, png_infop info_ptr, png_textp text_ptr, int num_text)
Definition: pngset.c:731
void PNGAPI png_set_read_user_chunk_fn(png_structp png_ptr, png_voidp user_chunk_ptr, png_user_chunk_ptr read_user_chunk_fn)
Definition: pngset.c:1198
png_color_8 sig_bit
Definition: png.h:817
png_fixed_point int_y_green
Definition: png.h:977
png_uint_32 PNGAPI png_get_image_height(png_structp png_ptr, png_infop info_ptr)
Definition: pngget.c:57
struct png_row_info_struct png_row_info
png_sPLT_t FAR *FAR * png_sPLT_tpp
Definition: png.h:624
png_uint_32 x_pixels_per_unit
Definition: png.h:861
png_colorp int int maximum_colors
Definition: png.h:1720
png_byte PNGAPI png_get_filter_type(png_structp png_ptr, png_infop info_ptr)
Definition: pngget.c:87
Definition: png.h:600
png_bytep palette_lookup
Definition: png.h:1342
void png_decompress_chunk(png_structp png_ptr, int comp_type, png_size_t chunklength, png_size_t prefix_size, png_size_t *newlength)
Definition: pngrutil.c:220
png_bytep avg_row
Definition: png.h:1225
void PNGAPI png_permit_empty_plte(png_structp png_ptr, int empty_plte_permitted)
Definition: pngset.c:1122
void png_handle_iCCP(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngrutil.c:1009
void PNGAPI png_set_tRNS(png_structp png_ptr, png_infop info_ptr, png_bytep trans, int num_trans, png_color_16p trans_values)
Definition: pngset.c:918
int mem_level
Definition: png.h:1929
int gamma_shift
Definition: png.h:1275
png_uint_16 red
Definition: png.h:577
int num_text
Definition: png.h:798
png_progressive_end_ptr end_fn
Definition: png.h:1310
void PNGAPI png_set_read_user_transform_fn(png_structp png_ptr, png_user_transform_ptr read_user_transform_fn)
Definition: pngrtran.c:697
png_bytep trans
Definition: png.h:831
void PNGAPI png_set_progressive_read_fn(png_structp png_ptr, png_voidp progressive_ptr, png_progressive_info_ptr info_fn, png_progressive_row_ptr row_fn, png_progressive_end_ptr end_fn)
Definition: pngpread.c:1576
png_uint_32 height
Definition: png.h:1213
void png_write_finish_row(png_structp png_ptr)
Definition: pngwutil.c:1860
png_infop info_ptr
Definition: png.h:1571
void PNGAPI png_default_read_data(png_structp png_ptr, png_bytep data, png_size_t length)
Definition: pngrio.c:44
void PNGAPI png_write_chunk_start(png_structp png_ptr, png_bytep chunk_name, png_uint_32 length)
Definition: pngwutil.c:94
png_infop double double double double double * green_x
Definition: png.h:2252
png_int_32 y_offset
Definition: png.h:852
void PNGAPI png_set_pHYs(png_structp png_ptr, png_infop info_ptr, png_uint_32 res_x, png_uint_32 res_y, int unit_type)
Definition: pngset.c:522
unsigned long png_uint_32
Definition: pngconf.h:1116
png_infop int chunk
Definition: png.h:2487
png_row_info FAR * png_row_infop
Definition: png.h:1098
void PNGAPI png_read_init_2(png_structp png_ptr, png_const_charp user_png_ver, png_size_t png_struct_size, png_size_t png_info_size)
Definition: pngread.c:191
png_charp PNGAPI png_get_header_version(png_structp png_ptr)
Definition: png.c:728
int num_chunk_list
Definition: png.h:1376
png_byte * data
Definition: png.h:696
png_uint_32 height
Definition: png.h:750
png_int_32 PNGAPI png_get_x_offset_microns(png_structp png_ptr, png_infop info_ptr)
Definition: pngget.c:194
FILE * png_FILE_p
Definition: pngconf.h:1210
png_uint_32 PNGAPI png_get_tIME(png_structp png_ptr, png_infop info_ptr, png_timep *mod_time)
Definition: pngget.c:747
void png_handle_PLTE(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngrutil.c:459
void png_write_zTXt(png_structp png_ptr, png_charp key, png_charp text, png_size_t text_len, int compression)
Definition: pngwutil.c:1395
png_charp PNGAPI png_get_copyright(png_structp png_ptr)
Definition: png.c:694
png_voidp png_error_ptr png_error_ptr png_voidp mem_ptr
Definition: png.h:1530
void png_do_unshift(png_row_infop row_info, png_bytep row, png_color_8p sig_bits)
Definition: pngrtran.c:1605
png_bytepp PNGAPI png_get_rows(png_structp png_ptr, png_infop info_ptr)
Definition: pngget.c:35
jmp_buf jmpbuf
Definition: png.h:1172
png_infop png_uint_32 flag
Definition: png.h:2159
png_info FAR *FAR * png_infopp
Definition: png.h:985
void PNGAPI png_free(png_structp png_ptr, png_voidp ptr)
Definition: pngmem.c:498
int PNGAPI png_reset_zstream(png_structp png_ptr)
Definition: png.c:759
png_color_16p int background_gamma_code
Definition: png.h:1703
void PNGAPI png_set_rgb_to_gray(png_structp png_ptr, int error_action, double red, double green)
Definition: pngrtran.c:633
png_uint_32 PNGAPI png_get_rowbytes(png_structp png_ptr, png_infop info_ptr)
Definition: pngget.c:25
void PNGAPI png_set_swap_alpha(png_structp png_ptr)
Definition: pngtrans.c:146
png_row_info row_info
Definition: png.h:1228
png_fixed_point int_gamma
Definition: png.h:1403
png_uint_32 old_big_row_buf_size
Definition: png.h:1461
void png_push_read_tEXt(png_structp png_ptr, png_infop info_ptr)
Definition: pngpread.c:1086
void PNGAPI png_destroy_read_struct(png_structpp png_ptr_ptr, png_infopp info_ptr_ptr, png_infopp end_info_ptr_ptr)
Definition: pngread.c:1080
void png_push_read_zTXt(png_structp png_ptr, png_infop info_ptr)
Definition: pngpread.c:1184
png_byte gray
Definition: png.h:590
png_voidp PNGAPI png_get_user_chunk_ptr(png_structp png_ptr)
Definition: pngget.c:823
png_uint_32 transformations
Definition: png.h:1201
int error_action
Definition: png.h:1628
png_size_t png_check_keyword(png_structp png_ptr, png_charp key, png_charpp new_key)
Definition: pngwutil.c:1231
png_uint_16pp gamma_16_from_1
Definition: png.h:1287
float gamma
Definition: png.h:1277
png_infop double * white_x
Definition: png.h:2252
png_infop png_fixed_point png_fixed_point png_fixed_point png_fixed_point png_fixed_point png_fixed_point * int_green_y
Definition: png.h:2258
void PNGAPI png_set_filter(png_structp png_ptr, int method, int filters)
Definition: pngwrite.c:1142
png_int_32 pcal_X1
Definition: png.h:909
void PNGAPI png_read_init_3(png_structpp ptr_ptr, png_const_charp user_png_ver, png_size_t png_struct_size)
Definition: pngread.c:238
png_uint_32 filler
Definition: png.h:1656
void png_push_have_info(png_structp png_ptr, png_infop info_ptr)
Definition: pngpread.c:1541
png_charp time_buffer
Definition: png.h:1361
png_infop png_timep * mod_time
Definition: png.h:2425
void png_handle_pHYs(png_structp png_ptr, png_infop info_ptr, png_uint_32 length)
Definition: pngrutil.c:1510
png_sPLT_entryp entries
Definition: png.h:620
png_byte PNGAPI png_get_color_type(png_structp png_ptr, png_infop info_ptr)
Definition: pngget.c:77
void png_do_write_interlace(png_row_infop row_info, png_bytep row, int pass)
Definition: pngwutil.c:1979
void PNGAPI png_set_error_fn(png_structp png_ptr, png_voidp error_ptr, png_error_ptr error_fn, png_error_ptr warning_fn)
Definition: pngerror.c:310
png_uint_32 mng_features_permitted
Definition: png.h:1397
png_byte interlaced
Definition: png.h:1238
void PNGAPI png_read_update_info(png_structp png_ptr, png_infop info_ptr)
Definition: pngread.c:534
int window_bits
Definition: png.h:1935
png_uint_32 PNGAPI png_get_sRGB(png_structp png_ptr, png_infop info_ptr, int *file_srgb_intent)
Definition: pngget.c:473
png_infop int freer
Definition: png.h:2081
png_uint_32 y_pixels_per_unit
Definition: png.h:862
void PNGAPI png_init_io(png_structp png_ptr, png_FILE_p fp)
Definition: png.c:633
void png_check_chunk_name(png_structp png_ptr, png_bytep chunk_name)
Definition: pngrutil.c:2326
PNG_EXPORT_VAR(PNG_CONST char) png_libpng_ver[18]
png_time FAR *FAR * png_timepp
Definition: png.h:684
int zlib_window_bits
Definition: png.h:1208
void PNGAPI png_set_keep_unknown_chunks(png_structp png_ptr, int keep, png_bytep chunk_list, int num_chunks)
Definition: pngset.c:1151
png_infop png_fixed_point png_fixed_point png_fixed_point png_fixed_point png_fixed_point png_fixed_point png_fixed_point * int_blue_x
Definition: png.h:2258
png_uint_32 asm_flags
Definition: png.h:1423
png_byte pass
Definition: png.h:1239
png_infop png_uint_32 png_uint_32 int int int int * compression_method
Definition: png.h:2309
png_voidp PNGAPI png_malloc(png_structp png_ptr, png_uint_32 size)
Definition: pngmem.c:429
png_uint_16 year
Definition: png.h:676
void png_reset_crc(png_structp png_ptr)
Definition: png.c:201
png_voidp PNGAPI png_malloc_warn(png_structp png_ptr, png_uint_32 size)
Definition: pngmem.c:541
void PNGAPI png_set_sRGB(png_structp png_ptr, png_infop info_ptr, int intent)
Definition: pngset.c:601
png_byte PNGAPI png_get_channels(png_structp png_ptr, png_infop info_ptr)
Definition: pngget.c:342
png_byte green
Definition: png.h:568
int keep
Definition: png.h:2483
png_bytep sub_row
Definition: png.h:1223
png_byte bit_depth
Definition: png.h:1093
unsigned int uInt
Definition: zconf.h:263
png_size_t current_text_left
Definition: png.h:1326
void png_write_cHRM(png_structp png_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)
Definition: pngwutil.c:964
void PNGAPI png_set_gray_to_rgb(png_structp png_ptr)
Definition: pngrtran.c:618
png_size_t unknown_chunks_num
Definition: png.h:924
png_byte blue
Definition: png.h:569
png_infop png_unknown_chunkp unknowns
Definition: png.h:2485
struct png_color_struct png_color
png_uint_32 png_read_chunk_header(png_structp png_ptr)
Definition: pngrutil.c:106
png_user_transform_ptr read_user_transform_fn
Definition: png.h:2000
void png_do_write_swap_alpha(png_row_infop row_info, png_bytep row)
Definition: pngwtran.c:337
float y_blue
Definition: png.h:891
void PNGAPI png_write_init_3(png_structpp ptr_ptr, png_const_charp user_png_ver, png_size_t png_struct_size)
Definition: pngwrite.c:634
void PNGAPI png_set_gAMA_fixed(png_structp png_ptr, png_infop info_ptr, png_fixed_point int_gamma)
Definition: pngset.c:181
png_unknown_chunkp unknown_chunks
Definition: png.h:923
void png_do_write_invert_alpha(png_row_infop row_info, png_bytep row)
Definition: pngwtran.c:425
png_infop png_color_8p * sig_bit
Definition: png.h:2360
png_uint_32 PNGAPI png_access_version_number(void)
Definition: png.c:768
png_color FAR * png_colorp
Definition: png.h:571
png_info FAR * png_infop
Definition: png.h:984