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] Change some hyphens to minus signs and fix other typos in libpng.3

Browse Source
This commit is contained in:
Glenn Randers-Pehrson 2013-08-06 17:24:19 -05:00
parent f880e3a735
commit 551435c359
2 changed files with 29 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
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.18beta01 - June 29, 2013 libpng version 1.5.18beta01 - August 6, 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.5.18beta01 - June 29, 2013 libpng versions 0.97, January 1998, through 1.5.18beta01 - August 6, 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
@ -707,7 +707,7 @@ situations:
system expects data with no gamma encoding. system expects data with no gamma encoding.
You would use the linear (unencoded) value if you need to process the pixel You would use the linear (unencoded) value if you need to process the pixel
values further because this avoids the need to decode and reencode each values further because this avoids the need to decode and re-encode each
component value whenever arithmetic is performed. A lot of graphics software component value whenever arithmetic is performed. A lot of graphics software
uses linear values for this reason, often with higher precision component values uses linear values for this reason, often with higher precision component values
to preserve overall accuracy. to preserve overall accuracy.
@ -2248,7 +2248,7 @@ For a more compact example of reading a PNG image, see the file example.c.
Reading PNG files progressively Reading PNG files progressively
The progressive reader is slightly different then the non-progressive The progressive reader is slightly different from the non-progressive
reader. Instead of calling png_read_info(), png_read_rows(), and reader. Instead of calling png_read_info(), png_read_rows(), and
png_read_end(), you make one call to png_process_data(), which calls png_read_end(), you make one call to png_process_data(), which calls
callbacks when it has the info, a row, or the end of the image. You callbacks when it has the info, a row, or the end of the image. You
@ -4171,7 +4171,7 @@ it has not been well tested and doesn't actually "dither".
The code was not The code was not
removed, however, and could be enabled by building libpng with removed, however, and could be enabled by building libpng with
PNG_READ_DITHER_SUPPORTED defined. In libpng-1.4.2, this support PNG_READ_DITHER_SUPPORTED defined. In libpng-1.4.2, this support
was reenabled, but the function was renamed png_set_quantize() to was re-enabled, but the function was renamed png_set_quantize() to
reflect more accurately what it actually does. At the same time, reflect more accurately what it actually does. At the same time,
the PNG_DITHER_[RED,GREEN_BLUE]_BITS macros were also renamed to the PNG_DITHER_[RED,GREEN_BLUE]_BITS macros were also renamed to
PNG_QUANTIZE_[RED,GREEN,BLUE]_BITS, and PNG_READ_DITHER_SUPPORTED PNG_QUANTIZE_[RED,GREEN,BLUE]_BITS, and PNG_READ_DITHER_SUPPORTED
@ -4655,7 +4655,7 @@ Other rules can be inferred by inspecting the libpng source.
XIV. Y2K Compliance in libpng XIV. Y2K Compliance in libpng
June 29, 2013 August 6, 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.

46
libpng.3
View File

