manpages/man3/libpng.3

<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!--ARC : LSARC 2003/085 libtiff, libjpeg, and libpng-->
<!ENTITY synp-tt "SYNOPSIS">
<!ENTITY cmd "libpng">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % gnomecommonents SYSTEM "gnomecommon.ent">
%gnomecommonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY suncopy "Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.">
]>
<?Pub UDT _bookmark _target>
<?Pub EntList brvbar bull cross dash diam diams frac12 frac13 frac14 hellip
 laquo lArr loz mdash nabla ndash para pound rArr raquo sect yen lt gt>
<?Pub Inc>
<?PubInc>
<refentry id="libpng-3">
<!-- %Z%%M% %I% %E% SMI; -->
<refmeta><refentrytitle>libpng</refentrytitle><manvolnum>3</manvolnum>
<refmiscinfo class="date">06 Apr 2004</refmiscinfo>
<refmiscinfo class="sectdesc">&man3;</refmiscinfo>
<refmiscinfo class="software">&release;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
</refmeta>
<indexterm><primary>libpng</primary></indexterm><indexterm><primary>Portable
Network Graphics (PNG) Reference Library</primary></indexterm>
<refnamediv id="libpng-3-name"><refname>libpng</refname><refpurpose>Portable
Network Graphics (PNG) Reference Library</refpurpose></refnamediv>
<refsect1 id="libpng-3-synp"><title>&synp-tt;</title>
<programlisting>#include &lt;png.h>

cc [ flag ...] -I/usr/sfw/include file [  library  ...  ]  -
L/usr/sfw/lib -R/usr/sfw/lib -lpng

png_uint_32 png_access_version_number (void);

int png_check_sig (png_bytep sig, int num);

void png_chunk_error (png_structp  png_ptr,  png_const_charp
error);

void png_chunk_warning (png_structp png_ptr, png_const_charp
message);

void png_convert_from_struct_tm (png_timep ptime, struct  tm
FAR * ttime);

void  png_convert_from_time_t   (png_timep   ptime,   time_t
ttime);

png_charp   png_convert_to_rfc1124   (png_structp   png_ptr,
png_timep ptime);

png_infop png_create_info_struct (png_structp png_ptr);

png_structp     png_create_read_struct      (png_const_charp
user_png_ver,  png_voidp  error_ptr, png_error_ptr error_fn,
png_error_ptr warn_fn);

png_structp         png_create_read_struct_2(png_const_charp
user_png_ver,  png_voidp  error_ptr, png_error_ptr error_fn,
png_error_ptr  warn_fn,  png_voidp  mem_ptr,  png_malloc_ptr
malloc_fn, png_free_ptr free_fn);

png_structp     png_create_write_struct     (png_const_charp
user_png_ver,  png_voidp  error_ptr, png_error_ptr error_fn,
png_error_ptr warn_fn);

png_structp        png_create_write_struct_2(png_const_charp
user_png_ver,  png_voidp  error_ptr, png_error_ptr error_fn,
png_error_ptr  warn_fn,  png_voidp  mem_ptr,  png_malloc_ptr
malloc_fn, png_free_ptr free_fn);

int png_debug(int level, png_const_charp message);

int png_debug1(int level, png_const_charp message, p1);

int png_debug2(int level, png_const_charp message, p1, p2);

void    png_destroy_info_struct    (png_structp     png_ptr,
png_infopp info_ptr_ptr);

void  png_destroy_read_struct   (png_structpp   png_ptr_ptr,
png_infopp info_ptr_ptr, png_infopp end_info_ptr_ptr);

void  png_destroy_write_struct  (png_structpp   png_ptr_ptr,
png_infopp info_ptr_ptr);

void png_error (png_structp png_ptr, png_const_charp error);

void png_free (png_structp png_ptr, png_voidp ptr);

void png_free_chunk_list (png_structp png_ptr);

void png_free_default(png_structp png_ptr, png_voidp ptr);

void png_free_data (png_structp png_ptr, png_infop info_ptr,
int num);

png_byte png_get_bit_depth (png_structp  png_ptr,  png_infop
info_ptr);

png_uint_32  png_get_bKGD  (png_structp  png_ptr,  png_infop
info_ptr, png_color_16p *background);

png_byte png_get_channels  (png_structp  png_ptr,  png_infop
info_ptr);

png_uint_32  png_get_cHRM  (png_structp  png_ptr,  png_infop
info_ptr,  double  *white_x, double *white_y, double *red_x,
double *red_y,  double  *green_x,  double  *green_y,  double
*blue_x, double *blue_y);

