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

[libpng16] Added documentation of the new png_get_palette_max() function.

Browse Source
This commit is contained in:
Glenn Randers-Pehrson 2013-02-04 19:50:56 -06:00
parent 29890b0439
commit 806477742a
5 changed files with 55 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
ANNOUNCE
View File

@ -1,5 +1,5 @@
Libpng 1.6.0rc01 - January 26, 2013 Libpng 1.6.0rc02 - February 5, 2013
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,19 +9,19 @@ 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.6.0rc01.tar.xz (LZMA-compressed, recommended) 1.6.0rc02.tar.xz (LZMA-compressed, recommended)
1.6.0rc01.tar.gz 1.6.0rc02.tar.gz
Source files with CRLF line endings (for Windows), without the Source files with CRLF line endings (for Windows), without the
"configure" script "configure" script
lp160r01.7z (LZMA-compressed, recommended) lp160r02.7z (LZMA-compressed, recommended)
lp160r01.zip lp160r02.zip
Other information: Other information:
1.6.0rc01-README.txt 1.6.0rc02-README.txt
1.6.0rc01-LICENSE.txt 1.6.0rc02-LICENSE.txt
Changes since the last public release (1.5.7): Changes since the last public release (1.5.7):
@ -597,6 +597,9 @@ Version 1.6.0beta40 [January 20, 2013]
Version 1.6.0rc01 [January 26, 2013] Version 1.6.0rc01 [January 26, 2013]
No changes. No changes.
Version 1.6.0rc02 [February 5, 2013]
Added png_get_palette_max() function.
=========================================================================== ===========================================================================
NOTICE November 17, 2012: NOTICE November 17, 2012:
The location of the git repository at SourceForge has changed. The location of the git repository at SourceForge has changed.

6
CHANGES
View File

@ -3779,7 +3779,8 @@ Version 1.5.7 [December 15, 2011]
Version 1.6.0beta01 [December 15, 2011] Version 1.6.0beta01 [December 15, 2011]
Removed machine-generated configure files from the GIT repository (they will Removed machine-generated configure files from the GIT repository (they will
continue to appear in the tarball distributions). continue to appear in the tarball distributions and in the libpng15 and
earlier GIT branches).
Restored the new 'simplified' API, which was started in libpng-1.5.7beta02 Restored the new 'simplified' API, which was started in libpng-1.5.7beta02
but later deleted from libpng-1.5.7beta05. but later deleted from libpng-1.5.7beta05.
Added example programs for the new 'simplified' API. Added example programs for the new 'simplified' API.
@ -4350,6 +4351,9 @@ Version 1.6.0beta40 [January 20, 2013]
Version 1.6.0rc01 [January 26, 2013] Version 1.6.0rc01 [January 26, 2013]
No changes. No changes.
Version 1.6.0rc02 [February 5, 2013]
Added png_get_palette_max() function.
=========================================================================== ===========================================================================
NOTICE November 17, 2012: NOTICE November 17, 2012:
The location of the git repository at SourceForge has changed. The location of the git repository at SourceForge has changed.

20
libpng-manual.txt
View File

