mewin/libpng
1
0
Fork 0
mirror of https://git.code.sf.net/p/libpng/code.git synced 2025-07-10 18:04:09 +02:00
Code Issues Projects Releases Wiki Activity

[master] Updated documentation of png_set|get_tRNS() and png_set|get_iCCP().

Browse Source
This commit is contained in:
Glenn Randers-Pehrson 2011-01-15 11:10:02 -06:00
parent a10d488a32
commit d486eb18c5
4 changed files with 69 additions and 61 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
ANNOUNCE
View File

@ -1,5 +1,5 @@
Libpng 1.4.6beta03 - January 15, 2011 Libpng 1.4.6beta04 - January 15, 2011
This is not intended to be a public release. It will be replaced This is not intended to be a public release. It will be replaced
within a few weeks by a public version or by another test version. within a few weeks by a public version or by another test version.
@ -9,20 +9,20 @@ Files available for download:
Source files with LF line endings (for Unix/Linux) and with a Source files with LF line endings (for Unix/Linux) and with a
"configure" script "configure" script
1.4.6beta03.tar.xz (LZMA-compressed, recommended) 1.4.6beta04.tar.xz (LZMA-compressed, recommended)
1.4.6beta03.tar.gz 1.4.6beta04.tar.gz
1.4.6beta03.tar.bz2 1.4.6beta04.tar.bz2
Source files with CRLF line endings (for Windows), without the Source files with CRLF line endings (for Windows), without the
"configure" script "configure" script
lp146b03.7z (LZMA-compressed, recommended) lp146b04.7z (LZMA-compressed, recommended)
lp146b03.zip lp146b04.zip
Other information: Other information:
1.4.6beta03-README.txt 1.4.6beta04-README.txt
1.4.6beta03-LICENSE.txt 1.4.6beta04-LICENSE.txt
Changes since the last public release (1.4.5): Changes since the last public release (1.4.5):
@ -35,9 +35,13 @@ version 1.4.6beta02 [January 14, 2011]
Fixed misspelled macros in contrib/pngminim (Cosmin) Fixed misspelled macros in contrib/pngminim (Cosmin)
Updated CMakeLists.txt (Clifford Yapp) Updated CMakeLists.txt (Clifford Yapp)
version 1.4.6beta03 [January 15, 2011] version 1.4.6beta03 [January 14, 2011]
Fixed some typecasts in png_debug statements (Cosmin). Fixed some typecasts in png_debug statements (Cosmin).
version 1.4.6beta04 [January 15, 2011]
Updated documentation of png_set|get_tRNS() and png_set|get_iCCP()
(Thomas Klausner).
Send comments/corrections/commendations to glennrp at users.sourceforge.net Send comments/corrections/commendations to glennrp at users.sourceforge.net
or to png-mng-implement at lists.sf.net (subscription required; visit or to png-mng-implement at lists.sf.net (subscription required; visit
https://lists.sourceforge.net/lists/listinfo/png-mng-implement). https://lists.sourceforge.net/lists/listinfo/png-mng-implement).

6
CHANGES
View File

@ -2744,9 +2744,13 @@ version 1.4.6beta02 [January 14, 2011]
Fixed misspelled macros in contrib/pngminim (Cosmin). Fixed misspelled macros in contrib/pngminim (Cosmin).
Updated CMakeLists.txt (Clifford Yapp). Updated CMakeLists.txt (Clifford Yapp).
version 1.4.6beta03 [January 15, 2011] version 1.4.6beta03 [January 14, 2011]
Fixed some typecasts in png_debug statements (Cosmin). Fixed some typecasts in png_debug statements (Cosmin).
version 1.4.6beta04 [January 15, 2011]
Updated documentation of png_set|get_tRNS() and png_set|get_iCCP()
(Thomas Klausner).
Send comments/corrections/commendations to glennrp at users.sourceforge.net Send comments/corrections/commendations to glennrp at users.sourceforge.net
or to png-mng-implement at lists.sf.net (subscription required; visit or to png-mng-implement at lists.sf.net (subscription required; visit
https://lists.sourceforge.net/lists/listinfo/png-mng-implement). https://lists.sourceforge.net/lists/listinfo/png-mng-implement).

44
libpng-1.4.6beta03.txt
View File

@ -1,6 +1,6 @@
libpng.txt - A description on how to use and modify libpng libpng.txt - A description on how to use and modify libpng
libpng version 1.4.6beta03 - January 15, 2011 libpng version 1.4.6beta04 - January 15, 2011
Updated and distributed by Glenn Randers-Pehrson Updated and distributed by Glenn Randers-Pehrson
<glennrp at users.sourceforge.net> <glennrp at users.sourceforge.net>
Copyright (c) 1998-2010 Glenn Randers-Pehrson Copyright (c) 1998-2010 Glenn Randers-Pehrson
@ -11,7 +11,7 @@ libpng.txt - A description on how to use and modify libpng
Based on: Based on:
libpng versions 0.97, January 1998, through 1.4.6beta03 - January 15, 2011 libpng versions 0.97, January 1998, through 1.4.6beta04 - January 15, 2011
Updated and distributed by Glenn Randers-Pehrson Updated and distributed by Glenn Randers-Pehrson
Copyright (c) 1998-2010 Glenn Randers-Pehrson Copyright (c) 1998-2010 Glenn Randers-Pehrson
@ -658,14 +658,14 @@ pointer into the info_ptr is returned for any complex types.
png_get_iCCP(png_ptr, info_ptr, &name, png_get_iCCP(png_ptr, info_ptr, &name,
&compression_type, &profile, &proflen); &compression_type, &profile, &proflen);
name - The profile name. name - The profile name.
compression - The compression type; always compression_type - The compression type; always
PNG_COMPRESSION_TYPE_BASE for PNG 1.0. PNG_COMPRESSION_TYPE_BASE for PNG 1.0.
You may give NULL to this argument to You may give NULL to this argument to
ignore it. ignore it.
profile - International Color Consortium color profile - International Color Consortium color
profile data. May contain NULs. profile data. May contain NULs.
proflen - length of profile data in bytes. proflen - length of profile data in bytes.
png_get_sBIT(png_ptr, info_ptr, &sig_bit); png_get_sBIT(png_ptr, info_ptr, &sig_bit);
sig_bit - the number of significant bits for sig_bit - the number of significant bits for
@ -678,11 +678,11 @@ pointer into the info_ptr is returned for any complex types.
&num_trans, &trans_color); &num_trans, &trans_color);
trans_alpha - array of alpha (transparency) trans_alpha - array of alpha (transparency)
entries for palette (PNG_INFO_tRNS) entries for palette (PNG_INFO_tRNS)
num_trans - number of transparent entries
(PNG_INFO_tRNS)
trans_color - graylevel or color sample values of trans_color - graylevel or color sample values of
the single transparent color for the single transparent color for
non-paletted images (PNG_INFO_tRNS) non-paletted images (PNG_INFO_tRNS)
num_trans - number of transparent entries
(PNG_INFO_tRNS)
png_get_hIST(png_ptr, info_ptr, &hist); png_get_hIST(png_ptr, info_ptr, &hist);
(PNG_INFO_hIST) (PNG_INFO_hIST)
@ -903,7 +903,7 @@ things.
As of libpng version 1.2.9, png_set_expand_gray_1_2_4_to_8() was As of libpng version 1.2.9, png_set_expand_gray_1_2_4_to_8() was
added. It expands the sample depth without changing tRNS to alpha. added. It expands the sample depth without changing tRNS to alpha.
As of libpng version 1.4.6beta03, not all possible expansions are supported. As of libpng version 1.4.6beta04, not all possible expansions are supported.
In the following table, the 01 means grayscale with depth<8, 31 means In the following table, the 01 means grayscale with depth<8, 31 means
indexed with depth<8, other numerals represent the color type, "T" means indexed with depth<8, other numerals represent the color type, "T" means
@ -1932,14 +1932,14 @@ width, height, bit_depth, and color_type must be the same in each call.
png_set_iCCP(png_ptr, info_ptr, name, compression_type, png_set_iCCP(png_ptr, info_ptr, name, compression_type,
profile, proflen); profile, proflen);
name - The profile name. name - The profile name.
compression - The compression type; always compression_type - The compression type; always
PNG_COMPRESSION_TYPE_BASE for PNG 1.0. PNG_COMPRESSION_TYPE_BASE for PNG 1.0.
You may give NULL to this argument to You may give NULL to this argument to
ignore it. ignore it.
profile - International Color Consortium color profile - International Color Consortium color
profile data. May contain NULs. profile data. May contain NULs.
proflen - length of profile data in bytes. proflen - length of profile data in bytes.
png_set_sBIT(png_ptr, info_ptr, sig_bit); png_set_sBIT(png_ptr, info_ptr, sig_bit);
sig_bit - the number of significant bits for sig_bit - the number of significant bits for
@ -3309,7 +3309,7 @@ Since the PNG Development group is an ad-hoc body, we can't make
an official declaration. an official declaration.
This is your unofficial assurance that libpng from version 0.71 and This is your unofficial assurance that libpng from version 0.71 and
upward through 1.4.6beta03 are Y2K compliant. It is my belief that earlier upward through 1.4.6beta04 are Y2K compliant. It is my belief that earlier
versions were also Y2K compliant. versions were also Y2K compliant.
Libpng only has three year fields. One is a 2-byte unsigned integer that Libpng only has three year fields. One is a 2-byte unsigned integer that

58
libpng.3
View File

@ -1,6 +1,6 @@
.TH LIBPNG 3 "January 15, 2011" .TH LIBPNG 3 "January 15, 2011"
.SH NAME .SH NAME
libpng \- Portable Network Graphics (PNG) Reference Library 1.4.6beta03 libpng \- Portable Network Graphics (PNG) Reference Library 1.4.6beta04
.SH SYNOPSIS .SH SYNOPSIS
\fI\fB \fI\fB
@ -160,7 +160,7 @@ libpng \- Portable Network Graphics (PNG) Reference Library 1.4.6beta03
\fI\fB \fI\fB
\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 \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_bytepp \fP\fIprofile\fP\fB, png_uint_32 \fI*proflen\fP\fB);\fP
\fI\fB \fI\fB
@ -262,7 +262,7 @@ libpng \- Portable Network Graphics (PNG) Reference Library 1.4.6beta03
\fI\fB \fI\fB
\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_color\fP\fB);\fP \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_alpha\fP\fB, int \fP\fI*num_trans\fP\fB, png_color_16p \fI*trans_color\fP\fB);\fP
\fI\fB \fI\fB
@ -506,7 +506,7 @@ libpng \- Portable Network Graphics (PNG) Reference Library 1.4.6beta03
\fI\fB \fI\fB
\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 \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_bytep \fP\fIprofile\fP\fB, png_uint_32 \fIproflen\fP\fB);\fP
\fI\fB \fI\fB
@ -658,7 +658,7 @@ libpng \- Portable Network Graphics (PNG) Reference Library 1.4.6beta03
\fI\fB \fI\fB
\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_color\fP\fB);\fP \fBvoid png_set_tRNS (png_structp \fP\fIpng_ptr\fP\fB, png_infop \fP\fIinfo_ptr\fP\fB, png_bytep \fP\fItrans_alpha\fP\fB, int \fP\fInum_trans\fP\fB, png_color_16p \fItrans_color\fP\fB);\fP
\fI\fB \fI\fB
@ -785,7 +785,7 @@ Following is a copy of the libpng.txt file that accompanies libpng.
.SH LIBPNG.TXT .SH LIBPNG.TXT
libpng.txt - A description on how to use and modify libpng libpng.txt - A description on how to use and modify libpng
libpng version 1.4.6beta03 - January 15, 2011 libpng version 1.4.6beta04 - January 15, 2011
Updated and distributed by Glenn Randers-Pehrson Updated and distributed by Glenn Randers-Pehrson
<glennrp at users.sourceforge.net> <glennrp at users.sourceforge.net>
Copyright (c) 1998-2010 Glenn Randers-Pehrson Copyright (c) 1998-2010 Glenn Randers-Pehrson
@ -796,7 +796,7 @@ libpng.txt - A description on how to use and modify libpng
Based on: Based on:
libpng versions 0.97, January 1998, through 1.4.6beta03 - January 15, 2011 libpng versions 0.97, January 1998, through 1.4.6beta04 - January 15, 2011
Updated and distributed by Glenn Randers-Pehrson Updated and distributed by Glenn Randers-Pehrson
Copyright (c) 1998-2010 Glenn Randers-Pehrson Copyright (c) 1998-2010 Glenn Randers-Pehrson
@ -1443,14 +1443,14 @@ pointer into the info_ptr is returned for any complex types.
png_get_iCCP(png_ptr, info_ptr, &name, png_get_iCCP(png_ptr, info_ptr, &name,
&compression_type, &profile, &proflen); &compression_type, &profile, &proflen);
name - The profile name. name - The profile name.
compression - The compression type; always compression_type - The compression type; always
PNG_COMPRESSION_TYPE_BASE for PNG 1.0. PNG_COMPRESSION_TYPE_BASE for PNG 1.0.
You may give NULL to this argument to You may give NULL to this argument to
ignore it. ignore it.
profile - International Color Consortium color profile - International Color Consortium color
profile data. May contain NULs. profile data. May contain NULs.
proflen - length of profile data in bytes. proflen - length of profile data in bytes.
png_get_sBIT(png_ptr, info_ptr, &sig_bit); png_get_sBIT(png_ptr, info_ptr, &sig_bit);
sig_bit - the number of significant bits for sig_bit - the number of significant bits for
@ -1463,11 +1463,11 @@ pointer into the info_ptr is returned for any complex types.
&num_trans, &trans_color); &num_trans, &trans_color);
trans_alpha - array of alpha (transparency) trans_alpha - array of alpha (transparency)
entries for palette (PNG_INFO_tRNS) entries for palette (PNG_INFO_tRNS)
num_trans - number of transparent entries
(PNG_INFO_tRNS)
trans_color - graylevel or color sample values of trans_color - graylevel or color sample values of
the single transparent color for the single transparent color for
non-paletted images (PNG_INFO_tRNS) non-paletted images (PNG_INFO_tRNS)
num_trans - number of transparent entries
(PNG_INFO_tRNS)
png_get_hIST(png_ptr, info_ptr, &hist); png_get_hIST(png_ptr, info_ptr, &hist);
(PNG_INFO_hIST) (PNG_INFO_hIST)
@ -1688,7 +1688,7 @@ things.
As of libpng version 1.2.9, png_set_expand_gray_1_2_4_to_8() was As of libpng version 1.2.9, png_set_expand_gray_1_2_4_to_8() was
added. It expands the sample depth without changing tRNS to alpha. added. It expands the sample depth without changing tRNS to alpha.
As of libpng version 1.4.6beta03, not all possible expansions are supported. As of libpng version 1.4.6beta04, not all possible expansions are supported.
In the following table, the 01 means grayscale with depth<8, 31 means In the following table, the 01 means grayscale with depth<8, 31 means
indexed with depth<8, other numerals represent the color type, "T" means indexed with depth<8, other numerals represent the color type, "T" means
@ -2717,14 +2717,14 @@ width, height, bit_depth, and color_type must be the same in each call.
png_set_iCCP(png_ptr, info_ptr, name, compression_type, png_set_iCCP(png_ptr, info_ptr, name, compression_type,
profile, proflen); profile, proflen);
name - The profile name. name - The profile name.
compression - The compression type; always compression_type - The compression type; always
PNG_COMPRESSION_TYPE_BASE for PNG 1.0. PNG_COMPRESSION_TYPE_BASE for PNG 1.0.
You may give NULL to this argument to You may give NULL to this argument to
ignore it. ignore it.
profile - International Color Consortium color profile - International Color Consortium color
profile data. May contain NULs. profile data. May contain NULs.
proflen - length of profile data in bytes. proflen - length of profile data in bytes.
png_set_sBIT(png_ptr, info_ptr, sig_bit); png_set_sBIT(png_ptr, info_ptr, sig_bit);
sig_bit - the number of significant bits for sig_bit - the number of significant bits for
@ -4094,7 +4094,7 @@ Since the PNG Development group is an ad-hoc body, we can't make
an official declaration. an official declaration.
This is your unofficial assurance that libpng from version 0.71 and This is your unofficial assurance that libpng from version 0.71 and
upward through 1.4.6beta03 are Y2K compliant. It is my belief that earlier upward through 1.4.6beta04 are Y2K compliant. It is my belief that earlier
versions were also Y2K compliant. versions were also Y2K compliant.
Libpng only has three year fields. One is a 2-byte unsigned integer that Libpng only has three year fields. One is a 2-byte unsigned integer that
@ -4343,7 +4343,7 @@ possible without all of you.
Thanks to Frank J. T. Wojcik for helping with the documentation. Thanks to Frank J. T. Wojcik for helping with the documentation.
Libpng version 1.4.6beta03 - January 15, 2011: Libpng version 1.4.6beta04 - January 15, 2011:
Initially created in 1995 by Guy Eric Schalnat, then of Group 42, Inc. Initially created in 1995 by Guy Eric Schalnat, then of Group 42, Inc.
Currently maintained by Glenn Randers-Pehrson (glennrp at users.sourceforge.net). Currently maintained by Glenn Randers-Pehrson (glennrp at users.sourceforge.net).
@ -4366,7 +4366,7 @@ this sentence.
This code is released under the libpng license. This code is released under the libpng license.
libpng versions 1.2.6, August 15, 2004, through 1.4.6beta03, January 15, 2011, are libpng versions 1.2.6, August 15, 2004, through 1.4.6beta04, January 15, 2011, are
Copyright (c) 2004,2006-2007 Glenn Randers-Pehrson, and are Copyright (c) 2004,2006-2007 Glenn Randers-Pehrson, and are
distributed according to the same disclaimer and license as libpng-1.2.5 distributed according to the same disclaimer and license as libpng-1.2.5
with the following individual added to the list of Contributing Authors with the following individual added to the list of Contributing Authors