Short:    Pdflib (libpdf) and tools V2.01 (68k+PPC)
Author:   Thomas Merz, Andreas R. Kleinert (port)
Uploader: info@ar-kleinert.de
Type:     text/misc

 Changes for Amiga 68k/PPC port are documented in
 in "CHANGES.amiga". Compiling instructions are
 in "COMPILE.amiga". For usage information, please
 refer to "readme.txt".

 PPC binaries have the .elf extension and can
 be executed from Shell when being used with
 ppc.library V46+

 There are two link library versions included:
 libpdf.lib (68k) and libpdf.a (PPC).

 Binaries can be found in "bin" directory, library files
 have been stored in "lib". Exception are the "pdftest"
 and "pdftest.elf" programs: they need to be run from
 the "test" directory, and that's why they're also
 located there.

 General information follows.

 --
 ARK, 28/Nov/99

************************************************************************

PDFlib V2.01
============
Portable C library for dynamically generating PDF ("Adobe Acrobat") files.
Copyright (c) 1997-1999 Thomas Merz (tm@muc.de)

The PDFlib distribution is available from the following URL:
http://www.ifconnection.de/~tm

THIS IS NOT PUBLIC DOMAIN OR FREEWARE SOFTWARE --
see end of this file for an overview of licensing and
usage issues, and the file doc/license.pdf for details.


Overview
========
PDFlib is a C library for generating PDF files. It offers a graphics
API with support for drawing, text, fonts, images, and hypertext. Call PDFlib
routines from within your client program and voila: dynamic PDF files!
For detailed instructions on PDFlib programming and the associated API,
see the PDFlib Programming Manual, included in PDF format in the
PDFlib distribution.


Supported Programming Environments
==================================
The PDFlib core library can be built as a static library or a shared
C library/DLL. PDFlib can be used from the following environments:

- ANSI C libary (static or dynamic)
- ANSI C++ via an object wrapper
- Perl5  with help from SWIG
- Tcl with help from SWIG
- Python with help from SWIG
- Java via the JNI with help from a hacked SWIG version
- Visual Basic with a DLL and a type library

- PHP3: PDFlib support is already included in the PHP3 distribution,
  see http://www.php.net. Note that PHP3 is not directly supported by
  the author of PDFlib.

The necessary "glue" for attaching PDFlib to these environments is
included in the distribution, as well as sample programs for all
supported environments.

Two sample applications are supplied for all supported language bindings:

- hello:        simple "hello, world!" program
- pdfclock:     generate a PDF file with an analog clock image


PDF Features
============
PDFlib's many features are covered in detail in the programming manual.
So let's just take a brief look at the most important ones:

- basic drawing
  lines, rectangles, arcs, Bezier curves, ...
  gray scale or RGB color
- text
  text in different fonts and sizes, formatting
  type 1 font embedding, built-in font metrics, AFM metrics files for
  additional fonts
- image file formats
  support for CCITT, TIFF, GIF, and JPEG files
- PDF output compression via Zlib
- hypertext features
  bookmarks, page transitions, Web and local links, PDF file attachments
- Unicode support for annotations, bookmarks, and document information


PDFlib application ideas
========================
- Dynamic PDF generation on a Web server
- Directly convert text or graphics files to PDF
- Report generator for applications such as databases
- PDF-generating printer driver for all kinds of applications
- ...many more!


Supplied Library Clients
========================
PDFlib includes some test and real client programs:

- pdftest:      general C test program, illustrates many PDF features
- pdfimage:     convert GIF/TIFF/JPEG images to PDF
- text2pdf:     convert text files to PDF
- pdfgraph:     draw a graph according to data read from a text file


============================= Archive contents =============================

