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

[libpng15] Added documentation of new png_get_palette_max() function.

Browse Source
This commit is contained in:
Glenn Randers-Pehrson 2013-02-04 19:45:48 -06:00
parent c9f2269857
commit 041f4465d0
6 changed files with 46 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
ANNOUNCE
View File

@ -1,5 +1,5 @@
Libpng 1.5.15beta01 - February 4, 2013 Libpng 1.5.15beta01 - 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.
@ -26,10 +26,11 @@ Other information:
Changes since the last public release (1.5.14): Changes since the last public release (1.5.14):
Version 1.5.15beta01 [February 4, 2013] Version 1.5.15beta01 [February 5, 2013]
Enabled renaming of the extern (but not DLL exported) ARM filter functions. Enabled renaming of the extern (but not DLL exported) ARM filter functions.
Also enabled inclusion of pngpriv.h in non-C files by preventing C/C++ Also enabled inclusion of pngpriv.h in non-C files by preventing C/C++
specific definitions if PNG_VERSION_INFO_ONLY is defined. specific definitions if PNG_VERSION_INFO_ONLY is defined.
Added png_get_palette_max() function.
Send comments/corrections/commendations to png-mng-implement at lists.sf.net Send comments/corrections/commendations to png-mng-implement at lists.sf.net
(subscription required; visit (subscription required; visit

3
CHANGES
View File

@ -3983,10 +3983,11 @@ Version 1.5.14rc03 [January 18, 2013]
Version 1.5.14 [January 24, 2013] Version 1.5.14 [January 24, 2013]
Removed an obsolete line from the manual. Removed an obsolete line from the manual.
Version 1.5.15beta01 [February 4, 2013] Version 1.5.15beta01 [February 5, 2013]
Enabled renaming of the extern (but not DLL exported) ARM filter functions. Enabled renaming of the extern (but not DLL exported) ARM filter functions.
Also enabled inclusion of pngpriv.h in non-C files by preventing C/C++ Also enabled inclusion of pngpriv.h in non-C files by preventing C/C++
specific definitions if PNG_VERSION_INFO_ONLY is defined. specific definitions if PNG_VERSION_INFO_ONLY is defined.
Added png_get_palette_max() function.
=========================================================================== ===========================================================================
NOTICE November 17, 2012: NOTICE November 17, 2012:

14
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.5.15beta01 - January 24, 2013 libpng version 1.5.15beta01 - 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-2012 Glenn Randers-Pehrson Copyright (c) 1998-2012 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.5.15beta01 - January 24, 2013 libpng versions 0.97, January 1998, through 1.5.15beta01 - February 5, 2013
Updated and distributed by Glenn Randers-Pehrson Updated and distributed by Glenn Randers-Pehrson
Copyright (c) 1998-2012 Glenn Randers-Pehrson Copyright (c) 1998-2012 Glenn Randers-Pehrson
@ -4161,6 +4161,14 @@ This is enabled by default but can be disabled in each png_ptr with
0: disable 0: disable
1: enable 1: enable
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
@ -4609,7 +4617,7 @@ Other rules can be inferred by inspecting the libpng source.
XIV. Y2K Compliance in libpng XIV. Y2K Compliance in libpng
January 24, 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.

23
libpng.3
View File

@ -1,4 +1,4 @@
.TH LIBPNG 3 "January 24, 2013" .TH LIBPNG 3 "February 5, 2013"
.SH NAME .SH NAME
libpng \- Portable Network Graphics (PNG) Reference Library 1.5.15beta01 libpng \- Portable Network Graphics (PNG) Reference Library 1.5.15beta01
.SH SYNOPSIS .SH SYNOPSIS
@ -492,7 +492,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.5.15beta01 - January 24, 2013 libpng version 1.5.15beta01 - 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-2012 Glenn Randers-Pehrson Copyright (c) 1998-2012 Glenn Randers-Pehrson
@ -503,7 +503,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.5.15beta01 - January 24, 2013 libpng versions 0.97, January 1998, through 1.5.15beta01 - February 5, 2013
Updated and distributed by Glenn Randers-Pehrson Updated and distributed by Glenn Randers-Pehrson
Copyright (c) 1998-2012 Glenn Randers-Pehrson Copyright (c) 1998-2012 Glenn Randers-Pehrson
@ -4654,6 +4654,14 @@ This is enabled by default but can be disabled in each png_ptr with
0: disable 0: disable
1: enable 1: enable
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
@ -5102,7 +5110,7 @@ Other rules can be inferred by inspecting the libpng source.
.SH XIV. Y2K Compliance in libpng .SH XIV. Y2K Compliance in libpng
January 24, 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.
@ -5331,7 +5339,6 @@ the first widely used release:
1.5.14beta01-08 15 10514 15.so.15.14[.0] 1.5.14beta01-08 15 10514 15.so.15.14[.0]
1.5.14rc01-03 15 10514 15.so.15.14[.0] 1.5.14rc01-03 15 10514 15.so.15.14[.0]
1.5.14 15 10514 15.so.15.14[.0] 1.5.14 15 10514 15.so.15.14[.0]
1.5.15beta01 15 10515 15.so.15.15[.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
@ -5388,7 +5395,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.5.15beta01 - January 24, 2013: Libpng version 1.5.15beta01 - 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).
@ -5411,7 +5418,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.5.15beta01, January 24, 2013, are libpng versions 1.2.6, August 15, 2004, through 1.5.15beta01, 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
@ -5510,7 +5517,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 24, 2013 February 5, 2013
.\" end of man page .\" end of man page

16
pngget.c
View File

@ -1,8 +1,8 @@
/* pngget.c - retrieval of values from info struct /* pngget.c - retrieval of values from info struct
* *
* Last changed in libpng 1.5.14 [January 24, 2013] * Last changed in libpng 1.5.15 [(PENDING RELEASE)]
* Copyright (c) 1998-2011 Glenn Randers-Pehrson * Copyright (c) 1998-2013 Glenn Randers-Pehrson
* (Version 0.96 Copyright (c) 1996, 1997 Andreas Dilger) * (Version 0.96 Copyright (c) 1996, 1997 Andreas Dilger)
* (Version 0.88 Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.) * (Version 0.88 Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.)
* *
@ -1127,4 +1127,16 @@ png_get_io_chunk_name (png_structp png_ptr)
} }
#endif /* ?PNG_IO_STATE_SUPPORTED */ #endif /* ?PNG_IO_STATE_SUPPORTED */
#ifdef PNG_CHECK_FOR_INVALID_INDEX_SUPPORTED
int PNGAPI
png_get_max_palette_index(png_const_structp png_ptr, png_const_infop info_ptr)
{
if (png_ptr != NULL && info_ptr != NULL)
return png_ptr->num_palette_max;
return (-1);
}
#endif
#endif /* PNG_READ_SUPPORTED || PNG_WRITE_SUPPORTED */ #endif /* PNG_READ_SUPPORTED || PNG_WRITE_SUPPORTED */

1
scripts/symbols.def
View File

@ -240,3 +240,4 @@ EXPORTS
png_set_cHRM_XYZ @232 png_set_cHRM_XYZ @232
png_set_cHRM_XYZ_fixed @233 png_set_cHRM_XYZ_fixed @233
png_set_check_for_invalid_index @234 png_set_check_for_invalid_index @234
png_get_palette_max @235