mirror of
				https://git.code.sf.net/p/libpng/code.git
				synced 2025-07-10 18:04:09 +02:00 
			
		
		
		
	[libpng15] Added documentation of new png_get_palette_max() function.
This commit is contained in:
		
							parent
							
								
									c9f2269857
								
							
						
					
					
						commit
						041f4465d0
					
				
							
								
								
									
										5
									
								
								ANNOUNCE
									
									
									
									
									
								
							
							
						
						
									
										5
									
								
								ANNOUNCE
									
									
									
									
									
								
							| @ -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 | ||||
| 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): | ||||
| 
 | ||||
| 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. | ||||
|     Also enabled inclusion of pngpriv.h in non-C files by preventing C/C++ | ||||
|     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 | ||||
| (subscription required; visit | ||||
|  | ||||
							
								
								
									
										3
									
								
								CHANGES
									
									
									
									
									
								
							
							
						
						
									
										3
									
								
								CHANGES
									
									
									
									
									
								
							| @ -3983,10 +3983,11 @@ Version 1.5.14rc03 [January 18, 2013] | ||||
| Version 1.5.14 [January 24, 2013] | ||||
|   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. | ||||
|     Also enabled inclusion of pngpriv.h in non-C files by preventing C/C++ | ||||
|     specific definitions if PNG_VERSION_INFO_ONLY is defined. | ||||
|   Added png_get_palette_max() function. | ||||
| 
 | ||||
|   =========================================================================== | ||||
|                        NOTICE November 17, 2012: | ||||
|  | ||||
| @ -1,6 +1,6 @@ | ||||
| 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 | ||||
|  <glennrp at users.sourceforge.net> | ||||
|  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: | ||||
| 
 | ||||
|  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 | ||||
|  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 | ||||
|                  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 | ||||
| 
 | ||||
| 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 | ||||
| 
 | ||||
| January 24, 2013 | ||||
| February 5, 2013 | ||||
| 
 | ||||
| Since the PNG Development group is an ad-hoc body, we can't make | ||||
| an official declaration. | ||||
|  | ||||
							
								
								
									
										23
									
								
								libpng.3
									
									
									
									
									
								
							
							
						
						
									
										23
									
								
								libpng.3
									
									
									
									
									
								
							| @ -1,4 +1,4 @@ | ||||
| .TH LIBPNG 3 "January 24, 2013" | ||||
| .TH LIBPNG 3 "February 5, 2013" | ||||
| .SH NAME | ||||
| libpng \- Portable Network Graphics (PNG) Reference Library 1.5.15beta01 | ||||
| .SH SYNOPSIS | ||||
| @ -492,7 +492,7 @@ Following is a copy of the libpng-manual.txt file that accompanies libpng. | ||||
| .SH LIBPNG.TXT | ||||
| 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 | ||||
|  <glennrp at users.sourceforge.net> | ||||
|  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: | ||||
| 
 | ||||
|  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 | ||||
|  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 | ||||
|                  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 | ||||
| 
 | ||||
| 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 | ||||
| 
 | ||||
| January 24, 2013 | ||||
| February 5, 2013 | ||||
| 
 | ||||
| Since the PNG Development group is an ad-hoc body, we can't make | ||||
| 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.14rc01-03       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 | ||||
| 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. | ||||
| 
 | ||||
| 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. | ||||
| 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. | ||||
| 
 | ||||
| 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 | ||||
| distributed according to the same disclaimer and license as libpng-1.2.5 | ||||
| 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 | ||||
| glennrp at users.sourceforge.net | ||||
| January 24, 2013 | ||||
| February 5, 2013 | ||||
| 
 | ||||
| .\" end of man page | ||||
| 
 | ||||
|  | ||||
							
								
								
									
										16
									
								
								pngget.c
									
									
									
									
									
								
							
							
						
						
									
										16
									
								
								pngget.c
									
									
									
									
									
								
							| @ -1,8 +1,8 @@ | ||||
| 
 | ||||
| /* pngget.c - retrieval of values from info struct
 | ||||
|  * | ||||
|  * Last changed in libpng 1.5.14 [January 24, 2013] | ||||
|  * Copyright (c) 1998-2011 Glenn Randers-Pehrson | ||||
|  * Last changed in libpng 1.5.15 [(PENDING RELEASE)] | ||||
|  * Copyright (c) 1998-2013 Glenn Randers-Pehrson | ||||
|  * (Version 0.96 Copyright (c) 1996, 1997 Andreas Dilger) | ||||
|  * (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 */ | ||||
| 
 | ||||
| #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 */ | ||||
|  | ||||
| @ -240,3 +240,4 @@ EXPORTS | ||||
|  png_set_cHRM_XYZ @232 | ||||
|  png_set_cHRM_XYZ_fixed @233 | ||||
|  png_set_check_for_invalid_index @234 | ||||
|  png_get_palette_max @235 | ||||
|  | ||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user
	 Glenn Randers-Pehrson
						Glenn Randers-Pehrson