cvs: phpdoc /fr/functions image.xml

From:	Damien Seguy	Date:	Fri, 01 Dec 2000 11:38:21 +0000
Subject:	cvs: phpdoc /fr/functions image.xml
Groups:	php.doc
Request:	Send a blank email to phpdoc+get-969333128@lists.php.net to get a copy of this message

dams Fri Dec 1 03:38:21 2000 EDT Modified files: /phpdoc/fr/functions image.xml Log: Replace imagepng by imagejpeg.Update imagestring(up)'s def.

Index: phpdoc/fr/functions/image.xml diff -u phpdoc/fr/functions/image.xml:1.5 phpdoc/fr/functions/image.xml:1.6 --- phpdoc/fr/functions/image.xml:1.5 Fri Nov 3 06:04:42 2000 +++ phpdoc/fr/functions/image.xml Fri Dec 1 03:38:21 2000 @@ -1,37 +1,35 @@ <reference id="ref.image"> <title>Images</title> <titleabbrev>Graphisme</titleabbrev> - <partintro> <simpara> Vous pouvez utiliser les fonctions PHP pour obtenir les - tailles des images aux formats <acronym>JPEG</acronym>, - <acronym>GIF</acronym>, <acronym>PNG</acronym>, et - <acronym>SWF</acronym>, et si vous avez la librairie GD (disponible - à <ulink url="&url.gd;">&url.gd;</ulink>) vous pourrez aussi + tailles des images aux formats <acronym>JPEG</acronym>, + <acronym>GIF</acronym>, <acronym>PNG</acronym>, et + <acronym>SWF</acronym>, et si vous avez la librairie GD (disponible + à <ulink url="&url.gd;">&url.gd;</ulink>) vous pourrez aussi créer et manipuler ces images. </simpara> <simpara> Les formats des images que vous pourrez manipuler dépend de la version de GD que vous installereez, et de toute autre librairie - dont GD a besoin pour accéder à ces images. Les versions antérieures - à la version 1.6 supportent le GIF, mais pas le PNG. Pour les versions - plus récentes, c'est le contraire. + dont GD a besoin pour accéder à ces images. Les versions + antérieures à la version 1.6 supportent le GIF, mais pas + le PNG. Pour les versions plus récentes, c'est le contraire. </simpara> <simpara> Pour accéder aux images en JPEG, vous devez installer la librairie - jpeg-6b (disponible à <ulink url="&url.jpeg;">&url.jpeg;</ulink>), + jpeg-6b (disponible à <ulink url="&url.jpeg;">&url.jpeg;</ulink>), puis, recompiler GD pour qu'elle utilise jpeg-6b. Vous devrez aussi - compiler PHP avec + compiler PHP avec <option role="configure">--with-jpeg-dir=/path/to/jpeg-6b</option>. </simpara> <simpara> - Pour ajouter le support des polices Type 1, vous devez installer t1lib + Pour ajouter le support des polices Type 1, vous devez installer t1lib (disponible à <ulink url="&url.t1lib;">&url.t1lib;</ulink>), puis ajouter l'option <option role="configure">--with-t1lib[=dir]</option>. </simpara> </partintro> - <refentry id="function.getimagesize"> <refnamediv> <refname>GetImageSize</refname> @@ -45,41 +43,39 @@ <paramdef>array <parameter><optional>imageinfo</optional></parameter></paramdef> </funcsynopsis> <para> - <function>getimagesize</function> va déterminer la taille des images + <function>getimagesize</function> va déterminer la taille des images de type <acronym>GIF</acronym>, <acronym>JPG</acronym>, - <acronym>PNG</acronym> ou <acronym>SWF</acronym> et en retourner - les dimensions avec le type d'image, et une chaîne type - "height/width", à placer dans une + <acronym>PNG</acronym> ou <acronym>SWF</acronym> et en retourner + les dimensions avec le type d'image, et une chaîne type + "height/width", à placer dans une balise <acronym>HTML</acronym> ou <sgmltag>IMG</sgmltag> normale. </para> - <para> - <function>getimagesize</function> etourne un tableau de 4 éléments. + <function>getimagesize</function> etourne un tableau de 4 éléments. L'index 0 contient la largeur. L'index 1 contient la longueur. L'index 2 - contient le type de l'image : 1 = GIF, 2 = JPG, 3 = PNG. L'index 3 contient la - chaîne à placer dans les balises HTML : - "height=xxx width=xxx". + contient le type de l'image : 1 = GIF, 2 = JPG, 3 = PNG. L'index 3 contient la + chaîne à placer dans les balises HTML : + "height=xxx width=xxx". <example> <title><function>getimagesize</function></title> <programlisting> <?php $size = GetImageSize("img/flag.jpg"); ?> <IMG SRC="img/flag.jpg" <?php echo $size[3]; ?>> </programlisting></example></para> - <para> - Le paramètre optionnel <parameter>imageinfo</parameter> permet - d'extraire des informations supplémentaires du fichier image. - Actuellement, cette option va retourner différents marqueurs + Le paramètre optionnel <parameter>imageinfo</parameter> permet + d'extraire des informations supplémentaires du fichier image. + Actuellement, cette option va retourner différents marqueurs <acronym>JPG</acronym> APP dans un tableau associatif. Certains programmes - utilisent ces marqueur APP pour préciser les informations dans - les balises HTML. Un marqueur commun est le marqueur APP13, décrit - à <ulink url="&url.iptc;">&url.iptc;</ulink>. Vous pouvez utiliser - la fonction <function>iptcparse</function> pour analyser ce marqueur, et + utilisent ces marqueur APP pour préciser les informations dans + les balises HTML. Un marqueur commun est le marqueur APP13, décrit + à <ulink url="&url.iptc;">&url.iptc;</ulink>. Vous pouvez utiliser + la fonction <function>iptcparse</function> pour analyser ce marqueur, et obtenir des informations intelligibles. <example> <title><function>getimagesize</function> qui retourne IPTC</title> <programlisting> -<?php +<?php $size = GetImageSize("testimg.jpg",&$info); if (isset($info["APP13"])) { $iptc = iptcparse($info["APP13"]); @@ -96,7 +92,6 @@ </para> </refsect1> </refentry> - <refentry id="function.imagearc"> <refnamediv> <refname>ImageArc</refname> @@ -116,17 +111,15 @@ <paramdef>int <parameter>col</parameter></paramdef> </funcsynopsis> <para> - <function>imagearc</function> dessine une ellipse partielle, centrée sur - <parameter>cx</parameter>, <parameter>cy</parameter>, (le coin en haut à gauche + <function>imagearc</function> dessine une ellipse partielle, centrée sur + <parameter>cx</parameter>, <parameter>cy</parameter>, (le coin en haut à gauche est l'origine (0,0)) dans l'image référencée par im. <parameter>w</parameter> et - <parameter>h</parameter> spécifient la largeur et la hauteur de l'ellipse, tandis - que le début et la fin de l'arc sont donnés en degrés, par les arguments + <parameter>h</parameter> spécifient la largeur et la hauteur de l'ellipse, tandis + que le début et la fin de l'arc sont donnés en degrés, par les arguments <parameter>s</parameter> et <parameter>e</parameter>. </para> - </refsect1> </refentry> - <refentry id="function.imagechar"> <refnamediv> <refname>ImageChar</refname> @@ -144,20 +137,18 @@ <paramdef>int <parameter>col</parameter></paramdef> </funcsynopsis> <para> - <function>imagechar</function> dessine le premier caractère de la chaîne - <parameter>c</parameter> dans l'image <parameter>id</parameter> avec le coin - supérieur gauche placé à la position <parameter>x</parameter>,<parameter>y</parameter> - (le coin en haut à gauche est l'origine (0,0)) avec la couleur - <parameter>col</parameter>. Si la police est 1, 2, 3, 4 ou 5, une police intégrée + <function>imagechar</function> dessine le premier caractère de la chaîne + <parameter>c</parameter> dans l'image <parameter>id</parameter> avec le coin + supérieur gauche placé à la position <parameter>x</parameter>,<parameter>y</parameter> + (le coin en haut à gauche est l'origine (0,0)) avec la couleur + <parameter>col</parameter>. Si la police est 1, 2, 3, 4 ou 5, une police intégrée sera utilisée (plus le chiffre est grand, plus grande est la police).0 </para> <para> Voir aussi <function>imageloadfont</function>. </para> - </refsect1> </refentry> - <refentry id="function.imagecharup"> <refnamediv> <refname>ImageCharUp</refname> @@ -174,21 +165,20 @@ <paramdef>string <parameter>c</parameter></paramdef> <paramdef>int <parameter>col</parameter></paramdef> </funcsynopsis> - <para> - <function>imagecharup</function> dessine le premier caractère de la chaîne - <parameter>c</parameter> dans l'image <parameter>id</parameter> avec le coin - supérieur gauche placé à la position <parameter>x</parameter>,<parameter>y</parameter> - (le coin en haut à gauche est l'origine (0,0)), avec la couleur + <para> + <function>imagecharup</function> dessine le premier caractère de la chaîne + <parameter>c</parameter> dans l'image <parameter>id</parameter> avec le coin + supérieur gauche placé à la position <parameter>x</parameter>,<parameter>y</parameter> + (le coin en haut à gauche est l'origine (0,0)), avec la couleur <parameter>col</parameter>. - Si la police est 1, 2, 3, 4 ou 5, une police intégrée sera utilisée (plus le + Si la police est 1, 2, 3, 4 ou 5, une police intégrée sera utilisée (plus le chiffre est grand, plus grande est la police). </para> - <para> + <para> Voir aussi <function>imageloadfont</function>. </para> </refsect1> </refentry> - <refentry id="function.imagecolorallocate"> <refnamediv> <refname>ImageColorAllocate</refname> @@ -204,11 +194,11 @@ <paramdef>int <parameter>blue</parameter></paramdef> </funcsynopsis> <para> - <function>imagecolorallocate</function> retourne un identifiant de couleur, + <function>imagecolorallocate</function> retourne un identifiant de couleur, représentant la couleur composée avec les couleurs RGB (<parameter>red</parameter>, - <parameter>green</parameter>, <parameter>blue</parameter>). L'argument + <parameter>green</parameter>, <parameter>blue</parameter>). L'argument <parameter>im</parameter> est le résultat de la fonction <function>imagecreate</function>. - <function>imagecolorallocate</function> doit être appelée pour créer chaque couleur + <function>imagecolorallocate</function> doit être appelée pour créer chaque couleur qui sera représentée par <parameter>im</parameter>. <informalexample><programlisting> $white = ImageColorAllocate($im, 255,255,255); @@ -216,7 +206,6 @@ </programlisting></informalexample></para> </refsect1> </refentry> - <refentry id="function.imagecolordeallocate"> <refnamediv> <refname>ImageColorDeAllocate</refname> @@ -228,13 +217,13 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int + <funcdef>int <function>imagecolordeallocate</function> </funcdef> - <paramdef>int + <paramdef>int <parameter>im</parameter> </paramdef> - <paramdef>int + <paramdef>int <parameter>index</parameter> </paramdef> </funcprototype> @@ -251,7 +240,6 @@ </para> </refsect1> </refentry> - <refentry id="function.imagecolorat"> <refnamediv> <refname>ImageColorAt</refname> @@ -267,7 +255,7 @@ </funcsynopsis> <para> <function>imagecolorat</function> retourne l'index de la couleur du pixel situé - aux coordonnées (<parameter>x</parameter>, <parameter>y</parameter>), dans l'image + aux coordonnées (<parameter>x</parameter>, <parameter>y</parameter>), dans l'image <parameter>im</parameter>. </para> <para> @@ -275,7 +263,6 @@ </para> </refsect1> </refentry> - <refentry id="function.imagecolorclosest"> <refnamediv> <refname>ImageColorClosest</refname> @@ -291,7 +278,7 @@ <paramdef>int <parameter>blue</parameter></paramdef> </funcsynopsis> <para> - <function>imagecolorclosest</function> retourne l'index de la couleur de la + <function>imagecolorclosest</function> retourne l'index de la couleur de la palette qui est la plus proche de la valeur RGB passée. </para> <para> @@ -303,7 +290,6 @@ </para> </refsect1> </refentry> - <refentry id="function.imagecolorexact"> <refnamediv> <refname>ImageColorExact</refname> @@ -319,8 +305,8 @@ <paramdef>int <parameter>blue</parameter></paramdef> </funcsynopsis> <para> - <function>imagecolorexact</function> retourne l'index de la couleur spécifiée - dans la palette de l'image <parameter>im</parameter>. + <function>imagecolorexact</function> retourne l'index de la couleur spécifiée + dans la palette de l'image <parameter>im</parameter>. </para> <para> Si la couleur n'existe pas dans cette palettre, retourne -1. @@ -330,7 +316,6 @@ </para> </refsect1> </refentry> - <refentry id="function.imagecolorresolve"> <refnamediv> <refname>ImageColorResolve</refname> @@ -348,8 +333,8 @@ <paramdef>int <parameter>blue</parameter></paramdef> </funcsynopsis> <para> - <function>imagecolorresolve</function> retourne un index de couleur - à tous les coups. Soit il arrive à trouver la couleur + <function>imagecolorresolve</function> retourne un index de couleur + à tous les coups. Soit il arrive à trouver la couleur demandée dans la palette, soit il recherche la couleur la plus proche. </para> @@ -358,7 +343,6 @@ </para> </refsect1> </refentry> - <refentry id="function.imagegammacorrect"> <refnamediv> <refname>ImageGammaCorrect</refname> @@ -370,16 +354,16 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int + <funcdef>int <function>imagegammacorrect</function> </funcdef> - <paramdef>int + <paramdef>int <parameter>im</parameter> </paramdef> - <paramdef>double + <paramdef>double <parameter>inputgamma</parameter> </paramdef> - <paramdef>double + <paramdef>double <parameter>outputgamma</parameter> </paramdef> </funcprototype> @@ -387,12 +371,11 @@ <para> <function>imagegammacorrect</function> applique une correction gamma au flot d'image GD <parameter>im</parameter>. Le facteur d'entrée est - <parameter>inputgamma</parameter>, et le facteur de sortie est + <parameter>inputgamma</parameter>, et le facteur de sortie est <parameter>outputgamma</parameter>. </para> </refsect1> </refentry> - <refentry id="function.imagecolorset"> <refnamediv> <refname>ImageColorSet</refname> @@ -410,9 +393,9 @@ <paramdef>int <parameter>blue</parameter></paramdef> </funcsynopsis> <para> - <function>imagecolorset</function> permet d'attribuer à un index + <function>imagecolorset</function> permet d'attribuer à un index d'une palette une couleur spécifique. C'est une fonction très - pratique pour effectuer du remplissage de couleur sans le faire + pratique pour effectuer du remplissage de couleur sans le faire réellement. </para> <para> @@ -420,7 +403,6 @@ </para> </refsect1> </refentry> - <refentry id="function.imagecolorsforindex"> <refnamediv> <refname>ImageColorsForIndex</refname> @@ -434,17 +416,16 @@ <paramdef>int <parameter>index</parameter></paramdef> </funcsynopsis> <para> - <function>imagecolorsforindex</function> retourne un tableau associatif + <function>imagecolorsforindex</function> retourne un tableau associatif avec les couleur rouge (red) , vert (green), bleu (blue) qui contiennent les valeurs de la couleur correspondante. </para> <para> - Voir aussi <function>imagecolorat</function> et + Voir aussi <function>imagecolorat</function> et <function>imagecolorexact</function>. </para> </refsect1> </refentry> - <refentry id="function.imagecolorstotal"> <refnamediv> <refname>ImageColorsTotal</refname> @@ -460,12 +441,11 @@ <function>imagecolorstotal</function> retourne le nombre de couleur de la palette. </para> <para> - Voir aussi <function>imagecolorat</function> et + Voir aussi <function>imagecolorat</function> et <function>imagecolorsforindex</function>. </para> </refsect1> </refentry> - <refentry id="function.imagecolortransparent"> <refnamediv> <refname>ImageColorTransparent</refname> @@ -479,20 +459,19 @@ <paramdef>int <parameter><optional>col</optional></parameter></paramdef> </funcsynopsis> <para> - <function>imagecolortransparent</function> permet de choisir la couleur - transparente d'une image, et de lui donner la valeur de col. - <parameter>im</parameter> est un identifiant d'image, retourné - par <function>imagecreate</function> et + <function>imagecolortransparent</function> permet de choisir la couleur + transparente d'une image, et de lui donner la valeur de col. + <parameter>im</parameter> est un identifiant d'image, retourné + par <function>imagecreate</function> et <parameter><optional>col</optional></parameter> est un identifiant de couleur retourné par <function>imagecolorallocate</function>. </para> <para> - L'identifiant de la nouvelle (ou courante) couleur transparante est + L'identifiant de la nouvelle (ou courante) couleur transparante est retourné. </para> </refsect1> </refentry> - <refentry id="function.imagecopy"> <refnamediv> <refname>ImageCopy</refname> @@ -504,10 +483,10 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int + <funcdef>int <function>imagecopy</function> </funcdef> - <paramdef>int + <paramdef>int <parameter>dst_im</parameter> </paramdef> <paramdef>int @@ -516,34 +495,33 @@ <paramdef>int <parameter>dst_x</parameter> </paramdef> - <paramdef>int + <paramdef>int <parameter>dst_y</parameter> </paramdef> - <paramdef>int + <paramdef>int <parameter>src_x</parameter> </paramdef> - <paramdef>int + <paramdef>int <parameter>src_y</parameter> </paramdef> - <paramdef>int + <paramdef>int <parameter>src_w</parameter> </paramdef> - <paramdef>int + <paramdef>int <parameter>src_h</parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - Copie une partie de l'image <parameter>src_im</parameter> sur l'image de + Copie une partie de l'image <parameter>src_im</parameter> sur l'image de destination <parameter>dst_im</parameter>, en commencant aux coordonnées <parameter>src_x</parameter>, <parameter>src_y </parameter> et sur la largeur de <parameter>src_w</parameter> et la hauteur de <parameter>src_h</parameter>. - La portion ainsi définie sera copiée et placée aux + La portion ainsi définie sera copiée et placée aux coordonnées <parameter>dst_x</parameter> et <parameter>dst_y</parameter>. </para> </refsect1> </refentry> - <refentry id="function.imagecopyresized"> <refnamediv> <refname>ImageCopyResized</refname> @@ -565,22 +543,21 @@ <paramdef>int <parameter>srcH</parameter></paramdef> </funcsynopsis> <para> - <function>imagecopyresized</function> copie une partie rectangulaire d'une image - dans une autre image de destination. <parameter>dst_im</parameter> est l'image - de destination, <parameter>src_im</parameter> est l'image source. Si les dimensions - de la source et de la destination ne sont pas égales, un + <function>imagecopyresized</function> copie une partie rectangulaire d'une image + dans une autre image de destination. <parameter>dst_im</parameter> est l'image + de destination, <parameter>src_im</parameter> est l'image source. Si les dimensions + de la source et de la destination ne sont pas égales, un étirement adéquat est effectué pour faire correspondre - les deux. Les coordonnées fournies se repère par rapport - au coin supérieur gauche. Cete fonction peut être + les deux. Les coordonnées fournies se repère par rapport + au coin supérieur gauche. Cete fonction peut être utilisée pour recopier des régions à l'intérieur - d'une même image, si <parameter>dst_im</parameter> et - <parameter>src_im</parameter> sont identiques : mais si les + d'une même image, si <parameter>dst_im</parameter> et + <parameter>src_im</parameter> sont identiques : mais si les régions se chevauchent, le résultat risque d'être incohérent. </para> </refsect1> </refentry> - <refentry id="function.imagecreate"> <refnamediv> <refname>ImageCreate</refname> @@ -593,14 +570,13 @@ <paramdef>int <parameter>x_size</parameter></paramdef> <paramdef>int <parameter>y_size</parameter></paramdef> </funcsynopsis> - <para> - <function>imagecreate</function> retourne un identifiant d'image + <para> + <function>imagecreate</function> retourne un identifiant d'image représentant une image blanche, de largeur <parameter>x_size</parameter> et longueur <parameter>y_size</parameter>. </para> </refsect1> </refentry> - <refentry id="function.imagecreatefromgif"> <refnamediv> <refname>ImageCreateFromGif</refname> @@ -615,13 +591,13 @@ <paramdef>string <parameter>filename</parameter></paramdef> </funcsynopsis> <para> - <function>imagecreatefromgif</function> retourne un identifiant d'image qui - représente l'image obtenue à partir du fichier dont le nom est + <function>imagecreatefromgif</function> retourne un identifiant d'image qui + représente l'image obtenue à partir du fichier dont le nom est donné. </para> - <para> - <function>imagecreatefromgif</function> retourne une chaîne vide en - cas d'échec. Il va aussi retourner une erreur qui va afficher un + <para> + <function>imagecreatefromgif</function> retourne une chaîne vide en + cas d'échec. Il va aussi retourner une erreur qui va afficher un lien brisé dans un navigateur. Pour simplifier le débuggage, utilisez le code suivant, qui retourne une erreur GIF : <example> @@ -645,21 +621,20 @@ </example> <note> <para> - Etant donné que toutes les fonctions de gestion des GIF ont - été supprimées de la bibliothèque GD - version 1.6, cette fonction n'est pas disponible si vous utilisez + Etant donné que toutes les fonctions de gestion des GIF ont + été supprimées de la bibliothèque GD + version 1.6, cette fonction n'est pas disponible si vous utilisez cette version de la librairie. </para> </note> </para> </refsect1> </refentry> - <refentry id="function.imagecreatefromjpeg"> <refnamediv> <refname>ImageCreateFromJPEG</refname> <refpurpose> - Crée une nouvelle image <acronym>JPEG</acronym> + Crée une nouvelle image <acronym>JPEG</acronym> à partir d'un fichier ou d'une URL </refpurpose> </refnamediv> @@ -673,13 +648,13 @@ </funcsynopsis> <para> <function>imagecreatefromjpeg</function> retourne un identifiant d'image - représentant un image obtenu à partir du fichier + représentant un image obtenu à partir du fichier <parameter>filename</parameter>. </para> - <para> + <para> <function>imagecreatefromjpeg</function> retourne une chaîne vide en cas d'échec. Elle affiche aussi un message d'erreur, qui s'affiche comme un - lien brisé dans un navigateur web. Pour faciliter le débuggage, + lien brisé dans un navigateur web. Pour faciliter le débuggage, voici une erreur <acronym>JPEG</acronym>: <example> <title> @@ -695,7 +670,7 @@ $tc = ImageColorAllocate ($im, 0, 0, 0); ImageFilledRectangle ($im, 0, 0, 150, 30, $bgc); /* Affichage d'un message d'erreur */ - ImageString ($im, 1, 5, 5, "Erreur de chargement de l'image $imgname", $tc); + ImageString ($im, 1, 5, 5, "Erreur de chargement de l'image $imgname", $tc); } return $im; } @@ -704,12 +679,11 @@ </para> </refsect1> </refentry> - <refentry id="function.imagecreatefrompng"> <refnamediv> <refname>ImageCreateFromPNG</refname> <refpurpose> - Crée une nouvelle image <acronym>PNG</acronym> à partir d'un fichier ou d'une URL + Crée une nouvelle image <acronym>PNG</acronym> à partir d'un fichier ou d'une URL </refpurpose> </refnamediv> <refsect1> @@ -722,13 +696,13 @@ </funcsynopsis> <para> <function>imagecreatefrompng</function> retourne un identifiant d'image - représentant un image obtenu à partir du fichier + représentant un image obtenu à partir du fichier <parameter>filename</parameter>. </para> - <para> + <para> <function>imagecreatefromjpeg</function> retourne une chaîne vide en cas d'échec. Elle affiche aussi un message d'erreur, qui s'affiche comme un - lien brisé dans un navigateur web. Pour faciliter le débuggage, + lien brisé dans un navigateur web. Pour faciliter le débuggage, voici une erreur <acronym>PNG</acronym>: <example> <title> @@ -744,7 +718,7 @@ $tc = ImageColorAllocate ($im, 0, 0, 0); ImageFilledRectangle ($im, 0, 0, 150, 30, $bgc); /* Affichage d'un message d'erreur */ - ImageString ($im, 1, 5, 5, "Erreur de chargement de l'image $imgname", $tc); + ImageString ($im, 1, 5, 5, "Erreur de chargement de l'image $imgname", $tc); } return $im; } @@ -753,7 +727,6 @@ </para> </refsect1> </refentry> - <refentry id="function.imagedashedline"> <refnamediv> <refname>ImageDashedLine</refname> @@ -770,19 +743,18 @@ <paramdef>int <parameter>y2</parameter></paramdef> <paramdef>int <parameter>col</parameter></paramdef> </funcsynopsis> - <para> - <function>imagedashedline</function> dessine une ligne pointillée + <para> + <function>imagedashedline</function> dessine une ligne pointillée entre les points (<parameter>x1</parameter>,<parameter>y1</parameter>) - et (<parameter>x2</parameter>,<parameter>y2</parameter>) (le coin - supérieur droit est l'origine (0,0)) dans l'image + et (<parameter>x2</parameter>,<parameter>y2</parameter>) (le coin + supérieur droit est l'origine (0,0)) dans l'image <parameter>im</parameter>, avec la couleur <parameter>col</parameter>. </para> - <para> + <para> Voir aussi <function>imageline</function>. </para> </refsect1> </refentry> - <refentry id="function.imagedestroy"> <refnamediv> <refname>ImageDestroy</refname> @@ -794,15 +766,14 @@ <funcdef>int <function>imagedestroy</function></funcdef> <paramdef>int <parameter>im</parameter></paramdef> </funcsynopsis> - <para> - <function>imagedestroy</function> libère toute la mémoire - associée avec l'image <parameter>im</parameter>. - <parameter>im</parameter> est un identifiant d'image valide retourné + <para> + <function>imagedestroy</function> libère toute la mémoire + associée avec l'image <parameter>im</parameter>. + <parameter>im</parameter> est un identifiant d'image valide retourné par <function>imagecreate</function>. </para> </refsect1> </refentry> - <refentry id="function.imagefill"> <refnamediv> <refname>ImageFill</refname> @@ -817,16 +788,15 @@ <paramdef>int <parameter>y</parameter></paramdef> <paramdef>int <parameter>col</parameter></paramdef> </funcsynopsis> - <para> - <function>imagefill</function> effectue un remplissage avec la couleur - <parameter>col</parameter>, dans l'image <parameter>im</parameter>, + <para> + <function>imagefill</function> effectue un remplissage avec la couleur + <parameter>col</parameter>, dans l'image <parameter>im</parameter>, à partir du point de coordonnées (<parameter>x</parameter>, - <parameter>y</parameter>) (le coin supérieur gauche est + <parameter>y</parameter>) (le coin supérieur gauche est l'origine (0,0)). </para> </refsect1> </refentry> - <refentry id="function.imagefilledpolygon"> <refnamediv> <refname>ImageFilledPolygon</refname> @@ -841,16 +811,15 @@ <paramdef>int <parameter>num_points</parameter></paramdef> <paramdef>int <parameter>col</parameter></paramdef> </funcsynopsis> - <para> - <function>imagefilledpolygon</function> dessine un polygone rempli dans l'image - <parameter>im</parameter>. <parameter>points</parameter> est un tableau PHP qui - contient les sommets des polygones sous la forme :. points[0] = x0, + <para> + <function>imagefilledpolygon</function> dessine un polygone rempli dans l'image + <parameter>im</parameter>. <parameter>points</parameter> est un tableau PHP qui + contient les sommets des polygones sous la forme :. points[0] = x0, points[1] = y0, points[2] = x1, points[3] = y1, etc. <parameter>num_points</parameter> est le nombre total de sommets. </para> </refsect1> </refentry> - <refentry id="function.imagefilledrectangle"> <refnamediv> <refname>ImageFilledRectangle</refname> @@ -867,16 +836,15 @@ <paramdef>int <parameter>y2</parameter></paramdef> <paramdef>int <parameter>col</parameter></paramdef> </funcsynopsis> - <para> - <function>imagefilledrectangle</function> dessine un rectangle de couleur - <parameter>col</parameter> dans l'image <parameter>im</parameter>, en commencant + <para> + <function>imagefilledrectangle</function> dessine un rectangle de couleur + <parameter>col</parameter> dans l'image <parameter>im</parameter>, en commencant par le sommet supérieur gauche (<parameter>x1</parameter>, <parameter>y1</parameter>) - et finissant au sommet inférieur droit (<parameter>x2</parameter>, <parameter>y2</parameter>). + et finissant au sommet inférieur droit (<parameter>x2</parameter>, <parameter>y2</parameter>). Le coin supérieur gauche est l'origine (0, 0). </para> </refsect1> </refentry> - <refentry id="function.imagefilltoborder"> <refnamediv> <refname>ImageFillToBorder</refname> @@ -892,16 +860,15 @@ <paramdef>int <parameter>border</parameter></paramdef> <paramdef>int <parameter>col</parameter></paramdef> </funcsynopsis> - <para> + <para> <function>imagefilltoborder</function> remplit avec la couleur <parameter>col</parameter> - toute la région à l'intérieur de la région limitée par la couleur - <parameter>border</parameter>. Le point de départ est - (<parameter>x</parameter>,<parameter>y</parameter>) + toute la région à l'intérieur de la région limitée par la couleur + <parameter>border</parameter>. Le point de départ est + (<parameter>x</parameter>,<parameter>y</parameter>) (le coin supérieur gauche est l'origine (0,0)). </para> </refsect1> </refentry> - <refentry id="function.imagefontheight"> <refnamediv> <refname>ImageFontHeight</refname> @@ -921,7 +888,6 @@ </para> </refsect1> </refentry> - <refentry id="function.imagefontwidth"> <refnamediv> <refname>ImageFontWidth</refname> @@ -933,15 +899,14 @@ <funcdef>int <function>imagefontwidth</function></funcdef> <paramdef>int <parameter>font</parameter></paramdef> </funcsynopsis> - <para> + <para> <function>imagefontwidth</function> retourne la largeur de la police en pixels. </para> - <para> + <para> Voir aussi <function>imagefontheight</function> et <function>imageloadfont</function>. </para> </refsect1> </refentry> - <refentry id="function.imagegif"> <refnamediv> <refname>ImageGif</refname> @@ -955,9 +920,9 @@ <paramdef>string <parameter>filename</parameter></paramdef> </funcsynopsis> <para> - <function>imagegif</function> crée un fichier image GIF avec le nom - <parameter>filename</parameter> d'après l'image <parameter>im</parameter>. - L'argument <parameter>im</parameter> est un identifiant valide retourné par la + <function>imagegif</function> crée un fichier image GIF avec le nom + <parameter>filename</parameter> d'après l'image <parameter>im</parameter>. + L'argument <parameter>im</parameter> est un identifiant valide retourné par la fonction <function>imagecreate</function>. </para> <para> @@ -966,21 +931,21 @@ ce qui fera qu'elle sera au format GIF89a. </para> <para> - Le nom du fichier est optionnel, et dans ce cas, l'image sera transmise - directement à la sortie standard. En envoyant une image de type image/gif - content-type, (grâce à la fonction <function>header</function>), vous pouvez + Le nom du fichier est optionnel, et dans ce cas, l'image sera transmise + directement à la sortie standard. En envoyant une image de type image/gif + content-type, (grâce à la fonction <function>header</function>), vous pouvez créer des images avec des scripts PHP. <note> <para> - Etant donné que toutes les fonctions GIF ont été supprimées de la bibliothèque - GD version 1.6, cette fonction ne sera pas accessible si vous avez cette + Etant donné que toutes les fonctions GIF ont été supprimées de la bibliothèque + GD version 1.6, cette fonction ne sera pas accessible si vous avez cette version de la librairie. </para> <para> - Le code suivant vous permet d'écrire des scripts PHP plus portables : + Le code suivant vous permet d'écrire des scripts PHP plus portables : le type de GD est automatiquement détecté. Il remplace la séquence <literal>Header("Content-type: image/gif"); - ImageGif($im);</literal> par un code plus souple : + ImageGif($im);</literal> par un code plus souple : <informalexample> <programlisting role="php"> <?php @@ -1006,9 +971,9 @@ <note> <para> En PHP4, à partir de la version 4.0.2, vous pouvez utiliser la fonction - <function>imagetypes</function> a la place de + <function>imagetypes</function> a la place de <function>function_exists</function> pour vérifier que certains - formats d'images sont supportés : + formats d'images sont supportés : <informalexample> <programlisting role="php"> if (ImageTypes() & IMG_GIF) { @@ -1027,7 +992,6 @@ </para> </refsect1> </refentry> - <refentry id="function.imagepng"> <refnamediv> <refname>ImagePNG</refname> @@ -1039,7 +1003,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int + <funcdef>int <function>imagepng</function> </funcdef> <paramdef>int <parameter>im</parameter></paramdef> @@ -1048,7 +1012,7 @@ </funcsynopsis> <para> <function>imagepng</function> envoie l'image GD (<parameter>im</parameter>) - au format PNG sur la sortie standard (typiquement, le navigateur web), ou + au format PNG sur la sortie standard (typiquement, le navigateur web), ou si <parameter>filename</parameter> est fourni, l'envoie dans un fichier. <informalexample> <programlisting role="php"> @@ -1060,9 +1024,9 @@ </informalexample> </para> <para> - Le nom du fichier est optionnel, et dans ce cas, l'image sera transmise - directement à la sortie standard. En envoyant une image de type image/png - content-type, (grâce à la fonction <function>header</function>), + Le nom du fichier est optionnel, et dans ce cas, l'image sera transmise + directement à la sortie standard. En envoyant une image de type image/png + content-type, (grâce à la fonction <function>header</function>), vous pouvez créer des images PNG avec des scripts PHP. </para> <para> @@ -1071,7 +1035,6 @@ </para> </refsect1> </refentry> - <refentry id="function.imagejpeg"> <refnamediv> <refname>ImageJPEG</refname> @@ -1085,30 +1048,30 @@ <funcprototype> <funcdef>int <function>imagejpeg</function></funcdef> <paramdef>int <parameter>im</parameter></paramdef> - <paramdef>string + <paramdef>string <parameter><optional>filename</optional></parameter> </paramdef> - <paramdef>int + <paramdef>int <parameter><optional>quality</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - <function>imagepng</function> envoie l'image GD (<parameter>im</parameter>) - au format JPEG sur la sortie standard (typiquement, le navigateur web), ou + <function>imagejpeg</function> envoie l'image GD (<parameter>im</parameter>) + au format JPEG sur la sortie standard (typiquement, le navigateur web), ou si <parameter>filename</parameter> est fourni, l'envoi dans un fichier. <parameter>im</parameter> a été créé par <function>imagecreate</function>. </para> <para> - Le nom du fichier est optionnel, et dans ce cas, l'image sera transmise - directement à la sortie standard. En envoyant une image de type image/jpeg - content-type, (grâce à la fonction <function>header</function>), + Le nom du fichier est optionnel, et dans ce cas, l'image sera transmise + directement à la sortie standard. En envoyant une image de type image/jpeg + content-type, (grâce à la fonction <function>header</function>), vous pouvez créer des images JPEG avec des scripts PHP. </para> <note> <para> Le support JPEG n'est disponible que si PHP est compilé avec GD-1.8 ou plus récent. - </para> + </para> </note> <para> Voir aussi <function>imagepng</function>, @@ -1116,7 +1079,6 @@ </para> </refsect1> </refentry> - <refentry id="function.imageinterlace"> <refnamediv> <refname>ImageInterlace</refname> @@ -1130,8 +1092,8 @@ <paramdef>int <parameter><optional>interlace</optional></parameter></paramdef> </funcsynopsis> <para> - <function>imageinterlace</function> active ou désactive le bit d'entrelacement. - Si l'entrelacement est à 1, l'image <parameter>im</parameter> sera interlacée, et + <function>imageinterlace</function> active ou désactive le bit d'entrelacement. + Si l'entrelacement est à 1, l'image <parameter>im</parameter> sera interlacée, et sinon, elle ne le sera pas. </para> <para> @@ -1139,7 +1101,6 @@ </para> </refsect1> </refentry> - <refentry id="function.imageline"> <refnamediv> <refname>ImageLine</refname> @@ -1156,25 +1117,23 @@ <paramdef>int <parameter>y2</parameter></paramdef> <paramdef>int <parameter>col</parameter></paramdef> </funcsynopsis> - <para> - <function>imageline</function> dessine une ligne depuis le point - (<parameter>x1</parameter>,<parameter>y1</parameter>) jusqu'au point - (<parameter>x2</parameter>,<parameter>y2</parameter>) + <para> + <function>imageline</function> dessine une ligne depuis le point + (<parameter>x1</parameter>,<parameter>y1</parameter>) jusqu'au point + (<parameter>x2</parameter>,<parameter>y2</parameter>) (le coin supérieur gauche est l'origine (0,0)) dans l'image <parameter>im</parameter> et avec la couleur <parameter>col</parameter>. - </para> - <para> + </para> + <para> Voir aussi <function>imagecreate</function> et <function>imagecolorallocate</function>. </para> </refsect1> </refentry> - <refentry id="function.imageloadfont"> <refnamediv> <refname>ImageLoadFont</refname> <refpurpose>Charge une nouvelle police.</refpurpose> </refnamediv> - <refsect1> <title>Description</title> <funcsynopsis> @@ -1182,13 +1141,13 @@ <paramdef>string <parameter>file</parameter></paramdef> </funcsynopsis> <para> - <function>imageloadfont</function> charge une nouvelle police utilisateur et - retourne un identifiant sur cette police. Cet identifiant sera toujours supérieur + <function>imageloadfont</function> charge une nouvelle police utilisateur et + retourne un identifiant sur cette police. Cet identifiant sera toujours supérieur à 5, pour éviter les conflits avec les polices standard PHP). </para> <para> - Le format des polices dépend actuellement du système d'exploitation. Ce qui - signifie qu'il vous faut générer des fichiers de polices pour la machine qui + Le format des polices dépend actuellement du système d'exploitation. Ce qui + signifie qu'il vous faut générer des fichiers de polices pour la machine qui fait tourner PHP. </para> <para> @@ -1233,18 +1192,14 @@ caractère, avec un total de (nombre_caractères*largeur*hauteur) octets. </entry> </row> - </tbody> </tgroup> </table></para> - <para> Voir aussi <function>imagefontwidth</function> et <function>imagefontheight</function>. </para> - </refsect1> </refentry> - <refentry id="function.imagepolygon"> <refnamediv> <refname>ImagePolygon</refname> @@ -1259,23 +1214,22 @@ <paramdef>int <parameter>num_points</parameter></paramdef> <paramdef>int <parameter>col</parameter></paramdef> </funcsynopsis> - <para> - <function>imagepolygon</function> dessine un polygone dans l'image <parameter>im</parameter>. - <parameter>points</parameter> est un tableau PHP qui contient les sommets du - polygone sous la forme : points[0] = x0, points[1] = y0, points[2] = x1, + <para> + <function>imagepolygon</function> dessine un polygone dans l'image <parameter>im</parameter>. + <parameter>points</parameter> est un tableau PHP qui contient les sommets du + polygone sous la forme : points[0] = x0, points[1] = y0, points[2] = x1, points[3] = y1, etc. num_points est le nombre de sommets. </para> - <para> + <para> Voir aussi <function>imagecreate</function>. </para> </refsect1> </refentry> - <refentry id="function.imagepsbbox"> <refnamediv> <refname>ImagePSBBox</refname> <refpurpose> - Retourne le rectangle entourant un texte et dessiné avec une police PostScript + Retourne le rectangle entourant un texte et dessiné avec une police PostScript Type1. </refpurpose> </refnamediv> @@ -1303,12 +1257,12 @@ <parameter>angle</parameter> est en degrés. </para> <para> - Les paramètres <parameter>space</parameter> et <parameter>tightness</parameter> - sont exprimés en unité d'espacement de caractères, avec 1 unité vaut 1/1000 d'un + Les paramètres <parameter>space</parameter> et <parameter>tightness</parameter> + sont exprimés en unité d'espacement de caractères, avec 1 unité vaut 1/1000 d'un em carré ( ? ? ?). </para> <para> - Les paramètres <parameter>space</parameter>, <parameter>tightness</parameter> et + Les paramètres <parameter>space</parameter>, <parameter>tightness</parameter> et <parameter>angle</parameter> sont optionnels. </para> <para> @@ -1343,11 +1297,9 @@ </para> </refsect1> </refentry> -  - <refentry id="function.imagepsencodefont"> <refnamediv> <refname>ImagePSEncodeFont</refname> @@ -1396,22 +1347,21 @@ <paramdef>string <parameter>encodingfile</parameter></paramdef> </funcsynopsis> <para> - <function>imagepsencodefont</function> charge le codage vectoriel d'un caractère - depuis un fichier et change le codage vectoriel de la police correspondante. Etant - donné que les polices PostScript de disposent pas des caractères au-delà de 127, - vous aurez surement besoin de les changer sur vous utilisez une autre langue que - l'anglais. Le format exact est décrit dans la documentation T1libs. T1lib est + <function>imagepsencodefont</function> charge le codage vectoriel d'un caractère + depuis un fichier et change le codage vectoriel de la police correspondante. Etant + donné que les polices PostScript de disposent pas des caractères au-delà de 127, + vous aurez surement besoin de les changer sur vous utilisez une autre langue que + l'anglais. Le format exact est décrit dans la documentation T1libs. T1lib est disponible en deux formes : IsoLatin1.enc et IsoLatin2.enc. </para> <para> - Si vous commencez à utiliser cette fonction régulièrement, une meilleure solution - est de définir un encodage, et de l'utiliser avec set ps.default_encoding dans - <link linkend="configuration.file">le fichier de configuration</link> pour + Si vous commencez à utiliser cette fonction régulièrement, une meilleure solution + est de définir un encodage, et de l'utiliser avec set ps.default_encoding dans + <link linkend="configuration.file">le fichier de configuration</link> pour utiliser par défaut l'encodage correct. </para> </refsect1> </refentry> - <refentry id="function.imagepsfreefont"> <refnamediv> <refname>ImagePSFreeFont</refname> @@ -1428,7 +1378,6 @@ </para> </refsect1> </refentry> - <refentry id="function.imagepsloadfont"> <refnamediv> <refname>ImagePSLoadFont</refname> @@ -1441,8 +1390,8 @@ <paramdef>string <parameter>filename</parameter></paramdef> </funcsynopsis> <para> - Au cas oú tout a bien marché, un index de police va être retourné, et pourra être - utilisé pour des opérations ultérieures. Sinon, la fonction retourne FALSE et + Au cas oú tout a bien marché, un index de police va être retourné, et pourra être + utilisé pour des opérations ultérieures. Sinon, la fonction retourne FALSE et affiche un message décrivant ce qui est erroné. </para> <para> @@ -1450,7 +1399,6 @@ </para> </refsect1> </refentry> - <refentry id="function.imagepsextendfont"> <refnamediv> <refname>ImagePsExtendFont</refname> @@ -1465,10 +1413,10 @@ <funcdef>bool <function>imagepsextendfont</function> </funcdef> - <paramdef>int + <paramdef>int <parameter>font_index</parameter> </paramdef> - <paramdef>double + <paramdef>double <parameter>extend</parameter> </paramdef> </funcprototype> @@ -1476,11 +1424,10 @@ <para> Etend ou condense la police de caractères <parameter>font_index</parameter>. Si la valeur de <parameter>extend</parameter> est inférieure à 1, ce sera une - condensation. + condensation. </para> </refsect1> </refentry> - <refentry id="function.imagepsslantfont"> <refnamediv> <refname>ImagePsSlantFont</refname> @@ -1492,25 +1439,24 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>bool + <funcdef>bool <function>imagepsslantfont</function> </funcdef> - <paramdef>int + <paramdef>int <parameter>font_index</parameter> </paramdef> - <paramdef>double + <paramdef>double <parameter>slant</parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - Met en italique la police de caractères - <parameter>font_index</parameter> avec le coefficient + Met en italique la police de caractères + <parameter>font_index</parameter> avec le coefficient <parameter>slant</parameter>. </para> </refsect1> </refentry> - <refentry id="function.imagepstext"> <refnamediv> <refname>ImagePSText</refname> @@ -1541,41 +1487,47 @@ <parameter>size</parameter> est exprimé en pixels. </para> <para> - <parameter>foreground</parameter> est la couleur dans laquelle le texte va + <parameter>foreground</parameter> est la couleur dans laquelle le texte va être dessiné. <parameter>background</parameter> est la couleur d'anti aliasing. - Aucun pixel avec la couleur <parameter>background</parameter> n'est dessiné, ce + Aucun pixel avec la couleur <parameter>background</parameter> n'est dessiné, ce qui fait que l'arrière plan n'a pas besoin d'être dans une couleur fixe. </para> <para> - Les coordonnées données (<parameter>x</parameter>, <parameter>y</parameter>) - définissent l'origine du premier caractère (grossièrement, le coin inférieur - gauche du caractère). Ceci est différent de la fonction - <function>imagestring</function>, oú (x, y) définissait le coin supérieur gauche - du premier caracètre. Reportez vous à la documentation PostScript pour avoir des - détails à propos des polices et de leurs tailles. + Les coordonnées données (<parameter>x</parameter>, + <parameter>y</parameter>) définissent l'origine du premier + caractère (grossièrement, le coin inférieur + gauche du caractère). Ceci est différent de la fonction + <function>imagestring</function>, oú (x, y) définissait le + coin supérieur gauche du premier caracètre. Reportez vous + à la documentation PostScript pour avoir des détails à + propos des polices et de leurs tailles. + </para> + <para> + <parameter>space</parameter> permet de changer la taille par défaut + du caractère d'espacement. Cette valeur peut être négative. + </para> + <para> + <parameter>tightness</parameter> permet de contrôler la quantité + d'espace entre deux caractères. Cette valeur peut être + négative. </para> <para> - <parameter>space</parameter> permet de changer la taille par défaut du caractère d'espacement. Cette valeur peut être négative. - </para> - <para> - <parameter>tightness</parameter> permet de contrôler la quantité d'espace entre deux caractères. Cette valeur peut être négative. + <parameter>angle</parameter> est en degrés. </para> <para> - <parameter>angle</parameter> est en degrés.</para> - <para> <parameter>antialias_steps</parameter> permet de contrôler le nombre de couleurs - du texte anti-aliasé. Les valeurs autorisées sont 4 et 16. 16 est recommandé pour - les polices de moins de 20 pixels, car l'effet est alors visible. Avec les - tailles plus grandes, utilisez de préférence 4, qui est moins gourmande en + du texte anti-aliasé. Les valeurs autorisées sont 4 et 16. 16 est recommandé pour + les polices de moins de 20 pixels, car l'effet est alors visible. Avec les + tailles plus grandes, utilisez de préférence 4, qui est moins gourmande en ressources. </para> <para> - Les paramètres <parameter>space</parameter> et <parameter>tightness</parameter> - sont exprimés en unité d'espace caractère, ce qui vaut 1/1000ème d'un em-carré + Les paramètres <parameter>space</parameter> et <parameter>tightness</parameter> + sont exprimés en unité d'espace caractère, ce qui vaut 1/1000ème d'un em-carré ( ? ? ?). </para> <para> - Les paramètres <parameter>space</parameter>, <parameter>tightness</parameter>, + Les paramètres <parameter>space</parameter>, <parameter>tightness</parameter>, <parameter>angle</parameter> et <parameter>antialias</parameter> sont optionnels. </para> <para> @@ -1607,7 +1559,6 @@ </para> </refsect1> </refentry> - <refentry id="function.imagerectangle"> <refnamediv> <refname>ImageRectangle</refname> @@ -1624,16 +1575,15 @@ <paramdef>int <parameter>y2</parameter></paramdef> <paramdef>int <parameter>col</parameter></paramdef> </funcsynopsis> - <para> - <function>imagerectangle</function> dessine un rectangle dans la couleur - <parameter>col</parameter>, dans l'image <parameter>im</parameter>, et en - commencant au point supérieur gauche (<parameter>x1</parameter>,<parameter>y1</parameter>), - et en finissant au point inférieur droit (<parameter>x2</parameter>,<parameter>y2</parameter>). + <para> + <function>imagerectangle</function> dessine un rectangle dans la couleur + <parameter>col</parameter>, dans l'image <parameter>im</parameter>, et en + commencant au point supérieur gauche (<parameter>x1</parameter>,<parameter>y1</parameter>), + et en finissant au point inférieur droit (<parameter>x2</parameter>,<parameter>y2</parameter>). Le coin supérieur gauche est l'origine (0,0). </para> </refsect1> </refentry> - <refentry id="function.imagesetpixel"> <refnamediv> <refname>ImageSetPixel</refname> @@ -1648,18 +1598,17 @@ <paramdef>int <parameter>y</parameter></paramdef> <paramdef>int <parameter>col</parameter></paramdef> </funcsynopsis> - <para> - <function>imagesetpixel</function> dessine un pixel au point - (<parameter>x</parameter>,<parameter>y</parameter>) - (le coin supérieur gauche est l'origine (0,0)) dans l'image <parameter>im</parameter>, + <para> + <function>imagesetpixel</function> dessine un pixel au point + (<parameter>x</parameter>,<parameter>y</parameter>) + (le coin supérieur gauche est l'origine (0,0)) dans l'image <parameter>im</parameter>, et avec la couleur <parameter>col</parameter>. - </para> + </para> <para> Voir aussi <function>imagecreate</function> et <function>imagecolorallocate</function>. </para> </refsect1> </refentry> - <refentry id="function.imagestring"> <refnamediv> <refname>ImageString</refname> @@ -1676,19 +1625,19 @@ <paramdef>string <parameter>s</parameter></paramdef> <paramdef>int <parameter>col</parameter></paramdef> </funcsynopsis> - <para> - <function>imagestring</function> dessine une ligne horizontale, dans l'image - <parameter>im</parameter>, aux coordonnées (<parameter>x</parameter>,<parameter>y</parameter>) - (le coin supérieur gauche est l'origine (0,0)) dans la couleur <parameter>col</parameter>. - Si l'argument de police vaut 1, 2, 3, 4 ou 5, une des polices par défaut sera + <para> + <function>imagestring</function> dessine une la chaîne sur une ligne + horizontale, dans l'image <parameter>im</parameter>, aux coordonnées + (<parameter>x</parameter>,<parameter>y</parameter>) (le coin supérieur + gauche est l'origine (0,0)) dans la couleur <parameter>col</parameter>. + Si l'argument de police vaut 1, 2, 3, 4 ou 5, une des polices par défaut sera utilisée). - </para> + </para> <para> Voir aussi <function>imageloadfont</function>. </para> </refsect1> </refentry> - <refentry id="function.imagestringup"> <refnamediv> <refname>ImageStringUp</refname> @@ -1705,18 +1654,19 @@ <paramdef>string <parameter>s</parameter></paramdef> <paramdef>int <parameter>col</parameter></paramdef> </funcsynopsis> - <para> - <function>imagestringup</function> dessine une chaîne verticale dans l'image - <parameter>im</parameter> aux coordonnées (<parameter>x</parameter>, <parameter>y</parameter>) - (l'origine est le coin supérieur gauche (0,0)) dans la couleur <parameter>col</parameter>. - Si la police utilisée est 1, 2, 3, 4 ou 5, une police par défaut sera utilisée. + <para> + <function>imagestringup</function> dessine une chaîne sur une ligne + verticale dans l'image <parameter>im</parameter> aux coordonnées + (<parameter>x</parameter>, <parameter>y</parameter>) (l'origine est le coin + supérieur gauche (0,0)) dans la couleur <parameter>col</parameter>. + Si la police utilisée est 1, 2, 3, 4 ou 5, une police par défaut + sera utilisée. </para> <para> Voir aussi <function>imageloadfont</function>. </para> </refsect1> </refentry> - <refentry id="function.imagesx"> <refnamediv> <refname>ImageSX</refname> @@ -1728,16 +1678,15 @@ <funcdef>int <function>imagesx</function></funcdef> <paramdef>int <parameter>im</parameter></paramdef> </funcsynopsis> - <para> - <function>imagesx</function> retourne la largeur de l'image référencée par + <para> + <function>imagesx</function> retourne la largeur de l'image référencée par <parameter>im</parameter>. </para> - <para> + <para> Voir aussi <function>imagecreate</function> et <function>imagesy</function>. </para> </refsect1> </refentry> - <refentry id="function.imagesy"> <refnamediv> <refname>ImageSY</refname> @@ -1750,7 +1699,7 @@ <paramdef>int <parameter>im</parameter></paramdef> </funcsynopsis> <para> - <function>imagesy</function> retourne la hauteur de l'image référencée par + <function>imagesy</function> retourne la hauteur de l'image référencée par <parameter>im</parameter>. </para> <para> @@ -1758,7 +1707,6 @@ </para> </refsect1> </refentry> - <refentry id="function.imagettfbbox"> <refnamediv> <refname>ImageTTFBBox</refname> @@ -1774,7 +1722,7 @@ <paramdef>string <parameter>text</parameter></paramdef> </funcsynopsis> <para> - <function>imagettfbbox</function> calcule et retourne le rectangle entourant + <function>imagettfbbox</function> calcule et retourne le rectangle entourant le texte <parameter>text</parameter>, écrit avec une police truetype. <variablelist> <varlistentry> @@ -1792,14 +1740,12 @@ </varlistentry> <varlistentry> <term><parameter>angle</parameter></term> - <listitem><simpara>Angle en degré dans lequel le texte <parameter>text</parameter> + <listitem><simpara>Angle en degré dans lequel le texte <parameter>text</parameter> va être mesuré. </simpara></listitem> </varlistentry> </variablelist> - - <function>imagettfbbox</function> retourne une tableau avec 8 éléments, + <function>imagettfbbox</function> retourne une tableau avec 8 éléments, représentants les 4 sommets du rectangle ainsi définis. - <informaltable> <tgroup cols="2"> <tbody> @@ -1838,8 +1784,8 @@ </tbody> </tgroup> </informaltable> - Les positions des points sont relatives au texte <emphasis>text</emphasis>, - indépendamment de l'angle : coin supérieur gauche faire référence au coin + Les positions des points sont relatives au texte <emphasis>text</emphasis>, + indépendamment de l'angle : coin supérieur gauche faire référence au coin supérieur gauche du texte écrit horizontalement. </para> <para> @@ -1850,7 +1796,6 @@ </para> </refsect1> </refentry> - <refentry id="function.imagettftext"> <refnamediv> <refname>ImageTTFText</refname> @@ -1870,46 +1815,46 @@ <paramdef>string <parameter>text</parameter></paramdef> </funcsynopsis> <para> - <function>imagettftext</function> dessine la chaîne <parameter>text</parameter> - dans l'image <parameter>im</parameter>, en commancant aux coordonnées - (<parameter>x</parameter>,<parameter>y</parameter>) (le coin supérieur gauche est - l'origine (0,0)), avec un angle de <parameter>angle</parameter>, et dans la - couleur <parameter>col</parameter>, en utilisant la police TrueType identifiée par + <function>imagettftext</function> dessine la chaîne <parameter>text</parameter> + dans l'image <parameter>im</parameter>, en commancant aux coordonnées + (<parameter>x</parameter>,<parameter>y</parameter>) (le coin supérieur gauche est + l'origine (0,0)), avec un angle de <parameter>angle</parameter>, et dans la + couleur <parameter>col</parameter>, en utilisant la police TrueType identifiée par <parameter>fontfile</parameter>. </para> <para> - Les coordonnées (<parameter>x</parameter>,<parameter>y</parameter>) serviront - de référence pour le premier caractère (en gros, le coin inférieur gauche du - caractère). C'est différent de <function>imagestring</function>, qui utilise le + Les coordonnées (<parameter>x</parameter>,<parameter>y</parameter>) serviront + de référence pour le premier caractère (en gros, le coin inférieur gauche du + caractère). C'est différent de <function>imagestring</function>, qui utilise le coin supérieur droit. </para> <para> - <parameter>angle</parameter> est donné en degrés, avec degré 0 pour un texte - horizontal, et en comptant les angles dans le sens inverse des aiguilles d'une - montre (sens direct). + <parameter>angle</parameter> est donné en degrés, avec degré 0 pour un texte + horizontal, et en comptant les angles dans le sens inverse des aiguilles d'une + montre (sens direct). </para> <para> - <parameter>fontfile</parameter> est le chemin jusqu'à la police TrueType à + <parameter>fontfile</parameter> est le chemin jusqu'à la police TrueType à utiliser. </para> <para> - <parameter>text</parameter> est le texte à dessiner, incluant aussi des séquences - de caractères UTF-8 (de la forme: &#123; ) pour générer des caractères au + <parameter>text</parameter> est le texte à dessiner, incluant aussi des séquences + de caractères UTF-8 (de la forme: &#123; ) pour générer des caractères au delà de 255. </para> <para> - <parameter>col</parameter> est l'index de la couleur dans la palette. Utiliser des + <parameter>col</parameter> est l'index de la couleur dans la palette. Utiliser des index négatifs, revient à supprimer l'anti-aliasing. </para> <para> - <function>imagettftext</function> retourne un tableau de 8 éléments représentants - les 4 points marquant les limites du texte. L'ordre des points est :supérieur - gauche, supérieur droit, inférieur droit, inférieur gauche. Les points sont + <function>imagettftext</function> retourne un tableau de 8 éléments représentants + les 4 points marquant les limites du texte. L'ordre des points est :supérieur + gauche, supérieur droit, inférieur droit, inférieur gauche. Les points sont nommés relativement au texte à l'horizontal. </para> <para> - Cet exemple va générer une image GIF noire de 400x30 pixels, avec les mots - "Test en cours..." en police blanche, Arial. + Cet exemple va générer une image GIF noire de 400x30 pixels, avec les mots + "Test en cours..." en police blanche, Arial. <example> <title>ImageTTFText</title> <programlisting> @@ -1923,9 +1868,8 @@ ImageDestroy($im); ?> </programlisting></example></para> - <para> - Cette fonction requiert les bibliothèques GD et + Cette fonction requiert les bibliothèques GD et <ulink url="&url.freetype;">FreeType</ulink>. </para> <para> @@ -1933,7 +1877,6 @@ </para> </refsect1> </refentry> - <refentry id="function.imagetypes"> <refnamediv> <refname>ImageTypes</refname> @@ -1969,7 +1912,6 @@ </para> </refsect1> </refentry> - <refentry id="function.read-exif-data"> <refnamediv> <refname>read_exif_data</refname> @@ -2002,7 +1944,6 @@ echo "$k: $v<br>\n"; } ?> - Output: FileName: p0001807.jpg FileDateTime: 929353056 @@ -2040,9 +1981,7 @@ </para> </refsect1> </refentry> - </reference> - <!-- Keep this comment at the end of the file Local variables: mode: sgml