png_uint_32   png_get_cHRM_fixed    (png_structp    png_ptr,
png_infop   info_ptr,   png_uint_32   *white_x,  png_uint_32
*white_y,   png_uint_32    *red_x,    png_uint_32    *red_y,
png_uint_32   *green_x,  png_uint_32  *green_y,  png_uint_32
*blue_x, png_uint_32 *blue_y);

png_byte png_get_color_type (png_structp png_ptr,  png_infop
info_ptr);

png_byte  png_get_compression_type   (png_structp   png_ptr,
png_infop info_ptr);

png_byte png_get_copyright (png_structp png_ptr);

png_voidp png_get_error_ptr (png_structp png_ptr);

png_byte png_get_filter_type (png_structp png_ptr, png_infop
info_ptr);

png_uint_32  png_get_gAMA  (png_structp  png_ptr,  png_infop
info_ptr, double *file_gamma);

png_uint_32   png_get_gAMA_fixed    (png_structp    png_ptr,
png_infop info_ptr, png_uint_32 *int_file_gamma);

png_byte png_get_header_ver (png_structp png_ptr);

png_byte png_get_header_version (png_structp png_ptr);

png_uint_32  png_get_hIST  (png_structp  png_ptr,  png_infop
info_ptr, png_uint_16p *hist);

png_uint_32  png_get_iCCP  (png_structp  png_ptr,  png_infop
info_ptr, png_charpp name, int *compression_type, png_charpp
profile, png_uint_32 *proflen);

png_uint_32  png_get_IHDR  (png_structp  png_ptr,  png_infop
info_ptr,   png_uint_32  *width,  png_uint_32  *height,  int
*bit_depth,  int  *color_type,  int   *interlace_type,   int
*compression_type, int *filter_type);

png_uint_32   png_get_image_height   (png_structp   png_ptr,
png_infop info_ptr);

png_uint_32   png_get_image_width   (png_structp    png_ptr,
png_infop info_ptr);

png_byte   png_get_interlace_type   (png_structp    png_ptr,
png_infop info_ptr);

png_voidp png_get_io_ptr (png_structp png_ptr);

png_byte png_get_libpng_ver (png_structp png_ptr);

png_voidp png_get_mem_ptr(png_structp png_ptr);

png_uint_32  png_get_oFFs  (png_structp  png_ptr,  png_infop
info_ptr,  png_uint_32 *offset_x, png_uint_32 *offset_y, int
*unit_type);

png_uint_32  png_get_pCAL  (png_structp  png_ptr,  png_infop
info_ptr,  png_charp  *purpose,  png_int_32  *X0, png_int_32
*X1, int *type, int *nparams, png_charp  *units,  png_charpp
*params);

png_uint_32  png_get_pHYs  (png_structp  png_ptr,  png_infop
info_ptr,   png_uint_32   *res_x,  png_uint_32  *res_y,  int
*unit_type);

float   png_get_pixel_aspect_ratio   (png_structp   png_ptr,
png_infop info_ptr);

png_uint_32 png_get_pixels_per_meter  (png_structp  png_ptr,
png_infop info_ptr);

png_voidp png_get_progressive_ptr (png_structp png_ptr);

png_uint_32  png_get_PLTE  (png_structp  png_ptr,  png_infop
info_ptr, png_colorp *palette, int *num_palette);

png_byte png_get_rgb_to_gray_status (png_structp png_ptr)

png_uint_32 png_get_rowbytes (png_structp png_ptr, png_infop
info_ptr);

png_bytepp  png_get_rows  (png_structp  png_ptr,   png_infop
info_ptr);

png_uint_32  png_get_sBIT  (png_structp  png_ptr,  png_infop
info_ptr, png_color_8p *sig_bit);

png_bytep png_get_signature (png_structp png_ptr,  png_infop
info_ptr);

png_uint_32  png_get_sPLT  (png_structp  png_ptr,  png_infop
info_ptr, png_spalette_p *splt_ptr);

png_uint_32  png_get_sRGB  (png_structp  png_ptr,  png_infop
info_ptr, int *intent);

png_uint_32  png_get_text  (png_structp  png_ptr,  png_infop
info_ptr, png_textp *text_ptr, int *num_text);

png_uint_32  png_get_tIME  (png_structp  png_ptr,  png_infop
info_ptr, png_timep *mod_time);

png_uint_32  png_get_tRNS  (png_structp  png_ptr,  png_infop
info_ptr,  png_bytep  *trans,  int *num_trans, png_color_16p
*trans_values);

png_uint_32  png_get_unknown_chunks  (png_structp   png_ptr,
png_infop info_ptr, png_unknown_chunkpp unknowns);

png_voidp png_get_user_chunk_ptr (png_structp png_ptr);

png_voidp png_get_user_transform_ptr (png_structp png_ptr);