@ -1,4 +1,4 @@
.TH LIBPNG 3 "June 29, 2013" .TH LIBPNG 3 "August 6, 2013"
.SH NAME .SH NAME
libpng \- Portable Network Graphics (PNG) Reference Library 1.5.18beta01 libpng \- Portable Network Graphics (PNG) Reference Library 1.5.18beta01
.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.18beta01 - June 29, 2013 libpng version 1.5.18beta01 - August 6, 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
@ -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.18beta01 - June 29, 2013 libpng versions 0.97, January 1998, through 1.5.18beta01 - August 6, 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
@ -641,7 +641,7 @@ All APIs that take (double) arguments also have a matching API that
takes the corresponding fixed point integer arguments. The fixed point takes the corresponding fixed point integer arguments. The fixed point
API has the same name as the floating point one with "_fixed" appended. API has the same name as the floating point one with "_fixed" appended.
The actual range of values permitted in the APIs is frequently less than The actual range of values permitted in the APIs is frequently less than
the full range of (png_fixed_point) (-21474 to +21474). When APIs require the full range of (png_fixed_point) (\-21474 to +21474). When APIs require
a non-negative argument the type is recorded as png_uint_32 above. Consult a non-negative argument the type is recorded as png_uint_32 above. Consult
the header file and the text below for more information. the header file and the text below for more information.
@ -682,7 +682,7 @@ The easiest way to make minor changes to the libpng configuration when
auto-configuration is supported is to add definitions to the command line auto-configuration is supported is to add definitions to the command line
using (typically) CPPFLAGS. For example: using (typically) CPPFLAGS. For example:
CPPFLAGS=-DPNG_NO_FLOATING_ARITHMETIC CPPFLAGS=\-DPNG_NO_FLOATING_ARITHMETIC
will change the internal libpng math implementation for gamma correction and will change the internal libpng math implementation for gamma correction and
other arithmetic calculations to fixed point, avoiding the need for fast other arithmetic calculations to fixed point, avoiding the need for fast
@ -690,7 +690,7 @@ floating point support. The result can be seen in the generated pnglibconf.h -
make sure it contains the changed feature macro setting. make sure it contains the changed feature macro setting.
If you need to make more extensive configuration changes - more than one or two If you need to make more extensive configuration changes - more than one or two
feature macro settings - you can either add -DPNG_USER_CONFIG to the build feature macro settings - you can either add \-DPNG_USER_CONFIG to the build
command line and put a list of feature macro settings in pngusr.h or you can set command line and put a list of feature macro settings in pngusr.h or you can set
DFA_XTRA (a makefile variable) to a file containing the same information in the DFA_XTRA (a makefile variable) to a file containing the same information in the
form of 'option' settings. form of 'option' settings.
@ -749,7 +749,7 @@ pngusr.dfa in these directories.
C. Configuration using PNG_USR_CONFIG C. Configuration using PNG_USR_CONFIG
If -DPNG_USR_CONFIG is added to the CFLAGS when pnglibconf.h is built the file If \-DPNG_USR_CONFIG is added to the CFLAGS when pnglibconf.h is built the file
pngusr.h will automatically be included before the options in pngusr.h will automatically be included before the options in
scripts/pnglibconf.dfa are processed. Your pngusr.h file should contain only scripts/pnglibconf.dfa are processed. Your pngusr.h file should contain only
macro definitions turning features on or off or setting settings. macro definitions turning features on or off or setting settings.
@ -979,7 +979,7 @@ input stream. You must supply the function
unknown chunk structure, process it, and return one unknown chunk structure, process it, and return one
of the following: */ of the following: */
return (-n); /* chunk had an error */ return (\-n); /* chunk had an error */
return (0); /* did not recognize */ return (0); /* did not recognize */
return (n); /* success */ return (n); /* success */
} }
@ -1024,7 +1024,7 @@ non-interlaced case the row that was just handled is simply one less than the
passed in row number, and pass will always be 0. For the interlaced case the passed in row number, and pass will always be 0. For the interlaced case the
same applies unless the row value is 0, in which case the row just handled was same applies unless the row value is 0, in which case the row just handled was
the last one from one of the preceding passes. Because interlacing may skip a the last one from one of the preceding passes. Because interlacing may skip a
pass you cannot be sure that the preceding pass is just 'pass-1', if you really pass you cannot be sure that the preceding pass is just 'pass\-1', if you really
need to know what the last pass is record (row,pass) from the callback and use need to know what the last pass is record (row,pass) from the callback and use
the last recorded value each time. the last recorded value each time.
@ -1110,7 +1110,7 @@ callback function:
.SS User limits .SS User limits
The PNG specification allows the width and height of an image to be as The PNG specification allows the width and height of an image to be as
large as 2^31-1 (0x7fffffff), or about 2.147 billion rows and columns. large as 2^(31\-1 (0x7fffffff), or about 2.147 billion rows and columns.
Since very few applications really need to process such large images, Since very few applications really need to process such large images,
we have imposed an arbitrary 1-million limit on rows and columns. we have imposed an arbitrary 1-million limit on rows and columns.
Larger images will be rejected immediately with a png_error() call. If Larger images will be rejected immediately with a png_error() call. If
@ -1199,7 +1199,7 @@ situations:
system expects data with no gamma encoding. system expects data with no gamma encoding.
You would use the linear (unencoded) value if you need to process the pixel You would use the linear (unencoded) value if you need to process the pixel
values further because this avoids the need to decode and reencode each values further because this avoids the need to decode and re-encode each
component value whenever arithmetic is performed. A lot of graphics software component value whenever arithmetic is performed. A lot of graphics software
uses linear values for this reason, often with higher precision component values uses linear values for this reason, often with higher precision component values
to preserve overall accuracy. to preserve overall accuracy.
@ -2670,13 +2670,13 @@ point to libpng-allocated storage with the following function:
or simply PNG_FREE_ALL or simply PNG_FREE_ALL
seq - sequence number of item to be freed seq - sequence number of item to be freed
(-1 for all items) (\-1 for all items)
This function may be safely called when the relevant storage has This function may be safely called when the relevant storage has
already been freed, or has not yet been allocated, or was allocated already been freed, or has not yet been allocated, or was allocated
by the user and not by libpng, and will in those cases do nothing. by the user and not by libpng, and will in those cases do nothing.
The "seq" parameter is ignored if only one item of the selected data The "seq" parameter is ignored if only one item of the selected data
type, such as PLTE, is allowed. If "seq" is not -1, and multiple items type, such as PLTE, is allowed. If "seq" is not \-1, and multiple items
are allowed for the data type identified in the mask, such as text or are allowed for the data type identified in the mask, such as text or
sPLT, only the n'th item in the structure is freed, where n is "seq". sPLT, only the n'th item in the structure is freed, where n is "seq".
@ -2740,7 +2740,7 @@ For a more compact example of reading a PNG image, see the file example.c.
.SS Reading PNG files progressively .SS Reading PNG files progressively
The progressive reader is slightly different then the non-progressive The progressive reader is slightly different from the non-progressive
reader. Instead of calling png_read_info(), png_read_rows(), and reader. Instead of calling png_read_info(), png_read_rows(), and
png_read_end(), you make one call to png_process_data(), which calls png_read_end(), you make one call to png_process_data(), which calls
callbacks when it has the info, a row, or the end of the image. You callbacks when it has the info, a row, or the end of the image. You
@ -3063,7 +3063,7 @@ non-interlaced case the row that was just handled is simply one less than the
passed in row number, and pass will always be 0. For the interlaced case the passed in row number, and pass will always be 0. For the interlaced case the
same applies unless the row value is 0, in which case the row just handled was same applies unless the row value is 0, in which case the row just handled was
the last one from one of the preceding passes. Because interlacing may skip a the last one from one of the preceding passes. Because interlacing may skip a
pass you cannot be sure that the preceding pass is just 'pass-1', if you really pass you cannot be sure that the preceding pass is just 'pass\-1', if you really
need to know what the last pass is record (row,pass) from the callback and use need to know what the last pass is record (row,pass) from the callback and use
the last recorded value each time. the last recorded value each time.
@ -3900,13 +3900,13 @@ point to libpng-allocated storage with the following function:
or simply PNG_FREE_ALL or simply PNG_FREE_ALL
seq - sequence number of item to be freed seq - sequence number of item to be freed
(-1 for all items) (\-1 for all items)
This function may be safely called when the relevant storage has This function may be safely called when the relevant storage has
already been freed, or has not yet been allocated, or was allocated already been freed, or has not yet been allocated, or was allocated
by the user and not by libpng, and will in those cases do nothing. by the user and not by libpng, and will in those cases do nothing.
The "seq" parameter is ignored if only one item of the selected data The "seq" parameter is ignored if only one item of the selected data
type, such as PLTE, is allowed. If "seq" is not -1, and multiple items type, such as PLTE, is allowed. If "seq" is not \-1, and multiple items
are allowed for the data type identified in the mask, such as text or are allowed for the data type identified in the mask, such as text or
sPLT, only the n'th item in the structure is freed, where n is "seq". sPLT, only the n'th item in the structure is freed, where n is "seq".
@ -4664,7 +4664,7 @@ it has not been well tested and doesn't actually "dither".
The code was not The code was not
removed, however, and could be enabled by building libpng with removed, however, and could be enabled by building libpng with
PNG_READ_DITHER_SUPPORTED defined. In libpng-1.4.2, this support PNG_READ_DITHER_SUPPORTED defined. In libpng-1.4.2, this support
was reenabled, but the function was renamed png_set_quantize() to was re-enabled, but the function was renamed png_set_quantize() to
reflect more accurately what it actually does. At the same time, reflect more accurately what it actually does. At the same time,
the PNG_DITHER_[RED,GREEN_BLUE]_BITS macros were also renamed to the PNG_DITHER_[RED,GREEN_BLUE]_BITS macros were also renamed to
PNG_QUANTIZE_[RED,GREEN,BLUE]_BITS, and PNG_READ_DITHER_SUPPORTED PNG_QUANTIZE_[RED,GREEN,BLUE]_BITS, and PNG_READ_DITHER_SUPPORTED
@ -4693,7 +4693,7 @@ reading, and after png_write_png() or png_write_image() while writing.
int max_palette = png_get_palette_max(png_ptr, info_ptr); int max_palette = png_get_palette_max(png_ptr, info_ptr);
This will return the maximum palette index found in the image, or "-1" if This will return the maximum palette index found in the image, or "\-1" if
the palette was not checked, or "0" if no palette was found. Note that this the palette was not checked, or "0" if no palette was found. Note that this
does not account for any palette index used by ancillary chunks such as the does not account for any palette index used by ancillary chunks such as the
bKGD chunk; you must check those separately to determine the maximum bKGD chunk; you must check those separately to determine the maximum
@ -5148,7 +5148,7 @@ Other rules can be inferred by inspecting the libpng source.
.SH XIV. Y2K Compliance in libpng .SH XIV. Y2K Compliance in libpng
June 29, 2013 August 6, 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.
@ -5443,7 +5443,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.18beta01 - June 29, 2013: Libpng version 1.5.18beta01 - August 6, 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).
@ -5466,7 +5466,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.18beta01, June 29, 2013, are libpng versions 1.2.6, August 15, 2004, through 1.5.18beta01, August 6, 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
@ -5565,7 +5565,7 @@ certification mark of the Open Source Initiative.
Glenn Randers-Pehrson Glenn Randers-Pehrson
glennrp at users.sourceforge.net glennrp at users.sourceforge.net
June 29, 2013 August 6, 2013
.\" end of man page .\" end of man page