cvs: phpdoc /de Translators /de/functions cpdf.xml

samesch Wed Aug 8 06:25:42 2001 EDT Modified files: /phpdoc/de Translators /phpdoc/de/functions cpdf.xml Log: Syncing with english rev. 1.26

Index: phpdoc/de/Translators diff -u phpdoc/de/Translators:1.184 phpdoc/de/Translators:1.185 --- phpdoc/de/Translators:1.184 Mon Aug 6 19:08:11 2001 +++ phpdoc/de/Translators Wed Aug 8 06:25:41 2001 @@ -67,7 +67,7 @@ ccvs.xml Peter Petermann fertig classobj.xml Hartmut Holzgraefe fertig com.xml Thomas Schöfbeck fertig (bis V. 1.15) -cpdf.xml Martin Samesch Änderungen +cpdf.xml Martin Samesch fertig (Rev. 1.26) curl.xml Christian Bombera in Arbeit cybercash.xml Martin Jansen fertig datetime.xml Thomas Schuermann fertig (bis V. 1.23) Index: phpdoc/de/functions/cpdf.xml diff -u phpdoc/de/functions/cpdf.xml:1.20 phpdoc/de/functions/cpdf.xml:1.21 --- phpdoc/de/functions/cpdf.xml:1.20 Sat Jul 7 18:16:48 2001 +++ phpdoc/de/functions/cpdf.xml Wed Aug 8 06:25:41 2001 @@ -4,23 +4,12 @@ <partintro> <simpara> - Mittels ClibPDF können Sie PDF-Dokumente mit PHP erstellen. Sie - bekommen diese Bibliothek von <ulink - url="&url.fastio;">FastIO</ulink>, aber sie ist keine freie - Software. Sie sollten auf jeden Fall die Lizenz lesen, bevor Sie - anfangen, mit ClibPDF zu experimentieren. Wenn Sie nicht mit den - Lizenzbedingungen einverstanden sind, sollten sie die Verwendung - der ebenfalls sehr mächtigen pdflib von Thomas Merz erwägen. - Funktionalität und API sind der pdflib von Thomas Merz ähnlich, - aber in Bezug auf FastIO ist ClibPDF schneller und erzeugt - kleinere Dokumente. Mit der neuen Version 2.0 von pdflib könnte - sich das geändert haben. Tatsächlich zeigt ein einfacher - Leistungsvergleich (Umwandlung des pdfclock.c-Beispiels von pdflib - 2.0 in ein PHP-Skript) überhaupt keinen - Geschwindigkeitsunterschied. Wenn die Kompression abgeschaltet - ist, ist auch die Größe der Datei ähnlich. Von daher sollten Sie - einfach beide Bibliotheken testen, um festzustellen, welche Ihre - Anforderungen erfüllt. + Mit der ClibPDF können Sie PDF-Dokumente mit PHP erstellen. Diese + Bibliothek ist zum Herunterladen erhältlich von <ulink + url="&url.fastio;">FastIO</ulink>, aber für deren kommerzielle + Verwendung ist es erforderlich, dass Sie eine Lizenz erwerben. + Funktionalität und API der ClibPDF sind der <link + linkend="ref.pdf">PDFlib</link> ähnlich. </simpara> <simpara> Diese Dokumentation sollten Sie zusammen mit dem ClibPDF-Handbuch @@ -28,9 +17,9 @@ </simpara> <simpara> Die Namen vieler Funktionen in der ClibPDF, im PHP-Modul und in - der pdflib sind gleich. Außer <function>cpdf_open</function> - nehmen alle Funktionen die Bezeichnung des Dokuments als ihren - ersten Parameter. + der <link linkend="ref.pdf">PDFlib</link> sind gleich. Außer + <function>cpdf_open</function> nehmen alle Funktionen die + Bezeichnung des Dokuments als ihren ersten Parameter. </simpara> <simpara> Diese Bezeichnung wird gegenwärtig nicht intern verwendet, weil @@ -52,16 +41,17 @@ </simpara> </note> <simpara> - Bisher war die Möglichkeit, das PDF-Dokument vollständig im - Speicher zu erzeugen, ohne temporäre Dateien zu verwenden, ein - großer Vorteil von ClibPDF gegenüber pdflib. Diese Fähigkeit hat - pdflib seit Version 3.0 auch. Sie bietet auch die Möglichkeit, - Koordinaten in einer vordefinierten Längeneinheit zu übergeben. - Dies ist eine praktische Fähigkeit, die aber auch mit + Eine nette Eigenschaft der ClibPDF (und der <link + linkend="ref.pdf">PDFlib</link>) ist die Möglichkeit, das + PDF-Dokument vollständig im Speicher zu erzeugen, ohne temporäre + Dateien zu verwenden. Sie bietet auch die Möglichkeit, Koordinaten + in einer vordefinierten Längeneinheit zu übergeben. Dies ist eine + praktische Fähigkeit, die bei Verwendung der <link + linkend="ref.pdf">PDFlib</link> aber auch mit <function>pdf_translate</function> simuliert werden kann. </simpara> <simpara> - Ein weiteres nettes Feature von ClibPDF ist die Tatsache, dass + Eine weitere nette Eigenschaft von ClibPDF ist die Tatsache, dass jede Seite jederzeit geändert werden kann, selbst wenn schon eine neue Seite geöffnet wurde. Die Funktion <function>cpdf_set_current_page</function> erlaubt es, die @@ -198,190 +188,218 @@ </example> </partintro> - <refentry id="function.cpdf-global-set-document-limits"> + <refentry id="function.cpdf-add-annotation"> <refnamediv> - <refname>cpdf_global_set_document_limits</refname> - <refpurpose>Setzt Beschränkungen für alle PDF-Dokumente</refpurpose> + <refname>cpdf_add_annotation</refname> + <refpurpose>Fügt eine Anmerkung ein</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef> - void <function>cpdf_global_set_document_limits</function> - </funcdef> - <paramdef>int <parameter>maxSeiten</parameter></paramdef> - <paramdef>int <parameter>maxSchriftarten</parameter></paramdef> - <paramdef>int <parameter>maxAbbildungen</parameter></paramdef> - <paramdef>int <parameter>maxBemerkungen</parameter></paramdef> - <paramdef>int <parameter>maxObjekte</parameter></paramdef> + <funcdef>void <function>cpdf_add_annotation</function></funcdef> + <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> + <paramdef>double <parameter>ulx</parameter></paramdef> + <paramdef>double <parameter>uly</parameter></paramdef> + <paramdef>double <parameter>orx</parameter></paramdef> + <paramdef>double <parameter>ory</parameter></paramdef> + <paramdef>string <parameter>Titel</parameter></paramdef> + <paramdef>string <parameter>Inhalt</parameter></paramdef> + <paramdef>int + <parameter><optional>Modus</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_global_set_document_limits</function> - setzt verschiedene Beschränkungen für Dokumente. Damit diese - Funktion wirksam wird, muss sie vor <function>cpdf_open</function> - aufgerufen werden. Sie setzt die Beschränkungen für alle - Dokumente, die danach geöffnet werden. + Die Funktion <function>cpdf_add_annotation</function> fügt eine + Anmerkung ein, bei der die untere linke Ecke bei + (<parameter>ulx</parameter>, <parameter>uly</parameter>) und die + obere rechte Ecke bei (<parameter>orx</parameter>, + <parameter>ory</parameter>) liegt. </para> <para> - Siehe auch: <function>cpdf_open</function>. + Der optionale Parameter <parameter>Modus</parameter> bestimmt die + Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird + die Einheit verwendet, dil wurde. Andernfalls werden die Koordinaten unabhängig von der + aktuellen Einheit in Postscript-Punkten gemessen. </para> </refsect1> </refentry> - <refentry id="function.cpdf-set-creator"> - <refnamediv> - <refname>cpdf_set_creator</refname> - <refpurpose>Setzt das Urheberfeld des PDF-Dokuments</refpurpose> - </refnamediv> + <refentry id="function.cpdf-add-outline"> + <refnamediv> + <refname>cpdf_add_outline</refname> + <refpurpose> + Fügt ein Lesezeichen für die aktuelle Seite hinzu + </refpurpose> + </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_set_creator</function></funcdef> - <paramdef>string <parameter>Urheber</parameter></paramdef> + <funcdef>void <function>cpdf_add_outline</function></funcdef> + <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> + <paramdef>string <parameter>Text</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_set_creator</function> setzt den - Urheber eines PDF-Dokuments. - </para> - <para> - Siehe auch: <function>cpdf_set_subject</function>, - <function>cpdf_set_title</function> und - <function>cpdf_set_keywords</function>. + Die Funktion <function>cpdf_add_outline</function> fügt ein + Lesezeichen mit dem Text <parameter>Text</parameter> hinzu, das + auf die aktuelle Seite zeigt. + <example> + <title>Hinzufügen einer Seitenübersicht</title> + <programlisting> +&lt;?php +$cpdf = cpdf_open(0); +cpdf_page_init($cpdf, 1, 0, 595, 842); +cpdf_add_outline($cpdf, 0, 0, 0, 1, "Seite 1"); +// ... +// etwas Zeichnung +// ... +cpdf_finalize($cpdf); +Header("Content-type: application/pdf"); +cpdf_output_buffer($cpdf); +cpdf_close($cpdf); +?&gt; + </programlisting> + </example> </para> </refsect1> </refentry> - <refentry id="function.cpdf-set-title"> + <refentry id="function.cpdf-arc"> <refnamediv> - <refname>cpdf_set_title</refname> - <refpurpose>Setzt das Titelfeld PDF-Dokuments</refpurpose> + <refname>cpdf_arc</refname> + <refpurpose>Zeichnet einen Kreisbogen</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_set_title</function></funcdef> - <paramdef>string <parameter>Titel</parameter></paramdef> + <funcdef>void <function>cpdf_arc</function></funcdef> + <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> + <paramdef>double <parameter>x-koor</parameter></paramdef> + <paramdef>double <parameter>y-koor</parameter></paramdef> + <paramdef>double <parameter>Radius</parameter></paramdef> + <paramdef>double <parameter>Anfang</parameter></paramdef> + <paramdef>double <parameter>Ende</parameter></paramdef> + <paramdef>int + <parameter><optional>Modus</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_set_title</function> setzt den Titel - eines PDF-Dokuments. + Die Funktion <function>cpdf_arc</function> zeichnet einen + Kreisbogen mit dem Mittelpunkt (<parameter>x-koor</parameter>, + <parameter>y-koor</parameter>) und dem Radius + <parameter>Radius</parameter>, der mit dem Winkel + <parameter>Anfang</parameter> beginnt und mit dem Winkel + <parameter>Ende</parameter> endet. </para> <para> - Siehe auch: <function>cpdf_set_subject</function>, - <function>cpdf_set_creator</function> und - <function>cpdf_set_keywords</function>. + Der optionale Parameter <parameter>Modus</parameter> bestimmt die + Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird + die Einheit verwendet, die für die Seite als Standard angegeben + wurde. Andernfalls werden die Koordinaten unabhängig von der + aktuellen Einheit in Postscript-Punkten gemessen. + </para> + <para> + Siehe auch: <function>cpdf_circle</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-set-subject"> + <refentry id="function.cpdf-begin-text"> <refnamediv> - <refname>cpdf_set_subject</refname> - <refpurpose>Setzt das Themenfeld des PDF-Dokuments</refpurpose> + <refname>cpdf_begin_text</refname> + <refpurpose>Beginnt einen Textabschnitt</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_set_subject</function></funcdef> - <paramdef>string <parameter>Thema</parameter></paramdef> + <funcdef>void <function>cpdf_begin_text</function></funcdef> + <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_set_subject</function> setzt das - Thema eines PDF-Dokuments. + Die Funktion <function>cpdf_begin_text</function> beginnt einen + Textabschnitt. Er muss mit <function>cpdf_end_text</function> + beendet werden. + <example> + <title>Ausgabe von Text</title> + <programlisting> +&lt;?php +cpdf_begin_text($pdf); +cpdf_set_font($pdf, 16, "Helvetica", "WinAnsiEncoding"); +cpdf_text($pdf, 100, 100, "Etwas Text"); +cpdf_end_text($pdf) +?&gt; + </programlisting> + </example> </para> <para> - Siehe auch: <function>cpdf_set_title</function>, - <function>cpdf_set_creator</function> und - <function>cpdf_set_keywords</function>. + Siehe auch: <function>cpdf_end_text</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-set-keywords"> + <refentry id="function.cpdf-circle"> <refnamediv> - <refname>cpdf_set_keywords</refname> - <refpurpose> - Setzt das Schlüsselwortfeld des PDF-Dokuments - </refpurpose> + <refname>cpdf_circle</refname> + <refpurpose>Zeichnet einen Kreis</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_set_keywords</function></funcdef> - <paramdef>string - <parameter>Schlüsselwörter</parameter> + <funcdef>void <function>cpdf_circle</function></funcdef> + <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> + <paramdef>double <parameter>x-koor</parameter></paramdef> + <paramdef>double <parameter>y-koor</parameter></paramdef> + <paramdef>double <parameter>Radius</parameter></paramdef> + <paramdef>int + <parameter><optional>Modus</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_set_keywords</function> setzt die - Schlüsselwörter eines PDF-Dokuments. + Die Funktion <function>cpdf_circle</function> zeichnet einen + Kreis mit dem Mittelpunkt (<parameter>x-koor</parameter>, + <parameter>y-koor</parameter>) und dem Radius + <parameter>Radius</parameter>. </para> <para> - Siehe auch: <function>cpdf_set_title</function>, - <function>cpdf_set_creator</function> und - <function>cpdf_set_subject</function>. + Der optionale Parameter <parameter>Modus</parameter> bestimmt die + Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird + die Einheit verwendet, die für die Seite als Standard angegeben + wurde. Andernfalls werden die Koordinaten unabhängig von der + aktuellen Einheit in Postscript-Punkten gemessen. + </para> + <para> + Siehe auch: <function>cpdf_arc</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-open"> + <refentry id="function.cpdf-clip"> <refnamediv> - <refname>cpdf_open</refname> - <refpurpose>Öffnet ein neues PDF-Dokument</refpurpose> + <refname>cpdf_clip</refname> + <refpurpose> + Beschränkt alle Zeichnungen auf den aktuellen Pfad + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>cpdf_open</function></funcdef> - <paramdef>int <parameter>Komprimierung</parameter></paramdef> - <paramdef> - string <parameter><optional>Dateiname</optional></parameter> - </paramdef> + <funcdef>void <function>cpdf_clip</function></funcdef> + <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_open</function> öffnet ein neues - PDF-Dokument. Wenn <parameter>Komprimierung</parameter> ungleich - 0 ist, schaltet dieser Parameter die Komprimierung des Dokuments - ein. Der optionale Parameter <parameter>Dateiname</parameter> - bestimmt die Datei in die das Dokument geschrieben wird. Wenn er - nicht angegeben wurde, wird das Dokument im Speicher erzeugt und - kann entweder mit <function>cpdf_save_to_file</function> in eine - Datei geschrieben werden oder mit - <function>cpdf_output_buffer</function> an die Standardausgabe - geschickt werden. - <note> - <simpara> - Der Rückgabewert wird in künftigen ClibPDF-Versionen als erster - Parameter aller anderen Funktionen benötigt, die in ein - PDF-Dokument schreiben. - </simpara> - <simpara> - Die ClibPDF-Bibliothek betrachtet den Dateinamen "-" als - Synonym für stdout. Das funktioniert allerdings nicht, wenn PHP - als Apache-Modul kompiliert wurde, weil die Art und Weise, in - der ClibPDF die Ausgabe an stdout vornimmt, nicht mit Apache - funktioniert. Sie können dieses Problem lösen, indem Sie keinen - Dateinamen angeben und stattdessen - <function>cpdf_output_buffer</function> verwenden, um das - PDF-Dokument auszugeben. - </simpara> - </note> - </para> - <para> - Siehe auch: <function>cpdf_close</function> und - <function>cpdf_output_buffer</function>. + Die Funktion <function>cpdf_clip</function> beschränkt alle + Zeichnungen auf den aktuellen Pfad. </para> </refsect1> </refentry> @@ -412,213 +430,158 @@ </refsect1> </refentry> - <refentry id="function.cpdf-page-init"> + <refentry id="function.cpdf-closepath"> <refnamediv> - <refname>cpdf_page_init</refname> - <refpurpose>Beginnt eine neue Seite</refpurpose> + <refname>cpdf_closepath</refname> + <refpurpose>Schließt den aktuellen Pfad</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_page_init</function></funcdef> + <funcdef>void <function>cpdf_closepath</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>int <parameter>Seitennummer</parameter></paramdef> - <paramdef>int <parameter>Ausrichtung</parameter></paramdef> - <paramdef>double <parameter>Höhe</parameter></paramdef> - <paramdef>double <parameter>Breite</parameter></paramdef> - <paramdef> - double <parameter><optional>Einheit</optional></parameter> - </paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_page_init</function> beginnt eine - neue Seite mit der Höhe <parameter>Höhe</parameter> und der - Breite <parameter>Breite</parameter>. Die Seite hat die Nummer - <parameter>Seitennummer</parameter> und die Ausrichtung - <parameter>Ausrichtung</parameter>. - <parameter>Ausrichtung</parameter> kann 0 für Hochformat oder 1 - für Querformat sein. Der optionale Parameter - <parameter>Einheit</parameter> gibt die Einheit des - Koordinatensystems in Anzahl von Postscript-Punkten pro Einheit - an. Da ein Zoll 72 Punkten entspricht, würde ein Wert von 72 - die Einheit auf ein Zoll setzen. Auch der Standardwert ist 72. - </para> - <para> - Siehe auch: <function>cpdf_set_current_page</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.cpdf-finalize-page"> - <refnamediv> - <refname>cpdf_finalize_page</refname> - <refpurpose>Beendet eine Seite</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>cpdf_finalize_page</function></funcdef> - <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>int <parameter>Seitennummer</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Die Funktion <function>cpdf_finalize_page</function> beendet die - Seite mit der Seitennummer <parameter>page number</parameter>. - </para> - <para> - Diese Funktion hat nur den Zweck, Speicherplatz zu sparen. Eine - abgeschlossene Seite belegt weniger Speicherplatz, kann aber - nicht mehr verändert werden. - </para> - <para> - Siehe auch: <function>cpdf_page_init</function>. + Die Funktion <function>cpdf_closepath</function> schließt den + aktuellen Pfad. </para> </refsect1> </refentry> - <refentry id="function.cpdf-finalize"> + <refentry id="function.cpdf-closepath-fill-stroke"> <refnamediv> - <refname>cpdf_finalize</refname> - <refpurpose>Beendet ein Dokument</refpurpose> + <refname>cpdf_closepath_fill_stroke</refname> + <refpurpose> + Schließt, füllt und zeichnet den aktuellen Pfad + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_finalize</function></funcdef> + <funcdef>void + <function>cpdf_closepath_fill_stroke</function> + </funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_finalize</function> beendet das - Dokument <parameter>PDF-Dokument</parameter>. Sie müssen danach - trotzdem noch <function>cpdf_close</function> aufrufen. + Die Funktion <function>cpdf_closepath_fill_stroke</function> + schließt den aktuellen Pfad, füllt seinen Innenraum mit der + aktuellen Füllfarbe und zeichnet ihn. </para> <para> - Siehe auch: <function>cpdf_close</function>. + Siehe auch: <function>cpdf_closepath</function>, + <function>cpdf_stroke</function>, <function>cpdf_fill</function>, + <function>cpdf_setgray_fill</function>, + <function>cpdf_setgray</function>, + <function>cpdf_setrgbcolor_fill</function> und + <function>cpdf_setrgbcolor</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-output-buffer"> + <refentry id="function.cpdf-closepath-stroke"> <refnamediv> - <refname>cpdf_output_buffer</refname> + <refname>cpdf_closepath_stroke</refname> <refpurpose> - Gibt das PDF-Dokument aus dem Zwischenspeicher aus + Schließt einen Pfad und zeichnet eine Linie entlang des Pfades </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_output_buffer</function></funcdef> + <funcdef>void + <function>cpdf_closepath_stroke</function> + </funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_output_buffer</function> gibt das - PDF-Dokument an stdout aus. Das Dokument muss im Speicher erstellt - worden sein, was der Fall ist, wenn - <function>cpdf_open</function> ohne den Parameter Dateiname - aufgerufen wurde. + Die Funktion <function>cpdf_closepath_stroke</function> ist eine + Kombination aus <function>cpdf_closepath</function> und + <function>cpdf_stroke</function>. Der Pfad wird geschlossen. </para> <para> - Siehe auch: <function>cpdf_open</function>. + Siehe auch: <function>cpdf_closepath</function> und + <function>cpdf_stroke</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-save-to-file"> + <refentry id="function.cpdf-continue-text"> <refnamediv> - <refname>cpdf_save_to_file</refname> - <refpurpose>Schreibt ein PDF-Dokument in eine Datei</refpurpose> + <refname>cpdf_continue_text</refname> + <refpurpose>Gibt den Text in der nächsten Zeile aus</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_save_to_file</function></funcdef> + <funcdef>void <function>cpdf_continue_text</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>string <parameter>Dateiname</parameter></paramdef> + <paramdef>string <parameter>Text</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_save_to_file</function> schreibt das - PDF-Dokument in eine Datei, sofern es im Speicher erstellt wurde. - </para> - <para> - Diese Funktion wird nicht benötigt, wenn das PDF-Dokument unter - Angabe eines Dateinamens als Parameter von - <function>cpdf_open</function> geöffnet wurde. + Die Funktion <function>cpdf_continue_text</function> gibt die + Zeichenkette in <parameter>Text</parameter> in der nächsten Zeile + aus. </para> <para> - Siehe auch: <function>cpdf_output_buffer</function> und - <function>cpdf_open</function>. + Siehe auch: <function>cpdf_show_xy</function>, + <function>cpdf_text</function>, + <function>cpdf_set_leading</function> und + <function>cpdf_set_text_pos</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-set-current-page"> + <refentry id="function.cpdf-curveto"> <refnamediv> - <refname>cpdf_set_current_page</refname> - <refpurpose>Setzt die aktuelle Seite</refpurpose> + <refname>cpdf_curveto</refname> + <refpurpose>Zeichnet eine Kurve</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_set_current_page</function></funcdef> + <funcdef>void <function>cpdf_curveto</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>int <parameter>Seitennummer</parameter></paramdef> + <paramdef>double <parameter>x1</parameter></paramdef> + <paramdef>double <parameter>y1</parameter></paramdef> + <paramdef>double <parameter>x2</parameter></paramdef> + <paramdef>double <parameter>y2</parameter></paramdef> + <paramdef>double <parameter>x3</parameter></paramdef> + <paramdef>double <parameter>y3</parameter></paramdef> + <paramdef>int + <parameter><optional>Modus</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_set_current_page</function> setzt die - Seite, an der alle Aktionen durchgeführt werden. Sie können - solange zwischen den Seiten wechseln, bis Sie eine Seite mit - <function>cpdf_finalize_page</function> abschließen. - </para> - <para> - Siehe auch: <function>cpdf_finalize_page</function>. + Die Funktion <function>cpdf_curveto</function> zeichnet eine + Bezier-Kurve vom aktuellen Punkt zum Punkt + (<parameter>x3</parameter>, <parameter>y3</parameter>), wobei + (<parameter>x1</parameter>, <parameter>y1</parameter>) und + (<parameter>x2</parameter>, <parameter>y2</parameter>) als + Kontrollpunkte verwendet werden. </para> - </refsect1> - </refentry> - - <refentry id="function.cpdf-begin-text"> - <refnamediv> - <refname>cpdf_begin_text</refname> - <refpurpose>Beginnt einen Textabschnitt</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>cpdf_begin_text</function></funcdef> - <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - </funcprototype> - </funcsynopsis> <para> - Die Funktion <function>cpdf_begin_text</function> beginnt einen - Textabschnitt. Er muss mit <function>cpdf_end_text</function> - beendet werden. - <example> - <title>Ausgabe von Text</title> - <programlisting> -&lt;?php -cpdf_begin_text($pdf); -cpdf_set_font($pdf, 16, "Helvetica", "WinAnsiEncoding"); -cpdf_text($pdf, 100, 100, "Etwas Text"); -cpdf_end_text($pdf) -?&gt; - </programlisting> - </example> + Der optionale Parameter <parameter>Modus</parameter> bestimmt die + Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird + die Einheit verwendet, die für die Seite als Standard angegeben + wurde. Andernfalls werden die Koordinaten unabhängig von der + aktuellen Einheit in Postscript-Punkten gemessen. </para> <para> - Siehe auch: <function>cpdf_end_text</function>. + Siehe auch: <function>cpdf_moveto</function>, + <function>cpdf_rmoveto</function>, + <function>cpdf_rlineto</function> und + <function>cpdf_lineto</function>. </para> </refsect1> </refentry> @@ -658,296 +621,246 @@ </refsect1> </refentry> - <refentry id="function.cpdf-show"> + <refentry id="function.cpdf-fill"> <refnamediv> - <refname>cpdf_show</refname> - <refpurpose>Gibt Text an der aktuellen Position aus</refpurpose> + <refname>cpdf_fill</refname> + <refpurpose>Füllt den aktuellen Pfad</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_show</function></funcdef> + <funcdef>void <function>cpdf_fill</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>string <parameter>Text</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_show</function> gibt die Zeichenkette - <parameter>Text</parameter> an der aktuellen Position aus. + Die Funktion <function>cpdf_fill</function> füllt den Innenraum + des aktuellen Pfades mit der aktuellen Füllfarbe. </para> <para> - Siehe auch: <function>cpdf_text</function>, - <function>cpdf_begin_text</function> und - <function>cpdf_end_text</function>. + Siehe auch: <function>cpdf_closepath</function>, + <function>cpdf_stroke</function>, + <function>cpdf_setgray_fill</function>, + <function>cpdf_setgray</function>, + <function>cpdf_setrgbcolor_fill</function> und + <function>cpdf_setrgbcolor</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-show-xy"> + <refentry id="function.cpdf-fill-stroke"> <refnamediv> - <refname>cpdf_show_xy</refname> - <refpurpose>Gibt Text an der angegebenen Position aus</refpurpose> + <refname>cpdf_fill_stroke</refname> + <refpurpose> + Füllt und zeichnet den aktuellen Pfad + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_show_xy</function></funcdef> + <funcdef>void <function>cpdf_fill_stroke</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>string <parameter>Text</parameter></paramdef> - <paramdef>double <parameter>x-koor</parameter></paramdef> - <paramdef>double <parameter>y-koor</parameter></paramdef> - <paramdef>int - <parameter><optional>Modus</optional></parameter> - </paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_show_xy</function> gibt die - Zeichenkette <parameter>Text</parameter> an der Position mit den - Koordinaten (<parameter>x-koor</parameter>, - <parameter>y-koor</parameter>) aus. - </para> - <para> - Der optionale Parameter <parameter>Modus</parameter> bestimmt die - Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird - die Einheit verwendet, die für die Seite als Standard angegeben - wurde. Andernfalls werden die Koordinaten unabhängig von der - aktuellen Einheit in Postscript-Punkten gemessen. - <note> - <simpara> - Ohne die optionalen Parameter ist die Funktion - <function>cpdf_show_xy</function> mit - <function>cpdf_text</function> identisch. - </simpara> - </note> + Die Funktion <function>cpdf_fill_stroke</function> füllt den + Innenraum des aktuellen Pfades mit der aktuellen Füllfarbe und + zeichnet den aktuellen Pfad. </para> <para> - Siehe auch: <function>cpdf_text</function>. + Siehe auch: <function>cpdf_closepath</function>, + <function>cpdf_stroke</function>, <function>cpdf_fill</function>, + <function>cpdf_setgray_fill</function>, + <function>cpdf_setgray</function>, + <function>cpdf_setrgbcolor_fill</function> und + <function>cpdf_setrgbcolor</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-text"> + <refentry id="function.cpdf-finalize"> <refnamediv> - <refname>cpdf_text</refname> - <refpurpose>Gibt den Text mit Parametern aus</refpurpose> + <refname>cpdf_finalize</refname> + <refpurpose>Beendet ein Dokument</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_text</function></funcdef> + <funcdef>void <function>cpdf_finalize</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>string <parameter>Text</parameter></paramdef> - <paramdef>double <parameter>x-koor</parameter></paramdef> - <paramdef>double <parameter>y-koor</parameter></paramdef> - <paramdef>int - <parameter><optional>Modus</optional></parameter> - </paramdef> - <paramdef> - double <parameter><optional>Richtung</optional></parameter> - </paramdef> - <paramdef> - int <parameter><optional>Ausrichtungsmodus</optional></parameter> - </paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_text</function> gibt die Zeichenkette - <parameter>Text</parameter> an der Position mit den Koordinaten - (<parameter>x-koor</parameter>, <parameter>y-koor</parameter>) - aus. - </para> - <para> - Der optionale Parameter <parameter>Modus</parameter> bestimmt die - Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird - die Einheit verwendet, die für die Seite als Standard angegeben - wurde. Andernfalls werden die Koordinaten unabhängig von der - aktuellen Einheit in Postscript-Punkten gemessen. Der optionale - Parameter <parameter>Richtung</parameter> bestimmt die Drehung - des Texts in Grad. Der optionale Parameter - <parameter>Ausrichtungsmodus</parameter> bestimmt, wie der Text - ausgerichtet wird. - </para> - <para> - Die möglichen Werte können Sie der ClibPDF-Dokumentation - entnehmen. + Die Funktion <function>cpdf_finalize</function> beendet das + Dokument <parameter>PDF-Dokument</parameter>. Sie müssen danach + trotzdem noch <function>cpdf_close</function> aufrufen. </para> <para> - Siehe auch: <function>cpdf_show_xy</function>. + Siehe auch: <function>cpdf_close</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-set-font"> + <refentry id="function.cpdf-finalize-page"> <refnamediv> - <refname>cpdf_set_font</refname> - <refpurpose>Wählt die aktuelle Schriftart und -größe</refpurpose> + <refname>cpdf_finalize_page</refname> + <refpurpose>Beendet eine Seite</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_set_font</function></funcdef> + <funcdef>void <function>cpdf_finalize_page</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>string <parameter>Schriftart</parameter></paramdef> - <paramdef>double <parameter>Größe</parameter></paramdef> - <paramdef>string <parameter>Kodierung</parameter></paramdef> + <paramdef>int <parameter>Seitennummer</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_set_font</function> setzt die - aktuelle Schriftart, Schriftgröße und -kodierung. Gegenwärtig - werden nur Standard-Postscript-Schriftarten unterstützt. + Die Funktion <function>cpdf_finalize_page</function> beendet die + Seite mit der Seitennummer <parameter>page number</parameter>. </para> <para> - Der Parameter <parameter>Kodierung</parameter> kann die folgenden - Werte akzeptieren: "MacRomanEncoding", "MacExpertEncoding", - "WinAnsiEncoding" und "&null;". "&null;" steht für die - schriftarteigene Kodierung. + Diese Funktion hat nur den Zweck, Speicherplatz zu sparen. Eine + abgeschlossene Seite belegt weniger Speicherplatz, kann aber + nicht mehr verändert werden. </para> <para> - Weitere Informationen, insbesondere wie asiatische Schriftarten - unterstützt werden, finden Sie im ClibPDF-Handbuch. + Siehe auch: <function>cpdf_page_init</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-set-leading"> + <refentry id="function.cpdf-global-set-document-limits"> <refnamediv> - <refname>cpdf_set_leading</refname> - <refpurpose>Setzt den Zeilenabstand</refpurpose> + <refname>cpdf_global_set_document_limits</refname> + <refpurpose> + Setzt Beschränkungen für alle PDF-Dokumente + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_set leading</function></funcdef> - <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>Abstand</parameter></paramdef> + <funcdef> + void <function>cpdf_global_set_document_limits</function> + </funcdef> + <paramdef>int <parameter>maxSeiten</parameter></paramdef> + <paramdef>int <parameter>maxSchriftarten</parameter></paramdef> + <paramdef>int <parameter>maxAbbildungen</parameter></paramdef> + <paramdef>int <parameter>maxBemerkungen</parameter></paramdef> + <paramdef>int <parameter>maxObjekte</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_set_leading</function> setzt den - Zeilenabstand. Dieser wird verwendet, wenn der Text durch - <function>cpdf_continue_text</function> ausgegeben wird. + Die Funktion <function>cpdf_global_set_document_limits</function> + setzt verschiedene Beschränkungen für Dokumente. Damit diese + Funktion wirksam wird, muss sie vor + <function>cpdf_open</function> aufgerufen werden. Sie setzt die + Beschränkungen für alle Dokumente, die danach geöffnet werden. </para> <para> - Siehe auch: <function>cpdf_continue_text</function>. + Siehe auch: <function>cpdf_open</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-set-text-rendering"> + <refentry id="function.cpdf-import-jpeg"> <refnamediv> - <refname>cpdf_set_text_rendering</refname> - <refpurpose>Legt fest, wie Text wiedergegeben wird</refpurpose> + <refname>cpdf_import_jpeg</refname> + <refpurpose>Öffnet ein JPEG-Bild</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void - <function>cpdf_set_text_rendering</function> - </funcdef> + <funcdef>int <function>cpdf_import_jpeg</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>int <parameter>Modus</parameter></paramdef> + <paramdef>string <parameter>Dateiname</parameter></paramdef> + <paramdef>double <parameter>x-koor</parameter></paramdef> + <paramdef>double <parameter>y-koor</parameter></paramdef> + <paramdef>double <parameter>Winkel</parameter></paramdef> + <paramdef>double <parameter>Breite</parameter></paramdef> + <paramdef>double <parameter>Höhe</parameter></paramdef> + <paramdef>double <parameter>x-Skalierung</parameter></paramdef> + <paramdef>double <parameter>y-Skalierung</parameter></paramdef> + <paramdef>int + <parameter><optional>Modus</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_set_text_rendering</function> legt - fest, wie der Text wiedergegeben wird. + Die Funktion <function>cpdf_import_jpeg</function> öffnet ein + Bild, das unter dem Namen <parameter>Dateiname</parameter> + gespeichert wurde. Das Bild muß im JPEG-Format vorliegen. Es wird + auf der aktuellen Seite an der Position + (<parameter>x-koor</parameter>, <parameter>y-koor</parameter>) + platziert. Das Bild wird um <parameter>Winkel</parameter> Grad + gedreht. </para> <para> - Die möglichen Werte für <parameter>Modus</parameter> sind 0=Text - ausfüllen, 1=Text durchstreichen, 2=Text ausfüllen und - durchstreichen, 3=unsichtbar, 4=Text ausfüllen und dem - Begrenzungspfad hinzufügen, 5=Text durchstreichen und dem - Begrenzungspfad hinzufügen, 6=Text ausfüllen und durchstreichen - und dem Begrenzungspfad hinzufügen, 7=dem Begrenzungspfad - hinzufügen. + Der optionale Parameter <parameter>Modus</parameter> bestimmt die + Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird + die Einheit verwendet, die für die Seite als Standard angegeben + wurde. Andernfalls werden die Koordinaten unabhängig von der + aktuellen Einheit in Postscript-Punkten gemessen. </para> - </refsect1> - </refentry> - - <refentry id="function.cpdf-set-horiz-scaling"> - <refnamediv> - <refname>cpdf_set_horiz_scaling</refname> - <refpurpose>Setzt die horizontale Textskalierung</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>cpdf_set_horiz_scaling</function></funcdef> - <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>Maßstab</parameter></paramdef> - </funcprototype> - </funcsynopsis> <para> - Die Funktion <function>cpdf_set_horiz_scaling</function> setzt - die horizontale Skalierung auf <parameter>Maßstab</parameter> - Prozent. + Siehe auch: <function>cpdf_place_inline_image</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-set-text-rise"> + <refentry id="function.cpdf-lineto"> <refnamediv> - <refname>cpdf_set_text_rise</refname> - <refpurpose>Legt die vertikale Textverschiebung fest</refpurpose> + <refname>cpdf_lineto</refname> + <refpurpose>Zeichnet eine Linie</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_set_text_rise</function></funcdef> + <funcdef>void <function>cpdf_lineto</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>Verschiebung</parameter></paramdef> + <paramdef>double <parameter>x-koor</parameter></paramdef> + <paramdef>double <parameter>y-koor</parameter></paramdef> + <paramdef>int + <parameter><optional>Modus</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_set_text_rise</function> legt die - Verschiebung des Texts um <parameter>Verschiebung</parameter> - Einheiten nach oben fest. + Die Funktion <function>cpdf_lineto</function> zeichnet eine Linie + vom aktuellen Punkt zum Punkt mit den Koordinaten + (<parameter>x-koor</parameter>, <parameter>y-koor</parameter>). </para> - </refsect1> - </refentry> - - <refentry id="function.cpdf-set-text-matrix"> - <refnamediv> - <refname>cpdf_set_text_matrix</refname> - <refpurpose>Legt die Text-Matrix fest</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>cpdf_set_text_matrix</function></funcdef> - <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>array <parameter>Matrix</parameter></paramdef> - </funcprototype> - </funcsynopsis> <para> - Die Funktion <function>cpdf_set_text_matrix</function> legt die - Matrix fest, die eine auf die aktuelle Schriftart angewandte - Transformation beschreibt. + Der optionale Parameter <parameter>Modus</parameter> bestimmt die + Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird + die Einheit verwendet, die für die Seite als Standard angegeben + wurde. Andernfalls werden die Koordinaten unabhängig von der + aktuellen Einheit in Postscript-Punkten gemessen. + </para> + <para> + Siehe auch: <function>cpdf_moveto</function>, + <function>cpdf_rmoveto</function> und + <function>cpdf_curveto</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-set-text-pos"> + <refentry id="function.cpdf-moveto"> <refnamediv> - <refname>cpdf_set_text_pos</refname> - <refpurpose>Legt die Textposition fest</refpurpose> + <refname>cpdf_moveto</refname> + <refpurpose>Legt die aktuelle Position fest</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_set_text_pos</function></funcdef> + <funcdef>void <function>cpdf_moveto</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> <paramdef>double <parameter>x-koor</parameter></paramdef> <paramdef>double <parameter>y-koor</parameter></paramdef> @@ -957,9 +870,9 @@ </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_set_text_pos</function> legt die - Position des Textes für den nächsten Aufruf von - <function>cpdf_show</function> fest. + Die Funktion <function>cpdf_moveto</function> setzt die aktuelle + Position auf die Koordinaten <parameter>x-koor</parameter> und + <parameter>y-koor</parameter>. </para> <para> Der optionale Parameter <parameter>Modus</parameter> bestimmt die @@ -969,140 +882,232 @@ aktuellen Einheit in Postscript-Punkten gemessen. </para> <para> - Siehe auch: <function>cpdf_show</function> - <function>cpdf_text</function>. + Siehe auch: <function>cpdf_rmoveto</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-set-char-spacing"> + <refentry id="function.cpdf-newpath"> <refnamediv> - <refname>cpdf_set_char_spacing</refname> - <refpurpose>Legt den Zeichenabstand fest</refpurpose> + <refname>cpdf_newpath</refname> + <refpurpose>Beginnt einen neuen Pfad</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_set_char_spacing</function></funcdef> - <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>Abstand</parameter></paramdef> + <funcdef>void + <function>cpdf_newpath</function> + </funcdef> + <paramdef>int + <parameter>PDF-Dokument</parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_set_char_spacing</function> legt den - Abstand zwischen den Zeichen fest. - </para> - <para> - Siehe auch: <function>cpdf_set_word_spacing</function> - <function>cpdf_set_leading</function>. + Die Funktion <function>cpdf_newpath</function> beginnt auf dem + durch den Parameter <parameter>PDF-Dokument</parameter> + angegebenen Dokument einen neuen Pfad. </para> </refsect1> </refentry> - <refentry id="function.cpdf-set-word-spacing"> + <refentry id="function.cpdf-open"> <refnamediv> - <refname>cpdf_set_word_spacing</refname> - <refpurpose> - Legt den Abstand zwischen den Wörtern fest - </refpurpose> + <refname>cpdf_open</refname> + <refpurpose>Öffnet ein neues PDF-Dokument</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_set_word_spacing</function></funcdef> - <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>Abstand</parameter></paramdef> + <funcdef>int <function>cpdf_open</function></funcdef> + <paramdef>int <parameter>Komprimierung</parameter></paramdef> + <paramdef> + string <parameter><optional>Dateiname</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_set_word_spacing</function> legt den - Abstand zwischen den Wörtern fest. - </para> - <para> - Siehe auch: <function>cpdf_set_char_spacing</function> - <function>cpdf_set_leading</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.cpdf-continue-text"> + Die Funktion <function>cpdf_open</function> öffnet ein neues + PDF-Dokument. Wenn <parameter>Komprimierung</parameter> ungleich + 0 ist, schaltet dieser Parameter die Komprimierung des Dokuments + ein. Der optionale Parameter <parameter>Dateiname</parameter> + bestimmt die Datei in die das Dokument geschrieben wird. Wenn er + nicht angegeben wurde, wird das Dokument im Speicher erzeugt und + kann entweder mit <function>cpdf_save_to_file</function> in eine + Datei geschrieben werden oder mit + <function>cpdf_output_buffer</function> an die Standardausgabe + geschickt werden. + <note> + <simpara> + Der Rückgabewert wird in künftigen ClibPDF-Versionen als erster + Parameter aller anderen Funktionen benötigt, die in ein + PDF-Dokument schreiben. + </simpara> + <simpara> + Die ClibPDF-Bibliothek betrachtet den Dateinamen "-" als + Synonym für stdout. Das funktioniert allerdings nicht, wenn PHP + als Apache-Modul kompiliert wurde, weil die Art und Weise, in + der ClibPDF die Ausgabe an stdout vornimmt, nicht mit Apache + funktioniert. Sie können dieses Problem lösen, indem Sie keinen + Dateinamen angeben und stattdessen + <function>cpdf_output_buffer</function> verwenden, um das + PDF-Dokument auszugeben. + </simpara> + </note> + </para> + <para> + Siehe auch: <function>cpdf_close</function> und + <function>cpdf_output_buffer</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.cpdf-output-buffer"> <refnamediv> - <refname>cpdf_continue_text</refname> - <refpurpose>Gibt den Text in der nächsten Zeile aus</refpurpose> + <refname>cpdf_output_buffer</refname> + <refpurpose> + Gibt das PDF-Dokument aus dem Zwischenspeicher aus + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_continue_text</function></funcdef> + <funcdef>void <function>cpdf_output_buffer</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>string <parameter>Text</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_continue_text</function> gibt die - Zeichenkette in <parameter>Text</parameter> in der nächsten Zeile - aus. + Die Funktion <function>cpdf_output_buffer</function> gibt das + PDF-Dokument an stdout aus. Das Dokument muss im Speicher + erstellt worden sein, was der Fall ist, wenn + <function>cpdf_open</function> ohne den Parameter Dateiname + aufgerufen wurde. </para> <para> - Siehe auch: <function>cpdf_show_xy</function>, - <function>cpdf_text</function>, - <function>cpdf_set_leading</function> und - <function>cpdf_set_text_pos</function>. + Siehe auch: <function>cpdf_open</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-stringwidth"> + <refentry id="function.cpdf-page-init"> <refnamediv> - <refname>cpdf_stringwidth</refname> - <refpurpose> - Liefert die Breite einer Zeichenkette in der aktuellen Schriftart - </refpurpose> + <refname>cpdf_page_init</refname> + <refpurpose>Beginnt eine neue Seite</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>double <function>cpdf_stringwidth</function></funcdef> + <funcdef>void <function>cpdf_page_init</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>string <parameter>Text</parameter></paramdef> + <paramdef>int <parameter>Seitennummer</parameter></paramdef> + <paramdef>int <parameter>Ausrichtung</parameter></paramdef> + <paramdef>double <parameter>Höhe</parameter></paramdef> + <paramdef>double <parameter>Breite</parameter></paramdef> + <paramdef> + double <parameter><optional>Einheit</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_stringwidth</function> gibt die - Breite der Zeichenkette in <parameter>Text</parameter> zurück. - Zuvor muß eine Schriftart festgelegt werden. + Die Funktion <function>cpdf_page_init</function> beginnt eine + neue Seite mit der Höhe <parameter>Höhe</parameter> und der + Breite <parameter>Breite</parameter>. Die Seite hat die Nummer + <parameter>Seitennummer</parameter> und die Ausrichtung + <parameter>Ausrichtung</parameter>. + <parameter>Ausrichtung</parameter> kann 0 für Hochformat oder 1 + für Querformat sein. Der optionale Parameter + <parameter>Einheit</parameter> gibt die Einheit des + Koordinatensystems in Anzahl von Postscript-Punkten pro Einheit + an. Da ein Zoll 72 Punkten entspricht, würde ein Wert von 72 + die Einheit auf ein Zoll setzen. Auch der Standardwert ist 72. </para> <para> - Siehe auch: <function>cpdf_set_font</function>. + Siehe auch: <function>cpdf_set_current_page</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-save"> + <refentry id="function.cpdf-place-inline-image"> <refnamediv> - <refname>cpdf_save</refname> - <refpurpose>Sichert die aktuelle Umgebung</refpurpose> + <refname>cpdf_place_inline_image</refname> + <refpurpose>Plaziert ein Bild auf der Seite</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_save</function></funcdef> + <funcdef>void + <function>cpdf_place_inline_image</function> + </funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> + <paramdef>int <parameter>Bild</parameter></paramdef> + <paramdef>double <parameter>x-koor</parameter></paramdef> + <paramdef>double <parameter>y-koor</parameter></paramdef> + <paramdef>double <parameter>Winkel</parameter></paramdef> + <paramdef>double <parameter>Breite</parameter></paramdef> + <paramdef>double <parameter>Höhe</parameter></paramdef> + <paramdef>int + <parameter><optional>Modus</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_save</function> sichert die aktuelle - Umgebung. Sie funktioniert wie der Postscript-Befehl gsave und - ist sehr nützlich, wenn Sie ein Objekt verschieben oder drehen - wollen, ohne daß es sich auf andere Objekte auswirkt. + Die Funktion <function>cpdf_place_inline_image</function> + plaziert auf der Seite ein Bild, das mit der PHP-Image-Funktion + erstellt wurde, an der Position (<parameter>x-koor</parameter>, + <parameter>y-koor</parameter>). Das Bild kann gleichzeitig + skaliert werden. </para> <para> - Siehe auch: <function>cpdf_restore</function>. + Der optionale Parameter <parameter>Modus</parameter> bestimmt die + Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird + die Einheit verwendet, die für die Seite als Standard angegeben + wurde. Andernfalls werden die Koordinaten unabhängig von der + aktuellen Einheit in Postscript-Punkten gemessen. + </para> + <para> + Siehe auch: <function>cpdf_import_jpeg</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.cpdf-rect"> + <refnamediv> + <refname>cpdf_rect</refname> + <refpurpose>Zeichnet ein Rechteck</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>cpdf_rect</function></funcdef> + <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> + <paramdef>double <parameter>x-koor</parameter></paramdef> + <paramdef>double <parameter>y-koor</parameter></paramdef> + <paramdef>double <parameter>Breite</parameter></paramdef> + <paramdef>double <parameter>Höhe</parameter></paramdef> + <paramdef>int + <parameter><optional>Modus</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Die Funktion <function>cpdf_rect</function> zeichnet ein + Rechteck, bei dem die linke untere Ecke im Punkt + (<parameter>x-koor</parameter>, <parameter>y-koor</parameter>) + liegt. Die Breite wird auf <parameter>Breite</parameter> und die + Höhe auf <parameter>Höhe</parameter> gesetzt. + </para> + <para> + Der optionale Parameter <parameter>Modus</parameter> bestimmt die + Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird + die Einheit verwendet, die für die Seite als Standard angegeben + wurde. Andernfalls werden die Koordinaten unabhängig von der + aktuellen Einheit in Postscript-Punkten gemessen. </para> </refsect1> </refentry> @@ -1145,18 +1150,16 @@ </refsect1> </refentry> - <refentry id="function.cpdf-translate"> + <refentry id="function.cpdf-rlineto"> <refnamediv> - <refname>cpdf_translate</refname> - <refpurpose> - Legt den Ursprung des Koordinatensystems fest - </refpurpose> + <refname>cpdf_rlineto</refname> + <refpurpose>Zeichnet eine Linie (relativ)</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_translate</function></funcdef> + <funcdef>void <function>cpdf_rlineto</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> <paramdef>double <parameter>x-koor</parameter></paramdef> <paramdef>double <parameter>y-koor</parameter></paramdef> @@ -1166,8 +1169,8 @@ </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_translate</function> setzt den - Ursprung des Koordinatensystems auf den Punkt + Die Funktion <function>cpdf_rlineto</function> zeichnet eine + Linie vom aktuellen Punkt zum relativen Punkt mit den Koordinaten (<parameter>x-koor</parameter>, <parameter>y-koor</parameter>). </para> <para> @@ -1177,27 +1180,46 @@ wurde. Andernfalls werden die Koordinaten unabhängig von der aktuellen Einheit in Postscript-Punkten gemessen. </para> + <para> + Siehe auch: <function>cpdf_moveto</function>, + <function>cpdf_rmoveto</function> und + <function>cpdf_curveto</function>. + </para> </refsect1> </refentry> - <refentry id="function.cpdf-scale"> + <refentry id="function.cpdf-rmoveto"> <refnamediv> - <refname>cpdf_scale</refname> - <refpurpose>Legt die Vergrößerung fest</refpurpose> + <refname>cpdf_rmoveto</refname> + <refpurpose>Legt die relative aktuelle Position fest</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_scale</function></funcdef> + <funcdef>void <function>cpdf_rmoveto</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>x-Vergrößerung</parameter></paramdef> - <paramdef>double <parameter>y-Vergrößerung</parameter></paramdef> + <paramdef>double <parameter>x-koor</parameter></paramdef> + <paramdef>double <parameter>y-koor</parameter></paramdef> + <paramdef>int + <parameter><optional>Modus</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_scale</function> setzt den - Vergrößerungsfaktor in beide Richtungen. + Die Funktion <function>cpdf_rmoveto</function> setzt die aktuelle + Position relativ zu den Koordinaten <parameter>x-koor</parameter> + und <parameter>y-koor</parameter>. + </para> + <para> + Der optionale Parameter <parameter>Modus</parameter> bestimmt die + Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird + die Einheit verwendet, die für die Seite als Standard angegeben + wurde. Andernfalls werden die Koordinaten unabhängig von der + aktuellen Einheit in Postscript-Punkten gemessen. + </para> + <para> + Siehe auch: <function>cpdf_moveto</function>. </para> </refsect1> </refentry> @@ -1223,328 +1245,399 @@ </refsect1> </refentry> - <refentry id="function.cpdf-setflat"> + <refentry id="function.cpdf-save"> <refnamediv> - <refname>cpdf_setflat</refname> - <refpurpose>Legt die Flachheit fest</refpurpose> + <refname>cpdf_save</refname> + <refpurpose>Sichert die aktuelle Umgebung</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_setflat</function></funcdef> + <funcdef>void <function>cpdf_save</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>Flachheit</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_setflat</function> setzt die - Flachheit auf einen Wert zwischen 0 und 100. + Die Funktion <function>cpdf_save</function> sichert die aktuelle + Umgebung. Sie funktioniert wie der Postscript-Befehl gsave und + ist sehr nützlich, wenn Sie ein Objekt verschieben oder drehen + wollen, ohne daß es sich auf andere Objekte auswirkt. + </para> + <para> + Siehe auch: <function>cpdf_restore</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-setlinejoin"> + <refentry id="function.cpdf-save-to-file"> <refnamediv> - <refname>cpdf_setlinejoin</refname> - <refpurpose>Legt den Typ der Linienverbindungen fest</refpurpose> + <refname>cpdf_save_to_file</refname> + <refpurpose>Schreibt ein PDF-Dokument in eine Datei</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_setlinejoin</function></funcdef> + <funcdef>void <function>cpdf_save_to_file</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>long <parameter>Typ</parameter></paramdef> + <paramdef>string <parameter>Dateiname</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_setlinejoin</function> setzt den Typ - der Linienverbindungen auf einen Wert zwischen 0 und 2. 0 = - Gehrung, 1 = rund, 2 = schräg. + Die Funktion <function>cpdf_save_to_file</function> schreibt das + PDF-Dokument in eine Datei, sofern es im Speicher erstellt wurde. + </para> + <para> + Diese Funktion wird nicht benötigt, wenn das PDF-Dokument unter + Angabe eines Dateinamens als Parameter von + <function>cpdf_open</function> geöffnet wurde. + </para> + <para> + Siehe auch: <function>cpdf_output_buffer</function> und + <function>cpdf_open</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-setlinecap"> + <refentry id="function.cpdf-scale"> <refnamediv> - <refname>cpdf_setlinecap</refname> - <refpurpose>Legt den Typ der Linienenden fest</refpurpose> + <refname>cpdf_scale</refname> + <refpurpose>Legt die Vergrößerung fest</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_setlinecap</function></funcdef> + <funcdef>void <function>cpdf_scale</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>int <parameter>Typ</parameter></paramdef> + <paramdef>double + <parameter>x-Vergrößerung</parameter> + </paramdef> + <paramdef>double + <parameter>y-Vergrößerung</parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_setlinecap</function> setzt den Typ - der Linienenden auf einen Wert zwischen 0 und 2. 0 = stumpfes - Ende, 1 = rund, 2 = vorspringendes Quadrat. + Die Funktion <function>cpdf_scale</function> setzt den + Vergrößerungsfaktor in beide Richtungen. </para> </refsect1> </refentry> - <refentry id="function.cpdf-setmiterlimit"> + <refentry id="function.cpdf-set-char-spacing"> <refnamediv> - <refname>cpdf_setmiterlimit</refname> - <refpurpose>Legt die Gehrungsbegrenzung fest</refpurpose> + <refname>cpdf_set_char_spacing</refname> + <refpurpose>Legt den Zeichenabstand fest</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_setmiterlimit</function></funcdef> + <funcdef>void + <function>cpdf_set_char_spacing</function> + </funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>Wert</parameter></paramdef> + <paramdef>double <parameter>Abstand</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_setmiterlimit</function> setzt die - Gehrungsbegrenzung auf einen Wert größer oder gleich 1. + Die Funktion <function>cpdf_set_char_spacing</function> legt den + Abstand zwischen den Zeichen fest. + </para> + <para> + Siehe auch: <function>cpdf_set_word_spacing</function> + <function>cpdf_set_leading</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-setlinewidth"> + <refentry id="function.cpdf-set-creator"> + <refnamediv> + <refname>cpdf_set_creator</refname> + <refpurpose>Setzt das Urheberfeld des PDF-Dokuments</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>cpdf_set_creator</function></funcdef> + <paramdef>string <parameter>Urheber</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Die Funktion <function>cpdf_set_creator</function> setzt den + Urheber eines PDF-Dokuments. + </para> + <para> + Siehe auch: <function>cpdf_set_subject</function>, + <function>cpdf_set_title</function> und + <function>cpdf_set_keywords</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.cpdf-set-current-page"> <refnamediv> - <refname>cpdf_setlinewidth</refname> - <refpurpose>Legt die Linienbreite fest</refpurpose> + <refname>cpdf_set_current_page</refname> + <refpurpose>Setzt die aktuelle Seite</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_setlinewidth</function></funcdef> + <funcdef>void + <function>cpdf_set_current_page</function> + </funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>Breite</parameter></paramdef> + <paramdef>int <parameter>Seitennummer</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_setlinewidth</function> setzt die - Linienbreite auf <parameter>Breite</parameter>. + Die Funktion <function>cpdf_set_current_page</function> setzt die + Seite, an der alle Aktionen durchgeführt werden. Sie können + solange zwischen den Seiten wechseln, bis Sie eine Seite mit + <function>cpdf_finalize_page</function> abschließen. + </para> + <para> + Siehe auch: <function>cpdf_finalize_page</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-setdash"> + <refentry id="function.cpdf-set-font"> <refnamediv> - <refname>cpdf_setdash</refname> - <refpurpose>Setzt eine gestrichelte Linie</refpurpose> + <refname>cpdf_set_font</refname> + <refpurpose>Wählt die aktuelle Schriftart und -größe</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_setdash</function></funcdef> + <funcdef>void <function>cpdf_set_font</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>schwarz</parameter></paramdef> - <paramdef>double <parameter>weiß</parameter></paramdef> + <paramdef>string <parameter>Schriftart</parameter></paramdef> + <paramdef>double <parameter>Größe</parameter></paramdef> + <paramdef>string <parameter>Kodierung</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_setdash</function> setzt das Muster - einer gestrichelten Linie auf <parameter>weiß</parameter> weiße - Einheiten und <parameter>schwarz</parameter> schwarze Einheiten. - Wenn beide 0 sind, wird die Linie durchgezogen. + Die Funktion <function>cpdf_set_font</function> setzt die + aktuelle Schriftart, Schriftgröße und -kodierung. Gegenwärtig + werden nur Standard-Postscript-Schriftarten unterstützt. + </para> + <para> + Der Parameter <parameter>Kodierung</parameter> kann die folgenden + Werte akzeptieren: "MacRomanEncoding", "MacExpertEncoding", + "WinAnsiEncoding" und "&null;". "&null;" steht für die + schriftarteigene Kodierung. + </para> + <para> + Weitere Informationen, insbesondere wie asiatische Schriftarten + unterstützt werden, finden Sie im ClibPDF-Handbuch. </para> </refsect1> </refentry> - - <refentry id="function.cpdf-newpath"> + + <refentry id="function.cpdf-set-horiz-scaling"> <refnamediv> - <refname>cpdf_newpath</refname> - <refpurpose>Beginnt einen neuen Pfad</refpurpose> + <refname>cpdf_set_horiz_scaling</refname> + <refpurpose>Setzt die horizontale Textskalierung</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void - <function>cpdf_newpath</function> + <funcdef>void + <function>cpdf_set_horiz_scaling</function> </funcdef> - <paramdef>int - <parameter>PDF-Dokument</parameter> - </paramdef> + <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> + <paramdef>double <parameter>Maßstab</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_newpath</function> beginnt auf dem - durch den Parameter <parameter>PDF-Dokument</parameter> - angegebenen Dokument einen neuen Pfad. + Die Funktion <function>cpdf_set_horiz_scaling</function> setzt + die horizontale Skalierung auf <parameter>Maßstab</parameter> + Prozent. </para> </refsect1> </refentry> - - <refentry id="function.cpdf-moveto"> + + <refentry id="function.cpdf-set-keywords"> <refnamediv> - <refname>cpdf_moveto</refname> - <refpurpose>Legt die aktuelle Position fest</refpurpose> + <refname>cpdf_set_keywords</refname> + <refpurpose> + Setzt das Schlüsselwortfeld des PDF-Dokuments + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_moveto</function></funcdef> - <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>x-koor</parameter></paramdef> - <paramdef>double <parameter>y-koor</parameter></paramdef> - <paramdef>int - <parameter><optional>Modus</optional></parameter> + <funcdef>void <function>cpdf_set_keywords</function></funcdef> + <paramdef>string + <parameter>Schlüsselwörter</parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_moveto</function> setzt die aktuelle - Position auf die Koordinaten <parameter>x-koor</parameter> und - <parameter>y-koor</parameter>. - </para> - <para> - Der optionale Parameter <parameter>Modus</parameter> bestimmt die - Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird - die Einheit verwendet, die für die Seite als Standard angegeben - wurde. Andernfalls werden die Koordinaten unabhängig von der - aktuellen Einheit in Postscript-Punkten gemessen. + Die Funktion <function>cpdf_set_keywords</function> setzt die + Schlüsselwörter eines PDF-Dokuments. </para> <para> - Siehe auch: <function>cpdf_rmoveto</function>. + Siehe auch: <function>cpdf_set_title</function>, + <function>cpdf_set_creator</function> und + <function>cpdf_set_subject</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-rmoveto"> + <refentry id="function.cpdf-set-leading"> <refnamediv> - <refname>cpdf_rmoveto</refname> - <refpurpose>Legt die relative aktuelle Position fest</refpurpose> + <refname>cpdf_set_leading</refname> + <refpurpose>Setzt den Zeilenabstand</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_rmoveto</function></funcdef> + <funcdef>void <function>cpdf_set leading</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>x-koor</parameter></paramdef> - <paramdef>double <parameter>y-koor</parameter></paramdef> - <paramdef>int - <parameter><optional>Modus</optional></parameter> - </paramdef> + <paramdef>double <parameter>Abstand</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_rmoveto</function> setzt die aktuelle - Position relativ zu den Koordinaten <parameter>x-koor</parameter> - und <parameter>y-koor</parameter>. - </para> - <para> - Der optionale Parameter <parameter>Modus</parameter> bestimmt die - Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird - die Einheit verwendet, die für die Seite als Standard angegeben - wurde. Andernfalls werden die Koordinaten unabhängig von der - aktuellen Einheit in Postscript-Punkten gemessen. + Die Funktion <function>cpdf_set_leading</function> setzt den + Zeilenabstand. Dieser wird verwendet, wenn der Text durch + <function>cpdf_continue_text</function> ausgegeben wird. </para> <para> - Siehe auch: <function>cpdf_moveto</function>. + Siehe auch: <function>cpdf_continue_text</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-curveto"> + <refentry id="function.cpdf-set-page-animation"> <refnamediv> - <refname>cpdf_curveto</refname> - <refpurpose>Zeichnet eine Kurve</refpurpose> + <refname>cpdf_set_page_animation</refname> + <refpurpose> + Legt den Übergang zwischen den Seiten fest + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_curveto</function></funcdef> + <funcdef>void + <function>cpdf_set_page_animation</function> + </funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>x1</parameter></paramdef> - <paramdef>double <parameter>y1</parameter></paramdef> - <paramdef>double <parameter>x2</parameter></paramdef> - <paramdef>double <parameter>y2</parameter></paramdef> - <paramdef>double <parameter>x3</parameter></paramdef> - <paramdef>double <parameter>y3</parameter></paramdef> - <paramdef>int - <parameter><optional>Modus</optional></parameter> - </paramdef> + <paramdef>int <parameter>Übergang</parameter></paramdef> + <paramdef>double <parameter>Dauer</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_curveto</function> zeichnet eine - Bezier-Kurve vom aktuellen Punkt zum Punkt - (<parameter>x3</parameter>, <parameter>y3</parameter>), wobei - (<parameter>x1</parameter>, <parameter>y1</parameter>) und - (<parameter>x2</parameter>, <parameter>y2</parameter>) als - Kontrollpunkte verwendet werden. + Die Funktion <function>cpdf_set_page_animation</function> legt + den Übergang zwischen aufeinanderfolgenden Seiten fest. </para> <para> - Der optionale Parameter <parameter>Modus</parameter> bestimmt die - Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird - die Einheit verwendet, die für die Seite als Standard angegeben - wurde. Andernfalls werden die Koordinaten unabhängig von der - aktuellen Einheit in Postscript-Punkten gemessen. + <parameter>Übergang</parameter> kann folgende Werte haben: + <simplelist> + <member>0 für keinen,</member> + <member> + 1 für zwei über den Bildschirm sausende Zeilen, die die nächste + Seite enthüllen, + </member> + <member> + 2 für mehrere über den Bildschirm sausende Zeilen, die die + nächste Seite enthüllen, + </member> + <member>3 für eine Box, die die nächste Seite enthüllt,</member> + <member> + 4 für eine einzelne über den Bildschirm sausende Zeile, die die + nächste Seite enthüllt, + </member> + <member> + 5, daß dich die alte Seite auflöst und die nächste Seite + enthüllt, + </member> + <member> + 6, daß der Auflösungseffekt vom einen Bildschirmrand zum + anderen wandert, + </member> + <member> + 7, daß die alte Seite einfach durch die neue Seite ersetzt wird + (Grundeinstellung) + </member> + </simplelist> </para> <para> - Siehe auch: <function>cpdf_moveto</function>, - <function>cpdf_rmoveto</function>, - <function>cpdf_rlineto</function> und - <function>cpdf_lineto</function>. + Der Wert <parameter>Dauer</parameter> ist die Anzahl der Sekunden + während des Seitenwechsels. </para> </refsect1> </refentry> - <refentry id="function.cpdf-lineto"> + <refentry id="function.cpdf-set-subject"> <refnamediv> - <refname>cpdf_lineto</refname> - <refpurpose>Zeichnet eine Linie</refpurpose> + <refname>cpdf_set_subject</refname> + <refpurpose>Setzt das Themenfeld des PDF-Dokuments</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_lineto</function></funcdef> - <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>x-koor</parameter></paramdef> - <paramdef>double <parameter>y-koor</parameter></paramdef> - <paramdef>int - <parameter><optional>Modus</optional></parameter> - </paramdef> + <funcdef>void <function>cpdf_set_subject</function></funcdef> + <paramdef>string <parameter>Thema</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_lineto</function> zeichnet eine Linie - vom aktuellen Punkt zum Punkt mit den Koordinaten - (<parameter>x-koor</parameter>, <parameter>y-koor</parameter>). + Die Funktion <function>cpdf_set_subject</function> setzt das + Thema eines PDF-Dokuments. </para> <para> - Der optionale Parameter <parameter>Modus</parameter> bestimmt die - Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird - die Einheit verwendet, die für die Seite als Standard angegeben - wurde. Andernfalls werden die Koordinaten unabhängig von der - aktuellen Einheit in Postscript-Punkten gemessen. + Siehe auch: <function>cpdf_set_title</function>, + <function>cpdf_set_creator</function> und + <function>cpdf_set_keywords</function>. </para> + </refsect1> + </refentry> + + <refentry id="function.cpdf-set-text-matrix"> + <refnamediv> + <refname>cpdf_set_text_matrix</refname> + <refpurpose>Legt die Text-Matrix fest</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <funcsynopsis> + <funcprototype> + <funcdef>void + <function>cpdf_set_text_matrix</function> + </funcdef> + <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> + <paramdef>array <parameter>Matrix</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> - Siehe auch: <function>cpdf_moveto</function>, - <function>cpdf_rmoveto</function> und - <function>cpdf_curveto</function>. + Die Funktion <function>cpdf_set_text_matrix</function> legt die + Matrix fest, die eine auf die aktuelle Schriftart angewandte + Transformation beschreibt. </para> </refsect1> </refentry> - <refentry id="function.cpdf-rlineto"> + <refentry id="function.cpdf-set-text-pos"> <refnamediv> - <refname>cpdf_rlineto</refname> - <refpurpose>Zeichnet eine Linie (relativ)</refpurpose> + <refname>cpdf_set_text_pos</refname> + <refpurpose>Legt die Textposition fest</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_rlineto</function></funcdef> + <funcdef>void <function>cpdf_set_text_pos</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> <paramdef>double <parameter>x-koor</parameter></paramdef> <paramdef>double <parameter>y-koor</parameter></paramdef> @@ -1554,9 +1647,9 @@ </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_rlineto</function> zeichnet eine - Linie vom aktuellen Punkt zum relativen Punkt mit den Koordinaten - (<parameter>x-koor</parameter>, <parameter>y-koor</parameter>). + Die Funktion <function>cpdf_set_text_pos</function> legt die + Position des Textes für den nächsten Aufruf von + <function>cpdf_show</function> fest. </para> <para> Der optionale Parameter <parameter>Modus</parameter> bestimmt die @@ -1566,386 +1659,348 @@ aktuellen Einheit in Postscript-Punkten gemessen. </para> <para> - Siehe auch: <function>cpdf_moveto</function>, - <function>cpdf_rmoveto</function> und - <function>cpdf_curveto</function>. + Siehe auch: <function>cpdf_show</function> + <function>cpdf_text</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-circle"> + <refentry id="function.cpdf-set-text-rendering"> <refnamediv> - <refname>cpdf_circle</refname> - <refpurpose>Zeichnet einen Kreis</refpurpose> + <refname>cpdf_set_text_rendering</refname> + <refpurpose>Legt fest, wie Text wiedergegeben wird</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_circle</function></funcdef> + <funcdef>void + <function>cpdf_set_text_rendering</function> + </funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>x-koor</parameter></paramdef> - <paramdef>double <parameter>y-koor</parameter></paramdef> - <paramdef>double <parameter>Radius</parameter></paramdef> - <paramdef>int - <parameter><optional>Modus</optional></parameter> - </paramdef> + <paramdef>int <parameter>Modus</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_circle</function> zeichnet einen - Kreis mit dem Mittelpunkt (<parameter>x-koor</parameter>, - <parameter>y-koor</parameter>) und dem Radius - <parameter>Radius</parameter>. - </para> - <para> - Der optionale Parameter <parameter>Modus</parameter> bestimmt die - Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird - die Einheit verwendet, die für die Seite als Standard angegeben - wurde. Andernfalls werden die Koordinaten unabhängig von der - aktuellen Einheit in Postscript-Punkten gemessen. + Die Funktion <function>cpdf_set_text_rendering</function> legt + fest, wie der Text wiedergegeben wird. </para> <para> - Siehe auch: <function>cpdf_arc</function>. + Die möglichen Werte für <parameter>Modus</parameter> sind 0=Text + ausfüllen, 1=Text durchstreichen, 2=Text ausfüllen und + durchstreichen, 3=unsichtbar, 4=Text ausfüllen und dem + Begrenzungspfad hinzufügen, 5=Text durchstreichen und dem + Begrenzungspfad hinzufügen, 6=Text ausfüllen und durchstreichen + und dem Begrenzungspfad hinzufügen, 7=dem Begrenzungspfad + hinzufügen. </para> </refsect1> </refentry> - <refentry id="function.cpdf-arc"> + <refentry id="function.cpdf-set-text-rise"> <refnamediv> - <refname>cpdf_arc</refname> - <refpurpose>Zeichnet einen Kreisbogen</refpurpose> + <refname>cpdf_set_text_rise</refname> + <refpurpose>Legt die vertikale Textverschiebung fest</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_arc</function></funcdef> + <funcdef>void <function>cpdf_set_text_rise</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>x-koor</parameter></paramdef> - <paramdef>double <parameter>y-koor</parameter></paramdef> - <paramdef>double <parameter>Radius</parameter></paramdef> - <paramdef>double <parameter>Anfang</parameter></paramdef> - <paramdef>double <parameter>Ende</parameter></paramdef> - <paramdef>int - <parameter><optional>Modus</optional></parameter> - </paramdef> + <paramdef>double <parameter>Verschiebung</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Die Funktion <function>cpdf_set_text_rise</function> legt die + Verschiebung des Texts um <parameter>Verschiebung</parameter> + Einheiten nach oben fest. + </para> + </refsect1> + </refentry> + + <refentry id="function.cpdf-set-title"> + <refnamediv> + <refname>cpdf_set_title</refname> + <refpurpose>Setzt das Titelfeld PDF-Dokuments</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>cpdf_set_title</function></funcdef> + <paramdef>string <parameter>Titel</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_arc</function> zeichnet einen - Kreisbogen mit dem Mittelpunkt (<parameter>x-koor</parameter>, - <parameter>y-koor</parameter>) und dem Radius - <parameter>Radius</parameter>, der mit dem Winkel - <parameter>Anfang</parameter> beginnt und mit dem Winkel - <parameter>Ende</parameter> endet. - </para> - <para> - Der optionale Parameter <parameter>Modus</parameter> bestimmt die - Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird - die Einheit verwendet, die für die Seite als Standard angegeben - wurde. Andernfalls werden die Koordinaten unabhängig von der - aktuellen Einheit in Postscript-Punkten gemessen. + Die Funktion <function>cpdf_set_title</function> setzt den Titel + eines PDF-Dokuments. </para> <para> - Siehe auch: <function>cpdf_circle</function>. + Siehe auch: <function>cpdf_set_subject</function>, + <function>cpdf_set_creator</function> und + <function>cpdf_set_keywords</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-rect"> + <refentry id="function.cpdf-set-word-spacing"> <refnamediv> - <refname>cpdf_rect</refname> - <refpurpose>Zeichnet ein Rechteck</refpurpose> + <refname>cpdf_set_word_spacing</refname> + <refpurpose> + Legt den Abstand zwischen den Wörtern fest + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_rect</function></funcdef> + <funcdef>void + <function>cpdf_set_word_spacing</function> + </funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>x-koor</parameter></paramdef> - <paramdef>double <parameter>y-koor</parameter></paramdef> - <paramdef>double <parameter>Breite</parameter></paramdef> - <paramdef>double <parameter>Höhe</parameter></paramdef> - <paramdef>int - <parameter><optional>Modus</optional></parameter> - </paramdef> + <paramdef>double <parameter>Abstand</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_rect</function> zeichnet ein - Rechteck, bei dem die linke untere Ecke im Punkt - (<parameter>x-koor</parameter>, <parameter>y-koor</parameter>) - liegt. Die Breite wird auf <parameter>Breite</parameter> und die - Höhe auf <parameter>Höhe</parameter> gesetzt. + Die Funktion <function>cpdf_set_word_spacing</function> legt den + Abstand zwischen den Wörtern fest. </para> <para> - Der optionale Parameter <parameter>Modus</parameter> bestimmt die - Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird - die Einheit verwendet, die für die Seite als Standard angegeben - wurde. Andernfalls werden die Koordinaten unabhängig von der - aktuellen Einheit in Postscript-Punkten gemessen. + Siehe auch: <function>cpdf_set_char_spacing</function> + <function>cpdf_set_leading</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-closepath"> + <refentry id="function.cpdf-setdash"> <refnamediv> - <refname>cpdf_closepath</refname> - <refpurpose>Schließt den aktuellen Pfad</refpurpose> + <refname>cpdf_setdash</refname> + <refpurpose>Setzt eine gestrichelte Linie</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_closepath</function></funcdef> + <funcdef>void <function>cpdf_setdash</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> + <paramdef>double <parameter>schwarz</parameter></paramdef> + <paramdef>double <parameter>weiß</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_closepath</function> schließt den - aktuellen Pfad. + Die Funktion <function>cpdf_setdash</function> setzt das Muster + einer gestrichelten Linie auf <parameter>weiß</parameter> weiße + Einheiten und <parameter>schwarz</parameter> schwarze Einheiten. + Wenn beide 0 sind, wird die Linie durchgezogen. </para> </refsect1> </refentry> - <refentry id="function.cpdf-stroke"> + <refentry id="function.cpdf-setflat"> <refnamediv> - <refname>cpdf_stroke</refname> - <refpurpose> - Zeichnet eine Linie entlang des aktuellen Pfades - </refpurpose> + <refname>cpdf_setflat</refname> + <refpurpose>Legt die Flachheit fest</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_stroke</function></funcdef> + <funcdef>void <function>cpdf_setflat</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> + <paramdef>double <parameter>Flachheit</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_stroke</function> Zeichnet eine Linie - entlang des aktuellen Pfades. - </para> - <para> - Siehe auch: <function>cpdf_closepath</function> und - <function>cpdf_closepath_stroke</function>. + Die Funktion <function>cpdf_setflat</function> setzt die + Flachheit auf einen Wert zwischen 0 und 100. </para> </refsect1> </refentry> - <refentry id="function.cpdf-closepath-stroke"> + <refentry id="function.cpdf-setgray"> <refnamediv> - <refname>cpdf_closepath_stroke</refname> + <refname>cpdf_setgray</refname> <refpurpose> - Schließt einen Pfad und zeichnet eine Linie entlang des Pfades + Setzt Zeichen- und Füllfarbe auf einen Grauwert </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void - <function>cpdf_closepath_stroke</function> - </funcdef> + <funcdef>void <function>cpdf_setgray</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> + <paramdef>double <parameter>Grauwert</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_closepath_stroke</function> ist eine - Kombination aus <function>cpdf_closepath</function> und - <function>cpdf_stroke</function>. Der Pfad wird geschlossen. + Die Funktion <function>cpdf_setgray_stroke</function> setzt die + aktuelle Zeichen- und Füllfarbe auf den angegebenen Grauwert. </para> <para> - Siehe auch: <function>cpdf_closepath</function> und - <function>cpdf_stroke</function>. + Siehe auch: <function>cpdf_setrgbcolor_stroke</function> und + <function>cpdf_setrgbcolor_fill</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-fill"> + <refentry id="function.cpdf-setgray-fill"> <refnamediv> - <refname>cpdf_fill</refname> - <refpurpose>Füllt den aktuellen Pfad</refpurpose> + <refname>cpdf_setgray_fill</refname> + <refpurpose>Setzt die Füllfarbe auf einen Grauwert</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_fill</function></funcdef> + <funcdef>void <function>cpdf_setgray_fill</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> + <paramdef>double <parameter>Grauwert</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_fill</function> füllt den Innenraum - des aktuellen Pfades mit der aktuellen Füllfarbe. + The <function>cpdf_setgray_fill</function> function sets the + current gray value to fill a path. </para> <para> - Siehe auch: <function>cpdf_closepath</function>, - <function>cpdf_stroke</function>, - <function>cpdf_setgray_fill</function>, - <function>cpdf_setgray</function>, - <function>cpdf_setrgbcolor_fill</function> und - <function>cpdf_setrgbcolor</function>. + Siehe auch: <function>cpdf_setrgbcolor_fill</function>. </para> </refsect1> </refentry> - - <refentry id="function.cpdf-fill-stroke"> + + <refentry id="function.cpdf-setgray-stroke"> <refnamediv> - <refname>cpdf_fill_stroke</refname> - <refpurpose> - Füllt und zeichnet den aktuellen Pfad - </refpurpose> + <refname>cpdf_setgray_stroke</refname> + <refpurpose>Setzt die Zeichenfarbe auf einen Grauwert</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_fill_stroke</function></funcdef> + <funcdef>void <function>cpdf_setgray_stroke</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> + <paramdef>double <parameter>Grauwert</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_fill_stroke</function> füllt den - Innenraum des aktuellen Pfades mit der aktuellen Füllfarbe und - zeichnet den aktuellen Pfad. + Die Funktion <function>cpdf_setgray_stroke</function> setzt die + aktuelle Zeichenfarbe auf den angegebenen Grauwert. </para> <para> - Siehe auch: <function>cpdf_closepath</function>, - <function>cpdf_stroke</function>, <function>cpdf_fill</function>, - <function>cpdf_setgray_fill</function>, - <function>cpdf_setgray</function>, - <function>cpdf_setrgbcolor_fill</function> und - <function>cpdf_setrgbcolor</function>. + Siehe auch: <function>cpdf_setrgbcolor_stroke</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-closepath-fill-stroke"> + <refentry id="function.cpdf-setlinecap"> <refnamediv> - <refname>cpdf_closepath_fill_stroke</refname> - <refpurpose> - Schließt, füllt und zeichnet den aktuellen Pfad - </refpurpose> + <refname>cpdf_setlinecap</refname> + <refpurpose>Legt den Typ der Linienenden fest</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void - <function>cpdf_closepath_fill_stroke</function> - </funcdef> + <funcdef>void <function>cpdf_setlinecap</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> + <paramdef>int <parameter>Typ</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_closepath_fill_stroke</function> - schließt den aktuellen Pfad, füllt seinen Innenraum mit der - aktuellen Füllfarbe und zeichnet ihn. - </para> - <para> - Siehe auch: <function>cpdf_closepath</function>, - <function>cpdf_stroke</function>, <function>cpdf_fill</function>, - <function>cpdf_setgray_fill</function>, - <function>cpdf_setgray</function>, - <function>cpdf_setrgbcolor_fill</function> und - <function>cpdf_setrgbcolor</function>. + Die Funktion <function>cpdf_setlinecap</function> setzt den Typ + der Linienenden auf einen Wert zwischen 0 und 2. 0 = stumpfes + Ende, 1 = rund, 2 = vorspringendes Quadrat. </para> </refsect1> </refentry> - <refentry id="function.cpdf-clip"> + <refentry id="function.cpdf-setlinejoin"> <refnamediv> - <refname>cpdf_clip</refname> - <refpurpose> - Beschränkt alle Zeichnungen auf den aktuellen Pfad - </refpurpose> + <refname>cpdf_setlinejoin</refname> + <refpurpose>Legt den Typ der Linienverbindungen fest</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_clip</function></funcdef> + <funcdef>void <function>cpdf_setlinejoin</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> + <paramdef>long <parameter>Typ</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_clip</function> beschränkt alle - Zeichnungen auf den aktuellen Pfad. + Die Funktion <function>cpdf_setlinejoin</function> setzt den Typ + der Linienverbindungen auf einen Wert zwischen 0 und 2. 0 = + Gehrung, 1 = rund, 2 = schräg. </para> </refsect1> </refentry> - - <refentry id="function.cpdf-setgray-fill"> + + <refentry id="function.cpdf-setlinewidth"> <refnamediv> - <refname>cpdf_setgray_fill</refname> - <refpurpose>Setzt die Füllfarbe auf einen Grauwert</refpurpose> + <refname>cpdf_setlinewidth</refname> + <refpurpose>Legt die Linienbreite fest</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_setgray_fill</function></funcdef> + <funcdef>void <function>cpdf_setlinewidth</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>Grauwert</parameter></paramdef> + <paramdef>double <parameter>Breite</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - The <function>cpdf_setgray_fill</function> function sets the - current gray value to fill a path. - </para> - <para> - Siehe auch: <function>cpdf_setrgbcolor_fill</function>. + Die Funktion <function>cpdf_setlinewidth</function> setzt die + Linienbreite auf <parameter>Breite</parameter>. </para> </refsect1> </refentry> - - <refentry id="function.cpdf-setgray-stroke"> + + <refentry id="function.cpdf-setmiterlimit"> <refnamediv> - <refname>cpdf_setgray_stroke</refname> - <refpurpose>Setzt die Zeichenfarbe auf einen Grauwert</refpurpose> + <refname>cpdf_setmiterlimit</refname> + <refpurpose>Legt die Gehrungsbegrenzung fest</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_setgray_stroke</function></funcdef> + <funcdef>void <function>cpdf_setmiterlimit</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>Grauwert</parameter></paramdef> + <paramdef>double <parameter>Wert</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_setgray_stroke</function> setzt die - aktuelle Zeichenfarbe auf den angegebenen Grauwert. - </para> - <para> - Siehe auch: <function>cpdf_setrgbcolor_stroke</function>. + Die Funktion <function>cpdf_setmiterlimit</function> setzt die + Gehrungsbegrenzung auf einen Wert größer oder gleich 1. </para> </refsect1> </refentry> - - <refentry id="function.cpdf-setgray"> + + <refentry id="function.cpdf-setrgbcolor"> <refnamediv> - <refname>cpdf_setgray</refname> + <refname>cpdf_setrgbcolor</refname> <refpurpose> - Setzt Zeichen- und Füllfarbe auf einen Grauwert + Setzt Zeichen- und Füllfarbe auf einen RGB-Farbwert </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_setgray</function></funcdef> + <funcdef>void <function>cpdf_setrgbcolor</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>Grauwert</parameter></paramdef> + <paramdef>double <parameter>Rotwert</parameter></paramdef> + <paramdef>double <parameter>Grünwert</parameter></paramdef> + <paramdef>double <parameter>Blauwert</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_setgray_stroke</function> setzt die - aktuelle Zeichen- und Füllfarbe auf den angegebenen Grauwert. + Die Funktion <function>cpdf_setrgbcolor_stroke</function> setzt + die aktuelle Zeichen- und Füllfarbe auf den angegebenen + RGB-Farbwert. </para> <para> Siehe auch: <function>cpdf_setrgbcolor_stroke</function> und @@ -1953,7 +2008,7 @@ </para> </refsect1> </refentry> - + <refentry id="function.cpdf-setrgbcolor-fill"> <refnamediv> <refname>cpdf_setrgbcolor_fill</refname> @@ -1965,7 +2020,9 @@ <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_setrgbcolor_fill</function></funcdef> + <funcdef>void + <function>cpdf_setrgbcolor_fill</function> + </funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> <paramdef>double <parameter>Rotwert</parameter></paramdef> <paramdef>double <parameter>Grünwert</parameter></paramdef> @@ -1982,7 +2039,7 @@ </para> </refsect1> </refentry> - + <refentry id="function.cpdf-setrgbcolor-stroke"> <refnamediv> <refname>cpdf_setrgbcolor_stroke</refname> @@ -2013,257 +2070,207 @@ </para> </refsect1> </refentry> - - <refentry id="function.cpdf-setrgbcolor"> + + <refentry id="function.cpdf-show"> <refnamediv> - <refname>cpdf_setrgbcolor</refname> - <refpurpose> - Setzt Zeichen- und Füllfarbe auf einen RGB-Farbwert - </refpurpose> + <refname>cpdf_show</refname> + <refpurpose>Gibt Text an der aktuellen Position aus</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_setrgbcolor</function></funcdef> + <funcdef>void <function>cpdf_show</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>Rotwert</parameter></paramdef> - <paramdef>double <parameter>Grünwert</parameter></paramdef> - <paramdef>double <parameter>Blauwert</parameter></paramdef> + <paramdef>string <parameter>Text</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_setrgbcolor_stroke</function> setzt - die aktuelle Zeichen- und Füllfarbe auf den angegebenen - RGB-Farbwert. + Die Funktion <function>cpdf_show</function> gibt die Zeichenkette + <parameter>Text</parameter> an der aktuellen Position aus. </para> <para> - Siehe auch: <function>cpdf_setrgbcolor_stroke</function> und - <function>cpdf_setrgbcolor_fill</function>. + Siehe auch: <function>cpdf_text</function>, + <function>cpdf_begin_text</function> und + <function>cpdf_end_text</function>. </para> </refsect1> </refentry> - - <refentry id="function.cpdf-add-outline"> + + <refentry id="function.cpdf-show-xy"> <refnamediv> - <refname>cpdf_add_outline</refname> - <refpurpose> - Fügt ein Lesezeichen für die aktuelle Seite hinzu - </refpurpose> + <refname>cpdf_show_xy</refname> + <refpurpose>Gibt Text an der angegebenen Position aus</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_add_outline</function></funcdef> + <funcdef>void <function>cpdf_show_xy</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> <paramdef>string <parameter>Text</parameter></paramdef> + <paramdef>double <parameter>x-koor</parameter></paramdef> + <paramdef>double <parameter>y-koor</parameter></paramdef> + <paramdef>int + <parameter><optional>Modus</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_add_outline</function> fügt ein - Lesezeichen mit dem Text <parameter>Text</parameter> hinzu, das - auf die aktuelle Seite zeigt. - <example> - <title>Hinzufügen einer Seitenübersicht</title> - <programlisting> -&lt;?php -$cpdf = cpdf_open(0); -cpdf_page_init($cpdf, 1, 0, 595, 842); -cpdf_add_outline($cpdf, 0, 0, 0, 1, "Seite 1"); -// ... -// etwas Zeichnung -// ... -cpdf_finalize($cpdf); -Header("Content-type: application/pdf"); -cpdf_output_buffer($cpdf); -cpdf_close($cpdf); -?&gt; - </programlisting> - </example> + Die Funktion <function>cpdf_show_xy</function> gibt die + Zeichenkette <parameter>Text</parameter> an der Position mit den + Koordinaten (<parameter>x-koor</parameter>, + <parameter>y-koor</parameter>) aus. + </para> + <para> + Der optionale Parameter <parameter>Modus</parameter> bestimmt die + Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird + die Einheit verwendet, die für die Seite als Standard angegeben + wurde. Andernfalls werden die Koordinaten unabhängig von der + aktuellen Einheit in Postscript-Punkten gemessen. + <note> + <simpara> + Ohne die optionalen Parameter ist die Funktion + <function>cpdf_show_xy</function> mit + <function>cpdf_text</function> identisch. + </simpara> + </note> + </para> + <para> + Siehe auch: <function>cpdf_text</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-set-page-animation"> + <refentry id="function.cpdf-stringwidth"> <refnamediv> - <refname>cpdf_set_page_animation</refname> + <refname>cpdf_stringwidth</refname> <refpurpose> - Legt den Übergang zwischen den Seiten fest + Liefert die Breite einer Zeichenkette in der aktuellen Schriftart </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void - <function>cpdf_set_page_animation</function> - </funcdef> + <funcdef>double <function>cpdf_stringwidth</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>int <parameter>Übergang</parameter></paramdef> - <paramdef>double <parameter>Dauer</parameter></paramdef> + <paramdef>string <parameter>Text</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_set_page_animation</function> legt - den Übergang zwischen aufeinanderfolgenden Seiten fest. - </para> - <para> - <parameter>Übergang</parameter> kann folgende Werte haben: - <simplelist> - <member>0 für keinen,</member> - <member> - 1 für zwei über den Bildschirm sausende Zeilen, die die nächste - Seite enthüllen, - </member> - <member> - 2 für mehrere über den Bildschirm sausende Zeilen, die die - nächste Seite enthüllen, - </member> - <member>3 für eine Box, die die nächste Seite enthüllt,</member> - <member> - 4 für eine einzelne über den Bildschirm sausende Zeile, die die - nächste Seite enthüllt, - </member> - <member> - 5, daß dich die alte Seite auflöst und die nächste Seite - enthüllt, - </member> - <member> - 6, daß der Auflösungseffekt vom einen Bildschirmrand zum - anderen wandert, - </member> - <member> - 7, daß die alte Seite einfach durch die neue Seite ersetzt wird - (Grundeinstellung) - </member> - </simplelist> + Die Funktion <function>cpdf_stringwidth</function> gibt die + Breite der Zeichenkette in <parameter>Text</parameter> zurück. + Zuvor muß eine Schriftart festgelegt werden. </para> <para> - Der Wert <parameter>Dauer</parameter> ist die Anzahl der Sekunden - während des Seitenwechsels. + Siehe auch: <function>cpdf_set_font</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-import-jpeg"> + <refentry id="function.cpdf-stroke"> <refnamediv> - <refname>cpdf_import_jpeg</refname> - <refpurpose>Öffnet ein JPEG-Bild</refpurpose> + <refname>cpdf_stroke</refname> + <refpurpose> + Zeichnet eine Linie entlang des aktuellen Pfades + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>cpdf_import_jpeg</function></funcdef> + <funcdef>void <function>cpdf_stroke</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>string <parameter>Dateiname</parameter></paramdef> - <paramdef>double <parameter>x-koor</parameter></paramdef> - <paramdef>double <parameter>y-koor</parameter></paramdef> - <paramdef>double <parameter>Winkel</parameter></paramdef> - <paramdef>double <parameter>Breite</parameter></paramdef> - <paramdef>double <parameter>Höhe</parameter></paramdef> - <paramdef>double <parameter>x-Skalierung</parameter></paramdef> - <paramdef>double <parameter>y-Skalierung</parameter></paramdef> - <paramdef>int - <parameter><optional>Modus</optional></parameter> - </paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_import_jpeg</function> öffnet ein - Bild, das unter dem Namen <parameter>Dateiname</parameter> - gespeichert wurde. Das Bild muß im JPEG-Format vorliegen. Es wird - auf der aktuellen Seite an der Position - (<parameter>x-koor</parameter>, <parameter>y-koor</parameter>) - platziert. Das Bild wird um <parameter>Winkel</parameter> Grad - gedreht. - </para> - <para> - Der optionale Parameter <parameter>Modus</parameter> bestimmt die - Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird - die Einheit verwendet, die für die Seite als Standard angegeben - wurde. Andernfalls werden die Koordinaten unabhängig von der - aktuellen Einheit in Postscript-Punkten gemessen. + Die Funktion <function>cpdf_stroke</function> Zeichnet eine Linie + entlang des aktuellen Pfades. </para> <para> - Siehe auch: <function>cpdf_place_inline_image</function>. + Siehe auch: <function>cpdf_closepath</function> und + <function>cpdf_closepath_stroke</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-place-inline-image"> + <refentry id="function.cpdf-text"> <refnamediv> - <refname>cpdf_place_inline_image</refname> - <refpurpose>Plaziert ein Bild auf der Seite</refpurpose> + <refname>cpdf_text</refname> + <refpurpose>Gibt den Text mit Parametern aus</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void - <function>cpdf_place_inline_image</function> - </funcdef> + <funcdef>void <function>cpdf_text</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>int <parameter>Bild</parameter></paramdef> + <paramdef>string <parameter>Text</parameter></paramdef> <paramdef>double <parameter>x-koor</parameter></paramdef> <paramdef>double <parameter>y-koor</parameter></paramdef> - <paramdef>double <parameter>Winkel</parameter></paramdef> - <paramdef>double <parameter>Breite</parameter></paramdef> - <paramdef>double <parameter>Höhe</parameter></paramdef> <paramdef>int <parameter><optional>Modus</optional></parameter> </paramdef> + <paramdef> + double <parameter><optional>Richtung</optional></parameter> + </paramdef> + <paramdef>int + <parameter><optional>Ausrichtungsmodus</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_place_inline_image</function> - plaziert auf der Seite ein Bild, das mit der PHP-Image-Funktion - erstellt wurde, an der Position (<parameter>x-koor</parameter>, - <parameter>y-koor</parameter>). Das Bild kann gleichzeitig - skaliert werden. + Die Funktion <function>cpdf_text</function> gibt die Zeichenkette + <parameter>Text</parameter> an der Position mit den Koordinaten + (<parameter>x-koor</parameter>, <parameter>y-koor</parameter>) + aus. </para> <para> Der optionale Parameter <parameter>Modus</parameter> bestimmt die Länge einer Einheit. Wenn er 0 ist oder weggelassen wurde, wird die Einheit verwendet, die für die Seite als Standard angegeben wurde. Andernfalls werden die Koordinaten unabhängig von der - aktuellen Einheit in Postscript-Punkten gemessen. + aktuellen Einheit in Postscript-Punkten gemessen. Der optionale + Parameter <parameter>Richtung</parameter> bestimmt die Drehung + des Texts in Grad. Der optionale Parameter + <parameter>Ausrichtungsmodus</parameter> bestimmt, wie der Text + ausgerichtet wird. </para> <para> - Siehe auch: <function>cpdf_import_jpeg</function>. + Die möglichen Werte können Sie der ClibPDF-Dokumentation + entnehmen. + </para> + <para> + Siehe auch: <function>cpdf_show_xy</function>. </para> </refsect1> </refentry> - <refentry id="function.cpdf-add-annotation"> + <refentry id="function.cpdf-translate"> <refnamediv> - <refname>cpdf_add_annotation</refname> - <refpurpose>Fügt eine Anmerkung ein</refpurpose> + <refname>cpdf_translate</refname> + <refpurpose> + Legt den Ursprung des Koordinatensystems fest + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>cpdf_add_annotation</function></funcdef> + <funcdef>void <function>cpdf_translate</function></funcdef> <paramdef>int <parameter>PDF-Dokument</parameter></paramdef> - <paramdef>double <parameter>ulx</parameter></paramdef> - <paramdef>double <parameter>uly</parameter></paramdef> - <paramdef>double <parameter>orx</parameter></paramdef> - <paramdef>double <parameter>ory</parameter></paramdef> - <paramdef>string <parameter>Titel</parameter></paramdef> - <paramdef>string <parameter>Inhalt</parameter></paramdef> + <paramdef>double <parameter>x-koor</parameter></paramdef> + <paramdef>double <parameter>y-koor</parameter></paramdef> <paramdef>int <parameter><optional>Modus</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - Die Funktion <function>cpdf_add_annotation</function> fügt eine - Anmerkung ein, bei der die untere linke Ecke bei - (<parameter>ulx</parameter>, <parameter>uly</parameter>) und die - obere rechte Ecke bei (<parameter>orx</parameter>, - <parameter>ory</parameter>) liegt. + Die Funktion <function>cpdf_translate</function> setzt den + Ursprung des Koordinatensystems auf den Punkt + (<parameter>x-koor</parameter>, <parameter>y-koor</parameter>). </para> <para> Der optionale Parameter <parameter>Modus</parameter> bestimmt die