Original  Packed Ratio    Date     Time    Name
-------- ------- ----- --------- --------  -------------
   95244   45281 52.4% 28-Nov-99 10:53:34 +pdfgraph
  188342   71768 61.8% 28-Nov-99 10:58:02 +pdfgraph.elf
   91608   43540 52.4% 28-Nov-99 10:53:34 +pdfimage
  185307   70948 61.7% 28-Nov-99 10:57:50 +pdfimage.elf
   90416   42919 52.5% 28-Nov-99 10:53:34 +text2pdf
  181382   69134 61.8% 28-Nov-99 10:58:16 +text2pdf.elf
    2671    1029 61.4% 28-Nov-99 10:03:16 +c.dsp
     933     467 49.9% 28-Nov-99 10:03:12 +hello.c
    1247     501 59.8% 28-Nov-99 10:03:16 +Makefile.in
    3951    1348 65.8% 28-Nov-99 10:03:12 +pdfclock.c
      44      44  0.0% 28-Nov-99 10:03:10 +readme.txt
     122     101 17.2% 28-Nov-99 10:03:12 +pdfclock.cgi
    2823    1040 63.1% 28-Nov-99 10:03:16 +Cplusplus.dsp
     953     495 48.0% 28-Nov-99 10:03:12 +hello.cpp
    1605     598 62.7% 28-Nov-99 10:03:16 +Makefile.in
    4063    1447 64.3% 28-Nov-99 10:03:12 +pdfclock.cpp
    9683    2471 74.4% 28-Nov-99 10:03:12 +pdflib.cpp
    6717    2129 68.3% 28-Nov-99 10:03:12 +pdflib.hpp
     343     223 34.9% 28-Nov-99 10:03:10 +readme.txt
     972     463 52.3% 28-Nov-99 10:03:12 +hello.java
    4683    1262 73.0% 28-Nov-99 10:03:16 +Java.dsp
    1919     809 57.8% 28-Nov-99 10:03:16 +Makefile.in
    3039     952 68.6% 28-Nov-99 10:03:12 +pdfclock.java
    7752    1137 85.3% 28-Nov-99 10:03:12 +pdflib.java
   44540    4672 89.5% 28-Nov-99 10:03:12 +pdflib_java.c
     731     422 42.2% 28-Nov-99 10:03:10 +readme.txt
     701     382 45.5% 28-Nov-99 10:03:14 +hello.pl
    1868     815 56.3% 28-Nov-99 10:03:16 +Makefile.in
     485     307 36.7% 28-Nov-99 10:03:14 +Makefile.PL.in
    2040     678 66.7% 28-Nov-99 10:03:14 +pdfclock.pl
    4188    1022 75.5% 28-Nov-99 10:03:14 +pdflib.pm
   72779    9716 86.6% 28-Nov-99 10:03:14 +pdflib_pl.c
    4833    1300 73.1% 28-Nov-99 10:03:16 +Perl.dsp
    3004    1402 53.3% 28-Nov-99 10:03:10 +readme.txt
     740     402 45.6% 28-Nov-99 10:03:14 +hello.py
    1569     691 55.9% 28-Nov-99 10:03:16 +Makefile.in
    2042     711 65.1% 28-Nov-99 10:03:14 +pdfclock.py
   84292    9927 88.2% 28-Nov-99 10:03:14 +pdflib_py.c
    4825    1294 73.1% 28-Nov-99 10:03:16 +Python.dsp
     314     208 33.7% 28-Nov-99 10:03:10 +readme.txt
     916     507 44.6% 28-Nov-99 10:03:14 +hello.tcl
    1810     768 57.5% 28-Nov-99 10:03:16 +Makefile.in
    2738    1012 63.0% 28-Nov-99 10:03:14 +pdfclock.tcl
   95077   10149 89.3% 28-Nov-99 10:03:14 +pdflib_tcl.c
    1798     736 59.0% 28-Nov-99 10:03:14 +pkgIndex.tcl
     365     237 35.0% 28-Nov-99 10:03:10 +readme.txt
    4792    1285 73.1% 28-Nov-99 10:03:16 +Tcl.dsp
    1161     569 50.9% 28-Nov-99 10:03:14 +hello.bas
    2468     831 66.3% 28-Nov-99 10:03:14 +pdfclock.bas
    3361    1116 66.7% 28-Nov-99 10:03:14 +pdflib_vb.def
   15825    3674 76.7% 28-Nov-99 10:03:14 +pdflib_vb.idl
     207     150 27.5% 28-Nov-99 10:03:10 +readme.txt
    4688    1243 73.4% 28-Nov-99 10:03:16 +VisualBasic.dsp
    1477     522 64.6% 28-Nov-99 10:03:16 +Makefile.in
   95244   45281 52.4% 28-Nov-99 10:53:04 +pdfgraph
    4270    1554 63.6% 28-Nov-99 10:03:08 +pdfgraph.c
   91608   43540 52.4% 28-Nov-99 10:52:36 +pdfimage
    4838    1779 63.2% 28-Nov-99 10:03:08 +pdfimage.c
     359     210 41.5% 28-Nov-99 10:45:58 +SCOPTIONS
    1810     611 66.2% 28-Nov-99 10:53:00 +smakefile
    1903     636 66.5% 28-Nov-99 10:58:22 +smakefilePPC
   90416   42919 52.5% 28-Nov-99 10:53:12 +text2pdf
    4942    1755 64.4% 28-Nov-99 10:03:08 +text2pdf.c
   68846   18392 73.2% 28-Nov-99 10:03:14 +configure
   21494    5698 73.4% 28-Nov-99 10:03:14 +configure.in
   33841   12910 61.8% 28-Nov-99 10:03:10 +changes.txt
    3374    1155 65.7% 28-Nov-99 10:03:08 +compatibility.txt
    1975     652 66.9% 28-Nov-99 10:03:08 +install.txt
   10852    8094 25.4% 28-Nov-99 10:03:12 +license.pdf
 1012592  668555 33.9% 28-Nov-99 10:03:12 +PDFlib.pdf
   15352    3959 74.2% 28-Nov-99 10:03:14 +Courier-Bold.afm
   15422    4070 73.6% 28-Nov-99 10:03:14 +Courier-BoldOblique.afm
   15443    4076 73.6% 28-Nov-99 10:03:14 +Courier-Oblique.afm
   15339    3953 74.2% 28-Nov-99 10:03:14 +Courier.afm
   17110    4631 72.9% 28-Nov-99 10:03:14 +Helvetica-Bold.afm
   17185    4778 72.1% 28-Nov-99 10:03:14 +Helvetica-BoldOblique.afm
   17873    4917 72.4% 28-Nov-99 10:03:14 +Helvetica-Oblique.afm
   17793    4773 73.1% 28-Nov-99 10:03:14 +Helvetica.afm
    2407     956 60.2% 28-Nov-99 10:03:14 +pdflib.upr
     168     119 29.1% 28-Nov-99 10:03:14 +readme.txt
    9644    3374 65.0% 28-Nov-99 10:03:14 +Symbol.afm
   17934    4980 72.2% 28-Nov-99 10:03:14 +Times-Bold.afm
   18021    5066 71.8% 28-Nov-99 10:03:14 +Times-BoldItalic.afm
   18019    5061 71.9% 28-Nov-99 10:03:14 +Times-Italic.afm
   17893    4925 72.4% 28-Nov-99 10:03:14 +Times-Roman.afm
    9467    2484 73.7% 28-Nov-99 10:03:14 +ZapfDingbats.afm
  151540   53651 64.5% 28-Nov-99 10:41:32 +libpdf.a
   84988   34839 59.0% 28-Nov-99 10:28:54 +libpdf.lib
   10195    2685 73.6% 28-Nov-99 10:03:14 +Makefile.in
    2680     388 85.5% 28-Nov-99 10:03:14 +PDFlib.dsw
  189256   27546 85.4% 28-Nov-99 10:03:16 +PDFlib.mcp
    8160    2817 65.4% 28-Nov-99 10:03:08 +ansi_e.h
     218     124 43.1% 07-Mar-99 21:00:24 +libc.h
      18      18  0.0% 07-Mar-99 20:57:36 +process.h
     217     124 42.8% 07-Mar-99 20:43:20 +unistd.h
    8053    2770 65.6% 28-Nov-99 10:03:08 +macrom_e.h
    3467    1054 69.5% 28-Nov-99 10:23:44 +Makefile.in
   37478    7875 78.9% 28-Nov-99 10:03:08 +p_afmparse.c
    6159    2245 63.5% 28-Nov-99 10:03:08 +p_afmparse.h
   21996    4688 78.6% 28-Nov-99 10:03:08 +p_annots.c
   23907    7310 69.4% 28-Nov-99 10:03:08 +p_basic.c
    6429    2373 63.0% 28-Nov-99 10:03:08 +p_ccitt.c
    4373    1200 72.5% 28-Nov-99 10:03:08 +p_color.c
    2540     980 61.4% 28-Nov-99 10:03:08 +p_config.h
    7866    2167 72.4% 28-Nov-99 10:03:08 +p_draw.c
    7548    2670 64.6% 28-Nov-99 10:03:08 +p_filter.c
   20201    5793 71.3% 28-Nov-99 10:03:08 +p_font.c
     300     221 26.3% 28-Nov-99 10:15:02 +p_gif.c
   15441    4951 67.9% 28-Nov-99 10:05:34 +p_gif_original.c
    6188    1796 70.9% 28-Nov-99 10:03:08 +p_gstate.c
   10469    3111 70.2% 28-Nov-99 10:03:08 +p_hyper.c
   17763    5011 71.7% 28-Nov-99 10:03:08 +p_image.c
   17296    5368 68.9% 28-Nov-99 10:03:08 +p_intern.h
   12464    4076 67.2% 28-Nov-99 10:03:08 +p_jpeg.c
   79966    7617 90.4% 28-Nov-99 10:03:08 +p_metrics.h
    5752    1729 69.9% 28-Nov-99 10:03:08 +p_text.c
    5871    2064 64.8% 28-Nov-99 10:03:08 +p_tiff.c
   11690    3819 67.3% 28-Nov-99 10:03:08 +p_util.c
    8141    2847 65.0% 28-Nov-99 10:03:08 +pdfdoc_e.h
    4181    1175 71.8% 28-Nov-99 10:03:16 +pdflib.dsp
   23367    5931 74.6% 28-Nov-99 10:03:08 +pdflib.h
    7748    2930 62.1% 28-Nov-99 10:03:08 +pdflib.i
    4494    1112 75.2% 28-Nov-99 10:03:16 +pdflib_static.dsp
     331     197 40.4% 07-Mar-99 20:52:22 +SCOPTIONS
    3735    1064 71.5% 28-Nov-99 10:37:32 +smakefile
    3403    1053 69.0% 28-Nov-99 10:41:12 +smakefilePPC
    8489    3628 57.2% 28-Nov-99 10:03:08 +readme.txt
   99842   99842  0.0% 28-Nov-99 10:03:12 +acroweb_j.tif
     840     395 52.9% 28-Nov-99 10:03:12 +graphdata
     932     437 53.1% 28-Nov-99 10:03:16 +Makefile.in
   37406   37406  0.0% 28-Nov-99 10:03:12 +nesrin.jpg
   23016   23016  0.0% 28-Nov-99 10:03:12 +pdflib.gif
  108664   52685 51.5% 28-Nov-99 11:03:46 +pdftest
   24720    6670 73.0% 28-Nov-99 10:23:40 +pdftest.c
  221569   85337 61.4% 28-Nov-99 11:06:54 +pdftest.elf
     359     210 41.5% 28-Nov-99 10:59:54 +SCOPTIONS
    1166     531 54.4% 28-Nov-99 11:01:26 +smakefile
    1233     564 54.2% 28-Nov-99 11:05:40 +smakefilePPC
    4407    1155 73.7% 28-Nov-99 10:03:16 +test.dsp
    3735    3006 19.5% 28-Nov-99 10:03:12 +tm.g3
    7171    2350 67.2% 28-Nov-99 10:03:16 +compile_metrics.c
    3798    1756 53.7% 28-Nov-99 10:03:16 +getopt.c
    5598    2233 60.1% 28-Nov-99 10:03:16 +install-sh
    1435     628 56.2% 28-Nov-99 10:03:16 +Makefile.in
     359     210 41.5% 28-Nov-99 10:49:44 +SCOPTIONS
      71      71  0.0% 28-Nov-99 10:51:28 +smakefile
      83      83  0.0% 28-Nov-99 10:54:02 +smakefilePPC
     597     357 40.2% 28-Nov-99 11:19:48 +CHANGES.amiga
    1041     390 62.5% 28-Nov-99 11:19:04 +COMPILE.amiga
    3916    1848 52.8% 28-Nov-99 11:18:00 +pdflib.readme
-------- ------- ----- --------- --------
 4321223 1876914 56.5% 28-Nov-99 18:15:30   150 files
