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