~ubuntu-branches/ubuntu/oneiric/libpng/oneiric

« back to all changes in this revision

Viewing changes to libpng.3

  • Committer: Bazaar Package Importer
  • Author(s): Anibal Monsalve Salazar
  • Date: 2009-05-22 09:11:26 UTC
  • mfrom: (1.1.7 upstream)
  • Revision ID: james.westby@ubuntu.com-20090522091126-ackh8fu2581nwuyg
Tags: 1.2.36-1
* New upstream release 
* Standards-Version is 3.8.1
* debhelper compat is 7
* Run dh_prep instead of dh_clean -k

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.TH LIBPNG 3 "February 14, 2009"
 
1
.TH LIBPNG 3 "May 7, 2009"
2
2
.SH NAME
3
 
libpng \- Portable Network Graphics (PNG) Reference Library 1.2.35
 
3
libpng \- Portable Network Graphics (PNG) Reference Library 1.2.36
4
4
.SH SYNOPSIS
5
 
\fI\fB
6
 
 
7
 
\fB#include <png.h>\fP
8
 
 
9
 
\fI\fB
 
5
\fB
 
6
#include <png.h>\fP
10
7
 
11
8
\fBpng_uint_32 png_access_version_number \fI(void\fP\fB);\fP
12
9
 
13
 
\fI\fB
14
 
 
15
10
\fBint png_check_sig (png_bytep \fP\fIsig\fP\fB, int \fInum\fP\fB);\fP
16
11
 
17
 
\fI\fB
18
 
 
19
12
\fBvoid png_chunk_error (png_structp \fP\fIpng_ptr\fP\fB, png_const_charp \fIerror\fP\fB);\fP
20
13
 
21
 
\fI\fB
22
 
 
23
14
\fBvoid png_chunk_warning (png_structp \fP\fIpng_ptr\fP\fB, png_const_charp \fImessage\fP\fB);\fP
24
15
 
25
 
\fI\fB
26
 
 
27
16
\fBvoid png_convert_from_struct_tm (png_timep \fP\fIptime\fP\fB, struct tm FAR * \fIttime\fP\fB);\fP
28
17
 
29
 
\fI\fB
30
 
 
31
18
\fBvoid png_convert_from_time_t (png_timep \fP\fIptime\fP\fB, time_t \fIttime\fP\fB);\fP
32
19
 
33
 
\fI\fB
34
 
 
35
20
\fBpng_charp png_convert_to_rfc1123 (png_structp \fP\fIpng_ptr\fP\fB, png_timep \fIptime\fP\fB);\fP
36
21
 
37
 
\fI\fB
38
 
 
39
22
\fBpng_infop png_create_info_struct (png_structp \fIpng_ptr\fP\fB);\fP
40
23
 
41
 
\fI\fB
42
 
 
43
24
\fBpng_structp png_create_read_struct (png_const_charp \fP\fIuser_png_ver\fP\fB, png_voidp \fP\fIerror_ptr\fP\fB, png_error_ptr \fP\fIerror_fn\fP\fB, png_error_ptr \fIwarn_fn\fP\fB);\fP
44
25
 
45
 
\fI\fB
46
 
 
47
26
\fBpng_structp png_create_read_struct_2(png_const_charp \fP\fIuser_png_ver\fP\fB, png_voidp \fP\fIerror_ptr\fP\fB, png_error_ptr \fP\fIerror_fn\fP\fB, png_error_ptr \fP\fIwarn_fn\fP\fB, png_voidp \fP\fImem_ptr\fP\fB, png_malloc_ptr \fP\fImalloc_fn\fP\fB, png_free_ptr \fIfree_fn\fP\fB);\fP
48
27
 
49
 
\fI\fB
50
 
 
51
28
\fBpng_structp png_create_write_struct (png_const_charp \fP\fIuser_png_ver\fP\fB, png_voidp \fP\fIerror_ptr\fP\fB, png_error_ptr \fP\fIerror_fn\fP\fB, png_error_ptr \fIwarn_fn\fP\fB);\fP
52
29
 
53
 
\fI\fB
54
 
 
55
30
\fBpng_structp png_create_write_struct_2(png_const_charp \fP\fIuser_png_ver\fP\fB, png_voidp \fP\fIerror_ptr\fP\fB, png_error_ptr \fP\fIerror_fn\fP\fB, png_error_ptr \fP\fIwarn_fn\fP\fB, png_voidp \fP\fImem_ptr\fP\fB, png_malloc_ptr \fP\fImalloc_fn\fP\fB, png_free_ptr \fIfree_fn\fP\fB);\fP
56
31
 
57
 
\fI\fB
58
 
 
59
32
\fBint png_debug(int \fP\fIlevel\fP\fB, png_const_charp \fImessage\fP\fB);\fP
60
33
 
61
 
\fI\fB
62
 
 
63
34
\fBint png_debug1(int \fP\fIlevel\fP\fB, png_const_charp \fP\fImessage\fP\fB, \fIp1\fP\fB);\fP
64
35
 
65
 
\fI\fB
66
 
 
67
36
\fBint png_debug2(int \fP\fIlevel\fP\fB, png_const_charp \fP\fImessage\fP\fB, \fP\fIp1\fP\fB, \fIp2\fP\fB);\fP
68
37
 
69
 
\fI\fB
70
 
 
71
38
\fBvoid png_destroy_info_struct (png_structp \fP\fIpng_ptr\fP\fB, png_infopp \fIinfo_ptr_ptr\fP\fB);\fP
72
39
 
73
 
\fI\fB
74
 
 
75
40
\fBvoid png_destroy_read_struct (png_structpp \fP\fIpng_ptr_ptr\fP\fB, png_infopp \fP\fIinfo_ptr_ptr\fP\fB, png_infopp \fIend_info_ptr_ptr\fP\fB);\fP
76
41
 
77
 
\fI\fB
78
 
 
79
42
\fBvoid png_destroy_write_struct (png_structpp \fP\fIpng_ptr_ptr\fP\fB, png_infopp \fIinfo_ptr_ptr\fP\fB);\fP
80
43
 
81
 
\fI\fB
82
 
 
83
44
\fBvoid png_error (png_structp \fP\fIpng_ptr\fP\fB, png_const_charp \fIerror\fP\fB);\fP
84
45
 
85
 
\fI\fB
86
 
 
87
46
\fBvoid png_free (png_structp \fP\fIpng_ptr\fP\fB, png_voidp \fIptr\fP\fB);\fP
88
47
 
89
 
\fI\fB
90
 
 
91
48
\fBvoid png_free_chunk_list (png_structp \fIpng_ptr\fP\fB);\fP
92
49
 
93
 
\fI\fB
94
 
 
95
50
\fBvoid png_free_default(png_structp \fP\fIpng_ptr\fP\fB, png_voidp \fIptr\fP\fB);\fP
96
51
 
97
 
\fI\fB
98
 
 
99
52
\fBvoid png_free_data (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, int \fInum\fP\fB);\fP
100
53
 
101
 