png_uint_32 png_get_valid  (png_structp  png_ptr,  png_infop
info_ptr, png_uint_32 flag);

png_int_32  png_get_x_offset_microns  (png_structp  png_ptr,
png_infop info_ptr);

png_int_32  png_get_x_offset_pixels  (png_structp   png_ptr,
png_infop info_ptr);

png_uint_32 png_get_x_pixels_per_meter (png_structp png_ptr,
png_infop info_ptr);

png_int_32  png_get_y_offset_microns  (png_structp  png_ptr,
png_infop info_ptr);

png_int_32  png_get_y_offset_pixels  (png_structp   png_ptr,
png_infop info_ptr);

png_uint_32 png_get_y_pixels_per_meter (png_structp png_ptr,
png_infop info_ptr);

png_uint_32   png_get_compression_buffer_size   (png_structp
png_ptr);

void png_info_init (png_infop info_ptr);

void png_init_io (png_structp png_ptr, FILE *fp);

png_voidp  png_malloc  (png_structp   png_ptr,   png_uint_32
size);

png_voidp      png_malloc_default(png_structp       png_ptr,
png_uint_32 size);

voidp png_memcpy (png_voidp  s1,  png_voidp  s2,  png_size_t
size);

png_voidp png_memcpy_check (png_structp  png_ptr,  png_voidp
s1, png_voidp s2, png_uint_32 size);

voidp png_memset (png_voidp s1, int value, png_size_t size);

png_voidp png_memset_check (png_structp  png_ptr,  png_voidp
s1, int value, png_uint_32 size);

void   png_permit_empty_plte   (png_structp   png_ptr,   int
empty_plte_permitted);

void  png_process_data   (png_structp   png_ptr,   png_infop
info_ptr, png_bytep buffer, png_size_t buffer_size);

void   png_progressive_combine_row   (png_structp   png_ptr,
png_bytep old_row, png_bytep new_row);

void  png_read_destroy   (png_structp   png_ptr,   png_infop
info_ptr, png_infop end_info_ptr);

void png_read_end (png_structp png_ptr, png_infop info_ptr);

void png_read_image (png_structp png_ptr, png_bytepp image);

DEPRECATED: void png_read_init (png_structp png_ptr);

DEPRECATED:  void  png_read_init_2   (png_structp   png_ptr,
png_const_charp  user_png_ver,  png_size_t  png_struct_size,
png_size_t png_info_size);

void   png_read_info   (png_structp    png_ptr,    png_infop
info_ptr);

void png_read_png (png_structp png_ptr, png_infop  info_ptr,
int transforms, png_voidp params);

void  png_read_row  (png_structp  png_ptr,  png_bytep   row,
png_bytep display_row);

void png_read_rows  (png_structp  png_ptr,  png_bytepp  row,
png_bytepp display_row, png_uint_32 num_rows);

void png_read_update_info  (png_structp  png_ptr,  png_infop
info_ptr);

void png_set_background (png_structp png_ptr,  png_color_16p
background_color,     int     background_gamma_code,     int
need_expand, double background_gamma);

void png_set_bgr (png_structp png_ptr);

void png_set_bKGD (png_structp png_ptr, png_infop  info_ptr,
png_color_16p background);

void png_set_cHRM (png_structp png_ptr, png_infop  info_ptr,
double  white_x, double white_y, double red_x, double red_y,
double  green_x,  double  green_y,  double  blue_x,   double
blue_y);

void  png_set_cHRM_fixed  (png_structp  png_ptr,   png_infop
info_ptr,    png_uint_32   white_x,   png_uint_32   white_y,
png_uint_32 red_x, png_uint_32 red_y,  png_uint_32  green_x,
png_uint_32   green_y,   png_uint_32   blue_x,   png_uint_32
blue_y);

void  png_set_compression_level  (png_structp  png_ptr,  int
level);

void png_set_compression_mem_level (png_structp png_ptr, int
mem_level);

void png_set_compression_method  (png_structp  png_ptr,  int
method);

void png_set_compression_strategy (png_structp png_ptr,  int
strategy);

void png_set_compression_window_bits  (png_structp  png_ptr,
int window_bits);

void   png_set_crc_action    (png_structp    png_ptr,    int
crit_action, int ancil_action);

void   png_set_dither   (png_structp   png_ptr,   png_colorp
palette,  int  num_palette, int maximum_colors, png_uint_16p
histogram, int full_dither);

void  png_set_error_fn   (png_structp   png_ptr,   png_voidp
error_ptr,     png_error_ptr     error_fn,     png_error_ptr
warning_fn);

void png_set_expand (png_structp png_ptr);

void  png_set_filler   (png_structp   png_ptr,   png_uint_32
filler, int flags);

