<!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 suncopy "Copyright (c) 2004, Sun Microsystems, Inc. 
Copyright (c) 1998 Addison Wesley Longman, Inc.
 All Rights Reserved.">
<!ENTITY cmd "libpngpf">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % gnomecommonents SYSTEM "gnomecommon.ent">
%gnomecommonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
]>
<?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 minus
 equals bsol sol amp>
<?Pub Inc>
<refentry id="libpngpf-3">
<!-- %Z%%M% %I% %E% SMI; -->
<refmeta><refentrytitle>libpngpf</refentrytitle><manvolnum>3</manvolnum>
<refmiscinfo class="date">26 Mar 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>libpngpf</primary></indexterm><indexterm><primary>Portable
Network Graphics (PNG) Reference Library 1.0.12 (private functions)</primary>
</indexterm>
<refnamediv id="libpngpf-3-name"><refname>libpng</refname><refpurpose>Portable
Network Graphics (PNG) Reference Library 1.0.12 (private functions)</refpurpose>
</refnamediv>
<refsect1 id="libpngpf-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

void png_build_gamma_table (png_structp png_ptr);

void png_build_grayscale_palette (int bit_depth,  png_colorp
palette);

void png_calculate_crc (png_structp png_ptr, png_bytep  ptr,
png_size_t length);

void png_check_chunk_name  (png_structp  png_ptr,  png_bytep
chunk_name);

png_size_t png_check_keyword (png_structp png_ptr, png_charp
key, png_charpp new_key);

void png_combine_row (png_structp  png_ptr,  png_bytep  row,
int mask);

void png_correct_palette  (png_structp  png_ptr,  png_colorp
palette, int num_palette);

int png_crc_error (png_structp png_ptr);

int png_crc_finish (png_structp png_ptr, png_uint_32 skip);

void  png_crc_read  (png_structp  png_ptr,  png_bytep   buf,
png_size_t length);

png_voidp  png_create_struct   (int   type,   png_malloc_ptr
malloc_fn);

png_voidp png_create_struct_2 (int type);

png_charp  png_decompress_chunk  (png_structp  png_ptr,  int
comp_type,   png_charp  chunkdata,  png_size_t  chunklength,
png_size_t prefix_length, png_size_t *data_length);

void png_destroy_struct (png_voidp struct_ptr);

void     png_destroy_struct_2     (png_voidp     struct_ptr,
png_free_ptr free_fn);

void png_do_background  (png_row_infop  row_info,  png_bytep
row,  png_color_16p  trans_values, png_color_16p background,
png_color_16p background_1, png_bytep gamma_table, png_bytep
gamma_from_1,  png_bytep gamma_to_1, png_uint_16pp gamma_16,
png_uint_16pp gamma_16_from_1, png_uint_16pp  gamma_16_to_1,
int gamma_shift);

void png_do_bgr (png_row_infop row_info, png_bytep row);

void png_do_chop (png_row_infop row_info, png_bytep row);

void png_do_dither (png_row_infop row_info,  png_bytep  row,
png_bytep palette_lookup, png_bytep dither_lookup);

void png_do_expand (png_row_infop row_info,  png_bytep  row,

png_color_16p trans_value);

void    png_do_expand_palette    (png_row_infop    row_info,
png_bytep  row,  png_colorp  palette,  png_bytep  trans, int
num_trans);

void png_do_gamma (png_row_infop  row_info,  png_bytep  row,
png_bytep  gamma_table,  png_uint_16pp  gamma_16_table,  int
gamma_shift);

void png_do_gray_to_rgb (png_row_infop  row_info,  png_bytep
row);

void png_do_invert (png_row_infop row_info, png_bytep row);

void png_do_pack  (png_row_infop  row_info,  png_bytep  row,
png_uint_32 bit_depth);

void  png_do_packswap  (png_row_infop  row_info,   png_bytep
row);

void png_do_read_filler (png_row_infop  row_info,  png_bytep
row, png_uint_32 filler, png_uint_32 flags);

void    png_do_read_interlace    (png_row_infop    row_info,
png_bytep row, int pass, png_uint_32 transformations);

void   png_do_read_invert_alpha   (png_row_infop   row_info,
png_bytep row);

void   png_do_read_swap_alpha    (png_row_infop    row_info,
png_bytep row);

void png_do_read_transformations (png_structp png_ptr);

int png_do_rgb_to_gray  (png_row_infop  row_info,  png_bytep
row);

void png_do_shift (png_row_infop  row_info,  png_bytep  row,
png_color_8p bit_depth);

void png_do_strip_filler (png_row_infop row_info,  png_bytep
row, png_uint_32 flags);

void png_do_swap (png_row_infop row_info, png_bytep row);

