[libpng17] Updated manual to require png_set_PLTE() to precede png_set_tRNS()

and png_set_hIST() if either is present.
This commit is contained in:
Glenn Randers-Pehrson 2015-12-01 11:13:44 -06:00
parent cb3402221b
commit c46bd30b51
4 changed files with 30 additions and 25 deletions

View File

@ -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 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.
@ -1022,7 +1022,7 @@ Version 1.7.0beta69 [November 24, 2015]
Temporarily disabled filter selection while writing, and temporarily Temporarily disabled filter selection while writing, and temporarily
replaced pngtest.png accordingly. 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 Fixed a simple bracket problem that prevented reading non-interlaced
PNG files with height == 1. PNG files with height == 1.
The code failed to zero out the row buffer at the start of a pass where The code failed to zero out the row buffer at the start of a pass where
@ -1055,15 +1055,8 @@ Version 1.7.0beta70 [November 30, 2015]
compression code with the decompression code; IDAT_size replaces compression code with the decompression code; IDAT_size replaces
IDAT_read_size and zbuffer_size, IDAT reading and writing is no longer IDAT_read_size and zbuffer_size, IDAT reading and writing is no longer
controlled by the size of the compression buffer. controlled by the size of the compression buffer.
Updated manual to require png_set_PLTE() to precede png_set_tRNS()
Send comments/corrections/commendations to png-mng-implement at lists.sf.net and png_set_hIST() if either is present.
(subscription required; visit
https://lists.sourceforge.net/lists/listinfo/png-mng-implement
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 Send comments/corrections/commendations to png-mng-implement at lists.sf.net
(subscription required; visit (subscription required; visit

View File

@ -5321,7 +5321,7 @@ Version 1.7.0beta69 [November 24, 2015]
Temporarily disabled filter selection while writing, and temporarily Temporarily disabled filter selection while writing, and temporarily
replaced pngtest.png accordingly. 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 Fixed a simple bracket problem that prevented reading non-interlaced
PNG files with height == 1. PNG files with height == 1.
The code failed to zero out the row buffer at the start of a pass where 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 compression code with the decompression code; IDAT_size replaces
IDAT_read_size and zbuffer_size, IDAT reading and writing is no longer IDAT_read_size and zbuffer_size, IDAT reading and writing is no longer
controlled by the size of the compression buffer. 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 Send comments/corrections/commendations to png-mng-implement at lists.sf.net
(subscription required; visit (subscription required; visit

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.7.0beta70 - November 24, 2015 libpng version 1.7.0beta70 - December 1, 2015
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-2015 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: 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 Updated and distributed by Glenn Randers-Pehrson
Copyright (c) 1998-2015 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 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 other png_set_*() functions, because they might require access to some of
the IHDR settings. The remaining png_set_*() functions can be called the IHDR settings.
in any order.
If you wish, you can reset the compression_type, interlace_type, or 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 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) (array of png_color)
num_palette - number of entries in the palette 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(png_ptr, info_ptr, file_gamma);
png_set_gAMA_fixed(png_ptr, info_ptr, int_file_gamma); png_set_gAMA_fixed(png_ptr, info_ptr, int_file_gamma);

View File

@ -1,4 +1,4 @@
.TH LIBPNG 3 "November 24, 2015" .TH LIBPNG 3 "December 1, 2015"
.SH NAME .SH NAME
libpng \- Portable Network Graphics (PNG) Reference Library 1.7.0beta70 libpng \- Portable Network Graphics (PNG) Reference Library 1.7.0beta70
.SH SYNOPSIS .SH SYNOPSIS
@ -498,7 +498,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.7.0beta70 - November 24, 2015 libpng version 1.7.0beta70 - December 1, 2015
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-2015 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: 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 Updated and distributed by Glenn Randers-Pehrson
Copyright (c) 1998-2015 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 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 other png_set_*() functions, because they might require access to some of
the IHDR settings. The remaining png_set_*() functions can be called the IHDR settings.
in any order.
If you wish, you can reset the compression_type, interlace_type, or 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 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) (array of png_color)
num_palette - number of entries in the palette 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(png_ptr, info_ptr, file_gamma);
png_set_gAMA_fixed(png_ptr, info_ptr, int_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.6.19rc01-03 16 10619 16.so.16.19[.0]
... ...
1.7.0alpha01-10 17 10700 17.so.17.0[.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 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
@ -5980,7 +5985,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.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. 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).
@ -6005,7 +6010,7 @@ this sentence.
This code is released under the libpng license. 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 Copyright (c) 2000-2002, 2004, 2006-2015 Glenn Randers-Pehrson, are
derived from libpng-1.0.6, and are distributed according to the same 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 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 Glenn Randers-Pehrson
glennrp at users.sourceforge.net glennrp at users.sourceforge.net
November 24, 2015 December 1, 2015
.\" end of man page .\" end of man page