cvs: phpdoc /fr/functions image.xml
| From: | Damien Seguy | Date: | Thu, 02 Aug 2001 09:39:37 +0000 |
| Subject: | cvs: phpdoc /fr/functions image.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336684@lists.php.net to get a copy of this message | ||
dams Thu Aug 2 05:39:37 2001 EDT
Modified files:
/phpdoc/fr/functions image.xml
Log:
*** empty log message ***
Index: phpdoc/fr/functions/image.xml diff -u phpdoc/fr/functions/image.xml:1.20 phpdoc/fr/functions/image.xml:1.21 --- phpdoc/fr/functions/image.xml:1.20 Sat Jul 7 18:22:12 2001 +++ phpdoc/fr/functions/image.xml Thu Aug 2 05:39:37 2001 @@ -11,9 +11,9 @@ 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 + Les formats des images que vous pourrez manipuler dépendent de la + version de GD que vous installerez, et de toute autre librairie + dont GD a besoin pour traiter à ces images. Les versions antérieures à la version 1.6 supportent le <acronym>GIF</acronym>, mais pas le <acronym>PNG</acronym>. Pour les versions plus récentes, c'est le contraire. @@ -33,7 +33,7 @@ </partintro> <refentry id="function.getimagesize"> <refnamediv> - <refname>GetImageSize</refname> + <refname>getimagesize</refname> <refpurpose>Retourne la taille d'une image GIF, JPG ou PNG.</refpurpose> </refnamediv> <refsect1> @@ -63,7 +63,7 @@ <title><function>getimagesize</function></title> <programlisting role="php"> <?php -$size = GetImageSize("img/flag.jpg"); +$size = getimagesize("img/flag.jpg"); ?> <IMG SRC="img/flag.jpg" <?php @@ -83,12 +83,17 @@ </example> </para> <para> - Avec les images <acronym>JPEG</acronym>, deux entêtes supplémentaires sont + Avec les images <acronym>JPEG</acronym>, deux en-têtes supplémentaires sont retournés : <literal>channel</literal> et <literal>bits</literal>. <literal>channel</literal> vaudra 3 avec les images RGB, et 4 avec les images CMYK. <literal>bits</literal> est le nombre de bits de chaque couleur. </para> <para> + Si l'accès à <parameter>filename</parameter> est impossible, + ou si ce n'est pas une image valide, <function>getimagesize</function> + retournera <literal>NULL</literal> et générera une alerte. + </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 @@ -112,7 +117,7 @@ </example> <note> <simpara> - <function>getimagesize</function> ne requiert par la bibliothèque GD. + <function>getimagesize</function> ne requiert pas la bibliothèque GD. </simpara> </note> <note> @@ -140,14 +145,14 @@ <para> <function>imagealphablending</function> fournit deux modes de dessins des images en vraies couleurs (truecolors). En mode "blending", le canal - alpha de chaque couleur fournie à chaque fonction de dessin, telles que - <function>imagesetpixel</function> détermine sa transparence. GD va alors + alpha de chaque couleur est fournie à chaque fonction de dessin, tel que + <function>imagesetpixel</function> peut déterminer sa transparence. GD va alors automatiquement mixer la couleur à ce point, et stocker le résultat dans l'image. Le pixel résultant est alors opaque. En mode non-mixant, la couleur est copiée littéralement avec ses informations de canal alpha, et remplace le pixel de destination. Le mixage n'est pas disponible avec les images à palette. Si <parameter>blendmode</parameter> vaut - &true;, alors le mode de mixage sera activé, et sinon + <literal>TRUE</literal>, alors le mode de mixage sera activé, sinon il sera désactivé. </para> <note> @@ -219,7 +224,7 @@ respectivement la largeur et la hauteur de l'ellipse, tandis que les points de début et de fin sont représentés par <parameter>s</parameter> et <parameter>e</parameter>, en degrés. L'argument <parameter>style</parameter> - est un champ de bit, combiné avec l'opérateur OR : + est un champ de bits, combiné avec l'opérateur OR : <orderedlist> <listitem><simpara><literal>IMG_ARC_PIE</literal></simpara></listitem> <listitem><simpara><literal>IMG_ARC_CHORD</literal></simpara></listitem> @@ -227,13 +232,13 @@ <listitem><simpara><literal>IMG_ARC_EDGED</literal></simpara></listitem> </orderedlist> <literal>IMG_ARC_PIE</literal> et <literal>IMG_ARC_CHORD</literal> sont - mutellememnt exclusives; <literal>IMG_ARC_CHORD</literal> ne fait que + mutellemement exclusives; <literal>IMG_ARC_CHORD</literal> ne fait que connecter les angles de début et de fin avec une ligne droite, tandis que <literal>IMG_ARC_PIE</literal> produit une ligne courbe. <literal>IMG_ARC_NOFILL</literal> indique que l'arc (ou corde) doit être dessiné mais pas rempli. <literal>IMG_ARC_EDGED</literal>, utilisé conjointement avec <literal>IMG_ARC_NOFILL</literal>, indique que les angles de - début et de fin doivent être connecté au centre. Cette fonction est + début et de fin doivent être connectés au centre. Cette fonction est recommandée pour faire les graphiques de type camenbert. </para> <note> @@ -338,7 +343,7 @@ 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 + sera utilisée (plus le chiffre est grand, plus grande est la police). </para> <para> Voir aussi @@ -570,7 +575,8 @@ <parameter>im</parameter>. </para> <para> - Si la couleur n'existe pas dans cette palettre, retourne -1. + Si la couleur n'existe pas dans cette palette, <function>imagecolorexact</function> + retourne -1. </para> <para> Voir aussi @@ -707,7 +713,7 @@ </funcsynopsis> <para> <function>imagegammacorrect</function> applique une correction gamma - au flot d'image GD <parameter>im</parameter>. Le facteur d'entrée est + à l'image GD <parameter>im</parameter>. Le facteur d'entrée est <parameter>inputgamma</parameter>, et le facteur de sortie est <parameter>outputgamma</parameter>. </para> @@ -739,7 +745,8 @@ réellement. </para> <para> - Voir aussi <function>imagecolorat</function>. + Voir aussi + <function>imagecolorat</function>. </para> </refsect1> </refentry> @@ -759,7 +766,7 @@ </funcsynopsis> <para> <function>imagecolorsforindex</function> retourne un tableau associatif - avec les couleur rouge (red) , vert (green), bleu (blue) qui contiennent + avec les couleurs rouge (red) , vert (green), bleu (blue) qui contiennent les valeurs de la couleur correspondante. </para> <para> @@ -772,7 +779,7 @@ <refentry id="function.imagecolorstotal"> <refnamediv> <refname>ImageColorsTotal</refname> - <refpurpose>Calcule le nombre de couleur d'une palette.</refpurpose> + <refpurpose>Calcule le nombre de couleurs d'une palette.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -897,7 +904,7 @@ <para> <function>imagecopymerge</function> copie une partie de l'image <parameter>src_im</parameter> dans l'image de destination - <parameter>dst_im</parameter> commençant aux coordonnées + <parameter>dst_im</parameter> en commençant aux coordonnées (<parameter>src_x</parameter>, <parameter>src_y</parameter>), avec la largeur <parameter>src_w</parameter> et la hauteur <parameter>src_h</parameter>. La zone de l'image ainsi définie sera @@ -996,8 +1003,8 @@ 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 sont définies par rapport + au coin supérieur gauche. Cette 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 @@ -1040,8 +1047,9 @@ de l'image durant une réduction. <parameter>Dst_im</parameter> est l'image de destination, <parameter>src_im</parameter> est l'image source. - Si les coordonnées, hauteurs et largeur des source et destinations - diffèrent, l'image copié sera étiré de manière appropriée. + Si les hauteurs et largeur des source et destination + diffèrent, l'image copiée sera étirée + de manière appropriée. Les coordonnées sont celles du coin supérieur gauche. <function>imagecopyresampled</function> peut servir à copier des zones d'une image vers elle-même, mais si les régions se @@ -1107,7 +1115,7 @@ utilisez le code suivant, qui retourne une erreur <acronym>GIF</acronym> : <example> <title> - Exemple de gestion des erreurs durant création d'image + Exemple de gestion des erreurs durant la création d'image (gracieusement offert par vic@zymsys.com ) </title> <programlisting role="php"> @@ -1169,7 +1177,7 @@ <refentry id="function.imagetruecolortopalette"> <refnamediv> <refname>ImageTrueColorToPalette</refname> - <refpurpose>Convertit une image en vraies couleur en image à palette</refpurpose> + <refpurpose>Convertit une image en vraies couleurs en image à palette</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1189,16 +1197,16 @@ été modifié pour préserver l'essentiel du canal alph dans la nouvelle palette, en plus de conserver les couleurs du mieux possible. Mais cela ne fonctionne pas toujours comme voulu. Il est alors préférable - de génèrer un résultat en vraies couleurs, ce qui a toujours le + de générer un résultat en vraies couleurs, ce qui a toujours le meilleur rendu. </para> <para> - Si <parameter>dither</parameter> vaut &true;, cela + Si <parameter>dither</parameter> vaut <literal>TRUE</literal>, cela indique que l'image doit être ditherée : l'image sera un peu plus granuleuse, mais l'approximation des couleurs sera meilleure. </para> <para> - <parameter>ncolors</parameter> est le nombre maximal de couleur dans la + <parameter>ncolors</parameter> est le nombre maximal de couleurs dans la palette finale. </para> <note> @@ -1227,7 +1235,7 @@ </funcsynopsis> <para> <function>imagecreatefromjpeg</function> retourne un identifiant d'image - représentant un image obtenu à partir du fichier + représentant une image obtenue à partir du fichier <parameter>filename</parameter>. </para> <para> @@ -1278,7 +1286,7 @@ </funcsynopsis> <para> <function>imagecreatefrompng</function> retourne un identifiant d'image - représentant un image obtenu à partir du fichier + représentant une image obtenue à partir du fichier <parameter>filename</parameter>. </para> <para> @@ -1420,7 +1428,7 @@ </funcsynopsis> <para> <function>imagedestroy</function> libère toute la mémoire - associée avec l'image <parameter>im</parameter>. + associée à l'image <parameter>im</parameter>. <parameter>im</parameter> est un identifiant d'image valide retourné par <function>imagecreate</function>. </para> @@ -1545,7 +1553,7 @@ </funcsynopsis> <para> <function>imagefontheight</function> retourne la hauteur de la police - <parameter>font</parameter>en pixel. + <parameter>font</parameter> en pixels. </para> <para> Voir aussi @@ -1599,13 +1607,13 @@ fonction <function>imagecreate</function>. </para> <para> - Le format de l'image sera GIF87a à moins que l'image n'ai une couleur transparente + Le format de l'image sera GIF87a, à moins que l'image n'ait une couleur transparente (mise en place grâce à la fonction <function>imagecolortransparent</function>)), 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 + directement à la sortie standard. En envoyant une en-tête de type <literal>image/gifcontent-type</literal> , (grâce à la fonction <function>header</function>), vous pouvez créer des images avec des scripts PHP. @@ -1749,7 +1757,7 @@ <function>imagejpeg</function> envoie l'image GD (<parameter>im</parameter>) au format <acronym>JPEG</acronym> 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é + l'envoie dans un fichier. <parameter>im</parameter> a été créé par <function>imagecreate</function>. </para> <para> @@ -1766,6 +1774,11 @@ </para> </note> <para> + <parameter>quality</parameter> est optionnel, et prend des valeurs + entières de 0 (pire qualité, petit fichier) et 100 (meilleure qualité, + gros fichier). Par défaut, la valeur est à 100. + </para> + <para> Voir aussi <function>imagepng</function>, <function>imagewbmp</function>, @@ -1798,7 +1811,7 @@ </para> <para> <parameter>filename</parameter> est optionnel, et s'il est omis, - l'image sera envoyée directement au client. En placant l'entête + l'image sera envoyée directement au client. En plaçant l'en-tête <acronym>image/vnd.wap.wbmp</acronym>, dans le champs "content-type", vous pourrez afficher une image <acronym>WBMP</acronym>. <note> @@ -1889,11 +1902,11 @@ <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). + 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 + 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> @@ -1902,9 +1915,9 @@ <tgroup cols="3"> <thead> <row> - <entry>position</entry> - <entry>Type de donnés C</entry> - <entry>description</entry> + <entry>Position</entry> + <entry>Type de données C</entry> + <entry>Description</entry> </row> </thead> <tbody> @@ -1923,12 +1936,12 @@ <row> <entry>Octets 8-11</entry> <entry>int</entry> - <entry>Largeur en pixel des caractères</entry> + <entry>Largeur en pixels des caractères</entry> </row> <row> <entry>Octets 12-15</entry> <entry>int</entry> - <entry>Hauteur en pixel des caractères</entry> + <entry>Hauteur en pixels des caractères</entry> </row> <row> <entry>Octets 16-</entry> @@ -2009,7 +2022,7 @@ <para> <parameter>tightness</parameter> permet de contrôler la quantité d'espace entre les caractères. Cette quantité - est ajouté lors des dessins, et peut donc être négative. + est ajoutée lors des dessins, et peut donc être négative. </para> <para> <parameter>angle</parameter> est en degrés. @@ -2027,9 +2040,9 @@ <para> Le rectangle entourant est calculé en utilisant les informations disponibles sur les tailles de caractères, et, malheureusement, - ont tendance à être légèrement différents + il a tendance à être légèrement différent du résultat réel final. Si l'angle est de 0 degré, - vous pouvez vous attendre à avoir besoin d'un rectangle d'au moins + vous pouvez-vous attendre à avoir besoin d'un rectangle d'au moins un pixel plus grand dans toutes les directions. </para> <para> @@ -2086,7 +2099,7 @@ par exemple l'extension ou la condensation, ou encore, modifier son vecteur d'encodage, tout en conservant l'original. Notez que la police que vous copiez doit être obtenue par <function>imagepsloadfont</function>, et non pas une police - qui a elle même été copiée. Vous pouvez aussi faire des modifications avant de + qui a elle-même été copiée. Vous pouvez aussi faire des modifications avant de la copier. </para> <para> @@ -2096,7 +2109,7 @@ </para> <para> Si tout a bien été fait, un index valide de police sera retourné, et pourra être - utilisé ultérieurement. Sinon, la fonction retournera &false;, et affichera un + utilisé ultérieurement. Sinon, la fonction retournera <literal>FALSE</literal>, et affichera un message décrivant l'erreur. </para> <para> @@ -2126,7 +2139,7 @@ caractère depuis un fichier et change le codage vectoriel de la police correspondante. Etant donné que les polices PostScript ne disposent pas des caractères au-delà de 127, vous aurez - sûrement besoin de les changer sur vous utilisez une autre langue que + sûrement besoin de les changer si 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> @@ -2154,7 +2167,8 @@ </funcprototype> </funcsynopsis> <para> - Voir aussi <function>imagepsloadfont</function>. + Voir aussi + <function>imagepsloadfont</function>. </para> </refsect1> </refentry> @@ -2172,13 +2186,28 @@ </funcprototype> </funcsynopsis> <para> - Au cas ooúugrave; tout a bien marché, un index de police + 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 + retourne <literal>FALSE</literal> et affiche un message décrivant ce qui est erroné. </para> <para> + <programlisting role="php"> +<?php + header("Content-type: image/jpeg"); + $im = imagecreate(350, 45); + $noir = imagecolorallocate($im, 0, 0, 0); + $Blanc = imagecolorallocate($im, 255, 255, 255); + $font = imagepsloadfont("bchbi.pfb"); + imagepstext($im, "Test ... Ca marche!", $font, 32, $white, $black, 32, 32); + imagepsfreefont($font); + imagejpeg($im, ""); + imagedestroy ($im); +?< + </programlisting> + </para> + <para> Voir aussi <function>imagepsfreefont</function>. </para> @@ -2266,15 +2295,15 @@ <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 - qui fait que l'arrière plan n'a pas besoin d'être dans une couleur fixe. + 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>, ooúugrave; (x, y) définissait le - coin supérieur gauche du premier caracètre. Reportez vous + <function>imagestring</function>, où (x, y) définissait le + coin supérieur gauche du premier caractère. Reportez-vous à la documentation PostScript pour avoir des détails à propos des polices et de leurs tailles. </para> @@ -2299,7 +2328,7 @@ </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é + sont exprimés en unité d'espaces caractère, ce qui vaut 1/1000ème d'un em-carré ( ? ? ?). </para> <para> @@ -2415,7 +2444,7 @@ <note> <para> Vous n'avez rien à faire lorsque vous en avez terminé avec une brosse, - mais si vous destruisez l'image de brosse, vous ne DEVEZ plus utiliser + mais si vous détruisez l'image de brosse, vous ne DEVEZ plus utiliser les options IMG_COLOR_BRUSHED et IMG_COLOR_STYLEDBRUSHED des fonctions <function>imageline</function> et <function>imagepolygon</function>, avant d'avoir créé une nouvelle brosse. @@ -2445,7 +2474,7 @@ <para> <function>imagesettile</function> remplace l'image de carrelage courante par l'image <parameter>tile</parameter>, - à utiliser dans toutes les remplissages (comme avec les fonctions + à utiliser dans tous les remplissages (comme avec les fonctions <function>imagefill</function> et <function>imagefilledpolygon</function>) lors des remplissages avec l'option <literal>IMG_COLOR_TILED</literal>. </para> @@ -2454,12 +2483,12 @@ de manière répétitive. N'importe quelle image GD peut servir d'image de remplissage. L'utilisation de la couleur transparente (gérée avec la fonction <function>imagecolortransparent</function>) permet à certaines - zone d'apparaître à travers le carrelage. + zones d'apparaître à travers le carrelage. </para> <note> <para> Vous n'avez rien à faire lorsque vous en avez terminé avec une brosse, - mais si vous destruisez l'image de brosse, vous ne DEVEZ plus utiliser + mais si vous détruisez l'image de brosse, vous ne DEVEZ plus utiliser l'option <literal>IMG_COLOR_TILED</literal> des fonctions <function>imagefill</function> et <function>imagefilledpolygon</function>, avant d'avoir créé une nouvelle brosse. @@ -2610,7 +2639,7 @@ <refentry id="function.imagettfbbox"> <refnamediv> <refname>ImageTTFBBox</refname> - <refpurpose>retourne le rectangle entourant un texte et dessiné avec une police TrueType.</refpurpose> + <refpurpose>Retourne le rectangle entourant un texte et dessiné avec une police TrueType.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -2669,8 +2698,8 @@ </varlistentry> </variablelist> <function>imagettfbbox</function> retourne une tableau avec 8 - éléments, représentants les 4 sommets du rectangle - ainsi définis. + éléments, représentant les 4 sommets du rectangle + ainsi défini. <informaltable> <tgroup cols="2"> <tbody> @@ -2719,7 +2748,8 @@ GD et Freetype. </para> <para> - Voir aussi <function>imagettftext</function>. + Voir aussi + <function>imagettftext</function>. </para> </refsect1> </refentry> @@ -2745,7 +2775,7 @@ </funcsynopsis> <para> <function>imagettftext</function> dessine la chaîne <parameter>text</parameter> - dans l'image <parameter>im</parameter>, en commancant aux coordonnées + dans l'image <parameter>im</parameter>, en commençant 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 @@ -2769,7 +2799,7 @@ <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 delà de 255. + 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 @@ -2777,35 +2807,38 @@ </para> <para> <function>imagettftext</function> retourne un tableau de 8 éléments - représentants les 4 points marquant les limites du texte. L'ordre + représentant les 4 points marquants 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. + relativement au texte à l'horizontale<function>imagecolorexact</function>. </para> <para> - Cet exemple va génèrer une image <acronym>GIF</acronym> noire - de 400x30 pixels, avec les mots "Test en cours..." en police blanche, Arial. + Cet exemple va générer une image <acronym>GIF</acronym> noire + de 400x30 pixels, avec les mots "Test en cours...Oméga: &#937;" + en police blanche, type Arial. <example> - <title><function>imagettftext</function></title> + <title>Exemple avec <function>imagettftext</function></title> <programlisting role="php"> <?php -Header("Content-type: image/gif"); -$im = imagecreate(400,30); -$black = ImageColorAllocate($im, 0,0,0); -$white = ImageColorAllocate($im, 255,255,255); -ImageTTFText($im, 20, 0, 10, 20, $white, "/path/arial.ttf", "Test en cours... Omega: &#937;"); -ImageGif($im); -ImageDestroy($im); + header("Content-type: image/gif"); + $im = imagecreate(400,30); + $black = imagecolorallocate($im, 0,0,0); + $white = imagecolorallocate($im, 255,255,255); + imagettftext($im, 20, 0, 10, 20, $white, "/path/arial.ttf", + "Test en cours... Oméga: &#937;"); + imagegif($im); + imagedestroy($im); ?> </programlisting> </example> </para> <para> - <function>imagettftext</function> requiert les bibliothèques GD et - <ulink url="&url.freetype;">FreeType</ulink>. + <function>imagettftext</function> requiert les bibliothèques GD + ainsi que <ulink url="&url.freetype;">FreeType</ulink>. </para> <para> - Voir aussi <function>imagettfbbox</function>. + Voir aussi + <function>imagettfbbox</function>. </para> </refsect1> </refentry> @@ -2826,7 +2859,7 @@ </funcprototype> </funcsynopsis> <para> - <function>imagetypes</function> retourne un champs de bit correspondant aux + <function>imagetypes</function> retourne un champs de bits correspondant aux formats d'images supportés par la version de GD utilisée. Les valeurs suivantes sont valables : <literal>IMG_GIF</literal> | <literal>IMG_JPG</literal> | <literal>IMG_PNG</literal> | <literal>IMG_WBMP</literal>. Pour vous assurer du support <acronym>PNG</acronym>, @@ -2847,7 +2880,7 @@ <refentry id="function.read-exif-data"> <refnamediv> <refname>read_exif_data</refname> - <refpurpose>Lit les entêtes EXIF d'une image JPEG</refpurpose> + <refpurpose>Lit les en-têtes EXIF d'une image JPEG</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -2858,22 +2891,22 @@ </funcprototype> </funcsynopsis> <para> - <function>read_exif_data</function> lit les entêtes EXIF de + <function>read_exif_data</function> lit les en-têtes EXIF de l'image <acronym>JPEG</acronym> nommée <parameter>filename</parameter>. Elle retourne un tableau associatif où les index sont les noms - d'entêtes EXIF, et les valeurs sont leur valeur - associée. Les entêtes EXIF sont souvent disponibles + d'en-têtes EXIF, et les valeurs sont leur valeur + associée. Les en-têtes EXIF sont souvent disponibles dans les images générées par les appareils - phots digitals, mais chaque constructeur marque ses images d'une + photos numériques, mais chaque constructeur marque ses images d'une manière qui lui est propre : il est impossible de savoir - quels entêtes seront présents. + quelles en-têtes seront présents. <example> <title>Exemple avec <function>read_exif_data</function></title> <programlisting role="php"> <?php $exif = read_exif_data('p0001807.jpg'); while(list($k,$v)=each($exif)) { - echo "$k: $v<br>\n"; + echo "$k: $v<br>\n"; } ?> </programlisting>
Index: phpdoc/fr/functions/image.xml diff -u phpdoc/fr/functions/image.xml:1.20 phpdoc/fr/functions/image.xml:1.21 --- phpdoc/fr/functions/image.xml:1.20 Sat Jul 7 18:22:12 2001 +++ phpdoc/fr/functions/image.xml Thu Aug 2 05:39:37 2001 @@ -11,9 +11,9 @@ 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 + Les formats des images que vous pourrez manipuler dépendent de la + version de GD que vous installerez, et de toute autre librairie + dont GD a besoin pour traiter à ces images. Les versions antérieures à la version 1.6 supportent le <acronym>GIF</acronym>, mais pas le <acronym>PNG</acronym>. Pour les versions plus récentes, c'est le contraire. @@ -33,7 +33,7 @@ </partintro> <refentry id="function.getimagesize"> <refnamediv> - <refname>GetImageSize</refname> + <refname>getimagesize</refname> <refpurpose>Retourne la taille d'une image GIF, JPG ou PNG.</refpurpose> </refnamediv> <refsect1> @@ -63,7 +63,7 @@ <title><function>getimagesize</function></title> <programlisting role="php"> <?php -$size = GetImageSize("img/flag.jpg"); +$size = getimagesize("img/flag.jpg"); ?> <IMG SRC="img/flag.jpg" <?php @@ -83,12 +83,17 @@ </example> </para> <para> - Avec les images <acronym>JPEG</acronym>, deux entêtes supplémentaires sont + Avec les images <acronym>JPEG</acronym>, deux en-têtes supplémentaires sont retournés : <literal>channel</literal> et <literal>bits</literal>. <literal>channel</literal> vaudra 3 avec les images RGB, et 4 avec les images CMYK. <literal>bits</literal> est le nombre de bits de chaque couleur. </para> <para> + Si l'accès à <parameter>filename</parameter> est impossible, + ou si ce n'est pas une image valide, <function>getimagesize</function> + retournera <literal>NULL</literal> et générera une alerte. + </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 @@ -112,7 +117,7 @@ </example> <note> <simpara> - <function>getimagesize</function> ne requiert par la bibliothèque GD. + <function>getimagesize</function> ne requiert pas la bibliothèque GD. </simpara> </note> <note> @@ -140,14 +145,14 @@ <para> <function>imagealphablending</function> fournit deux modes de dessins des images en vraies couleurs (truecolors). En mode "blending", le canal - alpha de chaque couleur fournie à chaque fonction de dessin, telles que - <function>imagesetpixel</function> détermine sa transparence. GD va alors + alpha de chaque couleur est fournie à chaque fonction de dessin, tel que + <function>imagesetpixel</function> peut déterminer sa transparence. GD va alors automatiquement mixer la couleur à ce point, et stocker le résultat dans l'image. Le pixel résultant est alors opaque. En mode non-mixant, la couleur est copiée littéralement avec ses informations de canal alpha, et remplace le pixel de destination. Le mixage n'est pas disponible avec les images à palette. Si <parameter>blendmode</parameter> vaut - &true;, alors le mode de mixage sera activé, et sinon + <literal>TRUE</literal>, alors le mode de mixage sera activé, sinon il sera désactivé. </para> <note> @@ -219,7 +224,7 @@ respectivement la largeur et la hauteur de l'ellipse, tandis que les points de début et de fin sont représentés par <parameter>s</parameter> et <parameter>e</parameter>, en degrés. L'argument <parameter>style</parameter> - est un champ de bit, combiné avec l'opérateur OR : + est un champ de bits, combiné avec l'opérateur OR : <orderedlist> <listitem><simpara><literal>IMG_ARC_PIE</literal></simpara></listitem> <listitem><simpara><literal>IMG_ARC_CHORD</literal></simpara></listitem> @@ -227,13 +232,13 @@ <listitem><simpara><literal>IMG_ARC_EDGED</literal></simpara></listitem> </orderedlist> <literal>IMG_ARC_PIE</literal> et <literal>IMG_ARC_CHORD</literal> sont - mutellememnt exclusives; <literal>IMG_ARC_CHORD</literal> ne fait que + mutellemement exclusives; <literal>IMG_ARC_CHORD</literal> ne fait que connecter les angles de début et de fin avec une ligne droite, tandis que <literal>IMG_ARC_PIE</literal> produit une ligne courbe. <literal>IMG_ARC_NOFILL</literal> indique que l'arc (ou corde) doit être dessiné mais pas rempli. <literal>IMG_ARC_EDGED</literal>, utilisé conjointement avec <literal>IMG_ARC_NOFILL</literal>, indique que les angles de - début et de fin doivent être connecté au centre. Cette fonction est + début et de fin doivent être connectés au centre. Cette fonction est recommandée pour faire les graphiques de type camenbert. </para> <note> @@ -338,7 +343,7 @@ 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 + sera utilisée (plus le chiffre est grand, plus grande est la police). </para> <para> Voir aussi @@ -570,7 +575,8 @@ <parameter>im</parameter>. </para> <para> - Si la couleur n'existe pas dans cette palettre, retourne -1. + Si la couleur n'existe pas dans cette palette, <function>imagecolorexact</function> + retourne -1. </para> <para> Voir aussi @@ -707,7 +713,7 @@ </funcsynopsis> <para> <function>imagegammacorrect</function> applique une correction gamma - au flot d'image GD <parameter>im</parameter>. Le facteur d'entrée est + à l'image GD <parameter>im</parameter>. Le facteur d'entrée est <parameter>inputgamma</parameter>, et le facteur de sortie est <parameter>outputgamma</parameter>. </para> @@ -739,7 +745,8 @@ réellement. </para> <para> - Voir aussi <function>imagecolorat</function>. + Voir aussi + <function>imagecolorat</function>. </para> </refsect1> </refentry> @@ -759,7 +766,7 @@ </funcsynopsis> <para> <function>imagecolorsforindex</function> retourne un tableau associatif - avec les couleur rouge (red) , vert (green), bleu (blue) qui contiennent + avec les couleurs rouge (red) , vert (green), bleu (blue) qui contiennent les valeurs de la couleur correspondante. </para> <para> @@ -772,7 +779,7 @@ <refentry id="function.imagecolorstotal"> <refnamediv> <refname>ImageColorsTotal</refname> - <refpurpose>Calcule le nombre de couleur d'une palette.</refpurpose> + <refpurpose>Calcule le nombre de couleurs d'une palette.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -897,7 +904,7 @@ <para> <function>imagecopymerge</function> copie une partie de l'image <parameter>src_im</parameter> dans l'image de destination - <parameter>dst_im</parameter> commençant aux coordonnées + <parameter>dst_im</parameter> en commençant aux coordonnées (<parameter>src_x</parameter>, <parameter>src_y</parameter>), avec la largeur <parameter>src_w</parameter> et la hauteur <parameter>src_h</parameter>. La zone de l'image ainsi définie sera @@ -996,8 +1003,8 @@ 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 sont définies par rapport + au coin supérieur gauche. Cette 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 @@ -1040,8 +1047,9 @@ de l'image durant une réduction. <parameter>Dst_im</parameter> est l'image de destination, <parameter>src_im</parameter> est l'image source. - Si les coordonnées, hauteurs et largeur des source et destinations - diffèrent, l'image copié sera étiré de manière appropriée. + Si les hauteurs et largeur des source et destination + diffèrent, l'image copiée sera étirée + de manière appropriée. Les coordonnées sont celles du coin supérieur gauche. <function>imagecopyresampled</function> peut servir à copier des zones d'une image vers elle-même, mais si les régions se @@ -1107,7 +1115,7 @@ utilisez le code suivant, qui retourne une erreur <acronym>GIF</acronym> : <example> <title> - Exemple de gestion des erreurs durant création d'image + Exemple de gestion des erreurs durant la création d'image (gracieusement offert par vic@zymsys.com ) </title> <programlisting role="php"> @@ -1169,7 +1177,7 @@ <refentry id="function.imagetruecolortopalette"> <refnamediv> <refname>ImageTrueColorToPalette</refname> - <refpurpose>Convertit une image en vraies couleur en image à palette</refpurpose> + <refpurpose>Convertit une image en vraies couleurs en image à palette</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1189,16 +1197,16 @@ été modifié pour préserver l'essentiel du canal alph dans la nouvelle palette, en plus de conserver les couleurs du mieux possible. Mais cela ne fonctionne pas toujours comme voulu. Il est alors préférable - de génèrer un résultat en vraies couleurs, ce qui a toujours le + de générer un résultat en vraies couleurs, ce qui a toujours le meilleur rendu. </para> <para> - Si <parameter>dither</parameter> vaut &true;, cela + Si <parameter>dither</parameter> vaut <literal>TRUE</literal>, cela indique que l'image doit être ditherée : l'image sera un peu plus granuleuse, mais l'approximation des couleurs sera meilleure. </para> <para> - <parameter>ncolors</parameter> est le nombre maximal de couleur dans la + <parameter>ncolors</parameter> est le nombre maximal de couleurs dans la palette finale. </para> <note> @@ -1227,7 +1235,7 @@ </funcsynopsis> <para> <function>imagecreatefromjpeg</function> retourne un identifiant d'image - représentant un image obtenu à partir du fichier + représentant une image obtenue à partir du fichier <parameter>filename</parameter>. </para> <para> @@ -1278,7 +1286,7 @@ </funcsynopsis> <para> <function>imagecreatefrompng</function> retourne un identifiant d'image - représentant un image obtenu à partir du fichier + représentant une image obtenue à partir du fichier <parameter>filename</parameter>. </para> <para> @@ -1420,7 +1428,7 @@ </funcsynopsis> <para> <function>imagedestroy</function> libère toute la mémoire - associée avec l'image <parameter>im</parameter>. + associée à l'image <parameter>im</parameter>. <parameter>im</parameter> est un identifiant d'image valide retourné par <function>imagecreate</function>. </para> @@ -1545,7 +1553,7 @@ </funcsynopsis> <para> <function>imagefontheight</function> retourne la hauteur de la police - <parameter>font</parameter>en pixel. + <parameter>font</parameter> en pixels. </para> <para> Voir aussi @@ -1599,13 +1607,13 @@ fonction <function>imagecreate</function>. </para> <para> - Le format de l'image sera GIF87a à moins que l'image n'ai une couleur transparente + Le format de l'image sera GIF87a, à moins que l'image n'ait une couleur transparente (mise en place grâce à la fonction <function>imagecolortransparent</function>)), 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 + directement à la sortie standard. En envoyant une en-tête de type <literal>image/gifcontent-type</literal> , (grâce à la fonction <function>header</function>), vous pouvez créer des images avec des scripts PHP. @@ -1749,7 +1757,7 @@ <function>imagejpeg</function> envoie l'image GD (<parameter>im</parameter>) au format <acronym>JPEG</acronym> 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é + l'envoie dans un fichier. <parameter>im</parameter> a été créé par <function>imagecreate</function>. </para> <para> @@ -1766,6 +1774,11 @@ </para> </note> <para> + <parameter>quality</parameter> est optionnel, et prend des valeurs + entières de 0 (pire qualité, petit fichier) et 100 (meilleure qualité, + gros fichier). Par défaut, la valeur est à 100. + </para> + <para> Voir aussi <function>imagepng</function>, <function>imagewbmp</function>, @@ -1798,7 +1811,7 @@ </para> <para> <parameter>filename</parameter> est optionnel, et s'il est omis, - l'image sera envoyée directement au client. En placant l'entête + l'image sera envoyée directement au client. En plaçant l'en-tête <acronym>image/vnd.wap.wbmp</acronym>, dans le champs "content-type", vous pourrez afficher une image <acronym>WBMP</acronym>. <note> @@ -1889,11 +1902,11 @@ <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). + 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 + 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> @@ -1902,9 +1915,9 @@ <tgroup cols="3"> <thead> <row> - <entry>position</entry> - <entry>Type de donnés C</entry> - <entry>description</entry> + <entry>Position</entry> + <entry>Type de données C</entry> + <entry>Description</entry> </row> </thead> <tbody> @@ -1923,12 +1936,12 @@ <row> <entry>Octets 8-11</entry> <entry>int</entry> - <entry>Largeur en pixel des caractères</entry> + <entry>Largeur en pixels des caractères</entry> </row> <row> <entry>Octets 12-15</entry> <entry>int</entry> - <entry>Hauteur en pixel des caractères</entry> + <entry>Hauteur en pixels des caractères</entry> </row> <row> <entry>Octets 16-</entry> @@ -2009,7 +2022,7 @@ <para> <parameter>tightness</parameter> permet de contrôler la quantité d'espace entre les caractères. Cette quantité - est ajouté lors des dessins, et peut donc être négative. + est ajoutée lors des dessins, et peut donc être négative. </para> <para> <parameter>angle</parameter> est en degrés. @@ -2027,9 +2040,9 @@ <para> Le rectangle entourant est calculé en utilisant les informations disponibles sur les tailles de caractères, et, malheureusement, - ont tendance à être légèrement différents + il a tendance à être légèrement différent du résultat réel final. Si l'angle est de 0 degré, - vous pouvez vous attendre à avoir besoin d'un rectangle d'au moins + vous pouvez-vous attendre à avoir besoin d'un rectangle d'au moins un pixel plus grand dans toutes les directions. </para> <para> @@ -2086,7 +2099,7 @@ par exemple l'extension ou la condensation, ou encore, modifier son vecteur d'encodage, tout en conservant l'original. Notez que la police que vous copiez doit être obtenue par <function>imagepsloadfont</function>, et non pas une police - qui a elle même été copiée. Vous pouvez aussi faire des modifications avant de + qui a elle-même été copiée. Vous pouvez aussi faire des modifications avant de la copier. </para> <para> @@ -2096,7 +2109,7 @@ </para> <para> Si tout a bien été fait, un index valide de police sera retourné, et pourra être - utilisé ultérieurement. Sinon, la fonction retournera &false;, et affichera un + utilisé ultérieurement. Sinon, la fonction retournera <literal>FALSE</literal>, et affichera un message décrivant l'erreur. </para> <para> @@ -2126,7 +2139,7 @@ caractère depuis un fichier et change le codage vectoriel de la police correspondante. Etant donné que les polices PostScript ne disposent pas des caractères au-delà de 127, vous aurez - sûrement besoin de les changer sur vous utilisez une autre langue que + sûrement besoin de les changer si 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> @@ -2154,7 +2167,8 @@ </funcprototype> </funcsynopsis> <para> - Voir aussi <function>imagepsloadfont</function>. + Voir aussi + <function>imagepsloadfont</function>. </para> </refsect1> </refentry> @@ -2172,13 +2186,28 @@ </funcprototype> </funcsynopsis> <para> - Au cas ooúugrave; tout a bien marché, un index de police + 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 + retourne <literal>FALSE</literal> et affiche un message décrivant ce qui est erroné. </para> <para> + <programlisting role="php"> +<?php + header("Content-type: image/jpeg"); + $im = imagecreate(350, 45); + $noir = imagecolorallocate($im, 0, 0, 0); + $Blanc = imagecolorallocate($im, 255, 255, 255); + $font = imagepsloadfont("bchbi.pfb"); + imagepstext($im, "Test ... Ca marche!", $font, 32, $white, $black, 32, 32); + imagepsfreefont($font); + imagejpeg($im, ""); + imagedestroy ($im); +?< + </programlisting> + </para> + <para> Voir aussi <function>imagepsfreefont</function>. </para> @@ -2266,15 +2295,15 @@ <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 - qui fait que l'arrière plan n'a pas besoin d'être dans une couleur fixe. + 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>, ooúugrave; (x, y) définissait le - coin supérieur gauche du premier caracètre. Reportez vous + <function>imagestring</function>, où (x, y) définissait le + coin supérieur gauche du premier caractère. Reportez-vous à la documentation PostScript pour avoir des détails à propos des polices et de leurs tailles. </para> @@ -2299,7 +2328,7 @@ </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é + sont exprimés en unité d'espaces caractère, ce qui vaut 1/1000ème d'un em-carré ( ? ? ?). </para> <para> @@ -2415,7 +2444,7 @@ <note> <para> Vous n'avez rien à faire lorsque vous en avez terminé avec une brosse, - mais si vous destruisez l'image de brosse, vous ne DEVEZ plus utiliser + mais si vous détruisez l'image de brosse, vous ne DEVEZ plus utiliser les options IMG_COLOR_BRUSHED et IMG_COLOR_STYLEDBRUSHED des fonctions <function>imageline</function> et <function>imagepolygon</function>, avant d'avoir créé une nouvelle brosse. @@ -2445,7 +2474,7 @@ <para> <function>imagesettile</function> remplace l'image de carrelage courante par l'image <parameter>tile</parameter>, - à utiliser dans toutes les remplissages (comme avec les fonctions + à utiliser dans tous les remplissages (comme avec les fonctions <function>imagefill</function> et <function>imagefilledpolygon</function>) lors des remplissages avec l'option <literal>IMG_COLOR_TILED</literal>. </para> @@ -2454,12 +2483,12 @@ de manière répétitive. N'importe quelle image GD peut servir d'image de remplissage. L'utilisation de la couleur transparente (gérée avec la fonction <function>imagecolortransparent</function>) permet à certaines - zone d'apparaître à travers le carrelage. + zones d'apparaître à travers le carrelage. </para> <note> <para> Vous n'avez rien à faire lorsque vous en avez terminé avec une brosse, - mais si vous destruisez l'image de brosse, vous ne DEVEZ plus utiliser + mais si vous détruisez l'image de brosse, vous ne DEVEZ plus utiliser l'option <literal>IMG_COLOR_TILED</literal> des fonctions <function>imagefill</function> et <function>imagefilledpolygon</function>, avant d'avoir créé une nouvelle brosse. @@ -2610,7 +2639,7 @@ <refentry id="function.imagettfbbox"> <refnamediv> <refname>ImageTTFBBox</refname> - <refpurpose>retourne le rectangle entourant un texte et dessiné avec une police TrueType.</refpurpose> + <refpurpose>Retourne le rectangle entourant un texte et dessiné avec une police TrueType.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -2669,8 +2698,8 @@ </varlistentry> </variablelist> <function>imagettfbbox</function> retourne une tableau avec 8 - éléments, représentants les 4 sommets du rectangle - ainsi définis. + éléments, représentant les 4 sommets du rectangle + ainsi défini. <informaltable> <tgroup cols="2"> <tbody> @@ -2719,7 +2748,8 @@ GD et Freetype. </para> <para> - Voir aussi <function>imagettftext</function>. + Voir aussi + <function>imagettftext</function>. </para> </refsect1> </refentry> @@ -2745,7 +2775,7 @@ </funcsynopsis> <para> <function>imagettftext</function> dessine la chaîne <parameter>text</parameter> - dans l'image <parameter>im</parameter>, en commancant aux coordonnées + dans l'image <parameter>im</parameter>, en commençant 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 @@ -2769,7 +2799,7 @@ <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 delà de 255. + 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 @@ -2777,35 +2807,38 @@ </para> <para> <function>imagettftext</function> retourne un tableau de 8 éléments - représentants les 4 points marquant les limites du texte. L'ordre + représentant les 4 points marquants 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. + relativement au texte à l'horizontale<function>imagecolorexact</function>. </para> <para> - Cet exemple va génèrer une image <acronym>GIF</acronym> noire - de 400x30 pixels, avec les mots "Test en cours..." en police blanche, Arial. + Cet exemple va générer une image <acronym>GIF</acronym> noire + de 400x30 pixels, avec les mots "Test en cours...Oméga: &#937;" + en police blanche, type Arial. <example> - <title><function>imagettftext</function></title> + <title>Exemple avec <function>imagettftext</function></title> <programlisting role="php"> <?php -Header("Content-type: image/gif"); -$im = imagecreate(400,30); -$black = ImageColorAllocate($im, 0,0,0); -$white = ImageColorAllocate($im, 255,255,255); -ImageTTFText($im, 20, 0, 10, 20, $white, "/path/arial.ttf", "Test en cours... Omega: &#937;"); -ImageGif($im); -ImageDestroy($im); + header("Content-type: image/gif"); + $im = imagecreate(400,30); + $black = imagecolorallocate($im, 0,0,0); + $white = imagecolorallocate($im, 255,255,255); + imagettftext($im, 20, 0, 10, 20, $white, "/path/arial.ttf", + "Test en cours... Oméga: &#937;"); + imagegif($im); + imagedestroy($im); ?> </programlisting> </example> </para> <para> - <function>imagettftext</function> requiert les bibliothèques GD et - <ulink url="&url.freetype;">FreeType</ulink>. + <function>imagettftext</function> requiert les bibliothèques GD + ainsi que <ulink url="&url.freetype;">FreeType</ulink>. </para> <para> - Voir aussi <function>imagettfbbox</function>. + Voir aussi + <function>imagettfbbox</function>. </para> </refsect1> </refentry> @@ -2826,7 +2859,7 @@ </funcprototype> </funcsynopsis> <para> - <function>imagetypes</function> retourne un champs de bit correspondant aux + <function>imagetypes</function> retourne un champs de bits correspondant aux formats d'images supportés par la version de GD utilisée. Les valeurs suivantes sont valables : <literal>IMG_GIF</literal> | <literal>IMG_JPG</literal> | <literal>IMG_PNG</literal> | <literal>IMG_WBMP</literal>. Pour vous assurer du support <acronym>PNG</acronym>, @@ -2847,7 +2880,7 @@ <refentry id="function.read-exif-data"> <refnamediv> <refname>read_exif_data</refname> - <refpurpose>Lit les entêtes EXIF d'une image JPEG</refpurpose> + <refpurpose>Lit les en-têtes EXIF d'une image JPEG</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -2858,22 +2891,22 @@ </funcprototype> </funcsynopsis> <para> - <function>read_exif_data</function> lit les entêtes EXIF de + <function>read_exif_data</function> lit les en-têtes EXIF de l'image <acronym>JPEG</acronym> nommée <parameter>filename</parameter>. Elle retourne un tableau associatif où les index sont les noms - d'entêtes EXIF, et les valeurs sont leur valeur - associée. Les entêtes EXIF sont souvent disponibles + d'en-têtes EXIF, et les valeurs sont leur valeur + associée. Les en-têtes EXIF sont souvent disponibles dans les images générées par les appareils - phots digitals, mais chaque constructeur marque ses images d'une + photos numériques, mais chaque constructeur marque ses images d'une manière qui lui est propre : il est impossible de savoir - quels entêtes seront présents. + quelles en-têtes seront présents. <example> <title>Exemple avec <function>read_exif_data</function></title> <programlisting role="php"> <?php $exif = read_exif_data('p0001807.jpg'); while(list($k,$v)=each($exif)) { - echo "$k: $v<br>\n"; + echo "$k: $v<br>\n"; } ?> </programlisting>