void png_do_unpack (png_row_infop row_info, png_bytep row);

void png_do_unshift (png_row_infop row_info, png_bytep  row,
png_color_8p sig_bits);

void   png_do_write_interlace    (png_row_infop    row_info,
png_bytep row, int pass);

void  png_do_write_invert_alpha   (png_row_infop   row_info,
png_bytep row);

void   png_do_write_swap_alpha   (png_row_infop    row_info,
png_bytep row);

void png_do_write_transformations (png_structp png_ptr);

void *png_far_to_near  (png_structp  png_ptr,png_voidp  ptr,
int check);

void png_flush (png_structp png_ptr);

png_int_32 png_get_int_32 (png_bytep buf);

png_uint_16 png_get_uint_16 (png_bytep buf);

png_uint_32 png_get_uint_32 (png_bytep buf);

int png_handle_as_unknown  (png_structp  png_ptr,  png_bytep
chunk_name);

void   png_handle_bKGD   (png_structp   png_ptr,   png_infop
info_ptr, png_uint_32 length);

void   png_handle_cHRM   (png_structp   png_ptr,   png_infop
info_ptr, png_uint_32 length);

void   png_handle_gAMA   (png_structp   png_ptr,   png_infop
info_ptr, png_uint_32 length);

void   png_handle_hIST   (png_structp   png_ptr,   png_infop
info_ptr, png_uint_32 length);

void   png_handle_IEND   (png_structp   png_ptr,   png_infop
info_ptr, png_uint_32 length);

void   png_handle_IHDR   (png_structp   png_ptr,   png_infop
info_ptr, png_uint_32 length);

void   png_handle_iCCP   (png_structp   png_ptr,   png_infop
info_ptr, png_uint_32 length);

void   png_handle_iTXt   (png_structp   png_ptr,   png_infop
info_ptr, png_uint_32 length);

void   png_handle_oFFs   (png_structp   png_ptr,   png_infop
info_ptr, png_uint_32 length);

void   png_handle_pCAL   (png_structp   png_ptr,   png_infop
info_ptr, png_uint_32 length);

void   png_handle_pHYs   (png_structp   png_ptr,   png_infop
info_ptr, png_uint_32 length);

void   png_handle_PLTE   (png_structp   png_ptr,   png_infop
info_ptr, png_uint_32 length);

void   png_handle_sBIT   (png_structp   png_ptr,   png_infop
info_ptr, png_uint_32 length);

void   png_handle_sCAL   (png_structp   png_ptr,   png_infop
info_ptr, png_uint_32 length);

void   png_handle_sPLT   (png_structp   png_ptr,   png_infop
info_ptr, png_uint_32 length);

void   png_handle_sRGB   (png_structp   png_ptr,   png_infop
info_ptr, png_uint_32 length);

void   png_handle_tEXt   (png_structp   png_ptr,   png_infop
info_ptr, png_uint_32 length);

void   png_handle_tIME   (png_structp   png_ptr,   png_infop
info_ptr, png_uint_32 length);

void   png_handle_tRNS   (png_structp   png_ptr,   png_infop
info_ptr, png_uint_32 length);

void  png_handle_unknown  (png_structp  png_ptr,   png_infop
info_ptr, png_uint_32 length);

void   png_handle_zTXt   (png_structp   png_ptr,   png_infop
info_ptr, png_uint_32 length);

void  png_info_destroy   (png_structp   png_ptr,   png_infop
info_ptr);

void png_init_read_transformations (png_structp png_ptr);

void png_process_IDAT_data (png_structp  png_ptr,  png_bytep
buffer, png_size_t buffer_length);

void png_process_some_data (png_structp  png_ptr,  png_infop
info_ptr);

void png_push_check_crc (png_structp png_ptr);

void png_push_crc_finish (png_structp png_ptr);

void  png_push_crc_skip  (png_structp  png_ptr,  png_uint_32
length);

void png_push_fill_buffer  (png_structp  png_ptr,  png_bytep
buffer, png_size_t length);

void png_push_handle_tEXt  (png_structp  png_ptr,  png_infop
info_ptr, png_uint_32 length);

void png_push_handle_unknown (png_structp png_ptr, png_infop
info_ptr, png_uint_32 length);

void png_push_handle_zTXt  (png_structp  png_ptr,  png_infop
info_ptr, png_uint_32 length);

void  png_push_have_end  (png_structp   png_ptr,   png_infop
info_ptr);

void  png_push_have_info  (png_structp  png_ptr,   png_infop
info_ptr);

void png_push_have_row (png_structp png_ptr, png_bytep row);

void png_push_process_row (png_structp png_ptr);

void  png_push_read_chunk  (png_structp  png_ptr,  png_infop
info_ptr);

