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