katja Sun Mar 19 17:23:57 2006 UTC
Modified files:
/phpdoc/en/reference/pdf reference.xml
Log:
PDF doc updated
http://cvs.php.net/viewcvs.cgi/phpdoc/en/reference/pdf/reference.xml?r1=1.22&r2=1.23&diff_format=u
Index: phpdoc/en/reference/pdf/reference.xml
diff -u phpdoc/en/reference/pdf/reference.xml:1.22
phpdoc/en/reference/pdf/reference.xml:1.23
--- phpdoc/en/reference/pdf/reference.xml:1.22 Mon Feb 20 01:59:10 2006
+++ phpdoc/en/reference/pdf/reference.xml Sun Mar 19 17:23:56 2006
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.22 $ -->
+<!-- $Revision: 1.23 $ -->
<!-- Purpose: utilspec.nontext -->
<!-- Membership: pecl, external -->
@@ -12,42 +12,48 @@
&reftitle.intro;
<para>
The PDF functions in PHP can create PDF files using the PDFlib
- library created by <ulink url="&url.pdflib.merz;">Thomas Merz</ulink>.
+ library which was initially created by Thomas Merz and is now
+ maintained by <ulink url="&url.pdf;">PDFlib GmbH</ulink>.
</para>
<para>
The documentation in this section is only meant to be an overview
of the available functions in the PDFlib library and should not be
considered an exhaustive reference. For the full and detailed
- explanation of each function, consult the PDFlib Reference Manual
- which is included in all PDFlib packages distributed by PDFlib GmbH.
+ explanation of each function, consult the PDFlib Reference Manual
+ which is included in all PDFlib packages distributed by PDFlib GmbH.
It provides a very good overview of what PDFlib is capable of doing
and contains the most up-to-date documentation of all functions.
</para>
<para>
- All of the functions in PDFlib and the PHP module have identical
- function names and parameters. You will need to understand some
- of the basic concepts of PDF and PostScript to efficiently use
- this extension. All lengths and coordinates are measured in
- PostScript points. There are generally 72 PostScript points to an
- inch, but this depends on the output resolution. Please see the
- PDFlib Reference Manual included in the PDFlib distribution for a more
- thorough explanation of the coordinate system used.
+ For a jump start we urge you to take a look at the programming samples
+ which are contained in all PDFlib distribution packages. These samples
+ demonstrate basic text, vector, and graphics output as well as
+ higher-level functions, such as the PDF import facility (PDI).
</para>
<para>
- With version 6, PDFlib offers an object oriented API for PHP 5 in
- addition to the function oriented API for PHP 4. The main difference is
+ All of the functions in PDFlib and the PHP module have identical
+ function names and parameters. Unless configured otherwise, all
+ lengths and coordinates are measured in PostScript points. There are
+ generally 72 PostScript points to an inch, but this depends on the
+ output resolution. Please see the PDFlib Reference Manual
+ included in the PDFlib distribution for a more thorough explanation
+ of the coordinate system used.
+ </para>
+ <para>
+ With version 6, PDFlib offers an object-oriented API for PHP 5 in
+ addition to the function-oriented API for PHP 4. The main difference is
the following:
- </para>
+ </para>
<para>
- In PHP 4, first a PDF resource has to be retrieved
- with a function call like
+ In PHP 4, first a PDF resource has to be retrieved with a function call
+ like
</para>
<para>
$p = PDF_new().
</para>
<para>
- This PDF resource is used as the first parameter in all further function
calls, such
- as in
+ This PDF resource is used as the first parameter in all further function
+ calls, such as in
</para>
<para>
PDF_begin_document($p, "", "").
@@ -56,21 +62,21 @@
In PHP 5 however, a PDFlib object is created with
</para>
<para>
- $p = new PDFlib().
+ $p = new PDFlib().
</para>
<para>
This object offers all PDFlib API functions as methods, e.g. as with
- </para>
+ </para>
<para>
$p->begin_document("", "").
</para>
<para>
In addition, exceptions have been introduced in PHP 5 which are
supported by PDFlib 6 and later as well.
- </para>
+ </para>
<para>
Please see the <link linkend="pdf.examples">examples</link> below for
- more information.
+ more information.
</para>
<note>
<para>
@@ -79,20 +85,17 @@
this related FAQ</link>.
</para>
</note>
- <note>
- <para>
- This extension has been moved to <ulink url="&url.pecl;">PECL</ulink> as
- of PHP 4.3.9.
- </para>
- </note>
</section>
<section id="pdf.requirements">
&reftitle.required;
<para>
- PDFlib is available for download at <ulink
- url="&url.pdf;">&url.pdf;</ulink>, but requires that you purchase
- a license for commercial use.
+ PDFlib Lite is available as open source. However, the
+ PDFlib Lite license allows free use only under certain conditions.
+ PDFlib Lite supports a subset of PDFlib's functionality; please see the
+ PDFlib web site for details. The full version of PDFlib is available for
+ download at <ulink url="&url.pdf;">&url.pdf;</ulink>, but requires that
+ you purchase a license for commercial use.
</para>
</section>
@@ -119,15 +122,15 @@
<para>
Starting with PHP 4.0.5, the PHP extension for PDFlib is
officially supported by PDFlib GmbH. This means that all the
- functions described in the PDFlib Reference Manual (PDFlib V3.0 or higher)
are
+ functions described in the PDFlib Reference Manual are
supported by PHP 4 with exactly the same meaning and the same
- parameters. However, with PDFlib V5.0.4 or higher all parameters
- have to be specified. For compatibility reasons,
- this binding for PDFlib still supports most of the deprecated functions,
but they
+ parameters. However, with PDFlib Version 5.0.4 or higher all parameters
+ have to be specified. For compatibility reasons, this binding for PDFlib
+ still supports most of the deprecated functions, but they
should be replaced by their new versions. PDFlib GmbH will not
support any problems arising from the use of these deprecated
functions. The documentation in this section indicates old functions as
- "Deprecated" and gives the replacement function to be used instead.
+ "Deprecated" and gives the replacement function to be used instead.
</para>
</section>
@@ -138,8 +141,8 @@
is probably creating your first PDF document. The following
example should help to get you started. It is developed for PHP 4 and
creates the file <filename>hello.pdf</filename> with one page.
- It defines some document info field contents, loads the Helvetica-Bold
- font and outputs the text "Hello world! (says PHP)".
+ It defines some document info field contents, loads the Helvetica-Bold
+ font and outputs the text "Hello world! (says PHP)".
</para>
<para>
<example>
@@ -184,13 +187,13 @@
</programlisting>
</example>
</para>
-
+
<para>
The following example comes with the PDFlib distribution for PHP 5.
- It uses the new exception handling and object encapsulation features
- available in PHP 5. It creates the file <filename>hello.pdf</filename>
with one page.
- It defines some document info field contents, loads the Helvetica-Bold
- font and outputs the text "Hello world! (says PHP)".
+ It uses the new exception handling and object encapsulation features
+ available in PHP 5. It creates the file <filename>hello.pdf</filename>
+ with one page. It defines some document info field contents, loads the
+ Helvetica-Bold font and outputs the text "Hello world! (says PHP)".
</para>
<para>
<example>
@@ -233,8 +236,8 @@
}
catch (PDFlibException $e) {
die("PDFlib exception occurred in hello sample:\n" .
- "[" . $e->get_errnum() . "] " . $e->get_apiname() . ": " .
- $e->get_errmsg() . "\n");
+ "[" . $e->get_errnum() . "] " . $e->get_apiname() . ": " .
+ $e->get_errmsg() . "\n");
}
catch (Exception $e) {
die($e);
@@ -271,3 +274,4 @@
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
+
