cvs: /phpdoc/functions pdf.sgml

steinm Tue Sep 14 09:40:16 1999 EDT Modified files: /phpdoc/functions pdf.sgml Log: - added changes for pdflib 2.01 Index: phpdoc/functions/pdf.sgml diff -u phpdoc/functions/pdf.sgml:1.10 phpdoc/functions/pdf.sgml:1.11 --- phpdoc/functions/pdf.sgml:1.10 Thu Sep 9 02:20:55 1999 +++ phpdoc/functions/pdf.sgml Tue Sep 14 09:40:16 1999 @@ -8,10 +8,9 @@ <simpara> You can use the PDF functions in PHP to create PDF files if you have the PDF library by Thomas Merz (available at <ulink url = - "http://www.ifconnection.de/~tm/">http://www.ifconnection.de/~tm/</ulink>). + "http://www.pdflib.com/pdflib/index.html">http://www.pdflib.com/pdflib/index.html</ulink>). Please consult the excelent documentation for - pdflib shipped with the source distribution of pdflib or available at - <ulink url="http://www.ifconnection.de/~tm/software/pdflib/PDFlib-0.6.pdf">http://www.ifconnection.de/~tm/software/pdflib/PDFlib-0.6.pdf</ulink>. + pdflib shipped with the source distribution of pdflib. It provides a very good overview of what pdflib capable of doing. Most of the functions in pdflib and the PHP module have the same name. The parameters are also @@ -28,10 +27,11 @@ details. <simpara> - Currently two versions of pdflib are supported: 0.6 and 2.0. It - is recommended that you use the newer version since it has more + Currently all versions of pdflib are supported. It + is recommended that you use the newest version since it has more features and fixes some problems which required a patch for the old - version. Unfortunately, the changes of the pdflib API in 2.0 have + version. Unfortunately, the changes of the pdflib API in 2.x + compared to 0.6 have been so severe that even some PHP functions had to be altered. Here is a list of changes: @@ -59,17 +59,25 @@ </listitem> </itemizedlist> + <simpara> + There were some more changes with the release 2.01 of pdflib which + should be covered by PHP. Some functions are not required anymore + (e.g. <function>pdf_put_image</function>). You will get a warning so + don't be shocked. + <simpara> - The pdf module introduces two new types of variables (if pdflib 2.0 + The pdf module introduces two new types of variables (if pdflib 2.x is used it is only one new type). They are called <parameter>pdfdoc</parameter> and <parameter>pdfinfo</parameter> - (<parameter>pdfinfo</parameter> is not existent if pdflib 2.0 is used. + (<parameter>pdfinfo</parameter> is not existent if pdflib 2.x is used. <parameter>pdfdoc</parameter> is a pointer to a pdf document and almost all functions need it as its first parameter. <parameter>pdfinfo</parameter> contains meta data about the PDF document. It has to be set before <function>pdf_open</function> is called. + <note><simpara>The following is only true for pdflib 0.6. Read the pdflib + manual for newer version</note> <simpara> In order to output text into a PDF document you will need to provide the afm file for each font. Afm files contain font metrics for a @@ -128,7 +136,7 @@ </programlisting> </informalexample> - Doing the same with pdflib 2.0 looks like the following: + Doing the same with pdflib 2.x looks like the following: <example> <title>Creating a PDF document with pdflib 2.0</title> @@ -1943,6 +1951,9 @@ <function>PDF_execute_image</function> is highly recommended for larger images (several kb) if they show up more than once in the document. + <note><simpara>This function has become meaningless with version + 2.01 of pdflib. It will just output a warning. + </note> <para> See also <function>PDF_put_image</function>, <function>PDF_place_image</function>, @@ -1972,6 +1983,9 @@ <para> The image can be scaled while displaying it. A scale of 1.0 will show the image in the original size. + <note><simpara>This function has become meaningless with version + 2.01 of pdflib. It will just output a warning. + </note> <example> <title>Multiple show of an image</title>