home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / pdflb302.zip / pdf / pdflib-3.0.2 / readme.txt < prev   
Text File  |  2000-08-21  |  10KB  |  261 lines
  1. PDFlib V3.02
  2. ============
  3. Portable C library for dynamically generating PDF ("Adobe Acrobat") files,
  4. with support for many other programming languages.
  5.  
  6. Copyright (c) 1997-2000 Thomas Merz and PDFlib GmbH
  7.  
  8. The PDFlib distribution is available from http://www.pdflib.com
  9.  
  10. THIS IS NOT PUBLIC DOMAIN OR FREEWARE SOFTWARE -- 
  11. see end of this file for an overview of licensing and
  12. usage issues, and the file doc/PDFlib-license.pdf for details.
  13.  
  14.  
  15. Overview
  16. ========
  17. PDFlib is a C library for generating PDF files. It offers a graphics
  18. API with support for drawing, text, fonts, images, and hypertext. Call PDFlib
  19. routines from within your client program and voila: dynamic PDF files!
  20. For detailed instructions on PDFlib programming and the associated API,
  21. see the PDFlib Programming Manual, included in PDF format in the
  22. PDFlib distribution.
  23.  
  24.  
  25. Supported Programming Environments
  26. ==================================
  27. The PDFlib core library can be built as a static library or a shared
  28. C library/DLL. PDFlib can be used from the following environments:
  29.  
  30. - ANSI C libary (static or dynamic)
  31. - ANSI C++ via an object wrapper
  32. - Perl
  33. - Tcl
  34. - Python
  35. - Java via the JNI, including servlets
  36. - ActiveX/COM (Visual Basic, Active Server Pages with VBScript and JScript,
  37.   Windows Script Host, Delphi, and numerous other environments). The
  38.   ActiveX edition of PDFlib is available separately.
  39.  
  40. The necessary wrappers for attaching PDFlib to these environments are
  41. included in the distribution (except for ActiveX), as well as sample
  42. programs for all supported environments.
  43.  
  44. Three sample applications are supplied for all supported language bindings:
  45.  
  46. - hello:    simple "hello, world!" program
  47. - pdfclock:    generate a PDF file with an analog clock image
  48. - image:    embed a JPEG image in the PDF output
  49.  
  50.  
  51. PDF Features
  52. ============
  53. PDFlib's many features are covered in detail in the programming manual.
  54. So let's just take a brief look at the most important ones:
  55.  
  56. - basic drawing
  57.   lines, rectangles, arcs, Bezier curves, ...
  58.   gray scale or RGB color
  59. - text
  60.   text in different fonts and sizes, formatting
  61.   type 1 font embedding, built-in font metrics, AFM metrics files for 
  62.   additional fonts, additional encodings
  63. - image file formats
  64.   support for PNG, CCITT, TIFF, GIF, and JPEG files
  65. - PDF output compression via Zlib
  66. - hypertext features
  67.   bookmarks, page transitions, Web and local links, PDF file attachments
  68. - Unicode support for hypertext and CJK page descriptions
  69. - CID font support for Chinese, Japanese, and Korean text
  70.  
  71.  
  72. Supplied Library Clients
  73. ========================
  74. PDFlib includes some sample client programs:
  75.  
  76. - pdftest:    general C test program, illustrates many PDF features
  77. - pdfimage:    convert GIF/TIFF/JPEG/PNG image files to PDF
  78. - text2pdf:    convert text files to PDF
  79.  
  80.  
  81. Platform support
  82. ================
  83. PDFlib requires an ANSI C compiler and runs on many platforms since
  84. it doesn't make use of an platform-specific features, and doesn't
  85. have any user interface. PDFlib is primarily developed and tested
  86. on Linux, Windows, and MacOS, and is compiled and tested on a
  87. variety of other platforms, including EBCDIC-based platforms.
  88.  
  89.  
  90. Binary distributions
  91. ====================
  92. PDFlib is available as source code as well as binary distribution
  93. for certain platform/language combinations. If you download the
  94. binary package, you save yourself the hassle of building the
  95. library for your platform. However, you should read the
  96. comprehensive manual (see below) in order to learn how to install
  97. the supplied binaries, and how to use PDFlib.
  98.  
  99.  
  100. Where to start?
  101. ===============
  102. PDFlib comes with a comprehensive manual which can be found as a
  103. PDF document in the doc directory.
  104.  
  105. Platform-specific build and install instructions can be found in
  106. the readme_<platform>.txt files in the doc directory.
  107.  
  108.  
  109. PDFlib resources
  110. ================
  111. Information on building and using PDFlib is available at several places.
  112. Please use these resources:
  113.  
  114. - The PDFlib manual in the doc directory contains the complete API reference,
  115.   plus extensive information regarding the supported language bindings.
  116.  
  117. - The PDFlib FAQ collects information about known bugs, patches,
  118.   and workarounds: http://www.pdflib.com.
  119.  
  120. - The PDFlib mailing list discusses PDFlib deployment in a variety of
  121.   environments. You can access the mailing list archives over the Web,
  122.   and don't need to subscribe in order to use it:
  123.   http://www.egroups.com/group/pdflib
  124.  
  125. - Commercial PDFlib licensees are eligible for professional product
  126.   support from PDFlib GmbH. Please send your inquiry along with your
  127.   PDFlib license number to support@pdflib.com.
  128.  
  129.  
  130. External libraries used in PDFlib
  131. =================================
  132. PDFlib makes use of several other libraries if they are available.
  133. Source code for these libraries is freely available on the Internet:
  134.  
  135. - Source code for Sam Leffler's TIFFlib is available from
  136.   http://www.libtiff.org
  137.   Note that some implementations of the TIFF library in turn
  138.   require the JPEG library which is available from http://www.ijg.org
  139.  
  140. - Source code for the zlib compression library is available from
  141.   http://www.info-zip.org/pub/infozip/zlib
  142.  
  143. - Source code for the PNG image library libpng is available from
  144.   http://www.libpng.org/pub/png
  145.   Note that the PNG library in turn requires the Zlib library.
  146.  
  147. Platform-specific information and download locations for these libraries
  148. can be found in doc/readme_<platform>.txt
  149.  
  150. Pre-built Windows binaries for these libraries are available from our
  151. Web site.
  152.  
  153. If any of these libraries is missing, PDFlib will work anyway,
  154. although (of course) it will be lacking the respective features.
  155.  
  156.  
  157. Submitting Bug Reports
  158. ======================
  159. In case of trouble you should always check the PDFlib Web site
  160. in order to see whether your problem is already known, or a patch exists.
  161. If not so, please observe the following:
  162.  
  163. If you have trouble building PDFlib on your system, please send the following
  164. to support@pdflib.com:
  165.  
  166. - a description of your problem and the platform in use
  167. - the PDFlib version number you are using
  168. - the output of "./libtool --config" (Unix systems only)
  169. - most welcome: suggested patches or solutions, other helpful information
  170.  
  171. If you have trouble with the behaviour of PDFlib, please send the following:
  172.  
  173. - a description of your problem
  174. - the platform in use
  175. - the PDFlib version number you are using
  176. - the language binding you are using, along with relevant version numbers
  177. - relevant code snippets for reproducing the problem, or a small PDF file
  178.   exhibiting the problem if you can't construct a code snippet easily
  179. - sample data files if necessary (image files, for example)
  180.  
  181.  
  182. A Shameless Plug
  183. ================
  184. My book has more information on PDFlib and PDF/Web integration.
  185. The book is currently available in German, English, and Japanese:
  186.  
  187. Mit Acrobat ins World Wide Web
  188. Effiziente Erstellung von PDF-Dateien und ihre Einbindung ins Web.
  189. An updated second edition will be available in October 2000 (ISBN 3-935320-00-0)
  190. Thomas Merz Verlag Muenchen 1998, ISBN 3-9804943-1-4.
  191.  
  192. Web Publishing with Acrobat/PDF
  193. Springer-Verlag Heidelberg Berlin New York 1998, ISBN 3-540-63762-1
  194.  
  195. Japanese edition:
  196. Tokyo Denki Daigaku 1999, ISBN 4-501-53020-0
  197. See http://plaza4.mbn.or.jp/~unit
  198.  
  199.  
  200. Licensing and Copyright
  201. =======================
  202. THIS IS NOT PUBLIC DOMAIN OR FREEWARE SOFTWARE!
  203.  
  204. PDFlib is available under two different licensing terms which are
  205. substantially different, and meet the needs of different developer groups.
  206. Please take the time to read the short summaries below in order to decide
  207. which one applies to your development.
  208.  
  209.  
  210. The Aladdin Free Public License
  211. -------------------------------
  212. This license applies to the main PDFlib package, but not to the
  213. ActiveX edition and any EBCDIC editions (both of which are only
  214. available under the terms of the commercial PDFlib license). The
  215. complete text of the license agreement can be found in the
  216. file aladdin-license.pdf. In short and non-legal terms:
  217.  
  218. - You may develop free software with PDFlib, provided you make your source
  219.   code available.
  220. - You may develop software for your own use with PDFlib, as long as you
  221.   don't sell it.
  222. - You may redistribute PDFlib non-commercially.
  223. - You may redistribute PDFlib on digital media if the complete contents of
  224.   the media are freely redistributable.
  225.   
  226. Only the text in the file doc/aladdin-license.pdf is considered to completely
  227. describe the licensing conditions. Project managers please note: Using PDFlib
  228. in your commercial projects is not covered by the Aladdin license, and
  229. effectively means jeopardizing your project through unlicensed software!
  230.  
  231.  
  232. The commercial PDFlib license
  233. -----------------------------
  234. A commercial PDFlib license is required for all uses of the software which
  235. are not explicitly covered by the Aladdin Free Public License, for example:
  236.  
  237. - shipping a commercial product which contains PDFlib,
  238. - distributing (free or commercial) software based on PDFlib when the source
  239.   code is not made available,
  240. - implementing commercial Web services with PDFlib.
  241.  
  242. Details of the commercial PDFlib license and a purchase order form
  243. can be found in the doc directory.
  244.  
  245. Please contact us if you're interested in obtaining a commercial PDFlib license:
  246.  
  247. PDFlib GmbH
  248. Tal 40, 80331 Muenchen, Germany
  249. fax +49/89/29 16 46 86
  250.  
  251. Thomas Merz, the primary author of PDFlib: tm@pdflib.com
  252.  
  253. License inquiries: sales@pdflib.com
  254.  
  255. Technical inquiries if you have not licensed PDFlib:
  256. mailing list (and archives) at http://www.egroups.com/group/pdflib
  257.  
  258. Support for PDFlib licensees: support@pdflib.com
  259.  
  260. Copyright (c) 1997-2000 PDFlib GmbH and Thomas Merz.  All rights reserved.
  261.