From c46bd30b51cffa05d3ff7a060dc07e962fc2d81f Mon Sep 17 00:00:00 2001 From: Glenn Randers-Pehrson Date: Tue, 1 Dec 2015 11:13:44 -0600 Subject: [PATCH] [libpng17] Updated manual to require png_set_PLTE() to precede png_set_tRNS() and png_set_hIST() if either is present. --- ANNOUNCE | 15 ++++----------- CHANGES | 4 +++- libpng-manual.txt | 13 +++++++++---- libpng.3 | 23 ++++++++++++++--------- 4 files changed, 30 insertions(+), 25 deletions(-) diff --git a/ANNOUNCE b/ANNOUNCE index ee1fa742a..05691be59 100644 --- a/ANNOUNCE +++ b/ANNOUNCE @@ -1,5 +1,5 @@ -Libpng 1.7.0beta70 - November 30, 2015 +Libpng 1.7.0beta70 - December 1, 2015 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. @@ -1022,7 +1022,7 @@ Version 1.7.0beta69 [November 24, 2015] Temporarily disabled filter selection while writing, and temporarily replaced pngtest.png accordingly. -Version 1.7.0beta70 [November 30, 2015] +Version 1.7.0beta70 [December 1, 2015] Fixed a simple bracket problem that prevented reading non-interlaced PNG files with height == 1. The code failed to zero out the row buffer at the start of a pass where @@ -1055,6 +1055,8 @@ Version 1.7.0beta70 [November 30, 2015] compression code with the decompression code; IDAT_size replaces IDAT_read_size and zbuffer_size, IDAT reading and writing is no longer controlled by the size of the compression buffer. + Updated manual to require png_set_PLTE() to precede png_set_tRNS() + and png_set_hIST() if either is present. Send comments/corrections/commendations to png-mng-implement at lists.sf.net (subscription required; visit @@ -1063,12 +1065,3 @@ to subscribe) or to glennrp at users.sourceforge.net Glenn R-P -#endif - -Send comments/corrections/commendations to png-mng-implement at lists.sf.net -(subscription required; visit -https://lists.sourceforge.net/lists/listinfo/png-mng-implement -to subscribe) -or to glennrp at users.sourceforge.net - -Glenn R-P diff --git a/CHANGES b/CHANGES index 9718e1fea..d0a0173da 100644 --- a/CHANGES +++ b/CHANGES @@ -5321,7 +5321,7 @@ Version 1.7.0beta69 [November 24, 2015] Temporarily disabled filter selection while writing, and temporarily replaced pngtest.png accordingly. -Version 1.7.0beta70 [November 30, 2015] +Version 1.7.0beta70 [December 1, 2015] Fixed a simple bracket problem that prevented reading non-interlaced PNG files with height == 1. The code failed to zero out the row buffer at the start of a pass where @@ -5354,6 +5354,8 @@ Version 1.7.0beta70 [November 30, 2015] compression code with the decompression code; IDAT_size replaces IDAT_read_size and zbuffer_size, IDAT reading and writing is no longer controlled by the size of the compression buffer. + Updated manual to require png_set_PLTE() to precede png_set_tRNS() + and png_set_hIST() if either is present. Send comments/corrections/commendations to png-mng-implement at lists.sf.net (subscription required; visit diff --git a/libpng-manual.txt b/libpng-manual.txt index 75ccd095e..fc69a2615 100644 --- a/libpng-manual.txt +++ b/libpng-manual.txt @@ -1,6 +1,6 @@ libpng-manual.txt - A description on how to use and modify libpng - libpng version 1.7.0beta70 - November 24, 2015 + libpng version 1.7.0beta70 - December 1, 2015 Updated and distributed by Glenn Randers-Pehrson Copyright (c) 1998-2015 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.7.0beta70 - November 24, 2015 + libpng versions 0.97, January 1998, through 1.7.0beta70 - December 1, 2015 Updated and distributed by Glenn Randers-Pehrson Copyright (c) 1998-2015 Glenn Randers-Pehrson @@ -2947,8 +2947,7 @@ Some of the more important parts of the png_info are: If you call png_set_IHDR(), the call must appear before any of the other png_set_*() functions, because they might require access to some of -the IHDR settings. The remaining png_set_*() functions can be called -in any order. +the IHDR settings. If you wish, you can reset the compression_type, interlace_type, or filter_method later by calling png_set_IHDR() again; if you do this, the @@ -2961,6 +2960,12 @@ width, height, bit_depth, and color_type must be the same in each call. (array of png_color) num_palette - number of entries in the palette +If you call png_set_PLTE(), the call must appear before either of +png_set_tRNS() or png_set_hIST() appears, because they require access +to the palette length. + +The remaining png_set_*() functions can be called in any order. + png_set_gAMA(png_ptr, info_ptr, file_gamma); png_set_gAMA_fixed(png_ptr, info_ptr, int_file_gamma); diff --git a/libpng.3 b/libpng.3 index fe6616a88..9aa5c626c 100644 --- a/libpng.3 +++ b/libpng.3 @@ -1,4 +1,4 @@ -.TH LIBPNG 3 "November 24, 2015" +.TH LIBPNG 3 "December 1, 2015" .SH NAME libpng \- Portable Network Graphics (PNG) Reference Library 1.7.0beta70 .SH SYNOPSIS @@ -498,7 +498,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.7.0beta70 - November 24, 2015 + libpng version 1.7.0beta70 - December 1, 2015 Updated and distributed by Glenn Randers-Pehrson Copyright (c) 1998-2015 Glenn Randers-Pehrson @@ -509,7 +509,7 @@ libpng-manual.txt - A description on how to use and modify libpng Based on: - libpng versions 0.97, January 1998, through 1.7.0beta70 - November 24, 2015 + libpng versions 0.97, January 1998, through 1.7.0beta70 - December 1, 2015 Updated and distributed by Glenn Randers-Pehrson Copyright (c) 1998-2015 Glenn Randers-Pehrson @@ -3445,8 +3445,7 @@ Some of the more important parts of the png_info are: If you call png_set_IHDR(), the call must appear before any of the other png_set_*() functions, because they might require access to some of -the IHDR settings. The remaining png_set_*() functions can be called -in any order. +the IHDR settings. If you wish, you can reset the compression_type, interlace_type, or filter_method later by calling png_set_IHDR() again; if you do this, the @@ -3459,6 +3458,12 @@ width, height, bit_depth, and color_type must be the same in each call. (array of png_color) num_palette - number of entries in the palette +If you call png_set_PLTE(), the call must appear before either of +png_set_tRNS() or png_set_hIST() appears, because they require access +to the palette length. + +The remaining png_set_*() functions can be called in any order. + png_set_gAMA(png_ptr, info_ptr, file_gamma); png_set_gAMA_fixed(png_ptr, info_ptr, int_file_gamma); @@ -5924,7 +5929,7 @@ the first widely used release: 1.6.19rc01-03 16 10619 16.so.16.19[.0] ... 1.7.0alpha01-10 17 10700 17.so.17.0[.0] - 1.7.0beta01-68 17 10700 17.so.17.0[.0] + 1.7.0beta01-70 17 10700 17.so.17.0[.0] Henceforth the source version will match the shared-library minor and patch numbers; the shared-library major version number will be @@ -5980,7 +5985,7 @@ possible without all of you. Thanks to Frank J. T. Wojcik for helping with the documentation. -Libpng version 1.7.0beta70 - November 24, 2015: +Libpng version 1.7.0beta70 - December 1, 2015: Initially created in 1995 by Guy Eric Schalnat, then of Group 42, Inc. Currently maintained by Glenn Randers-Pehrson (glennrp at users.sourceforge.net). @@ -6005,7 +6010,7 @@ this sentence. This code is released under the libpng license. -libpng versions 1.0.7, July 1, 2000, through 1.7.0beta70, November 24, 2015, are +libpng versions 1.0.7, July 1, 2000, through 1.7.0beta70, December 1, 2015, are Copyright (c) 2000-2002, 2004, 2006-2015 Glenn Randers-Pehrson, are derived from libpng-1.0.6, and are distributed according to the same disclaimer and license as libpng-1.0.6 with the following individuals @@ -6104,7 +6109,7 @@ the additional disclaimers inserted at version 1.0.7. Glenn Randers-Pehrson glennrp at users.sourceforge.net -November 24, 2015 +December 1, 2015 .\" end of man page