@ -1,6 +1,6 @@
libpng-manual.txt - A description on how to use and modify libpng libpng-manual.txt - A description on how to use and modify libpng
libpng version 1.6.0rc01 - January 26, 2013 libpng version 1.6.0rc02 - February 5, 2013
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-2013 Glenn Randers-Pehrson Copyright (c) 1998-2013 Glenn Randers-Pehrson
@ -11,7 +11,7 @@ libpng-manual.txt - A description on how to use and modify libpng
Based on: Based on:
libpng versions 0.97, January 1998, through 1.6.0rc01 - January 26, 2013 libpng versions 0.97, January 1998, through 1.6.0rc02 - February 5, 2013
Updated and distributed by Glenn Randers-Pehrson Updated and distributed by Glenn Randers-Pehrson
Copyright (c) 1998-2013 Glenn Randers-Pehrson Copyright (c) 1998-2013 Glenn Randers-Pehrson
@ -4590,6 +4590,14 @@ If the error is ignored, or if png_benign_error() treats it as a warning,
any invalid pixels are decoded as opaque black by the decoder and written any invalid pixels are decoded as opaque black by the decoder and written
as-is by the encoder. as-is by the encoder.
Retrieving the maximum palette index found was added at libpng-1.5.15.
This statement must appear after png_read_png() or png_read_image().
int max_palette = png_get_palette_max(png_ptr, info_ptr);
This will return the maximum palette index found, or "-1" if the palette
was not checked, or "0" if no palette was found.
A. Changes that affect users of libpng A. Changes that affect users of libpng
There are no substantial API changes between the non-deprecated parts of There are no substantial API changes between the non-deprecated parts of
@ -4964,6 +4972,10 @@ This adds more correct option control of the unknown handling, corrects
a pre-existing bug where the per-chunk 'keep' setting is ignored, and makes a pre-existing bug where the per-chunk 'keep' setting is ignored, and makes
it possible to skip IDAT chunks in the sequential reader. it possible to skip IDAT chunks in the sequential reader.
The machine-generated configure files are no longer included in branches
libpng16 and later of the GIT repository. They continue to be included
in the tarball releases, however.
XIII. Detecting libpng XIII. Detecting libpng
The png_get_io_ptr() function has been present since libpng-0.88, has never The png_get_io_ptr() function has been present since libpng-0.88, has never
@ -5125,13 +5137,13 @@ Other rules can be inferred by inspecting the libpng source.
XVI. Y2K Compliance in libpng XVI. Y2K Compliance in libpng
January 26, 2013 February 5, 2013
Since the PNG Development group is an ad-hoc body, we can't make 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.6.0rc01 are Y2K compliant. It is my belief that earlier upward through 1.6.0rc02 are Y2K compliant. It is my belief that earlier
versions were also Y2K compliant. versions were also Y2K compliant.
Libpng only has two year fields. One is a 2-byte unsigned integer Libpng only has two year fields. One is a 2-byte unsigned integer

32
libpng.3
View File