\fI\fB
102
 
 
103
54
\fBpng_byte png_get_bit_depth (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
104
55
 
105
 
\fI\fB
106
 
 
107
56
\fBpng_uint_32 png_get_bKGD (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_color_16p \fI*background\fP\fB);\fP
108
57
 
109
 
\fI\fB
110
 
 
111
58
\fBpng_byte png_get_channels (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
112
59
 
113
 
\fI\fB
114
 
 
115
60
\fBpng_uint_32 png_get_cHRM (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, double \fP\fI*white_x\fP\fB, double \fP\fI*white_y\fP\fB, double \fP\fI*red_x\fP\fB, double \fP\fI*red_y\fP\fB, double \fP\fI*green_x\fP\fB, double \fP\fI*green_y\fP\fB, double \fP\fI*blue_x\fP\fB, double \fI*blue_y\fP\fB);\fP
116
61
 
117
 
\fI\fB
118
 
 
119
62
\fBpng_uint_32 png_get_cHRM_fixed (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_uint_32 \fP\fI*white_x\fP\fB, png_uint_32 \fP\fI*white_y\fP\fB, png_uint_32 \fP\fI*red_x\fP\fB, png_uint_32 \fP\fI*red_y\fP\fB, png_uint_32 \fP\fI*green_x\fP\fB, png_uint_32 \fP\fI*green_y\fP\fB, png_uint_32 \fP\fI*blue_x\fP\fB, png_uint_32 \fI*blue_y\fP\fB);\fP
120
63
 
121
 
\fI\fB
122
 
 
123
64
\fBpng_byte png_get_color_type (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
124
65
 
125
 
\fI\fB
126
 
 
127
66
\fBpng_byte png_get_compression_type (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
128
67
 
129
 
\fI\fB
130
 
 
131
68
\fBpng_byte png_get_copyright (png_structp \fIpng_ptr\fP\fB);\fP
132
69
 
133
 
\fI\fB
134
 
 
135
70
\fBpng_voidp png_get_error_ptr (png_structp \fIpng_ptr\fP\fB);\fP
136
71
 
137
 
\fI\fB
138
 
 
139
72
\fBpng_byte png_get_filter_type (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
140
73
 
141
 
\fI\fB
142
 
 
143
74
\fBpng_uint_32 png_get_gAMA (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, double \fI*file_gamma\fP\fB);\fP
144
75
 
145
 
\fI\fB
146
 
 
147
76
\fBpng_uint_32 png_get_gAMA_fixed (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_uint_32 \fI*int_file_gamma\fP\fB);\fP
148
77
 
149
 
\fI\fB
150
 
 
151
78
\fBpng_byte png_get_header_ver (png_structp \fIpng_ptr\fP\fB);\fP
152
79
 
153
 
\fI\fB
154
 
 
155
80
\fBpng_byte png_get_header_version (png_structp \fIpng_ptr\fP\fB);\fP
156
81
 
157
 
\fI\fB
158
 
 
159
82
\fBpng_uint_32 png_get_hIST (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_uint_16p \fI*hist\fP\fB);\fP
160
83
 
161
 
\fI\fB
162
 
 
163
84
\fBpng_uint_32 png_get_iCCP (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_charpp \fP\fIname\fP\fB, int \fP\fI*compression_type\fP\fB, png_charpp \fP\fIprofile\fP\fB, png_uint_32 \fI*proflen\fP\fB);\fP
164
85
 
165
 
\fI\fB
166
 
 
167
86
\fBpng_uint_32 png_get_IHDR (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_uint_32 \fP\fI*width\fP\fB, png_uint_32 \fP\fI*height\fP\fB, int \fP\fI*bit_depth\fP\fB, int \fP\fI*color_type\fP\fB, int \fP\fI*interlace_type\fP\fB, int \fP\fI*compression_type\fP\fB, int \fI*filter_type\fP\fB);\fP
168
87
 
169
 
\fI\fB
170
 
 
171
88
\fBpng_uint_32 png_get_image_height (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
172
89
 
173
 
\fI\fB
174
 
 
175
90
\fBpng_uint_32 png_get_image_width (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
176
91
 
177
 
\fI\fB
178
 
 
179
 
\fB#if \fI!defined(PNG_1_0_X)
180
 
 
181
 
\fBpng_int_32 png_get_int_32 (png_bytep \fIbuf\fP\fB);\fP
182
 
 
183
 
\fI\fB#endif
184
 
 
185
 
\fI\fB
 
92
\fB#if !defined(PNG_1_0_X) png_int_32 png_get_int_32 (png_bytep buf); \fI#endif
186
93
 
187
94
\fBpng_byte png_get_interlace_type (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
188
95
 
189
 
\fI\fB
190
 
 
191
96
\fBpng_voidp png_get_io_ptr (png_structp \fIpng_ptr\fP\fB);\fP
192
97
 
193
 
\fI\fB
194
 
 
195
98
\fBpng_byte png_get_libpng_ver (png_structp \fIpng_ptr\fP\fB);\fP
196
99
 
197
 
\fI\fB
198
 
 
199
100
\fBpng_voidp png_get_mem_ptr(png_structp \fIpng_ptr\fP\fB);\fP
200
101
 
201
 
\fI\fB
202
 
 
203
102
\fBpng_uint_32 png_get_oFFs (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_uint_32 \fP\fI*offset_x\fP\fB, png_uint_32 \fP\fI*offset_y\fP\fB, int \fI*unit_type\fP\fB);\fP
204
103
 
205
 
\fI\fB
206
 
 
207
104
\fBpng_uint_32 png_get_pCAL (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_charp \fP\fI*purpose\fP\fB, png_int_32 \fP\fI*X0\fP\fB, png_int_32 \fP\fI*X1\fP\fB, int \fP\fI*type\fP\fB, int \fP\fI*nparams\fP\fB, png_charp \fP\fI*units\fP\fB, png_charpp \fI*params\fP\fB);\fP
208
105
 
209
 
\fI\fB
210
 
 
211
106
\fBpng_uint_32 png_get_pHYs (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_uint_32 \fP\fI*res_x\fP\fB, png_uint_32 \fP\fI*res_y\fP\fB, int \fI*unit_type\fP\fB);\fP
212
107
 
213
 
\fI\fB
214
 
 
215
108
\fBfloat png_get_pixel_aspect_ratio (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
216
109
 
217
 
\fI\fB
218
 
 
219
110
\fBpng_uint_32 png_get_pixels_per_meter (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
220
111
 
221
 
\fI\fB
222
 
 
223
112
\fBpng_voidp png_get_progressive_ptr (png_structp \fIpng_ptr\fP\fB);\fP
224
113
 
225
 
\fI\fB
226
 
 
227
114
\fBpng_uint_32 png_get_PLTE (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_colorp \fP\fI*palette\fP\fB, int \fI*num_palette\fP\fB);\fP
228
115
 
229
 
\fI\fB
230
 
 
231
 
\fBpng_byte png_get_rgb_to_gray_status (png_structp \fIpng_ptr)
232
 
 
233
 
\fBpng_uint_32 png_get_rowbytes (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
234
 
 
235
 
\fI\fB
 
116
\fBpng_byte png_get_rgb_to_gray_status (png_structp png_ptr) png_uint_32 png_get_rowbytes (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
236
117
 
237
118
\fBpng_bytepp png_get_rows (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
238
119
 
239
 
\fI\fB
240
 
 
241
120
\fBpng_uint_32 png_get_sBIT (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_color_8p \fI*sig_bit\fP\fB);\fP
242
121
 
243
 
\fI\fB
244
 
 
245
122
\fBpng_bytep png_get_signature (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
246
123
 
247
 
\fI\fB
248
 
 
249
124
\fBpng_uint_32 png_get_sPLT (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_spalette_p \fI*splt_ptr\fP\fB);\fP
250
125
 
251
 
\fI\fB
252
 
 
253
126
\fBpng_uint_32 png_get_sRGB (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, int \fI*intent\fP\fB);\fP
254
127
 
255
 
\fI\fB
256
 
 
257
128
\fBpng_uint_32 png_get_text (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_textp \fP\fI*text_ptr\fP\fB, int \fI*num_text\fP\fB);\fP
258
129
 
259
 
\fI\fB
260
 
 
261
130
\fBpng_uint_32 png_get_tIME (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_timep \fI*mod_time\fP\fB);\fP
262
131
 
263
 
\fI\fB
264
 
 
265
132
\fBpng_uint_32 png_get_tRNS (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_bytep \fP\fI*trans\fP\fB, int \fP\fI*num_trans\fP\fB, png_color_16p \fI*trans_values\fP\fB);\fP
266
133
 
267
 
\fI\fB
268
 
 
269
 
\fB#if \fI!defined(PNG_1_0_X)
270
 
 
271
 
\fBpng_uint_16 png_get_uint_16 (png_bytep \fIbuf\fP\fB);\fP
272
 
 
273
 
\fI\fB
 
134
\fB#if !defined(PNG_1_0_X) png_uint_16 png_get_uint_16 (png_bytep \fIbuf\fP\fB);\fP
274
135
 
275
136
\fBpng_uint_32 png_get_uint_31 (png_bytep \fIbuf\fP\fB);\fP
276
137
 
277
 
\fI\fB
278
 
 
279
 
\fBpng_uint_32 png_get_uint_32 (png_bytep \fIbuf\fP\fB);\fP
280
 
 
281
 
\fI\fB#endif
282
 
 
283
 
\fI\fB
 
138
\fBpng_uint_32 png_get_uint_32 (png_bytep buf); \fI#endif
284
139
 
285
140
\fBpng_uint_32 png_get_unknown_chunks (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_unknown_chunkpp \fIunknowns\fP\fB);\fP
286
141
 
287
 
\fI\fB
288
 
 
289
142
\fBpng_voidp png_get_user_chunk_ptr (png_structp \fIpng_ptr\fP\fB);\fP
290
143
 
291
 
\fI\fB
292
 
 
293
144
\fBpng_uint_32 png_get_user_height_max( png_structp \fIpng_ptr\fP\fB);\fP
294
145
 
295
 
\fI\fB
296
 
 
297
146
\fBpng_voidp png_get_user_transform_ptr (png_structp \fIpng_ptr\fP\fB);\fP
298
147
 
299
 
\fI\fB
300
 
 
301
148
\fBpng_uint_32 png_get_user_width_max (png_structp \fIpng_ptr\fP\fB);\fP
302
149
 
303
 
\fI\fB
304
 
 
305
150
\fBpng_uint_32 png_get_valid (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_uint_32 \fIflag\fP\fB);\fP
306
151
 
307
 
\fI\fB
308
 
 
309
152
\fBpng_int_32 png_get_x_offset_microns (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
310
153
 
311
 
\fI\fB
312
 
 
313
154
\fBpng_int_32 png_get_x_offset_pixels (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
314
155
 
315
 
\fI\fB
316
 
 
317
156
\fBpng_uint_32 png_get_x_pixels_per_meter (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
318
157
 
319
 
\fI\fB
320
 
 
321
158
\fBpng_int_32 png_get_y_offset_microns (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
322
159
 
323
 
\fI\fB
324
 
 
325
160
\fBpng_int_32 png_get_y_offset_pixels (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
326
161
 
327
 
\fI\fB
328
 
 
329
162
\fBpng_uint_32 png_get_y_pixels_per_meter (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
330
163
 
331
 
\fI\fB
332
 
 
333
164
\fBpng_uint_32 png_get_compression_buffer_size (png_structp \fIpng_ptr\fP\fB);\fP
334
165
 
335
 
\fI\fB
336
 
 
337
166
\fBint png_handle_as_unknown (png_structp \fP\fIpng_ptr\fP\fB, png_bytep \fIchunk_name\fP\fB);\fP
338
167
 
339
 
\fI\fB
340
 
 
341
168
\fBvoid png_init_io (png_structp \fP\fIpng_ptr\fP\fB, FILE \fI*fp\fP\fB);\fP
342
169
 
343
 
\fI\fB
344
 
 
345
170
\fBDEPRECATED: void png_info_init (png_infop \fIinfo_ptr\fP\fB);\fP
346
171
 
347
 
\fI\fB
348
 
 
349
172
\fBDEPRECATED: void png_info_init_2 (png_infopp \fP\fIptr_ptr\fP\fB, png_size_t \fIpng_info_struct_size\fP\fB);\fP
350
173
 
351
 
\fI\fB
352
 
 
353
174
\fBpng_voidp png_malloc (png_structp \fP\fIpng_ptr\fP\fB, png_uint_32 \fIsize\fP\fB);\fP
354
175
 
355
 
\fI\fB
356
 
 
357
176
\fBpng_voidp png_malloc_default(png_structp \fP\fIpng_ptr\fP\fB, png_uint_32 \fIsize\fP\fB);\fP
358
177
 
359
 
\fI\fB
360
 
 
361
178
\fBvoidp png_memcpy (png_voidp \fP\fIs1\fP\fB, png_voidp \fP\fIs2\fP\fB, png_size_t \fIsize\fP\fB);\fP
362
179
 
363
 
\fI\fB
364
 
 
365
180
\fBpng_voidp png_memcpy_check (png_structp \fP\fIpng_ptr\fP\fB, png_voidp \fP\fIs1\fP\fB, png_voidp \fP\fIs2\fP\fB, png_uint_32 \fIsize\fP\fB);\fP
366
181
 
367
 
\fI\fB
368
 
 
369
182
\fBvoidp png_memset (png_voidp \fP\fIs1\fP\fB, int \fP\fIvalue\fP\fB, png_size_t \fIsize\fP\fB);\fP
370
183
 
371
 
\fI\fB
372
 
 
373
184
\fBpng_voidp png_memset_check (png_structp \fP\fIpng_ptr\fP\fB, png_voidp \fP\fIs1\fP\fB, int \fP\fIvalue\fP\fB, png_uint_32 \fIsize\fP\fB);\fP
374
185
 
375
 
\fI\fB
376
 
 
377
186
\fBDEPRECATED: void png_permit_empty_plte (png_structp \fP\fIpng_ptr\fP\fB, int \fIempty_plte_permitted\fP\fB);\fP
378
187
 
379
 
\fI\fB
380
 
 
381
188
\fBvoid png_process_data (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_bytep \fP\fIbuffer\fP\fB, png_size_t \fIbuffer_size\fP\fB);\fP
382
189
 
383
 
\fI\fB
384
 
 
385
190
\fBvoid png_progressive_combine_row (png_structp \fP\fIpng_ptr\fP\fB, png_bytep \fP\fIold_row\fP\fB, png_bytep \fInew_row\fP\fB);\fP
386
191
 
387
 
\fI\fB
388
 
 
389
192
\fBvoid png_read_destroy (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_infop \fIend_info_ptr\fP\fB);\fP
390
193
 
391
 
\fI\fB
392
 
 
393
194
\fBvoid png_read_end (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
394
195
 
395
 
\fI\fB
396
 
 
397
196
\fBvoid png_read_image (png_structp \fP\fIpng_ptr\fP\fB, png_bytepp \fIimage\fP\fB);\fP
398
197
 
399
 
\fI\fB
400
 
 
401
198
\fBDEPRECATED: void png_read_init (png_structp \fIpng_ptr\fP\fB);\fP
402
199
 
403
 
\fI\fB
404
 
 
405
200
\fBDEPRECATED: void png_read_init_2 (png_structpp \fP\fIptr_ptr\fP\fB, png_const_charp \fP\fIuser_png_ver\fP\fB, png_size_t \fP\fIpng_struct_size\fP\fB, png_size_t \fIpng_info_size\fP\fB);\fP
406
201
 
407
 
\fI\fB
408
 
 
409
202
\fBvoid png_read_info (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
410
203
 
411
 
\fI\fB
412
 
 
413
204
\fBvoid png_read_png (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, int \fP\fItransforms\fP\fB, png_voidp \fIparams\fP\fB);\fP
414
205
 
415
 
\fI\fB
416
 
 
417
206
\fBvoid png_read_row (png_structp \fP\fIpng_ptr\fP\fB, png_bytep \fP\fIrow\fP\fB, png_bytep \fIdisplay_row\fP\fB);\fP
418
207
 
419
 
\fI\fB
420
 
 
421
208
\fBvoid png_read_rows (png_structp \fP\fIpng_ptr\fP\fB, png_bytepp \fP\fIrow\fP\fB, png_bytepp \fP\fIdisplay_row\fP\fB, png_uint_32 \fInum_rows\fP\fB);\fP
422
209
 
423
 
\fI\fB
424
 
 
425
210
\fBvoid png_read_update_info (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
426
211
 
427
 
\fI\fB
428
 
 
429
 
\fB#if \fI!defined(PNG_1_0_X)
430
 
 
431
 
\fBpng_save_int_32 (png_bytep \fP\fIbuf\fP\fB, png_int_32 \fIi\fP\fB);\fP
432
 
 
433
 
\fI\fB
 
212
\fB#if !defined(PNG_1_0_X) png_save_int_32 (png_bytep \fP\fIbuf\fP\fB, png_int_32 \fIi\fP\fB);\fP
434
213
 
435
214
\fBvoid png_save_uint_16 (png_bytep \fP\fIbuf\fP\fB, unsigned int \fIi\fP\fB);\fP
436
215
 
437
 
\fI\fB
438
 
 
439
216
\fBvoid png_save_uint_32 (png_bytep \fP\fIbuf\fP\fB, png_uint_32 \fIi\fP\fB);\fP
440
217
 
441
 
\fI\fB
442
 
 
443
 
\fBvoid png_set_add_alpha (png_structp \fP\fIpng_ptr\fP\fB, png_uint_32 \fP\fIfiller\fP\fB, int \fIflags\fP\fB);\fP
444
 
 
445
 
\fI\fB#endif
446
 
 
447
 
\fI\fB
 
218
\fBvoid png_set_add_alpha (png_structp \fP\fIpng_ptr\fP\fB, png_uint_32 \fP\fIfiller\fP\fB, int flags); \fI#endif
448
219
 
449
220
\fBvoid png_set_background (png_structp \fP\fIpng_ptr\fP\fB, png_color_16p \fP\fIbackground_color\fP\fB, int \fP\fIbackground_gamma_code\fP\fB, int \fP\fIneed_expand\fP\fB, double \fIbackground_gamma\fP\fB);\fP
450
221
 
451
 
\fI\fB
452
 
 
453
222
\fBvoid png_set_bgr (png_structp \fIpng_ptr\fP\fB);\fP
454
223
 
455
 
\fI\fB
456
 
 
457
224
\fBvoid png_set_bKGD (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_color_16p \fIbackground\fP\fB);\fP
458
225
 
459
 
\fI\fB
460
 
 
461
226
\fBvoid png_set_cHRM (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, double \fP\fIwhite_x\fP\fB, double \fP\fIwhite_y\fP\fB, double \fP\fIred_x\fP\fB, double \fP\fIred_y\fP\fB, double \fP\fIgreen_x\fP\fB, double \fP\fIgreen_y\fP\fB, double \fP\fIblue_x\fP\fB, double \fIblue_y\fP\fB);\fP
462
227
 
463
 
\fI\fB
464
 
 
465
228
\fBvoid png_set_cHRM_fixed (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_uint_32 \fP\fIwhite_x\fP\fB, png_uint_32 \fP\fIwhite_y\fP\fB, png_uint_32 \fP\fIred_x\fP\fB, png_uint_32 \fP\fIred_y\fP\fB, png_uint_32 \fP\fIgreen_x\fP\fB, png_uint_32 \fP\fIgreen_y\fP\fB, png_uint_32 \fP\fIblue_x\fP\fB, png_uint_32 \fIblue_y\fP\fB);\fP
466
229
 
467
 
\fI\fB
468
 
 
469
230
\fBvoid png_set_compression_level (png_structp \fP\fIpng_ptr\fP\fB, int \fIlevel\fP\fB);\fP
470
231
 
471
 
\fI\fB
472
 
 
473
232
\fBvoid png_set_compression_mem_level (png_structp \fP\fIpng_ptr\fP\fB, int \fImem_level\fP\fB);\fP
474
233
 
475
 
\fI\fB
476
 
 
477
234
\fBvoid png_set_compression_method (png_structp \fP\fIpng_ptr\fP\fB, int \fImethod\fP\fB);\fP
478
235
 
479
 
\fI\fB
480
 
 
481
236
\fBvoid png_set_compression_strategy (png_structp \fP\fIpng_ptr\fP\fB, int \fIstrategy\fP\fB);\fP
482
237
 
483
 
\fI\fB
484
 
 
485
238
\fBvoid png_set_compression_window_bits (png_structp \fP\fIpng_ptr\fP\fB, int \fIwindow_bits\fP\fB);\fP
486
239
 
487
 
\fI\fB
488
 
 
489
240
\fBvoid png_set_crc_action (png_structp \fP\fIpng_ptr\fP\fB, int \fP\fIcrit_action\fP\fB, int \fIancil_action\fP\fB);\fP
490
241
 
491
 
\fI\fB
492
 
 
493
242
\fBvoid png_set_dither (png_structp \fP\fIpng_ptr\fP\fB, png_colorp \fP\fIpalette\fP\fB, int \fP\fInum_palette\fP\fB, int \fP\fImaximum_colors\fP\fB, png_uint_16p \fP\fIhistogram\fP\fB, int \fIfull_dither\fP\fB);\fP
494
243
 
495
 
\fI\fB
496
 
 
497
244
\fBvoid png_set_error_fn (png_structp \fP\fIpng_ptr\fP\fB, png_voidp \fP\fIerror_ptr\fP\fB, png_error_ptr \fP\fIerror_fn\fP\fB, png_error_ptr \fIwarning_fn\fP\fB);\fP
498
245
 
499
 
\fI\fB
500
 
 
501
246
\fBvoid png_set_expand (png_structp \fIpng_ptr\fP\fB);\fP
502
247
 
503
 
\fI\fB
504
 
 
505
248
\fBvoid png_set_expand_gray_1_2_4_to_8(png_structp \fIpng_ptr\fP\fB);\fP
506
249
 
507
 
\fI\fB
508
 
 
509
250
\fBvoid png_set_filler (png_structp \fP\fIpng_ptr\fP\fB, png_uint_32 \fP\fIfiller\fP\fB, int \fIflags\fP\fB);\fP
510
251
 
511
 
\fI\fB
512
 
 
513
252
\fBvoid png_set_filter (png_structp \fP\fIpng_ptr\fP\fB, int \fP\fImethod\fP\fB, int \fIfilters\fP\fB);\fP
514
253
 
515
 
\fI\fB
516
 
 
517
254
\fBvoid png_set_filter_heuristics (png_structp \fP\fIpng_ptr\fP\fB, int \fP\fIheuristic_method\fP\fB, int \fP\fInum_weights\fP\fB, png_doublep \fP\fIfilter_weights\fP\fB, png_doublep \fIfilter_costs\fP\fB);\fP
518
255
 
519
 
\fI\fB
520
 
 
521
256
\fBvoid png_set_flush (png_structp \fP\fIpng_ptr\fP\fB, int \fInrows\fP\fB);\fP
522
257
 
523
 
\fI\fB
524
 
 
525
258
\fBvoid png_set_gamma (png_structp \fP\fIpng_ptr\fP\fB, double \fP\fIscreen_gamma\fP\fB, double \fIdefault_file_gamma\fP\fB);\fP
526
259
 
527
 
\fI\fB
528
 
 
529
260
\fBvoid png_set_gAMA (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, double \fIfile_gamma\fP\fB);\fP
530
261
 
531
 
\fI\fB
532
 
 
533
262
\fBvoid png_set_gAMA_fixed (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_uint_32 \fIfile_gamma\fP\fB);\fP
534
263
 
535
 
\fI\fB
536
 
 
537
264
\fBvoid png_set_gray_1_2_4_to_8(png_structp \fIpng_ptr\fP\fB);\fP
538
265
 
539
 
\fI\fB
540
 
 
541
266
\fBvoid png_set_gray_to_rgb (png_structp \fIpng_ptr\fP\fB);\fP
542
267
 
543
 
\fI\fB
544
 
 
545
268
\fBvoid png_set_hIST (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_uint_16p \fIhist\fP\fB);\fP
546
269
 
547
 
\fI\fB
548
 
 
549
270
\fBvoid png_set_iCCP (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_charp \fP\fIname\fP\fB, int \fP\fIcompression_type\fP\fB, png_charp \fP\fIprofile\fP\fB, png_uint_32 \fIproflen\fP\fB);\fP
550
271
 
551
 
\fI\fB
552
 
 
553
272
\fBint png_set_interlace_handling (png_structp \fIpng_ptr\fP\fB);\fP
554
273
 
555
 
\fI\fB
556
 
 
557
274
\fBvoid png_set_invalid (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, int \fImask\fP\fB);\fP
558
275
 
559
 
\fI\fB
560
 
 
561
276
\fBvoid png_set_invert_alpha (png_structp \fIpng_ptr\fP\fB);\fP
562
277
 
563
 
\fI\fB
564
 
 
565
278
\fBvoid png_set_invert_mono (png_structp \fIpng_ptr\fP\fB);\fP
566
279
 
567
 
\fI\fB
568
 
 
569
280
\fBvoid png_set_IHDR (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_uint_32 \fP\fIwidth\fP\fB, png_uint_32 \fP\fIheight\fP\fB, int \fP\fIbit_depth\fP\fB, int \fP\fIcolor_type\fP\fB, int \fP\fIinterlace_type\fP\fB, int \fP\fIcompression_type\fP\fB, int \fIfilter_type\fP\fB);\fP
570
281
 
571
 
\fI\fB
572
 
 
573
282
\fBvoid png_set_keep_unknown_chunks (png_structp \fP\fIpng_ptr\fP\fB, int \fP\fIkeep\fP\fB, png_bytep \fP\fIchunk_list\fP\fB, int \fInum_chunks\fP\fB);\fP
574
283
 
575
 
\fI\fB
576
 
 
577
284
\fBvoid png_set_mem_fn(png_structp \fP\fIpng_ptr\fP\fB, png_voidp \fP\fImem_ptr\fP\fB, png_malloc_ptr \fP\fImalloc_fn\fP\fB, png_free_ptr \fIfree_fn\fP\fB);\fP
578
285
 
579
 
\fI\fB
580
 
 
581
286
\fBvoid png_set_oFFs (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_uint_32 \fP\fIoffset_x\fP\fB, png_uint_32 \fP\fIoffset_y\fP\fB, int \fIunit_type\fP\fB);\fP
582
287
 
583
 
\fI\fB
584
 
 
585
288
\fBvoid png_set_packing (png_structp \fIpng_ptr\fP\fB);\fP
586
289
 
587
 
\fI\fB
588
 
 
589
290
\fBvoid png_set_packswap (png_structp \fIpng_ptr\fP\fB);\fP
590
291
 
591
 
\fI\fB
592
 
 
593
292
\fBvoid png_set_palette_to_rgb(png_structp \fIpng_ptr\fP\fB);\fP
594
293
 
595
 
\fI\fB
596
 
 
597
294
\fBvoid png_set_pCAL (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_charp \fP\fIpurpose\fP\fB, png_int_32 \fP\fIX0\fP\fB, png_int_32 \fP\fIX1\fP\fB, int \fP\fItype\fP\fB, int \fP\fInparams\fP\fB, png_charp \fP\fIunits\fP\fB, png_charpp \fIparams\fP\fB);\fP
598
295
 
599
 
\fI\fB
600
 
 
601
296
\fBvoid png_set_pHYs (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_uint_32 \fP\fIres_x\fP\fB, png_uint_32 \fP\fIres_y\fP\fB, int \fIunit_type\fP\fB);\fP
602
297
 
603
 
\fI\fB
604
 
 
605
298
\fBvoid png_set_progressive_read_fn (png_structp \fP\fIpng_ptr\fP\fB, png_voidp \fP\fIprogressive_ptr\fP\fB, png_progressive_info_ptr \fP\fIinfo_fn\fP\fB, png_progressive_row_ptr \fP\fIrow_fn\fP\fB, png_progressive_end_ptr \fIend_fn\fP\fB);\fP
606
299
 
607
 
\fI\fB
608
 
 
609
300
\fBvoid png_set_PLTE (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_colorp \fP\fIpalette\fP\fB, int \fInum_palette\fP\fB);\fP
610
301
 
611
 
\fI\fB
612
 
 
613
302
\fBvoid png_set_read_fn (png_structp \fP\fIpng_ptr\fP\fB, png_voidp \fP\fIio_ptr\fP\fB, png_rw_ptr \fIread_data_fn\fP\fB);\fP
614
303
 
615
 
\fI\fB
616
 
 
617
304
\fBvoid png_set_read_status_fn (png_structp \fP\fIpng_ptr\fP\fB, png_read_status_ptr \fIread_row_fn\fP\fB);\fP
618
305
 
619
 
\fI\fB
620
 
 
621
306
\fBvoid png_set_read_user_transform_fn (png_structp \fP\fIpng_ptr\fP\fB, png_user_transform_ptr \fIread_user_transform_fn\fP\fB);\fP
622
307
 
623
 
\fI\fB
624
 
 
625
308
\fBvoid png_set_rgb_to_gray (png_structp \fP\fIpng_ptr\fP\fB, int \fP\fIerror_action\fP\fB, double \fP\fIred\fP\fB, double \fIgreen\fP\fB);\fP
626
309
 
627
 
\fI\fB
628
 
 
629
310
\fBvoid png_set_rgb_to_gray_fixed (png_structp \fP\fIpng_ptr\fP\fB, int error_action png_fixed_point \fP\fIred\fP\fB, png_fixed_point \fIgreen\fP\fB);\fP
630
311
 
631
 
\fI\fB
632
 
 
633
312
\fBvoid png_set_rows (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_bytepp \fIrow_pointers\fP\fB);\fP
634
313
 
635
 
\fI\fB
636
 
 
637
314
\fBvoid png_set_sBIT (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_color_8p \fIsig_bit\fP\fB);\fP
638
315
 
639
 
\fI\fB
640
 
 
641
316
\fBvoid png_set_sCAL (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_charp \fP\fIunit\fP\fB, double \fP\fIwidth\fP\fB, double \fIheight\fP\fB);\fP
642
317
 
643
 
\fI\fB
644
 
 
645
318
\fBvoid png_set_shift (png_structp \fP\fIpng_ptr\fP\fB, png_color_8p \fItrue_bits\fP\fB);\fP
646
319
 
647
 
\fI\fB
648
 
 
649
320
\fBvoid png_set_sig_bytes (png_structp \fP\fIpng_ptr\fP\fB, int \fInum_bytes\fP\fB);\fP
650
321
 
651
 
\fI\fB
652
 
 
653
322
\fBvoid png_set_sPLT (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_spalette_p \fP\fIsplt_ptr\fP\fB, int \fInum_spalettes\fP\fB);\fP
654
323
 
655
 
\fI\fB
656
 
 
657
324
\fBvoid png_set_sRGB (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, int \fIintent\fP\fB);\fP
658
325
 
659
 
\fI\fB
660
 
 
661
326
\fBvoid png_set_sRGB_gAMA_and_cHRM (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, int \fIintent\fP\fB);\fP
662
327
 
663
 
\fI\fB
664
 
 
665
328
\fBvoid png_set_strip_16 (png_structp \fIpng_ptr\fP\fB);\fP
666
329
 
667
 
\fI\fB
668
 
 
669
330
\fBvoid png_set_strip_alpha (png_structp \fIpng_ptr\fP\fB);\fP
670
331
 
671
 
\fI\fB
672
 
 
673
332
\fBvoid png_set_swap (png_structp \fIpng_ptr\fP\fB);\fP
674
333
 
675
 
\fI\fB
676
 
 
677
334
\fBvoid png_set_swap_alpha (png_structp \fIpng_ptr\fP\fB);\fP
678
335
 
679
 
\fI\fB
680
 
 
681
336
\fBvoid png_set_text (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_textp \fP\fItext_ptr\fP\fB, int \fInum_text\fP\fB);\fP
682
337
 
683
 
\fI\fB
684
 
 
685
338
\fBvoid png_set_tIME (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_timep \fImod_time\fP\fB);\fP
686
339
 
687
 
\fI\fB
688
 
 
689
340
\fBvoid png_set_tRNS (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_bytep \fP\fItrans\fP\fB, int \fP\fInum_trans\fP\fB, png_color_16p \fItrans_values\fP\fB);\fP
690
341
 
691
 
\fI\fB
692
 
 
693
342
\fBvoid png_set_tRNS_to_alpha(png_structp \fIpng_ptr\fP\fB);\fP
694
343
 
695
 
\fI\fB
696
 
 
697
344
\fBpng_uint_32 png_set_unknown_chunks (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_unknown_chunkp \fP\fIunknowns\fP\fB, int \fP\fInum\fP\fB, int \fIlocation\fP\fB);\fP
698
345
 
699
 
\fI\fB
700
 
 
701
346
\fBvoid png_set_unknown_chunk_location(png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, int \fP\fIchunk\fP\fB, int \fIlocation\fP\fB);\fP
702
347
 
703
 
\fI\fB
704
 
 
705
348
\fBvoid png_set_read_user_chunk_fn (png_structp \fP\fIpng_ptr\fP\fB, png_voidp \fP\fIuser_chunk_ptr\fP\fB, png_user_chunk_ptr \fIread_user_chunk_fn\fP\fB);\fP
706
349
 
707
 
\fI\fB
708
 
 
709
350
\fBvoid png_set_user_limits (png_structp \fP\fIpng_ptr\fP\fB, png_uint_32 \fP\fIuser_width_max\fP\fB, png_uint_32 \fIuser_height_max\fP\fB);\fP
710
351
 
711
 
\fI\fB
712
 
 
713
352
\fBvoid png_set_user_transform_info (png_structp \fP\fIpng_ptr\fP\fB, png_voidp \fP\fIuser_transform_ptr\fP\fB, int \fP\fIuser_transform_depth\fP\fB, int \fIuser_transform_channels\fP\fB);\fP
714
353
 
715
 
\fI\fB
716
 
 
717
354
\fBvoid png_set_write_fn (png_structp \fP\fIpng_ptr\fP\fB, png_voidp \fP\fIio_ptr\fP\fB, png_rw_ptr \fP\fIwrite_data_fn\fP\fB, png_flush_ptr \fIoutput_flush_fn\fP\fB);\fP
718
355
 
719
 
\fI\fB
720
 
 
721
356
\fBvoid png_set_write_status_fn (png_structp \fP\fIpng_ptr\fP\fB, png_write_status_ptr \fIwrite_row_fn\fP\fB);\fP
722
357
 
723
 
\fI\fB
724
 
 
725
358
\fBvoid png_set_write_user_transform_fn (png_structp \fP\fIpng_ptr\fP\fB, png_user_transform_ptr \fIwrite_user_transform_fn\fP\fB);\fP
726
359
 
727
 
\fI\fB
728
 
 
729
360
\fBvoid png_set_compression_buffer_size(png_structp \fP\fIpng_ptr\fP\fB, png_uint_32 \fIsize\fP\fB);\fP
730
361
 
731
 
\fI\fB
732
 
 
733
362
\fBint png_sig_cmp (png_bytep \fP\fIsig\fP\fB, png_size_t \fP\fIstart\fP\fB, png_size_t \fInum_to_check\fP\fB);\fP
734
363
 
735
 
\fI\fB
736
 
 
737
364
\fBvoid png_start_read_image (png_structp \fIpng_ptr\fP\fB);\fP
738
365
 
739
 
\fI\fB
740
 
 
741
366
\fBvoid png_warning (png_structp \fP\fIpng_ptr\fP\fB, png_const_charp \fImessage\fP\fB);\fP
742
367
 
743
 
\fI\fB
744
 
 
745
368
\fBvoid png_write_chunk (png_structp \fP\fIpng_ptr\fP\fB, png_bytep \fP\fIchunk_name\fP\fB, png_bytep \fP\fIdata\fP\fB, png_size_t \fIlength\fP\fB);\fP
746
369
 
747
 
\fI\fB
748
 
 
749
370
\fBvoid png_write_chunk_data (png_structp \fP\fIpng_ptr\fP\fB, png_bytep \fP\fIdata\fP\fB, png_size_t \fIlength\fP\fB);\fP
750
371
 
751
 
\fI\fB
752
 
 
753
372
\fBvoid png_write_chunk_end (png_structp \fIpng_ptr\fP\fB);\fP
754
373
 
755
 
\fI\fB
756
 
 
757
374
\fBvoid png_write_chunk_start (png_structp \fP\fIpng_ptr\fP\fB, png_bytep \fP\fIchunk_name\fP\fB, png_uint_32 \fIlength\fP\fB);\fP
758
375
 
759
 
\fI\fB
760
 
 
761
376
\fBvoid png_write_destroy (png_structp \fIpng_ptr\fP\fB);\fP
762
377
 
763
 
\fI\fB
764
 
 
765
378
\fBvoid png_write_end (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
766
379
 
767
 
\fI\fB
768
 
 
769
380
\fBvoid png_write_flush (png_structp \fIpng_ptr\fP\fB);\fP
770
381
 
771
 
\fI\fB
772
 
 
773
382
\fBvoid png_write_image (png_structp \fP\fIpng_ptr\fP\fB, png_bytepp \fIimage\fP\fB);\fP
774
383
 
775
 
\fI\fB
776
 
 
777
384
\fBDEPRECATED: void png_write_init (png_structp \fIpng_ptr\fP\fB);\fP
778
385
 
779
 
\fI\fB
780
 
 
781
386
\fBDEPRECATED: void png_write_init_2 (png_structpp \fP\fIptr_ptr\fP\fB, png_const_charp \fP\fIuser_png_ver\fP\fB, png_size_t \fP\fIpng_struct_size\fP\fB, png_size_t \fIpng_info_size\fP\fB);\fP
782
387
 
783
 
\fI\fB
784
 
 
785
388
\fBvoid png_write_info (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
786
389
 
787
 
\fI\fB
788
 
 
789
390
\fBvoid png_write_info_before_PLTE (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fIinfo_ptr\fP\fB);\fP
790
391
 
791
 
\fI\fB
792
 
 
793
392
\fBvoid png_write_png (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, int \fP\fItransforms\fP\fB, png_voidp \fIparams\fP\fB);\fP
794
393
 
795
 
\fI\fB
796
 
 
797
394
\fBvoid png_write_row (png_structp \fP\fIpng_ptr\fP\fB, png_bytep \fIrow\fP\fB);\fP
798
395
 
799
 
\fI\fB
800
 
 
801
396
\fBvoid png_write_rows (png_structp \fP\fIpng_ptr\fP\fB, png_bytepp \fP\fIrow\fP\fB, png_uint_32 \fInum_rows\fP\fB);\fP
802
397
 
803
 
\fI\fB
804
 
 
805
398
\fBvoidpf png_zalloc (voidpf \fP\fIpng_ptr\fP\fB, uInt \fP\fIitems\fP\fB, uInt \fIsize\fP\fB);\fP
806
399
 
807
 
\fI\fB
808
 
 
809
400
\fBvoid png_zfree (voidpf \fP\fIpng_ptr\fP\fB, voidpf \fIptr\fP\fB);\fP
810
401
 
811
 
\fI\fB
812
 
 
813
402
.SH DESCRIPTION
814
403
The
815
404
.I libpng
821
410
.SH LIBPNG.TXT
822
411
libpng.txt - A description on how to use and modify libpng
823
412
 
824
 
 libpng version 1.2.35 - February 14, 2009
 
413
 libpng version 1.2.36 - May 7, 2009
825
414
 Updated and distributed by Glenn Randers-Pehrson
826
415
 <glennrp at users.sourceforge.net>
827
 
 Copyright (c) 1998-2008 Glenn Randers-Pehrson
 
416
 Copyright (c) 1998-2009 Glenn Randers-Pehrson
828
417
 For conditions of distribution and use, see copyright
829
418
 notice in png.h.
830
419
 
831
420
 Based on:
832
421
 
833
 
 libpng versions 0.97, January 1998, through 1.2.35 - February 14, 2009
 
422
 libpng versions 0.97, January 1998, through 1.2.36 - May 7, 2009
834
423
 Updated and distributed by Glenn Randers-Pehrson
835
 
 Copyright (c) 1998-2008 Glenn Randers-Pehrson
 
424
 Copyright (c) 1998-2009 Glenn Randers-Pehrson
836
425
 
837
426
 libpng 1.0 beta 6  version 0.96 May 28, 1997
838
427
 Updated and distributed by Andreas Dilger
962
551
will also want to insure that you are, in fact, dealing with a PNG
963
552
file.  Libpng provides a simple check to see if a file is a PNG file.
964
553
To use it, pass in the first 1 to 8 bytes of the file to the function
965
 
png_sig_cmp(), and it will return 0 if the bytes match the corresponding
966
 
bytes of the PNG signature, or nonzero otherwise.  Of course, the more bytes
967
 
you pass in, the greater the accuracy of the prediction.
 
554
png_sig_cmp(), and it will return 0 (false) if the bytes match the
 
555
corresponding bytes of the PNG signature, or nonzero (true) otherwise.
 
556
Of course, the more bytes you pass in, the greater the accuracy of the
 
557
prediction.
968
558
 
969
559
If you are intending to keep the file pointer open for use in libpng,
970
560
you must ensure you don't read more than 8 bytes from the beginning
1228
818
         (int)sizeof(unused_chunks)/5);
1229
819
    #endif
1230
820
 
 
821
.SS User limits
 
822
 
 
823
The PNG specification allows the width and height of an image to be as
 
824
large as 2^31-1 (0x7fffffff), or about 2.147 billion rows and columns.
 
825
Since very few applications really need to process such large images,
 
826
we have imposed an arbitrary 1-million limit on rows and columns.
 
827
Larger images will be rejected immediately with a png_error() call. If
 
828
you wish to override this limit, you can use
 
829
 
 
830
   png_set_user_limits(png_ptr, width_max, height_max);
 
831
 
 
832
to set your own limits, or use width_max = height_max = 0x7fffffffL
 
833
to allow all valid dimensions (libpng may reject some very large images
 
834
anyway because of potential buffer overflow conditions).
 
835
 
 
836
You should put this statement after you create the PNG structure and
 
837
before calling png_read_info(), png_read_png(), or png_process_data().
 
838
If you need to retrieve the limits that are being applied, use
 
839
 
 
840
   width_max = png_get_user_width_max(png_ptr);
 
841
   height_max = png_get_user_height_max(png_ptr);
1231
842
 
1232
843
.SS The high-level read interface
1233
844
 
1671
1282
 
1672
1283
As of libpng version 1.2.9, png_set_expand_gray_1_2_4_to_8() was
1673
1284
added.  It expands the sample depth without changing tRNS to alpha.
1674
 
At the same time, png_set_gray_1_2_4_to_8() was deprecated, and it
1675
 
will be removed from a future version.
1676
 
 
1677
1285
 
1678
1286
PNG can have files with 16 bits per channel.  If you only can handle
1679
1287
8 bits per channel, this will strip the pixels down to 8 bit.
2890
2498
    PNG_TRANSFORM_INVERT_ALPHA  Change alpha from opacity
2891
2499
                                to transparency
2892
2500
    PNG_TRANSFORM_SWAP_ENDIAN   Byte-swap 16-bit samples
2893
 
    PNG_TRANSFORM_STRIP_FILLER  Strip out filler bytes.
 
2501
    PNG_TRANSFORM_STRIP_FILLER        Strip out filler
 
2502
                                      bytes (deprecated).
 
2503
    PNG_TRANSFORM_STRIP_FILLER_BEFORE Strip out leading
 
2504
                                      filler bytes
 
2505
    PNG_TRANSFORM_STRIP_FILLER_AFTER  Strip out trailing
 
2506
                                      filler bytes
2894
2507
 
2895
2508
If you have valid image data in the info structure (you can use
2896
2509
png_set_rows() to put image data in the info structure), simply do this:
3297
2910
        png_bytep data, png_size_t length);
3298
2911
    void user_flush_data(png_structp png_ptr);
3299
2912
 
 
2913
The user_read_data() function is responsible for detecting and
 
2914
handling end-of-data errors.
 
2915
 
3300
2916
Supplying NULL for the read, write, or flush functions sets them back
3301
 
to using the default C stream functions.  It is an error to read from
3302
 
a write stream, and vice versa.
 
2917
to using the default C stream functions, which expect the io_ptr to
 
2918
point to a standard *FILE structure.  It is probably a mistake
 
2919
to use NULL for one of write_data_fn and output_flush_fn but not both
 
2920
of them, unless you have built libpng with PNG_NO_WRITE_FLUSH defined.
 
2921
It is an error to read from a write stream, and vice versa.
3303
2922
 
3304
2923
Error handling in libpng is done through png_error() and png_warning().
3305
2924
Errors handled through png_error() are fatal, meaning that png_error()
3404
3023
 
3405
3024
.SS Configuring for compiler xxx:
3406
3025
 
3407
 
All includes for libpng are in pngconf.h.  If you need to add/change/delete
3408
 
an include, this is the place to do it.  The includes that are not
3409
 
needed outside libpng are protected by the PNG_INTERNAL definition,
3410
 
which is only defined for those routines inside libpng itself.  The
3411
 
files in libpng proper only include png.h, which includes pngconf.h.
 
3026
All includes for libpng are in pngconf.h.  If you need to add, change
 
3027
or delete an include, this is the place to do it.
 
3028
The includes that are not needed outside libpng are protected by the
 
3029
PNG_INTERNAL definition, which is only defined for those routines inside
 
3030
libpng itself.  The files in libpng proper only include png.h, which
 
3031
includes pngconf.h.
3412
3032
 
3413
3033
.SS Configuring zlib:
3414
3034
 
3599
3219
having level = 0 will be printed.  There aren't any such statements in
3600
3220
this version of libpng, but if you insert some they will be printed.
3601
3221
 
3602
 
.SH VII.  MNG support
 
3222
.SH VI.  MNG support
3603
3223
 
3604
3224
The MNG specification (available at http://www.libpng.org/pub/mng) allows
3605
3225
certain extensions to PNG for PNG images that are embedded in MNG datastreams.
3624
3244
them.  You may wish to consider using libmng (available at
3625
3245
http://www.libmng.com) instead.
3626
3246
 
3627
 
.SH VIII.  Changes to Libpng from version 0.88
 
3247
.SH VII.  Changes to Libpng from version 0.88
3628
3248
 
3629
3249
It should be noted that versions of libpng later than 0.96 are not
3630
3250
distributed by the original libpng author, Guy Schalnat, nor by
3673
3293
 
3674
3294
   png_uint_32 application_vn = PNG_LIBPNG_VER;
3675
3295
 
3676
 
.SH IX. Y2K Compliance in libpng
3677
 
 
3678
 
February 14, 2009
 
3296
.SH VIII.  Changes to Libpng from version 1.0.x to 1.2.x
 
3297
 
 
3298
Support for user memory management was enabled by default.  To
 
3299
accomplish this, the functions png_create_read_struct_2(),
 
3300
png_create_write_struct_2(), png_set_mem_fn(), png_get_mem_ptr(),
 
3301
png_malloc_default(), and png_free_default() were added.
 
3302
 
 
3303
Support for certain MNG features was enabled.
 
3304
 
 
3305
Support for numbered error messages was added.  However, we never got
 
3306
around to actually numbering the error messages.  The function
 
3307
png_set_strip_error_numbers() was added (Note: the prototype for this
 
3308
function was inadvertently removed from png.h in PNG_NO_ASSEMBLER_CODE
 
3309
builds of libpng-1.2.15.  It was restored in libpng-1.2.36).
 
3310
 
 
3311
The png_malloc_warn() function was added at libpng-1.2.3.  This issues
 
3312
a png_warning and returns NULL instead of aborting when it fails to
 
3313
acquire the requested memory allocation.
 
3314
 
 
3315
Support for setting user limits on image width and height was enabled
 
3316
by default.  The functions png_set_user_limits(), png_get_user_width_max(),
 
3317
and png_get_user_height_max() were added at libpng-1.2.6.
 
3318
 
 
3319
The png_set_add_alpha() function was added at libpng-1.2.7.
 
3320
 
 
3321
The function png_set_expand_gray_1_2_4_to_8() was added at libpng-1.2.9.
 
3322
Unlike png_set_gray_1_2_4_to_8(), the new function does not expand the
 
3323
tRNS chunk to alpha. The png_set_gray_1_2_4_to_8() function is
 
3324
deprecated.
 
3325
 
 
3326
A number of macro definitions in support of runtime selection of
 
3327
assembler code features (especially Intel MMX code support) were
 
3328
added at libpng-1.2.0:
 
3329
 
 
3330
    PNG_ASM_FLAG_MMX_SUPPORT_COMPILED
 
3331
    PNG_ASM_FLAG_MMX_SUPPORT_IN_CPU
 
3332
    PNG_ASM_FLAG_MMX_READ_COMBINE_ROW
 
3333
    PNG_ASM_FLAG_MMX_READ_INTERLACE
 
3334
    PNG_ASM_FLAG_MMX_READ_FILTER_SUB
 
3335
    PNG_ASM_FLAG_MMX_READ_FILTER_UP
 
3336
    PNG_ASM_FLAG_MMX_READ_FILTER_AVG
 
3337
    PNG_ASM_FLAG_MMX_READ_FILTER_PAETH
 
3338
    PNG_ASM_FLAGS_INITIALIZED
 
3339
    PNG_MMX_READ_FLAGS
 
3340
    PNG_MMX_FLAGS
 
3341
    PNG_MMX_WRITE_FLAGS
 
3342
    PNG_MMX_FLAGS
 
3343
 
 
3344
We added the following functions in support of runtime
 
3345
selection of assembler code features:
 
3346
 
 
3347
    png_get_mmx_flagmask()
 
3348
    png_set_mmx_thresholds()
 
3349
    png_get_asm_flags()
 
3350
    png_get_mmx_bitdepth_threshold()
 
3351
    png_get_mmx_rowbytes_threshold()
 
3352
    png_set_asm_flags()
 
3353
 
 
3354
We replaced all of these functions with simple stubs in libpng-1.2.20,
 
3355
when the Intel assembler code was removed due to a licensing issue.
 
3356
 
 
3357
.SH IX.  (Omitted)
 
3358
.SH X. Y2K Compliance in libpng
 
3359
 
 
3360
May 7, 2009
3679
3361
 
3680
3362
Since the PNG Development group is an ad-hoc body, we can't make
3681
3363
an official declaration.
3682
3364
 
3683
3365
This is your unofficial assurance that libpng from version 0.71 and
3684
 
upward through 1.2.35 are Y2K compliant.  It is my belief that earlier
 
3366
upward through 1.2.36 are Y2K compliant.  It is my belief that earlier
3685
3367
versions were also Y2K compliant.
3686
3368
 
3687
3369
Libpng only has three year fields.  One is a 2-byte unsigned integer that
3943
3625
 1.2.35rc01-02       13    10235  12.so.0.35[.0]
3944
3626
 1.0.43              10    10043  10.so.0.43[.0]
3945
3627
 1.2.35              13    10235  12.so.0.35[.0]
 
3628
 1.2.36beta01-05     13    10236  12.so.0.36[.0]
 
3629
 1.2.36rc01          13    10236  12.so.0.36[.0]
 
3630
 1.0.44              10    10044  10.so.0.44[.0]
 
3631
 1.2.36              13    10236  12.so.0.36[.0]
3946
3632
 
3947
3633
Henceforth the source version will match the shared-library minor
3948
3634
and patch numbers; the shared-library major version number will be
3998
3684
 
3999
3685
Thanks to Frank J. T. Wojcik for helping with the documentation.
4000
3686
 
4001
 
Libpng version 1.2.35 - February 14, 2009:
 
3687
Libpng version 1.2.36 - May 7, 2009:
4002
3688
Initially created in 1995 by Guy Eric Schalnat, then of Group 42, Inc.
4003
3689
Currently maintained by Glenn Randers-Pehrson (glennrp at users.sourceforge.net).
4004
3690
 
4019
3705
If you modify libpng you may insert additional notices immediately following
4020
3706
this sentence.
4021
3707
 
4022
 
libpng versions 1.2.6, August 15, 2004, through 1.2.35, February 14, 2009, are
 
3708
libpng versions 1.2.6, August 15, 2004, through 1.2.36, May 7, 2009, are
4023
3709
Copyright (c) 2004,2006-2008 Glenn Randers-Pehrson, and are
4024
3710
distributed according to the same disclaimer and license as libpng-1.2.5
4025
3711
with the following individual added to the list of Contributing Authors
4118
3804
 
4119
3805
Glenn Randers-Pehrson
4120
3806
glennrp at users.sourceforge.net
4121
 
February 14, 2009
 
3807
May 7, 2009
4122
3808
 
4123
3809
.\" end of man page
4124
3810