dams Fri Feb 23 02:29:16 2001 EDT Modified files: /phpdoc/fr/functions pdf.xml Log: Updated configure option
Index: phpdoc/fr/functions/pdf.xml diff -u phpdoc/fr/functions/pdf.xml:1.8 phpdoc/fr/functions/pdf.xml:1.9 --- phpdoc/fr/functions/pdf.xml:1.8 Sat Feb 17 04:56:00 2001 +++ phpdoc/fr/functions/pdf.xml Fri Feb 23 02:29:15 2001 @@ -13,13 +13,13 @@ de la configuration. Suivez attentivement les messages d'erreur. </simpara> <simpara> - Reportez vous à l'excellente documentation de pdflib, disponible - avec la distribution de pdflib. C'est une introduction très - pratique des possibilités de pdflib et elle contient la liste + Reportez vous à l'excellente documentation de PDFLib, disponible + avec la distribution de PDFLib. C'est une introduction très + pratique des possibilités de PDFLib et elle contient la liste la plus complète et les descriptions les plus à jours des fonctions. </simpara> <simpara> - Toutes les fonctions de pdflib se retrouvent dans PHP sous le même nom. + Toutes les fonctions de PDFLib se retrouvent dans PHP sous le même nom. De même, les paramètres sont identiques. Vous devez connaître les concepts de base de PDF ou de Postscript pour utiliser efficacement ce module. @@ -43,20 +43,20 @@ paramètre. </simpara> <sect1 id="pdf.oldlibs.confusion"> - <title>Confusion entre les vieilles version de pdflib</title> + <title>Confusion entre les vieilles versions de PDFLib</title> <simpara> Depuis le début du support de PDF sous PHP, - (commençant avec la version pdflib 0.6), il y a eu des milliers - de modifications dans les API de pdflib. La plus part de ces modifications + (commençant avec la version PDFLib 0.6), il y a eu des milliers + de modifications dans les API de PDFLib. La plus part de ces modifications ont été suivies par PHP, et parfois même au prix de modifications des API PHP. Depuis la version 3.x, ces API semblent s'être stabilisées, et PHP 4 a adoptée cette version comme le minimum nécessaire pour supporter PDF. En conséquence de quoi, un grand nombre de fonction vont - disparaître, ou être - remplacée. Le support de pdflib 0.6 est complétement abandonné. - La liste suivante indique quelles sont les fonctions obsolète - dans PHP 4.02, et qui devraient être remplacées par de nouvelles versions. + disparaître, ou être remplacée. Le support de + PDFLib 0.6 est complétement abandonné. La liste suivante + indique quelles sont les fonctions obsolètes en PHP 4.02, et qui + devraient être remplacées par de nouvelles versions. </simpara> <para> <table> @@ -104,7 +104,7 @@ <literal>"Creator"</literal> comme second paramètre.</entry> </row> <row> - <entry>pdf_set_info_title</entry> + <entry>pdf_set_info_title()</entry> <entry><function>pdf_set_info</function> avec <literal>"Title"</literal> comme second paramètre.</entry> </row> @@ -114,51 +114,51 @@ <literal>"Subject"</literal> comme second paramètre.</entry> </row> <row> - <entry>pdf_set_info_author</entry> + <entry>pdf_set_info_author()</entry> <entry><function>pdf_set_info</function> avec <literal>"Author"</literal> comme second paramètre.</entry> </row> <row> - <entry>pdf_set_info_keywords</entry> + <entry>pdf_set_info_keywords()</entry> <entry><function>pdf_set_info</function> avec <literal>"Keywords"</literal> comme second paramètre.</entry> </row> <row> - <entry><function>pdf_set_leading</function></entry> + <entry>pdf_set_leading()</entry> <entry><function>pdf_set_value</function> avec <literal>"leading"</literal> comme second paramètre.</entry> </row> <row> - <entry><function>pdf_set_text_rendering</function></entry> + <entry>pdf_set_text_rendering()</entry> <entry><function>pdf_set_value</function> avec <literal>"textrendering"</literal> comme second paramètre.</entry> </row> <row> - <entry><function>pdf_set_text_rise</function></entry> + <entry>pdf_set_text_rise()</entry> <entry><function>pdf_set_value</function> avec <literal>"textrise"</literal> comme second paramètre.</entry> </row> <row> - <entry><function>pdf_set_horiz_scaling</function></entry> + <entry>pdf_set_horiz_scaling()</entry> <entry><function>pdf_set_value</function> avec <literal>"horizscaling"</literal> comme second paramètre.</entry> </row> <row> - <entry><function>pdf_set_text_matrix</function></entry> + <entry>pdf_set_text_matrix()</entry> <entry>Désormais inutile</entry> </row> <row> - <entry><function>pdf_set_char_spacing</function></entry> + <entry>pdf_set_char_spacing()</entry> <entry><function>pdf_set_value</function> avec <literal>"charspacing"</literal> comme second paramètre.</entry> </row> <row> - <entry><function>pdf_set_word_spacing</function></entry> + <entry>pdf_set_word_spacing()</entry> <entry><function>pdf_set_value</function> avec <literal>"wordspacing"</literal> comme second paramètre.</entry> </row> <row> - <entry><function>pdf_set_transition</function></entry> + <entry>pdf_set_transition()</entry> <entry><function>pdf_set_parameter</function> avec <literal>"transition"</literal> comme second paramètre.</entry> </row> @@ -173,38 +173,38 @@ <function>pdf_setfont</function></entry> </row> <row> - <entry><function>pdf_set_duration</function></entry> + <entry>pdf_set_duration()</entry> <entry><function>pdf_set_value</function> avec <literal>"duration"</literal> comme second paramètre.</entry> </row> <row> - <entry><function>pdf_open_gif</function></entry> + <entry>pdf_open_gif()</entry> <entry><function>pdf_open_image_file</function> avec <literal>"gif"</literal> comme second paramètre.</entry> </row> <row> - <entry><function>pdf_open_jpeg</function></entry> + <entry>pdf_open_jpeg()</entry> <entry><function>pdf_open_image_file</function> avec <literal>"jpeg"</literal> comme second paramètre.</entry> </row> <row> - <entry><function>pdf_open_tiff</function></entry> + <entry>pdf_open_tiff()</entry> <entry><function>pdf_open_image_file</function> avec <literal>"tiff"</literal> comme second paramètre.</entry> </row> <row> - <entry><function>pdf_open_png</function></entry> + <entry>pdf_open_png()</entry> <entry><function>pdf_open_image_file</function> avec <literal>"png"</literal> comme second paramètre.</entry> </row> <row> - <entry>pdf_get_imagewidth</entry> + <entry>pdf_get_imagewidth()</entry> <entry><function>pdf_get_value</function> avec <literal>"imagewidth"</literal> comme second paramètre et l'image comme troisième.</entry> </row> <row> - <entry>pdf_get_imageheight</entry> + <entry>pdf_get_imageheight()</entry> <entry><function>pdf_get_value</function> avec <literal>"imageheight"</literal> comme second paramètre et l'image comme troisième.</entry> @@ -215,9 +215,9 @@ </para> </sect1> <sect1 id="pdf.install.pdflib"> - <title>Conseils pour installer pdflib 3.x</title> + <title>Conseils pour installer PDFLib 3.x</title> <simpara> - Depuis la version 3.0 de pdflib vous pouvez configurer cette librairie + Depuis la version 3.0 de PDFLib vous pouvez configurer cette librairie avec l'option <literal>--enable-shared-pdflib</literal>. </simpara> </sect1> @@ -228,43 +228,44 @@ vous devez utiliser PDFlib 3.0 ou plus récent. </simpara> <simpara> - PHP 3, d'un autre coté, ne doit pas être utilisé avec une version - plus récente que la 2.01. Depuis la version 1.61 du source - php3/functions/pdf.c (php 3.19), il est possible d'utiliser - la version PDFlib 3.0 ou plus récent. + PHP 3, d'un autre coté, ne doit pas être utilisé + avec une version plus récente que la 2.01. Depuis la + version 1.61 du source <filename>php3/functions/pdf.c</filename> + (php 3.19), il est possible d'utiliser la version PDFlib 3.0 ou + plus récent. </simpara> </sect1> <sect1 id="pdf.oldlibs.hints"> - <title>Installation des anciennes versions de pdflib</title> + <title>Installation des anciennes versions de PDFLib</title> <simpara> - Si vous utilisez pdflib 2.01 vérifiez comment votre librairie a - été - installée. Il doit y avoir un fichier (ou un lien) vers libpdf.so. - La version 2.01 ne fait que créer une librairie avec le nom - libpdf2.01.so qui ne peut être trouvé lors de la compilation du + Si vous utilisez PDFLib 2.01 vérifiez comment votre librairie a + été installée. Il doit y avoir un fichier (ou + un lien) vers <filename>libpdf.so</filename>. La version 2.01 ne fait + que créer une librairie avec le nom <filename>libpdf2.01.so</filename> + qui ne peut être trouvé lors de la compilation du programme de configuration. Vous devez créer vous même ce lien - symbolique de libpdf.so vers libpdf2.01.so.. + symbolique de <filename>libpdf.so</filename> vers +</filename>libpdf2.01.so</filename>. </simpara> <simpara> - La version 2.20 de pdflib a introduit de nombreuses modifications dans ses + 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érer correctement votre mémoire. Jusqu'à la version 3.0, pdflib + PHP 4 (mais pas de PHP 3). Si vous utilisez PDFLib 2.20, + gérer correctement votre mémoire. Jusqu'à la version 3.0, +PDFLib peut se révéler très instable. Le paramètre d'encodage <function>pdf_set_font</function> est devenu une chaî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é. En général, il est recommandé - de consulter les notes de version de la pdflib pour lister toutes les - modifications. + Si vous utilisez PDFLib 2.30, <function>pdf_set_text_matrix</function> + a disparu. Elle n'est plus supporté. En général, + il est recommandé 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écente de pdflib. PHP 3, par contre, ne doit pas - être utilisé avec des versions plus récentes que la 2.01. + A partir du 9 mars 2000, PHP 4 ne supporte plus que la + version 3.0 et plus récente de PDFLib. PHP 3, par contre, ne doit pas + être utilisé avec des versions plus récentes que la 2.01. </simpara> </sect1> <sect1 id="pdf.examples"> @@ -279,13 +280,13 @@ </simpara> <para> <example> - <title>Création d'un document PDF avec pdflib</title> + <title>Création d'un document PDF avec PDFLib</title> <programlisting role="php"> <?php $pdf = pdf_new(); pdf_open_file($pdf, "test.pdf"); pdf_set_info($pdf, "Author", "Uwe Steinmann"); -pdf_set_info($pdf, "Title", "Test for PHP wrapper of PDFlib 2.0"); +pdf_set_info($pdf, "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); @@ -318,7 +319,7 @@ </example> </para> <para> - La distribution pdflib contient un exemple plus complexe, + La distribution PDFLib contient un exemple plus complexe, qui crée des pages plus élaborées, avec une horloge. Cet exemple a été converti en script PHP (vous retrouverez cet exemple dans le module @@ -328,7 +329,7 @@ </para> <para> <example> - <title>Exemple pdfclock issue de la distribution pdflib</title> + <title>Exemple pdfclock issue de la distribution PDFLib</title> <programlisting role="php"> <?php $radius = 200; @@ -1174,8 +1175,9 @@ </para> <para> Voir aussi <function>pdf_open_image_file</function>, - <function>pdf_open_memory_image</function>, - <function>pdf_get_image_width</function>.</para> + <function>pdf_open_memory_image</function> et + <function>pdf_get_image_width</function>. + </para> </refsect1> </refentry> <refentry id="function.pdf-get-image-width"> @@ -1198,8 +1200,8 @@ </para> <para> Voir aussi <function>pdf_open_image_file</function>, - <function>pdf_open_memory_image</function>, - <function>pdf_get_image_height</function>. + <function>pdf_open_memory_image</function> et + <function>pdf_get_image_height</function>. </para> </refsect1> </refentry> @@ -1420,9 +1422,9 @@ l'une des valeurs suivantes : "jpeg", "ccitt", "raw". <parameter>source</parameter> peut prendre l'une des valeurs suivantes : "memory" (mémoire), "fileref" (pointeur de fichier), - "url". <parameter>length</parameter> ne sert que pour le type - "raw"; <parameter>params</parameter> ne sert qur pour le type - "ccitt". + "url". <parameter>length</parameter> ne sert que pour le type + "raw"; <parameter>params</parameter> ne sert qur pour le type + "ccitt". </para> </refsect1> </refentry> @@ -1710,10 +1712,10 @@ </funcprototype> </funcsynopsis> <para> - <function>pdf_setdash</function> modifie les caractères de remplissage, - et affecte <parameter>white</parameter> comme caractère invisible, et - <parameter>black</parameter> comme caractère de remplissage. Si les deux - sont à zéros, une ligne continue est affichée. + <function>pdf_setdash</function> modifie les caractères de remplissage, + et affecte <parameter>white</parameter> comme caractère invisible, et + <parameter>black</parameter> comme caractère de remplissage. Si les deux + sont à zéros, une ligne continue est affichée. </para> </refsect1> </refentry> @@ -1732,8 +1734,8 @@ </funcprototype> </funcsynopsis> <para> - <function>pdf_setflat</function> modifie la platitude, et lui - affecte la valeur <parameter>value</parameter> entre 0 et 100. + <function>pdf_setflat</function> modifie la platitude, et lui + affecte la valeur <parameter>value</parameter> entre 0 et 100. </para> </refsect1> </refentry> @@ -1781,7 +1783,7 @@ </para> <para> Voir aussi <function>pdf_setrgbcolor_stroke</function> et - <function>pdf_setrgbcolor_fill</function>. + <function>pdf_setrgbcolor_fill</function>. </para> </refsect1> </refentry> @@ -2162,17 +2164,17 @@ <function>pdf_set_font</function> sélectionne la police, sa taille et son encodage. Il vous faudra fournir des fichiers Adobe Font Metrics (afm) comme police, dans le dossier de police - (par défaut ./fonts). Si vous utilisez pdflib 0.6, vous devrez + (par défaut ./fonts). Si vous utilisez PDFLib 0.6, vous devrez fournir des fichiers Adobe Font Métric (afm-files) pour les polices, dans le chemin de police ( par défaut, ./fonts). Si vous utilisez php versin 3 ou une version plus ancienne que la - version 2.20 de pdflib, le quatrième paramètre + version 2.20 de PDFLib, le quatrième paramètre <parameter>encoding</parameter> peut prendre les valeurs suivantes : 0 = builtin, 1 = pdfdoc, 2 = macroman, 3 = macexpert, 4 = winansi. Un encodage plus grand que 4 et inférieur à 0 sera transformé en 'winansi'. 'winansi' est souvent un bon choix. Si vous utilisez PHP version 4 et une version plus ancienne que la - version 2.20 de pdflib le quatrième paramètre + version 2.20 de PDFLib le quatrième paramètre <parameter>encoding</parameter> est une chaîne : 'builtin', 'pdfdoc', 'macroman', 'macexpert', 'winansi'. Si le dernier paramètre est à 1, la police est @@ -2389,12 +2391,12 @@ </funcsynopsis> <para> <function>pdf_set_value</function> modifie la valeur (numérique) - du paramètre <parameter>name</parameter> de PDFlib. + du paramètre <parameter>name</parameter> de PDFLib. </para> <para> Voir aussi <function>pdf_get_value</function>, - <function>pdf_get_parameter</function>, - <function>pdf_set_parameter</function>. + <function>pdf_get_parameter</function> et + <function>pdf_set_parameter</function>. </para> </refsect1> </refentry> @@ -2416,8 +2418,8 @@ <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>. + Voir aussi <function>pdf_set_char_spacing</function> + et <function>pdf_set_leading</function>. </para> </refsect1> </refentry>