@ -1,6 +1,6 @@
.TH LIBPNG 3 "January 26, 2013" .TH LIBPNG 3 "February 5, 2013"
.SH NAME .SH NAME
libpng \- Portable Network Graphics (PNG) Reference Library 1.6.0rc01 libpng \- Portable Network Graphics (PNG) Reference Library 1.6.0rc02
.SH SYNOPSIS .SH SYNOPSIS
\fB \fB
#include <png.h>\fP #include <png.h>\fP
@ -504,7 +504,7 @@ Following is a copy of the libpng-manual.txt file that accompanies libpng.
.SH LIBPNG.TXT .SH LIBPNG.TXT
libpng-manual.txt - A description on how to use and modify libpng libpng-manual.txt - A description on how to use and modify libpng
libpng version 1.6.0rc01 - January 26, 2013 libpng version 1.6.0rc02 - February 5, 2013
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-2013 Glenn Randers-Pehrson Copyright (c) 1998-2013 Glenn Randers-Pehrson
@ -515,7 +515,7 @@ libpng-manual.txt - A description on how to use and modify libpng
Based on: Based on:
libpng versions 0.97, January 1998, through 1.6.0rc01 - January 26, 2013 libpng versions 0.97, January 1998, through 1.6.0rc02 - February 5, 2013
Updated and distributed by Glenn Randers-Pehrson Updated and distributed by Glenn Randers-Pehrson
Copyright (c) 1998-2013 Glenn Randers-Pehrson Copyright (c) 1998-2013 Glenn Randers-Pehrson
@ -5095,6 +5095,14 @@ If the error is ignored, or if png_benign_error() treats it as a warning,
any invalid pixels are decoded as opaque black by the decoder and written any invalid pixels are decoded as opaque black by the decoder and written
as-is by the encoder. as-is by the encoder.
Retrieving the maximum palette index found was added at libpng-1.5.15.
This statement must appear after png_read_png() or png_read_image().
int max_palette = png_get_palette_max(png_ptr, info_ptr);
This will return the maximum palette index found, or "-1" if the palette
was not checked, or "0" if no palette was found.
A. Changes that affect users of libpng A. Changes that affect users of libpng
There are no substantial API changes between the non-deprecated parts of There are no substantial API changes between the non-deprecated parts of
@ -5469,6 +5477,10 @@ This adds more correct option control of the unknown handling, corrects
a pre-existing bug where the per-chunk 'keep' setting is ignored, and makes a pre-existing bug where the per-chunk 'keep' setting is ignored, and makes
it possible to skip IDAT chunks in the sequential reader. it possible to skip IDAT chunks in the sequential reader.
The machine-generated configure files are no longer included in branches
libpng16 and later of the GIT repository. They continue to be included
in the tarball releases, however.
.SH XIII. Detecting libpng .SH XIII. Detecting libpng
The png_get_io_ptr() function has been present since libpng-0.88, has never The png_get_io_ptr() function has been present since libpng-0.88, has never
@ -5630,13 +5642,13 @@ Other rules can be inferred by inspecting the libpng source.
.SH XVI. Y2K Compliance in libpng .SH XVI. Y2K Compliance in libpng
January 26, 2013 February 5, 2013
Since the PNG Development group is an ad-hoc body, we can't make 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.6.0rc01 are Y2K compliant. It is my belief that earlier upward through 1.6.0rc02 are Y2K compliant. It is my belief that earlier
versions were also Y2K compliant. versions were also Y2K compliant.
Libpng only has two year fields. One is a 2-byte unsigned integer Libpng only has two year fields. One is a 2-byte unsigned integer
@ -5842,7 +5854,7 @@ the first widely used release:
1.5.7rc01-03 15 10507 15.so.15.7[.0] 1.5.7rc01-03 15 10507 15.so.15.7[.0]
1.5.7 15 10507 15.so.15.7[.0] 1.5.7 15 10507 15.so.15.7[.0]
1.6.0beta01-40 16 10600 16.so.16.0[.0] 1.6.0beta01-40 16 10600 16.so.16.0[.0]
1.6.0rc01 16 10600 16.so.16.0[.0] 1.6.0rc01-02 16 10600 16.so.16.0[.0]
Henceforth the source version will match the shared-library minor Henceforth the source version will match the shared-library minor
and patch numbers; the shared-library major version number will be and patch numbers; the shared-library major version number will be
@ -5899,7 +5911,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.6.0rc01 - January 26, 2013: Libpng version 1.6.0rc02 - February 5, 2013:
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).
@ -5922,7 +5934,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.6.0rc01, January 26, 2013, are libpng versions 1.2.6, August 15, 2004, through 1.6.0rc02, February 5, 2013, 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
@ -6021,7 +6033,7 @@ certification mark of the Open Source Initiative.
Glenn Randers-Pehrson Glenn Randers-Pehrson
glennrp at users.sourceforge.net glennrp at users.sourceforge.net
January 26, 2013 February 5, 2013
.\" end of man page .\" end of man page

3
scripts/symbols.def
View File

@ -5,7 +5,7 @@
LIBRARY LIBRARY
EXPORTS EXPORTS
;Version 1.6.0rc01 ;Version 1.6.0rc02
png_access_version_number @1 png_access_version_number @1
png_set_sig_bytes @2 png_set_sig_bytes @2
png_sig_cmp @3 png_sig_cmp @3
@ -247,3 +247,4 @@ EXPORTS
png_image_write_to_stdio @240 png_image_write_to_stdio @240
png_convert_to_rfc1123_buffer @241 png_convert_to_rfc1123_buffer @241
png_set_check_for_invalid_index @242 png_set_check_for_invalid_index @242
png_get_palette_max @243