void png_set_filter (png_structp png_ptr,  int  method,  int
filters);

void  png_set_filter_heuristics  (png_structp  png_ptr,  int
heuristic_method,      int      num_weights,     png_doublep
filter_weights, png_doublep filter_costs);

void png_set_flush (png_structp png_ptr, int nrows);

void    png_set_gamma    (png_structp    png_ptr,     double
screen_gamma, double default_file_gamma);

void png_set_gAMA (png_structp png_ptr, png_infop  info_ptr,
double file_gamma);

void  png_set_gAMA_fixed  (png_structp  png_ptr,   png_infop
info_ptr, png_uint_32 file_gamma);

void png_set_gray_1_2_4_to_8(png_structp png_ptr);

void png_set_gray_to_rgb (png_structp png_ptr);

void png_set_hIST (png_structp png_ptr, png_infop  info_ptr,
png_uint_16p hist);

void png_set_iCCP (png_structp png_ptr, png_infop  info_ptr,
png_charp  name,  int  compression_type,  png_charp profile,
png_uint_32 proflen);

int png_set_interlace_handling (png_structp png_ptr);

void   png_set_invalid   (png_structp   png_ptr,   png_infop
info_ptr, int mask);

void png_set_invert_alpha (png_structp png_ptr);

void png_set_invert_mono (png_structp png_ptr);

void png_set_IHDR (png_structp png_ptr, png_infop  info_ptr,
png_uint_32  width,  png_uint_32  height, int bit_depth, int
color_type, int interlace_type,  int  compression_type,  int
filter_type);

void png_set_keep_unknown_chunks (png_structp  png_ptr,  int
keep, png_bytep chunk_list, int num_chunks);

void png_set_mem_fn(png_structp png_ptr, png_voidp  mem_ptr,
png_malloc_ptr malloc_fn, png_free_ptr free_fn);

void png_set_oFFs (png_structp png_ptr, png_infop  info_ptr,
png_uint_32 offset_x, png_uint_32 offset_y, int unit_type);

void png_set_packing (png_structp png_ptr);

void png_set_packswap (png_structp png_ptr);

void png_set_palette_to_rgb(png_structp png_ptr);

void png_set_pCAL (png_structp png_ptr, png_infop  info_ptr,
png_charp  purpose,  png_int_32 X0, png_int_32 X1, int type,
int nparams, png_charp units, png_charpp params);

void png_set_pHYs (png_structp png_ptr, png_infop  info_ptr,
png_uint_32 res_x, png_uint_32 res_y, int unit_type);

void   png_set_progressive_read_fn   (png_structp   png_ptr,
png_voidp progressive_ptr, png_progressive_info_ptr info_fn,
png_progressive_row_ptr   row_fn,    png_progressive_end_ptr
end_fn);

void png_set_PLTE (png_structp png_ptr, png_infop  info_ptr,
png_colorp palette, int num_palette);

void png_set_read_fn (png_structp png_ptr, png_voidp io_ptr,
png_rw_ptr read_data_fn);

void    png_set_read_status_fn     (png_structp     png_ptr,
png_read_status_ptr read_row_fn);

void  png_set_read_user_transform_fn  (png_structp  png_ptr,
png_user_transform_ptr read_user_transform_fn);

void   png_set_rgb_to_gray   (png_structp    png_ptr,    int
error_action, double red, double green);

void  png_set_rgb_to_gray_fixed  (png_structp  png_ptr,  int
error_action png_fixed_point red, png_fixed_point green);

void png_set_rows (png_structp png_ptr, png_infop  info_ptr,
png_bytepp row_pointers);

void png_set_sBIT (png_structp png_ptr, png_infop  info_ptr,
png_color_8p sig_bit);

void png_set_sCAL (png_structp png_ptr, png_infop  info_ptr,
png_charp unit, double width, double height);

void  png_set_shift   (png_structp   png_ptr,   png_color_8p
true_bits);

void png_set_sig_bytes (png_structp png_ptr, int num_bytes);

void png_set_sPLT (png_structp png_ptr, png_infop  info_ptr,
png_spalette_p splt_ptr, int num_spalettes);

void png_set_sRGB (png_structp png_ptr, png_infop  info_ptr,
int intent);

void   png_set_sRGB_gAMA_and_cHRM   (png_structp    png_ptr,
png_infop info_ptr, int intent);

void png_set_strip_16 (png_structp png_ptr);

void png_set_strip_alpha (png_structp png_ptr);

void png_set_swap (png_structp png_ptr);

void png_set_swap_alpha (png_structp png_ptr);

void png_set_text (png_structp png_ptr, png_infop  info_ptr,
png_textp text_ptr, int num_text);

