cvs: phpdoc /fr/functions pdf.xml

dams Fri Nov 24 03:06:51 2000 EDT Modified files: /phpdoc/fr/functions pdf.xml Log: Translated all new functions.

Index: phpdoc/fr/functions/pdf.xml diff -u phpdoc/fr/functions/pdf.xml:1.1 phpdoc/fr/functions/pdf.xml:1.2 --- phpdoc/fr/functions/pdf.xml:1.1 Fri Jul 21 03:27:50 2000 +++ phpdoc/fr/functions/pdf.xml Fri Nov 24 03:06:50 2000 @@ -1,2271 +1,2516 @@ - <reference id="ref.pdf"> - <title>Fonctions PDF</title> - <titleabbrev>PDF</titleabbrev> - - <partintro> - - <simpara> - Vous disposez de fonctions PDF en PHP pour cr&eacute;er des fichiers PDF , pour peu que - vous ayez la biblioth&egrave;que PDF de Thomas Merz (disponible &agrave; : - <ulink url="&url.pdf;">&url.pdf;</ulink> (site anglais)). Vous aurez aussi besoin - des librairies <ulink url="&url.jpeg">JPEG library</ulink>, - <ulink url="&url.tiff;">the TIFF library</ulink>, pour compiler cette librairie. - Si vous utilisez pdflib 2.01, v&eacute;rifiez l'installation de la librairie. - Il ne devrait y avoir qu'un fichier (ou lien) : libPDF.so. La version 2.01 - ne fait que cr&eacute;er une librairie appel&eacute;e libpdf2.01.so, qui ne peut &ecirc;tre trouv&eacute;e - lors du link du programme de test, lors de la configuration. Il vous faudra faire - ce lien vous m&ecirc;me, de libPDF.so vers libpdf2.01.so. - </simpara> - <simpara> - La version 2.20 de pdflib a introduit beaucoup de modifications dans ses API pour - supporter les polices chinoises et japonaises. Cela modifie malheureusement les API - du module PHP4 (mais pas le 3). Utilisez pdflib 2.20 qui g&egrave;re correctement la - m&eacute;moire lors de la g&eacute;n&eacute;ration de fichier PDF. Jusqu'&agrave; la publication de la version - 3.0, pdflib peut &ecirc;tre un peu instable. Le param&egrave;tre d'encodage de - <function>pdf_set_font</function> a &eacute;t&eacute; chang&eacute; en cha&icirc;ne. Ainsi, &agrave; la place - de '4', vous devrez utiliser 'winansi'. - </simpara> - <simpara> - Si vous utilisez pdflib 2.30 la fonction <function>pdf_set_text_matrix</function> - a disparu. Elle n'est plus support&eacute;e. En g&eacute;n&eacute;ral, c'est une bonne id&eacute;e de consulter - les notices de publications, pour conna&icirc;tre les modifications qui sont intervenues. - </simpara> - <simpara> - Reportez vous &agrave; l'excellente documentation de pdflib, disponible - avec la distribution de pdflib ou &agrave; : - http://www.ifconnection.de/~tm/software/pdflib/PDFlib-0.6.PDF. - C'est une introduction tr&egrave;s pratique des capacit&eacute;s de pdflib. La plus part des - fonctions de pdflib se retrouvent dans PHP sous le m&ecirc;me nom. De m&ecirc;me, les - param&egrave;tres sont identiques. Vous devez conna&icirc;tre les concepts de base de PDF ou de - Postscript pour utiliser efficacement ce module. Toutes les longueurs et - coordonn&eacute;es sont mesur&eacute;es en points Postscript points. Il y a g&eacute;n&eacute;ralement - 72 points PostScript par pouce, mais cela d&eacute;pend en fait de la r&eacute;solution - d'affichage. - </simpara> - <simpara> - Il y a un autre module PHP pour cr&eacute;er des document PDF, bas&eacute; sur la biblioth&egrave;que - <ulink url="&url.cpdf;">FastIO's</ulink>'s ClibPDF. - Les API sont l&eacute;g&egrave;rement diff&eacute;rentes. Reportez vous &agrave; la section - <link linkend="ref.cpdf">ClibPDF functions</link> pour plus de d&eacute;tails. - </simpara> - <simpara> - Actuellement, toutes les versions de la biblioth&egrave;que pdflib sont support&eacute;es. - Il est pr&eacute;f&eacute;rable d'utiliser la nouvelle version, &eacute;tant donn&eacute; qu'elle comporte - moins de bugs, et propose plus de fonctions que l'ancienne version. Malheureusement, - les modifications dans les API de la biblioth&egrave;que ont &eacute;t&eacute; si importantes que - certaines fonctions PHP ont dues &ecirc;tre modifi&eacute;es. Voici une petite liste des - changements : - </simpara> - <itemizedlist> - <listitem> - <simpara> - La structure Info n'existe plus. Par cons&eacute;quent, - <function>pdf_get_info</function> est obsol&egrave;te et les fonctions - <function>pdf_set_info_creator</function>, <function>pdf_set_info_title</function>, - <function>pdf_set_info_author</function>, <function>pdf_set_info_subject</function> et - <function>pdf_set_info_keywords</function> ne prennent plus de structure info - comme premier param&egrave;tre, mais le document PDF. Cela signifie aussi que le - document PDF doit &ecirc;tre ouvert pour pouvoir appeler ces fonctions. - </simpara> - </listitem> - <listitem> - <simpara> - La mani&egrave;re d'ouvrir un document a chang&eacute;. La fonction - <function>pdf_open</function> ne prend plus qu'un param&egrave;tre, qui est le pointeur - de fichier, obtenu avec la fonction <function>fopen</function>. - </simpara> - </listitem> - </itemizedlist> - - <simpara> - Il y a aussi quelques nouveaut&eacute;s avec la version 2.01 de pdflib qui devrait &ecirc;tre - couvertes par PHP. Quelques fonctions ne sont plus utilis&eacute;es (e.g. - <function>pdf_put_image</function>). Ne soyez pas surpris d'obtenir une alerte... - </simpara> - - <simpara> - Le module PDF introduit deux nouveaux types de variables (avec pdflib 2.x, - seulement un nouveau type) C'est pdfdoc et pdfinfo (pdfinfo n'existe pas avec - pdflib 2.x. pdfdoc est un pointeur de document PDF, et presque toutes les - fonctions en ont besoin comme premier param&egrave;tre. pdfinfo contient des m&eacute;ta - donn&eacute;es &agrave; propos du document PDF document. Il doit exister avant d'appeler - (<parameter>pdfinfo</parameter> n'existe pas si pdflib 2.x est utilis&eacute;. - <parameter>pdfdoc</parameter> est un pointeur sur un document PDF et presque - toutes les fonctions le requi&egrave;re comme premier param&egrave;tre. - <parameter>pdfinfo</parameter> contient des m&eacute;ta-donn&eacute;es sur les documents PDF. - Elles doivent &ecirc;tre fix&eacute;e avant d'utiliser <function>pdf_open</function>. - </simpara> - - <note> - <simpara> - La suite n'est vraie qu'avec pdflib 0.6. Lisez le manuel de pdflib - pour les nouveaut&eacute;s des nouvelles versions. - </simpara> - </note> - <simpara> - Pour sauver des donn&eacute;es dans un fichier PDF, vous devez fournir un fichier de - type afm pour chaque police de caract&egrave;re. Les fichiers Afm contiennent les - d&eacute;finitions des polices Postscript. Par d&eacute;faut, ces fichiers afm sont recherch&eacute; - dans un dossier nomm&eacute; 'fonts', pr&egrave;s du dossier qui contient le script &eacute;x&eacute;cut&eacute;. - (Encore une fois, ceci &eacute;tait vrai avec pdflib 0.6, mais ne le sera pas - n&eacute;cessairement avec les nouvelles versions). - </simpara> - - <simpara> - La plupart des fonctions sont plut&ocirc;t simples &agrave; utiliser. Le plus difficile est - probablement la cr&eacute;ation d'un document PDF simple. Les exemples suivant vous - aideront &agrave; rep&eacute;rer les premiers &eacute;l&eacute;ments. Ils utilisent les fonctions accessibles - avec pdflib 0.6. Ils cr&eacute;ent un exemple de test, test.pdf, d'une seule page. - La page contient le texte "Times-Roman" en police renforc&eacute;e, soulign&eacute;, de 30 pt. - </simpara> - <example> - <title>Creation d'un document PDF avec pdflib 0.6</title> - <programlisting> -&lt;?php -$fp = fopen("test.pdf", "w"); -$info = PDF_get_info(); -pdf_set_info_author($info, "Uwe Steinmann"); -PDF_set_info_title($info, "Test for PHP wrapper of PDFlib 0.6"); -PDF_set_info_author($info, "Name of Author"); -pdf_set_info_creator($info, "See Author"); -pdf_set_info_subject($info, "Testing"); -$pdf = PDF_open($fp, $info); -PDF_begin_page($pdf, 595, 842); -PDF_add_outline($pdf, "Page 1"); -pdf_set_font($pdf, "Times-Roman", 30, 4); -pdf_set_text_rendering($pdf, 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); -echo "&lt;A HREF=getPDF.php3>finished&lt;/A>"; -?> - </programlisting> - </example> - - <para> - - Le script getPDF.php3 ne fait que produire un fichier PDF. - - <informalexample> - <programlisting> -&lt;?php -$fp = fopen("test.pdf", "r"); -header("Content-type: application/pdf"); -fpassthru($fp); -fclose($fp); -?> - </programlisting> - </informalexample> - - La m&ecirc;me chose avec pdflib 2.x ressemble &agrave; ce qui suit : - - <example> - <title>Cr&eacute;ation d'un document PDF avec pdflib 2.x</title> - <programlisting> -&lt;?php -$fp = fopen("test.pdf", "w"); -$pdf = PDF_open($fp); -pdf_set_info_author($pdf, "Uwe Steinmann"); -PDF_set_info_title($pdf, "Test for PHP wrapper of PDFlib 2.0"); -PDF_set_info_author($pdf, "Name of Author"); -pdf_set_info_creator($pdf, "See Author"); -pdf_set_info_subject($pdf, "Testing"); -PDF_begin_page($pdf, 595, 842); -PDF_add_outline($pdf, "Page 1"); -pdf_set_font($pdf, "Times-Roman", 30, 4); -pdf_set_text_rendering($pdf, 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); -echo "&lt;A HREF=getPDF.php3>finished&lt;/A>"; -?> - </programlisting> - <para> - Ce script est identique &agrave; celui ci-dessus.</para> - </example> - - La distribution de pdflib contient d'autres exemples plus &eacute;labor&eacute;s, qui cr&eacute;e - des pages plus consistantes. Cet exemple convertit en PHP, et en utilisant - pdflib 2.x ressemble &agrave; ce qui suit : - (Vous pouvez retrouver cet exemple dans la documentation de - <link linkend="ref.cpdf">clibpdf module)</link>: - - <example> - <title>Exemple pdfclock de la distribution pdflib 2.x</title> - <programlisting> -&lt;?php -$pdffilename = "clock.pdf"; -$radius = 200; -$margin = 20; -$pagecount = 40; - -$fp = fopen($pdffilename, "w"); -$pdf = pdf_open($fp); -pdf_set_info_creator($pdf, "pdf_clock.php3"); -pdf_set_info_author($pdf, "Uwe Steinmann"); -pdf_set_info_title($pdf, "Analog Clock"); - -while($pagecount-- > 0) { - pdf_begin_page($pdf, 2 * ($radius + $margin), 2 * ($radius + $margin)); - - pdf_set_transition($pdf, 4); /* wipe */ - pdf_set_duration($pdf, 0.5); - - pdf_translate($pdf, $radius + $margin, $radius + $margin); - pdf_save($pdf); - pdf_setrgbcolor($pdf, 0.0, 0.0, 1.0); - - /* 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_restore($pdf); - pdf_save($pdf); - - /* 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); - } - - $ltime = getdate(); - - /* Dessine les 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); - - /* 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); -} - -$pdf = pdf_close($pdf); -fclose($fp); -echo "&lt;A HREF=getPDF.php3?filename=".$pdffilename.">finished&lt;/A>"; -?> - </programlisting> - <para> - Le script getPDF.php3 ne fait qu'afficher le fichier PDF. - <programlisting> -&lt;?php -$fp = fopen($filename, "r"); -header("Content-type: application/pdf"); -fpassthru($fp); -fclose($fp); -?> - </programlisting></para> - </example></para> - </partintro> - - <refentry id="function.pdf-get-info"> - <refnamediv> - <refname>PDF_get_info</refname> - <refpurpose>Retourne la structure d'info par d&eacute;faut d'un document PDF.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>info <function>pdf_get_info</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_get_info</function> retourne une structure d'information de document - PDF. Cette structure est la structure par d&eacute;faut. Elle devra &ecirc;tre remplie avec - des informations ad&eacute;quates, telle que l'auteur, le sujet etc.... - - <note> - <simpara> - Cette fonction n'est pas disponible si pdflib 2.x est activ&eacute;e. - </simpara> - </note> - </para> - - <para> - Voir aussi <function>PDF_set_info_creator</function>, - <function>PDF_set_info_author</function>, - <function>PDF_set_info_keywords</function>, - <function>PDF_set_info_title</function>, - <function>PDF_set_info_subject</function>.</para> - </refsect1> - </refentry> - - <refentry id="function.pdf-set-info-creator"> - <refnamediv> - <refname>PDF_set_info_creator</refname> - <refpurpose>Affecte le champs titre de la structure info.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_set_info_creator</function></funcdef> - <paramdef>info <parameter>info</parameter></paramdef> - <paramdef>string <parameter>creator</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_set_info_creator</function> affecte le champs titre de la - structure info d'un document PDF. Cette fonction doit &ecirc;tre appel&eacute;e apr&egrave;s - <function>PDF_get_info</function> et avant <function>PDF_open</function>. - L'appeler apr&egrave;s <function>PDF_open</function> sera sans effet sur le document. - - <note> - <simpara> - Cette fonction ne fait pas partie de PDF library. - </simpara> - </note> - - <note> - <simpara> - Cette fonction prend un autre type de premier param&egrave;tre si pdflib 2.x est activ&eacute;. - Le premier param&egrave;tre doit alors &ecirc;tre un identifiant de document PDF document, - retourn&eacute; par <function>pdf_open</function>. Par cons&eacute;quent, - <function>pdf_open</function> doit avoir &eacute;t&eacute; appel&eacute; avant cette fonction. - </simpara> - </note> - </para> - - <para> - Voir aussi <function>PDF_get_info</function>, - <function>PDF_set_info_keywords</function>, - <function>PDF_set_info_title</function>, - <function>PDF_set_info_subject</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-set-info-title"> - <refnamediv> - <refname>PDF_set_info_title</refname> - <refpurpose>Affecte le champs cr&eacute;ateur de la structure info.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_set_info_title</function></funcdef> - <paramdef>info <parameter>info</parameter></paramdef> - <paramdef>string <parameter>title</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_set_info_title</function> modifie le sujet d'un document PDF. - Cette fonction doit &ecirc;tre appel&eacute;e apr&egrave;s <function>PDF_get_info</function> mais - avant <function>PDF_open</function>. Si vous l'appelez apr&egrave;s - <function>PDF_open</function>, elle n'aura pas d'effet sur le document. - - <note> - <simpara> - Cette fonction ne fait pas partie de PDF library. - </simpara> - </note> - - <note> - <simpara> - Cette fonction prend un autre type de premier param&egrave;tre si pdflib 2.x est activ&eacute;. - Le premier param&egrave;tre doit alors &ecirc;tre un identifiant de document PDF document, - retourn&eacute; par <function>pdf_open</function>. Par cons&eacute;quent, - <function>pdf_open</function> doit avoir &eacute;t&eacute; appel&eacute; avant cette fonction. - </simpara> - </note> - </para> - - <para> - Voir aussi <function>PDF_get_info</function>, - <function>PDF_set_info_creator</function>, - <function>PDF_set_info_author</function>, - <function>PDF_set_info_keywords</function>, - <function>PDF_set_info_subject</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-set-info-subject"> - <refnamediv> - <refname>PDF_set_info_subject</refname> - <refpurpose>Affecte le champs cr&eacute;ateur de la structure info.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_set_info_subject</function></funcdef> - <paramdef>info <parameter>info</parameter></paramdef> - <paramdef>string <parameter>subject</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_set_info_subject</function> modifie le sujet d'un document PDF. - Cette fonction doit &ecirc;tre appel&eacute;e apr&egrave;s <function>PDF_get_info</function> et - avant <function>PDF_open</function>, sinon, elle sera sans effet. - - <note> - <simpara> - Cette fonction ne fait pas partie de PDF library. - </simpara> - </note> - - <note> - <simpara> - Cette fonction prend un autre type de premier param&egrave;tre si pdflib 2.x est activ&eacute;. - Le premier param&egrave;tre doit alors &ecirc;tre un identifiant de document PDF document, - retourn&eacute; par <function>pdf_open</function>. Par cons&eacute;quent, - <function>pdf_open</function> doit avoir &eacute;t&eacute; appel&eacute; avant cette fonction. - </simpara> - </note> - </para> - - <para> - Voir aussi <function>PDF_get_info</function>, - <function>PDF_set_info_creator</function>, - <function>PDF_set_info_author</function>, - <function>PDF_set_info_title</function>, - <function>PDF_set_info_keywords</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-set-info-keywords"> - <refnamediv> - <refname>PDF_set_info_keywords</refname> - <refpurpose>Affecte le champs mots-cl&eacute; de la structure info.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_set_info_keywords</function></funcdef> - <paramdef>info <parameter>info</parameter></paramdef> - <paramdef>string <parameter>keywords</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_set_info_subject</function> affecte le champs mots-cl&eacute; de la - structure d'un document PDF. Cette fonction doit &ecirc;tre appel&eacute;e apr&egrave;s - <function>PDF_get_info</function> et avant <function>PDF_open</function>, - sinon, elle sera sans effet. - - <note> - <simpara> - Cette fonction ne fait pas partie de PDF library. - </simpara> - </note> - - <note> - <simpara> - Cette fonction prend un autre type de premier param&egrave;tre si pdflib 2.x est activ&eacute;. - Le premier param&egrave;tre doit alors &ecirc;tre un identifiant de document PDF document, - retourn&eacute; par <function>pdf_open</function>. Par cons&eacute;quent, - <function>pdf_open</function> doit avoir &eacute;t&eacute; appel&eacute; avant cette fonction. - </simpara> - </note> - </para> - - <para> - Voir aussi <function>PDF_get_info</function>, - <function>PDF_set_info_creator</function>, - <function>PDF_set_info_author</function>, - <function>PDF_set_info_title</function>, - <function>PDF_set_info_subject</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-set-info-author"> - <refnamediv> - <refname>PDF_set_info_author</refname> - <refpurpose>Fills the author field of the info structure.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_set_info_author</function></funcdef> - <paramdef>info <parameter>info</parameter></paramdef> - <paramdef>string <parameter>author</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_set_info_author</function> affecte le champs auteur de la - structure d'un document PDF. Cette fonction doit &ecirc;tre appel&eacute;e apr&egrave;s - <function>PDF_get_info</function> et avant <function>PDF_open</function>, sinon, - elle sera sans effet. - - <note> - <simpara> - Cette fonction ne fait pas partie de PDF library. - </simpara> - </note> - - <note> - <simpara> - Cette fonction prend un autre type de premier param&egrave;tre si pdflib 2.x est activ&eacute;. - Le premier param&egrave;tre doit alors &ecirc;tre un identifiant de document PDF document, - retourn&eacute; par <function>pdf_open</function>. Par cons&eacute;quent, - <function>pdf_open</function> doit avoir &eacute;t&eacute; appel&eacute; avant cette fonction. - </simpara> - </note> - </para> - - <para> - Voir aussi <function>PDF_get_info</function>, - <function>PDF_set_info_creator</function>, - <function>PDF_set_info_keywords</function>, - <function>PDF_set_info_title</function>, - <function>PDF_set_info_subject</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-open"> - <refnamediv> - <refname>PDF_open</refname> - <refpurpose>Ouvre un nouveau document PDF.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>pdf_open</function></funcdef> - <paramdef>int <parameter>file</parameter></paramdef> - <paramdef>int <parameter>info</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_open</function> ouvre un nouveau document PDF. Le fichier - correspondant doit avoir &eacute;t&eacute; ouvert avec <function>fopen</function> et le - pointeur de fichier est pass&eacute; en argument <parameter>file</parameter>. - <parameter>info</parameter> est une structure info cr&eacute;&eacute;e par - <function>pdf_get_info</function>. Cette structure info sera effac&eacute;e &agrave; partir - de cette fonction. - - <note> - <simpara> - Cette fonction ne fait pas partie de PDF library. - </simpara> - </note> - - <note> - <simpara> - Cette fonction prend un autre type de premier param&egrave;tre si pdflib 2.x est activ&eacute;. - Le premier param&egrave;tre doit alors &ecirc;tre un identifiant de document PDF document, - retourn&eacute; par <function>pdf_open</function>. Par cons&eacute;quent, - <function>pdf_open</function> doit avoir &eacute;t&eacute; appel&eacute; avant cette fonction. - </simpara> - </note> - </para> - - <para> - Voir aussi <function>fopen</function>, - <function>PDF_get_info</function>, - <function>PDF_close</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.pdf-close"> - <refnamediv> - <refname>PDF_close</refname> - <refpurpose>Ferme un document PDF.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_close</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_close</function> ferme un document PDF. - - <note><simpara> - A cause de la programmation bugg&eacute;e de pdflib 0.6 fermer un document PDF ferme - aussi le fichier associ&eacute;. Cela ne devrait pas &ecirc;tre le cas, puisque pdflib n'a - pas ouvert le fichier, mais s'attend &agrave; un fichier d&eacute;j&agrave; ouvert, lorsque - <function>PDF_open</function> est appel&eacute;e. Par cons&eacute;quent, il ne devrait pas - fermer le fichier. Afin de r&eacute;soudre de probl&egrave;me, mettez en commentaire la ligne - 190 dans le fichier p_basic.c de pdflib 0.6 jusqu'&agrave; ce qu'une nouvelle version - corrige ce bug. - </simpara></note> - - <note><simpara> - Cette fonction n'a pas besoin de patch avec pdflib, si pdflib 2.0 est activ&eacute;e. - </simpara></note></para> - - <para> - Voir aussi <function>PDF_open</function>, - <function>fclose</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-begin-page"> - <refnamediv> - <refname>PDF_begin_page</refname> - <refpurpose>Commence une nouvelle page.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_begin_page</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>height</parameter></paramdef> - <paramdef>double <parameter>width</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_begin_page</function> commence une nouvelle page avec la - taille <parameter>height</parameter> et la largueur - <parameter>width</parameter>. - </para> - - <para> - Voir aussi <function>PDF_end_page</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-end-page"> - <refnamediv> - <refname>PDF_end_page</refname> - <refpurpose>Termine une page.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_end_page</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_end_page</function> termine une page. Une fois qu'une page a &eacute;t&eacute; - ferm&eacute;e, elle ne peut pas &ecirc;tre modifi&eacute;e. - </para> - - <para> - Voir aussi <function>PDF_begin_page</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-show"> - <refnamediv> - <refname>PDF_show</refname> - <refpurpose>Affiche un texte &agrave; la position courante.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_show</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>string <parameter>text</parameter></paramdef> - </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_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> - <funcdef>void <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> - <paramdef>double <parameter>width</parameter></paramdef> - <paramdef>double <parameter>height</parameter></paramdef> - <paramdef>string <parameter>mode</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_show_boxed</function> affiche le texte <parameter>text</parameter> - dans un rectangle, dont le coin inf&eacute;rieur gauche est aux coordonn&eacute;es - (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>). - Les dimensions du rectangle sont <parameter>height</parameter> et - <parameter>width</parameter>. Le param&egrave;tre <parameter>mode</parameter> indique le - type de <parameter>text</parameter>. Si <parameter>width</parameter> et - <parameter>height</parameter> sont &agrave; z&eacute;ro, le mode <parameter>mode</parameter> - peut &ecirc;tre "left" (gauche), "right" (droite) ou "center"(centr&eacute;). - <parameter>width</parameter> ou <parameter>height</parameter> sont diff&eacute;rents - peuvant prendre les valeurs de "justify" (justification) ou "fulljustify" - (justification compl&egrave;te). - </para> - - <para> - Voir aussi <function>PDF_show</function>, - <function>PDF_show_xy</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-show-xy"> - <refnamediv> - <refname>PDF_show_xy</refname> - <refpurpose>Affiche un texte &agrave; une position donn&eacute;e.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_show_xy</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> - </funcsynopsis> - <para> - <function>PDF_show_xy</function> affiche le texte <parameter>text</parameter> - &agrave; la position donn&eacute;e par les coordonn&eacute;es (<parameter>x-coor</parameter>, - <parameter>y-coor</parameter>). - </para> - - <para> - Voir aussi <function>PDF_show</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-set-font"> - <refnamediv> - <refname>PDF_set_font</refname> - <refpurpose>S&eacute;lectionne la police et sa taille.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <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> - </funcsynopsis> - <para> - <function>PDF_set_font</function> s&eacute;lectionne la police, sa taille et son encodage. - Il vous faudra fournir des fichiers Adobe Font Metrics (afm) comme police, dans le - dossier de polices (par d&eacute;faut ./fonts). Si vous utilisez pdflib 0.6, vous devrez - fournir des fichiers Adobe Font M&eacute;tric (afm-files) pour les polices, dans le - chemin de police ( par d&eacute;faut, ./fonts). Si vous utilisez php versin 3 ou une - version plus ancienne que la version 2.20 de pdflib, le quatri&egrave;me param&egrave;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&eacute;rieur &agrave; 0 sera transform&eacute; 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&egrave;me param&egrave;tre <parameter>encoding</parameter> est une cha&icirc;ne : - 'builtin', 'pdfdoc', 'macroman', 'macexpert', 'winansi'. Si le dernier param&egrave;tre - est &agrave; 1, la police est int&eacute;gr&eacute;e dans le document. Sinon, elle ne le sera pas. - Incorporer une police dans un document est un bonne id&eacute;e si la police n'est pas - r&eacute;pandue, ou si vous ne pouvez pas vous assurez que le la personne qui regardera - votre document peut acc&eacute;der &agrave; cette police. - </para> - - <note> - <simpara> - Cette fonction doit &ecirc;tre appel&eacute;e apr&egrave;s <function>PDF_begin_page</function> - pour cr&eacute;er un document PDF valide. - </simpara> - </note> - - </refsect1> - </refentry> - - <refentry id="function.pdf-set-leading"> - <refnamediv> - <refname>PDF_set_leading</refname> - <refpurpose>Choisi la distance entre les lignes du textes.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_set_leading</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>distance</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_set_leading</function> permet de choisir la distance entre les - lignes du texte. Cette valeur sera utilis&eacute;e si du texte est affich&eacute; par - <function>PDF_continue_text</function>. - </para> - - <para> - Voir aussi <function>PDF_continue_text</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-set-parameter"> - <refnamediv> - <refname>PDF_set_parameter</refname> - <refpurpose>Fixe certains param&egrave;tres.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <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> - </funcsynopsis> - <para> - <function>PDF_set_parameter</function> fixe certaines valeurs de pdglib. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-set-text-rendering"> - <refnamediv> - <refname>PDF_set_text_rendering</refname> - <refpurpose>Determine le rendu du texte.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_set_text_rendering</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>int <parameter>mode</parameter></paramdef> - </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 and stroke text (texte plein et stroke), - 3=invisible, 4=texte plein, et ajout&eacute; au chemin, 5=stroke text, ajout&eacute; au chemin, - 6=texte plein et stroke, ajout&eacute; au chemin, 7=ajout&eacute; au chemin. - </para> - </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> - <funcdef>void <function>pdf_set_horiz_scaling</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>scale</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_set_horiz_scaling</function> fixe l'&eacute;chelle horizontale du texte, - &agrave; <parameter>scale</parameter> en pourcentage. - </para> - </refsect1> - </refentry> - - <refentry id="function.pdf-set-text-rise"> - <refnamediv> - <refname>PDF_set_text_rise</refname> - <refpurpose>Choisi l'&eacute;l&eacute;vation du texte.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_set_text_rise</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>rise</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_set_text_rise</function> fixe l'&eacute;l&eacute;vation du texte &agrave; - <parameter>rise</parameter> points. - </para> - </refsect1> - </refentry> - - <refentry id="function.pdf-set-text-matrix"> - <refnamediv> - <refname>PDF_set_text_matrix</refname> - <refpurpose>Fixe la matrice de texte.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_set_text_matrix</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>array <parameter>matrix</parameter></paramdef> - </funcsynopsis> - <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 &eacute;l&eacute;ments. - </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> - <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> - </funcsynopsis> - <para> - <function>PDF_set_text_pos</function> choisi la position du texte qui sera - utilis&eacute;e lors du prochain <function>pdf_show</function>. - </para> - <para> - Voir aussi <function>PDF_show</function>, - <function>PDF_show_xy</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.pdf-set-char-spacing"> - <refnamediv> - <refname>PDF_set_char_spacing</refname> - <refpurpose>Fixe l'espacement des caract&egrave;res.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_set_char_spacing</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>space</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_set_char_spacing</function> fixe l'espacement des caract&egrave;res. - </para> - <para> - Voir aussi <function>PDF_set_word_spacing</function>, - <function>PDF_set_leading</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> - <funcdef>void <function>pdf_set_word_spacing</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>space</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_set_word_spacing</function> fixe 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-skew"> - <refnamediv> - <refname>PDF_skew</refname> - <refpurpose>Modifie le syst&egrave;me de coordonn&eacute;es.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <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> - </funcsynopsis> - <para> - <function>PDF_skew</function> modifie le syst&egrave;me de coordonn&eacute;es, en faisant - une rotation d'angle <parameter>alpha</parameter> pour les (x) et d'angle - <parameter>beta</parameter> pour les (y), en degr&eacute;s. - <parameter>alpha</parameter> et <parameter>beta</parameter> ne peuvent pas - pendre les valeurs de 90 ou 270 degr&eacute;s. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-continue-text"> - <refnamediv> - <refname>PDF_continue_text</refname> - <refpurpose>Affiche un texte sur une nouvelle ligne.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_continue_text</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>string <parameter>text</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_continue_text</function> affiche le texte - <parameter>text</parameter> sur une nouvelle ligne. La distance entre les - lignes peut &ecirc;tre choisie avec <function>PDF_set_leading</function>. - </para> - - <para> - Voir aussi <function>PDF_show_xy</function>, - <function>PDF_set_leading</function>, - <function>PDF_set_text_pos</function>. - </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> - <funcdef>double <function>pdf_stringwidth</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>string <parameter>text</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_stringwidth</function> retourne la largeur du texte - <parameter>text</parameter> avec la police courante. Il faut qu'une police ait - &eacute;t&eacute; choisie auparavant. - </para> - - <para> - Voir aussi <function>PDF_set_font</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-save"> - <refnamediv> - <refname>PDF_save</refname> - <refpurpose>Enregistre l'environnement courant.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_save</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_save</function> enregistre l'environnement courant. Le fonctionnement - est identique &agrave; la commande postscript gsave. Tr&egrave;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_restore</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-restore"> - <refnamediv> - <refname>PDF_restore</refname> - <refpurpose>Restaure un environnement sauv&eacute;.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_restore</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_restore</function> restaure un environnement sauv&eacute; par - <function>PDF_save</function>. Cela fonctionne de mani&egrave;re identique &agrave; la commande - postscript grestore. Tr&egrave;s pratique lorsque vous vous faire des translations ou des - rotations sans affecter les autres objets. - <example> - <title>Sauver et Restaurer un environnement</title> - <programlisting> -&lt;?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-translate"> - <refnamediv> - <refname>PDF_translate</refname> - <refpurpose>Choisi l'origine du syst&egrave;me de coordonn&eacute;es.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <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> - </funcsynopsis> - <para> - <function>PDF_translate</function> place l'origine du syst&egrave;me de coordonn&eacute;es au - point (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>). L'exemple - suivant trace une ligne de (0, 0) &agrave; (200, 200) par rapport aux coordonn&eacute;es - initiales. Il faut aussi d&eacute;signer le point courant apr&egrave;s - <function>PDF_translate</function> et avant de commencer &agrave; dessiner les objets. - - <example> - <title>Translation</title> - <programlisting> -&lt;?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-scale"> - <refnamediv> - <refname>PDF_scale</refname> - <refpurpose>Choisi l'&eacute;chelle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <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> - </funcsynopsis> - <para> - <function>PDF_scale</function> choisi l'&eacute;chelle dans les deux directions. - L'exemple suivant multiplie l'&eacute;chelle par 72. La ligne suivante sera dessin&eacute;e sur - un pouce (2.54 cm) de large. - - <example> - <title>Mise &agrave; l'&eacute;chelle</title> - <programlisting> -&lt;?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-rotate"> - <refnamediv> - <refname>PDF_rotate</refname> - <refpurpose>Choisi la rotation.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_rotate</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>angle</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_rotate</function> choisi la rotation en degr&eacute;. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-setflat"> - <refnamediv> - <refname>PDF_setflat</refname> - <refpurpose>Fixe la platitude (flatness).</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_setflat</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>value</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_setflat</function> choisi la platitude, et lui affecte une valeur - entre 0 et 100. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-setlinejoin"> - <refnamediv> - <refname>PDF_setlinejoin</refname> - <refpurpose>Choisi le param&egrave;tre linejoin.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_setlinejoin</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>long <parameter>value</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_setlinejoin</function> choisi le param&egrave;tre "linejoin", et lui - affecte une valeur entre 0 et 2. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-setlinecap"> - <refnamediv> - <refname>PDF_setlinecap</refname> - <refpurpose>Choisi le param&egrave;tre linecap.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_setlinecap</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>int <parameter>value</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_setlinecap</function> affecte au param&egrave;tre linecap une valeur entre - 0 et 2. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-setmiterlimit"> - <refnamediv> - <refname>PDF_setmiterlimit</refname> - <refpurpose>Choisi la "miter limit".</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_setmiterlimit</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>value</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_setmiterlimit</function> choisi la "miter limit" et lui affecte - une valeur sup&eacute;rieure &agrave; 1. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-setlinewidth"> - <refnamediv> - <refname>PDF_setlinewidth</refname> - <refpurpose>Choisi la largeur de ligne.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_setlinewidth</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>width</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_setlinewidth</function> affecte &agrave; largeur de ligne la valeur - <parameter>width</parameter>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-setdash"> - <refnamediv> - <refname>PDF_setdash</refname> - <refpurpose>Choisi les caract&egrave;res de remplissage.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <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> - </funcsynopsis> - <para> - <function>PDF_setdash</function> choisi les caract&egrave;res de remplissage, - et affecte <parameter>white</parameter> comme caract&egrave;re invisible, et - <parameter>black</parameter> comme caract&egrave;re de remplissage. Si les deux sont &agrave; - z&eacute;ros, une ligne continue est affich&eacute;e. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-moveto"> - <refnamediv> - <refname>PDF_moveto</refname> - <refpurpose>Choisi le point courant.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <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> - </funcsynopsis> - <para> - <function>PDF_moveto</function> d&eacute;place le point courant &agrave; la position - (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>). - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-curveto"> - <refnamediv> - <refname>PDF_curveto</refname> - <refpurpose>Dessine une courbe.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <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> - </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&ocirc;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>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-lineto"> - <refnamediv> - <refname>PDF_lineto</refname> - <refpurpose>Dessine une ligne.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <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> - </funcsynopsis> - <para> - <function>PDF_lineto</function> dessine une ligne entre le point courant et le - point de coordonn&eacute;es (<parameter>x-coor</parameter>, - <parameter>y-coor</parameter>). - </para> - - <para> - Voir aussi <function>PDF_moveto</function>, - <function>PDF_curveto</function>, - <function>PDF_stroke</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-circle"> - <refnamediv> - <refname>PDF_circle</refname> - <refpurpose>Dessine un cercle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <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> - </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>. - </para> - - <para> - Voir aussi <function>PDF_arc</function>, - <function>PDF_stroke</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-arc"> - <refnamediv> - <refname>PDF_arc</refname> - <refpurpose>Dessine un arc.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_arc</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> - <paramdef>double <parameter>start</parameter></paramdef> - <paramdef>double <parameter>end</parameter></paramdef> - </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 &agrave; l'angle - <parameter>start</parameter> et finissant &agrave; l'angle <parameter>end</parameter>. - </para> - - <para> - Voir aussi <function>PDF_circle</function>, - <function>PDF_stroke</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-rect"> - <refnamediv> - <refname>PDF_rect</refname> - <refpurpose>Dessine un rectangle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_rect</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>width</parameter></paramdef> - <paramdef>double <parameter>height</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_rect</function> dessine un rectangle un rectangle de coin - inf&eacute;rieur gauche de coordonn&eacute;es - (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>). - Sa longueur vaut <parameter>width</parameter>. Et sa largeur - <parameter>height</parameter>. - </para> - - <para> - Voir aussi <function>PDF_stroke</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.pdf-closepath"> - <refnamediv> - <refname>PDF_closepath</refname> - <refpurpose>Ferme et clos le chemin.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_closepath</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_closepath</function> ferme et clos le chemin courant. Cela signifie - qu'une ligne va &ecirc;tre ajout&eacute;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&eacute;marre un - nouveau chemin. - </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> - <funcdef>void <function>pdf_stroke</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_stroke</function> dessine une ligne le long du chemin. Le chemin - courant est la somme de toutes les lignes d&eacute;ssin&eacute;es. Sans cette fonction, la - ligne de chemin ne sera pas dessin&eacute;e. - </para> - - <para> - Voir aussi <function>PDF_closepath</function>, - <function>PDF_closepath_stroke</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-closepath-stroke"> - <refnamediv> - <refname>PDF_closepath_stroke</refname> - <refpurpose>Ferme le chemin et dessine le long du chemin.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_closepath_stroke</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - </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. - </para> - - <para> - Voir aussi <function>PDF_closepath</function>, - <function>PDF_stroke</function>.</para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-fill"> - <refnamediv> - <refname>PDF_fill</refname> - <refpurpose>Remplis le chemin courant.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_fill</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_fill</function> remplis l'int&eacute;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> - - </refsect1> - </refentry> - - <refentry id="function.pdf-fill-stroke"> - <refnamediv> - <refname>PDF_fill_stroke</refname> - <refpurpose>Remplis et dessine le chemin courant.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_fill_stroke</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_fill_stroke</function> remplis l'int&eacute;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>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-closepath-fill-stroke"> - <refnamediv> - <refname>PDF_closepath_fill_stroke</refname> - <refpurpose>Remplis, dessine et ferme le chemin courant.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_closepath_fill_stroke</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - </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>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-endpath"> - <refnamediv> - <refname>PDF_endpath</refname> - <refpurpose>Ferme le chemin courant.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_endpath</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_endpath</function> ferme le chemin courant mais ne le clos pas. - </para> - - <para> - Voir aussi <function>PDF_closepath</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-clip"> - <refnamediv> - <refname>PDF_clip</refname> - <refpurpose>Aligne sur le chemin courant.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_clip</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_clip</function> aligne tous les dessins sur le chemin courant. - </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> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_setgray_fill</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>gray value</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_setgray_fill</function> choisi la couleur grise comme couleur de - remplissage. - </para> - - <para> - Voir aussi <function>PDF_setrgbcolor_fill</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-setgray-stroke"> - <refnamediv> - <refname>PDF_setgray_stroke</refname> - <refpurpose>Fixe la couleur de dessin &agrave; un niveau de gris.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_setgray_stroke</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>gray value</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_setgray_stroke</function> Fixe la couleur de dessin &agrave; un niveau - de gris. - </para> - - <para> - Voir aussi <function>PDF_setrgbcolor_stroke</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-setgray"> - <refnamediv> - <refname>PDF_setgray</refname> - <refpurpose>Choisi la couleur grise comme couleur de remplissage et de dessin.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_setgray</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>gray value</parameter></paramdef> - </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>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-setrgbcolor-fill"> - <refnamediv> - <refname>PDF_setrgbcolor_fill</refname> - <refpurpose>Choisi la couleur rgb comme couleur de remplissage.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <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> - </funcsynopsis> - <para> - <function>PDF_setrgbcolor_fill</function> choisi la couleur rgb comme couleur - de remplissage. - </para> - - <para> - Voir aussi <function>PDF_setrgbcolor_fill</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-setrgbcolor-stroke"> - <refnamediv> - <refname>PDF_setrgbcolor_stroke</refname> - <refpurpose>Choisi la couleur rgb comme couleur de remplissage.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <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> - </funcsynopsis> - <para> - <function>PDF_setrgbcolor_stroke</function> choisi la couleur rgb comme couleur - de remplissage. - </para> - - <para> - Voir aussi <function>PDF_setrgbcolor_stroke</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-setrgbcolor"> - <refnamediv> - <refname>PDF_setrgbcolor</refname> - <refpurpose>Choisi la couleur rgb comme couleur de dessin et de remplissage.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <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> - </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>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-add-outline"> - <refnamediv> - <refname>PDF_add_outline</refname> - <refpurpose>Ajoute un signet sur la page courante.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <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> - </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&eacute;r&eacute; comme un fils de la page <parameter>parent</parameter> et - est ouvert par d&eacute;faut si <parameter>open</parameter> n'est pas 0. La valeur - retourn&eacute;e est un identifiant du signet, qui pourra &ecirc;tre r&eacute;utilis&eacute; comme parent - d'autres signets. Vous pouvez ainsi cr&eacute;er des hi&eacute;rarchies de signets. - </para> - <simpara> - Malheureusement, pdflib ne copie pas la cha&icirc;ne, ce qui force PHP &agrave; allouer la - m&eacute;moire. Actuellement, cette m&eacute;moire n'est jamais lib&eacute;r&eacute;e par une fonction PDF, - mais prise en charge par le gestionnaire PHP. - </simpara> - - </refsect1> - </refentry> - - <refentry id="function.pdf-set-transition"> - <refnamediv> - <refname>PDF_set_transition</refname> - <refpurpose>Fixe le mode de transition entre les pages.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_set_transition</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>int <parameter>transition</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_set_transition</function> Fixe le mode de transition entre les - pages. La valeur de <parameter>transition</parameter> peut &ecirc;tre : - - <simplelist> - <member> - 0 : aucune transition, - </member> - <member> - 1 : deux lignes en travers de l'&eacute;cran repr&eacute;sente la page, - </member> - <member> - 2 : plusieurs lignes en travers de l'&eacute;cran repr&eacute;sente la page, - </member> - <member> - 3 : une boite repr&eacute;sente la page, - </member> - <member> - 4 : une seule ligne en travers de l'&eacute;cran repr&eacute;sente la page, - </member> - <member> - 5 : l'ancienne page se dissout pour rev&eacute;ler la nouvelle, - </member> - <member> - 6 : l'effet page d'un coin &agrave; l'autre - </member> - <member> - 7 : l'ancienne page est simplement remplac&eacute;e par la nouvelle (valeur par d&eacute;faut) - </member> - </simplelist></para> - <para> - Voir aussi <function>PDF_set_duration</function>.</para> - </refsect1> - </refentry> - - <refentry id="function.pdf-set-duration"> - <refnamediv> - <refname>PDF_set_duration</refname> - <refpurpose>Choisi la dur&eacute;e de transition entre deux pages.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_set_duration</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>double <parameter>duration</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_set_duration</function> choisi la dur&eacute;e de transition, en secondes, - entre deux pages. - </para> - <para> - Voir aussi <function>PDF_set_transition</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.pdf-open-gif"> - <refnamediv> - <refname>PDF_open_gif</refname> - <refpurpose>Ouvre une image GIF.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>pdf_open_gif</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_open_gif</function> ouvre et charge l'image GIF du fichier - <parameter>filename</parameter>. Le format doit &ecirc;tre GIF. La fonction retourne un - identifiant d'image PDF : - - <example> - <title>Inclusion d'un image GIF</title> - <programlisting> -&lt;?php -$im = PDF_open_gif($pdf, "test.gif"); -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_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-memory-image"> - <refnamediv> - <refname>PDF_open_memory_image</refname> - <refpurpose>Ouvre une image cr&eacute;&eacute;e par les fonctions images PHP.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>pdf_open_memory_image</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>int <parameter>image</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_open_memory_image</function> prend comme argument une image cr&eacute;&eacute;e - avec les fonctions PHP, et la rend disponible opur le document PDF. La fonction - retourne un identifiant PDF d'image. - - <example> - <title>Inclusion d'une image m&eacute;moire</title> - <programlisting> -&lt;?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> - - <refentry id="function.pdf-open-jpeg"> - <refnamediv> - <refname>PDF_open_jpeg</refname> - <refpurpose>Ouvre une image JPEG.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>pdf_open_jpeg</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_open_jpeg</function> ouvre et charge l'image JPEG du fichier - <parameter>filename</parameter>. - Le format de l'image doit &ecirc;tre JPEG. La fonction retourne un identifiant d'image - PDF. - </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>. - </para> - </refsect1> - </refentry> - - <refentry id="function.pdf-close-image"> - <refnamediv> - <refname>PDF_close_image</refname> - <refpurpose>Ferme une image.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_close_image</function></funcdef> - <paramdef>int <parameter>image</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_close_image</function> ferme une image qui a &eacute;t&eacute; ouverte par - <function>PDF_open_gif</function> ou <function>PDF_open_jpeg</function>. - </para> - <para> - Voir aussi <function>PDF_open_jpeg</function>, - <function>PDF_open_gif</function>, - <function>PDF_open_memory_image</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.pdf-place-image"> - <refnamediv> - <refname>PDF_place_image</refname> - <refpurpose>Place une image dans la page.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <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> - </funcsynopsis> - <para> - <function>PDF_place_image</function> place l'image <parameter>image</parameter> - dans la page courante, &agrave; la position (<parameter>x-coor</parameter>, - <parameter>x-coor</parameter>). L'image peut changer d'&eacute;chelle simultan&eacute;mement. - </para> - <para> - Voir aussi <function>PDF_put_image</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.pdf-put-image"> - <refnamediv> - <refname>PDF_put_image</refname> - <refpurpose> - Enregistre une image dans un fichier PDF pour utilisation ult&eacute;rieure. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_put_image</function></funcdef> - <paramdef>int <parameter>pdf document</parameter></paramdef> - <paramdef>int <parameter>image</parameter></paramdef> - </funcsynopsis> - <para> - <function>PDF_put_image</function> enregistre une image dans un fichier PDF pour - utilisation ult&eacute;rieure. L'image n'est pas visible. On peut l'afficher avec la - fonction <function>PDF_execute_image</function>, et aussi souvent que d&eacute;sir&eacute;. Cela - permet d'utiliser plusieurs fois la m&ecirc;me image, sans augmenter la taille du - fichier. <function>PDF_put_image</function> et - <function>PDF_execute_image</function> est fortement recommand&eacute; pour les images - de grande taille (plusieurs ko) si elles sont affich&eacute;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> - </para> - <para> - Voir aussi <function>PDF_put_image</function>, - <function>PDF_place_image</function>, - <function>PDF_execute_image</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.pdf-execute-image"> - <refnamediv> - <refname>PDF_execute_image</refname> - <refpurpose>Place une image enregistr&eacute;e dans la page.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>pdf_execute_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> - </funcsynopsis> - <para> - <function>PDF_execute_image</function> affiche une image qui a &eacute;t&eacute; enregistr&eacute;e - dans le document PDF, avec la fonction <function>PDF_put_image</function>. - L'image est implant&eacute;e dans la page courante, et aux coordonn&eacute;es donn&eacute;es. - </para> - <para> - L'image peut &ecirc;tre chang&eacute;e d'&eacute;chelle en m&ecirc;me temps qu'elle est affich&eacute;e. Une - &eacute;chelle de 1.0 affichera l'image &agrave; 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> -&lt;?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></para> - - </refsect1> - </refentry> - - <refentry id="function.pdf-add-annotation"> - <refnamediv> - <refname>pdf_add_annotation</refname> - <refpurpose>Ajoute une annotation.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <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> - </funcsynopsis> - <para> - <function>pdf_add_annotation</function> ajoute une note, dont le coin - inf&eacute;rieur droit est (<parameter>llx</parameter>, <parameter>lly</parameter>) - et le coin sup&eacute;rieur droit est - (<parameter>urx</parameter>, <parameter>ury</parameter>). - </para> - - </refsect1> - </refentry> - - </reference> - -<!-- Keep this comment at the end of the file -Local variables: -mode: sgml -sgml-omittag:t -sgml-shorttag:t -sgml-minimize-attributes:nil -sgml-always-quote-attributes:t -sgml-indent-step:1 -sgml-indent-data:t -sgml-parent-document:nil -sgml-default-dtd-file:"../../manual.ced" -sgml-exposed-tags:nil -sgml-local-catalogs:nil -sgml-local-ecat-files:nil -End: ---> + <reference id="ref.pdf"> + <title>Fonctions PDF</title> + <titleabbrev>PDF</titleabbrev> + <partintro> + <simpara> + Vous disposez de fonctions PDF en PHP pour cr&eacute;er des + fichiers PDF, pour peu que vous ayez la biblioth&egrave;que PDF + de Thomas Merz (disponible &agrave; : + <ulink url="&url.pdf;">&url.pdf;</ulink> (site anglais)). Vous aurez + aussi besoin des librairies <ulink url="&url.jpeg">JPEG library</ulink>, + <ulink url="&url.tiff;">the TIFF library</ulink>, pour compiler cette + librairie. Ces deux librairies posent pas mal de probl&egrave;mes lors + de la configuration. Suivez attentivement les messages d'erreur. + </simpara> + <simpara> + Reportez vous &agrave; l'excellente documentation de pdflib, disponible + avec la distribution de pdflib. C'est une introduction tr&egrave;s + pratique des capacit&eacute;s de pdflib. La plus part des fonctions + de pdflib se retrouvent dans PHP sous le m&ecirc;me nom. De m&ecirc;me, les + param&egrave;tres sont identiques. Vous devez conna&icirc;tre les concepts + de base de PDF ou de Postscript pour utiliser efficacement ce module. + Toutes les longueurs et coordonn&eacute;es sont mesur&eacute;es en + points Postscript points. Il y a g&eacute;n&eacute;ralement + 72 points PostScript par pouce, mais cela d&eacute;pend en + fait de la r&eacute;solution d'affichage. + </simpara> + <simpara> + Il y a un autre module PHP pour cr&eacute;er des document PDF, + bas&eacute; sur la biblioth&egrave;que + <ulink url="&url.cpdf;">FastIO's</ulink>'s ClibPDF. + Les API sont l&eacute;g&egrave;rement diff&eacute;rentes. + Reportez vous &agrave; la section <link linkend="ref.cpdf">fonctions ClipPDF</link> + pour plus de d&eacute;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&egrave;tre. + </simpara> + <sect1 id="pdf.oldlibs.confusion"> + <title>Confusion entre les vieilles version de pdflib</title> + <simpara> + Depuis le d&eacute;but du support de PDF sous PHP, ( commen&ccedil;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 &eacute;t&eacute; suivies par PHP, + et parfois m&ecirc;me au prix de modifications des API PHP. Depuis la version + 3.x, ces API semblent s'&ecirc;tre stabilis&eacute;es, et PHP 4 a adopt&eacute;e cette + version comme le minimum n&eacute;cessaire pour supporter PDF. En cons&eacute;quence + de quoi, un grand nombre de fonction vont dispara&icirc;tre, ou &ecirc;tre + remplac&eacute;e. Le support de pdflib 0.6 est compl&eacute;tement abandonn&eacute;. + La liste suivante indique quelles sont les fonctions obsol&egrave;te + dans PHP 4.02, et qui devraient &ecirc;tre remplac&eacute;es par de nouvelles versions. + </simpara> + <para> + <table> + <title>Fonctions obsol&egrave;tes et leur remplacements</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Anciennes fonctions</entry> + <entry>Nouvelles fonctions</entry> + </row> + </thead> + <tbody> + <row> + <entry><function>pdf_put_image</function></entry> + <entry>D&eacute;sormais inutile</entry> + </row> + <row> + <entry><function>pdf_get_font</function></entry> + <entry><function>pdf_get_value</function> avec + <literal>"font"</literal> comme second param&egrave;tre.</entry> + </row> + <row> + <entry><function>pdf_get_fontsize</function></entry> + <entry><function>pdf_get_value</function> avec + <literal>"fontsize"</literal> comme second param&egrave;tre.</entry> + </row> + <row> + <entry><function>pdf_get_fontname</function></entry> + <entry><function>pdf_get_parameter</function> avec + <literal>"fontname"</literal> comme second param&egrave;tre.</entry> + </row> + <row> + <entry><function>pdf_set_info_creator</function></entry> + <entry><function>pdf_set_info</function> avec + <literal>"Creator"</literal> comme second param&egrave;tre.</entry> + </row> + <row> + <entry><function>pdf_set_info_title</function></entry> + <entry><function>pdf_set_info</function> avec + <literal>"Title"</literal> comme second param&egrave;tre.</entry> + </row> + <row> + <entry><function>pdf_set_info_subject</function></entry> + <entry><function>pdf_set_info</function> avec + <literal>"Subject"</literal> comme second param&egrave;tre.</entry> + </row> + <row> + <entry><function>pdf_set_info_author</function></entry> + <entry><function>pdf_set_info</function> avec + <literal>"Author"</literal> comme second param&egrave;tre.</entry> + </row> + <row> + <entry><function>pdf_set_info_keywords</function></entry> + <entry><function>pdf_set_info</function> avec + <literal>"Keywords"</literal> comme second param&egrave;tre.</entry> + </row> + <row> + <entry><function>pdf_set_leading</function></entry> + <entry><function>pdf_set_value</function> avec + <literal>"leading"</literal> comme second param&egrave;tre.</entry> + </row> + <row> + <entry><function>pdf_set_text_rendering</function></entry> + <entry><function>pdf_set_value</function> avec + <literal>"textrendering"</literal> comme second param&egrave;tre.</entry> + </row> + <row> + <entry><function>pdf_set_text_rise</function></entry> + <entry><function>pdf_set_value</function> avec + <literal>"textrise"</literal> comme second param&egrave;tre.</entry> + </row> + <row> + <entry><function>pdf_set_horiz_scaling</function></entry> + <entry><function>pdf_set_value</function> avec + <literal>"horizscaling"</literal> comme second param&egrave;tre.</entry> + </row> + <row> + <entry><function>pdf_set_text_matrix</function></entry> + <entry>D&eacute;sormais inutile</entry> + </row> + <row> + <entry><function>pdf_set_char_spacing</function></entry> + <entry><function>pdf_set_value</function> avec + <literal>"charspacing"</literal> comme second param&egrave;tre.</entry> + </row> + <row> + <entry><function>pdf_set_word_spacing</function></entry> + <entry><function>pdf_set_value</function> avec + <literal>"wordspacing"</literal> comme second param&egrave;tre.</entry> + </row> + <row> + <entry><function>pdf_set_transition</function></entry> + <entry><function>pdf_set_parameter</function> avec + <literal>"transition"</literal> comme second param&egrave;tre.</entry> + </row> + <row> + <entry><function>pdf_set_duration</function></entry> + <entry><function>pdf_set_value</function> avec + <literal>"duration"</literal> comme second param&egrave;tre.</entry> + </row> + <row> + <entry><function>pdf_open_gif</function></entry> + <entry><function>pdf_open_image_file</function> avec + <literal>"gif"</literal> comme second param&egrave;tre.</entry> + </row> + <row> + <entry><function>pdf_open_jpeg</function></entry> + <entry><function>pdf_open_image_file</function> avec + <literal>"jpeg"</literal> comme second param&egrave;tre.</entry> + </row> + <row> + <entry><function>pdf_open_tiff</function></entry> + <entry><function>pdf_open_image_file</function> avec + <literal>"tiff"</literal> comme second param&egrave;tre.</entry> + </row> + <row> + <entry><function>pdf_open_png</function></entry> + <entry><function>pdf_open_image_file</function> avec + <literal>"png"</literal> comme second param&egrave;tre.</entry> + </row> + <row> + <entry><function>pdf_get_imagewidth</function></entry> + <entry><function>pdf_get_value</function> avec + <literal>"imagewidth"</literal> comme second param&egrave;tre et + l'image comme troisi&egrave;me.</entry> + </row> + <row> + <entry><function>pdf_get_imageheight</function></entry> + <entry><function>pdf_get_value</function> avec + <literal>"imageheight"</literal> comme second param&egrave;tre et + l'image comme troisi&egrave;me.</entry> + </row> + <row> + <entry><function></function></entry> + <entry><function></function></entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </sect1> + <sect1 id="pdf.install.pdflib"> + <title>Conseils pour installer pdflib 3.x</title> + <simpara> + Depuis la version 3.0 de pdflib vous pouvez configurer cette librairie + avec l'option <literal>--enable-shared-pdflib</literal>. + </simpara> + </sect1> + <sect1 id="pdf.oldlibs.hints"> + <title>Installation des anciennes versions de pdflib</title> + <simpara> + Si vous utilisez pdflib 2.01 v&eacute;rifiez comment votre librairie a &eacute;t&eacute; + install&eacute;e. Il doit y avoir un fichier (ou un lien) vers libpdf.so. + La version 2.01 ne fait que cr&eacute;er une librairie avec le nom + libpdf2.01.so qui ne peut &ecirc;tre trouv&eacute; lors de la compilation du + programme de configuration. Vous devez cr&eacute;er vous m&ecirc;me ce lien + symbolique de libpdf.so vers libpdf2.01.so.. + </simpara> + <simpara> + La version 2.20 de pdflib a introduit de nombreuses modifications dans ses + API, ainsi que le support des polices chinoises et japonaises. Cela + impliquent malheureusement des modifications dans le module PDF de + PHP 4 (mais pas de PHP 3). Si vous utilisez pdflib 2.20, + g&eacute;rer correctement votre m&eacute;moire. Jusqu'&agrave; la version 3.0, pdflib + peut se r&eacute;v&eacute;ler tr&egrave;s instable. Le param&egrave;tre d'encodage + <function>pdf_set_font</function> est devenu une cha&icirc;ne. Cela + signifique notamment qu'il faut remplacer 4 par 'winansi'. + </simpara> + <simpara> + Si vous utilisez pdflib 2.30, <function>pdf_set_text_matrix</function> + a disparu. Elle n'est plus support&eacute;. En g&eacute;n&eacute;ral, il est recommand&eacute; + de consulter les notes de version de la pdflib pour lister toutes les + modifications. + </simpara> + <simpara> + A partir du 9 mars 2000, PHP 4 ne supporte plus que la + version 3.0 et plus r&eacute;cente de pdflib. PHP 3, par contre, ne doit pas + &ecirc;tre utilis&eacute; avec des versions plus r&eacute;centes que la 2.01. + </simpara> + </sect1> + <sect1 id="pdf.examples"> + <title>Examples</title> + <simpara> + La plus part des fonctions sont simples d'emploi.Le plus difficile + est probablement de cr&eacute;er un fichier PDF simple. L'exemple suivant + devrait vous mettre sur les rails. + Il cr&eacute;e un fichier <filename>test.pdf</filename> d'une page. + La page contient du texte "Times Roman outlined", de taille de 30pt. + Le texte est aussi soulign&eacute;. + </simpara> + <para> + <example> + <title>Cr&eacute;ation d'un document PDF avec pdflib</title> + <programlisting> +&lt;?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); +echo "&lt;A HREF=getpdf.php>finished&lt;/A>"; +?> + </programlisting> + <simpara> + Ce script <filename>getpdf.php</filename> retourne simplement le document PDF. + </simpara> + <informalexample> + <programlisting> +&lt;?php +$fp = fopen("test.pdf", "r"); +header("Content-type: application/pdf"); +fpassthru($fp); +fclose($fp); +?> + </programlisting> + </informalexample> + </example> + </para> + <para> + La distribution pdflib contient un exemple plus complexe, + qui cr&eacute;e des pages plus &eacute;labor&eacute;es, avec une horloge. Cet exemple + a &eacute;t&eacute; converti en script PHP (vous retrouverez cet exemple + dans le module <link linkend="ref.cpdf">clibpdf</link>) : + </para> + <para> + <example> + <title>Exemple pdfclock issue de la distribution pdflib</title> + <programlisting> +&lt;?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); + for ($alpha = 0; $alpha &lt; 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_restore($pdf); + pdf_save($pdf); + /* 5 minute strokes */ + pdf_setlinewidth($pdf, 3.0); + for ($alpha = 0; $alpha &lt; 360; $alpha += 30) { + 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); +} +$pdf = pdf_close($pdf); +fclose($fp); +echo "&lt;A HREF=getpdf.php?filename=".$pdffilename.">finished&lt;/A>"; +?> + </programlisting> + <simpara> + Ce script <filename>getpdf.php</filename> ne fait que retourner un document PDF. + </simpara> + <programlisting> +&lt;?php +$fp = fopen($filename, "r"); +header("Content-type: application/pdf"); +fpassthru($fp); +fclose($fp); +?> + </programlisting> + </example></para> + </sect1> + </partintro> + <refentry id="function.pdf-set-info"> + <refnamediv> + <refname>pdf_set_info</refname> + <refpurpose>Remplis les ent&ecirc;tes du document</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_set_info</function> modifie un champs d'ent&ecirc;te + d'un document PDF. Les valeurs possibles pour <parameter>fieldname</parameter> + sont : 'Subject' (sujet), 'Title'(titre), 'Creator'(cr&eacute;ateur), + 'Author'(auteur), 'Keywords'(mots-cl&eacute;) et un autre nom, d&eacute;fini par l + l'utilisateur. + Cette fonction peut &ecirc;tre appel&eacute;e avant la cr&eacute;ation d'une page. + <example> + <title>Pr&eacute;parer l'ent&ecirc;te d'un document PDF</title> + <programlisting> +&lt;?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 <function>pdf_set_info_keywords</function>, + <function>pdf_set_info_title</function>, + <function>pdf_set_info_subject</function>, + <function>pdf_set_info_creator</function>, + <function>pdf_set_info_sybject</function>. + </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.pdf-open"> + <refnamediv> + <refname>PDF_open</refname> + <refpurpose>Ouvre un nouveau document PDF.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pdf_open</function></funcdef> + <paramdef>int <parameter>file</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_open</function> ouvre un nouveau document PDF. Le + fichier correspondant doit avoir &eacute;t&eacute; ouvert avec + <function>fopen</function> et le pointeur de fichier est + pass&eacute; en argument <parameter>file</parameter>. + <parameter>info</parameter> est une structure info cr&eacute;&eacute;e + par <function>pdf_get_info</function>. Cette structure info sera + effac&eacute;e &agrave; partir de cette fonction. + </para> + <note> + <simpara> + La valeur retourn&eacute;e est utilis&eacute;e par toutes les autres fonctions + PDF comme premier argument. + </simpara> + </note> + <para> + Voir aussi <function>fopen</function>, + <function>pdf_close</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-close"> + <refnamediv> + <refname>PDF_close</refname> + <refpurpose>Ferme un document PDF.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pdf_close</function></funcdef> + <paramdef>int <parameter>pdf document</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_close</function> ferme un document PDF. + </para> + <para> + Voir aussi <function>pdf_open</function>, + <function>fclose</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-begin-page"> + <refnamediv> + <refname>PDF_begin_page</refname> + <refpurpose>Commence une nouvelle page.</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> + </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&eacute;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_end_page</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-end-page"> + <refnamediv> + <refname>PDF_end_page</refname> + <refpurpose>Termine une page.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pdf_end_page</function></funcdef> + <paramdef>int <parameter>pdf document</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_end_page</function> termine une page. Une fois + qu'une page a &eacute;t&eacute; ferm&eacute;e, elle ne peut pas + &ecirc;tre modifi&eacute;e. + </para> + <para> + Voir aussi <function>pdf_begin_page</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-show"> + <refnamediv> + <refname>PDF_show</refname> + <refpurpose>Affiche un texte &agrave; la position 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> + </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 document</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_show_boxed</function> affiche le texte + <parameter>text</parameter> dans un rectangle, dont le coin + inf&eacute;rieur gauche est aux coordonn&eacute;es + (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>). + Les dimensions du rectangle sont <parameter>height</parameter> et + <parameter>width</parameter>. Le param&egrave;tre <parameter>mode</parameter> + indique le type de <parameter>text</parameter>. Si + <parameter>width</parameter> et <parameter>height</parameter> sont + &agrave; z&eacute;ro, le mode <parameter>mode</parameter> + peut &ecirc;tre "left" (gauche), "right" (droite) ou "center" + (centr&eacute;). <parameter>width</parameter> ou <parameter>height</parameter> + sont diff&eacute;rents pouvant prendre les valeurs de "justify" + (justification) ou "fulljustify" (justification compl&egrave;te). + </para> + <para> + Si le param&egrave;tre <parameter>feature</parameter> vaut "blind", + le texte n'est pas affich&eacute;. + </para> + <para> + Retourne le nombre de caract&egrave;res qui n'ont pas pu &ecirc;tre + trait&eacute;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-show-xy"> + <refnamediv> + <refname>PDF_show_xy</refname> + <refpurpose>Affiche un texte &agrave; une position donn&eacute;e.</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> + <paramdef>double <parameter>x-coor</parameter></paramdef> + <paramdef>double <parameter>y-coor</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_show_xy</function> affiche le texte + <parameter>text</parameter> &agrave; la position donn&eacute;e + par les coordonn&eacute;es + (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>). + </para> + <para> + Voir aussi <function>pdf_show</function>, + <function>pdf_show_boxed</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-set-font"> + <refnamediv> + <refname>PDF_set_font</refname> + <refpurpose>S&eacute;lectionne la police et sa taille.</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_set_font</function> s&eacute;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&eacute;faut ./fonts). Si vous utilisez pdflib 0.6, vous devrez + fournir des fichiers Adobe Font M&eacute;tric (afm-files) pour les + polices, dans le chemin de police ( par d&eacute;faut, ./fonts). + Si vous utilisez php versin 3 ou une version plus ancienne que la + version 2.20 de pdflib, le quatri&egrave;me param&egrave;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&eacute;rieur &agrave; 0 sera + transform&eacute; 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&egrave;me param&egrave;tre + <parameter>encoding</parameter> est une cha&icirc;ne : + 'builtin', 'pdfdoc', 'macroman', 'macexpert', 'winansi'. Si + le dernier param&egrave;tre est &agrave; 1, la police est + int&eacute;gr&eacute;e dans le document. Sinon, elle ne le sera + pas. Incorporer une police dans un document est un bonne id&eacute;e + si la police n'est pas r&eacute;pandue, ou si vous ne pouvez pas vous + assurez que le la personne qui regardera votre document peut + acc&eacute;der &agrave; cette police. + </para> + <note> + <simpara> + <function>pdf_set_font</function> doit &ecirc;tre appel&eacute;e apr&egrave;s + <function>pdf_begin_page</function> pour cr&eacute;er un document PDF valide. + </simpara> + </note> + <note> + <simpara> + Si vous r&eacute;f&eacute;rencez une police dans un fichier .upr, assurez vous que + le nom du fichier .afm et celui de la police sont bien les m&ecirc;mes. + Sinon, la police sera aggrandie plusieur fois (Merci &agrave; + Paul Haddon pour cette info). + </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.pdf-set-leading"> + <refnamediv> + <refname>PDF_set_leading</refname> + <refpurpose>Modifie la distance entre les lignes du textes.</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_set_leading</function> permet de choisir la distance + entre les lignes du texte. Cette valeur sera utilis&eacute;e si + du texte est affich&eacute; par <function>pdf_continue_text</function>. + </para> + <para> + Voir aussi <function>pdf_continue_text</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-set-parameter"> + <refnamediv> + <refname>PDF_set_parameter</refname> + <refpurpose>Modifie certains param&egrave;tres.</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_set_parameter</function> modifie certaines valeurs de pdglib. + <parameter>value</parameter> est de type cha&icirc;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-get-parameter"> + <refnamediv> + <refname>pdf_get_parameter</refname> + <refpurpose>Lit certains param&egrave;tres</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_get_parameter</function> lit certains + param&egrave;tres de la librairie pdflib. Ces param&egrave;tres sont des + cha&icirc;nes de caract&egrave;res. Le param&egrave;tre + <parameter>modifier</parameter> caract&eacute;rise le param&egrave;tre. + S'il n'est pas n&eacute;cessaire, il faut l'omettre, ou passer 0. + </para> + <para> + Voir aussi <function>pdf_get_value</function>, + <function>pdf_set_value</function>, + <function>pdf_set_parameter</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-set-value"> + <refnamediv> + <refname>pdf_set_value</refname> + <refpurpose>Modifie certains param&egrave;tre num&eacute;riques</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_set_value</function> modifie la valeur (num&eacute;rique) + du param&egrave;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-get-value"> + <refnamediv> + <refname>pdf_get_value</refname> + <refpurpose>Lit certains param&egrave;tres num&eacute;riques</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_get_parameter</function> lit certains + param&egrave;tres de la librairie pdflib. Ces param&egrave;tres sont des + num&eacute;riques. Le param&egrave;tre + <parameter>modifier</parameter> caract&eacute;rise le param&egrave;tre. + S'il n'est pas n&eacute;cessaire, il faut l'omettre, ou passer 0. + </para> + <para> + Voir aussi <function>pdf_get_parameter</function>, + <function>pdf_set_value</function>, + <function>pdf_set_parameter</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-get-image-height"> + <refnamediv> + <refname>pdf_get_image_height</refname> + <refpurpose>Retourne la hauteur d'une image</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> + </funcprototype> + </funcsynopsis> + <para> + <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-get-image-width"> + <refnamediv> + <refname>pdf_get_image_width</refname> + <refpurpose>Retourne la largeur d'une image</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> + </funcprototype> + </funcsynopsis> + <para> + <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-set-text-rendering"> + <refnamediv> + <refname>PDF_set_text_rendering</refname> + <refpurpose>Determine le rendu du texte.</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> + </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 and stroke text (texte plein + et stroke), 3=invisible, 4=texte plein, et ajout&eacute; au chemin, + 5=stroke text, ajout&eacute; au chemin, 6=texte plein et stroke, + ajout&eacute; au chemin, 7=ajout&eacute; au chemin. + </para> + </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 document</parameter></paramdef> + <paramdef>double <parameter>scale</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_set_horiz_scaling</function> fixe l'&eacute;chelle + horizontale du texte, &agrave; <parameter>scale</parameter> en + pourcentage. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-set-text-rise"> + <refnamediv> + <refname>PDF_set_text_rise</refname> + <refpurpose>Modifie l'&eacute;l&eacute;vation du texte.</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_set_text_rise</function> fixe l'&eacute;l&eacute;vation + du texte &agrave; <parameter>rise</parameter> points. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-set-text-matrix"> + <refnamediv> + <refname>PDF_set_text_matrix</refname> + <refpurpose>Fixe la matrice de texte.</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> + </funcprototype> + </funcsynopsis> + <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 &eacute;l&eacute;ments. + </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 document</parameter></paramdef> + <paramdef>double <parameter>x-coor</parameter></paramdef> + <paramdef>double <parameter>y-coor</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_set_text_pos</function> modifie la position du texte qui sera + utilis&eacute;e lors du prochain <function>pdf_show</function>. + </para> + <para> + Voir aussi <function>pdf_show</function>, + <function>pdf_show_xy</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-set-char-spacing"> + <refnamediv> + <refname>PDF_set_char_spacing</refname> + <refpurpose>Fixe l'espacement des caract&egrave;res.</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_set_char_spacing</function> fixe l'espacement des caract&egrave;res. + </para> + <para> + Voir aussi <function>pdf_set_word_spacing</function>, + <function>pdf_set_leading</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 document</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-skew"> + <refnamediv> + <refname>PDF_skew</refname> + <refpurpose>Modifie le syst&egrave;me de coordonn&eacute;es.</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_skew</function> modifie le syst&egrave;me de coordonn&eacute;es, + en faisant une rotation d'angle <parameter>alpha</parameter> pour les (x) et + d'angle <parameter>beta</parameter> pour les (y), en degr&eacute;s. + <parameter>alpha</parameter> et <parameter>beta</parameter> ne peuvent pas + pendre les valeurs de 90 ou 270 degr&eacute;s. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-continue-text"> + <refnamediv> + <refname>PDF_continue_text</refname> + <refpurpose>Affiche un texte sur une nouvelle ligne.</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 &ecirc;tre choisie + avec <function>pdf_set_leading</function>. + </para> + <para> + Voir aussi <function>pdf_show_xy</function>, + <function>pdf_set_leading</function>, + <function>pdf_set_text_pos</function>. + </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 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 + &eacute;t&eacute; choisie auparavant. + </para> + <para> + Voir aussi <function>pdf_set_font</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-save"> + <refnamediv> + <refname>PDF_save</refname> + <refpurpose>Enregistre l'environnement courant.</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 &agrave; la commande postscript gsave. Tr&egrave;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_restore</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-restore"> + <refnamediv> + <refname>PDF_restore</refname> + <refpurpose>Restaure un environnement sauv&eacute;.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pdf_restore</function></funcdef> + <paramdef>int <parameter>pdf document</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_restore</function> restaure un environnement sauv&eacute; par + <function>pdf_save</function>. Cela fonctionne de mani&egrave;re identique + &agrave; la commande Postscript grestore. Tr&egrave;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> +&lt;?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-translate"> + <refnamediv> + <refname>PDF_translate</refname> + <refpurpose>Modifie l'origine du syst&egrave;me de coordonn&eacute;es.</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_translate</function> place l'origine du syst&egrave;me de + coordonn&eacute;es au point (<parameter>x-coor</parameter>, + <parameter>y-coor</parameter>). L'exemple suivant trace une ligne de (0, 0) + &agrave; (200, 200) par rapport aux coordonn&eacute;es initiales. Il faut aussi + d&eacute;signer le point courant apr&egrave;s <function>pdf_translate</function> + et avant de commencer &agrave; dessiner les objets. + <example> + <title>Translation</title> + <programlisting> +&lt;?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-scale"> + <refnamediv> + <refname>PDF_scale</refname> + <refpurpose>Modifie l'&eacute;chelle.</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_scale</function> modifie l'&eacute;chelle dans les deux directions. + L'exemple suivant multiplie l'&eacute;chelle par 72. La ligne suivante sera + dessin&eacute;e sur un pouce (2.54 cm) de large. + <example> + <title>Mise &agrave; l'&eacute;chelle</title> + <programlisting> +&lt;?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-rotate"> + <refnamediv> + <refname>PDF_rotate</refname> + <refpurpose>Choisi la rotation.</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_rotate</function> modifie la rotation de + <parameter>angle</parameter> degr&eacute;. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-setflat"> + <refnamediv> + <refname>PDF_setflat</refname> + <refpurpose>Modifie la platitude (flatness).</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> + </funcprototype> + </funcsynopsis> + <para> + <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-setlinejoin"> + <refnamediv> + <refname>PDF_setlinejoin</refname> + <refpurpose>Modifie le param&egrave;tre linejoin.</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_setlinejoin</function> modifie le param&egrave;tre "linejoin", + et lui affecte la valeur <parameter>value</parameter>, entre 0 et 2. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-setlinecap"> + <refnamediv> + <refname>PDF_setlinecap</refname> + <refpurpose>Choisi le param&egrave;tre linecap.</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_setlinecap</function> affecte au param&egrave;tre "linecap" + la valeur <parameter>value</parameter>, entre 0 et 2. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-setmiterlimit"> + <refnamediv> + <refname>PDF_setmiterlimit</refname> + <refpurpose>Modifie la "miter limit".</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&eacute;rieure &agrave; 1. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-setlinewidth"> + <refnamediv> + <refname>PDF_setlinewidth</refname> + <refpurpose>Modifie la largeur de ligne.</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_setlinewidth</function> affecte &agrave; largeur de + ligne la valeur <parameter>width</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-setdash"> + <refnamediv> + <refname>PDF_setdash</refname> + <refpurpose>Modifie les caract&egrave;res de remplissage.</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_setdash</function> modifie les caract&egrave;res de remplissage, + et affecte <parameter>white</parameter> comme caract&egrave;re invisible, et + <parameter>black</parameter> comme caract&egrave;re de remplissage. Si les deux + sont &agrave; z&eacute;ros, une ligne continue est affich&eacute;e. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-moveto"> + <refnamediv> + <refname>PDF_moveto</refname> + <refpurpose>Modifie le point courant.</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&eacute;place le point courant &agrave; + la position (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>). + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-curveto"> + <refnamediv> + <refname>PDF_curveto</refname> + <refpurpose>Dessine une courbe.</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> + </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&ocirc;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>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-lineto"> + <refnamediv> + <refname>PDF_lineto</refname> + <refpurpose>Dessine une ligne.</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_lineto</function> dessine une ligne entre le point courant et le + point de coordonn&eacute;es (<parameter>x-coor</parameter>, + <parameter>y-coor</parameter>). + </para> + <para> + Voir aussi <function>pdf_moveto</function>, + <function>pdf_curveto</function>, + <function>pdf_stroke</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-circle"> + <refnamediv> + <refname>PDF_circle</refname> + <refpurpose>Dessine un cercle.</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> + </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>. + </para> + <para> + Voir aussi <function>pdf_arc</function>, + <function>pdf_stroke</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-arc"> + <refnamediv> + <refname>PDF_arc</refname> + <refpurpose>Dessine un arc.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pdf_arc</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> + <paramdef>double <parameter>start</parameter></paramdef> + <paramdef>double <parameter>end</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 &agrave; l'angle + <parameter>start</parameter> et finissant &agrave; l'angle + <parameter>end</parameter>. + </para> + <para> + Voir aussi <function>pdf_circle</function>, + <function>pdf_stroke</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-rect"> + <refnamediv> + <refname>PDF_rect</refname> + <refpurpose>Dessine un rectangle.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pdf_rect</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>width</parameter></paramdef> + <paramdef>double <parameter>height</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_rect</function> dessine un rectangle un rectangle de coin + inf&eacute;rieur gauche de coordonn&eacute;es + (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>). + Sa longueur vaut <parameter>width</parameter>. Et sa largeur + <parameter>height</parameter>. + </para> + <para> + Voir aussi <function>pdf_stroke</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-closepath"> + <refnamediv> + <refname>PDF_closepath</refname> + <refpurpose>Ferme et clos le chemin.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pdf_closepath</function></funcdef> + <paramdef>int <parameter>pdf document</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_closepath</function> ferme et clos le chemin courant. Cela + signifie qu'une ligne va &ecirc;tre ajout&eacute;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&eacute;marre un nouveau chemin. + </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 document</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&eacute;ssin&eacute;es. Sans cette + fonction, la ligne de chemin ne sera pas dessin&eacute;e. + </para> + <para> + Voir aussi <function>pdf_closepath</function>, + <function>pdf_closepath_stroke</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-closepath-stroke"> + <refnamediv> + <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_closepath_stroke</function></funcdef> + <paramdef>int <parameter>pdf document</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. + </para> + <para> + Voir aussi <function>pdf_closepath</function>, + <function>pdf_stroke</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-fill"> + <refnamediv> + <refname>PDF_fill</refname> + <refpurpose>Remplis le chemin courant.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pdf_fill</function></funcdef> + <paramdef>int <parameter>pdf document</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_fill</function> remplis l'int&eacute;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> + </refsect1> + </refentry> + <refentry id="function.pdf-fill-stroke"> + <refnamediv> + <refname>PDF_fill_stroke</refname> + <refpurpose>Remplis et dessine le chemin courant.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pdf_fill_stroke</function></funcdef> + <paramdef>int <parameter>pdf document</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_fill_stroke</function> remplis l'int&eacute;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>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-closepath-fill-stroke"> + <refnamediv> + <refname>PDF_closepath_fill_stroke</refname> + <refpurpose>Remplis, dessine et ferme le chemin courant.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pdf_closepath_fill_stroke</function></funcdef> + <paramdef>int <parameter>pdf document</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>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-endpath"> + <refnamediv> + <refname>PDF_endpath</refname> + <refpurpose>Ferme le chemin courant.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pdf_endpath</function></funcdef> + <paramdef>int <parameter>pdf document</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>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-clip"> + <refnamediv> + <refname>PDF_clip</refname> + <refpurpose>Aligne sur le chemin courant.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pdf_clip</function></funcdef> + <paramdef>int <parameter>pdf document</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_clip</function> aligne tous les dessins sur le chemin courant. + </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> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pdf_setgray_fill</function></funcdef> + <paramdef>int <parameter>pdf document</parameter></paramdef> + <paramdef>double <parameter>gray value</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_setgray_fill</function> choisi la couleur grise comme couleur de + remplissage. + </para> + <para> + Voir aussi <function>pdf_setrgbcolor_fill</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-setgray-stroke"> + <refnamediv> + <refname>PDF_setgray_stroke</refname> + <refpurpose>Fixe la couleur de dessin &agrave; 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>double <parameter>gray value</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_setgray_stroke</function> Fixe la couleur de dessin + &agrave; un niveau de gris. + </para> + <para> + Voir aussi <function>pdf_setrgbcolor_stroke</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-setgray"> + <refnamediv> + <refname>PDF_setgray</refname> + <refpurpose> + Choisi la couleur grise comme couleur de remplissage et de dessin. + </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> + </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>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-setrgbcolor-fill"> + <refnamediv> + <refname>PDF_setrgbcolor_fill</refname> + <refpurpose>Choisi la couleur rgb comme couleur de remplissage.</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_setrgbcolor_fill</function> choisi la couleur rgb comme couleur + de remplissage. + </para> + <para> + Voir aussi <function>pdf_setrgbcolor_fill</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-setrgbcolor-stroke"> + <refnamediv> + <refname>PDF_setrgbcolor_stroke</refname> + <refpurpose>Choisi la couleur rgb comme couleur de remplissage.</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> + </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>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-setrgbcolor"> + <refnamediv> + <refname>PDF_setrgbcolor</refname> + <refpurpose>Choisi la couleur rgb comme couleur de dessin et de remplissage.</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> + </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>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-add-outline"> + <refnamediv> + <refname>PDF_add_outline</refname> + <refpurpose>Ajoute un signet sur la page courante.</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> + </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&eacute;r&eacute; comme un fils de la page + <parameter>parent</parameter> et est ouvert par d&eacute;faut si + <parameter>open</parameter> n'est pas 0. La valeur retourn&eacute;e est un + identifiant du signet, qui pourra &ecirc;tre r&eacute;utilis&eacute; comme + parent d'autres signets. Vous pouvez ainsi cr&eacute;er des hi&eacute;rarchies + de signets. + </para> + <simpara> + Malheureusement, pdflib ne copie pas la cha&icirc;ne, ce qui force PHP &agrave; + allouer la m&eacute;moire. Actuellement, cette m&eacute;moire n'est jamais + lib&eacute;r&eacute;e par une fonction PDF, mais prise en charge par le + gestionnaire PHP. + </simpara> + </refsect1> + </refentry> + <refentry id="function.pdf-set-transition"> + <refnamediv> + <refname>PDF_set_transition</refname> + <refpurpose>Fixe le mode de transition entre les pages.</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_set_transition</function> Fixe le mode de transition entre les + pages. La valeur de <parameter>transition</parameter> peut &ecirc;tre : + <simplelist> + <member> + 0 : aucune transition, + </member> + <member> + 1 : deux lignes en travers de l'&eacute;cran repr&eacute;sente la page, + </member> + <member> + 2 : plusieurs lignes en travers de l'&eacute;cran repr&eacute;sente la page, + </member> + <member> + 3 : une boite repr&eacute;sente la page, + </member> + <member> + 4 : une seule ligne en travers de l'&eacute;cran repr&eacute;sente la page, + </member> + <member> + 5 : l'ancienne page se dissout pour rev&eacute;ler la nouvelle, + </member> + <member> + 6 : l'effet page d'un coin &agrave; l'autre + </member> + <member> + 7 : l'ancienne page est simplement remplac&eacute;e par la nouvelle (valeur par d&eacute;faut) + </member> + </simplelist></para> + <para> + Voir aussi <function>pdf_set_duration</function>.</para> + </refsect1> + </refentry> + <refentry id="function.pdf-set-duration"> + <refnamediv> + <refname>PDF_set_duration</refname> + <refpurpose>Choisi la dur&eacute;e de transition entre deux pages.</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_set_duration</function> choisi la dur&eacute;e de transition, + en secondes, entre deux pages. + </para> + <para> + Voir aussi <function>pdf_set_transition</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-open-gif"> + <refnamediv> + <refname>PDF_open_gif</refname> + <refpurpose>Ouvre une image GIF.</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_open_gif</function> ouvre et charge l'image GIF du fichier + <parameter>filename</parameter>. Le format doit &ecirc;tre GIF. La fonction + retourne un identifiant d'image PDF : + <example> + <title>Inclusion d'un image GIF</title> + <programlisting> +&lt;?php +$im = PDF_open_gif($pdf, "test.gif"); +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_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-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&eacute;e dans + le fichier <parameter>png_file</parameter>. Le format de cette image + doit &ecirc;tre PNG. La fonction retourne un identifiant d'image PNG. + <note> + <simpara> + Cette fonction ne doit plus &ecirc;tre utilis&eacute;e. Utilisez plut&ocirc;t + <function>pdf_open_image_file</function>. + </simpara> + </note> + <example> + <title>Including a PNG image</title> + <programlisting> +&lt;?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"> + <refnamediv> + <refname>pdf_open_image_file</refname> + <refpurpose>Lit une image dans un fichier</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> + </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> +&lt;?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> + <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>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-open-memory-image"> + <refnamediv> + <refname>PDF_open_memory_image</refname> + <refpurpose> + Ouvre une image cr&eacute;&eacute;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 document</parameter></paramdef> + <paramdef>int <parameter>image</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_open_memory_image</function> prend comme argument une + image cr&eacute;&eacute;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&eacute;moire</title> + <programlisting> +&lt;?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> + <refentry id="function.pdf-open-jpeg"> + <refnamediv> + <refname>PDF_open_jpeg</refname> + <refpurpose>Ouvre une image JPEG.</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> + </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 &ecirc;tre JPEG. + La fonction retourne un identifiant d'image PDF. + <note> + <simpara> + Cette fonction ne doit plus &ecirc;tre utilis&eacute;e. Utilisez plut&ocirc;t + <function>pdf_open_image_file</function>. + </simpara> + </note> + </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>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-open-tiff"> + <refnamediv> + <refname>pdf_open_tiff</refname> + <refpurpose>Ouvre une image TIFF</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> + </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 &ecirc;tre JPEG. + La fonction retourne un identifiant d'image PDF. + </simpara> + <note> + <simpara> + Cette fonction ne doit plus &ecirc;tre utilis&eacute;e. Utilisez plut&ocirc;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>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-close-image"> + <refnamediv> + <refname>PDF_close_image</refname> + <refpurpose>Ferme une image.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pdf_close_image</function></funcdef> + <paramdef>int <parameter>image</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_close_image</function> ferme une image qui a + &eacute;t&eacute; ouverte par <function>pdf_open_gif</function> ou + <function>pdf_open_jpeg</function>. + </para> + <para> + Voir aussi <function>pdf_open_jpeg</function>, + <function>pdf_open_gif</function>, + <function>pdf_open_tiff</function>, + <function>pdf_open_file</function>, + <function>pdf_open_memory_image</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-place-image"> + <refnamediv> + <refname>PDF_place_image</refname> + <refpurpose>Place une image dans la page.</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_place_image</function> place l'image <parameter>image</parameter> + dans la page courante, &agrave; la position (<parameter>x-coor</parameter>, + <parameter>x-coor</parameter>). L'image peut changer d'&eacute;chelle + simultan&eacute;mement. + </para> + <para> + Voir aussi <function>pdf_put_image</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-put-image"> + <refnamediv> + <refname>PDF_put_image</refname> + <refpurpose> + Enregistre une image dans un fichier PDF pour utilisation ult&eacute;rieure. + </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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_put_image</function> enregistre une image dans un fichier PDF + pour utilisation ult&eacute;rieure. L'image n'est pas visible. On peut + l'afficher avec la fonction <function>pdf_execute_image</function>, et + aussi souvent que d&eacute;sir&eacute;. Cela permet d'utiliser plusieurs + fois la m&ecirc;me image, sans augmenter la taille du fichier. + <function>pdf_put_image</function> et <function>pdf_execute_image</function> + est fortement recommand&eacute; pour les images de grande taille (plusieurs ko) + si elles sont affich&eacute;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> + </para> + <para> + Voir aussi <function>pdf_put_image</function>, + <function>pdf_place_image</function>, + <function>pdf_execute_image</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-execute-image"> + <refnamediv> + <refname>PDF_execute_image</refname> + <refpurpose>Place une image enregistr&eacute;e dans la page.</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> + <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 &eacute;t&eacute; + enregistr&eacute;e dans le document PDF, avec la fonction + <function>pdf_put_image</function>. + L'image est implant&eacute;e dans la page courante, et aux coordonn&eacute;es + donn&eacute;es. + </para> + <para> + L'image peut &ecirc;tre modifi&eacute;e d'&eacute;chelle en m&ecirc;me + temps qu'elle est affich&eacute;e. Une &eacute;chelle de 1.0 affichera + l'image &agrave; 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> +&lt;?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> + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-add-annotation"> + <refnamediv> + <refname>pdf_add_annotation</refname> + <refpurpose>Ajoute une annotation.</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_add_annotation</function> ajoute une note, dont le coin + inf&eacute;rieur droit est (<parameter>llx</parameter>, + <parameter>lly</parameter>) et le coin sup&eacute;rieur droit est + (<parameter>urx</parameter>, <parameter>ury</parameter>). + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-set-border-style"> + <refnamediv> + <refname>pdf_set_border_style</refname> + <refpurpose>Modifie le bord des liens et annotations</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> + <paramdef>double <parameter>width</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&eacute;). + </para> + <para> + Voir aussi <function>pdf_set_border_color</function>, + <function>pdf_set_border_dash</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-set-border-color"> + <refnamediv> + <refname>pdf_set_border_color</refname> + <refpurpose>Modifie la couleur des liens et annotations</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> + </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&eacute;sentent une couleur RGB (rouge, + vert, bleu) et leur valeur doit &ecirc;tre comprise entre 0.0 et 1.0. + </para> + <para> + Voir aussi <function>pdf_set_border_style</function>, + <function>pdf_set_border_dash</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-set-border-dash"> + <refnamediv> + <refname>pdf_set_border_dash</refname> + <refpurpose>Modifie les pointill&eacute;s des liens et annotations</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> + </funcprototype> + </funcsynopsis> + <para> + <function>pdf_set_border_dash</function> modifie la longueur + des pointill&eacute;s (si le style de bord d'une annotation est en pointill&eacute;). + <parameter>black</parameter> repr&eacute;sente la taille des traits + noirs, et <parameter>white</parameter> celle des espaces blancs. + </para> + <para> + Voir aussi <function>pdf_set_border_style</function>, + <function>pdf_set_border_color</function>. + </para> + </refsect1> + </refentry> + </reference> +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +sgml-parent-document:nil +sgml-default-dtd-file:"../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +-->