
CONTENTS
========
1. Purpose of the package
2. Installation
3. Recent sources and documentation
4. Developer information
5. Contact



1. Purpose of the package
=========================
This package contains the png2pdf program. This program converts PNG
images to PDF files. It can use the PNG alpha channel to mix against
a background (either from the PNG file's background chunk or user
specified) and/or to create an image mask or PDF alpha channel.

This software is released under the GNU General Public License, version 2.
See the file COPYING for details.



2. Installation
===============

2.1 Installation on Unix/Linux
------------------------------

2.1.1 Required libraries
The following libraries are required to install png2pdf:
- zlib    (required)
  http://www.gzip.org/zlib
- bzip2   (recommended)
  http://sources.redhat.com/bzip2/
- libpng  (required)
  http://www.libpng.org/pub/png/libpng.html
- dklibs  (required)
  http://sourceforge.net/projects/dklibs
Note: If you use package management software to install these libraries
make sure the developer support (C header files...) is installed too.
Some package managers use separated packages (xxx-dev) to provide
developer support for libraries.

2.1.2 Installation procedure
After unpacking the png2pdf source the usual
  ./configure
  make
  make install
procedure should work.

2.2 Installation on Windows
---------------------------
Windows users are encourage to use the setup executables from
http://sourceforge.net/projects/dklibs in the
dklibs-win32 package. The *user*.exe file installs the programs
and the documentataion, the *dev*.exe file also installs the
sources for all the programs and all the libraries needed to
build the programs.


3. Recent sources and documentation
===================================
The project is hosted on SourceForge, see
  http://png2pdf.sourceforge.net
and
  http://sourceforge.net/projects/png2pdf
for the most recent sources and documentation.



4. Developer Information
========================

For each module you find 2 source files: *.ctr and *.c.
The *.c file is created from the *.ctr file by running tracecc.
If you want to apply changes to the source, do it in the *.ctr
file.



5. Contact
==========
You can contact me using the contact form
http://www.fh-schmalkalden.de/url.php?/page/1026/select_wert/3023 on
our faculty's web server.
Please use "png2pdf bug" or "png2pdf suggestion" in the subject.

The bugtracking and feature mechanisms on the SourceForge
web site http://sourceforge.net/projects/png2pdf can also be used,
I check them approximately once per month.

Dirk Krause
2005-02-15