void png_set_tIME (png_structp png_ptr, png_infop  info_ptr,
png_timep mod_time);

void png_set_tRNS (png_structp png_ptr, png_infop  info_ptr,
png_bytep trans, int num_trans, png_color_16p trans_values);

void png_set_tRNS_to_alpha(png_structp png_ptr);

png_uint_32  png_set_unknown_chunks  (png_structp   png_ptr,
png_infop  info_ptr,  png_unknown_chunkp  unknowns, int num,
int location);

void   png_set_unknown_chunk_location(png_structp   png_ptr,
png_infop info_ptr, int chunk, int location);

void   png_set_read_user_chunk_fn   (png_structp    png_ptr,
png_voidp         user_chunk_ptr,         png_user_chunk_ptr
read_user_chunk_fn);

void   png_set_user_transform_info   (png_structp   png_ptr,
png_voidp  user_transform_ptr, int user_transform_depth, int
user_transform_channels);

void  png_set_write_fn   (png_structp   png_ptr,   png_voidp
io_ptr,      png_rw_ptr     write_data_fn,     png_flush_ptr
output_flush_fn);

void    png_set_write_status_fn    (png_structp     png_ptr,
png_write_status_ptr write_row_fn);

void png_set_write_user_transform_fn  (png_structp  png_ptr,
png_user_transform_ptr write_user_transform_fn);

void  png_set_compression_buffer_size(png_structp   png_ptr,
png_uint_32 size);

int png_sig_cmp (png_bytep sig, png_size_t start, png_size_t
num_to_check);

void png_start_read_image (png_structp png_ptr);

void png_warning (png_structp png_ptr, png_const_charp  mes-
sage);

void   png_write_chunk   (png_structp   png_ptr,   png_bytep
chunk_name, png_bytep data, png_size_t length);

void png_write_chunk_data  (png_structp  png_ptr,  png_bytep
data, png_size_t length);

void png_write_chunk_end (png_structp png_ptr);

void png_write_chunk_start (png_structp  png_ptr,  png_bytep
chunk_name, png_uint_32 length);

void png_write_destroy (png_structp png_ptr);

void png_write_destroy_info (png_infop info_ptr);

void   png_write_end   (png_structp    png_ptr,    png_infop
info_ptr);

void png_write_flush (png_structp png_ptr);

void  png_write_image   (png_structp   png_ptr,   png_bytepp
image);

DEPRECATED: void png_write_init (png_structp png_ptr);

DEPRECATED:  void  png_write_init_2  (png_structp   png_ptr,
png_const_charp  user_png_ver,  png_size_t  png_struct_size,
png_size_t png_info_size);

void   png_write_info   (png_structp   png_ptr,    png_infop
info_ptr);

void   png_write_info_before_PLTE   (png_structp    png_ptr,
png_infop info_ptr);

void png_write_png (png_structp png_ptr, png_infop info_ptr,
int transforms, png_voidp params);

void png_write_row (png_structp png_ptr, png_bytep row);

