___                                    ____  _   _  ____       
  |_ _|_ __ ___   __ _  __ _  ___   _ _  |  _ \| \ | |/ ___|  _ _ 
   | || '_ ` _ \ / _` |/ _` |/ _ \ (_|_) | |_) |  \| | |  _  (_|_)
   | || | | | | | (_| | (_| |  __/  _ _  |  __/| |\  | |_| |  _ _ 
  |___|_| |_| |_|\__,_|\__, |\___| (_|_) |_|   |_| \_|\____| (_|_)
                       |___/                                      
   _     _ _                       
  | |   (_) |__  _ __  _ __   __ _ 
  | |   | | '_ \| '_ \| '_ \ / _` |
  | |___| | |_) | |_) | | | | (_| |
  |_____|_|_.__/| .__/|_| |_|\__, |
                |_|          |___/ 


This is the README for Image::PNG::Libpng version 0.58.

Image::PNG::Libpng is a "module" for the Perl computer programming
language, a library of computer code to install on a computer.  This
document contains four sections:

1. About - what the module does

2. Documentation - how to learn more about the module

3. Installation - how to install this module on a computer

4. Help - what to do if you get stuck

-----------------------------------------------------------------------------

1. ABOUT

Image::PNG::Libpng - Perl interface to libpng

Image::PNG::Libpng is a Perl library for accessing the contents of PNG
(Portable Network Graphics) images. Image::PNG::Libpng enables Perl to
use the "libpng" library to read and write files in PNG
format. Image::PNG::Libpng does not contain the libpng library. The
libpng library must be installed on your computer prior to installing
Image::PNG::Libpng.

Image::PNG::Libpng consists of Perl subroutines which mirror
the C functions in libpng, plus helper subroutines to make it easier
to read and write PNG data in Perl. 

For those familiar with libpng, the section "Differences
from libpng" explains the differences with libpng.

-----------------------------------------------------------------------------

2. DOCUMENTATION

You can read the documentation for the module online at the following
website:

    * http://metacpan.org/release/Image-PNG-Libpng

(This link goes to the latest version of the module.)

After installing the module, you can read the documentation on your
computer using

    perldoc Image::PNG::Libpng

-----------------------------------------------------------------------------

3. INSTALLATION

This module requires Perl version 5.8.1 or later.

To install the module from CPAN, use

    cpan Image::PNG::Libpng

If you have the App::cpanminus installer, you may prefer

    cpanm Image::PNG::Libpng

To install the module from the source file, Image-PNG-Libpng-0.58.tar.gz,
follow this sequence of commands:

    tar xfz Image-PNG-Libpng-0.58.tar.gz
    cd Image-PNG-Libpng-0.58
    perl Makefile.PL
    make
    make install

If you want to test the module before installing it, use "make test" after
"make" and before "make install".

-----------------------------------------------------------------------------

4. HELP

To get help with the module, you can email the author, Ben Bullock, at
<benkasminbullock@gmail.com>. If you think there is a problem in the
module, you can report a bug at 

<https://github.com/benkasminbullock/image-png-libpng/issues>,

or if you want to alter the source code of Image::PNG::Libpng, try the
public repository on github at 

<https://github.com/benkasminbullock/image-png-libpng>. 

-----------------------------------------------------------------------------

This README was written on Mon Jan 29 09:09:10 2024.

-----------------------------------------------------------------------------