void  png_push_read_end  (png_structp   png_ptr,   png_infop
info_ptr);

void png_push_read_IDAT (png_structp png_ptr);

void  png_push_read_sig  (png_structp   png_ptr,   png_infop
info_ptr);

void  png_push_read_tEXt  (png_structp  png_ptr,   png_infop
info_ptr);

void  png_push_read_zTXt  (png_structp  png_ptr,   png_infop
info_ptr);

void png_push_restore_buffer (png_structp png_ptr, png_bytep
buffer, png_size_t buffer_length);

void png_push_save_buffer (png_structp png_ptr);

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

void png_read_filter_row (png_structp png_ptr, png_row_infop
row_info, png_bytep row, png_bytep prev_row, int filter);

void png_read_finish_row (png_structp png_ptr);

void png_read_push_finish_row (png_structp png_ptr);

void png_read_start_row (png_structp png_ptr);

void png_read_transform_info (png_structp png_ptr, png_infop
info_ptr);

void png_reset_crc (png_structp png_ptr);

void png_save_int_32 (png_bytep buf, png_int_32 i);

void png_save_uint_16 (png_bytep buf, unsigned int i);

void png_save_uint_32 (png_bytep buf, png_uint_32 i);

void  png_write_bKGD  (png_structp  png_ptr,   png_color_16p
values, int color_type);

void png_write_cHRM (png_structp  png_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_write_cHRM_fixed (png_structp png_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_write_data (png_structp  png_ptr,  png_bytep  data,
png_size_t length);

void png_write_filtered_row (png_structp png_ptr,  png_bytep
filtered_row);

void     png_write_find_filter     (png_structp     png_ptr,
png_row_infop row_info);

void png_write_finish_row (png_structp png_ptr);

void    png_write_gAMA    (png_structp    png_ptr,    double
file_gamma);

void png_write_gAMA_fixed (png_structp png_ptr,  png_uint_32
int_file_gamma);

void png_write_hIST (png_structp png_ptr, png_uint_16p hist,
int num_hist);

void png_write_iCCP (png_structp  png_ptr,  png_charp  name,
int compression_type, png_charp profile, int proflen);

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

void png_write_IEND (png_structp png_ptr);

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

void png_write_iTXt (png_structp png_ptr,  int  compression,
png_charp  key,  png_charp  lang,  png_charp translated_key,
png_charp text));

void  png_write_oFFs   (png_structp   png_ptr,   png_uint_32
x_offset, png_uint_32 y_offset, int unit_type);

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

void  png_write_pHYs   (png_structp   png_ptr,   png_uint_32
x_pixels_per_unit,    png_uint_32   y_pixels_per_unit,   int
unit_type);

void   png_write_PLTE   (png_structp   png_ptr,   png_colorp
palette, png_uint_32 num_pal);

void png_write_sBIT (png_structp png_ptr, png_color_8p sbit,
int color_type);

void png_write_sCAL (png_structp  png_ptr,  png_charp  unit,
double width, double height);

void png_write_sCAL_s (png_structp png_ptr, png_charp  unit,
png_charp width, png_charp height);

void png_write_sig (png_structp png_ptr);

void png_write_sRGB (png_structp png_ptr, int intent);

void  png_write_sPLT  (png_structp  png_ptr,  png_spalette_p
palette);

void png_write_start_row (png_structp png_ptr);

void png_write_tEXt  (png_structp  png_ptr,  png_charp  key,
png_charp text, png_size_t text_len);

void   png_write_tIME   (png_structp   png_ptr,    png_timep
mod_time);

void png_write_tRNS (png_structp png_ptr,  png_bytep  trans,
png_color_16p values, int number, int color_type);

void png_write_zTXt  (png_structp  png_ptr,  png_charp  key,
png_charp text, png_size_t text_len, int compression);

voidpf png_zalloc (voidpf png_ptr, uInt items, uInt size);

void png_zfree (voidpf png_ptr, voidpf ptr);

</programlisting>
</refsect1>
<refsect1 id="libpngpf-3-desc"><title>&desc-tt;</title>
<para>The functions listed above are used privately by <filename>libpng</filename>
and are not recommended for use by applications. The functions are listed
alphabetically here as an aid to <filename>libpng</filename> maintainers.
See <filename>png.h</filename> for more information about these functions.
</para>
</refsect1>
<refsect1 id="libpngpf-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="libpngpf-3-also"><title>&also-tt;</title>
<!--Reference to another man page-->
<!--Reference to a Help manual-->
<!--Reference to a book.-->
<para>
<citerefentry><refentrytitle>libpng</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>png</refentrytitle><manvolnum>4</manvolnum></citerefentry>,
<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>
</para>
</refsect1>
<refsect1 id="libpngpf-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>