void png_write_rows (png_structp  png_ptr,  png_bytepp  row,

png_uint_32 num_rows);</programlisting>
</refsect1>
<refsect1 id="libpng-3-desc"><title>&desc-tt;</title>
<para>The <filename>libpng</filename> library supports encoding, decoding,
and various manipulations of the Portable Network Graphics (PNG) format image
files. The <filename>libpng</filename> library uses the <literal>zlib(3)</literal>
compression library.</para>
<para>For more information about libpng V1.0.15, see
<literal>http://www.libpng.org/pub/png/libpng-1.0.15-manual.txt
</literal></para>
<para>For more information about libpng V1.2.5, see
<literal>http://www.libpng.org/pub/png/libpng-manual.txt</literal></para>
</refsect1>
<refsect1 id="libpng-3-exde"><title>&exde-tt;</title>
<refsect2 id="libpng-3-exde-versions">
<title>Version Numbers</title>
<para>Due to various miscommunications, unforeseen code incompatibilities
and occasional factors outside the authors' control, version numbering on
the library has not always been consistent and straightforward. The following
table summarizes matters since version 0.89c, which was the first widely used
release.</para>
<informaltable frame="all">
<tgroup cols="4" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="25*">
<colspec colname="COLSPEC1" colwidth="25*"><colspec colname="COLSPEC2" colwidth="25*">
<colspec colname="COLSPEC3" colwidth="25*">
<thead>
<row rowsep="1"><entry colsep="1" rowsep="1"><para>source version</para></entry>
<entry colsep="1" rowsep="1"><para>png.h string</para></entry><entry colsep="1"
rowsep="1"><para>png.h int</para></entry><entry colsep="1" rowsep="1"><para>
shared-lib version</para></entry></row>
</thead>
<tbody>
<row><entry colsep="1" rowsep="1">0.89c ("beta 3")</entry><entry colsep="1"
rowsep="1">0.89</entry><entry colsep="1" rowsep="1">89</entry><entry colsep="1"
rowsep="1">1.0.89</entry></row>
<row><entry colsep="1" rowsep="1">0.90 ("beta 4")</entry><entry colsep="1"
rowsep="1">0.90</entry><entry colsep="1" rowsep="1">90</entry><entry colsep="1"
rowsep="1">0.90</entry></row>
<row><entry colsep="1" rowsep="1">0.95 ("beta 5")</entry><entry colsep="1"
rowsep="1">0.95</entry><entry colsep="1" rowsep="1">95</entry><entry colsep="1"
rowsep="1">0.95</entry></row>
<row><entry colsep="1" rowsep="1">0.96 ("beta 6")</entry><entry colsep="1"
rowsep="1">0.96</entry><entry colsep="1" rowsep="1">96</entry><entry colsep="1"
rowsep="1">0.96</entry></row>
<row><entry colsep="1" rowsep="1">0.97b ("beta 7")</entry><entry colsep="1"
rowsep="1">1.00.97</entry><entry colsep="1" rowsep="1">97</entry><entry colsep="1"
rowsep="1">1.0.1</entry></row>
<row><entry colsep="1" rowsep="1">0.97c</entry><entry colsep="1" rowsep="1">
0.97</entry><entry colsep="1" rowsep="1">97</entry><entry colsep="1" rowsep="1">
1.0.1</entry></row>
<row><entry colsep="1" rowsep="1">0.98</entry><entry colsep="1" rowsep="1">
0.98</entry><entry colsep="1" rowsep="1">98</entry><entry colsep="1" rowsep="1">
2.0.98</entry></row>
<row><entry colsep="1" rowsep="1">0.99</entry><entry colsep="1" rowsep="1">
0.99</entry><entry colsep="1" rowsep="1">98</entry><entry colsep="1" rowsep="1">
2.0.99</entry></row>
<row><entry colsep="1" rowsep="1">0.99a-m</entry><entry colsep="1" rowsep="1">
0.99</entry><entry colsep="1" rowsep="1">99</entry><entry colsep="1" rowsep="1">
2.0.99</entry></row>
<row><entry colsep="1" rowsep="1">1.00</entry><entry colsep="1" rowsep="1">
1.00</entry><entry colsep="1" rowsep="1">100</entry><entry colsep="1" rowsep="1">
2.1.0</entry></row>
<row><entry colsep="1" rowsep="1">1.0.0</entry><entry colsep="1" rowsep="1">
1.0.0</entry><entry colsep="1" rowsep="1">100</entry><entry colsep="1" rowsep="1">
2.1.0</entry></row>
<row><entry colsep="1" rowsep="1">1.0.0</entry><entry colsep="1" rowsep="1">
*</entry><entry colsep="1" rowsep="1">100</entry><entry colsep="1" rowsep="1">
2.1.0</entry></row>
<row><entry colsep="1" rowsep="1">1.0.1</entry><entry colsep="1" rowsep="1"></entry>
<entry colsep="1" rowsep="1">10001</entry><entry colsep="1" rowsep="1">2.1.0
</entry></row>
<row><entry colsep="1" rowsep="1">1.0.1a-e</entry><entry colsep="1" rowsep="1"></entry>
<entry colsep="1" rowsep="1">10002</entry><entry colsep="1" rowsep="1">#</entry>
</row>
<row><entry colsep="1" rowsep="1">1.0.2</entry><entry colsep="1" rowsep="1"></entry>
<entry colsep="1" rowsep="1">10002</entry><entry colsep="1" rowsep="1"></entry>
</row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.2a-b</entry><entry
colname="COLSPEC1" colsep="1" rowsep="1"></entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10003</entry><entry colname="COLSPEC3" colsep="1" rowsep="1"></entry>
</row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.1</entry><entry colname="COLSPEC1"
colsep="1" rowsep="1"></entry><entry colname="COLSPEC2" colsep="1" rowsep="1">
10001</entry><entry colname="COLSPEC3" colsep="1" rowsep="1"></entry></row>
<row><entry colname="COLSPEC0">1.0.1a-e</entry><entry colname="COLSPEC1"></entry>
<entry colname="COLSPEC2">10002</entry><entry colname="COLSPEC3">2.1.0.1a-e
</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.2</entry><entry colname="COLSPEC1"
colsep="1" rowsep="1"></entry><entry colname="COLSPEC2">10002</entry><entry
colname="COLSPEC3" colsep="1" rowsep="1">2.1.0.2</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.2a-b</entry><entry
colname="COLSPEC1" colsep="1" rowsep="1"></entry><entry colname="COLSPEC2">
10003</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">2.1.0.2a-b</entry>
</row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0</entry><entry colname="COLSPEC1"
colsep="1" rowsep="1"></entry><entry colname="COLSPEC2" colsep="1" rowsep="1">
10003</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">2.1.0</entry>
</row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0a-d</entry><entry
colname="COLSPEC1" colsep="1" rowsep="1"></entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10004</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
2.1.0a-d</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.4</entry><entry colname="COLSPEC1"
colsep="1" rowsep="1"></entry><entry colname="COLSPEC2" colsep="1" rowsep="1">
10004</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">2.1.0.4</entry>
</row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.4a-f</entry><entry
colname="COLSPEC1" colsep="1" rowsep="1"></entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10005</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
2.1.0.4a-f</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.5 (+ 2 patches)</entry>
<entry colname="COLSPEC1" colsep="1" rowsep="1"></entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10005</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
2.1.0.5</entry></row>
<row><entry colname="COLSPEC0">1.0.5a-d</entry><entry colname="COLSPEC1"></entry>
<entry colname="COLSPEC2">10006</entry><entry colname="COLSPEC3">2.1.0.5a-d
</entry></row>
<row><entry colname="COLSPEC0">1.0.5e-r</entry><entry colname="COLSPEC1"></entry>
<entry colname="COLSPEC2">10100</entry><entry colname="COLSPEC3">2.1.0.5e-r
</entry></row>
<row><entry colname="COLSPEC0">1.0.5s-v</entry><entry colname="COLSPEC1"></entry>
<entry colname="COLSPEC2">10006</entry><entry colname="COLSPEC3">2.1.0.5s-v
</entry></row>
<row><entry colname="COLSPEC0">1.0.6 (+ 3 patches)</entry><entry colname="COLSPEC1"></entry>
<entry colname="COLSPEC2">10006</entry><entry colname="COLSPEC3">2.1.0.6</entry>
</row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.6d-g</entry><entry
colname="COLSPEC1" colsep="1" rowsep="1"></entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10007</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
2.1.0.6d-g</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.6h</entry><entry
colname="COLSPEC1" colsep="1" rowsep="1"></entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10007</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
10.6h</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.6i</entry><entry
colname="COLSPEC1" colsep="1" rowsep="1"></entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10007</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
10.6i</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.6j</entry><entry
colname="COLSPEC1" colsep="1" rowsep="1"></entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10007</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
2.1.0.6j</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.7beta11-14</entry>
<entry colname="COLSPEC1" colsep="1" rowsep="1">DLLNUM</entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10007</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
2.1.0.7beta11-14</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.7beta15-18</entry>
<entry colname="COLSPEC1" colsep="1" rowsep="1">1</entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10007</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
2.1.0.7beta15-18</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.7rc1-2</entry><entry
colname="COLSPEC1" colsep="1" rowsep="1">1</entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10007</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
2.1.0.7rc1-2</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.7</entry><entry colname="COLSPEC1"
colsep="1" rowsep="1">1</entry><entry colname="COLSPEC2" colsep="1" rowsep="1">
10007</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">2.1.0.7</entry>
</row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.8beta1-4</entry>
<entry colname="COLSPEC1" colsep="1" rowsep="1">1</entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10008</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
2.1.0.8beta1-4</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.8rc1</entry><entry
colname="COLSPEC1" colsep="1" rowsep="1">1</entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10008</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
2.1.0.8rc1</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.8</entry><entry colname="COLSPEC1"
colsep="1" rowsep="1">1</entry><entry colname="COLSPEC2" colsep="1" rowsep="1">
10008</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">2.1.0.8</entry>
</row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.9beta1-6</entry>
<entry colname="COLSPEC1" colsep="1" rowsep="1">1</entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10009</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
2.1.0.9beta1-6</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.9rc1</entry><entry
colname="COLSPEC1" colsep="1" rowsep="1">1</entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10009</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
2.1.0.9rc1</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.9beta7-10</entry>
<entry colname="COLSPEC1" colsep="1" rowsep="1">1</entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10009</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
2.1.0.9beta7-10</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.9rc2</entry><entry
colname="COLSPEC1" colsep="1" rowsep="1">1</entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10009</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
2.1.0.9rc2</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.9</entry><entry colname="COLSPEC1"
colsep="1" rowsep="1">1</entry><entry colname="COLSPEC2" colsep="1" rowsep="1">
10009</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">2.1.0.9</entry>
</row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.10beta1</entry><entry
colname="COLSPEC1" colsep="1" rowsep="1">1</entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10010</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
2.1.0.10beta1</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.10rc1</entry><entry
colname="COLSPEC1" colsep="1" rowsep="1">1</entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10010</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
2.1.0.10rc1</entry></row>
<row><entry colname="COLSPEC0">1.0.10</entry><entry colname="COLSPEC1">1</entry>
<entry colname="COLSPEC2">10010</entry><entry colname="COLSPEC3">2.1.0.10
</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.11beta1-3</entry>
<entry colname="COLSPEC1" colsep="1" rowsep="1">1</entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10011</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
2.1.0.11beta1-3</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.11rc1</entry><entry
colname="COLSPEC1" colsep="1" rowsep="1">1</entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10011</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
2.1.0.11rc1</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.11</entry><entry
colname="COLSPEC1" colsep="1" rowsep="1">1</entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10011</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
2.1.0.11</entry></row>
<row><entry colname="COLSPEC0" colsep="1" rowsep="1">1.0.12beta1-2</entry>
<entry colname="COLSPEC1" colsep="1" rowsep="1">1</entry><entry colname="COLSPEC2"
colsep="1" rowsep="1">10012</entry><entry colname="COLSPEC3" colsep="1" rowsep="1">
2.1.0.12beta1-2</entry></row>
</tbody>
</tgroup>
</informaltable>
<variablelist>
<varlistentry><term>*</term><listitem><para>From this release forward, the <literal>
png.h</literal> string is identical to the source version.</para>
</listitem></varlistentry>
<varlistentry><term>#</term><listitem><para>From this release
forward, the shared library is 2.<replaceable>V</replaceable>, where <replaceable>
V</replaceable> is the source code version except as noted.</para>
</listitem></varlistentry>
</variablelist><para>Henceforth, the source version will match the shared-library
minor and patch numbers. The shared-library major version number will be used
for changes in backward compatibility, as it is intended. The PNG_PNGLIB_VER
macro, which is not used within <filename>libpng</filename> but is available
for applications, is an unsigned integer of the form <replaceable>xyyzz</replaceable>
corresponding to the source version <replaceable>x.y.z</replaceable> (leading
zeros in <replaceable>y</replaceable> and <replaceable>z</replaceable>). Beta
versions were given the previous public release number plus a letter, until
version 1.0.6j. From then on, they were given the upcoming public release
number plus "betaNN" or "rcN".</para>
</refsect2>
</refsect1>
<refsect1 id="libpng-3-attr"><title>&attr-tt;</title>
<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>
<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>
for descriptions of the following attributes:</para>
<informaltable frame="all">
<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">
<colspec colname="COLSPEC1" colwidth="1*">
<thead>
<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"
valign="middle">ATTRIBUTE VALUE</entry></row>
</thead>
<tbody>
<row><entry><para>Availability</para></entry><entry><para>image/library/libpng</para></entry>
</row>
<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry
colname="COLSPEC1"><para>Uncommitted</para></entry></row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="libpng-3-also"><title>&also-tt;</title>
<!--Reference to another man page-->
<!--Reference to a Help manual-->
<!--Reference to a book.-->
<para>
<citerefentry><refentrytitle>libpngpf</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>png</refentrytitle><manvolnum>4</manvolnum></citerefentry>,
<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>
</para>
<variablelist termlength="wholeline">
<varlistentry><term><filename>libpng</filename></term><listitem><para><programlisting>
<literal>ftp://ftp.uu.net/graphics/png</literal>
<literal>http://www.libpng.org/pub/png</literal></programlisting></para>
</listitem></varlistentry>
<varlistentry><term><filename>zlib</filename></term><listitem><para>Generally
at the same location as <filename>libpng</filename> or at <programlisting>
<literal>ftp://ftp.uu.net/pub/archiving/zip/zlib</literal>
<literal>ftp://ftp.info-zip.org/pub/infozip/zlib</literal></programlisting></para>
</listitem></varlistentry>
<varlistentry><term>PNGspecification:RFC2083</term><listitem><para>Generally
at the same location as <filename>libpng</filename> or at <literal>ftp://ds.internic.net/rfc/rfc2083.txt
</literal></para>
<para>or as a W3C Recommendation at
<literal>http://www.w3.org/TR/REC-png.html</literal></para>
</listitem></varlistentry>
</variablelist><para>In the case of any inconsistency between the PNG specification
and this library, the specification takes precedence.</para>
</refsect1>
<refsect1 id="libpng-3-note"><title>&note-tt;</title>
<para>This man page was originally written by Glenn Randers-Pehrson. Updated
by Breda McColgan, Sun Microsystems Inc., 2004.</para>
</refsect1>
</refentry>