WebSVN – Kolibri OS – Blame – /contrib/media/updf/include/png.h

Rev	Author	Line No.	Line
4680	right-hear	1
		2	*
		3	* libpng version 1.5.1 - February 3, 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.5.1 - February 3, 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 12.so.0.1.0.17rc1
		108	* 1.2.7rc1 13 10207 12.so.0.1.2.7rc1
		109	* 1.0.17 10 10017 12.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 12.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 12.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-7 13 10210 12.so.0.10[.0]
		121	* 1.2.10rc1-2 13 10210 12.so.0.10[.0]
		122	* 1.2.10 13 10210 12.so.0.10[.0]
		123	* 1.4.0beta1-5 14 10400 14.so.0.0[.0]
		124	* 1.2.11beta1-4 13 10211 12.so.0.11[.0]
		125	* 1.4.0beta7-8 14 10400 14.so.0.0[.0]
		126	* 1.2.11 13 10211 12.so.0.11[.0]
		127	* 1.2.12 13 10212 12.so.0.12[.0]
		128	* 1.4.0beta9-14 14 10400 14.so.0.0[.0]
		129	* 1.2.13 13 10213 12.so.0.13[.0]
		130	* 1.4.0beta15-36 14 10400 14.so.0.0[.0]
		131	* 1.4.0beta37-87 14 10400 14.so.14.0[.0]
		132	* 1.4.0rc01 14 10400 14.so.14.0[.0]
		133	* 1.4.0beta88-109 14 10400 14.so.14.0[.0]
		134	* 1.4.0rc02-08 14 10400 14.so.14.0[.0]
		135	* 1.4.0 14 10400 14.so.14.0[.0]
		136	* 1.4.1beta01-03 14 10401 14.so.14.1[.0]
		137	* 1.4.1rc01 14 10401 14.so.14.1[.0]
		138	* 1.4.1beta04-12 14 10401 14.so.14.1[.0]
		139	* 1.4.1 14 10401 14.so.14.1[.0]
		140	* 1.4.2 14 10402 14.so.14.2[.0]
		141	* 1.4.3 14 10403 14.so.14.3[.0]
		142	* 1.4.4 14 10404 14.so.14.4[.0]
		143	* 1.5.0beta01-58 15 10500 15.so.15.0[.0]
		144	* 1.5.0rc01-07 15 10500 15.so.15.0[.0]
		145	* 1.5.0 15 10500 15.so.15.0[.0]
		146	* 1.5.1beta01-11 15 10501 15.so.15.1[.0]
		147	* 1.5.1rc01-02 15 10501 15.so.15.1[.0]
		148	* 1.5.1 15 10501 15.so.15.1[.0]
		149	*
		150	* Henceforth the source version will match the shared-library major
		151	* and minor numbers; the shared-library major version number will be
		152	* used for changes in backward compatibility, as it is intended. The
		153	* PNG_LIBPNG_VER macro, which is not used within libpng but is available
		154	* for applications, is an unsigned integer of the form xyyzz corresponding
		155	* to the source version x.y.z (leading zeros in y and z). Beta versions
		156	* were given the previous public release number plus a letter, until
		157	* version 1.0.6j; from then on they were given the upcoming public
		158	* release number plus "betaNN" or "rcN".
		159	*
		160	* Binary incompatibility exists only when applications make direct access
		161	* to the info_ptr or png_ptr members through png.h, and the compiled
		162	* application is loaded with a different version of the library.
		163	*
		164	* DLLNUM will change each time there are forward or backward changes
		165	* in binary compatibility (e.g., when a new feature is added).
		166	*
		167	* See libpng-manual.txt or libpng.3 for more information. The PNG
		168	* specification is available as a W3C Recommendation and as an ISO
		169	* Specification,
		170	*/
		171
		172
		173	* COPYRIGHT NOTICE, DISCLAIMER, and LICENSE:
		174	*
		175	* If you modify libpng you may insert additional notices immediately following
		176	* this sentence.
		177	*
		178	* This code is released under the libpng license.
		179	*
		180	* libpng versions 1.2.6, August 15, 2004, through 1.5.1, February 3, 2011, are
		181	* Copyright (c) 2004, 2006-2011 Glenn Randers-Pehrson, and are
		182	* distributed according to the same disclaimer and license as libpng-1.2.5
		183	* with the following individual added to the list of Contributing Authors:
		184	*
		185	* Cosmin Truta
		186	*
		187	* libpng versions 1.0.7, July 1, 2000, through 1.2.5, October 3, 2002, are
		188	* Copyright (c) 2000-2002 Glenn Randers-Pehrson, and are
		189	* distributed according to the same disclaimer and license as libpng-1.0.6
		190	* with the following individuals added to the list of Contributing Authors:
		191	*
		192	* Simon-Pierre Cadieux
		193	* Eric S. Raymond
		194	* Gilles Vollant
		195	*
		196	* and with the following additions to the disclaimer:
		197	*
		198	* There is no warranty against interference with your enjoyment of the
		199	* library or against infringement. There is no warranty that our
		200	* efforts or the library will fulfill any of your particular purposes
		201	* or needs. This library is provided with all faults, and the entire
		202	* risk of satisfactory quality, performance, accuracy, and effort is with
		203	* the user.
		204	*
		205	* libpng versions 0.97, January 1998, through 1.0.6, March 20, 2000, are
		206	* Copyright (c) 1998, 1999, 2000 Glenn Randers-Pehrson, and are
		207	* distributed according to the same disclaimer and license as libpng-0.96,
		208	* with the following individuals added to the list of Contributing Authors:
		209	*
		210	* Tom Lane
		211	* Glenn Randers-Pehrson
		212	* Willem van Schaik
		213	*
		214	* libpng versions 0.89, June 1996, through 0.96, May 1997, are
		215	* Copyright (c) 1996, 1997 Andreas Dilger
		216	* Distributed according to the same disclaimer and license as libpng-0.88,
		217	* with the following individuals added to the list of Contributing Authors:
		218	*
		219	* John Bowler
		220	* Kevin Bracey
		221	* Sam Bushell
		222	* Magnus Holmgren
		223	* Greg Roelofs
		224	* Tom Tanner
		225	*
		226	* libpng versions 0.5, May 1995, through 0.88, January 1996, are
		227	* Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.
		228	*
		229	* For the purposes of this copyright and license, "Contributing Authors"
		230	* is defined as the following set of individuals:
		231	*
		232	* Andreas Dilger
		233	* Dave Martindale
		234	* Guy Eric Schalnat
		235	* Paul Schmidt
		236	* Tim Wegner
		237	*
		238	* The PNG Reference Library is supplied "AS IS". The Contributing Authors
		239	* and Group 42, Inc. disclaim all warranties, expressed or implied,
		240	* including, without limitation, the warranties of merchantability and of
		241	* fitness for any purpose. The Contributing Authors and Group 42, Inc.
		242	* assume no liability for direct, indirect, incidental, special, exemplary,
		243	* or consequential damages, which may result from the use of the PNG
		244	* Reference Library, even if advised of the possibility of such damage.
		245	*
		246	* Permission is hereby granted to use, copy, modify, and distribute this
		247	* source code, or portions hereof, for any purpose, without fee, subject
		248	* to the following restrictions:
		249	*
		250	* 1. The origin of this source code must not be misrepresented.
		251	*
		252	* 2. Altered versions must be plainly marked as such and must not
		253	* be misrepresented as being the original source.
		254	*
		255	* 3. This Copyright notice may not be removed or altered from
		256	* any source or altered source distribution.
		257	*
		258	* The Contributing Authors and Group 42, Inc. specifically permit, without
		259	* fee, and encourage the use of this source code as a component to
		260	* supporting the PNG file format in commercial products. If you use this
		261	* source code in a product, acknowledgment is not required but would be
		262	* appreciated.
		263	*/
		264
		265
		266	* A "png_get_copyright" function is available, for convenient use in "about"
		267	* boxes and the like:
		268	*
		269	* printf("%s", png_get_copyright(NULL));
		270	*
		271	* Also, the PNG logo (in PNG format, of course) is supplied in the
		272	* files "pngbar.png" and "pngbar.jpg (88x31) and "pngnow.png" (98x31).
		273	*/
		274
		275
		276	* Libpng is OSI Certified Open Source Software. OSI Certified is a
		277	* certification mark of the Open Source Initiative.
		278	*/
		279
		280
		281	* The contributing authors would like to thank all those who helped
		282	* with testing, bug fixes, and patience. This wouldn't have been
		283	* possible without all of you.
		284	*
		285	* Thanks to Frank J. T. Wojcik for helping with the documentation.
		286	*/
		287
		288
		289	* Y2K compliance in libpng:
		290	* =========================
		291	*
		292	* February 3, 2011
		293	*
		294	* Since the PNG Development group is an ad-hoc body, we can't make
		295	* an official declaration.
		296	*
		297	* This is your unofficial assurance that libpng from version 0.71 and
		298	* upward through 1.5.1 are Y2K compliant. It is my belief that
		299	* earlier versions were also Y2K compliant.
		300	*
		301	* Libpng only has three year fields. One is a 2-byte unsigned integer
		302	* that will hold years up to 65535. The other two hold the date in text
		303	* format, and will hold years up to 9999.
		304	*
		305	* The integer is
		306	* "png_uint_16 year" in png_time_struct.
		307	*
		308	* The strings are
		309	* "png_charp time_buffer" in png_struct and
		310	* "near_time_buffer", which is a local character string in png.c.
		311	*
		312	* There are seven time-related functions:
		313	* png.c: png_convert_to_rfc_1123() in png.c
		314	* (formerly png_convert_to_rfc_1152() in error)
		315	* png_convert_from_struct_tm() in pngwrite.c, called in pngwrite.c
		316	* png_convert_from_time_t() in pngwrite.c
		317	* png_get_tIME() in pngget.c
		318	* png_handle_tIME() in pngrutil.c, called in pngread.c
		319	* png_set_tIME() in pngset.c
		320	* png_write_tIME() in pngwutil.c, called in pngwrite.c
		321	*
		322	* All handle dates properly in a Y2K environment. The
		323	* png_convert_from_time_t() function calls gmtime() to convert from system
		324	* clock time, which returns (year - 1900), which we properly convert to
		325	* the full 4-digit year. There is a possibility that applications using
		326	* libpng are not passing 4-digit years into the png_convert_to_rfc_1123()
		327	* function, or that they are incorrectly passing only a 2-digit year
		328	* instead of "year - 1900" into the png_convert_from_struct_tm() function,
		329	* but this is not under our control. The libpng documentation has always
		330	* stated that it works with 4-digit years, and the APIs have been
		331	* documented as such.
		332	*
		333	* The tIME chunk itself is also Y2K compliant. It uses a 2-byte unsigned
		334	* integer to hold the year, and can hold years as large as 65535.
		335	*
		336	* zlib, upon which libpng depends, is also Y2K compliant. It contains
		337	* no date-related code.
		338	*
		339	* Glenn Randers-Pehrson
		340	* libpng maintainer
		341	* PNG Development Group
		342	*/
		343
		344
		345	#define PNG_H
		346
		347
		348	* describes how to use libpng, and the file example.c summarizes it
		349	* with some code on which to build. This file is useful for looking
		350	* at the actual function definitions and structure components.
		351	*/
		352
		353
		354	#define PNG_LIBPNG_VER_STRING "1.5.1"
		355	#define PNG_HEADER_VERSION_STRING \
		356	" libpng version 1.5.1 - February 3, 2011\n"
		357
		358
		359	#define PNG_LIBPNG_VER_DLLNUM 15
		360
		361
		362	#define PNG_LIBPNG_VER_MAJOR 1
		363	#define PNG_LIBPNG_VER_MINOR 5
		364	#define PNG_LIBPNG_VER_RELEASE 1
		365	/* This should match the numeric part of the final component of
		366	* PNG_LIBPNG_VER_STRING, omitting any leading zero:
		367	*/
		368
		369
		370
		371
		372	#define PNG_LIBPNG_BUILD_ALPHA 1
		373	#define PNG_LIBPNG_BUILD_BETA 2
		374	#define PNG_LIBPNG_BUILD_RC 3
		375	#define PNG_LIBPNG_BUILD_STABLE 4
		376	#define PNG_LIBPNG_BUILD_RELEASE_STATUS_MASK 7
		377
		378
		379	#define PNG_LIBPNG_BUILD_PATCH 8 /* Can be OR'ed with
		380	PNG_LIBPNG_BUILD_STABLE only */
		381	#define PNG_LIBPNG_BUILD_PRIVATE 16 /* Cannot be OR'ed with
		382	PNG_LIBPNG_BUILD_SPECIAL */
		383	#define PNG_LIBPNG_BUILD_SPECIAL 32 /* Cannot be OR'ed with
		384	PNG_LIBPNG_BUILD_PRIVATE */
		385
		386
		387
		388
		389	* We must not include leading zeros.
		390	* Versions 0.7 through 1.0.0 were in the range 0 to 100 here (only
		391	* version 1.0.0 was mis-numbered 100 instead of 10000). From
		392	* version 1.0.1 it's xxyyzz, where x=major, y=minor, z=release
		393	*/
		394	#define PNG_LIBPNG_VER 10501 /* 1.5.1 */
		395
		396
		397	* the library has been built.
		398	*/
		399	#ifndef PNGLCONF_H
		400	/* If pnglibconf.h is missing, you can
		401	* copy scripts/pnglibconf.h.prebuilt to pnglibconf.h
		402	*/
		403	# include "pnglibconf.h"
		404	#endif
		405
		406
		407	/* Standard header files (not needed for the version info) */
		408	# ifdef PNG_SETJMP_SUPPORTED
		409	# include
		410	# endif
		411
		412
		413	* defines struct tm:
		414	*/
		415	#ifdef PNG_CONVERT_tIME_SUPPORTED
		416	/* "time.h" functions are not supported on all operating systems */
		417	# include
		418	#endif
		419
		420
		421	# include "pngconf.h"
		422	#endif
		423
		424
		425	* Added at libpng-1.2.8
		426	*
		427	* Ref MSDN: Private as priority over Special
		428	* VS_FF_PRIVATEBUILD File was not built using standard release
		429	* procedures. If this value is given, the StringFileInfo block must
		430	* contain a PrivateBuild string.
		431	*
		432	* VS_FF_SPECIALBUILD File was built by the original company using
		433	* standard release procedures but is a variation of the standard
		434	* file of the same version number. If this value is given, the
		435	* StringFileInfo block must contain a SpecialBuild string.
		436	*/
		437
		438
		439	# define PNG_LIBPNG_BUILD_TYPE \
		440	(PNG_LIBPNG_BUILD_BASE_TYPE \| PNG_LIBPNG_BUILD_PRIVATE)
		441	#else
		442	# ifdef PNG_LIBPNG_SPECIALBUILD
		443	# define PNG_LIBPNG_BUILD_TYPE \
		444	(PNG_LIBPNG_BUILD_BASE_TYPE \| PNG_LIBPNG_BUILD_SPECIAL)
		445	# else
		446	# define PNG_LIBPNG_BUILD_TYPE (PNG_LIBPNG_BUILD_BASE_TYPE)
		447	# endif
		448	#endif
		449
		450
		451
		452
		453	#ifdef __cplusplus
		454	extern "C" {
		455	#endif /* __cplusplus */
		456
		457
		458	* the version above.
		459	*/
		460	#define png_libpng_ver png_get_header_ver(NULL)
		461
		462
		463	*
		464	* 1. Any configuration options that can be specified by for the application
		465	* code when it is built. (Build time configuration is in pnglibconf.h)
		466	* 2. Type definitions (base types are defined in pngconf.h), structure
		467	* definitions.
		468	* 3. Exported library functions.
		469	*
		470	* The library source code has additional files (principally pngpriv.h) that
		471	* allow configuration of the library.
		472	*/
		473	/* Section 1: run time configuration
		474	* See pnglibconf.h for build time configuration
		475	*
		476	* Run time configuration allows the application to choose between
		477	* implementations of certain arithmetic APIs. The default is set
		478	* at build time and recorded in pnglibconf.h, but it is safe to
		479	* override these (and only these) settings. Note that this won't
		480	* change what the library does, only application code, and the
		481	* settings can (and probably should) be made on a per-file basis
		482	* by setting the #defines before including png.h
		483	*
		484	* Use macros to read integers from PNG data or use the exported
		485	* functions?
		486	* PNG_USE_READ_MACROS: use the macros (see below) Note that
		487	* the macros evaluate their argument multiple times.
		488	* PNG_NO_USE_READ_MACROS: call the relevant library function.
		489	*
		490	* Use the alternative algorithm for compositing alpha samples that
		491	* does not use division?
		492	* PNG_READ_COMPOSITE_NODIV_SUPPORTED: use the 'no division'
		493	* algorithm.
		494	* PNG_NO_READ_COMPOSITE_NODIV: use the 'division' algorithm.
		495	*
		496	* How to handle benign errors if PNG_ALLOW_BENIGN_ERRORS is
		497	* false?
		498	* PNG_ALLOW_BENIGN_ERRORS: map calls to the benign error
		499	* APIs to png_warning.
		500	* Otherwise the calls are mapped to png_error.
		501	*/
		502
		503
		504	* constants.
		505	* See pngconf.h for base types that vary by machine/system
		506	*/
		507
		508
		509	* do not agree upon the version number.
		510	*/
		511	typedef char* png_libpng_version_1_5_1;
		512
		513
		514	* exact size) is not important, although the size of the fields need to
		515	* be png_byte or png_uint_16 (as defined below).
		516	*/
		517	typedef struct png_color_struct
		518	{
		519	png_byte red;
		520	png_byte green;
		521	png_byte blue;
		522	} png_color;
		523	typedef png_color FAR * png_colorp;
		524	typedef PNG_CONST png_color FAR * png_const_colorp;
		525	typedef png_color FAR * FAR * png_colorpp;
		526
		527
		528	{
		529	png_byte index; /* used for palette files */
		530	png_uint_16 red; /* for use in red green blue files */
		531	png_uint_16 green;
		532	png_uint_16 blue;
		533	png_uint_16 gray; /* for use in grayscale files */
		534	} png_color_16;
		535	typedef png_color_16 FAR * png_color_16p;
		536	typedef PNG_CONST png_color_16 FAR * png_const_color_16p;
		537	typedef png_color_16 FAR * FAR * png_color_16pp;
		538
		539
		540	{
		541	png_byte red; /* for use in red green blue files */
		542	png_byte green;
		543	png_byte blue;
		544	png_byte gray; /* for use in grayscale files */
		545	png_byte alpha; /* for alpha channel files */
		546	} png_color_8;
		547	typedef png_color_8 FAR * png_color_8p;
		548	typedef PNG_CONST png_color_8 FAR * png_const_color_8p;
		549	typedef png_color_8 FAR * FAR * png_color_8pp;
		550
		551
		552	* The following two structures are used for the in-core representation
		553	* of sPLT chunks.
		554	*/
		555	typedef struct png_sPLT_entry_struct
		556	{
		557	png_uint_16 red;
		558	png_uint_16 green;
		559	png_uint_16 blue;
		560	png_uint_16 alpha;
		561	png_uint_16 frequency;
		562	} png_sPLT_entry;
		563	typedef png_sPLT_entry FAR * png_sPLT_entryp;
		564	typedef PNG_CONST png_sPLT_entry FAR * png_const_sPLT_entryp;
		565	typedef png_sPLT_entry FAR * FAR * png_sPLT_entrypp;
		566
		567
		568	* occupy the LSB of their respective members, and the MSB of each member
		569	* is zero-filled. The frequency member always occupies the full 16 bits.
		570	*/
		571
		572
		573	{
		574	png_charp name; /* palette name */
		575	png_byte depth; /* depth of palette samples */
		576	png_sPLT_entryp entries; /* palette entries */
		577	png_int_32 nentries; /* number of palette entries */
		578	} png_sPLT_t;
		579	typedef png_sPLT_t FAR * png_sPLT_tp;
		580	typedef PNG_CONST png_sPLT_t FAR * png_const_sPLT_tp;
		581	typedef png_sPLT_t FAR * FAR * png_sPLT_tpp;
		582
		583
		584	/* png_text holds the contents of a text/ztxt/itxt chunk in a PNG file,
		585	* and whether that contents is compressed or not. The "key" field
		586	* points to a regular zero-terminated C string. The "text", "lang", and
		587	* "lang_key" fields can be regular C strings, empty strings, or NULL pointers.
		588	* However, the * structure returned by png_get_text() will always contain
		589	* regular zero-terminated C strings (possibly empty), never NULL pointers,
		590	* so they can be safely used in printf() and other string-handling functions.
		591	*/
		592	typedef struct png_text_struct
		593	{
		594	int compression; /* compression value:
		595	-1: tEXt, none
		596	0: zTXt, deflate
		597	1: iTXt, none
		598	2: iTXt, deflate */
		599	png_charp key; /* keyword, 1-79 character description of "text" */
		600	png_charp text; /* comment, may be an empty string (ie "")
		601	or a NULL pointer */
		602	png_size_t text_length; /* length of the text string */
		603	png_size_t itxt_length; /* length of the itxt string */
		604	png_charp lang; /* language code, 0-79 characters
		605	or a NULL pointer */
		606	png_charp lang_key; /* keyword translated UTF-8 string, 0 or more
		607	chars or a NULL pointer */
		608	} png_text;
		609	typedef png_text FAR * png_textp;
		610	typedef PNG_CONST png_text FAR * png_const_textp;
		611	typedef png_text FAR * FAR * png_textpp;
		612	#endif
		613
		614
		615	* The values of the PNG_TEXT_COMPRESSION_ defines should NOT be changed. */
		616	#define PNG_TEXT_COMPRESSION_NONE_WR -3
		617	#define PNG_TEXT_COMPRESSION_zTXt_WR -2
		618	#define PNG_TEXT_COMPRESSION_NONE -1
		619	#define PNG_TEXT_COMPRESSION_zTXt 0
		620	#define PNG_ITXT_COMPRESSION_NONE 1
		621	#define PNG_ITXT_COMPRESSION_zTXt 2
		622	#define PNG_TEXT_COMPRESSION_LAST 3 /* Not a valid value */
		623
		624
		625	* Two conversions are provided, both from time_t and struct tm. There
		626	* is no portable way to convert to either of these structures, as far
		627	* as I know. If you know of a portable way, send it to me. As a side
		628	* note - PNG has always been Year 2000 compliant!
		629	*/
		630	typedef struct png_time_struct
		631	{
		632	png_uint_16 year; /* full year, as in, 1995 */
		633	png_byte month; /* month of year, 1 - 12 */
		634	png_byte day; /* day of month, 1 - 31 */
		635	png_byte hour; /* hour of day, 0 - 23 */
		636	png_byte minute; /* minute of hour, 0 - 59 */
		637	png_byte second; /* second of minute, 0 - 60 (for leap seconds) */
		638	} png_time;
		639	typedef png_time FAR * png_timep;
		640	typedef PNG_CONST png_time FAR * png_const_timep;
		641	typedef png_time FAR * FAR * png_timepp;
		642
		643
		644	defined(PNG_HANDLE_AS_UNKNOWN_SUPPORTED)
		645	/* png_unknown_chunk is a structure to hold queued chunks for which there is
		646	* no specific support. The idea is that we can use this to queue
		647	* up private chunks for output even though the library doesn't actually
		648	* know about their semantics.
		649	*/
		650	typedef struct png_unknown_chunk_t
		651	{
		652	png_byte name[5];
		653	png_byte *data;
		654	png_size_t size;
		655
		656
		657	png_byte location; /* mode of operation at read time */
		658	}
		659	png_unknown_chunk;
		660	typedef png_unknown_chunk FAR * png_unknown_chunkp;
		661	typedef PNG_CONST png_unknown_chunk FAR * png_const_unknown_chunkp;
		662	typedef png_unknown_chunk FAR * FAR * png_unknown_chunkpp;
		663	#endif
		664
		665
		666	typedef png_info FAR * png_infop;
		667	typedef PNG_CONST png_info FAR * png_const_infop;
		668	typedef png_info FAR * FAR * png_infopp;
		669
		670
		671	#define PNG_UINT_31_MAX ((png_uint_32)0x7fffffffL)
		672	#define PNG_UINT_32_MAX ((png_uint_32)(-1))
		673	#define PNG_SIZE_MAX ((png_size_t)(-1))
		674
		675
		676	* PNG specification manner (x100000)
		677	*/
		678	#define PNG_FP_1 100000
		679	#define PNG_FP_HALF 50000
		680
		681
		682	/* color type masks */
		683	#define PNG_COLOR_MASK_PALETTE 1
		684	#define PNG_COLOR_MASK_COLOR 2
		685	#define PNG_COLOR_MASK_ALPHA 4
		686
		687
		688	#define PNG_COLOR_TYPE_GRAY 0
		689	#define PNG_COLOR_TYPE_PALETTE (PNG_COLOR_MASK_COLOR \| PNG_COLOR_MASK_PALETTE)
		690	#define PNG_COLOR_TYPE_RGB (PNG_COLOR_MASK_COLOR)
		691	#define PNG_COLOR_TYPE_RGB_ALPHA (PNG_COLOR_MASK_COLOR \| PNG_COLOR_MASK_ALPHA)
		692	#define PNG_COLOR_TYPE_GRAY_ALPHA (PNG_COLOR_MASK_ALPHA)
		693	/* aliases */
		694	#define PNG_COLOR_TYPE_RGBA PNG_COLOR_TYPE_RGB_ALPHA
		695	#define PNG_COLOR_TYPE_GA PNG_COLOR_TYPE_GRAY_ALPHA
		696
		697
		698	#define PNG_COMPRESSION_TYPE_BASE 0 /* Deflate method 8, 32K window */
		699	#define PNG_COMPRESSION_TYPE_DEFAULT PNG_COMPRESSION_TYPE_BASE
		700
		701
		702	#define PNG_FILTER_TYPE_BASE 0 /* Single row per-byte filtering */
		703	#define PNG_INTRAPIXEL_DIFFERENCING 64 /* Used only in MNG datastreams */
		704	#define PNG_FILTER_TYPE_DEFAULT PNG_FILTER_TYPE_BASE
		705
		706
		707	#define PNG_INTERLACE_NONE 0 /* Non-interlaced image */
		708	#define PNG_INTERLACE_ADAM7 1 /* Adam7 interlacing */
		709	#define PNG_INTERLACE_LAST 2 /* Not a valid value */
		710
		711
		712	#define PNG_OFFSET_PIXEL 0 /* Offset in pixels */
		713	#define PNG_OFFSET_MICROMETER 1 /* Offset in micrometers (1/10^6 meter) */
		714	#define PNG_OFFSET_LAST 2 /* Not a valid value */
		715
		716
		717	#define PNG_EQUATION_LINEAR 0 /* Linear transformation */
		718	#define PNG_EQUATION_BASE_E 1 /* Exponential base e transform */
		719	#define PNG_EQUATION_ARBITRARY 2 /* Arbitrary base exponential transform */
		720	#define PNG_EQUATION_HYPERBOLIC 3 /* Hyperbolic sine transformation */
		721	#define PNG_EQUATION_LAST 4 /* Not a valid value */
		722
		723
		724	#define PNG_SCALE_UNKNOWN 0 /* unknown unit (image scale) */
		725	#define PNG_SCALE_METER 1 /* meters per pixel */
		726	#define PNG_SCALE_RADIAN 2 /* radians per pixel */
		727	#define PNG_SCALE_LAST 3 /* Not a valid value */
		728
		729
		730	#define PNG_RESOLUTION_UNKNOWN 0 /* pixels/unknown unit (aspect ratio) */
		731	#define PNG_RESOLUTION_METER 1 /* pixels/meter */
		732	#define PNG_RESOLUTION_LAST 2 /* Not a valid value */
		733
		734
		735	#define PNG_sRGB_INTENT_PERCEPTUAL 0
		736	#define PNG_sRGB_INTENT_RELATIVE 1
		737	#define PNG_sRGB_INTENT_SATURATION 2
		738	#define PNG_sRGB_INTENT_ABSOLUTE 3
		739	#define PNG_sRGB_INTENT_LAST 4 /* Not a valid value */
		740
		741
		742	#define PNG_KEYWORD_MAX_LENGTH 79
		743
		744
		745	#define PNG_MAX_PALETTE_LENGTH 256
		746
		747
		748	* from the PNG header, or if the application has filled in the corresponding
		749	* data in the info_struct to be written into the output file. The values
		750	* of the PNG_INFO_ defines should NOT be changed.
		751	*/
		752	#define PNG_INFO_gAMA 0x0001
		753	#define PNG_INFO_sBIT 0x0002
		754	#define PNG_INFO_cHRM 0x0004
		755	#define PNG_INFO_PLTE 0x0008
		756	#define PNG_INFO_tRNS 0x0010
		757	#define PNG_INFO_bKGD 0x0020
		758	#define PNG_INFO_hIST 0x0040
		759	#define PNG_INFO_pHYs 0x0080
		760	#define PNG_INFO_oFFs 0x0100
		761	#define PNG_INFO_tIME 0x0200
		762	#define PNG_INFO_pCAL 0x0400
		763	#define PNG_INFO_sRGB 0x0800 /* GR-P, 0.96a */
		764	#define PNG_INFO_iCCP 0x1000 /* ESR, 1.0.6 */
		765	#define PNG_INFO_sPLT 0x2000 /* ESR, 1.0.6 */
		766	#define PNG_INFO_sCAL 0x4000 /* ESR, 1.0.6 */
		767	#define PNG_INFO_IDAT 0x8000L /* ESR, 1.0.6 */
		768
		769
		770	* change these values for the row. It also should enable using
		771	* the routines for other purposes.
		772	*/
		773	typedef struct png_row_info_struct
		774	{
		775	png_uint_32 width; /* width of row */
		776	png_size_t rowbytes; /* number of bytes in row */
		777	png_byte color_type; /* color type of row */
		778	png_byte bit_depth; /* bit depth of row */
		779	png_byte channels; /* number of channels (1, 2, 3, or 4) */
		780	png_byte pixel_depth; /* bits per pixel (depth * channels) */
		781	} png_row_info;
		782
		783
		784	typedef png_row_info FAR * FAR * png_row_infopp;
		785
		786
		787	* that allow the user to override the default I/O functions with his or her
		788	* own. The png_error_ptr type should match that of user-supplied warning
		789	* and error functions, while the png_rw_ptr type should match that of the
		790	* user read/write data functions. Note that the 'write' function must not
		791	* modify the buffer it is passed. The 'read' function, on the other hand, is
		792	* expected to return the read data in the buffer.
		793	*/
		794	typedef struct png_struct_def png_struct;
		795	typedef PNG_CONST png_struct FAR * png_const_structp;
		796	typedef png_struct FAR * png_structp;
		797
		798
		799	typedef PNG_CALLBACK(void, *png_rw_ptr, (png_structp, png_bytep, png_size_t), );
		800	typedef PNG_CALLBACK(void, *png_flush_ptr, (png_structp), );
		801	typedef PNG_CALLBACK(void, *png_read_status_ptr, (png_structp, png_uint_32,
		802	int), );
		803	typedef PNG_CALLBACK(void, *png_write_status_ptr, (png_structp, png_uint_32,
		804	int), );
		805
		806
		807	typedef PNG_CALLBACK(void, *png_progressive_info_ptr,
		808	(png_structp, png_infop), );
		809	typedef PNG_CALLBACK(void, *png_progressive_end_ptr,
		810	(png_structp, png_infop), );
		811	typedef PNG_CALLBACK(void, *png_progressive_row_ptr,
		812	(png_structp, png_bytep, png_uint_32, int), );
		813	#endif
		814
		815
		816	defined(PNG_WRITE_USER_TRANSFORM_SUPPORTED)
		817	typedef PNG_CALLBACK(void, *png_user_transform_ptr,
		818	(png_structp, png_row_infop, png_bytep), );
		819	#endif
		820
		821
		822	typedef PNG_CALLBACK(int, *png_user_chunk_ptr, (png_structp,
		823	png_unknown_chunkp), );
		824	#endif
		825	#ifdef PNG_UNKNOWN_CHUNKS_SUPPORTED
		826	typedef PNG_CALLBACK(void, *png_unknown_chunk_ptr, (png_structp), );
		827	#endif
		828
		829
		830	/* This must match the function definition in , and the
		831	* application must include this before png.h to obtain the definition
		832	* of jmp_buf. The function is required to be PNG_NORETURN. (Note that
		833	* PNG_PTR_NORETURN is used here because current versions of the Microsoft
		834	* C compiler do not support the PNG_NORETURN attribute on a pointer.)
		835	*
		836	* If you get a type warning from the compiler when linking against this line
		837	* then your compiler has 'longjmp' that does not match the requirements of the
		838	* compiler that built libpng. You will have to write a wrapper function for
		839	* your compiler's longjmp and call png_set_longjmp_fn directly (not via the
		840	* png_jmpbuf macro.)
		841	*
		842	* If you get a warning here while building the library you will need to make
		843	* changes to ensure that pnglibconf.h records the calling convention used by
		844	* your compiler. This may be very difficult - try using a different compiler
		845	* to build the library!
		846	*/
		847	typedef PNG_FUNCTION(void, (PNGCAPI *png_longjmp_ptr), PNGARG((jmp_buf, int)),
		848	PNG_PTR_NORETURN);
		849	#endif
		850
		851
		852	#define PNG_TRANSFORM_IDENTITY 0x0000 /* read and write */
		853	#define PNG_TRANSFORM_STRIP_16 0x0001 /* read only */
		854	#define PNG_TRANSFORM_STRIP_ALPHA 0x0002 /* read only */
		855	#define PNG_TRANSFORM_PACKING 0x0004 /* read and write */
		856	#define PNG_TRANSFORM_PACKSWAP 0x0008 /* read and write */
		857	#define PNG_TRANSFORM_EXPAND 0x0010 /* read only */
		858	#define PNG_TRANSFORM_INVERT_MONO 0x0020 /* read and write */
		859	#define PNG_TRANSFORM_SHIFT 0x0040 /* read and write */
		860	#define PNG_TRANSFORM_BGR 0x0080 /* read and write */
		861	#define PNG_TRANSFORM_SWAP_ALPHA 0x0100 /* read and write */
		862	#define PNG_TRANSFORM_SWAP_ENDIAN 0x0200 /* read and write */
		863	#define PNG_TRANSFORM_INVERT_ALPHA 0x0400 /* read and write */
		864	#define PNG_TRANSFORM_STRIP_FILLER 0x0800 /* write only */
		865	/* Added to libpng-1.2.34 */
		866	#define PNG_TRANSFORM_STRIP_FILLER_BEFORE PNG_TRANSFORM_STRIP_FILLER
		867	#define PNG_TRANSFORM_STRIP_FILLER_AFTER 0x1000 /* write only */
		868	/* Added to libpng-1.4.0 */
		869	#define PNG_TRANSFORM_GRAY_TO_RGB 0x2000 /* read only */
		870
		871
		872	#define PNG_FLAG_MNG_EMPTY_PLTE 0x01
		873	#define PNG_FLAG_MNG_FILTER_64 0x04
		874	#define PNG_ALL_MNG_FEATURES 0x05
		875
		876
		877	* this allowed the zlib default functions to be used on Windows
		878	* platforms. In 1.5 the zlib default malloc (which just calls malloc and
		879	* ignores the first argument) should be completely compatible with the
		880	* following.
		881	*/
		882	typedef PNG_CALLBACK(png_voidp, *png_malloc_ptr, (png_structp,
		883	png_alloc_size_t), );
		884	typedef PNG_CALLBACK(void, *png_free_ptr, (png_structp, png_voidp), );
		885
		886
		887
		888
		889	* Here are the function definitions most commonly used. This is not
		890	* the place to find out how to use libpng. See libpng-manual.txt for the
		891	* full explanation, see example.c for the summary. This just provides
		892	* a simple one line description of the use of each function.
		893	*
		894	* The PNG_EXPORT() and PNG_EXPORTA() macros used below are defined in
		895	* pngconf.h and in the *.dfn files in the scripts directory.
		896	*
		897	* PNG_EXPORT(ordinal, type, name, (args));
		898	*
		899	* ordinal: ordinal that is used while building
		900	* *.def files. The ordinal value is only
		901	* relevant when preprocessing png.h with
		902	* the *.dfn files for building symbol table
		903	* entries, and are removed by pngconf.h.
		904	* type: return type of the function
		905	* name: function name
		906	* args: function arguments, with types
		907	*
		908	* When we wish to append attributes to a function prototype we use
		909	* the PNG_EXPORTA() macro instead.
		910	*
		911	* PNG_EXPORTA(ordinal, type, name, (args), attributes);
		912	*
		913	* ordinal, type, name, and args: same as in PNG_EXPORT().
		914	* attributes: function attributes
		915	*/
		916
		917
		918	PNG_EXPORT(1, png_uint_32, png_access_version_number, (void));
		919
		920
		921	* Handling more than 8 bytes from the beginning of the file is an error.
		922	*/
		923	PNG_EXPORT(2, void, png_set_sig_bytes, (png_structp png_ptr, int num_bytes));
		924
		925
		926	* PNG file. Returns zero if the supplied bytes match the 8-byte PNG
		927	* signature, and non-zero otherwise. Having num_to_check == 0 or
		928	* start > 7 will always fail (ie return non-zero).
		929	*/
		930	PNG_EXPORT(3, int, png_sig_cmp, (png_const_bytep sig, png_size_t start,
		931	png_size_t num_to_check));
		932
		933
		934	* png_check_sig(sig, n) := !png_sig_cmp(sig, 0, n).
		935	*/
		936	#define png_check_sig(sig, n) !png_sig_cmp((sig), 0, (n))
		937
		938
		939	PNG_EXPORTA(4, png_structp, png_create_read_struct,
		940	(png_const_charp user_png_ver, png_voidp error_ptr,
		941	png_error_ptr error_fn, png_error_ptr warn_fn),
		942	PNG_ALLOCATED);
		943
		944
		945	PNG_EXPORTA(5, png_structp, png_create_write_struct,
		946	(png_const_charp user_png_ver, png_voidp error_ptr, png_error_ptr error_fn,
		947	png_error_ptr warn_fn),
		948	PNG_ALLOCATED);
		949
		950
		951	(png_const_structp png_ptr));
		952
		953
		954	png_size_t size));
		955
		956
		957	* match up.
		958	*/
		959	#ifdef PNG_SETJMP_SUPPORTED
		960	/* This function returns the jmp_buf built in to *png_ptr. It must be
		961	* supplied with an appropriate 'longjmp' function to use on that jmp_buf
		962	* unless the default error function is overridden in which case NULL is
		963	* acceptable. The size of the jmp_buf is checked against the actual size
		964	* allocated by the library - the call will return NULL on a mismatch
		965	* indicating an ABI mismatch.
		966	*/
		967	PNG_EXPORT(8, jmp_buf*, png_set_longjmp_fn, (png_structp png_ptr,
		968	png_longjmp_ptr longjmp_fn, size_t jmp_buf_size));
		969	# define png_jmpbuf(png_ptr) \
		970	(*png_set_longjmp_fn((png_ptr), longjmp, sizeof (jmp_buf)))
		971	#else
		972	# define png_jmpbuf(png_ptr) \
		973	(LIBPNG_WAS_COMPILED_WITH__PNG_NO_SETJMP)
		974	#endif
		975	/* This function should be used by libpng applications in place of
		976	* longjmp(png_ptr->jmpbuf, val). If longjmp_fn() has been set, it
		977	* will use it; otherwise it will call PNG_ABORT(). This function was
		978	* added in libpng-1.5.0.
		979	*/
		980	PNG_EXPORTA(9, void, png_longjmp, (png_structp png_ptr, int val),
		981	PNG_NORETURN);
		982
		983
		984	/* Reset the compression stream */
		985	PNG_EXPORT(10, int, png_reset_zstream, (png_structp png_ptr));
		986	#endif
		987
		988
		989	#ifdef PNG_USER_MEM_SUPPORTED
		990	PNG_EXPORTA(11, png_structp, png_create_read_struct_2,
		991	(png_const_charp user_png_ver, png_voidp error_ptr, png_error_ptr error_fn,
		992	png_error_ptr warn_fn,
		993	png_voidp mem_ptr, png_malloc_ptr malloc_fn, png_free_ptr free_fn),
		994	PNG_ALLOCATED);
		995	PNG_EXPORTA(12, png_structp, png_create_write_struct_2,
		996	(png_const_charp user_png_ver, png_voidp error_ptr, png_error_ptr error_fn,
		997	png_error_ptr warn_fn,
		998	png_voidp mem_ptr, png_malloc_ptr malloc_fn, png_free_ptr free_fn),
		999	PNG_ALLOCATED);
		1000	#endif
		1001
		1002
		1003	PNG_EXPORT(13, void, png_write_sig, (png_structp png_ptr));
		1004
		1005
		1006	PNG_EXPORT(14, void, png_write_chunk, (png_structp png_ptr, png_const_bytep
		1007	chunk_name, png_const_bytep data, png_size_t length));
		1008
		1009
		1010	PNG_EXPORT(15, void, png_write_chunk_start, (png_structp png_ptr,
		1011	png_const_bytep chunk_name, png_uint_32 length));
		1012
		1013
		1014	PNG_EXPORT(16, void, png_write_chunk_data, (png_structp png_ptr,
		1015	png_const_bytep data, png_size_t length));
		1016
		1017
		1018	PNG_EXPORT(17, void, png_write_chunk_end, (png_structp png_ptr));
		1019
		1020
		1021	PNG_EXPORTA(18, png_infop, png_create_info_struct, (png_structp png_ptr),
		1022	PNG_ALLOCATED);
		1023
		1024
		1025	png_size_t png_info_struct_size));
		1026
		1027
		1028	PNG_EXPORT(20, void, png_write_info_before_PLTE,
		1029	(png_structp png_ptr, png_infop info_ptr));
		1030	PNG_EXPORT(21, void, png_write_info,
		1031	(png_structp png_ptr, png_infop info_ptr));
		1032
		1033
		1034	/* Read the information before the actual image data. */
		1035	PNG_EXPORT(22, void, png_read_info,
		1036	(png_structp png_ptr, png_infop info_ptr));
		1037	#endif
		1038
		1039
		1040	PNG_EXPORT(23, png_const_charp, png_convert_to_rfc1123,
		1041	(png_structp png_ptr,
		1042	png_const_timep ptime));
		1043	#endif
		1044
		1045
		1046	/* Convert from a struct tm to png_time */
		1047	PNG_EXPORT(24, void, png_convert_from_struct_tm, (png_timep ptime,
		1048	PNG_CONST struct tm FAR * ttime));
		1049
		1050
		1051	PNG_EXPORT(25, void, png_convert_from_time_t,
		1052	(png_timep ptime, time_t ttime));
		1053	#endif /* PNG_CONVERT_tIME_SUPPORTED */
		1054
		1055
		1056	/* Expand data to 24-bit RGB, or 8-bit grayscale, with alpha if available. */
		1057	PNG_EXPORT(26, void, png_set_expand, (png_structp png_ptr));
		1058	PNG_EXPORT(27, void, png_set_expand_gray_1_2_4_to_8, (png_structp png_ptr));
		1059	PNG_EXPORT(28, void, png_set_palette_to_rgb, (png_structp png_ptr));
		1060	PNG_EXPORT(29, void, png_set_tRNS_to_alpha, (png_structp png_ptr));
		1061	#endif
		1062
		1063
		1064	/* Use blue, green, red order for pixels. */
		1065	PNG_EXPORT(30, void, png_set_bgr, (png_structp png_ptr));
		1066	#endif
		1067
		1068
		1069	/* Expand the grayscale to 24-bit RGB if necessary. */
		1070	PNG_EXPORT(31, void, png_set_gray_to_rgb, (png_structp png_ptr));
		1071	#endif
		1072
		1073
		1074	/* Reduce RGB to grayscale. */
		1075	PNG_FP_EXPORT(32, void, png_set_rgb_to_gray, (png_structp png_ptr,
		1076	int error_action, double red, double green));
		1077	PNG_FIXED_EXPORT(33, void, png_set_rgb_to_gray_fixed, (png_structp png_ptr,
		1078	int error_action, png_fixed_point red, png_fixed_point green));
		1079
		1080
		1081	png_ptr));
		1082	#endif
		1083
		1084
		1085	png_colorp palette));
		1086
		1087
		1088	PNG_EXPORT(36, void, png_set_strip_alpha, (png_structp png_ptr));
		1089	#endif
		1090
		1091
		1092	defined(PNG_WRITE_SWAP_ALPHA_SUPPORTED)
		1093	PNG_EXPORT(37, void, png_set_swap_alpha, (png_structp png_ptr));
		1094	#endif
		1095
		1096
		1097	defined(PNG_WRITE_INVERT_ALPHA_SUPPORTED)
		1098	PNG_EXPORT(38, void, png_set_invert_alpha, (png_structp png_ptr));
		1099	#endif
		1100
		1101
		1102	/* Add a filler byte to 8-bit Gray or 24-bit RGB images. */
		1103	PNG_EXPORT(39, void, png_set_filler, (png_structp png_ptr, png_uint_32 filler,
		1104	int flags));
		1105	/* The values of the PNG_FILLER_ defines should NOT be changed */
		1106	# define PNG_FILLER_BEFORE 0
		1107	# define PNG_FILLER_AFTER 1
		1108	/* Add an alpha byte to 8-bit Gray or 24-bit RGB images. */
		1109	PNG_EXPORT(40, void, png_set_add_alpha,
		1110	(png_structp png_ptr, png_uint_32 filler,
		1111	int flags));
		1112	#endif /* PNG_READ_FILLER_SUPPORTED \|\| PNG_WRITE_FILLER_SUPPORTED */
		1113
		1114
		1115	/* Swap bytes in 16-bit depth files. */
		1116	PNG_EXPORT(41, void, png_set_swap, (png_structp png_ptr));
		1117	#endif
		1118
		1119
		1120	/* Use 1 byte per pixel in 1, 2, or 4-bit depth files. */
		1121	PNG_EXPORT(42, void, png_set_packing, (png_structp png_ptr));
		1122	#endif
		1123
		1124
		1125	defined(PNG_WRITE_PACKSWAP_SUPPORTED)
		1126	/* Swap packing order of pixels in bytes. */
		1127	PNG_EXPORT(43, void, png_set_packswap, (png_structp png_ptr));
		1128	#endif
		1129
		1130
		1131	/* Converts files to legal bit depths. */
		1132	PNG_EXPORT(44, void, png_set_shift, (png_structp png_ptr, png_const_color_8p
		1133	true_bits));
		1134	#endif
		1135
		1136
		1137	defined(PNG_WRITE_INTERLACING_SUPPORTED)
		1138	/* Have the code handle the interlacing. Returns the number of passes.
		1139	* MUST be called before png_read_update_info or png_start_read_image,
		1140	* otherwise it will not have the desired effect. Note that it is still
		1141	* necessary to call png_read_row or png_read_rows png_get_image_height
		1142	* times for each pass.
		1143	*/
		1144	PNG_EXPORT(45, int, png_set_interlace_handling, (png_structp png_ptr));
		1145	#endif
		1146
		1147
		1148	/* Invert monochrome files */
		1149	PNG_EXPORT(46, void, png_set_invert_mono, (png_structp png_ptr));
		1150	#endif
		1151
		1152
		1153	/* Handle alpha and tRNS by replacing with a background color. */
		1154	PNG_FP_EXPORT(47, void, png_set_background, (png_structp png_ptr,
		1155	png_const_color_16p background_color, int background_gamma_code,
		1156	int need_expand, double background_gamma));
		1157	PNG_FIXED_EXPORT(215, void, png_set_background_fixed, (png_structp png_ptr,
		1158	png_const_color_16p background_color, int background_gamma_code,
		1159	int need_expand, png_fixed_point background_gamma));
		1160	#endif
		1161	#ifdef PNG_READ_BACKGROUND_SUPPORTED
		1162	# define PNG_BACKGROUND_GAMMA_UNKNOWN 0
		1163	# define PNG_BACKGROUND_GAMMA_SCREEN 1
		1164	# define PNG_BACKGROUND_GAMMA_FILE 2
		1165	# define PNG_BACKGROUND_GAMMA_UNIQUE 3
		1166	#endif
		1167
		1168
		1169	/* Strip the second byte of information from a 16-bit depth file. */
		1170	PNG_EXPORT(48, void, png_set_strip_16, (png_structp png_ptr));
		1171	#endif
		1172
		1173
		1174	/* Turn on quantizing, and reduce the palette to the number of colors
		1175	* available.
		1176	*/
		1177	PNG_EXPORT(49, void, png_set_quantize,
		1178	(png_structp png_ptr, png_colorp palette,
		1179	int num_palette, int maximum_colors, png_const_uint_16p histogram,
		1180	int full_quantize));
		1181	#endif
		1182
		1183
		1184	/* The threshold on gamma processing is configurable but hard-wired into the
		1185	* library. The following is the floating point variant.
		1186	*/
		1187	#define PNG_GAMMA_THRESHOLD (PNG_GAMMA_THRESHOLD_FIXED*.00001)
		1188
		1189
		1190	PNG_FP_EXPORT(50, void, png_set_gamma,
		1191	(png_structp png_ptr, double screen_gamma,
		1192	double default_file_gamma));
		1193	PNG_FIXED_EXPORT(208, void, png_set_gamma_fixed, (png_structp png_ptr,
		1194	png_fixed_point screen_gamma, png_fixed_point default_file_gamma));
		1195	#endif
		1196
		1197
		1198	/* Set how many lines between output flushes - 0 for no flushing */
		1199	PNG_EXPORT(51, void, png_set_flush, (png_structp png_ptr, int nrows));
		1200	/* Flush the current PNG output buffer */
		1201	PNG_EXPORT(52, void, png_write_flush, (png_structp png_ptr));
		1202	#endif
		1203
		1204
		1205	PNG_EXPORT(53, void, png_start_read_image, (png_structp png_ptr));
		1206
		1207
		1208	PNG_EXPORT(54, void, png_read_update_info,
		1209	(png_structp png_ptr, png_infop info_ptr));
		1210
		1211
		1212	/* Read one or more rows of image data. */
		1213	PNG_EXPORT(55, void, png_read_rows, (png_structp png_ptr, png_bytepp row,
		1214	png_bytepp display_row, png_uint_32 num_rows));
		1215	#endif
		1216
		1217
		1218	/* Read a row of data. */
		1219	PNG_EXPORT(56, void, png_read_row, (png_structp png_ptr, png_bytep row,
		1220	png_bytep display_row));
		1221	#endif
		1222
		1223
		1224	/* Read the whole image into memory at once. */
		1225	PNG_EXPORT(57, void, png_read_image, (png_structp png_ptr, png_bytepp image));
		1226	#endif
		1227
		1228
		1229	PNG_EXPORT(58, void, png_write_row,
		1230	(png_structp png_ptr, png_const_bytep row));
		1231
		1232
		1233	* is declared as writeable to maintain compatibility with previous versions
		1234	* of libpng and to allow the 'display_row' array from read_rows to be passed
		1235	* unchanged to write_rows.
		1236	*/
		1237	PNG_EXPORT(59, void, png_write_rows, (png_structp png_ptr, png_bytepp row,
		1238	png_uint_32 num_rows));
		1239
		1240
		1241	PNG_EXPORT(60, void, png_write_image,
		1242	(png_structp png_ptr, png_bytepp image));
		1243
		1244
		1245	PNG_EXPORT(61, void, png_write_end,
		1246	(png_structp png_ptr, png_infop info_ptr));
		1247
		1248
		1249	/* Read the end of the PNG file. */
		1250	PNG_EXPORT(62, void, png_read_end, (png_structp png_ptr, png_infop info_ptr));
		1251	#endif
		1252
		1253
		1254	PNG_EXPORT(63, void, png_destroy_info_struct, (png_structp png_ptr,
		1255	png_infopp info_ptr_ptr));
		1256
		1257
		1258	PNG_EXPORT(64, void, png_destroy_read_struct, (png_structpp png_ptr_ptr,
		1259	png_infopp info_ptr_ptr, png_infopp end_info_ptr_ptr));
		1260
		1261
		1262	PNG_EXPORT(65, void, png_destroy_write_struct, (png_structpp png_ptr_ptr,
		1263	png_infopp info_ptr_ptr));
		1264
		1265
		1266	PNG_EXPORT(66, void, png_set_crc_action,
		1267	(png_structp png_ptr, int crit_action, int ancil_action));
		1268
		1269
		1270	* ancillary and critical chunks, and whether to use the data contained
		1271	* therein. Note that it is impossible to "discard" data in a critical
		1272	* chunk. For versions prior to 0.90, the action was always error/quit,
		1273	* whereas in version 0.90 and later, the action for CRC errors in ancillary
		1274	* chunks is warn/discard. These values should NOT be changed.
		1275	*
		1276	* value action:critical action:ancillary
		1277	*/
		1278	#define PNG_CRC_DEFAULT 0 /* error/quit warn/discard data */
		1279	#define PNG_CRC_ERROR_QUIT 1 /* error/quit error/quit */
		1280	#define PNG_CRC_WARN_DISCARD 2 /* (INVALID) warn/discard data */
		1281	#define PNG_CRC_WARN_USE 3 /* warn/use data warn/use data */
		1282	#define PNG_CRC_QUIET_USE 4 /* quiet/use data quiet/use data */
		1283	#define PNG_CRC_NO_CHANGE 5 /* use current value use current value */
		1284
		1285
		1286	* libpng and the compression methods used by zlib. These functions are
		1287	* mainly useful for testing, as the defaults should work with most users.
		1288	* Those users who are tight on memory or want faster performance at the
		1289	* expense of compression can modify them. See the compression library
		1290	* header file (zlib.h) for an explination of the compression functions.
		1291	*/
		1292
		1293
		1294	* value for "method" is 0.
		1295	*/
		1296	PNG_EXPORT(67, void, png_set_filter,
		1297	(png_structp png_ptr, int method, int filters));
		1298
		1299
		1300	* are chosen so that they don't conflict with real filter types
		1301	* below, in case they are supplied instead of the #defined constants.
		1302	* These values should NOT be changed.
		1303	*/
		1304	#define PNG_NO_FILTERS 0x00
		1305	#define PNG_FILTER_NONE 0x08
		1306	#define PNG_FILTER_SUB 0x10
		1307	#define PNG_FILTER_UP 0x20
		1308	#define PNG_FILTER_AVG 0x40
		1309	#define PNG_FILTER_PAETH 0x80
		1310	#define PNG_ALL_FILTERS (PNG_FILTER_NONE \| PNG_FILTER_SUB \| PNG_FILTER_UP \| \
		1311	PNG_FILTER_AVG \| PNG_FILTER_PAETH)
		1312
		1313
		1314	* These defines should NOT be changed.
		1315	*/
		1316	#define PNG_FILTER_VALUE_NONE 0
		1317	#define PNG_FILTER_VALUE_SUB 1
		1318	#define PNG_FILTER_VALUE_UP 2
		1319	#define PNG_FILTER_VALUE_AVG 3
		1320	#define PNG_FILTER_VALUE_PAETH 4
		1321	#define PNG_FILTER_VALUE_LAST 5
		1322
		1323
		1324	/* The "heuristic_method" is given by one of the PNG_FILTER_HEURISTIC_
		1325	* defines, either the default (minimum-sum-of-absolute-differences), or
		1326	* the experimental method (weighted-minimum-sum-of-absolute-differences).
		1327	*
		1328	* Weights are factors >= 1.0, indicating how important it is to keep the
		1329	* filter type consistent between rows. Larger numbers mean the current
		1330	* filter is that many times as likely to be the same as the "num_weights"
		1331	* previous filters. This is cumulative for each previous row with a weight.
		1332	* There needs to be "num_weights" values in "filter_weights", or it can be
		1333	* NULL if the weights aren't being specified. Weights have no influence on
		1334	* the selection of the first row filter. Well chosen weights can (in theory)
		1335	* improve the compression for a given image.
		1336	*
		1337	* Costs are factors >= 1.0 indicating the relative decoding costs of a
		1338	* filter type. Higher costs indicate more decoding expense, and are
		1339	* therefore less likely to be selected over a filter with lower computational
		1340	* costs. There needs to be a value in "filter_costs" for each valid filter
		1341	* type (given by PNG_FILTER_VALUE_LAST), or it can be NULL if you aren't
		1342	* setting the costs. Costs try to improve the speed of decompression without
		1343	* unduly increasing the compressed image size.
		1344	*
		1345	* A negative weight or cost indicates the default value is to be used, and
		1346	* values in the range [0.0, 1.0) indicate the value is to remain unchanged.
		1347	* The default values for both weights and costs are currently 1.0, but may
		1348	* change if good general weighting/cost heuristics can be found. If both
		1349	* the weights and costs are set to 1.0, this degenerates the WEIGHTED method
		1350	* to the UNWEIGHTED method, but with added encoding time/computation.
		1351	*/
		1352	PNG_FP_EXPORT(68, void, png_set_filter_heuristics, (png_structp png_ptr,
		1353	int heuristic_method, int num_weights, png_const_doublep filter_weights,
		1354	png_const_doublep filter_costs));
		1355	PNG_FIXED_EXPORT(209, void, png_set_filter_heuristics_fixed,
		1356	(png_structp png_ptr,
		1357	int heuristic_method, int num_weights, png_const_fixed_point_p
		1358	filter_weights, png_const_fixed_point_p filter_costs));
		1359	#endif /* PNG_WRITE_WEIGHTED_FILTER_SUPPORTED */
		1360
		1361
		1362	* changed.
		1363	*/
		1364	#define PNG_FILTER_HEURISTIC_DEFAULT 0 /* Currently "UNWEIGHTED" */
		1365	#define PNG_FILTER_HEURISTIC_UNWEIGHTED 1 /* Used by libpng < 0.95 */
		1366	#define PNG_FILTER_HEURISTIC_WEIGHTED 2 /* Experimental feature */
		1367	#define PNG_FILTER_HEURISTIC_LAST 3 /* Not a valid value */
		1368
		1369
		1370	* 0 - 9, corresponding directly to the zlib compression levels 0 - 9
		1371	* (0 - no compression, 9 - "maximal" compression). Note that tests have
		1372	* shown that zlib compression levels 3-6 usually perform as well as level 9
		1373	* for PNG images, and do considerably fewer caclulations. In the future,
		1374	* these values may not correspond directly to the zlib compression levels.
		1375	*/
		1376	PNG_EXPORT(69, void, png_set_compression_level,
		1377	(png_structp png_ptr, int level));
		1378
		1379
		1380	int mem_level));
		1381
		1382
		1383	int strategy));
		1384
		1385
		1386	int window_bits));
		1387
		1388
		1389	int method));
		1390
		1391
		1392	* handling. They are in the file pngrio.c, pngwio.c, and pngerror.c,
		1393	* and call standard C I/O routines such as fread(), fwrite(), and
		1394	* fprintf(). These functions can be made to use other I/O routines
		1395	* at run time for those applications that need to handle I/O in a
		1396	* different manner by calling png_set_???_fn(). See libpng-manual.txt for
		1397	* more information.
		1398	*/
		1399
		1400
		1401	/* Initialize the input/output for the PNG file to the default functions. */
		1402	PNG_EXPORT(74, void, png_init_io, (png_structp png_ptr, png_FILE_p fp));
		1403	#endif
		1404
		1405
		1406	* supplied functions. If no messages are to be printed you must still
		1407	* write and use replacement functions. The replacement error_fn should
		1408	* still do a longjmp to the last setjmp location if you are using this
		1409	* method of error handling. If error_fn or warning_fn is NULL, the
		1410	* default function will be used.
		1411	*/
		1412
		1413
		1414	(png_structp png_ptr, png_voidp error_ptr,
		1415	png_error_ptr error_fn, png_error_ptr warning_fn));
		1416
		1417
		1418	PNG_EXPORT(76, png_voidp, png_get_error_ptr, (png_const_structp png_ptr));
		1419
		1420
		1421	* If buffered output is not used, then output_flush_fn can be set to NULL.
		1422	* If PNG_WRITE_FLUSH_SUPPORTED is not defined at libpng compile time
		1423	* output_flush_fn will be ignored (and thus can be NULL).
		1424	* It is probably a mistake to use NULL for output_flush_fn if
		1425	* write_data_fn is not also NULL unless you have built libpng with
		1426	* PNG_WRITE_FLUSH_SUPPORTED undefined, because in this case libpng's
		1427	* default flush function, which uses the standard *FILE structure, will
		1428	* be used.
		1429	*/
		1430	PNG_EXPORT(77, void, png_set_write_fn, (png_structp png_ptr, png_voidp io_ptr,
		1431	png_rw_ptr write_data_fn, png_flush_ptr output_flush_fn));
		1432
		1433
		1434	PNG_EXPORT(78, void, png_set_read_fn, (png_structp png_ptr, png_voidp io_ptr,
		1435	png_rw_ptr read_data_fn));
		1436
		1437
		1438	PNG_EXPORT(79, png_voidp, png_get_io_ptr, (png_structp png_ptr));
		1439
		1440
		1441	png_read_status_ptr read_row_fn));
		1442
		1443
		1444	png_write_status_ptr write_row_fn));
		1445
		1446
		1447	/* Replace the default memory allocation functions with user supplied one(s). */
		1448	PNG_EXPORT(82, void, png_set_mem_fn, (png_structp png_ptr, png_voidp mem_ptr,
		1449	png_malloc_ptr malloc_fn, png_free_ptr free_fn));
		1450	/* Return the user pointer associated with the memory functions */
		1451	PNG_EXPORT(83, png_voidp, png_get_mem_ptr, (png_const_structp png_ptr));
		1452	#endif
		1453
		1454
		1455	PNG_EXPORT(84, void, png_set_read_user_transform_fn, (png_structp png_ptr,
		1456	png_user_transform_ptr read_user_transform_fn));
		1457	#endif
		1458
		1459
		1460	PNG_EXPORT(85, void, png_set_write_user_transform_fn, (png_structp png_ptr,
		1461	png_user_transform_ptr write_user_transform_fn));
		1462	#endif
		1463
		1464
		1465	PNG_EXPORT(86, void, png_set_user_transform_info, (png_structp png_ptr,
		1466	png_voidp user_transform_ptr, int user_transform_depth,
		1467	int user_transform_channels));
		1468	/* Return the user pointer associated with the user transform functions */
		1469	PNG_EXPORT(87, png_voidp, png_get_user_transform_ptr,
		1470	(png_const_structp png_ptr));
		1471	#endif
		1472
		1473
		1474	/* Return information about the row currently being processed. Note that these
		1475	* APIs do not fail but will return unexpected results if called outside a user
		1476	* transform callback. Also note that when transforming an interlaced image the
		1477	* row number is still the row in the final, de-interlaced, image but the row
		1478	* only contains the data of the current pass - consult png_row_info for the
		1479	* actual width of the row!
		1480	*/
		1481	PNG_EXPORT(217, png_uint_32, png_get_current_row_number, (png_const_structp));
		1482	PNG_EXPORT(218, png_byte, png_get_current_pass_number, (png_const_structp));
		1483	#endif
		1484
		1485
		1486	PNG_EXPORT(88, void, png_set_read_user_chunk_fn, (png_structp png_ptr,
		1487	png_voidp user_chunk_ptr, png_user_chunk_ptr read_user_chunk_fn));
		1488	PNG_EXPORT(89, png_voidp, png_get_user_chunk_ptr, (png_const_structp png_ptr));
		1489	#endif
		1490
		1491
		1492	/* Sets the function callbacks for the push reader, and a pointer to a
		1493	* user-defined structure available to the callback functions.
		1494	*/
		1495	PNG_EXPORT(90, void, png_set_progressive_read_fn, (png_structp png_ptr,
		1496	png_voidp progressive_ptr, png_progressive_info_ptr info_fn,
		1497	png_progressive_row_ptr row_fn, png_progressive_end_ptr end_fn));
		1498
		1499
		1500	PNG_EXPORT(91, png_voidp, png_get_progressive_ptr, (png_const_structp png_ptr));
		1501
		1502
		1503	PNG_EXPORT(92, void, png_process_data,
		1504	(png_structp png_ptr, png_infop info_ptr,
		1505	png_bytep buffer, png_size_t buffer_size));
		1506
		1507
		1508	* processing of any more data. The function returns the number of bytes
		1509	* remaining, excluding any that libpng has cached internally. A subsequent
		1510	* call to png_process_data must supply these bytes again. If the argument
		1511	* 'save' is set to true the routine will first save all the pending data and
		1512	* will always return 0.
		1513	*/
		1514	PNG_EXPORT(219, png_size_t, png_process_data_pause, (png_structp, int save));
		1515
		1516
		1517	* png_process_data. It returns the number of bytes of data to skip in the
		1518	* input. Normally it will return 0, but if it returns a non-zero value the
		1519	* application must skip than number of bytes of input data and pass the
		1520	* following data to the next call to png_process_data.
		1521	*/
		1522	PNG_EXPORT(220, png_uint_32, png_process_data_skip, (png_structp));
		1523
		1524
		1525	* the callback and be non-NULL if anything needs to be done; the library
		1526	* stores its own version of the new data internally and ignores the passed
		1527	* in value.
		1528	*/
		1529	PNG_EXPORT(93, void, png_progressive_combine_row, (png_structp png_ptr,
		1530	png_bytep old_row, png_const_bytep new_row));
		1531	#endif /* PNG_PROGRESSIVE_READ_SUPPORTED */
		1532
		1533
		1534	(png_structp png_ptr, png_alloc_size_t size),
		1535	PNG_ALLOCATED);
		1536	/* Added at libpng version 1.4.0 */
		1537	PNG_EXPORTA(95, png_voidp, png_calloc,
		1538	(png_structp png_ptr, png_alloc_size_t size),
		1539	PNG_ALLOCATED);
		1540
		1541
		1542	PNG_EXPORTA(96, png_voidp, png_malloc_warn, (png_structp png_ptr,
		1543	png_alloc_size_t size), PNG_ALLOCATED);
		1544
		1545
		1546	PNG_EXPORT(97, void, png_free, (png_structp png_ptr, png_voidp ptr));
		1547
		1548
		1549	PNG_EXPORT(98, void, png_free_data,
		1550	(png_structp png_ptr, png_infop info_ptr, png_uint_32 free_me, int num));
		1551
		1552
		1553	* by libpng or by the application */
		1554	PNG_EXPORT(99, void, png_data_freer,
		1555	(png_structp png_ptr, png_infop info_ptr, int freer, png_uint_32 mask));
		1556
		1557
		1558	#define PNG_DESTROY_WILL_FREE_DATA 1
		1559	#define PNG_SET_WILL_FREE_DATA 1
		1560	#define PNG_USER_WILL_FREE_DATA 2
		1561	/* Flags for png_ptr->free_me and info_ptr->free_me */
		1562	#define PNG_FREE_HIST 0x0008
		1563	#define PNG_FREE_ICCP 0x0010
		1564	#define PNG_FREE_SPLT 0x0020
		1565	#define PNG_FREE_ROWS 0x0040
		1566	#define PNG_FREE_PCAL 0x0080
		1567	#define PNG_FREE_SCAL 0x0100
		1568	#define PNG_FREE_UNKN 0x0200
		1569	#define PNG_FREE_LIST 0x0400
		1570	#define PNG_FREE_PLTE 0x1000
		1571	#define PNG_FREE_TRNS 0x2000
		1572	#define PNG_FREE_TEXT 0x4000
		1573	#define PNG_FREE_ALL 0x7fff
		1574	#define PNG_FREE_MUL 0x4220 /* PNG_FREE_SPLT\|PNG_FREE_TEXT\|PNG_FREE_UNKN */
		1575
		1576
		1577	PNG_EXPORTA(100, png_voidp, png_malloc_default, (png_structp png_ptr,
		1578	png_alloc_size_t size), PNG_ALLOCATED);
		1579	PNG_EXPORT(101, void, png_free_default, (png_structp png_ptr, png_voidp ptr));
		1580	#endif
		1581
		1582
		1583	/* Fatal error in PNG image of libpng - can't continue */
		1584	PNG_EXPORTA(102, void, png_error,
		1585	(png_structp png_ptr, png_const_charp error_message),
		1586	PNG_NORETURN);
		1587
		1588
		1589	PNG_EXPORTA(103, void, png_chunk_error, (png_structp png_ptr,
		1590	png_const_charp error_message), PNG_NORETURN);
		1591
		1592
		1593	/* Fatal error in PNG image of libpng - can't continue */
		1594	PNG_EXPORTA(104, void, png_err, (png_structp png_ptr), PNG_NORETURN);
		1595	#endif
		1596
		1597
		1598	PNG_EXPORT(105, void, png_warning, (png_structp png_ptr,
		1599	png_const_charp warning_message));
		1600
		1601
		1602	PNG_EXPORT(106, void, png_chunk_warning, (png_structp png_ptr,
		1603	png_const_charp warning_message));
		1604
		1605
		1606	/* Benign error in libpng. Can continue, but may have a problem.
		1607	* User can choose whether to handle as a fatal error or as a warning. */
		1608	# undef png_benign_error
		1609	PNG_EXPORT(107, void, png_benign_error, (png_structp png_ptr,
		1610	png_const_charp warning_message));
		1611
		1612
		1613	# undef png_chunk_benign_error
		1614	PNG_EXPORT(108, void, png_chunk_benign_error, (png_structp png_ptr,
		1615	png_const_charp warning_message));
		1616
		1617
		1618	(png_structp png_ptr, int allowed));
		1619	#else
		1620	# ifdef PNG_ALLOW_BENIGN_ERRORS
		1621	# define png_benign_error png_warning
		1622	# define png_chunk_benign_error png_chunk_warning
		1623	# else
		1624	# define png_benign_error png_error
		1625	# define png_chunk_benign_error png_chunk_error
		1626	# endif
		1627	#endif
		1628
		1629
		1630	* Similarly, the png_get_ calls are used to read values from the
		1631	* png_info_struct, either storing the parameters in the passed variables, or
		1632	* setting pointers into the png_info_struct where the data is stored. The
		1633	* png_get_ functions return a non-zero value if the data was available
		1634	* in info_ptr, or return zero and do not change any of the parameters if the
		1635	* data was not available.
		1636	*
		1637	* These functions should be used instead of directly accessing png_info
		1638	* to avoid problems with future changes in the size and internal layout of
		1639	* png_info_struct.
		1640	*/
		1641	/* Returns "flag" if chunk data is valid in info_ptr. */
		1642	PNG_EXPORT(110, png_uint_32, png_get_valid,
		1643	(png_const_structp png_ptr, png_const_infop info_ptr,
		1644	png_uint_32 flag));
		1645
		1646
		1647	PNG_EXPORT(111, png_size_t, png_get_rowbytes, (png_const_structp png_ptr,
		1648	png_const_infop info_ptr));
		1649
		1650
		1651	/* Returns row_pointers, which is an array of pointers to scanlines that was
		1652	* returned from png_read_png().
		1653	*/
		1654	PNG_EXPORT(112, png_bytepp, png_get_rows,
		1655	(png_const_structp png_ptr, png_const_infop info_ptr));
		1656	/* Set row_pointers, which is an array of pointers to scanlines for use
		1657	* by png_write_png().
		1658	*/
		1659	PNG_EXPORT(113, void, png_set_rows, (png_structp png_ptr,
		1660	png_infop info_ptr, png_bytepp row_pointers));
		1661	#endif
		1662
		1663
		1664	PNG_EXPORT(114, png_byte, png_get_channels,
		1665	(png_const_structp png_ptr, png_const_infop info_ptr));
		1666
		1667
		1668	/* Returns image width in pixels. */
		1669	PNG_EXPORT(115, png_uint_32, png_get_image_width, (png_const_structp png_ptr,
		1670	png_const_infop info_ptr));
		1671
		1672
		1673	PNG_EXPORT(116, png_uint_32, png_get_image_height, (png_const_structp png_ptr,
		1674	png_const_infop info_ptr));
		1675
		1676
		1677	PNG_EXPORT(117, png_byte, png_get_bit_depth,
		1678	(png_const_structp png_ptr, png_const_infop info_ptr));
		1679
		1680
		1681	PNG_EXPORT(118, png_byte, png_get_color_type, (png_const_structp png_ptr,
		1682	png_const_infop info_ptr));
		1683
		1684
		1685	PNG_EXPORT(119, png_byte, png_get_filter_type, (png_const_structp png_ptr,
		1686	png_const_infop info_ptr));
		1687
		1688
		1689	PNG_EXPORT(120, png_byte, png_get_interlace_type, (png_const_structp png_ptr,
		1690	png_const_infop info_ptr));
		1691
		1692
		1693	PNG_EXPORT(121, png_byte, png_get_compression_type, (png_const_structp png_ptr,
		1694	png_const_infop info_ptr));
		1695
		1696
		1697	PNG_EXPORT(122, png_uint_32, png_get_pixels_per_meter,
		1698	(png_const_structp png_ptr, png_const_infop info_ptr));
		1699	PNG_EXPORT(123, png_uint_32, png_get_x_pixels_per_meter,
		1700	(png_const_structp png_ptr, png_const_infop info_ptr));
		1701	PNG_EXPORT(124, png_uint_32, png_get_y_pixels_per_meter,
		1702	(png_const_structp png_ptr, png_const_infop info_ptr));
		1703
		1704
		1705	PNG_FP_EXPORT(125, float, png_get_pixel_aspect_ratio,
		1706	(png_const_structp png_ptr, png_const_infop info_ptr));
		1707	PNG_FIXED_EXPORT(210, png_fixed_point, png_get_pixel_aspect_ratio_fixed,
		1708	(png_const_structp png_ptr, png_const_infop info_ptr));
		1709
		1710
		1711	PNG_EXPORT(126, png_int_32, png_get_x_offset_pixels,
		1712	(png_const_structp png_ptr, png_const_infop info_ptr));
		1713	PNG_EXPORT(127, png_int_32, png_get_y_offset_pixels,
		1714	(png_const_structp png_ptr, png_const_infop info_ptr));
		1715	PNG_EXPORT(128, png_int_32, png_get_x_offset_microns,
		1716	(png_const_structp png_ptr, png_const_infop info_ptr));
		1717	PNG_EXPORT(129, png_int_32, png_get_y_offset_microns,
		1718	(png_const_structp png_ptr, png_const_infop info_ptr));
		1719
		1720
		1721
		1722
		1723	PNG_EXPORT(130, png_const_bytep, png_get_signature,
		1724	(png_const_structp png_ptr, png_infop info_ptr));
		1725
		1726
		1727	PNG_EXPORT(131, png_uint_32, png_get_bKGD,
		1728	(png_const_structp png_ptr, png_infop info_ptr,
		1729	png_color_16p *background));
		1730	#endif
		1731
		1732
		1733	PNG_EXPORT(132, void, png_set_bKGD, (png_structp png_ptr, png_infop info_ptr,
		1734	png_const_color_16p background));
		1735	#endif
		1736
		1737
		1738	PNG_FP_EXPORT(133, png_uint_32, png_get_cHRM, (png_const_structp png_ptr,
		1739	png_const_infop info_ptr, double white_x, double white_y, double *red_x,
		1740	double red_y, double green_x, double green_y, double blue_x,
		1741	double *blue_y));
		1742	#ifdef PNG_FIXED_POINT_SUPPORTED /* Otherwise not implemented */
		1743	PNG_FIXED_EXPORT(134, png_uint_32, png_get_cHRM_fixed,
		1744	(png_const_structp png_ptr,
		1745	png_const_infop info_ptr, png_fixed_point *int_white_x,
		1746	png_fixed_point int_white_y, png_fixed_point int_red_x,
		1747	png_fixed_point int_red_y, png_fixed_point int_green_x,
		1748	png_fixed_point int_green_y, png_fixed_point int_blue_x,
		1749	png_fixed_point *int_blue_y));
		1750	#endif
		1751	#endif
		1752
		1753
		1754	PNG_FP_EXPORT(135, void, png_set_cHRM,
		1755	(png_structp png_ptr, png_infop info_ptr,
		1756	double white_x, double white_y, double red_x, double red_y, double green_x,
		1757	double green_y, double blue_x, double blue_y));
		1758	PNG_FIXED_EXPORT(136, void, png_set_cHRM_fixed, (png_structp png_ptr,
		1759	png_infop info_ptr, png_fixed_point int_white_x,
		1760	png_fixed_point int_white_y, png_fixed_point int_red_x,
		1761	png_fixed_point int_red_y, png_fixed_point int_green_x,
		1762	png_fixed_point int_green_y, png_fixed_point int_blue_x,
		1763	png_fixed_point int_blue_y));
		1764	#endif
		1765
		1766
		1767	PNG_FP_EXPORT(137, png_uint_32, png_get_gAMA,
		1768	(png_const_structp png_ptr, png_const_infop info_ptr,
		1769	double *file_gamma));
		1770	PNG_FIXED_EXPORT(138, png_uint_32, png_get_gAMA_fixed,
		1771	(png_const_structp png_ptr, png_const_infop info_ptr,
		1772	png_fixed_point *int_file_gamma));
		1773	#endif
		1774
		1775
		1776	PNG_FP_EXPORT(139, void, png_set_gAMA, (png_structp png_ptr,
		1777	png_infop info_ptr, double file_gamma));
		1778	PNG_FIXED_EXPORT(140, void, png_set_gAMA_fixed, (png_structp png_ptr,
		1779	png_infop info_ptr, png_fixed_point int_file_gamma));
		1780	#endif
		1781
		1782
		1783	PNG_EXPORT(141, png_uint_32, png_get_hIST,
		1784	(png_const_structp png_ptr, png_const_infop info_ptr,
		1785	png_uint_16p *hist));
		1786	#endif
		1787
		1788
		1789	PNG_EXPORT(142, void, png_set_hIST, (png_structp png_ptr,
		1790	png_infop info_ptr, png_const_uint_16p hist));
		1791	#endif
		1792
		1793
		1794	(png_structp png_ptr, png_infop info_ptr,
		1795	png_uint_32 width, png_uint_32 height, int bit_depth, int color_type,
		1796	int interlace_method, int compression_method, int *filter_method));
		1797
		1798
		1799	(png_structp png_ptr, png_infop info_ptr,
		1800	png_uint_32 width, png_uint_32 height, int bit_depth, int color_type,
		1801	int interlace_method, int compression_method, int filter_method));
		1802
		1803
		1804	PNG_EXPORT(145, png_uint_32, png_get_oFFs,
		1805	(png_const_structp png_ptr, png_const_infop info_ptr,
		1806	png_int_32 offset_x, png_int_32 offset_y, int *unit_type));
		1807	#endif
		1808
		1809
		1810	PNG_EXPORT(146, void, png_set_oFFs,
		1811	(png_structp png_ptr, png_infop info_ptr,
		1812	png_int_32 offset_x, png_int_32 offset_y, int unit_type));
		1813	#endif
		1814
		1815
		1816	PNG_EXPORT(147, png_uint_32, png_get_pCAL,
		1817	(png_const_structp png_ptr, png_const_infop info_ptr,
		1818	png_charp purpose, png_int_32 X0, png_int_32 X1, int type,
		1819	int *nparams,
		1820	png_charp units, png_charpp params));
		1821	#endif
		1822
		1823
		1824	PNG_EXPORT(148, void, png_set_pCAL, (png_structp png_ptr,
		1825	png_infop info_ptr,
		1826	png_const_charp purpose, png_int_32 X0, png_int_32 X1, int type,
		1827	int nparams, png_const_charp units, png_charpp params));
		1828	#endif
		1829
		1830
		1831	PNG_EXPORT(149, png_uint_32, png_get_pHYs,
		1832	(png_const_structp png_ptr, png_const_infop info_ptr,
		1833	png_uint_32 res_x, png_uint_32 res_y, int *unit_type));
		1834	#endif
		1835
		1836
		1837	PNG_EXPORT(150, void, png_set_pHYs,
		1838	(png_structp png_ptr, png_infop info_ptr,
		1839	png_uint_32 res_x, png_uint_32 res_y, int unit_type));
		1840	#endif
		1841
		1842
		1843	(png_const_structp png_ptr, png_const_infop info_ptr,
		1844	png_colorp palette, int num_palette));
		1845
		1846
		1847	(png_structp png_ptr, png_infop info_ptr,
		1848	png_const_colorp palette, int num_palette));
		1849
		1850
		1851	PNG_EXPORT(153, png_uint_32, png_get_sBIT,
		1852	(png_const_structp png_ptr, png_infop info_ptr,
		1853	png_color_8p *sig_bit));
		1854	#endif
		1855
		1856
		1857	PNG_EXPORT(154, void, png_set_sBIT,
		1858	(png_structp png_ptr, png_infop info_ptr, png_const_color_8p sig_bit));
		1859	#endif
		1860
		1861
		1862	PNG_EXPORT(155, png_uint_32, png_get_sRGB, (png_const_structp png_ptr,
		1863	png_const_infop info_ptr, int *file_srgb_intent));
		1864	#endif
		1865
		1866
		1867	PNG_EXPORT(156, void, png_set_sRGB,
		1868	(png_structp png_ptr, png_infop info_ptr, int srgb_intent));
		1869	PNG_EXPORT(157, void, png_set_sRGB_gAMA_and_cHRM, (png_structp png_ptr,
		1870	png_infop info_ptr, int srgb_intent));
		1871	#endif
		1872
		1873
		1874	PNG_EXPORT(158, png_uint_32, png_get_iCCP,
		1875	(png_const_structp png_ptr, png_const_infop info_ptr,
		1876	png_charpp name, int *compression_type, png_bytepp profile,
		1877	png_uint_32 *proflen));
		1878	#endif
		1879
		1880
		1881	PNG_EXPORT(159, void, png_set_iCCP,
		1882	(png_structp png_ptr, png_infop info_ptr,
		1883	png_const_charp name, int compression_type, png_const_bytep profile,
		1884	png_uint_32 proflen));
		1885	#endif
		1886
		1887
		1888	PNG_EXPORT(160, png_uint_32, png_get_sPLT,
		1889	(png_const_structp png_ptr, png_const_infop info_ptr,
		1890	png_sPLT_tpp entries));
		1891	#endif
		1892
		1893
		1894	PNG_EXPORT(161, void, png_set_sPLT,
		1895	(png_structp png_ptr, png_infop info_ptr,
		1896	png_const_sPLT_tp entries, int nentries));
		1897	#endif
		1898
		1899
		1900	/* png_get_text also returns the number of text chunks in num_text /
		1901	PNG_EXPORT(162, png_uint_32, png_get_text,
		1902	(png_const_structp png_ptr, png_const_infop info_ptr,
		1903	png_textp text_ptr, int num_text));
		1904	#endif
		1905
		1906
		1907	* language, and translated keywords are NULL pointers, the structure
		1908	* returned by png_get_text will always contain regular
		1909	* zero-terminated C strings. They might be empty strings but
		1910	* they will never be NULL pointers.
		1911	*/
		1912
		1913
		1914	PNG_EXPORT(163, void, png_set_text,
		1915	(png_structp png_ptr, png_infop info_ptr,
		1916	png_const_textp text_ptr, int num_text));
		1917	#endif
		1918
		1919
		1920	PNG_EXPORT(164, png_uint_32, png_get_tIME,
		1921	(png_const_structp png_ptr, png_infop info_ptr, png_timep *mod_time));
		1922	#endif
		1923
		1924
		1925	PNG_EXPORT(165, void, png_set_tIME,
		1926	(png_structp png_ptr, png_infop info_ptr, png_const_timep mod_time));
		1927	#endif
		1928
		1929
		1930	PNG_EXPORT(166, png_uint_32, png_get_tRNS,
		1931	(png_const_structp png_ptr, png_infop info_ptr,
		1932	png_bytep trans_alpha, int num_trans, png_color_16p *trans_color));
		1933	#endif
		1934
		1935
		1936	PNG_EXPORT(167, void, png_set_tRNS,
		1937	(png_structp png_ptr, png_infop info_ptr,
		1938	png_const_bytep trans_alpha, int num_trans,
		1939	png_const_color_16p trans_color));
		1940	#endif
		1941
		1942
		1943	PNG_FP_EXPORT(168, png_uint_32, png_get_sCAL,
		1944	(png_const_structp png_ptr, png_const_infop info_ptr,
		1945	int unit, double width, double *height));
		1946	#ifdef PNG_FLOATING_ARITHMETIC_SUPPORTED
		1947	/* NOTE: this API is currently implemented using floating point arithmetic,
		1948	* consequently it can only be used on systems with floating point support.
		1949	* In any case the range of values supported by png_fixed_point is small and it
		1950	* is highly recommended that png_get_sCAL_s be used instead.
		1951	*/
		1952	PNG_FIXED_EXPORT(214, png_uint_32, png_get_sCAL_fixed,
		1953	(png_structp png_ptr, png_const_infop info_ptr, int *unit,
		1954	png_fixed_point *width,
		1955	png_fixed_point *height));
		1956	#endif
		1957	PNG_EXPORT(169, png_uint_32, png_get_sCAL_s,
		1958	(png_const_structp png_ptr, png_const_infop info_ptr,
		1959	int *unit, png_charpp swidth, png_charpp sheight));
		1960
		1961
		1962	(png_structp png_ptr, png_infop info_ptr,
		1963	int unit, double width, double height));
		1964	PNG_FIXED_EXPORT(213, void, png_set_sCAL_fixed, (png_structp png_ptr,
		1965	png_infop info_ptr, int unit, png_fixed_point width,
		1966	png_fixed_point height));
		1967	PNG_EXPORT(171, void, png_set_sCAL_s,
		1968	(png_structp png_ptr, png_infop info_ptr,
		1969	int unit, png_const_charp swidth, png_const_charp sheight));
		1970	#endif /* PNG_sCAL_SUPPORTED */
		1971
		1972
		1973	/* Provide a list of chunks and how they are to be handled, if the built-in
		1974	handling or default unknown chunk handling is not desired. Any chunks not
		1975	listed will be handled in the default manner. The IHDR and IEND chunks
		1976	must not be listed.
		1977	keep = 0: follow default behaviour
		1978	= 1: do not keep
		1979	= 2: keep only if safe-to-copy
		1980	= 3: keep even if unsafe-to-copy
		1981	*/
		1982	PNG_EXPORT(172, void, png_set_keep_unknown_chunks,
		1983	(png_structp png_ptr, int keep,
		1984	png_const_bytep chunk_list, int num_chunks));
		1985	PNG_EXPORT(173, int, png_handle_as_unknown, (png_structp png_ptr,
		1986	png_const_bytep chunk_name));
		1987	#endif
		1988	#ifdef PNG_UNKNOWN_CHUNKS_SUPPORTED
		1989	PNG_EXPORT(174, void, png_set_unknown_chunks, (png_structp png_ptr,
		1990	png_infop info_ptr, png_const_unknown_chunkp unknowns,
		1991	int num_unknowns));
		1992	PNG_EXPORT(175, void, png_set_unknown_chunk_location,
		1993	(png_structp png_ptr, png_infop info_ptr, int chunk, int location));
		1994	PNG_EXPORT(176, int, png_get_unknown_chunks, (png_const_structp png_ptr,
		1995	png_const_infop info_ptr, png_unknown_chunkpp entries));
		1996	#endif
		1997
		1998
		1999	* If you need to turn it off for a chunk that your application has freed,
		2000	* you can use png_set_invalid(png_ptr, info_ptr, PNG_INFO_CHNK);
		2001	*/
		2002	PNG_EXPORT(177, void, png_set_invalid,
		2003	(png_structp png_ptr, png_infop info_ptr, int mask));
		2004
		2005
		2006	/* The "params" pointer is currently not used and is for future expansion. */
		2007	PNG_EXPORT(178, void, png_read_png, (png_structp png_ptr, png_infop info_ptr,
		2008	int transforms, png_voidp params));
		2009	PNG_EXPORT(179, void, png_write_png, (png_structp png_ptr, png_infop info_ptr,
		2010	int transforms, png_voidp params));
		2011	#endif
		2012
		2013
		2014	(png_const_structp png_ptr));
		2015	PNG_EXPORT(181, png_const_charp, png_get_header_ver,
		2016	(png_const_structp png_ptr));
		2017	PNG_EXPORT(182, png_const_charp, png_get_header_version,
		2018	(png_const_structp png_ptr));
		2019	PNG_EXPORT(183, png_const_charp, png_get_libpng_ver,
		2020	(png_const_structp png_ptr));
		2021
		2022
		2023	PNG_EXPORT(184, png_uint_32, png_permit_mng_features, (png_structp png_ptr,
		2024	png_uint_32 mng_features_permitted));
		2025	#endif
		2026
		2027
		2028	#define PNG_HANDLE_CHUNK_AS_DEFAULT 0
		2029	#define PNG_HANDLE_CHUNK_NEVER 1
		2030	#define PNG_HANDLE_CHUNK_IF_SAFE 2
		2031	#define PNG_HANDLE_CHUNK_ALWAYS 3
		2032
		2033
		2034	* messages before passing them to the error or warning handler.
		2035	*/
		2036	#ifdef PNG_ERROR_NUMBERS_SUPPORTED
		2037	PNG_EXPORT(185, void, png_set_strip_error_numbers,
		2038	(png_structp png_ptr,
		2039	png_uint_32 strip_mode));
		2040	#endif
		2041
		2042
		2043	#ifdef PNG_SET_USER_LIMITS_SUPPORTED
		2044	PNG_EXPORT(186, void, png_set_user_limits, (png_structp png_ptr,
		2045	png_uint_32 user_width_max, png_uint_32 user_height_max));
		2046	PNG_EXPORT(187, png_uint_32, png_get_user_width_max,
		2047	(png_const_structp png_ptr));
		2048	PNG_EXPORT(188, png_uint_32, png_get_user_height_max,
		2049	(png_const_structp png_ptr));
		2050	/* Added in libpng-1.4.0 */
		2051	PNG_EXPORT(189, void, png_set_chunk_cache_max, (png_structp png_ptr,
		2052	png_uint_32 user_chunk_cache_max));
		2053	PNG_EXPORT(190, png_uint_32, png_get_chunk_cache_max,
		2054	(png_const_structp png_ptr));
		2055	/* Added in libpng-1.4.1 */
		2056	PNG_EXPORT(191, void, png_set_chunk_malloc_max, (png_structp png_ptr,
		2057	png_alloc_size_t user_chunk_cache_max));
		2058	PNG_EXPORT(192, png_alloc_size_t, png_get_chunk_malloc_max,
		2059	(png_const_structp png_ptr));
		2060	#endif
		2061
		2062
		2063	PNG_EXPORT(193, png_uint_32, png_get_pixels_per_inch,
		2064	(png_const_structp png_ptr, png_const_infop info_ptr));
		2065
		2066
		2067	(png_const_structp png_ptr, png_const_infop info_ptr));
		2068
		2069
		2070	(png_const_structp png_ptr, png_const_infop info_ptr));
		2071
		2072
		2073	(png_const_structp png_ptr, png_const_infop info_ptr));
		2074	#ifdef PNG_FIXED_POINT_SUPPORTED /* otherwise not implemented. */
		2075	PNG_FIXED_EXPORT(211, png_fixed_point, png_get_x_offset_inches_fixed,
		2076	(png_structp png_ptr, png_const_infop info_ptr));
		2077	#endif
		2078
		2079
		2080	png_const_infop info_ptr));
		2081	#ifdef PNG_FIXED_POINT_SUPPORTED /* otherwise not implemented. */
		2082	PNG_FIXED_EXPORT(212, png_fixed_point, png_get_y_offset_inches_fixed,
		2083	(png_structp png_ptr, png_const_infop info_ptr));
		2084	#endif
		2085
		2086
		2087	PNG_EXPORT(198, png_uint_32, png_get_pHYs_dpi, (png_const_structp png_ptr,
		2088	png_const_infop info_ptr, png_uint_32 res_x, png_uint_32 res_y,
		2089	int *unit_type));
		2090	# endif /* PNG_pHYs_SUPPORTED */
		2091	#endif /* PNG_INCH_CONVERSIONS_SUPPORTED */
		2092
		2093
		2094	#ifdef PNG_IO_STATE_SUPPORTED
		2095	PNG_EXPORT(199, png_uint_32, png_get_io_state, (png_structp png_ptr));
		2096
		2097
		2098	(png_structp png_ptr), PNG_DEPRECATED);
		2099	PNG_EXPORT(216, png_uint_32, png_get_io_chunk_type,
		2100	(png_const_structp png_ptr));
		2101
		2102
		2103	# define PNG_IO_NONE 0x0000 /* no I/O at this moment */
		2104	# define PNG_IO_READING 0x0001 /* currently reading */
		2105	# define PNG_IO_WRITING 0x0002 /* currently writing */
		2106	# define PNG_IO_SIGNATURE 0x0010 /* currently at the file signature */
		2107	# define PNG_IO_CHUNK_HDR 0x0020 /* currently at the chunk header */
		2108	# define PNG_IO_CHUNK_DATA 0x0040 /* currently at the chunk data */
		2109	# define PNG_IO_CHUNK_CRC 0x0080 /* currently at the chunk crc */
		2110	# define PNG_IO_MASK_OP 0x000f /* current operation: reading/writing */
		2111	# define PNG_IO_MASK_LOC 0x00f0 /* current location: sig/hdr/data/crc */
		2112	#endif /* ?PNG_IO_STATE_SUPPORTED */
		2113
		2114
		2115	* libpng interlace handling is turned off the macros may be used to handle
		2116	* interlaced images within the application.
		2117	*/
		2118	#define PNG_INTERLACE_ADAM7_PASSES 7
		2119
		2120
		2121	* full, image which appears in a given pass. 'pass' is in the range 0
		2122	* to 6 and the result is in the range 0 to 7.
		2123	*/
		2124	#define PNG_PASS_START_ROW(pass) (((1U&~(pass))<<(3-((pass)>>1)))&7)
		2125	#define PNG_PASS_START_COL(pass) (((1U& (pass))<<(3-(((pass)+1)>>1)))&7)
		2126
		2127
		2128	* pass. This is expressed as a shift - effectively log2 of the number or
		2129	* rows or columns in each 8x8 tile of the original image.
		2130	*/
		2131	#define PNG_PASS_ROW_SHIFT(pass) ((pass)>2?(8-(pass))>>1:3)
		2132	#define PNG_PASS_COL_SHIFT(pass) ((pass)>1?(7-(pass))>>1:3)
		2133
		2134
		2135	* pass of an image given its height or width. In fact these macros may
		2136	* return non-zero even though the sub-image is empty, because the other
		2137	* dimension may be empty for a small image.
		2138	*/
		2139	#define PNG_PASS_ROWS(height, pass) (((height)+(((1<
		2140	-1)-PNG_PASS_START_ROW(pass)))>>PNG_PASS_ROW_SHIFT(pass))
		2141	#define PNG_PASS_COLS(width, pass) (((width)+(((1<
		2142	-1)-PNG_PASS_START_COL(pass)))>>PNG_PASS_COL_SHIFT(pass))
		2143
		2144
		2145	* image given a row in an interlaced image, so two more macros:
		2146	*/
		2147	#define PNG_ROW_FROM_PASS_ROW(yIn, pass) \
		2148	(((yIn)<
		2149	#define PNG_COL_FROM_PASS_COL(xIn, pass) \
		2150	(((xIn)<
		2151
		2152
		2153	* or column is in a particular pass. These use a common utility macro that
		2154	* returns a mask for a given pass - the offset 'off' selects the row or
		2155	* column version. The mask has the appropriate bit set for each column in
		2156	* the tile.
		2157	*/
		2158	#define PNG_PASS_MASK(pass,off) ( \
		2159	((0x110145AFU>>(((7-(off))-(pass))<<2)) & 0xFU) \| \
		2160	((0x01145AF0U>>(((7-(off))-(pass))<<2)) & 0xF0U))
		2161
		2162
		2163	((PNG_PASS_MASK(pass,0) >> ((y)&7)) & 1)
		2164	#define PNG_COL_IN_INTERLACE_PASS(x, pass) \
		2165	((PNG_PASS_MASK(pass,1) >> ((x)&7)) & 1)
		2166
		2167
		2168	/* With these routines we avoid an integer divide, which will be slower on
		2169	* most machines. However, it does take more operations than the corresponding
		2170	* divide method, so it may be slower on a few RISC systems. There are two
		2171	* shifts (by 8 or 16 bits) and an addition, versus a single integer divide.
		2172	*
		2173	* Note that the rounding factors are NOT supposed to be the same! 128 and
		2174	* 32768 are correct for the NODIV code; 127 and 32767 are correct for the
		2175	* standard method.
		2176	*
		2177	* [Optimized code by Greg Roelofs and Mark Adler...blame us for bugs. :-) ]
		2178	*/
		2179
		2180
		2181
		2182
		2183	{ png_uint_16 temp = (png_uint_16)((png_uint_16)(fg) \
		2184	* (png_uint_16)(alpha) \
		2185	+ (png_uint_16)(bg)*(png_uint_16)(255 \
		2186	- (png_uint_16)(alpha)) + (png_uint_16)128); \
		2187	(composite) = (png_byte)((temp + (temp >> 8)) >> 8); }
		2188
		2189
		2190	{ png_uint_32 temp = (png_uint_32)((png_uint_32)(fg) \
		2191	* (png_uint_32)(alpha) \
		2192	+ (png_uint_32)(bg)*(png_uint_32)(65535L \
		2193	- (png_uint_32)(alpha)) + (png_uint_32)32768L); \
		2194	(composite) = (png_uint_16)((temp + (temp >> 16)) >> 16); }
		2195
		2196
		2197
		2198
		2199	(composite) = (png_byte)(((png_uint_16)(fg) * (png_uint_16)(alpha) + \
		2200	(png_uint_16)(bg) * (png_uint_16)(255 - (png_uint_16)(alpha)) + \
		2201	(png_uint_16)127) / 255)
		2202
		2203
		2204	(composite) = (png_uint_16)(((png_uint_32)(fg) * (png_uint_32)(alpha) + \
		2205	(png_uint_32)(bg)*(png_uint_32)(65535L - (png_uint_32)(alpha)) + \
		2206	(png_uint_32)32767) / (png_uint_32)65535L)
		2207	#endif /* PNG_READ_COMPOSITE_NODIV_SUPPORTED */
		2208
		2209
		2210	PNG_EXPORT(201, png_uint_32, png_get_uint_32, (png_const_bytep buf));
		2211	PNG_EXPORT(202, png_uint_16, png_get_uint_16, (png_const_bytep buf));
		2212	PNG_EXPORT(203, png_int_32, png_get_int_32, (png_const_bytep buf));
		2213	#endif
		2214
		2215
		2216	png_const_bytep buf));
		2217	/* No png_get_int_16 -- may be added if there's a real need for it. */
		2218
		2219
		2220	#ifdef PNG_WRITE_INT_FUNCTIONS_SUPPORTED
		2221	PNG_EXPORT(205, void, png_save_uint_32, (png_bytep buf, png_uint_32 i));
		2222	#endif
		2223	#ifdef PNG_SAVE_INT_32_SUPPORTED
		2224	PNG_EXPORT(206, void, png_save_int_32, (png_bytep buf, png_int_32 i));
		2225	#endif
		2226
		2227
		2228	* The parameter is declared unsigned int, not png_uint_16,
		2229	* just to avoid potential problems on pre-ANSI C compilers.
		2230	*/
		2231	#ifdef PNG_WRITE_INT_FUNCTIONS_SUPPORTED
		2232	PNG_EXPORT(207, void, png_save_uint_16, (png_bytep buf, unsigned int i));
		2233	/* No png_save_int_16 -- may be added if there's a real need for it. */
		2234	#endif
		2235
		2236
		2237	/* Inline macros to do direct reads of bytes from the input buffer.
		2238	* The png_get_int_32() routine assumes we are using two's complement
		2239	* format for negative values, which is almost certainly true.
		2240	*/
		2241	# define png_get_uint_32(buf) \
		2242	(((png_uint_32)(*(buf)) << 24) + \
		2243	((png_uint_32)(*((buf) + 1)) << 16) + \
		2244	((png_uint_32)(*((buf) + 2)) << 8) + \
		2245	((png_uint_32)(*((buf) + 3))))
		2246
		2247
		2248	* function) incorrectly returned a value of type png_uint_32.
		2249	*/
		2250	# define png_get_uint_16(buf) \
		2251	((png_uint_16) \
		2252	(((unsigned int)(*(buf)) << 8) + \
		2253	((unsigned int)(*((buf) + 1)))))
		2254
		2255
		2256	((png_int_32)((*(buf) & 0x80) \
		2257	? -((png_int_32)((png_get_uint_32(buf) ^ 0xffffffffL) + 1)) \
		2258	: (png_int_32)png_get_uint_32(buf)))
		2259	#endif
		2260
		2261
		2262	* defs
		2263	*/
		2264
		2265
		2266	* one to use is one more than this.) Maintainer, remember to add an entry to
		2267	* scripts/symbols.def as well.
		2268	*/
		2269	#ifdef PNG_EXPORT_LAST_ORDINAL
		2270	PNG_EXPORT_LAST_ORDINAL(220);
		2271	#endif
		2272
		2273
		2274	}
		2275	#endif
		2276
		2277
		2278	/* Do not put anything past this line */
		2279	#endif /* PNG_H */
		2280

Subversion Repositories Kolibri OS

(root)/contrib/media/updf/include/png.h @ 8238 – Rev