dams Mon Feb 12 07:18:24 2001 EDT Modified files: /phpdoc/fr/functions pdf.xml Log: Updated translation. I kept all detailled functions, since new version seems to be shortened.
Index: phpdoc/fr/functions/pdf.xml diff -u phpdoc/fr/functions/pdf.xml:1.5 phpdoc/fr/functions/pdf.xml:1.6 --- phpdoc/fr/functions/pdf.xml:1.5 Fri Jan 26 06:44:21 2001 +++ phpdoc/fr/functions/pdf.xml Mon Feb 12 07:18:23 2001 @@ -15,9 +15,13 @@ <simpara> Reportez vous à l'excellente documentation de pdflib, disponible avec la distribution de pdflib. C'est une introduction très - pratique des capacités de pdflib. La plus part des fonctions - de pdflib se retrouvent dans PHP sous le même nom. De même, les - paramètres sont identiques. Vous devez connaître les concepts + pratique des possibilités de pdflib et elle contient la liste + la plus complète et les descriptions les plus à jours des +fonctions. + </simpara> + <simpara> + Toutes les fonctions de pdflib se retrouvent dans PHP sous le même nom. + De même, les paramètres sont identiques. + Vous devez connaître les concepts de base de PDF ou de Postscript pour utiliser efficacement ce module. Toutes les longueurs et coordonnées sont mesurées en points Postscript points. Il y a généralement @@ -29,24 +33,27 @@ basé sur la bibliothèque <ulink url="&url.cpdf;">FastIO's</ulink>'s ClibPDF. Les API sont légèrement différentes. - Reportez vous à la section <link linkend="ref.cpdf">fonctions ClipPDF</link> - pour plus de détails. + Reportez-vous à la section + <link linkend="ref.cpdf">fonctions ClipPDF</link> pour plus de détails. </simpara> <simpara> Le module PDF introduit un nouveau type de variables. C'est - <parameter>pdfdoc</parameter> : c'est un pointeur sur un document PDF et toutes - les fonctions l'utilise comme premier paramètre. + <parameter>pdfdoc</parameter> : c'est un pointeur sur un + document PDF et toutes les fonctions l'utilise comme premier + paramètre. </simpara> <sect1 id="pdf.oldlibs.confusion"> <title>Confusion entre les vieilles version de pdflib</title> <simpara> - Depuis le début du support de PDF sous PHP, ( commençant avec la version - pdflib 0.6), il y a eu des milliers de modifications dans les API de - pdflib. La plus part de ces modifications ont été suivies par PHP, - et parfois même au prix de modifications des API PHP. Depuis la version - 3.x, ces API semblent s'être stabilisées, et PHP 4 a adoptée cette - version comme le minimum nécessaire pour supporter PDF. En conséquence - de quoi, un grand nombre de fonction vont disparaître, ou être + Depuis le début du support de PDF sous PHP, + (commençant avec la version pdflib 0.6), il y a eu des milliers + de modifications dans les API de pdflib. La plus part de ces modifications + ont été suivies par PHP, et parfois même au prix + de modifications des API PHP. Depuis la version 3.x, ces API semblent + s'être stabilisées, et PHP 4 a adoptée cette + version comme le minimum nécessaire pour supporter PDF. + En conséquence de quoi, un grand nombre de fonction vont + disparaître, ou être remplacée. Le support de pdflib 0.6 est complétement abandonné. La liste suivante indique quelles sont les fonctions obsolète dans PHP 4.02, et qui devraient être remplacées par de nouvelles versions. @@ -62,11 +69,21 @@ </row> </thead> <tbody> + <row> + <entry>pdf_put_image()</entry> + <entry>Désormais inutile</entry> + </row> <row> - <entry><function>pdf_put_image</function></entry> + <entry>pdf_execute_image()</entry> <entry>Désormais inutile</entry> </row> <row> + <entry>pdf_get_annotation()</entry> + <entry> + <function>pdf_get_bookmark</function> avec les mêmes +paramètres. + </entry> + </row> + <row> <entry>pdf_get_font()</entry> <entry><function>pdf_get_value</function> avec <literal>"font"</literal> comme second paramètre.</entry> @@ -74,7 +91,7 @@ <row> <entry>pdf_get_fontsize()</entry> <entry><function>pdf_get_value</function> avec - <literal>"fontsize"</literal> comme second paramètre.</entry> + <literal>"fontsize"</literal> comme second paramètre.</entry> </row> <row> <entry>pdf_get_fontname()</entry> @@ -146,6 +163,16 @@ <literal>"transition"</literal> comme second paramètre.</entry> </row> <row> + <entry>pdf_open()</entry> + <entry><function>pdf_new</function> suivi d'un appel à + <function>pdf_open_file</function></entry> + </row> + <row> + <entry>pdf_set_font()</entry> + <entry><function>pdf_findfont</function> suivi d'un appel à + <function>pdf_setfont</function></entry> + </row> + <row> <entry><function>pdf_set_duration</function></entry> <entry><function>pdf_set_value</function> avec <literal>"duration"</literal> comme second paramètre.</entry> @@ -194,10 +221,24 @@ avec l'option <literal>--enable-shared-pdflib</literal>. </simpara> </sect1> + <sect1 id="pdf.oldlibs.versions"> + <title>Choix de la version de PDFlib</title> + <simpara> + Avec toutes les versions de PHP 4, ultérieure au 9 mars 2000, + vous devez utiliser PDFlib 3.0 ou plus récent. + </simpara> + <simpara> + PHP 3, d'un autre coté, ne doit pas être utilisé avec une +version + plus récente que la 2.01. Depuis la version 1.61 du source + php3/functions/pdf.c (php 3.19), il est possible d'utiliser + la version PDFlib 3.0 ou plus récent. + </simpara> + </sect1> <sect1 id="pdf.oldlibs.hints"> <title>Installation des anciennes versions de pdflib</title> <simpara> - Si vous utilisez pdflib 2.01 vérifiez comment votre librairie a été + Si vous utilisez pdflib 2.01 vérifiez comment votre librairie a + été installée. Il doit y avoir un fichier (ou un lien) vers libpdf.so. La version 2.01 ne fait que créer une librairie avec le nom libpdf2.01.so qui ne peut être trouvé lors de la compilation du @@ -229,7 +270,7 @@ <sect1 id="pdf.examples"> <title>Exemples</title> <simpara> - La plus part des fonctions sont simples d'emploi.Le plus difficile + La plus part des fonctions sont simples d'emploi. Le plus difficile est probablement de créer un fichier PDF simple. L'exemple suivant devrait vous mettre sur les rails. Il crée un fichier <filename>test.pdf</filename> d'une page. @@ -241,23 +282,23 @@ <title>Création d'un document PDF avec pdflib</title> <programlisting role="php"> <?php -$fp = fopen("test.pdf", "w"); -$pdf = pdf_open($fp); -pdf_set_info($pdf, "Author", "Uwe Steinmann"); -pdf_set_info($pdf, "Title", "Test for PHP wrapper of PDFlib 2.0"); -pdf_set_info($pdf, "Creator", "See Author"); -pdf_set_info($pdf, "Subject", "Testing"); -pdf_begin_page($pdf, 595, 842); -pdf_add_outline($pdf, "Page 1"); -pdf_set_font($pdf, "Times-Roman", 30, "host"); -pdf_set_value($pdf, "textrendering", 1); -pdf_show_xy($pdf, "Times Roman outlined", 50, 750); -pdf_moveto($pdf, 50, 740); -pdf_lineto($pdf, 330, 740); -pdf_stroke($pdf); -pdf_end_page($pdf); -pdf_close($pdf); -fclose($fp); +$pdf = PDF_new(); +PDF_open_file($pdf, "test.pdf"); +PDF_set_info($pdf, "Author", "Uwe Steinmann"); +PDF_set_info($pdf, "Title", "Test for PHP wrapper of PDFlib 2.0"); +PDF_set_info($pdf, "Creator", "See Author"); +PDF_set_info($pdf, "Subject", "Testing"); +PDF_begin_page($pdf, 595, 842); +PDF_add_outline($pdf, "Page 1"); +PDF_set_font($pdf, "Times-Roman", 30, "host"); +PDF_set_value($pdf, "textrendering", 1); +PDF_show_xy($pdf, "Times Roman outlined", 50, 750); +PDF_moveto($pdf, 50, 740); +PDF_lineto($pdf, 330, 740); +PDF_stroke($pdf); +PDF_end_page($pdf); +PDF_close($pdf); +PDF_delete($pdf); echo "<A HREF=getpdf.php>finished</A>"; ?> </programlisting> @@ -278,1239 +319,1233 @@ </para> <para> La distribution pdflib contient un exemple plus complexe, - qui crée des pages plus élaborées, avec une horloge. Cet exemple - a été converti en script PHP (vous retrouverez cet exemple - dans le module <link linkend="ref.cpdf">clibpdf</link>) : + qui crée des pages plus élaborées, + avec une horloge. Cet exemple a été converti en + script PHP (vous retrouverez cet exemple dans le module + <link linkend="ref.cpdf">clibpdf</link>). Il utilise les + possibilités de création de fichier en mémoire, sans fichier + temporaire. </para> <para> <example> <title>Exemple pdfclock issue de la distribution pdflib</title> <programlisting role="php"> <?php -$pdffilename = "clock.pdf"; $radius = 200; $margin = 20; -$pagecount = 40; -$fp = fopen($pdffilename, "w"); -$pdf = pdf_open($fp); -pdf_set_info($pdf, "Creator", "pdf_clock.php3"); -pdf_set_info($pdf, "Author", "Uwe Steinmann"); -pdf_set_info($pdf, "Title", "Analog Clock"); -while($pagecount-- > 0) { - pdf_begin_page($pdf, 2 * ($radius + $margin), 2 * ($radius + $margin)); - pdf_set_parameter($pdf, "transition", "wipe"); - pdf_set_value($pdf, "duration", 0.5); - pdf_translate($pdf, $radius + $margin, $radius + $margin); - pdf_save($pdf); - pdf_setrgbcolor($pdf, 0.0, 0.0, 1.0); - /* minute strokes */ - pdf_setlinewidth($pdf, 2.0); +$pagecount = 10; +$pdf = PDF_new(); +if (!PDF_open_file($pdf, "")) { + print error; + exit; +}; +PDF_set_parameter($pdf, "warning", "true"); +PDF_set_info($pdf, "Creator", "pdf_clock.php"); +PDF_set_info($pdf, "Author", "Uwe Steinmann"); +PDF_set_info($pdf, "Title", "Analog Clock"); +while($pagecount-- > 0) { + PDF_begin_page($pdf, 2 * ($radius + $margin), 2 * ($radius + $margin)); + PDF_set_parameter($pdf, "transition", "wipe"); + PDF_set_value($pdf, "duration", 0.5); + PDF_translate($pdf, $radius + $margin, $radius + $margin); + PDF_save($pdf); + PDF_setrgbcolor($pdf, 0.0, 0.0, 1.0); + /* indicateurs de minutes */ + PDF_setlinewidth($pdf, 2.0); for ($alpha = 0; $alpha < 360; $alpha += 6) { - pdf_rotate($pdf, 6.0); - pdf_moveto($pdf, $radius, 0.0); - pdf_lineto($pdf, $radius-$margin/3, 0.0); - pdf_stroke($pdf); + PDF_rotate($pdf, 6.0); + PDF_moveto($pdf, $radius, 0.0); + PDF_lineto($pdf, $radius-$margin/3, 0.0); + PDF_stroke($pdf); } - pdf_restore($pdf); - pdf_save($pdf); - /* 5 minute strokes */ - pdf_setlinewidth($pdf, 3.0); + PDF_restore($pdf); + PDF_save($pdf); + /* indicateurs de 5 minutes */ + PDF_setlinewidth($pdf, 3.0); for ($alpha = 0; $alpha < 360; $alpha += 30) { - pdf_rotate($pdf, 30.0); - pdf_moveto($pdf, $radius, 0.0); - pdf_lineto($pdf, $radius-$margin, 0.0); - pdf_stroke($pdf); + PDF_rotate($pdf, 30.0); + PDF_moveto($pdf, $radius, 0.0); + PDF_lineto($pdf, $radius-$margin, 0.0); + PDF_stroke($pdf); } $ltime = getdate(); - /* draw hour hand */ - pdf_save($pdf); - pdf_rotate($pdf,-(($ltime['minutes']/60.0)+$ltime['hours']-3.0)*30.0); - pdf_moveto($pdf, -$radius/10, -$radius/20); - pdf_lineto($pdf, $radius/2, 0.0); - pdf_lineto($pdf, -$radius/10, $radius/20); - pdf_closepath($pdf); - pdf_fill($pdf); - pdf_restore($pdf); - /* draw minute hand */ - pdf_save($pdf); - pdf_rotate($pdf,-(($ltime['seconds']/60.0)+$ltime['minutes']-15.0)*6.0); - pdf_moveto($pdf, -$radius/10, -$radius/20); - pdf_lineto($pdf, $radius * 0.8, 0.0); - pdf_lineto($pdf, -$radius/10, $radius/20); - pdf_closepath($pdf); - pdf_fill($pdf); - pdf_restore($pdf); - /* draw second hand */ - pdf_setrgbcolor($pdf, 1.0, 0.0, 0.0); - pdf_setlinewidth($pdf, 2); - pdf_save($pdf); - pdf_rotate($pdf, -(($ltime['seconds'] - 15.0) * 6.0)); - pdf_moveto($pdf, -$radius/5, 0.0); - pdf_lineto($pdf, $radius, 0.0); - pdf_stroke($pdf); - pdf_restore($pdf); - /* draw little circle at center */ - pdf_circle($pdf, 0, 0, $radius/30); - pdf_fill($pdf); - pdf_restore($pdf); - pdf_end_page($pdf); + /* aiguille des heures */ + PDF_save($pdf); + PDF_rotate($pdf,-(($ltime['minutes']/60.0)+$ltime['hours']-3.0)*30.0); + PDF_moveto($pdf, -$radius/10, -$radius/20); + PDF_lineto($pdf, $radius/2, 0.0); + PDF_lineto($pdf, -$radius/10, $radius/20); + PDF_closepath($pdf); + PDF_fill($pdf); + PDF_restore($pdf); + /* aiguille des minutes */ + PDF_save($pdf); + PDF_rotate($pdf,-(($ltime['seconds']/60.0)+$ltime['minutes']-15.0)*6.0); + PDF_moveto($pdf, -$radius/10, -$radius/20); + PDF_lineto($pdf, $radius * 0.8, 0.0); + PDF_lineto($pdf, -$radius/10, $radius/20); + PDF_closepath($pdf); + PDF_fill($pdf); + PDF_restore($pdf); + /* aiguille des secondes */ + PDF_setrgbcolor($pdf, 1.0, 0.0, 0.0); + PDF_setlinewidth($pdf, 2); + PDF_save($pdf); + PDF_rotate($pdf, -(($ltime['seconds'] - 15.0) * 6.0)); + PDF_moveto($pdf, -$radius/5, 0.0); + PDF_lineto($pdf, $radius, 0.0); + PDF_stroke($pdf); + PDF_restore($pdf); + /* petit cercle au centre */ + PDF_circle($pdf, 0, 0, $radius/30); + PDF_fill($pdf); + PDF_restore($pdf); + PDF_end_page($pdf); + # pour voir une différence + sleep(1); } -$pdf = pdf_close($pdf); -fclose($fp); -echo "<A HREF=getpdf.php?filename=".$pdffilename.">finished</A>"; -?> - </programlisting> - <simpara> - Ce script <filename>getpdf.php</filename> ne fait que retourner un document PDF. - </simpara> - <programlisting role="php"> -<?php -$fp = fopen($filename, "r"); +PDF_close($pdf); +$buf = PDF_get_buffer($pdf); +$len = strlen($buf); header("Content-type: application/pdf"); -fpassthru($fp); -fclose($fp); +header("Content-Length: $len"); +header("Content-Disposition: inline; filename=foo.pdf"); +print $buf; +PDF_delete($pdf); ?> </programlisting> </example> </para> </sect1> </partintro> - <refentry id="function.pdf-set-info"> + <refentry id="function.pdf-add-annotation"> <refnamediv> - <refname>pdf_set_info</refname> - <refpurpose>Remplis les entêtes du document</refpurpose> + <refname>PDF_add_annotation</refname> + <refpurpose>Obsolète: Ajoute une annotation</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para> + <function>pdf_add_outline</function> est remplacé par + <function>pdf_add_note</function> + </para> + <para> + Voir aussi <function>pdf_add_note</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-add-bookmark"> + <refnamediv> + <refname>PDF_add_bookmark</refname> + <refpurpose>Ajoute un signet à la page courante</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_set_info</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>string <parameter>fieldname</parameter></paramdef> - <paramdef>string <parameter>value</parameter></paramdef> + <funcdef>int <function>pdf_add_bookmark</function></funcdef> + <paramdef>int <parameter>pdf object</parameter></paramdef> + <paramdef>string <parameter>text</parameter></paramdef> + <paramdef>int <parameter><optional>parent</optional></parameter></paramdef> + <paramdef>int <parameter><optional>open</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_set_info</function> modifie un champs d'entête - d'un document PDF. Les valeurs possibles pour <parameter>fieldname</parameter> - sont : 'Subject' (sujet), 'Title'(titre), 'Creator'(créateur), - 'Author'(auteur), 'Keywords'(mots-clé) et un autre nom, défini par l - l'utilisateur. - Cette fonction peut être appelée avant la création d'une page. - <example> - <title>Préparer l'entête d'un document PDF</title> - <programlisting role="php"> -<?php -$fd = fopen("test.pdf", "w"); -$pdfdoc = pdf_open($fd); -pdf_set_info($pdfdoc, "Author", "Uwe Steinmann"); -pdf_set_info($pdfdoc, "Creator", "Uwe Steinmann"); -pdf_set_info($pdfdoc, "Title", "Testing Info Fields"); -pdf_set_info($pdfdoc, "Subject", "Test"); -pdf_set_info($pdfdoc, "Keywords", "Test, Fields"); -pdf_set_info($pdfdoc, "CustomField", "What ever makes sense"); -pdf_begin_page($pdfdoc, 595, 842); -pdf_end_page($pdfdoc); -pdf_close($pdfdoc); -?> - </programlisting> - </example> - </para> - <note> - <simpara> - Cette fonction remplace pdf_set_info_keywords, - pdf_set_info_title, - pdf_set_info_subject, - pdf_set_info_creator, - pdf_set_info_subject. - </simpara> - </note> + <function>pdf_add_bookmark</function> ajoute un signet sous le père + <parameter>parent</parameter>, ou un signet général, si + <parameter>parent</parameter> vaut 0. <function>pdf_add_bookmark</function> + retourne un descripteur de signet, qui peut être utilisé comme + père d'un autre signet. Si <parameter>open</parameter> vaut 1, + les signets fils seront ouverts. Ils seront fermés sinon. + </para> </refsect1> </refentry> - <refentry id="function.pdf-open"> + <refentry id="function.pdf-add-launchlink"> <refnamediv> - <refname>PDF_open</refname> - <refpurpose>Ouvre un nouveau document PDF.</refpurpose> + <refname>PDF_add_launchlink</refname> + <refpurpose>Ajoute une annotation éxécutable dans la page +courante</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>pdf_open</function></funcdef> - <paramdef>int <parameter>file</parameter></paramdef> + <funcdef>int <function>pdf_add_launchlink</function></funcdef> + <paramdef>int <parameter>pdf object</parameter></paramdef> + <paramdef>double <parameter>llx</parameter></paramdef> + <paramdef>double <parameter>lly</parameter></paramdef> + <paramdef>double <parameter>urx</parameter></paramdef> + <paramdef>double <parameter>ury</parameter></paramdef> + <paramdef>string <parameter>filename</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_open</function> ouvre un nouveau document PDF. Le - fichier correspondant doit avoir été ouvert avec - <function>fopen</function> et le pointeur de fichier est - passé en argument <parameter>file</parameter>. Si vous ne - passez aucun paramètres, le document sera créé en mémoire, - et envoyé à la sortie standard (stdout ou client web). + <function>pdf_add_launchlink</function> ajoute une annotation exécutable + (le fichier de destination peut etre n'importe quel fichier). </para> - <note> - <simpara> - La valeur retournée est utilisée par toutes les autres fonctions - PDF comme premier argument. - </simpara> - </note> + </refsect1> + </refentry> + <refentry id="function.pdf-add-locallink"> + <refnamediv> + <refname>PDF_add_locallink</refname> + <refpurpose>Ajoute un lien sur une annotation dans la page courante</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pdf_add_locallink</function></funcdef> + <paramdef>int <parameter>pdf object</parameter></paramdef> + <paramdef>double <parameter>llx</parameter></paramdef> + <paramdef>double <parameter>lly</parameter></paramdef> + <paramdef>double <parameter>urx</parameter></paramdef> + <paramdef>double <parameter>ury</parameter></paramdef> + <paramdef>int <parameter>page</parameter></paramdef> + <paramdef>string <parameter>dest</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> - Voir aussi <function>fopen</function>, - <function>pdf_close</function>. + Add a link annotation to a target within the current PDF file. </para> </refsect1> </refentry> - <refentry id="function.pdf-close"> + <refentry id="function.pdf-add-note"> <refnamediv> - <refname>PDF_close</refname> - <refpurpose>Ferme un document PDF.</refpurpose> + <refname>PDF_add_note</refname> + <refpurpose>Ajoute une note d'annotation dans la page courante</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_close</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> + <funcdef>int <function>pdf_add_note</function></funcdef> + <paramdef>int <parameter>pdf object</parameter></paramdef> + <paramdef>double <parameter>llx</parameter></paramdef> + <paramdef>double <parameter>lly</parameter></paramdef> + <paramdef>double <parameter>urx</parameter></paramdef> + <paramdef>double <parameter>ury</parameter></paramdef> + <paramdef>string <parameter>contents</parameter></paramdef> + <paramdef>string <parameter>title</parameter></paramdef> + <paramdef>string <parameter>icon</parameter></paramdef> + <paramdef>int <parameter>open</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_close</function> ferme un document PDF. + <function>pdf_add_note</function> ajoute une note d'annotation. + <parameter>icon</parameter> peut prendre une des valeurs + suivantes : "comment" (commentaire), "insert" (insertion), "note" (note), + "paragraph" (paragraphe), "newparagraph" (nouveau paragraphe), + "key" (cle), ou "help" (aide). + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-add-outline"> + <refnamediv> + <refname>pdf_add_outline</refname> + <refpurpose>Obsolète: Ajoute un signet dans la page courante</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para> + Obsolète. </para> <para> - Voir aussi <function>pdf_open</function>, - <function>fclose</function>. + Voir aussi <function>pdf_add_bookmark</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-begin-page"> + <refentry id="function.pdf-add-pdflink"> <refnamediv> - <refname>PDF_begin_page</refname> - <refpurpose>Commence une nouvelle page.</refpurpose> + <refname>PDF_add_pdflink</refname> + <refpurpose>Ajoute un lien sur un fichier dans la page courante</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_begin_page</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>width</parameter></paramdef> - <paramdef>double <parameter>height</parameter></paramdef> + <funcdef>int <function>pdf_add_pdflink</function></funcdef> + <paramdef>int <parameter>pdf object</parameter></paramdef> + <paramdef>double <parameter>llx</parameter></paramdef> + <paramdef>double <parameter>lly</parameter></paramdef> + <paramdef>double <parameter>urx</parameter></paramdef> + <paramdef>double <parameter>ury</parameter></paramdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>int <parameter>page</parameter></paramdef> + <paramdef>string <parameter>dest</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_begin_page</function> commence une nouvelle page avec la - taille <parameter>height</parameter> et la largueur - <parameter>width</parameter>. Afin de créer un nouveau - document valide, vous devez appeler cette fonction et - <function>pdf_end_page</function> au moins une fois. + <function>pdf_add_pdflink</function> ajoute un lien vers un fichier + PDF, sous forme d'annotation. </para> + </refsect1> + </refentry> + <refentry id="function.pdf-add-weblink"> + <refnamediv> + <refname>PDF_add_weblink</refname> + <refpurpose>Ajoute un lien hypertexte dans la page courante</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pdf_add_weblink</function></funcdef> + <paramdef>int <parameter>pdf object</parameter></paramdef> + <paramdef>double <parameter>llx</parameter></paramdef> + <paramdef>double <parameter>lly</parameter></paramdef> + <paramdef>double <parameter>urx</parameter></paramdef> + <paramdef>double <parameter>ury</parameter></paramdef> + <paramdef>string <parameter>url</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> - Voir aussi <function>pdf_end_page</function>. + <function>pdf_add_weblink</function> ajoute un lien hypertexte + vers une URL sur le web. </para> </refsect1> </refentry> - <refentry id="function.pdf-end-page"> + <refentry id="function.pdf-arc"> <refnamediv> - <refname>PDF_end_page</refname> - <refpurpose>Termine une page.</refpurpose> + <refname>PDF_arc</refname> + <refpurpose>Dessine un arc.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_end_page</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> + <funcdef>void <function>pdf_arc</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>x-coor</parameter></paramdef> + <paramdef>double <parameter>y-coor</parameter></paramdef> + <paramdef>double <parameter>radius</parameter></paramdef> + <paramdef>double <parameter>start</parameter></paramdef> + <paramdef>double <parameter>end</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_end_page</function> termine une page. Une fois - qu'une page a été fermée, elle ne peut pas - être modifiée. + <function>pdf_arc</function> dessine un arc de cercle, de centre + (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>) et de + rayon <parameter>radius</parameter>, en commencant à l'angle + <parameter>start</parameter> et finissant à l'angle + <parameter>end</parameter>. </para> <para> - Voir aussi <function>pdf_begin_page</function>. + Voir aussi <function>pdf_circle</function>, + <function>pdf_stroke</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-show"> + <refentry id="function.pdf-attach-file"> <refnamediv> - <refname>PDF_show</refname> - <refpurpose>Affiche un texte à la position courante.</refpurpose> + <refname>PDF_attach_file</refname> + <refpurpose>Attache un fichier à la page courante</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_show</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>string <parameter>text</parameter></paramdef> + <funcdef>int <function>pdf_attach_file</function></funcdef> + <paramdef>int <parameter>pdf object</parameter></paramdef> + <paramdef>double <parameter>llx</parameter></paramdef> + <paramdef>double <parameter>lly</parameter></paramdef> + <paramdef>double <parameter>urx</parameter></paramdef> + <paramdef>double <parameter>ury</parameter></paramdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>string <parameter>description</parameter></paramdef> + <paramdef>string <parameter>author</parameter></paramdef> + <paramdef>string <parameter>mimetype</parameter></paramdef> + <paramdef>string <parameter>icon</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - <function>pdf_show</function> affiche le texte <parameter>text</parameter> - avec la position courante, et avec la police courante. - </para> <para> - Voir aussi <function>pdf_show_xy</function>, - <function>pdf_show_boxed</function>, - <function>pdf_set_text_pos</function>, - <function>pdf_set_font</function>. + <function>pdf_attach_file</function> attache un fichier à la + page courante. <parameter>icon</parameter> peut prendre + l'une des valeurs suivantes : "graph" (image), + "paperclip" (texte), "pushpin" (??? NdTraducteur : mailez + moi!) ou "tag" (étiquette). </para> </refsect1> </refentry> - <refentry id="function.pdf-show-boxed"> + <refentry id="function.pdf-begin-page"> <refnamediv> - <refname>PDF_show_boxed</refname> - <refpurpose>Affiche un texte dans un rectangle.</refpurpose> + <refname>PDF_begin_page</refname> + <refpurpose>Commence une nouvelle page.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>pdf_show_boxed</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>string <parameter>text</parameter></paramdef> - <paramdef>double <parameter>x-coor</parameter></paramdef> - <paramdef>double <parameter>y-coor</parameter></paramdef> + <funcdef>void <function>pdf_begin_page</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> <paramdef>double <parameter>width</parameter></paramdef> <paramdef>double <parameter>height</parameter></paramdef> - <paramdef>string <parameter>mode</parameter></paramdef> - <paramdef>string <parameter><optional>feature</optional></parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - <function>pdf_show_boxed</function> affiche le texte - <parameter>text</parameter> dans un rectangle, dont le coin - inférieur gauche est aux coordonnées - (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>). - Les dimensions du rectangle sont <parameter>height</parameter> et - <parameter>width</parameter>. Le paramètre <parameter>mode</parameter> - indique le type de <parameter>text</parameter>. Si - <parameter>width</parameter> et <parameter>height</parameter> sont - à zéro, le mode <parameter>mode</parameter> - peut être "left" (gauche), "right" (droite) ou "center" - (centré). <parameter>width</parameter> ou <parameter>height</parameter> - sont différents pouvant prendre les valeurs de "justify" - (justification) ou "fulljustify" (justification complète). - </para> - <para> - Si le paramètre <parameter>feature</parameter> vaut "blind", - le texte n'est pas affiché. - </para> <para> - Retourne le nombre de caractères qui n'ont pas pu être - traités, car ils ne rentraient pas dans le rectangle. + <function>pdf_begin_page</function> commence une nouvelle page avec la + taille <parameter>height</parameter> et la largueur + <parameter>width</parameter>. Afin de créer un nouveau + document valide, vous devez appeler cette fonction et + <function>pdf_end_page</function> au moins une fois. </para> <para> - Voir aussi <function>pdf_show</function> et <function>pdf_show_xy</function>. + Voir aussi <function>pdf_end_page</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-show-xy"> + <refentry id="function.pdf-circle"> <refnamediv> - <refname>PDF_show_xy</refname> - <refpurpose>Affiche un texte à une position donnée.</refpurpose> + <refname>PDF_circle</refname> + <refpurpose>Dessine un cercle.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_show_xy</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>string <parameter>text</parameter></paramdef> + <funcdef>void <function>pdf_circle</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> <paramdef>double <parameter>x-coor</parameter></paramdef> <paramdef>double <parameter>y-coor</parameter></paramdef> + <paramdef>double <parameter>radius</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_show_xy</function> affiche le texte - <parameter>text</parameter> à la position donnée - par les coordonnées - (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>). + <function>pdf_circle</function> dessine un cercle de centre + (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>), et de rayon + <parameter>radius</parameter>. </para> <para> - Voir aussi <function>pdf_show</function>, - <function>pdf_show_boxed</function>. + Voir aussi <function>pdf_arc</function>, + <function>pdf_stroke</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-set-font"> + <refentry id="function.pdf-clip"> <refnamediv> - <refname>PDF_set_font</refname> - <refpurpose>Sélectionne la police et sa taille.</refpurpose> + <refname>PDF_clip</refname> + <refpurpose>Aligne sur le chemin courant.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_set_font</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>string <parameter>font name</parameter></paramdef> - <paramdef>double <parameter>size</parameter></paramdef> - <paramdef>string <parameter>encoding</parameter></paramdef> - <paramdef>int <parameter><optional>embed</optional></parameter></paramdef> + <funcdef>void <function>pdf_clip</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_set_font</function> sélectionne la police, - sa taille et son encodage. Il vous faudra fournir des fichiers - Adobe Font Metrics (afm) comme police, dans le dossier de police - (par défaut ./fonts). Si vous utilisez pdflib 0.6, vous devrez - fournir des fichiers Adobe Font Métric (afm-files) pour les - polices, dans le chemin de police ( par défaut, ./fonts). - Si vous utilisez php versin 3 ou une version plus ancienne que la - version 2.20 de pdflib, le quatrième paramètre - <parameter>encoding</parameter> peut prendre les valeurs suivantes : - 0 = builtin, 1 = pdfdoc, 2 = macroman, 3 = macexpert, 4 = winansi. - Un encodage plus grand que 4 et inférieur à 0 sera - transformé en 'winansi'. 'winansi' est souvent un bon choix. - Si vous utilisez PHP version 4 et une version plus ancienne que la - version 2.20 de pdflib le quatrième paramètre - <parameter>encoding</parameter> est une chaîne : - 'builtin', 'pdfdoc', 'macroman', 'macexpert', 'winansi'. Si - le dernier paramètre est à 1, la police est - intégrée dans le document. Sinon, elle ne le sera - pas. Incorporer une police dans un document est un bonne idée - si la police n'est pas répandue, ou si vous ne pouvez pas vous - assurez que le la personne qui regardera votre document peut - accéder à cette police. + <function>pdf_clip</function> aligne tous les dessins sur le chemin courant. </para> - <note> - <simpara> - <function>pdf_set_font</function> doit être appelée après - <function>pdf_begin_page</function> pour créer un document PDF valide. - </simpara> - </note> - <note> - <simpara> - Si vous référencez une police dans un fichier .upr, assurez vous que - le nom du fichier .afm et celui de la police sont bien les mêmes. - Sinon, la police sera aggrandie plusieur fois (Merci à - Paul Haddon pour cette info). - </simpara> - </note> </refsect1> </refentry> - <refentry id="function.pdf-set-leading"> + <refentry id="function.pdf-close"> <refnamediv> - <refname>PDF_set_leading</refname> - <refpurpose>Modifie la distance entre les lignes du textes.</refpurpose> + <refname>PDF_close</refname> + <refpurpose>Ferme un document PDF.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_set_leading</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>distance</parameter></paramdef> + <funcdef>void <function>pdf_close</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_set_leading</function> permet de choisir la distance - entre les lignes du texte. Cette valeur sera utilisée si - du texte est affiché par <function>pdf_continue_text</function>. + <function>pdf_close</function> ferme un document PDF. </para> <para> - Voir aussi <function>pdf_continue_text</function>. + Voir aussi <function>pdf_open</function>, + <function>fclose</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-set-parameter"> + <refentry id="function.pdf-closepath"> <refnamediv> - <refname>PDF_set_parameter</refname> - <refpurpose>Modifie certains paramètres.</refpurpose> + <refname>PDF_closepath</refname> + <refpurpose>Ferme et clos le chemin.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_set_parameter</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>string <parameter>name</parameter></paramdef> - <paramdef>string <parameter>value</parameter></paramdef> + <funcdef>void <function>pdf_closepath</function></funcdef> + <paramdef>int <parameter>pdf object</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - <function>pdf_set_parameter</function> modifie certaines valeurs de pdglib. - <parameter>value</parameter> est de type chaîne. - </para> <para> - Voir aussi <function>pdf_get_value</function>, - <function>pdf_set_value</function>, - <function>pdf_get_parameter</function>. + <function>pdf_closepath</function> ferme et clos le chemin courant. Cela + signifie qu'une ligne va être ajoutée entre le point courant et + le premier point du chemin. De nombreuses fonctions telles que + <function>pdf_moveto</function>, <function>pdf_circle</function> et + <function>pdf_rect</function> démarre un nouveau chemin. </para> </refsect1> </refentry> - <refentry id="function.pdf-get-parameter"> + <refentry id="function.pdf-closepath-fill-stroke"> <refnamediv> - <refname>pdf_get_parameter</refname> - <refpurpose>Lit certains paramètres</refpurpose> + <refname>PDF_closepath_fill_stroke</refname> + <refpurpose>Remplis, dessine et ferme le chemin courant.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>string <function>pdf_get_parameter</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>string <parameter>name</parameter></paramdef> - <paramdef>double <parameter><optional>modifier</optional></parameter></paramdef> + <funcdef>void <function>pdf_closepath_fill_stroke</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_get_parameter</function> lit certains - paramètres de la librairie pdflib. Ces paramètres sont des - chaînes de caractères. Le paramètre - <parameter>modifier</parameter> caractérise le paramètre. - S'il n'est pas nécessaire, il faut l'omettre, ou passer 0. + <function>pdf_closepath_fill_stroke</function> clos le chemin, + le remplis avec la couleur courante, et dessine le chemin. </para> <para> - Voir aussi <function>pdf_get_value</function>, - <function>pdf_set_value</function>, - <function>pdf_set_parameter</function>. + Voir aussi <function>pdf_closepath</function>, + <function>pdf_stroke</function>, + <function>pdf_fill</function>, + <function>pdf_setgray_fill</function>, + <function>pdf_setgray</function>, + <function>pdf_setrgbcolor_fill</function>, + <function>pdf_setrgbcolor</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-set-value"> + <refentry id="function.pdf-closepath-stroke"> <refnamediv> - <refname>pdf_set_value</refname> - <refpurpose>Modifie certains paramètre numériques</refpurpose> + <refname>PDF_closepath_stroke</refname> + <refpurpose>Ferme le chemin et dessine le long du chemin.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_set_value</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>string <parameter>name</parameter></paramdef> - <paramdef>double <parameter>value</parameter></paramdef> + <funcdef>void <function>pdf_closepath_stroke</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_set_value</function> modifie la valeur (numérique) - du paramètre <parameter>name</parameter> de PDFlib. + <function>pdf_closepath_stroke</function> est une combinaison de + <function>pdf_closepath</function> et <function>pdf_stroke</function>. + Elle ferme aussi le chemin. </para> <para> - Voir aussi <function>pdf_get_value</function>, - <function>pdf_get_parameter</function>, - <function>pdf_set_parameter</function>. + Voir aussi <function>pdf_closepath</function>, + <function>pdf_stroke</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-get-value"> + <refentry id="function.pdf-close-image"> <refnamediv> - <refname>pdf_get_value</refname> - <refpurpose>Lit certains paramètres numériques</refpurpose> + <refname>PDF_close_image</refname> + <refpurpose>Ferme une image</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>double <function>pdf_get_value</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>string <parameter>name</parameter></paramdef> - <paramdef>double <parameter><optional>modifier</optional></parameter></paramdef> + <funcdef>void <function>pdf_close_image</function></funcdef> + <paramdef>int <parameter>image</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_get_parameter</function> lit certains - paramètres de la librairie pdflib. Ces paramètres sont des - numériques. Le paramètre - <parameter>modifier</parameter> caractérise le paramètre. - S'il n'est pas nécessaire, il faut l'omettre, ou passer 0. + <function>pdf_close_image</function> ferme une image qui a + été ouverte par <function>pdf_open_gif</function> ou + <function>pdf_open_jpeg</function>. </para> <para> - Voir aussi <function>pdf_get_parameter</function>, - <function>pdf_set_value</function>, - <function>pdf_set_parameter</function>. + Voir aussi <function>pdf_open_jpeg</function>, + <function>pdf_open_gif</function>, + <function>pdf_open_tiff</function>, + <function>pdf_open_memory_image</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-get-image-height"> + <refentry id="function.pdf-concat"> <refnamediv> - <refname>pdf_get_image_height</refname> - <refpurpose>Retourne la hauteur d'une image</refpurpose> + <refname>PDF_concat</refname> + <refpurpose>Concatène une matrice avec CTM</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>string <function>pdf_get_image_height</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>int <parameter>image</parameter></paramdef> + <funcdef>void <function>pdf_concat</function></funcdef> + <paramdef>int <parameter>pdf object</parameter></paramdef> + <paramdef>double <parameter>a</parameter></paramdef> + <paramdef>double <parameter>b</parameter></paramdef> + <paramdef>double <parameter>c</parameter></paramdef> + <paramdef>double <parameter>d</parameter></paramdef> + <paramdef>double <parameter>e</parameter></paramdef> + <paramdef>double <parameter>f</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_get_image_height</function> retourne la hauteur - de l'image <parameter>image</parameter> en pixels. + <function>pdf_concat</function> concatène une matrice avec CTM. </para> - <para> - Voir aussi <function>pdf_open_image_file</function>, - <function>pdf_open_memory_image</function>, - <function>pdf_get_image_width</function>.</para> </refsect1> </refentry> - <refentry id="function.pdf-get-image-width"> + <refentry id="function.pdf-continue-text"> <refnamediv> - <refname>pdf_get_image_width</refname> - <refpurpose>Retourne la largeur d'une image</refpurpose> + <refname>PDF_continue_text</refname> + <refpurpose>Affiche un texte sur une nouvelle ligne.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>string <function>pdf_get_image_width</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>int <parameter>image</parameter></paramdef> + <funcdef>void <function>pdf_continue_text</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>string <parameter>text</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_get_image_width</function> retourne la largeur - de l'image <parameter>image</parameter>, en pixels. + <function>pdf_continue_text</function> affiche le texte + <parameter>text</parameter> sur une nouvelle ligne. La distance + entre les lignes peut être choisie avec + <function>pdf_set_leading</function>. </para> <para> - Voir aussi <function>pdf_open_image_file</function>, - <function>pdf_open_memory_image</function>, - <function>pdf_get_image_height</function>. + Voir aussi <function>pdf_show_xy</function>, + <function>pdf_set_leading</function> et + <function>pdf_set_text_pos</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-set-text-rendering"> + <refentry id="function.pdf-curveto"> <refnamediv> - <refname>PDF_set_text_rendering</refname> - <refpurpose>Determine le rendu du texte.</refpurpose> + <refname>PDF_curveto</refname> + <refpurpose>Dessine une courbe.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_set_text_rendering</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>int <parameter>mode</parameter></paramdef> + <funcdef>void <function>pdf_curveto</function></funcdef> + <paramdef>int <parameter>pdf object</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> </funcprototype> </funcsynopsis> <para> - <function>pdf_set_text_rendering</function> determine le rendu du texte. - Les valeurs possibles pour <parameter>mode</parameter> sont 0=fill text - (texte plein), 1=stroke text (???), 2=fill et stroke text (texte plein - et stroke), 3=invisible, 4=texte plein, et ajouté au chemin, - 5=stroke text, ajouté au chemin, 6=texte plein et stroke, - ajouté au chemin, 7=ajouté au chemin. + <function>pdf_curveto</function> dessine une courbe de Bézier + entre le point courant et le point (<parameter>x3</parameter>, + <parameter>y3</parameter>) en utilisant les points de contrôle + (<parameter>x1</parameter>, <parameter>y1</parameter>) et + (<parameter>x2</parameter>, <parameter>y2</parameter>). + </para> + <para> + Voir aussi <function>pdf_moveto</function>, + <function>pdf_lineto</function> et + <function>pdf_stroke</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-set-horiz-scaling"> + <refentry id="function.pdf-delete"> <refnamediv> - <refname>PDF_set_horiz_scaling</refname> - <refpurpose>Fixe l'echelle horizontale du texte.</refpurpose> + <refname>PDF_delete</refname> + <refpurpose>Efface un objet PDF</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_set_horiz_scaling</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>scale</parameter></paramdef> + <funcdef>void <function>pdf_delete</function></funcdef> + <paramdef>int <parameter>pdf object</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_set_horiz_scaling</function> fixe l'échelle - horizontale du texte, à <parameter>scale</parameter> en - pourcentage. + <function>pdf_delete</function> efface un objet PDF et libère + les ressources. </para> </refsect1> </refentry> - <refentry id="function.pdf-set-text-rise"> + <refentry id="function.pdf-end-page"> <refnamediv> - <refname>PDF_set_text_rise</refname> - <refpurpose>Modifie l'élévation du texte.</refpurpose> + <refname>PDF_end_page</refname> + <refpurpose>Termine une page.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_set_text_rise</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>rise</parameter></paramdef> + <funcdef>void <function>pdf_end_page</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_set_text_rise</function> fixe l'élévation - du texte à <parameter>rise</parameter> points. + <function>pdf_end_page</function> termine une page. Une fois + qu'une page a été fermée, elle ne peut pas + être modifiée. + </para> + <para> + Voir aussi <function>pdf_begin_page</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-set-text-matrix"> + <refentry id="function.pdf-endpath"> <refnamediv> - <refname>PDF_set_text_matrix</refname> - <refpurpose>Fixe la matrice de texte.</refpurpose> + <refname>PDF_endpath</refname> + <refpurpose>Ferme le chemin courant</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_set_text_matrix</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>array <parameter>matrix</parameter></paramdef> + <funcdef>void <function>pdf_endpath</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> </funcprototype> </funcsynopsis> + <para> + <function>pdf_endpath</function> ferme le chemin courant + mais ne le clôt pas. + </para> <para> - <function>pdf_set_text_matrix</function> choisi la matrice de texte : la matrice - de texte determine les transformations de la police courante. La matrice est un - tableau de 6 éléments. + Voir aussi <function>pdf_closepath</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-set-text-pos"> + <refentry id="function.pdf-fill"> <refnamediv> - <refname>PDF_set_text_pos</refname> - <refpurpose>Fixe la position du texte.</refpurpose> + <refname>PDF_fill</refname> + <refpurpose>Remplis le chemin courant.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_set_text_pos</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>x-coor</parameter></paramdef> - <paramdef>double <parameter>y-coor</parameter></paramdef> + <funcdef>void <function>pdf_fill</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_set_text_pos</function> modifie la position du texte qui sera - utilisée lors du prochain <function>pdf_show</function>. + <function>pdf_fill</function> remplis l'intérieur du chemin + courant avec la couleur courante. </para> <para> - Voir aussi <function>pdf_show</function>, - <function>pdf_show_xy</function>. + Voir aussi <function>pdf_closepath</function>, + <function>pdf_stroke</function>, + <function>pdf_setgray_fill</function>, + <function>pdf_setgray</function>, + <function>pdf_setrgbcolor_fill</function>, + <function>pdf_setrgbcolor</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-set-char-spacing"> + <refentry id="function.pdf-fill-stroke"> <refnamediv> - <refname>PDF_set_char_spacing</refname> - <refpurpose>Fixe l'espacement des caractères.</refpurpose> + <refname>PDF_fill_stroke</refname> + <refpurpose>Remplis et dessine le chemin courant.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_set_char_spacing</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>space</parameter></paramdef> + <funcdef>void <function>pdf_fill_stroke</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_set_char_spacing</function> fixe l'espacement des caractères. + <function>pdf_fill_stroke</function> remplis l'intérieur du chemin + courant avec la couleur courante, puis dessine le chemin courant. </para> <para> - Voir aussi <function>pdf_set_word_spacing</function>, - <function>pdf_set_leading</function>. + Voir aussi <function>pdf_closepath</function>, + <function>pdf_stroke</function>, + <function>pdf_fill</function>, + <function>pdf_setgray_fill</function>, + <function>pdf_setgray</function>, + <function>pdf_setrgbcolor_fill</function>, + <function>pdf_setrgbcolor</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-set-word-spacing"> + <refentry id="function.pdf-findfont"> <refnamediv> - <refname>PDF_set_word_spacing</refname> - <refpurpose>Fixe l'espacement des mots.</refpurpose> + <refname>PDF_findfont</refname> + <refpurpose>Prépare une police pour utilisation +ultérieure</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_set_word_spacing</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>space</parameter></paramdef> + <funcdef>void <function>pdf_findfont</function></funcdef> + <paramdef>int <parameter>pdf object</parameter></paramdef> + <paramdef>string <parameter>fontname</parameter></paramdef> + <paramdef>string <parameter>encoding</parameter></paramdef> + <paramdef>int <parameter>embed</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - <function>pdf_set_word_spacing</function> modifie l'espacement des mots. - </para> <para> - Voir aussi <function>pdf_set_char_spacing</function>, - <function>pdf_set_leading</function>. + <function>pdf_findfont</function> prépare une police pour utilisation + ultérieure avec <function>pdf_setfont</function>. Les dimensions seront + chargées, et lorsque c'est possible, le fichier de police sera + vérifié, mais pas utilisé. <parameter>encoding</parameter> +peut prendre + l'une des valeurs suivantes : "builtin" (intégrée), + "macroman", "winansi", "host", et nom d'encodage utilisateur, ou encore + nom de CMap. </para> </refsect1> </refentry> - <refentry id="function.pdf-skew"> + <refentry id="function.pdf-get-buffer"> <refnamediv> - <refname>PDF_skew</refname> - <refpurpose>Modifie le système de coordonnées.</refpurpose> + <refname>PDF_get_buffer</refname> + <refpurpose>Lit un buffer contenant des données PDF</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_skew</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>alpha</parameter></paramdef> - <paramdef>double <parameter>beta</parameter></paramdef> + <funcdef>string <function>pdf_get_buffer</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_skew</function> modifie le système de coordonnées, - en faisant une rotation d'angle <parameter>alpha</parameter> pour les (x) et - d'angle <parameter>beta</parameter> pour les (y), en degrés. - <parameter>alpha</parameter> et <parameter>beta</parameter> ne peuvent pas - pendre les valeurs de 90 ou 270 degrés. + <function>pdf_get_buffer</function> lit le contenu du buffer + <parameter>pdf_object</parameter>. Le résultat doit être +utilisé + par le client avant d'appeler toute autre fonction PDFLib. </para> </refsect1> </refentry> - <refentry id="function.pdf-continue-text"> + <refentry id="function.pdf-get-font"> <refnamediv> - <refname>PDF_continue_text</refname> - <refpurpose>Affiche un texte sur une nouvelle ligne.</refpurpose> + <refname>PDF_get_font</refname> + <refpurpose>Obsolète : gestion de police</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>pdf_continue_text</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>string <parameter>text</parameter></paramdef> - </funcprototype> - </funcsynopsis> <para> - <function>pdf_continue_text</function> affiche le texte <parameter>text</parameter> - sur une nouvelle ligne. La distance entre les lignes peut être choisie - avec <function>pdf_set_leading</function>. + Obsolète. </para> <para> - Voir aussi <function>pdf_show_xy</function>, - <function>pdf_set_leading</function>, - <function>pdf_set_text_pos</function>. + Voir aussi <function>pdf_get_value</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-stringwidth"> + <refentry id="function.pdf-get-fontname"> <refnamediv> - <refname>PDF_stringwidth</refname> - <refpurpose>Retourne la largeur du texte avec la police courante.</refpurpose> + <refname>PDF_get_fontname</refname> + <refpurpose>Obsolète : gestion de nom de police</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>double <function>pdf_stringwidth</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>string <parameter>text</parameter></paramdef> - </funcprototype> - </funcsynopsis> <para> - <function>pdf_stringwidth</function> retourne la largeur du texte - <parameter>text</parameter> avec la police courante. Il faut qu'une police ait - été choisie auparavant. + Obsolète. </para> <para> - Voir aussi <function>pdf_set_font</function>. + Voir aussi <function>pdf_get_parameter</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-save"> + <refentry id="function.pdf-get-fontsize"> <refnamediv> - <refname>PDF_save</refname> - <refpurpose>Enregistre l'environnement courant.</refpurpose> + <refname>PDF_get_fontsize</refname> + <refpurpose>Obsolète : gestion de taille de police</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>pdf_save</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - </funcprototype> - </funcsynopsis> <para> - <function>pdf_save</function> enregistre l'environnement courant. Le - fonctionnement est identique à la commande postscript gsave. Très - pratique si vous voulez faire une translation ou une rotation d'un objet, sans - affecter les autres. <function>pdf_save</function> sera toujours suivi d'un - <function>pdf_restore</function>. + Obsolète. </para> <para> - Voir aussi <function>pdf_restore</function>. + Voir aussi <function>pdf_get_value</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-restore"> + <refentry id="function.pdf-get-image-height"> <refnamediv> - <refname>PDF_restore</refname> - <refpurpose>Restaure un environnement sauvé.</refpurpose> + <refname>pdf_get_image_height</refname> + <refpurpose>Retourne la hauteur d'une image</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_restore</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> + <funcdef>string <function>pdf_get_image_height</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>int <parameter>image</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - <function>pdf_restore</function> restaure un environnement sauvé par - <function>pdf_save</function>. Cela fonctionne de manière identique - à la commande Postscript grestore. Très pratique lorsque vous vous - faire des translations ou des rotations sans affecter les autres objets. - <example> - <title>Sauver et restaurer un environnement PDF</title> - <programlisting role="php"> -<?php -pdf_save($pdf); -// tout un lot de rotations, translations, transformations... -pdf_restore($pdf) -?> - </programlisting> - </example> - </para> <para> - Voir aussi <function>pdf_save</function>. + <function>pdf_get_image_height</function> retourne la hauteur + de l'image <parameter>image</parameter> en pixels. </para> + <para> + Voir aussi <function>pdf_open_image_file</function>, + <function>pdf_open_memory_image</function>, + <function>pdf_get_image_width</function>.</para> </refsect1> </refentry> - <refentry id="function.pdf-translate"> + <refentry id="function.pdf-get-image-width"> <refnamediv> - <refname>PDF_translate</refname> - <refpurpose>Modifie l'origine du système de coordonnées.</refpurpose> + <refname>pdf_get_image_width</refname> + <refpurpose>Retourne la largeur d'une image</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_translate</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>x-coor</parameter></paramdef> - <paramdef>double <parameter>y-coor</parameter></paramdef> + <funcdef>string <function>pdf_get_image_width</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>int <parameter>image</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_translate</function> place l'origine du système de - coordonnées au point (<parameter>x-coor</parameter>, - <parameter>y-coor</parameter>). L'exemple suivant trace une ligne de (0, 0) - à (200, 200) par rapport aux coordonnées initiales. Il faut aussi - désigner le point courant après <function>pdf_translate</function> - et avant de commencer à dessiner les objets. - <example> - <title>Translation</title> - <programlisting role="php"> -<?php PDF_moveto($pdf, 0, 0); -PDF_lineto($pdf, 100, 100); -PDF_stroke($pdf); -PDF_translate($pdf, 100, 100); -PDF_moveto($pdf, 0, 0); -PDF_lineto($pdf, 100, 100); -PDF_stroke($pdf); -?> - </programlisting> - </example> + <function>pdf_get_image_width</function> retourne la largeur + de l'image <parameter>image</parameter>, en pixels. + </para> + <para> + Voir aussi <function>pdf_open_image_file</function>, + <function>pdf_open_memory_image</function>, + <function>pdf_get_image_height</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-scale"> + <refentry id="function.pdf-get-parameter"> <refnamediv> - <refname>PDF_scale</refname> - <refpurpose>Modifie l'échelle.</refpurpose> + <refname>PDF_get_parameter</refname> + <refpurpose>Lit la valeur d'un paramètre PDFLib chaîne</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_scale</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>x-scale</parameter></paramdef> - <paramdef>double <parameter>y-scale</parameter></paramdef> + <funcdef>string <function>pdf_get_parameter</function></funcdef> + <paramdef>int <parameter>pdf object</parameter></paramdef> + <paramdef>string <parameter>key</parameter></paramdef> + <paramdef>double <parameter><optional>modifier</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_scale</function> modifie l'échelle dans les deux directions. - L'exemple suivant multiplie l'échelle par 72. La ligne suivante sera - dessinée sur un pouce (2.54 cm) de large. - <example> - <title>Mise à l'échelle</title> - <programlisting role="php"> -<?php PDF_scale($pdf, 72.0, 72.0); -PDF_lineto($pdf, 1, 1); -PDF_stroke($pdf); -?> - </programlisting> - </example> - </para> + <function>pdf_get_parameter</function> lit le contenu de certains + paramètres PDFLib, au format chaîne de caractères. + </para> </refsect1> </refentry> - <refentry id="function.pdf-rotate"> + <refentry id="function.pdf-get-value"> <refnamediv> - <refname>PDF_rotate</refname> - <refpurpose>Choisi la rotation.</refpurpose> + <refname>PDF_get_value</refname> + <refpurpose>Lit la valeur d'un paramètre PDFLib +numérique</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_rotate</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>angle</parameter></paramdef> + <funcdef>double <function>pdf_get_value</function></funcdef> + <paramdef>int <parameter>pdf object</parameter></paramdef> + <paramdef>string <parameter>key</parameter></paramdef> + <paramdef>double <parameter><optional>modifier</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_rotate</function> modifie la rotation de - <parameter>angle</parameter> degré. + <function>pdf_get_value</function> lit le contenu de certains + paramètres PDFLib, au format numérique. </para> </refsect1> </refentry> - <refentry id="function.pdf-setflat"> + <refentry id="function.pdf-lineto"> <refnamediv> - <refname>PDF_setflat</refname> - <refpurpose>Modifie la platitude (flatness).</refpurpose> + <refname>PDF_lineto</refname> + <refpurpose>Dessine une ligne.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_setflat</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>value</parameter></paramdef> + <funcdef>void <function>pdf_lineto</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>x-coor</parameter></paramdef> + <paramdef>double <parameter>y-coor</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_setflat</function> modifie la platitude, et lui - affecte la valeur <parameter>value</parameter> entre 0 et 100. + <function>pdf_lineto</function> dessine une ligne entre le point + courant et le point de coordonnées + (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>). + </para> + <para> + Voir aussi <function>pdf_moveto</function>, + <function>pdf_curveto</function> et + <function>pdf_stroke</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-setlinejoin"> + <refentry id="function.pdf-moveto"> <refnamediv> - <refname>PDF_setlinejoin</refname> - <refpurpose>Modifie le paramètre linejoin.</refpurpose> + <refname>PDF_moveto</refname> + <refpurpose>Déplace le point courant.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_setlinejoin</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>long <parameter>value</parameter></paramdef> + <funcdef>void <function>pdf_moveto</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>x-coor</parameter></paramdef> + <paramdef>double <parameter>y-coor</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_setlinejoin</function> modifie le paramètre "linejoin", - et lui affecte la valeur <parameter>value</parameter>, entre 0 et 2. + <function>pdf_moveto</function> déplace le point courant à + la position (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>). </para> </refsect1> </refentry> - <refentry id="function.pdf-setlinecap"> + <refentry id="function.pdf-new"> <refnamediv> - <refname>PDF_setlinecap</refname> - <refpurpose>Choisi le paramètre linecap.</refpurpose> + <refname>PDF_new</refname> + <refpurpose>Crée un nouvel objet PDF</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_setlinecap</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>int <parameter>value</parameter></paramdef> + <funcdef>int <function>pdf_new</function></funcdef> + <void/> </funcprototype> </funcsynopsis> <para> - <function>pdf_setlinecap</function> affecte au paramètre "linecap" - la valeur <parameter>value</parameter>, entre 0 et 2. + <function>pdf_new</function> crée un nouvel objet PDF, + avec gestion des erreurs et de la mémoire par défaut. </para> </refsect1> </refentry> - <refentry id="function.pdf-setmiterlimit"> + <refentry id="function.pdf-open"> <refnamediv> - <refname>PDF_setmiterlimit</refname> - <refpurpose>Modifie la "miter limit".</refpurpose> + <refname>pdf_open</refname> + <refpurpose>Obsolète: Ouvre un nouvel objet PDF</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>pdf_setmiterlimit</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>value</parameter></paramdef> - </funcprototype> - </funcsynopsis> <para> - <function>pdf_setmiterlimit</function> modifie la "miter limit" et - lui affecte la valeur <parameter>value</parameter>, supérieure à 1. + <function>pdf_open</function> est obsolète. Utilisez + <function>pdf_new</function> puis <function>pdf_open_file</function>. </para> + <para> + Voir aussi <function>pdf_new</function> et + <function>pdf_open_file</function>. + </para> </refsect1> </refentry> - <refentry id="function.pdf-setlinewidth"> + <refentry id="function.pdf-open-ccitt"> <refnamediv> - <refname>PDF_setlinewidth</refname> - <refpurpose>Modifie la largeur de ligne.</refpurpose> + <refname>PDF_open_CCITT</refname> + <refpurpose>Ouvre une nouvelle image à partir de données +CCITT</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_setlinewidth</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>width</parameter></paramdef> + <funcdef>int <function>pdf_open_ccitt</function></funcdef> + <paramdef>int <parameter>pdf object</parameter></paramdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>int <parameter>width</parameter></paramdef> + <paramdef>int <parameter>height</parameter></paramdef> + <paramdef>int <parameter>BitReverse</parameter></paramdef> + <paramdef>int <parameter>k</parameter></paramdef> + <paramdef>int <parameter>Blackls1</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_setlinewidth</function> affecte à largeur de - ligne la valeur <parameter>width</parameter>. + <function>pdf_open_ccitt</function> ouvre une image + CCITT. </para> </refsect1> </refentry> - <refentry id="function.pdf-setdash"> + <refentry id="function.pdf-open-file"> <refnamediv> - <refname>PDF_setdash</refname> - <refpurpose>Modifie les caractères de remplissage.</refpurpose> + <refname>PDF_open_file</refname> + <refpurpose>Ouvre un nouvel objet PDF</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_setdash</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>white</parameter></paramdef> - <paramdef>double <parameter>black</parameter></paramdef> + <funcdef>int <function>pdf_open_file</function></funcdef> + <paramdef>int <parameter>pdf object</parameter></paramdef> + <paramdef>string <parameter><optional>filename</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_setdash</function> modifie les caractères de remplissage, - et affecte <parameter>white</parameter> comme caractère invisible, et - <parameter>black</parameter> comme caractère de remplissage. Si les deux - sont à zéros, une ligne continue est affichée. + <function>pdf_open_file</function> crée un nouvel objet PDF + à partir du fichier <parameter>filename</parameter>. Si + <parameter>filename</parameter> est vide, le fichier PDF + sera généré en mémoire. Le résultat devrat +être lu avec la fonction + <function>pdf_get_buffer</function> function. </para> </refsect1> </refentry> - <refentry id="function.pdf-moveto"> + <refentry id="function.pdf-open-gif"> <refnamediv> - <refname>PDF_moveto</refname> - <refpurpose>Modifie le point courant.</refpurpose> + <refname>PDF_open_gif</refname> + <refpurpose>Obsolète: Ouvre une image GIF</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>pdf_moveto</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>x-coor</parameter></paramdef> - <paramdef>double <parameter>y-coor</parameter></paramdef> - </funcprototype> - </funcsynopsis> <para> - <function>pdf_moveto</function> déplace le point courant à - la position (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>). + Obsolète. + </para> + <para> + Voir aussi <function>pdf_open_image</function>, </para> </refsect1> </refentry> - <refentry id="function.pdf-curveto"> + <refentry id="function.pdf-open-image"> <refnamediv> - <refname>PDF_curveto</refname> - <refpurpose>Dessine une courbe.</refpurpose> + <refname>PDF_open_image</refname> + <refpurpose>Fonction générique pour les images</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_curveto</function></funcdef> - <paramdef>int <parameter>pdf document</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> + <funcdef>int <function>pdf_open_image</function></funcdef> + <paramdef>int <parameter>PDF-document</parameter></paramdef> + <paramdef>string <parameter>imagetype</parameter></paramdef> + <paramdef>string <parameter>source</parameter></paramdef> + <paramdef>string <parameter>data</parameter></paramdef> + <paramdef>long <parameter>length</parameter></paramdef> + <paramdef>int <parameter>width</parameter></paramdef> + <paramdef>int <parameter>height</parameter></paramdef> + <paramdef>int <parameter>components</parameter></paramdef> + <paramdef>int <parameter>bpc</parameter></paramdef> + <paramdef>string <parameter>params</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - <function>pdf_curveto</function> dessine une courbe de Bezier entre le point - courant et le point (<parameter>x3</parameter>, <parameter>y3</parameter>) en - utilisant les points de contrôle (<parameter>x1</parameter>, - <parameter>y1</parameter>) et (<parameter>x2</parameter>, <parameter>y2</parameter>). - </para> <para> - Voir aussi <function>pdf_moveto</function>, - <function>pdf_lineto</function>, - <function>pdf_stroke</function>. + <function>pdf_open_image</function> ouvre des fichiers de divers + formats d'images. <parameter>imagetype</parameter> peut prendre + l'une des valeurs suivantes : "jpeg", "ccitt", "raw". + <parameter>source</parameter> peut prendre l'une des valeurs + suivantes : "memory" (mémoire), "fileref" (pointeur de fichier), + "url". <parameter>length</parameter> ne sert que pour le type + "raw"; <parameter>params</parameter> ne sert qur pour le type + "ccitt". </para> </refsect1> </refentry> - <refentry id="function.pdf-lineto"> + <refentry id="function.pdf-open-image-file"> <refnamediv> - <refname>PDF_lineto</refname> - <refpurpose>Dessine une ligne.</refpurpose> + <refname>PDF_open_image_file</refname> + <refpurpose>Lit une image depuis un fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_lineto</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>x-coor</parameter></paramdef> - <paramdef>double <parameter>y-coor</parameter></paramdef> + <funcdef>int <function>pdf_open_image_file</function></funcdef> + <paramdef>int <parameter>PDF_object</parameter></paramdef> + <paramdef>string <parameter>imagetype</parameter></paramdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>string +<parameter><optional>stringparam</optional></parameter></paramdef> + <paramdef>string <parameter><optional>intparam</optional></parameter></paramdef> </funcprototype> </funcsynopsis> + <para> + <function>pdf_open_image_file</function> ouvre une image + dans le fichier <parameter>filename</parameter>. +<parameter>imagetype</parameter> + peut prendre une des valeurs suivantes : "jpeg", "tiff", "gif", + et "png". <parameter>stringparam</parameter> peut prendre l'une + des valeurs suivantes : "", "mask", "masked", ou "page". + <parameter>intparam</parameter> peut valoir 0, l'id de l'image + du masque appliqué, ou la page. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-open-png"> + <refnamediv> + <refname>pdf_open_png</refname> + <refpurpose>Obsolète: Ouvre une image PNG</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> <para> - <function>pdf_lineto</function> dessine une ligne entre le point courant et le - point de coordonnées (<parameter>x-coor</parameter>, - <parameter>y-coor</parameter>). + Obsolète. </para> <para> - Voir aussi <function>pdf_moveto</function>, - <function>pdf_curveto</function>, - <function>pdf_stroke</function>. + Voir aussi <function>pdf_open_image</function>, </para> </refsect1> </refentry> - <refentry id="function.pdf-circle"> + <refentry id="function.pdf-open-jpeg"> <refnamediv> - <refname>PDF_circle</refname> - <refpurpose>Dessine un cercle.</refpurpose> + <refname>PDF_open_jpeg</refname> + <refpurpose>Obsolète: Ouvre une image JPEG</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para> + Obsolète. + </para> + <para> + Voir aussi <function>pdf_open_image</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-open-png"> + <refnamediv> + <refname>PDF_open_png</refname> + <refpurpose>Obsolète: Ouvre une image PNG</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para> + Obsolète. + </para> + <para> + Voir aussi <function>pdf_open_image</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-open-tiff"> + <refnamediv> + <refname>PDF_open_tiff</refname> + <refpurpose>Obsolète: Ouvre une image TIFF</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_circle</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>x-coor</parameter></paramdef> - <paramdef>double <parameter>y-coor</parameter></paramdef> - <paramdef>double <parameter>radius</parameter></paramdef> + <funcdef>int <function>pdf_open_tiff</function></funcdef> + <paramdef>int <parameter>PDF-document</parameter></paramdef> + <paramdef>string <parameter>filename</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_circle</function> dessine un cercle de centre - (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>), et de rayon - <parameter>radius</parameter>. + Obsolète. </para> <para> - Voir aussi <function>pdf_arc</function>, - <function>pdf_stroke</function>. + Voir aussi <function>pdf_open_image</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-arc"> + <refentry id="function.pdf-place-image"> <refnamediv> - <refname>PDF_arc</refname> - <refpurpose>Dessine un arc.</refpurpose> + <refname>PDF_place_image</refname> + <refpurpose>Place une image dans la page.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_arc</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> + <funcdef>void <function>pdf_place_image</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>int <parameter>image</parameter></paramdef> <paramdef>double <parameter>x-coor</parameter></paramdef> <paramdef>double <parameter>y-coor</parameter></paramdef> - <paramdef>double <parameter>radius</parameter></paramdef> - <paramdef>double <parameter>start</parameter></paramdef> - <paramdef>double <parameter>end</parameter></paramdef> + <paramdef>double <parameter>scale</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_arc</function> dessine un arc de cercle, de centre - (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>) et de - rayon <parameter>radius</parameter>, en commencant à l'angle - <parameter>start</parameter> et finissant à l'angle - <parameter>end</parameter>. + <function>pdf_place_image</function> place l'image <parameter>image</parameter> + dans la page courante, à la position (<parameter>x-coor</parameter>, + <parameter>x-coor</parameter>). L'image peut changer d'échelle + simultanémement. </para> <para> - Voir aussi <function>pdf_circle</function>, - <function>pdf_stroke</function>. + Voir aussi <function>pdf_put_image</function>. </para> </refsect1> </refentry> @@ -1524,7 +1559,7 @@ <funcsynopsis> <funcprototype> <funcdef>void <function>pdf_rect</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> <paramdef>double <parameter>x-coor</parameter></paramdef> <paramdef>double <parameter>y-coor</parameter></paramdef> <paramdef>double <parameter>width</parameter></paramdef> @@ -1543,214 +1578,223 @@ </para> </refsect1> </refentry> - <refentry id="function.pdf-closepath"> + <refentry id="function.pdf-restore"> <refnamediv> - <refname>PDF_closepath</refname> - <refpurpose>Ferme et clos le chemin.</refpurpose> + <refname>PDF_restore</refname> + <refpurpose>Restaure un environnement sauvé.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_closepath</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> + <funcdef>void <function>pdf_restore</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_closepath</function> ferme et clos le chemin courant. Cela - signifie qu'une ligne va être ajoutée entre le point courant et - le premier point du chemin. De nombreuses fonctions telles que - <function>pdf_moveto</function>, <function>pdf_circle</function> et - <function>pdf_rect</function> démarre un nouveau chemin. + <function>pdf_restore</function> restaure un environnement sauvé par + <function>pdf_save</function>. Cela fonctionne de manière identique + à la commande Postscript grestore. Très pratique lorsque vous vous + faire des translations ou des rotations sans affecter les autres objets. + <example> + <title>Sauver et restaurer un environnement PDF</title> + <programlisting role="php"> +<?php +pdf_save($pdf); +// tout un lot de rotations, translations, transformations... +pdf_restore($pdf) +?> + </programlisting> + </example> + </para> + <para> + Voir aussi <function>pdf_save</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-stroke"> + <refentry id="function.pdf-rotate"> <refnamediv> - <refname>PDF_stroke</refname> - <refpurpose>Dessine le long du chemin.</refpurpose> + <refname>PDF_rotate</refname> + <refpurpose>Choisi la rotation.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_stroke</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> + <funcdef>void <function>pdf_rotate</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>angle</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - <function>pdf_stroke</function> dessine une ligne le long du chemin. Le chemin - courant est la somme de toutes les lignes déssinées. Sans cette - fonction, la ligne de chemin ne sera pas dessinée. - </para> <para> - Voir aussi <function>pdf_closepath</function>, - <function>pdf_closepath_stroke</function>. + <function>pdf_rotate</function> modifie la rotation de + <parameter>angle</parameter> degré. </para> </refsect1> </refentry> - <refentry id="function.pdf-closepath-stroke"> + <refentry id="function.pdf-save"> <refnamediv> - <refname>PDF_closepath_stroke</refname> - <refpurpose>Ferme le chemin et dessine le long du chemin.</refpurpose> + <refname>PDF_save</refname> + <refpurpose>Enregistre l'environnement courant.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_closepath_stroke</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> + <funcdef>void <function>pdf_save</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_closepath_stroke</function> est une combinaison de - <function>pdf_closepath</function> et <function>pdf_stroke</function>. - Elle ferme aussi le chemin. + <function>pdf_save</function> enregistre l'environnement courant. Le + fonctionnement est identique à la commande postscript gsave. Très + pratique si vous voulez faire une translation ou une rotation d'un objet, sans + affecter les autres. <function>pdf_save</function> sera toujours suivi d'un + <function>pdf_restore</function>. </para> <para> - Voir aussi <function>pdf_closepath</function>, - <function>pdf_stroke</function>. + Voir aussi <function>pdf_restore</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-fill"> + <refentry id="function.pdf-scale"> <refnamediv> - <refname>PDF_fill</refname> - <refpurpose>Remplis le chemin courant.</refpurpose> + <refname>PDF_scale</refname> + <refpurpose>Modifie l'échelle.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_fill</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> + <funcdef>void <function>pdf_scale</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>x-scale</parameter></paramdef> + <paramdef>double <parameter>y-scale</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - <function>pdf_fill</function> remplis l'intérieur du chemin - courant avec la couleur courante. - </para> <para> - Voir aussi <function>pdf_closepath</function>, - <function>pdf_stroke</function>, - <function>pdf_setgray_fill</function>, - <function>pdf_setgray</function>, - <function>pdf_setrgbcolor_fill</function>, - <function>pdf_setrgbcolor</function>. - </para> + <function>pdf_scale</function> modifie l'échelle dans les deux +directions. + L'exemple suivant multiplie l'échelle par 72. La ligne suivante sera + dessinée sur un pouce (2.54 cm) de large. + <example> + <title>Mise à l'échelle</title> + <programlisting role="php"> +<?php PDF_scale($pdf, 72.0, 72.0); +PDF_lineto($pdf, 1, 1); +PDF_stroke($pdf); +?> + </programlisting> + </example> + </para> </refsect1> </refentry> - <refentry id="function.pdf-fill-stroke"> + <refentry id="function.pdf-setdash"> <refnamediv> - <refname>PDF_fill_stroke</refname> - <refpurpose>Remplis et dessine le chemin courant.</refpurpose> + <refname>PDF_setdash</refname> + <refpurpose>Modifie les caractères de remplissage.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_fill_stroke</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> + <funcdef>void <function>pdf_setdash</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>white</parameter></paramdef> + <paramdef>double <parameter>black</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - <function>pdf_fill_stroke</function> remplis l'intérieur du chemin - courant avec la couleur courante, puis dessine le chemin courant. - </para> <para> - Voir aussi <function>pdf_closepath</function>, - <function>pdf_stroke</function>, - <function>pdf_fill</function>, - <function>pdf_setgray_fill</function>, - <function>pdf_setgray</function>, - <function>pdf_setrgbcolor_fill</function>, - <function>pdf_setrgbcolor</function>. + <function>pdf_setdash</function> modifie les caractères de remplissage, + et affecte <parameter>white</parameter> comme caractère invisible, et + <parameter>black</parameter> comme caractère de remplissage. Si les deux + sont à zéros, une ligne continue est affichée. </para> </refsect1> </refentry> - <refentry id="function.pdf-closepath-fill-stroke"> + <refentry id="function.pdf-setflat"> <refnamediv> - <refname>PDF_closepath_fill_stroke</refname> - <refpurpose>Remplis, dessine et ferme le chemin courant.</refpurpose> + <refname>PDF_setflat</refname> + <refpurpose>Modifie la platitude (flatness).</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_closepath_fill_stroke</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> + <funcdef>void <function>pdf_setflat</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>value</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - <function>pdf_closepath_fill_stroke</function> clos le chemin, - le remplis avec la couleur courante, et dessine le chemin. - </para> <para> - Voir aussi <function>pdf_closepath</function>, - <function>pdf_stroke</function>, - <function>pdf_fill</function>, - <function>pdf_setgray_fill</function>, - <function>pdf_setgray</function>, - <function>pdf_setrgbcolor_fill</function>, - <function>pdf_setrgbcolor</function>. + <function>pdf_setflat</function> modifie la platitude, et lui + affecte la valeur <parameter>value</parameter> entre 0 et 100. </para> </refsect1> </refentry> - <refentry id="function.pdf-endpath"> + <refentry id="function.pdf-setfont"> <refnamediv> - <refname>PDF_endpath</refname> - <refpurpose>Ferme le chemin courant.</refpurpose> + <refname>PDF_setfont</refname> + <refpurpose>Modifie la police courante</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_endpath</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> + <funcdef>void <function>pdf_setfont</function></funcdef> + <paramdef>int <parameter>pdf object</parameter></paramdef> + <paramdef>int <parameter>font</parameter></paramdef> + <paramdef>double <parameter>size</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - <function>pdf_endpath</function> ferme le chemin courant mais ne le clos pas. - </para> <para> - Voir aussi <function>pdf_closepath</function>. + <function>pdf_setfont</function> remplace la police courante + par <parameter>font</parameter>, à la taille <parameter>size</parameter>. + <parameter>font</parameter> est créé par +<function>pdf_findfont</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-clip"> + <refentry id="function.pdf-setgray"> <refnamediv> - <refname>PDF_clip</refname> - <refpurpose>Aligne sur le chemin courant.</refpurpose> + <refname>PDF_setgray</refname> + <refpurpose> + Modifie la couleur grise comme couleur de remplissage et de dessin. + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_clip</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> + <funcdef>void <function>pdf_setgray</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>gray value</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_clip</function> aligne tous les dessins sur le chemin courant. + <function>pdf_setgray</function> modifie la couleur grise comme + couleur de remplissage et de dessin. + </para> + <para> + Voir aussi <function>pdf_setrgbcolor_stroke</function> et + <function>pdf_setrgbcolor_fill</function>. </para> </refsect1> </refentry> <refentry id="function.pdf-setgray-fill"> <refnamediv> <refname>PDF_setgray_fill</refname> - <refpurpose>Choisi la couleur grise comme couleur de remplissage.</refpurpose> + <refpurpose>Modifie la couleur grise comme couleur de remplissage.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>void <function>pdf_setgray_fill</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> <paramdef>double <parameter>gray value</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_setgray_fill</function> choisi la couleur grise comme couleur de + <function>pdf_setgray_fill</function> modifie la couleur grise comme couleur de remplissage. </para> <para> @@ -1761,19 +1805,19 @@ <refentry id="function.pdf-setgray-stroke"> <refnamediv> <refname>PDF_setgray_stroke</refname> - <refpurpose>Fixe la couleur de dessin à un niveau de gris.</refpurpose> + <refpurpose>Modifie la couleur de dessin à un niveau de gris.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>void <function>pdf_setgray_stroke</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> <paramdef>double <parameter>gray value</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_setgray_stroke</function> Fixe la couleur de dessin + <function>pdf_setgray_stroke</function> modifie la couleur de dessin à un niveau de gris. </para> <para> @@ -1781,717 +1825,848 @@ </para> </refsect1> </refentry> - <refentry id="function.pdf-setgray"> + <refentry id="function.pdf-setlinecap"> <refnamediv> - <refname>PDF_setgray</refname> - <refpurpose> - Choisi la couleur grise comme couleur de remplissage et de dessin. - </refpurpose> + <refname>PDF_setlinecap</refname> + <refpurpose>Modifie le paramètre linecap.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_setgray</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>gray value</parameter></paramdef> + <funcdef>void <function>pdf_setlinecap</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>int <parameter>value</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - <function>pdf_setgray</function> choisi la couleur grise comme couleur de - remplissage et de dessin. - </para> <para> - Voir aussi <function>pdf_setrgbcolor_stroke</function>, - <function>pdf_setrgbcolor_fill</function>. + <function>pdf_setlinecap</function> affecte au paramètre "linecap" + la valeur <parameter>value</parameter>, entre 0 et 2. </para> </refsect1> </refentry> - <refentry id="function.pdf-setrgbcolor-fill"> + <refentry id="function.pdf-setlinejoin"> <refnamediv> - <refname>PDF_setrgbcolor_fill</refname> - <refpurpose>Choisi la couleur rgb comme couleur de remplissage.</refpurpose> + <refname>PDF_setlinejoin</refname> + <refpurpose>Modifie le paramètre linejoin.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_setrgbcolor_fill</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>red value</parameter></paramdef> - <paramdef>double <parameter>green value</parameter></paramdef> - <paramdef>double <parameter>blue value</parameter></paramdef> + <funcdef>void <function>pdf_setlinejoin</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>long <parameter>value</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_setrgbcolor_fill</function> choisi la couleur rgb comme couleur - de remplissage. + <function>pdf_setlinejoin</function> modifie le paramètre "linejoin", + et lui affecte la valeur <parameter>value</parameter>, entre 0 et 2. </para> - <para> - Voir aussi <function>pdf_setrgbcolor_fill</function>. - </para> </refsect1> </refentry> - <refentry id="function.pdf-setrgbcolor-stroke"> + <refentry id="function.pdf-setlinewidth"> <refnamediv> - <refname>PDF_setrgbcolor_stroke</refname> - <refpurpose>Choisi la couleur rgb comme couleur de remplissage.</refpurpose> + <refname>PDF_setlinewidth</refname> + <refpurpose>Modifie la largeur de ligne.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_setrgbcolor_stroke</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>red value</parameter></paramdef> - <paramdef>double <parameter>green value</parameter></paramdef> - <paramdef>double <parameter>blue value</parameter></paramdef> + <funcdef>void <function>pdf_setlinewidth</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>width</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - <function>pdf_setrgbcolor_stroke</function> choisi la couleur rgb comme couleur - de remplissage. - </para> <para> - Voir aussi <function>pdf_setrgbcolor_stroke</function>. + <function>pdf_setlinewidth</function> affecte à largeur de + ligne la valeur <parameter>width</parameter>. </para> </refsect1> </refentry> - <refentry id="function.pdf-setrgbcolor"> + <refentry id="function.pdf-setmiterlimit"> <refnamediv> - <refname>PDF_setrgbcolor</refname> - <refpurpose>Choisi la couleur rgb comme couleur de dessin et de remplissage.</refpurpose> + <refname>PDF_setmiterlimit</refname> + <refpurpose>Modifie la "miter limit".</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_setrgbcolor</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>red value</parameter></paramdef> - <paramdef>double <parameter>green value</parameter></paramdef> - <paramdef>double <parameter>blue value</parameter></paramdef> + <funcdef>void <function>pdf_setmiterlimit</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>value</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - <function>pdf_setrgbcolor_stroke</function> choisi la couleur rgb comme couleur - de remplissage. - </para> <para> - Voir aussi <function>pdf_setrgbcolor_stroke</function>, - <function>pdf_setrgbcolor_fill</function>. + <function>pdf_setmiterlimit</function> modifie la "miter limit" et + lui affecte la valeur <parameter>value</parameter>, + supérieure à 1. </para> </refsect1> </refentry> - <refentry id="function.pdf-add-outline"> + <refentry id="function.pdf-setoplydash"> <refnamediv> - <refname>PDF_add_outline</refname> - <refpurpose>Ajoute un signet sur la page courante.</refpurpose> + <refname>PDF_setoplydash</refname> + <refpurpose>Modifie les pointillés compliqués</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>pdf_add_outline</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>string <parameter>text</parameter></paramdef> - <paramdef>int <parameter><optional>parent</optional></parameter></paramdef> - <paramdef>int <parameter><optional>open</optional></parameter></paramdef> + <funcdef>void <function>pdf_setoplydash</function></funcdef> + <paramdef>int <parameter>pdf object</parameter></paramdef> + <paramdef>array <parameter>dasharray</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_add_outline</function> ajoute un signet de nom - <parameter>text</parameter> sur la page courante, et au point courant. - Le signet est inséré comme un fils de la page - <parameter>parent</parameter> et est ouvert par défaut si - <parameter>open</parameter> n'est pas 0. La valeur retournée est un - identifiant du signet, qui pourra être réutilisé comme - parent d'autres signets. Vous pouvez ainsi créer des hiérarchies - de signets. + <function>pdf_setoplydash</function> modifie les pointillés + complexes, définit par le tableau <parameter>dasharray</parameter>. </para> - <simpara> - Malheureusement, pdflib ne copie pas la chaîne, ce qui force PHP à - allouer la mémoire. Actuellement, cette mémoire n'est jamais - libérée par une fonction PDF, mais prise en charge par le - gestionnaire PHP. - </simpara> </refsect1> </refentry> - <refentry id="function.pdf-set-transition"> + <refentry id="function.pdf-setrgbcolor"> <refnamediv> - <refname>PDF_set_transition</refname> - <refpurpose>Fixe le mode de transition entre les pages.</refpurpose> + <refname>PDF_setrgbcolor</refname> + <refpurpose>Modifie la couleur rgb comme couleur de dessin et de +remplissage.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_set_transition</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>int <parameter>transition</parameter></paramdef> + <funcdef>void <function>pdf_setrgbcolor</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>red value</parameter></paramdef> + <paramdef>double <parameter>green value</parameter></paramdef> + <paramdef>double <parameter>blue value</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_set_transition</function> Fixe le mode de transition entre les - pages. La valeur de <parameter>transition</parameter> peut être : - <simplelist> - <member> - 0 : aucune transition, - </member> - <member> - 1 : deux lignes en travers de l'écran représente la page, - </member> - <member> - 2 : plusieurs lignes en travers de l'écran représente la page, - </member> - <member> - 3 : une boite représente la page, - </member> - <member> - 4 : une seule ligne en travers de l'écran représente la page, - </member> - <member> - 5 : l'ancienne page se dissout pour revéler la nouvelle, - </member> - <member> - 6 : l'effet page d'un coin à l'autre - </member> - <member> - 7 : l'ancienne page est simplement remplacée par la nouvelle (valeur par défaut) - </member> - </simplelist> + <function>pdf_setrgbcolor_stroke</function> modifie la couleur + <acronym>RGB</acronym> comme couleur de remplissage. </para> <para> - Voir aussi <function>pdf_set_duration</function>.</para> + Voir aussi <function>pdf_setrgbcolor_stroke</function> et + <function>pdf_setrgbcolor_fill</function>. + </para> </refsect1> </refentry> - <refentry id="function.pdf-set-duration"> + <refentry id="function.pdf-setrgbcolor-fill"> <refnamediv> - <refname>PDF_set_duration</refname> - <refpurpose>Choisi la durée de transition entre deux pages.</refpurpose> + <refname>PDF_setrgbcolor_fill</refname> + <refpurpose>Modifie la couleur rgb comme couleur de remplissage.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_set_duration</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>duration</parameter></paramdef> + <funcdef>void <function>pdf_setrgbcolor_fill</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>red value</parameter></paramdef> + <paramdef>double <parameter>green value</parameter></paramdef> + <paramdef>double <parameter>blue value</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_set_duration</function> choisi la durée de transition, - en secondes, entre deux pages. + <function>pdf_setrgbcolor_fill</function> choisi la couleur + <acronym>RGB</acronym> comme couleur de remplissage. </para> <para> - Voir aussi <function>pdf_set_transition</function>. + Voir aussi <function>pdf_setrgbcolor_fill</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-open-gif"> + <refentry id="function.pdf-setrgbcolor-stroke"> <refnamediv> - <refname>PDF_open_gif</refname> - <refpurpose>Ouvre une image GIF.</refpurpose> + <refname>PDF_setrgbcolor_stroke</refname> + <refpurpose>Modifie la couleur rgb comme couleur de dessin.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>pdf_open_gif</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>string <parameter>filename</parameter></paramdef> + <funcdef>void <function>pdf_setrgbcolor_stroke</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>red value</parameter></paramdef> + <paramdef>double <parameter>green value</parameter></paramdef> + <paramdef>double <parameter>blue value</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_open_gif</function> ouvre et charge l'image GIF du fichier - <parameter>filename</parameter>. Le format doit être GIF. La fonction - retourne un identifiant d'image PDF : - <example> - <title>Inclusion d'un image GIF</title> - <programlisting role="php"> -<?php -$im = PDF_open_gif($pdf, "test.gif"); -pdf_place_image($pdf, $im, 100, 100, 1); -pdf_close_image($pdf, $im); -?> - </programlisting> - </example> + <function>pdf_setrgbcolor_stroke</function> choisi la couleur + <acronym>RGB</acronym> comme couleur de dessin. </para> <para> - Voir aussi <function>pdf_close_image</function>, - <function>pdf_open_jpeg</function>, - <function>pdf_open_memory_image</function>, - <function>pdf_execute_image</function>, - <function>pdf_place_image</function>, - <function>pdf_put_image</function>. + Voir aussi <function>pdf_setrgbcolor_fill</function>. </para> </refsect1> - </refentry> - <refentry id="function.pdf-open-png"> - <refnamediv> - <refname>pdf_open_png</refname> - <refpurpose> - Ouvre une image PNG - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int - <function>pdf_open_png</function> - </funcdef> - <paramdef>int - <parameter>pdf</parameter> - </paramdef> - <paramdef>string - <parameter>png_file</parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>pdf_open_png</function> ouvre une image, stockée dans - le fichier <parameter>png_file</parameter>. Le format de cette image - doit être PNG. La fonction retourne un identifiant d'image PNG. - <note> - <simpara> - Cette fonction ne doit plus être utilisée. Utilisez plutôt - <function>pdf_open_image_file</function>. - </simpara> - </note> - <example> - <title>Including a PNG image</title> - <programlisting role="php"> -<?php -$im = pdf_open_png ($pdf, "test.png"); -pdf_place_image ($pdf, $im, 100, 100, 1); -pdf_close_image ($pdf, $im); -?> - </programlisting> - </example> - </para> - <para> - Voir aussi <function>pdf_close_image</function>, - <function>pdf_open_jpeg</function>, - <function>pdf_open_gif</function>, - <function>pdf_open_memory_image</function>, - <function>pdf_execute_image</function>, - <function>pdf_place_image</function>, - <function>pdf_put_image</function>. - </para> - </refsect1> </refentry> - <refentry id="function.pdf-open-image-file"> + <refentry id="function.pdf-set-border-color"> <refnamediv> - <refname>pdf_open_image_file</refname> - <refpurpose>Lit une image dans un fichier</refpurpose> + <refname>pdf_set_border_color</refname> + <refpurpose>Modifie la couleur des liens et annotations</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>pdf_open_image_file</function></funcdef> - <paramdef>int <parameter>PDF-document</parameter></paramdef> - <paramdef>string <parameter>format</parameter></paramdef> - <paramdef>string <parameter>filename</parameter></paramdef> + <funcdef>void <function>pdf_set_border_color</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>red</parameter></paramdef> + <paramdef>double <parameter>green</parameter></paramdef> + <paramdef>double <parameter>blue</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_open_image_file</function> lit une image au format - <parameter>format</parameter> dans le fichier <parameter>filename</parameter>. - Les formats possibles sont 'png', 'tiff', 'jpeg' et 'gif'. - La fonction retourne un identifiant d'image PDF. - <example> - <title>Insertion d'une image dans un fichier PDF</title> - <programlisting role="php"> -<?php -$pim = pdf_open_image_file($pdf, "png", "picture.png"); -pdf_place_image($pdf, $pim, 100, 100, 1); -pdf_close_image($pdf, $pim); -?> - </programlisting> - </example> - </para> + <function>pdf_set_border_color</function> modifie la couleur des + bords de liens et d'annotation. Les trois composants + <parameter>red</parameter>, <parameter>green</parameter>, + <parameter>blue</parameter> représentent une couleur + <acronym>RGB</acronym> (rouge, vert, bleu) et leur valeur doivent + être comprise entre 0 et 1. + </para> <para> - Voir aussi <function>pdf_close_image</function>, - <function>pdf_open_jpeg</function>, - <function>pdf_open_gif</function>, - <function>pdf_open_tiff</function>, - <function>pdf_open_png</function>, - <function>pdf_execute_image</function>, - <function>pdf_place_image</function>, - <function>pdf_put_image</function>. + Voir aussi <function>pdf_set_border_style</function> et + <function>pdf_set_border_dash</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-open-memory-image"> + <refentry id="function.pdf-set-border-dash"> <refnamediv> - <refname>PDF_open_memory_image</refname> - <refpurpose> - Ouvre une image créée par les fonctions images PHP. - </refpurpose> + <refname>pdf_set_border_dash</refname> + <refpurpose>Modifie les pointillés des liens et annotations</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>pdf_open_memory_image</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>int <parameter>image</parameter></paramdef> + <funcdef>void <function>pdf_set_border_dash</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>black</parameter></paramdef> + <paramdef>double <parameter>white</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_open_memory_image</function> prend comme argument une - image créée avec les fonctions PHP, et la rend disponible - pour le document PDF. La fonction retourne un identifiant PDF d'image. - <example> - <title>Inclusion d'une image mémoire</title> - <programlisting role="php"> -<?php -$im = ImageCreate(100, 100); -$col = ImageColorAllocate($im, 80, 45, 190); -ImageFill($im, 10, 10, $col); -$pim = PDF_open_memory_image($pdf, $im); -ImageDestroy($im); -pdf_place_image($pdf, $pim, 100, 100, 1); -pdf_close_image($pdf, $pim); -?> - </programlisting> - </example> - </para> + <function>pdf_set_border_dash</function> modifie la longueur + des pointillés (si le style de bord d'une annotation est en +pointillé). + <parameter>black</parameter> représente la taille des traits + noirs, et <parameter>white</parameter> celle des espaces blancs. + </para> <para> - Voir aussi <function>pdf_close_image</function>, - <function>pdf_open_jpeg</function>, - <function>pdf_open_gif</function>, - <function>pdf_execute_image</function>, - <function>pdf_place_image</function>, - <function>pdf_put_image</function>. + Voir aussi <function>pdf_set_border_style</function>, + <function>pdf_set_border_color</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-open-jpeg"> + <refentry id="function.pdf-set-border-style"> <refnamediv> - <refname>PDF_open_jpeg</refname> - <refpurpose>Ouvre une image JPEG.</refpurpose> + <refname>pdf_set_border_style</refname> + <refpurpose>Modifie le bord des liens et annotations</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>pdf_open_jpeg</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>string <parameter>filename</parameter></paramdef> + <funcdef>void <function>pdf_set_border_style</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>string <parameter>style</parameter></paramdef> + <paramdef>double <parameter>width</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_open_jpeg</function> ouvre et charge l'image JPEG du fichier - <parameter>filename</parameter>. Le format de l'image doit être JPEG. - La fonction retourne un identifiant d'image PDF. - <note> - <simpara> - Cette fonction ne doit plus être utilisée. Utilisez plutôt - <function>pdf_open_image_file</function>. - </simpara> - </note> + <function>pdf_set_border_style</function> modifie le style des + bords de liens et d'annotation. <parameter>style</parameter> peut + valoir 'solid' (trait plain) ou 'dashed'( pointillé). </para> <para> - Voir aussi <function>pdf_close_image</function>, - <function>pdf_open_gif</function>, - <function>pdf_open_memory_image</function>, - <function>pdf_execute_image</function>, - <function>pdf_place_image</function>, - <function>pdf_put_image</function>. + Voir aussi <function>pdf_set_border_color</function>, + <function>pdf_set_border_dash</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-open-tiff"> + <refentry id="function.pdf-set-char-spacing"> <refnamediv> - <refname>pdf_open_tiff</refname> - <refpurpose>Ouvre une image TIFF</refpurpose> + <refname>PDF_set_char_spacing</refname> + <refpurpose>Fixe l'espacement des caractères.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>pdf_open_tiff</function></funcdef> - <paramdef>int <parameter>PDF-document</parameter></paramdef> - <paramdef>string <parameter>filename</parameter></paramdef> + <funcdef>void <function>pdf_set_char_spacing</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>space</parameter></paramdef> </funcprototype> </funcsynopsis> - <simpara> - <function>pdf_open_jpeg</function> ouvre et charge l'image JPEG du fichier - <parameter>filename</parameter>. Le format de l'image doit être JPEG. - La fonction retourne un identifiant d'image PDF. - </simpara> - <note> - <simpara> - Cette fonction ne doit plus être utilisée. Utilisez plutôt - <function>pdf_open_image_file</function>. - </simpara> - </note> <para> - Voir aussi <function>pdf_close_image</function>, - <function>pdf_open_gif</function>, - <function>pdf_open_jpeg</function>, - <function>pdf_open_png</function>, - <function>pdf_open_memory_image</function>, - <function>pdf_execute_image</function>, - <function>pdf_place_image</function>, - <function>pdf_put_image</function>. + <function>pdf_set_char_spacing</function> fixe l'espacement des +caractères. + </para> + <para> + Voir aussi <function>pdf_set_word_spacing</function>, + <function>pdf_set_leading</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-close-image"> + <refentry id="function.pdf-set-duration"> <refnamediv> - <refname>PDF_close_image</refname> - <refpurpose>Ferme une image.</refpurpose> + <refname>PDF_set_duration</refname> + <refpurpose>Choisi la durée de transition entre deux pages.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_close_image</function></funcdef> - <paramdef>int <parameter>image</parameter></paramdef> + <funcdef>void <function>pdf_set_duration</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>duration</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_close_image</function> ferme une image qui a - été ouverte par <function>pdf_open_gif</function> ou - <function>pdf_open_jpeg</function>. + <function>pdf_set_duration</function> choisi la durée de transition, + en secondes, entre deux pages. </para> <para> - Voir aussi <function>pdf_open_jpeg</function>, - <function>pdf_open_gif</function>, - <function>pdf_open_tiff</function>, - <function>pdf_open_memory_image</function>. + Voir aussi <function>pdf_set_transition</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-place-image"> + <refentry id="function.pdf-set-font"> <refnamediv> - <refname>PDF_place_image</refname> - <refpurpose>Place une image dans la page.</refpurpose> + <refname>PDF_set_font</refname> + <refpurpose>Sélectionne la police et sa taille.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_place_image</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>int <parameter>image</parameter></paramdef> - <paramdef>double <parameter>x-coor</parameter></paramdef> - <paramdef>double <parameter>y-coor</parameter></paramdef> - <paramdef>double <parameter>scale</parameter></paramdef> + <funcdef>void <function>pdf_set_font</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>string <parameter>font name</parameter></paramdef> + <paramdef>double <parameter>size</parameter></paramdef> + <paramdef>string <parameter>encoding</parameter></paramdef> + <paramdef>int <parameter><optional>embed</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_place_image</function> place l'image <parameter>image</parameter> - dans la page courante, à la position (<parameter>x-coor</parameter>, - <parameter>x-coor</parameter>). L'image peut changer d'échelle - simultanémement. + <function>pdf_set_font</function> sélectionne la police, + sa taille et son encodage. Il vous faudra fournir des fichiers + Adobe Font Metrics (afm) comme police, dans le dossier de police + (par défaut ./fonts). Si vous utilisez pdflib 0.6, vous devrez + fournir des fichiers Adobe Font Métric (afm-files) pour les + polices, dans le chemin de police ( par défaut, ./fonts). + Si vous utilisez php versin 3 ou une version plus ancienne que la + version 2.20 de pdflib, le quatrième paramètre + <parameter>encoding</parameter> peut prendre les valeurs suivantes : + 0 = builtin, 1 = pdfdoc, 2 = macroman, 3 = macexpert, 4 = winansi. + Un encodage plus grand que 4 et inférieur à 0 sera + transformé en 'winansi'. 'winansi' est souvent un bon choix. + Si vous utilisez PHP version 4 et une version plus ancienne que la + version 2.20 de pdflib le quatrième paramètre + <parameter>encoding</parameter> est une chaîne : + 'builtin', 'pdfdoc', 'macroman', 'macexpert', 'winansi'. Si + le dernier paramètre est à 1, la police est + intégrée dans le document. Sinon, elle ne le sera + pas. Incorporer une police dans un document est un bonne idée + si la police n'est pas répandue, ou si vous ne pouvez pas vous + assurez que le la personne qui regardera votre document peut + accéder à cette police. </para> + <note> + <simpara> + <function>pdf_set_font</function> doit être appelée après + <function>pdf_begin_page</function> pour créer un document PDF valide. + </simpara> + </note> + <note> + <simpara> + Si vous référencez une police dans un fichier .upr, assurez vous +que + le nom du fichier .afm et celui de la police sont bien les mêmes. + Sinon, la police sera aggrandie plusieur fois (Merci à + Paul Haddon pour cette info). + </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.pdf-set-horiz-scaling"> + <refnamediv> + <refname>PDF_set_horiz_scaling</refname> + <refpurpose>Fixe l'echelle horizontale du texte.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pdf_set_horiz_scaling</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>scale</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> - Voir aussi <function>pdf_put_image</function>. + <function>pdf_set_horiz_scaling</function> fixe l'échelle + horizontale du texte, à <parameter>scale</parameter> en + pourcentage. </para> </refsect1> </refentry> - <refentry id="function.pdf-put-image"> + <refentry id="function.pdf-set-info"> <refnamediv> - <refname>PDF_put_image</refname> - <refpurpose> - Enregistre une image dans un fichier PDF pour utilisation ultérieure. - </refpurpose> + <refname>pdf_set_info</refname> + <refpurpose>Remplis les entêtes du document</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_put_image</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>int <parameter>image</parameter></paramdef> + <funcdef>void <function>pdf_set_info</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>string <parameter>fieldname</parameter></paramdef> + <paramdef>string <parameter>value</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_put_image</function> enregistre une image dans un fichier PDF - pour utilisation ultérieure. L'image n'est pas visible. On peut - l'afficher avec la fonction <function>pdf_execute_image</function>, et - aussi souvent que désiré. Cela permet d'utiliser plusieurs - fois la même image, sans augmenter la taille du fichier. - <function>pdf_put_image</function> et <function>pdf_execute_image</function> - est fortement recommandé pour les images de grande taille (plusieurs ko) - si elles sont affichées plus d'une fois dans le document. - <note> - <simpara> - Cette fonction n'a plus de sens avec la version 2.01 de pdflib. - Elle ne fera que retourner une alerte. - </simpara> - </note> + <function>pdf_set_info</function> modifie un champs d'entête + d'un document PDF. Les valeurs possibles pour <parameter>fieldname</parameter> + sont : 'Subject' (sujet), 'Title'(titre), 'Creator'(créateur), + 'Author'(auteur), 'Keywords'(mots-clé) et un autre nom, + défini par l'utilisateur. + <function>pdf_set_info</function> peut être appelée + avant la création d'une page. + <example> + <title>Préparer l'entête d'un document PDF</title> + <programlisting role="php"> +<?php +$fd = fopen("test.pdf", "w"); +$pdfdoc = pdf_open($fd); +pdf_set_info($pdfdoc, "Author", "Uwe Steinmann"); +pdf_set_info($pdfdoc, "Creator", "Uwe Steinmann"); +pdf_set_info($pdfdoc, "Title", "Testing Info Fields"); +pdf_set_info($pdfdoc, "Subject", "Test"); +pdf_set_info($pdfdoc, "Keywords", "Test, Fields"); +pdf_set_info($pdfdoc, "CustomField", "What ever makes sense"); +pdf_begin_page($pdfdoc, 595, 842); +pdf_end_page($pdfdoc); +pdf_close($pdfdoc); +?> + </programlisting> + </example> + </para> + <note> + <simpara> + Cette fonction remplace pdf_set_info_keywords(), + pdf_set_info_title(), + pdf_set_info_subject(), + pdf_set_info_creator(), + pdf_set_info_subject(). + </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.pdf-set-leading"> + <refnamediv> + <refname>PDF_set_leading</refname> + <refpurpose>Obsolète : Modifie la distance entre les lignes du +texte</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para> + Obsolète. </para> <para> - Voir aussi <function>pdf_put_image</function>, - <function>pdf_place_image</function>, - <function>pdf_execute_image</function>. + Voir aussi <function>pdf_set_value</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-execute-image"> + <refentry id="function.pdf-set-parameter"> <refnamediv> - <refname>PDF_execute_image</refname> - <refpurpose>Place une image enregistrée dans la page.</refpurpose> + <refname>PDF_set_parameter</refname> + <refpurpose>Modifie certains paramètres.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_execute_image</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>int <parameter>image</parameter></paramdef> + <funcdef>void <function>pdf_set_parameter</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>string <parameter>name</parameter></paramdef> + <paramdef>string <parameter>value</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_set_parameter</function> modifie certaines valeurs de pdglib. + <parameter>value</parameter> est de type chaîne. + </para> + <para> + Voir aussi <function>pdf_get_value</function>, + <function>pdf_set_value</function>, + <function>pdf_get_parameter</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-set-text-pos"> + <refnamediv> + <refname>PDF_set_text_pos</refname> + <refpurpose>Fixe la position du texte.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pdf_set_text_pos</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> <paramdef>double <parameter>x-coor</parameter></paramdef> <paramdef>double <parameter>y-coor</parameter></paramdef> - <paramdef>double <parameter>scale</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_execute_image</function> affiche une image qui a été - enregistrée dans le document PDF, avec la fonction - <function>pdf_put_image</function>. - L'image est implantée dans la page courante, et aux coordonnées - données. + <function>pdf_set_text_pos</function> modifie la position du texte qui sera + utilisée lors du prochain <function>pdf_show</function>. </para> <para> - L'image peut être modifiée d'échelle en même - temps qu'elle est affichée. Une échelle de 1.0 affichera - l'image à sa taille d'origine. - <note> - <simpara> - Cette fonction n'a plus de sens avec la version 2.01 de pdflib. - Elle ne fera que retourner une alerte. - </simpara> - </note> - <example> - <title>Affichage multiple d'une image.</title> - <programlisting role="php"> -<?php -$im = ImageCreate(100, 100); -$col1 = ImageColorAllocate($im, 80, 45, 190); -ImageFill($im, 10, 10, $col1); -$pim = PDF_open_memory_image($pdf, $im); -pdf_put_image($pdf, $pim); -pdf_execute_image($pdf, $pim, 100, 100, 1); -pdf_execute_image($pdf, $pim, 200, 200, 2); -pdf_close_image($pdf, $pim); -?> - </programlisting> - </example> + Voir aussi <function>pdf_show</function>, + <function>pdf_show_xy</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-add-annotation"> + <refentry id="function.pdf-set-text-rendering"> <refnamediv> - <refname>pdf_add_annotation</refname> - <refpurpose>Ajoute une annotation.</refpurpose> + <refname>PDF_set_text_rendering</refname> + <refpurpose>Determine le rendu du texte.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_add_annotation</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>llx</parameter></paramdef> - <paramdef>double <parameter>lly</parameter></paramdef> - <paramdef>double <parameter>urx</parameter></paramdef> - <paramdef>double <parameter>ury</parameter></paramdef> - <paramdef>string <parameter>title</parameter></paramdef> - <paramdef>string <parameter>content</parameter></paramdef> + <funcdef>void <function>pdf_set_text_rendering</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>int <parameter>mode</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_add_annotation</function> ajoute une note, dont le coin - inférieur droit est (<parameter>llx</parameter>, - <parameter>lly</parameter>) et le coin supérieur droit est - (<parameter>urx</parameter>, <parameter>ury</parameter>). + <function>pdf_set_text_rendering</function> determine le rendu du texte. + Les valeurs possibles pour <parameter>mode</parameter> sont 0=fill text + (texte plein), 1=stroke text (???), 2=fill et stroke text (texte plein + et stroke), 3=invisible, 4=texte plein, et ajouté au chemin, + 5=stroke text, ajouté au chemin, 6=texte plein et stroke, + ajouté au chemin, 7=ajouté au chemin. </para> </refsect1> </refentry> - <refentry id="function.pdf-set-border-style"> + <refentry id="function.pdf-set-transition"> <refnamediv> - <refname>pdf_set_border_style</refname> - <refpurpose>Modifie le bord des liens et annotations</refpurpose> + <refname>pdf_set_text_matrix</refname> + <refpurpose>Obsolète: Modifie la transition des pages</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para> + See <function>pdf_set_parameter</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-set-value"> + <refnamediv> + <refname>pdf_set_value</refname> + <refpurpose>Modifie certains paramètre numériques</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_set_border_style</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>string <parameter>style</parameter></paramdef> + <funcdef>void <function>pdf_set_value</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>string <parameter>name</parameter></paramdef> + <paramdef>double <parameter>value</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_set_value</function> modifie la valeur (numérique) + du paramètre <parameter>name</parameter> de PDFlib. + </para> + <para> + Voir aussi <function>pdf_get_value</function>, + <function>pdf_get_parameter</function>, + <function>pdf_set_parameter</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-set-word-spacing"> + <refnamediv> + <refname>PDF_set_word_spacing</refname> + <refpurpose>Fixe l'espacement des mots.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pdf_set_word_spacing</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>space</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_set_word_spacing</function> modifie l'espacement des mots. + </para> + <para> + Voir aussi <function>pdf_set_char_spacing</function>, + <function>pdf_set_leading</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-show"> + <refnamediv> + <refname>PDF_show</refname> + <refpurpose>Affiche un texte à la position courante.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pdf_show</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>string <parameter>text</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_show</function> affiche le texte <parameter>text</parameter> + avec la position courante, et avec la police courante. + </para> + <para> + Voir aussi <function>pdf_show_xy</function>, + <function>pdf_show_boxed</function>, + <function>pdf_set_text_pos</function>, + <function>pdf_set_font</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-show-boxed"> + <refnamediv> + <refname>PDF_show_boxed</refname> + <refpurpose>Affiche un texte dans un rectangle.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pdf_show_boxed</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>string <parameter>text</parameter></paramdef> + <paramdef>double <parameter>x-coor</parameter></paramdef> + <paramdef>double <parameter>y-coor</parameter></paramdef> <paramdef>double <parameter>width</parameter></paramdef> + <paramdef>double <parameter>height</parameter></paramdef> + <paramdef>string <parameter>mode</parameter></paramdef> + <paramdef>string <parameter><optional>feature</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_set_border_style</function> modifie le style des - bords de liens et d'annotation. <parameter>style</parameter> peut - valoir 'solid' (trait plain) ou 'dashed'( pointillé). + <function>pdf_show_boxed</function> affiche le texte + <parameter>text</parameter> dans un rectangle, dont le coin + inférieur gauche est aux coordonnées + (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>). + Les dimensions du rectangle sont <parameter>height</parameter> et + <parameter>width</parameter>. Le paramètre <parameter>mode</parameter> + indique le type de <parameter>text</parameter>. Si + <parameter>width</parameter> et <parameter>height</parameter> sont + à zéro, le mode <parameter>mode</parameter> + peut être "left" (gauche), "right" (droite) ou "center" + (centré). <parameter>width</parameter> ou <parameter>height</parameter> + sont différents pouvant prendre les valeurs de "justify" + (justification) ou "fulljustify" (justification complète). </para> <para> - Voir aussi <function>pdf_set_border_color</function>, - <function>pdf_set_border_dash</function>. + Si le paramètre <parameter>feature</parameter> vaut "blind", + le texte n'est pas affiché. + </para> + <para> + Retourne le nombre de caractères qui n'ont pas pu être + traités, car ils ne rentraient pas dans le rectangle. + </para> + <para> + Voir aussi <function>pdf_show</function> et <function>pdf_show_xy</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-set-border-color"> + <refentry id="function.pdf-show-xy"> <refnamediv> - <refname>pdf_set_border_color</refname> - <refpurpose>Modifie la couleur des liens et annotations</refpurpose> + <refname>PDF_show_xy</refname> + <refpurpose>Affiche un texte à une position donnée.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_set_border_color</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>red</parameter></paramdef> - <paramdef>double <parameter>green</parameter></paramdef> - <paramdef>double <parameter>blue</parameter></paramdef> + <funcdef>void <function>pdf_show_xy</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>string <parameter>text</parameter></paramdef> + <paramdef>double <parameter>x-coor</parameter></paramdef> + <paramdef>double <parameter>y-coor</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_set_border_color</function> modifie la couleur des - bords de liens et d'annotation. Les trois composants - <parameter>red</parameter>, <parameter>green</parameter>, - <parameter>blue</parameter> représentent une couleur RGB (rouge, - vert, bleu) et leur valeur doit être comprise entre 0.0 et 1.0. + <function>pdf_show_xy</function> affiche le texte + <parameter>text</parameter> à la position donnée + par les coordonnées + (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>). </para> <para> - Voir aussi <function>pdf_set_border_style</function>, - <function>pdf_set_border_dash</function>. + Voir aussi <function>pdf_show</function>, + <function>pdf_show_boxed</function>. </para> </refsect1> </refentry> - <refentry id="function.pdf-set-border-dash"> + <refentry id="function.pdf-skew"> <refnamediv> - <refname>pdf_set_border_dash</refname> - <refpurpose>Modifie les pointillés des liens et annotations</refpurpose> + <refname>PDF_skew</refname> + <refpurpose>Modifie le système de coordonnées.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>pdf_set_border_dash</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>black</parameter></paramdef> - <paramdef>double <parameter>white</parameter></paramdef> + <funcdef>void <function>pdf_skew</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>alpha</parameter></paramdef> + <paramdef>double <parameter>beta</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>pdf_set_border_dash</function> modifie la longueur - des pointillés (si le style de bord d'une annotation est en pointillé). - <parameter>black</parameter> représente la taille des traits - noirs, et <parameter>white</parameter> celle des espaces blancs. + <function>pdf_skew</function> modifie le système de coordonnées, + en faisant une rotation d'angle <parameter>alpha</parameter> pour les (x) et + d'angle <parameter>beta</parameter> pour les (y), en degrés. + <parameter>alpha</parameter> et <parameter>beta</parameter> ne peuvent pas + pendre les valeurs de 90 ou 270 degrés. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-stringwidth"> + <refnamediv> + <refname>PDF_stringwidth</refname> + <refpurpose>Retourne la largeur du texte avec la police courante.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>double <function>pdf_stringwidth</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>string <parameter>text</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_stringwidth</function> retourne la largeur du texte + <parameter>text</parameter> avec la police courante. Il faut qu'une police ait + été choisie auparavant. </para> <para> - Voir aussi <function>pdf_set_border_style</function>, - <function>pdf_set_border_color</function>. + Voir aussi <function>pdf_set_font</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-stroke"> + <refnamediv> + <refname>PDF_stroke</refname> + <refpurpose>Dessine le long du chemin.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pdf_stroke</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_stroke</function> dessine une ligne le long du chemin. Le chemin + courant est la somme de toutes les lignes déssinées. Sans cette + fonction, la ligne de chemin ne sera pas dessinée. + </para> + <para> + Voir aussi <function>pdf_closepath</function>, + <function>pdf_closepath_stroke</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-translate"> + <refnamediv> + <refname>PDF_translate</refname> + <refpurpose>Modifie l'origine du système de +coordonnées.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pdf_translate</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>double <parameter>x-coor</parameter></paramdef> + <paramdef>double <parameter>y-coor</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_translate</function> place l'origine du système de + coordonnées au point (<parameter>x-coor</parameter>, + <parameter>y-coor</parameter>). L'exemple suivant trace une ligne de (0, 0) + à (200, 200) par rapport aux coordonnées initiales. Il faut aussi + désigner le point courant après <function>pdf_translate</function> + et avant de commencer à dessiner les objets. + <example> + <title>Translation</title> + <programlisting role="php"> +<?php PDF_moveto($pdf, 0, 0); +PDF_lineto($pdf, 100, 100); +PDF_stroke($pdf); +PDF_translate($pdf, 100, 100); +PDF_moveto($pdf, 0, 0); +PDF_lineto($pdf, 100, 100); +PDF_stroke($pdf); +?> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-open-memory-image"> + <refnamediv> + <refname>PDF_open_memory_image</refname> + <refpurpose> + Ouvre une image créée par les fonctions images PHP. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pdf_open_memory_image</function></funcdef> + <paramdef>int <parameter>pdf_object</parameter></paramdef> + <paramdef>int <parameter>image</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_open_memory_image</function> prend comme argument une + image créée avec les fonctions PHP, et la rend disponible + pour le document PDF. La fonction retourne un identifiant PDF d'image. + <example> + <title>Inclusion d'une image mémoire</title> + <programlisting role="php"> +<?php +$im = ImageCreate(100, 100); +$col = ImageColorAllocate($im, 80, 45, 190); +ImageFill($im, 10, 10, $col); +$pim = PDF_open_memory_image($pdf, $im); +ImageDestroy($im); +pdf_place_image($pdf, $pim, 100, 100, 1); +pdf_close_image($pdf, $pim); +?> + </programlisting> + </example> + </para> + <para> + Voir aussi <function>pdf_close_image</function>, + <function>pdf_open_jpeg</function>, + <function>pdf_open_gif</function>, + <function>pdf_execute_image</function>, + <function>pdf_place_image</function>, + <function>pdf_put_image</function>. </para> </refsect1> </refentry>