cvs: phpdoc-fr /reference/image/functions imagefilter.xml imagefontheight.xml imagefontwidth.xml imageftbbox.xml imagefttext.xml imagegammacorrect.xml
imagegd.xml imagegd2.xml imagegif.xml imageinterlace.xml
| From: | Yannick Torres | Date: | Sun, 28 Dec 2008 14:33:48 +0000 |
| Subject: | cvs: phpdoc-fr /reference/image/functions imagefilter.xml imagefontheight.xml imagefontwidth.xml imageftbbox.xml imagefttext.xml imagegammacorrect.xml imagegd.xml imagegd2.xml imagegif.xml imageinterlace.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-6182@lists.php.net to get a copy of this message | ||
yannick Sun Dec 28 14:33:48 2008 UTC
Modified files:
/phpdoc-fr/reference/image/functions imagefilter.xml
imagefontheight.xml
imagefontwidth.xml
imageftbbox.xml
imagefttext.xml
imagegammacorrect.xml
imagegd2.xml imagegd.xml
imagegif.xml
imageinterlace.xml
Log:
sync with EN
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagefilter.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/image/functions/imagefilter.xml diff -u phpdoc-fr/reference/image/functions/imagefilter.xml:1.14 phpdoc-fr/reference/image/functions/imagefilter.xml:1.15 --- phpdoc-fr/reference/image/functions/imagefilter.xml:1.14 Wed Jun 11 16:39:25 2008 +++ phpdoc-fr/reference/image/functions/imagefilter.xml Sun Dec 28 14:33:48 2008 @@ -1,7 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry xml:id="function.imagefilter" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -118,6 +118,28 @@ <term><parameter>arg1</parameter></term> <listitem> <para> + <itemizedlist> + <listitem> + <simpara> + <constant>IMG_FILTER_BRIGHTNESS</constant> : Degré de luminosité. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>IMG_FILTER_CONTRAST</constant> : Degré du contraste. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>IMG_FILTER_COLORIZE</constant> : Valeur du composant rouge. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>IMG_FILTER_SMOOTH</constant> : Degré du lissé. + </simpara> + </listitem> + </itemizedlist> </para> </listitem> </varlistentry> @@ -125,6 +147,13 @@ <term><parameter>arg2</parameter></term> <listitem> <para> + <itemizedlist> + <listitem> + <simpara> + <constant>IMG_FILTER_COLORIZE</constant> : Valeur du composant vert. + </simpara> + </listitem> + </itemizedlist> </para> </listitem> </varlistentry> @@ -132,6 +161,29 @@ <term><parameter>arg3</parameter></term> <listitem> <para> + <itemizedlist> + <listitem> + <simpara> + <constant>IMG_FILTER_COLORIZE</constant> : Valeur du composant bleu. + </simpara> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>arg4</parameter></term> + <listitem> + <para> + <itemizedlist> + <listitem> + <simpara> + <constant>IMG_FILTER_COLORIZE</constant> : Canal Alpha. Une valeur + entre 0 et 127. 0 signifie totalement opaque, tandis que 127 signifie + totalement transparent. + </simpara> + </listitem> + </itemizedlist> </para> </listitem> </varlistentry> @@ -180,10 +232,15 @@ <![CDATA[ <?php $im = imagecreatefrompng('dave.png'); -if ($im && imagefilter($im, IMG_FILTER_GRAYSCALE)) { + +if($im && imagefilter($im, IMG_FILTER_GRAYSCALE)) +{ echo 'Image convertie en grayscale.'; + imagepng($im, 'dave.png'); -} else { +} +else +{ echo 'La convertion en grayscale a échoué.'; } @@ -198,14 +255,17 @@ <![CDATA[ <?php $im = imagecreatefrompng('sean.png'); -if ($im && imagefilter($im, IMG_FILTER_BRIGHTNESS, 20)) { + +if($im && imagefilter($im, IMG_FILTER_BRIGHTNESS, 20)) +{ echo 'La luminosité de l\'image a été modifiée.'; imagepng($im, 'sean.png'); -} else { + imagedestroy($im); +} +else +{ echo 'Echec lors de la modification de la luminosité.'; } - -imagedestroy($im); ?> ]]> </programlisting> @@ -218,24 +278,74 @@ $im = imagecreatefrompng('philip.png'); /* R, G, B, donc 0, 255, 0 correspond au vert */ -if ($im && imagefilter($im, IMG_FILTER_COLORIZE, 0, 255, 0)) { +if($im && imagefilter($im, IMG_FILTER_COLORIZE, 0, 255, 0)) +{ echo 'L\'image a été ombragée en vert avec succès.'; imagepng($im, 'philip.png'); -} else { + imagedestroy($im); +} +else +{ echo 'Echec lors de la modification de l\'ombrage.'; } +?> +]]> + </programlisting> + </example> + <example> + <title>Exemple d'image en négatif avec <function>imagefilter</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Définission de notre fonction "négatif" afin qu'elle soit portable +// également sur les versions de PHP qui n'ont pas la fonction imagefilter() +function negate($im) +{ + if(function_exists('imagefilter')) + { + return imagefilter($im, IMG_FILTER_NEGATE); + } + + for($x = 0; $x < imagesx($im); ++$x) + { + for($y = 0; $y < imagesy($im); ++$y) + { + $index = imagecolorat($im, $x, $y); + $rgb = imagecolorsforindex($index); + $color = imagecolorallocate($im, 255 - $rgb['red'], 255 - $rgb['green'], 255 - $rgb['blue']); + + imagesetpixel($im, $x, $y, $color); + } + } + + return(true); +} -imagedestroy($im); +$im = imagecreatefromjpeg('kalle.jpg'); + +if($im && negate($im)) +{ + echo 'Image convertie avec succès en couleur négative.'; + + imagejpeg($im, 'kalle.jpg', 100); + imagedestroy($im); +} +else +{ + echo 'Echec lors de la conversion en couleur négative.'; +} ?> ]]> </programlisting> </example> </para> </refsect1> + <refsect1 role="notes"> &reftitle.notes; ¬e.bundled.gd; </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagefontheight.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/image/functions/imagefontheight.xml diff -u phpdoc-fr/reference/image/functions/imagefontheight.xml:1.12 phpdoc-fr/reference/image/functions/imagefontheight.xml:1.13 --- phpdoc-fr/reference/image/functions/imagefontheight.xml:1.12 Sun Jul 22 19:39:24 2007 +++ phpdoc-fr/reference/image/functions/imagefontheight.xml Sun Dec 28 14:33:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.imagefontheight" xmlns="http://docbook.org/ns/docbook"> @@ -18,6 +18,7 @@ Retourne la hauteur de la police <parameter>font</parameter> en pixels. </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -26,12 +27,54 @@ </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne la hauteur de la police, en pixels. </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imagefontheight</function> et des polices internes</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo 'Hauteur de la police : ' . imagefontheight(4); +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +Hauteur de la police : 16 +]]> + </screen> + </example> + <example> + <title>Exemple avec <function>imagefontheight</function> et <function>imageloadfont</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Chargement d'une police .gdf +$font = imageloadfont('anonymous.gdf'); + +echo 'Hauteur de la police : ' . imagefontheight($font); +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +Hauteur de la police : 43 +]]> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagefontwidth.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/image/functions/imagefontwidth.xml diff -u phpdoc-fr/reference/image/functions/imagefontwidth.xml:1.12 phpdoc-fr/reference/image/functions/imagefontwidth.xml:1.13 --- phpdoc-fr/reference/image/functions/imagefontwidth.xml:1.12 Sun Jul 22 19:39:24 2007 +++ phpdoc-fr/reference/image/functions/imagefontwidth.xml Sun Dec 28 14:33:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.imagefontwidth" xmlns="http://docbook.org/ns/docbook"> @@ -18,6 +18,7 @@ Retourne la largeur de la police <parameter>font</parameter> en pixels. </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -26,12 +27,55 @@ </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne la largeur de la police. </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imagefontwidth</function> et les polices internes</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo 'Largeur de la police : ' . imagefontwidth(4); +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +Largeur de la police : 8 +]]> + </screen> + </example> + <example> + <title>Exemple avec <function>imagefontwidth</function> et <function>imageloadfont</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Chargement d'une police .gdf +$font = imageloadfont('anonymous.gdf'); + +echo 'Largeur de la police : ' . imagefontwidth($font); +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +Largeur de la police : 23 +]]> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imageftbbox.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/image/functions/imageftbbox.xml diff -u phpdoc-fr/reference/image/functions/imageftbbox.xml:1.13 phpdoc-fr/reference/image/functions/imageftbbox.xml:1.14 --- phpdoc-fr/reference/image/functions/imageftbbox.xml:1.13 Sun Jul 22 19:39:24 2007 +++ phpdoc-fr/reference/image/functions/imageftbbox.xml Sun Dec 28 14:33:48 2008 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry xml:id='function.imageftbbox' xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -14,11 +14,14 @@ <type>array</type><methodname>imageftbbox</methodname> <methodparam><type>float</type><parameter>size</parameter></methodparam> <methodparam><type>float</type><parameter>angle</parameter></methodparam> - <methodparam><type>string</type><parameter>font_file</parameter></methodparam> + <methodparam><type>string</type><parameter>fontfile</parameter></methodparam> <methodparam><type>string</type><parameter>text</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>extrainfo</parameter></methodparam> </methodsynopsis> - &warn.undocumented.func; + <para> + Calcule le rectangle d'encadrement pour un texte, en utilisant la police + courante et freetype2. + </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; @@ -28,6 +31,8 @@ <term><parameter>size</parameter></term> <listitem> <para> + La taille de la police. Suivant votre version de GD, elle devra + être spécifié en pixel (GD1) ou en point (GD2). </para> </listitem> </varlistentry> @@ -35,13 +40,19 @@ <term><parameter>angle</parameter></term> <listitem> <para> + Angle, en degrés, dans lequel le paramètre <parameter>text</parameter> + sera mesuré. </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>font_file</parameter></term> + <term><parameter>fontfile</parameter></term> <listitem> <para> + Le nom du fichier de la police TrueType (peut être une URL). + Suivant la version de GD utilisée par PHP, il sera recherché les + fichiers qui ne commencent pas par un '/', en y ajoutant l'extension + '.ttf', et suivant le chemin des polices défini par la bibliothèque. </para> </listitem> </varlistentry> @@ -49,6 +60,7 @@ <term><parameter>text</parameter></term> <listitem> <para> + La chaîne à mesurer. </para> </listitem> </varlistentry> @@ -56,6 +68,25 @@ <term><parameter>extrainfo</parameter></term> <listitem> <para> + <table> + <title>Indexes possibles pour le tableau <parameter>extrainfo</parameter></title> + <tgroup cols="2"> + <thead> + <row> + <entry>Clé</entry> + <entry>Type</entry> + <entry>Signification</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>linespacing</literal></entry> + <entry><type>float</type></entry> + <entry>Définit l'espacement entre les lignes lors du dessin</entry> + </row> + </tbody> + </tgroup> + </table> </para> </listitem> </varlistentry> @@ -65,13 +96,99 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> + <function>imageftbbox</function> retourne un tableau contenant 8 éléments + représentant les 4 points du rectangle antourant le texte : + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry>0</entry> + <entry>Coin en bas, à gauche, position en X</entry> + </row> + <row> + <entry>1</entry> + <entry>Coin en bas, à gauche, position en Y</entry> + </row> + <row> + <entry>2</entry> + <entry>Coin en bas, à droite, position en X</entry> + </row> + <row> + <entry>3</entry> + <entry>Coin en bas, à droite, position en Y</entry> + </row> + <row> + <entry>4</entry> + <entry>Coin en haut, à droite, position en X</entry> + </row> + <row> + <entry>5</entry> + <entry>Coin en haut, à droite, position en Y</entry> + </row> + <row> + <entry>6</entry> + <entry>Coin en haut, à gauche, position en X</entry> + </row> + <row> + <entry>7</entry> + <entry>Coin en haut, à gauche, position en Y</entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + Les points sont relatifs au <emphasis>texte</emphasis> suivant le paramètre + <parameter>angle</parameter>, aussi, "en haut à gauche" signifie le coin en + haut à gauche lorsque l'on regarde le texte horizontalement. </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imageftbbox</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image de 300x150 pixels +$im = imagecreatetruecolor(300, 150); +$black = imagecolorallocate($im, 0, 0, 0); +$white = imagecolorallocate($im, 255, 255, 255); + +// Définit l'arrière-plan en blanc +imagefilledrectangle($im, 0, 0, 299, 299, $white); + +// Chemin vers notre fichier de police +$font = './arial.ttf'; + +// D'abord, nous créons un rectangle contenant notre texte +$bbox = imageftbbox(10, 0, $font, 'The PHP Documentation Group'); + +// Nos coordonnées en X et en Y +$x = $bbox[0] + (imagesx($im) / 2) - ($bbox[4] / 2) - 5; +$y = $bbox[1] + (imagesy($im) / 2) - ($bbox[5] / 2) - 5; + +imagefttext($im, 10, 0, $x, $y, $black, $font, 'The PHP Documentation Group'); + +// Affichage vers le navigateur +header('Content-type: image/png'); + +imagepng($im); +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; ¬e.gd.2; ¬e.freetype; </refsect1> + <refsect1 role="changelog"> &reftitle.changelog; <para> @@ -87,7 +204,7 @@ <row> <entry>4.3.5</entry> <entry> - Le paramètre <parameter>extrainfo</parameter> est devenu optionnel. + Le paramètre <parameter>extrainfo</parameter> devient optionnel. </entry> </row> </tbody> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagefttext.xml?r1=1.17&r2=1.18&diff_format=u Index: phpdoc-fr/reference/image/functions/imagefttext.xml diff -u phpdoc-fr/reference/image/functions/imagefttext.xml:1.17 phpdoc-fr/reference/image/functions/imagefttext.xml:1.18 --- phpdoc-fr/reference/image/functions/imagefttext.xml:1.17 Wed May 14 11:43:39 2008 +++ phpdoc-fr/reference/image/functions/imagefttext.xml Sun Dec 28 14:33:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> -<!-- EN-Revision: 1.15 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.18 $ --> +<!-- EN-Revision: 1.18 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id='function.imagefttext' xmlns="http://docbook.org/ns/docbook"> @@ -18,11 +18,12 @@ <methodparam><type>int</type><parameter>x</parameter></methodparam> <methodparam><type>int</type><parameter>y</parameter></methodparam> <methodparam><type>int</type><parameter>color</parameter></methodparam> - <methodparam><type>string</type><parameter>font_file</parameter></methodparam> + <methodparam><type>string</type><parameter>fontfile</parameter></methodparam> <methodparam><type>string</type><parameter>text</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>extrainfo</parameter></methodparam> </methodsynopsis> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -32,7 +33,7 @@ <term><parameter>size</parameter></term> <listitem> <para> - La taille de la police à utiliser, en nombre de points + La taille de la police à utiliser, en nombre de points. </para> </listitem> </varlistentry> @@ -66,8 +67,8 @@ <term><parameter>y</parameter></term> <listitem> <para> - L'ordonnée <literal>y-ordinate</literal>. Ce paramètre configure la position de base de la police, - et non pas le bas de cette dernière. + L'ordonnée <literal>y-ordinate</literal>. Ce paramètre configure la + position de base de la police, et non pas le bas de cette dernière. </para> </listitem> </varlistentry> @@ -76,16 +77,47 @@ <listitem> <para> L'index de la couleur désirée pour le texte, voir - la fonction <function>imagecolorexact</function> + la fonction <function>imagecolorexact</function>. </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>font_file</parameter></term> + <term><parameter>fontfile</parameter></term> <listitem> <para> - Le chemin complet vers le fichier représentant - la police de caractères à utiliser. + Le chemin vers la police TrueType à utiliser. + </para> + <para> + Suivant la version de GD utilisée par PHP, il sera recherché les + fichiers qui ne commencent pas par un '<literal>/</literal>', en y + ajoutant l'extension '<literal>.ttf</literal>', et suivant le chemin des + polices défini par la bibliothèque. + </para> + <para> + Lors de l'utilisation d'une version de GD inférieure à 2.0.18, un + caractère d'espacement (plutôt qu'un point-virgule) était utilisé + comment séparateur dans le chemin pour les différents fichiers de police. + Si vous utilisez toujours cette notation, vous obtiendrez le message + d'erreur suivant : + <literal>Warning: Could not find/open font</literal>. Pour ces anciennes + versions, la seule solution est de déplacer la police dans un dossier qui + ne contient pas d'espace. + </para> + <para> + Dans la plupart des cas, lorsque la police se trouve dans le même dossier + que le script qui cherche à l'utiliser, la solution suivante permet + de s'affranchir de tous les problèmes relatifs à l'inclusion. + <programlisting role="php"> +<![CDATA[ +<?php +// Définit la variable d'environnement pour GD +putenv('GDFONTPATH=' . realpath('.')); + +// Nom de la police à utiliser (note qu'il n'y a pas d'extension .ttf) +$font = 'SomeFont'; +?> +]]> + </programlisting> </para> </listitem> </varlistentry> @@ -101,12 +133,32 @@ <term><parameter>extrainfo</parameter></term> <listitem> <para> + <table> + <title>Indexes possibles pour le tableau <parameter>extrainfo</parameter></title> + <tgroup cols="2"> + <thead> + <row> + <entry>Clé</entry> + <entry>Type</entry> + <entry>Signification</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>linespacing</literal></entry> + <entry><type>float</type></entry> + <entry>Définit l'espacement entre les lignes lors du dessin</entry> + </row> + </tbody> + </tgroup> + </table> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> @@ -153,11 +205,47 @@ </informaltable> </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imagefttext</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image de 300x100 pixels +$im = imagecreatetruecolor(300, 100); +$red = imagecolorallocate($im, 0xFF, 0x00, 0x00); +$black = imagecolorallocate($im, 0x00, 0x00, 0x00); + +// Définit l'arrière-plan en rouge +imagefilledrectangle($im, 0, 0, 299, 99, $red); + +// Chemin vers notre fichier de police ttf +$font_file = './arial.ttf'; + +// Dessine le texte 'PHP Manual' en utilisant une police de taille 13 +imagefttext($im, 13, 0, 105, 55, $black, $font_file, 'PHP Manual'); + +// Affichage de l'image sur le navigateur +header('Content-Type: image/png'); + +imagepng($im); +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; ¬e.gd.2; ¬e.freetype; </refsect1> + <refsect1 role="changelog"> &reftitle.changelog; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagegammacorrect.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/image/functions/imagegammacorrect.xml diff -u phpdoc-fr/reference/image/functions/imagegammacorrect.xml:1.13 phpdoc-fr/reference/image/functions/imagegammacorrect.xml:1.14 --- phpdoc-fr/reference/image/functions/imagegammacorrect.xml:1.13 Sun Jul 22 19:39:24 2007 +++ phpdoc-fr/reference/image/functions/imagegammacorrect.xml Sun Dec 28 14:33:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.imagegammacorrect" xmlns="http://docbook.org/ns/docbook"> @@ -29,7 +29,7 @@ <term><parameter>inputgamma</parameter></term> <listitem> <para> - Le facteur gamma d'entrée + Le facteur gamma d'entrée. </para> </listitem> </varlistentry> @@ -37,19 +37,45 @@ <term><parameter>outputgamma</parameter></term> <listitem> <para> - Le facteur gamma de sortie + Le facteur gamma de sortie. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imagegammacorrect</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image +$im = imagecreatefromgif('php.gif'); + +// Correction gamma, sortie à 1.537 +imagegammacorrect($im, 1.0, 1.537); + +// Sauvegarde et libération de la mémoire +imagegif($im, './php_gamma_corrected.gif'); +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagegd2.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/reference/image/functions/imagegd2.xml diff -u phpdoc-fr/reference/image/functions/imagegd2.xml:1.16 phpdoc-fr/reference/image/functions/imagegd2.xml:1.17 --- phpdoc-fr/reference/image/functions/imagegd2.xml:1.16 Mon Apr 14 18:30:07 2008 +++ phpdoc-fr/reference/image/functions/imagegd2.xml Sun Dec 28 14:33:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.20 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id='function.imagegd2' xmlns="http://docbook.org/ns/docbook"> @@ -21,6 +21,7 @@ Génère une image au format GD2, vers le fichier <parameter>filename</parameter>. </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -39,6 +40,7 @@ <term><parameter>chunk_size</parameter></term> <listitem> <para> + Taille de la pièce. </para> </listitem> </varlistentry> @@ -55,12 +57,60 @@ </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Affichage d'une image GD2</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image vide et ajout d'un texte +$im = imagecreatetruecolor(120, 20); +$text_color = imagecolorallocate($im, 233, 14, 91); +imagestring($im, 1, 5, 5, "Un texte simple", $text_color); + +imagegd2($im); + +// Libération de la mémoire +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>Sauvegarde d'une image GD2</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image vide et ajout d'un texte +$im = imagecreatetruecolor(120, 20); +$text_color = imagecolorallocate($im, 233, 14, 91); +imagestring($im, 1, 5, 5, "Un texte simple", $text_color); + +// Sauvegarde de l'image GD2 +// Le format de fichier pour les images GD2 est .gd2, voir http://www.libgd.org/GdFileFormats +imagegd2($im, 'simple.gd'); + +// Libération de la mémoire +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; ¬e.gd.2; http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagegd.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/image/functions/imagegd.xml diff -u phpdoc-fr/reference/image/functions/imagegd.xml:1.14 phpdoc-fr/reference/image/functions/imagegd.xml:1.15 --- phpdoc-fr/reference/image/functions/imagegd.xml:1.14 Mon Apr 14 18:30:07 2008 +++ phpdoc-fr/reference/image/functions/imagegd.xml Sun Dec 28 14:33:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id='function.imagegd' xmlns="http://docbook.org/ns/docbook"> @@ -36,12 +36,61 @@ </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Affichage d'une image GD</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image vide et ajout d'un texte +$im = imagecreatetruecolor(120, 20); +$text_color = imagecolorallocate($im, 233, 14, 91); +imagestring($im, 1, 5, 5, "Un texte simple", $text_color); + +// Affichage de l'image +imagegd($im); + +// Libération de la mémoire +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>Sauvegarde d'une image GD</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image vide et ajout d'un texte +$im = imagecreatetruecolor(120, 20); +$text_color = imagecolorallocate($im, 233, 14, 91); +imagestring($im, 1, 5, 5, "Un texte simple", $text_color); + +// Sauvegarde de l'image GD +// Le format de fichier pour les images GD est .gd, voir http://www.libgd.org/GdFileFormats +imagegd($im, 'simple.gd'); + +// Libération de la mémoire +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; <note> @@ -52,6 +101,7 @@ </para> </note> </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagegif.xml?r1=1.25&r2=1.26&diff_format=u Index: phpdoc-fr/reference/image/functions/imagegif.xml diff -u phpdoc-fr/reference/image/functions/imagegif.xml:1.25 phpdoc-fr/reference/image/functions/imagegif.xml:1.26 --- phpdoc-fr/reference/image/functions/imagegif.xml:1.25 Sat Jun 21 20:51:34 2008 +++ phpdoc-fr/reference/image/functions/imagegif.xml Sun Dec 28 14:33:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.25 $ --> -<!-- EN-Revision: 1.18 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.26 $ --> +<!-- EN-Revision: 1.19 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.imagegif" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -28,6 +28,7 @@ <acronym>GIF89a</acronym>. </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -45,12 +46,63 @@ </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Affichage d'une image en utilisant <function>imagegif</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image +$im = imagecreatetruecolor(100, 100); + +// Définit l'arrière-plan en blanc +imagefilledrectangle($im, 0, 0, 99, 99, 0xFFFFFF); + +// Dessine un texte dans l'image +imagestring($im, 3, 40, 20, 'GD Library', 0xFFBA00); + +// Affiche l'image sur le navigateur +header('Content-type: image/gif'); + +imagegif($im); +imagedestroy($im); +?> +]]> + </programlisting> + </example> + <example> + <title>Convertion d'une image PNG en GIF, en utilisant <function>imagegif</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Chargement de l'image PNG +$png = imagecreatefrompng('./php.png'); + +// Sauvegarde de l'image en GIF +imagegif($png, './php.gif'); + +// Libération de la mémoire +imagedestroy($png); + +// C'est fait ! +echo 'Convertion avec succès de l'image PNG en GIF !'; +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; <note> @@ -71,20 +123,52 @@ <programlisting role="php"> <![CDATA[ <?php -if (function_exists("imagegif")) { - header("Content-type: image/gif"); +// Création d'une image +$im = imagecreatetruecolor(100, 100); + +// On fait quelques opérations sur l'image ici... + +// Gestion de l'affichage +if(function_exists('imagegif')) +{ + // Pour GIF + header('Content-type: image/gif'); + imagegif($im); -} elseif (function_exists("imagejpeg")) { - header("Content-type: image/jpeg"); - imagejpeg($im, "", 0.5); -} elseif (function_exists("imagepng")) { - header("Content-type: image/png"); +} +elseif(function_exists('imagejpeg')) +{ + // Pour JPEG + header('Content-type: image/jpeg'); + + imagejpeg($im, NULL, 100); +} +elseif(function_exists('imagepng')) +{ + // Pour PNG + header('Content-type: image/png'); + imagepng($im); -} elseif (function_exists("imagewbmp")) { - header("Content-type: image/vnd.wap.wbmp"); +} +elseif(function_exists('imagewbmp')) +{ + // Pour WBMP + header('Content-type: image/vnd.wap.wbmp'); + imagewbmp($im); -} else { - die("Pas de support graphique avec PHP sur ce serveur"); +} +else +{ + imagedestroy($im); + + die('Aucun support sur ce serveur PHP n\'a été trouvé'); +} + +// Si un support a été trouvé pour un de ces formats, +// nous libérons la mémoire +if($im) +{ + imagedestroy($im); } ?> ]]> @@ -94,7 +178,7 @@ </note> <note> <para> - Depuis les versions 3.0.18 et 4.0.2, vous pouvez utiliser la + Depuis les versions 3.0.18 et 4.0.2 de PHP, vous pouvez utiliser la fonction <function>imagetypes</function> au lieu de <function>function_exists</function> pour vérifier la présence des différents formats d'images supportés.: @@ -102,10 +186,13 @@ <programlisting role="php"> <![CDATA[ <?php -if (imagetypes() & IMG_GIF) { - header ("Content-type: image/gif"); - imagegif ($im); -} elseif (imagetypes() & IMG_JPG) { +if(imagetypes() & IMG_GIF) +{ + header('Content-type: image/gif'); + imagegif($im); +} +elseif(imagetypes() & IMG_JPG) +{ /* ... etc. */ } ?> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imageinterlace.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/image/functions/imageinterlace.xml diff -u phpdoc-fr/reference/image/functions/imageinterlace.xml:1.15 phpdoc-fr/reference/image/functions/imageinterlace.xml:1.16 --- phpdoc-fr/reference/image/functions/imageinterlace.xml:1.15 Thu May 22 22:54:34 2008 +++ phpdoc-fr/reference/image/functions/imageinterlace.xml Sun Dec 28 14:33:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.imageinterlace" xmlns="http://docbook.org/ns/docbook"> @@ -23,6 +23,7 @@ l'image créée sera un <acronym>JPEG</acronym> progressif. </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -40,12 +41,38 @@ </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne 1 si l'entrelacement est activé pour l'image, 0 sinon. </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Activation de l'entrelacement en utilisant la fonction <function>imageinterlace</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image +$im = imagecreatefrom('php.gif'); + +// Activation de l'entrelacement +imageinterlace($im, true); + +// Sauvegarde de l'image +imagegif($im, './php_interlaced.gif'); +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagefilter.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/image/functions/imagefilter.xml diff -u phpdoc-fr/reference/image/functions/imagefilter.xml:1.14 phpdoc-fr/reference/image/functions/imagefilter.xml:1.15 --- phpdoc-fr/reference/image/functions/imagefilter.xml:1.14 Wed Jun 11 16:39:25 2008 +++ phpdoc-fr/reference/image/functions/imagefilter.xml Sun Dec 28 14:33:48 2008 @@ -1,7 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry xml:id="function.imagefilter" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -118,6 +118,28 @@ <term><parameter>arg1</parameter></term> <listitem> <para> + <itemizedlist> + <listitem> + <simpara> + <constant>IMG_FILTER_BRIGHTNESS</constant> : Degré de luminosité. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>IMG_FILTER_CONTRAST</constant> : Degré du contraste. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>IMG_FILTER_COLORIZE</constant> : Valeur du composant rouge. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>IMG_FILTER_SMOOTH</constant> : Degré du lissé. + </simpara> + </listitem> + </itemizedlist> </para> </listitem> </varlistentry> @@ -125,6 +147,13 @@ <term><parameter>arg2</parameter></term> <listitem> <para> + <itemizedlist> + <listitem> + <simpara> + <constant>IMG_FILTER_COLORIZE</constant> : Valeur du composant vert. + </simpara> + </listitem> + </itemizedlist> </para> </listitem> </varlistentry> @@ -132,6 +161,29 @@ <term><parameter>arg3</parameter></term> <listitem> <para> + <itemizedlist> + <listitem> + <simpara> + <constant>IMG_FILTER_COLORIZE</constant> : Valeur du composant bleu. + </simpara> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>arg4</parameter></term> + <listitem> + <para> + <itemizedlist> + <listitem> + <simpara> + <constant>IMG_FILTER_COLORIZE</constant> : Canal Alpha. Une valeur + entre 0 et 127. 0 signifie totalement opaque, tandis que 127 signifie + totalement transparent. + </simpara> + </listitem> + </itemizedlist> </para> </listitem> </varlistentry> @@ -180,10 +232,15 @@ <![CDATA[ <?php $im = imagecreatefrompng('dave.png'); -if ($im && imagefilter($im, IMG_FILTER_GRAYSCALE)) { + +if($im && imagefilter($im, IMG_FILTER_GRAYSCALE)) +{ echo 'Image convertie en grayscale.'; + imagepng($im, 'dave.png'); -} else { +} +else +{ echo 'La convertion en grayscale a échoué.'; } @@ -198,14 +255,17 @@ <![CDATA[ <?php $im = imagecreatefrompng('sean.png'); -if ($im && imagefilter($im, IMG_FILTER_BRIGHTNESS, 20)) { + +if($im && imagefilter($im, IMG_FILTER_BRIGHTNESS, 20)) +{ echo 'La luminosité de l\'image a été modifiée.'; imagepng($im, 'sean.png'); -} else { + imagedestroy($im); +} +else +{ echo 'Echec lors de la modification de la luminosité.'; } - -imagedestroy($im); ?> ]]> </programlisting> @@ -218,24 +278,74 @@ $im = imagecreatefrompng('philip.png'); /* R, G, B, donc 0, 255, 0 correspond au vert */ -if ($im && imagefilter($im, IMG_FILTER_COLORIZE, 0, 255, 0)) { +if($im && imagefilter($im, IMG_FILTER_COLORIZE, 0, 255, 0)) +{ echo 'L\'image a été ombragée en vert avec succès.'; imagepng($im, 'philip.png'); -} else { + imagedestroy($im); +} +else +{ echo 'Echec lors de la modification de l\'ombrage.'; } +?> +]]> + </programlisting> + </example> + <example> + <title>Exemple d'image en négatif avec <function>imagefilter</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Définission de notre fonction "négatif" afin qu'elle soit portable +// également sur les versions de PHP qui n'ont pas la fonction imagefilter() +function negate($im) +{ + if(function_exists('imagefilter')) + { + return imagefilter($im, IMG_FILTER_NEGATE); + } + + for($x = 0; $x < imagesx($im); ++$x) + { + for($y = 0; $y < imagesy($im); ++$y) + { + $index = imagecolorat($im, $x, $y); + $rgb = imagecolorsforindex($index); + $color = imagecolorallocate($im, 255 - $rgb['red'], 255 - $rgb['green'], 255 - $rgb['blue']); + + imagesetpixel($im, $x, $y, $color); + } + } + + return(true); +} -imagedestroy($im); +$im = imagecreatefromjpeg('kalle.jpg'); + +if($im && negate($im)) +{ + echo 'Image convertie avec succès en couleur négative.'; + + imagejpeg($im, 'kalle.jpg', 100); + imagedestroy($im); +} +else +{ + echo 'Echec lors de la conversion en couleur négative.'; +} ?> ]]> </programlisting> </example> </para> </refsect1> + <refsect1 role="notes"> &reftitle.notes; ¬e.bundled.gd; </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagefontheight.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/image/functions/imagefontheight.xml diff -u phpdoc-fr/reference/image/functions/imagefontheight.xml:1.12 phpdoc-fr/reference/image/functions/imagefontheight.xml:1.13 --- phpdoc-fr/reference/image/functions/imagefontheight.xml:1.12 Sun Jul 22 19:39:24 2007 +++ phpdoc-fr/reference/image/functions/imagefontheight.xml Sun Dec 28 14:33:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.imagefontheight" xmlns="http://docbook.org/ns/docbook"> @@ -18,6 +18,7 @@ Retourne la hauteur de la police <parameter>font</parameter> en pixels. </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -26,12 +27,54 @@ </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne la hauteur de la police, en pixels. </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imagefontheight</function> et des polices internes</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo 'Hauteur de la police : ' . imagefontheight(4); +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +Hauteur de la police : 16 +]]> + </screen> + </example> + <example> + <title>Exemple avec <function>imagefontheight</function> et <function>imageloadfont</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Chargement d'une police .gdf +$font = imageloadfont('anonymous.gdf'); + +echo 'Hauteur de la police : ' . imagefontheight($font); +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +Hauteur de la police : 43 +]]> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagefontwidth.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/image/functions/imagefontwidth.xml diff -u phpdoc-fr/reference/image/functions/imagefontwidth.xml:1.12 phpdoc-fr/reference/image/functions/imagefontwidth.xml:1.13 --- phpdoc-fr/reference/image/functions/imagefontwidth.xml:1.12 Sun Jul 22 19:39:24 2007 +++ phpdoc-fr/reference/image/functions/imagefontwidth.xml Sun Dec 28 14:33:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.imagefontwidth" xmlns="http://docbook.org/ns/docbook"> @@ -18,6 +18,7 @@ Retourne la largeur de la police <parameter>font</parameter> en pixels. </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -26,12 +27,55 @@ </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne la largeur de la police. </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imagefontwidth</function> et les polices internes</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo 'Largeur de la police : ' . imagefontwidth(4); +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +Largeur de la police : 8 +]]> + </screen> + </example> + <example> + <title>Exemple avec <function>imagefontwidth</function> et <function>imageloadfont</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Chargement d'une police .gdf +$font = imageloadfont('anonymous.gdf'); + +echo 'Largeur de la police : ' . imagefontwidth($font); +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +Largeur de la police : 23 +]]> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imageftbbox.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/image/functions/imageftbbox.xml diff -u phpdoc-fr/reference/image/functions/imageftbbox.xml:1.13 phpdoc-fr/reference/image/functions/imageftbbox.xml:1.14 --- phpdoc-fr/reference/image/functions/imageftbbox.xml:1.13 Sun Jul 22 19:39:24 2007 +++ phpdoc-fr/reference/image/functions/imageftbbox.xml Sun Dec 28 14:33:48 2008 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry xml:id='function.imageftbbox' xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -14,11 +14,14 @@ <type>array</type><methodname>imageftbbox</methodname> <methodparam><type>float</type><parameter>size</parameter></methodparam> <methodparam><type>float</type><parameter>angle</parameter></methodparam> - <methodparam><type>string</type><parameter>font_file</parameter></methodparam> + <methodparam><type>string</type><parameter>fontfile</parameter></methodparam> <methodparam><type>string</type><parameter>text</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>extrainfo</parameter></methodparam> </methodsynopsis> - &warn.undocumented.func; + <para> + Calcule le rectangle d'encadrement pour un texte, en utilisant la police + courante et freetype2. + </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; @@ -28,6 +31,8 @@ <term><parameter>size</parameter></term> <listitem> <para> + La taille de la police. Suivant votre version de GD, elle devra + être spécifié en pixel (GD1) ou en point (GD2). </para> </listitem> </varlistentry> @@ -35,13 +40,19 @@ <term><parameter>angle</parameter></term> <listitem> <para> + Angle, en degrés, dans lequel le paramètre <parameter>text</parameter> + sera mesuré. </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>font_file</parameter></term> + <term><parameter>fontfile</parameter></term> <listitem> <para> + Le nom du fichier de la police TrueType (peut être une URL). + Suivant la version de GD utilisée par PHP, il sera recherché les + fichiers qui ne commencent pas par un '/', en y ajoutant l'extension + '.ttf', et suivant le chemin des polices défini par la bibliothèque. </para> </listitem> </varlistentry> @@ -49,6 +60,7 @@ <term><parameter>text</parameter></term> <listitem> <para> + La chaîne à mesurer. </para> </listitem> </varlistentry> @@ -56,6 +68,25 @@ <term><parameter>extrainfo</parameter></term> <listitem> <para> + <table> + <title>Indexes possibles pour le tableau <parameter>extrainfo</parameter></title> + <tgroup cols="2"> + <thead> + <row> + <entry>Clé</entry> + <entry>Type</entry> + <entry>Signification</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>linespacing</literal></entry> + <entry><type>float</type></entry> + <entry>Définit l'espacement entre les lignes lors du dessin</entry> + </row> + </tbody> + </tgroup> + </table> </para> </listitem> </varlistentry> @@ -65,13 +96,99 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> + <function>imageftbbox</function> retourne un tableau contenant 8 éléments + représentant les 4 points du rectangle antourant le texte : + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry>0</entry> + <entry>Coin en bas, à gauche, position en X</entry> + </row> + <row> + <entry>1</entry> + <entry>Coin en bas, à gauche, position en Y</entry> + </row> + <row> + <entry>2</entry> + <entry>Coin en bas, à droite, position en X</entry> + </row> + <row> + <entry>3</entry> + <entry>Coin en bas, à droite, position en Y</entry> + </row> + <row> + <entry>4</entry> + <entry>Coin en haut, à droite, position en X</entry> + </row> + <row> + <entry>5</entry> + <entry>Coin en haut, à droite, position en Y</entry> + </row> + <row> + <entry>6</entry> + <entry>Coin en haut, à gauche, position en X</entry> + </row> + <row> + <entry>7</entry> + <entry>Coin en haut, à gauche, position en Y</entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + Les points sont relatifs au <emphasis>texte</emphasis> suivant le paramètre + <parameter>angle</parameter>, aussi, "en haut à gauche" signifie le coin en + haut à gauche lorsque l'on regarde le texte horizontalement. </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imageftbbox</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image de 300x150 pixels +$im = imagecreatetruecolor(300, 150); +$black = imagecolorallocate($im, 0, 0, 0); +$white = imagecolorallocate($im, 255, 255, 255); + +// Définit l'arrière-plan en blanc +imagefilledrectangle($im, 0, 0, 299, 299, $white); + +// Chemin vers notre fichier de police +$font = './arial.ttf'; + +// D'abord, nous créons un rectangle contenant notre texte +$bbox = imageftbbox(10, 0, $font, 'The PHP Documentation Group'); + +// Nos coordonnées en X et en Y +$x = $bbox[0] + (imagesx($im) / 2) - ($bbox[4] / 2) - 5; +$y = $bbox[1] + (imagesy($im) / 2) - ($bbox[5] / 2) - 5; + +imagefttext($im, 10, 0, $x, $y, $black, $font, 'The PHP Documentation Group'); + +// Affichage vers le navigateur +header('Content-type: image/png'); + +imagepng($im); +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; ¬e.gd.2; ¬e.freetype; </refsect1> + <refsect1 role="changelog"> &reftitle.changelog; <para> @@ -87,7 +204,7 @@ <row> <entry>4.3.5</entry> <entry> - Le paramètre <parameter>extrainfo</parameter> est devenu optionnel. + Le paramètre <parameter>extrainfo</parameter> devient optionnel. </entry> </row> </tbody> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagefttext.xml?r1=1.17&r2=1.18&diff_format=u Index: phpdoc-fr/reference/image/functions/imagefttext.xml diff -u phpdoc-fr/reference/image/functions/imagefttext.xml:1.17 phpdoc-fr/reference/image/functions/imagefttext.xml:1.18 --- phpdoc-fr/reference/image/functions/imagefttext.xml:1.17 Wed May 14 11:43:39 2008 +++ phpdoc-fr/reference/image/functions/imagefttext.xml Sun Dec 28 14:33:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> -<!-- EN-Revision: 1.15 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.18 $ --> +<!-- EN-Revision: 1.18 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id='function.imagefttext' xmlns="http://docbook.org/ns/docbook"> @@ -18,11 +18,12 @@ <methodparam><type>int</type><parameter>x</parameter></methodparam> <methodparam><type>int</type><parameter>y</parameter></methodparam> <methodparam><type>int</type><parameter>color</parameter></methodparam> - <methodparam><type>string</type><parameter>font_file</parameter></methodparam> + <methodparam><type>string</type><parameter>fontfile</parameter></methodparam> <methodparam><type>string</type><parameter>text</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>extrainfo</parameter></methodparam> </methodsynopsis> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -32,7 +33,7 @@ <term><parameter>size</parameter></term> <listitem> <para> - La taille de la police à utiliser, en nombre de points + La taille de la police à utiliser, en nombre de points. </para> </listitem> </varlistentry> @@ -66,8 +67,8 @@ <term><parameter>y</parameter></term> <listitem> <para> - L'ordonnée <literal>y-ordinate</literal>. Ce paramètre configure la position de base de la police, - et non pas le bas de cette dernière. + L'ordonnée <literal>y-ordinate</literal>. Ce paramètre configure la + position de base de la police, et non pas le bas de cette dernière. </para> </listitem> </varlistentry> @@ -76,16 +77,47 @@ <listitem> <para> L'index de la couleur désirée pour le texte, voir - la fonction <function>imagecolorexact</function> + la fonction <function>imagecolorexact</function>. </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>font_file</parameter></term> + <term><parameter>fontfile</parameter></term> <listitem> <para> - Le chemin complet vers le fichier représentant - la police de caractères à utiliser. + Le chemin vers la police TrueType à utiliser. + </para> + <para> + Suivant la version de GD utilisée par PHP, il sera recherché les + fichiers qui ne commencent pas par un '<literal>/</literal>', en y + ajoutant l'extension '<literal>.ttf</literal>', et suivant le chemin des + polices défini par la bibliothèque. + </para> + <para> + Lors de l'utilisation d'une version de GD inférieure à 2.0.18, un + caractère d'espacement (plutôt qu'un point-virgule) était utilisé + comment séparateur dans le chemin pour les différents fichiers de police. + Si vous utilisez toujours cette notation, vous obtiendrez le message + d'erreur suivant : + <literal>Warning: Could not find/open font</literal>. Pour ces anciennes + versions, la seule solution est de déplacer la police dans un dossier qui + ne contient pas d'espace. + </para> + <para> + Dans la plupart des cas, lorsque la police se trouve dans le même dossier + que le script qui cherche à l'utiliser, la solution suivante permet + de s'affranchir de tous les problèmes relatifs à l'inclusion. + <programlisting role="php"> +<![CDATA[ +<?php +// Définit la variable d'environnement pour GD +putenv('GDFONTPATH=' . realpath('.')); + +// Nom de la police à utiliser (note qu'il n'y a pas d'extension .ttf) +$font = 'SomeFont'; +?> +]]> + </programlisting> </para> </listitem> </varlistentry> @@ -101,12 +133,32 @@ <term><parameter>extrainfo</parameter></term> <listitem> <para> + <table> + <title>Indexes possibles pour le tableau <parameter>extrainfo</parameter></title> + <tgroup cols="2"> + <thead> + <row> + <entry>Clé</entry> + <entry>Type</entry> + <entry>Signification</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>linespacing</literal></entry> + <entry><type>float</type></entry> + <entry>Définit l'espacement entre les lignes lors du dessin</entry> + </row> + </tbody> + </tgroup> + </table> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> @@ -153,11 +205,47 @@ </informaltable> </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imagefttext</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image de 300x100 pixels +$im = imagecreatetruecolor(300, 100); +$red = imagecolorallocate($im, 0xFF, 0x00, 0x00); +$black = imagecolorallocate($im, 0x00, 0x00, 0x00); + +// Définit l'arrière-plan en rouge +imagefilledrectangle($im, 0, 0, 299, 99, $red); + +// Chemin vers notre fichier de police ttf +$font_file = './arial.ttf'; + +// Dessine le texte 'PHP Manual' en utilisant une police de taille 13 +imagefttext($im, 13, 0, 105, 55, $black, $font_file, 'PHP Manual'); + +// Affichage de l'image sur le navigateur +header('Content-Type: image/png'); + +imagepng($im); +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; ¬e.gd.2; ¬e.freetype; </refsect1> + <refsect1 role="changelog"> &reftitle.changelog; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagegammacorrect.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/image/functions/imagegammacorrect.xml diff -u phpdoc-fr/reference/image/functions/imagegammacorrect.xml:1.13 phpdoc-fr/reference/image/functions/imagegammacorrect.xml:1.14 --- phpdoc-fr/reference/image/functions/imagegammacorrect.xml:1.13 Sun Jul 22 19:39:24 2007 +++ phpdoc-fr/reference/image/functions/imagegammacorrect.xml Sun Dec 28 14:33:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.imagegammacorrect" xmlns="http://docbook.org/ns/docbook"> @@ -29,7 +29,7 @@ <term><parameter>inputgamma</parameter></term> <listitem> <para> - Le facteur gamma d'entrée + Le facteur gamma d'entrée. </para> </listitem> </varlistentry> @@ -37,19 +37,45 @@ <term><parameter>outputgamma</parameter></term> <listitem> <para> - Le facteur gamma de sortie + Le facteur gamma de sortie. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imagegammacorrect</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image +$im = imagecreatefromgif('php.gif'); + +// Correction gamma, sortie à 1.537 +imagegammacorrect($im, 1.0, 1.537); + +// Sauvegarde et libération de la mémoire +imagegif($im, './php_gamma_corrected.gif'); +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagegd2.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/reference/image/functions/imagegd2.xml diff -u phpdoc-fr/reference/image/functions/imagegd2.xml:1.16 phpdoc-fr/reference/image/functions/imagegd2.xml:1.17 --- phpdoc-fr/reference/image/functions/imagegd2.xml:1.16 Mon Apr 14 18:30:07 2008 +++ phpdoc-fr/reference/image/functions/imagegd2.xml Sun Dec 28 14:33:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.20 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id='function.imagegd2' xmlns="http://docbook.org/ns/docbook"> @@ -21,6 +21,7 @@ Génère une image au format GD2, vers le fichier <parameter>filename</parameter>. </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -39,6 +40,7 @@ <term><parameter>chunk_size</parameter></term> <listitem> <para> + Taille de la pièce. </para> </listitem> </varlistentry> @@ -55,12 +57,60 @@ </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Affichage d'une image GD2</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image vide et ajout d'un texte +$im = imagecreatetruecolor(120, 20); +$text_color = imagecolorallocate($im, 233, 14, 91); +imagestring($im, 1, 5, 5, "Un texte simple", $text_color); + +imagegd2($im); + +// Libération de la mémoire +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>Sauvegarde d'une image GD2</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image vide et ajout d'un texte +$im = imagecreatetruecolor(120, 20); +$text_color = imagecolorallocate($im, 233, 14, 91); +imagestring($im, 1, 5, 5, "Un texte simple", $text_color); + +// Sauvegarde de l'image GD2 +// Le format de fichier pour les images GD2 est .gd2, voir http://www.libgd.org/GdFileFormats +imagegd2($im, 'simple.gd'); + +// Libération de la mémoire +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; ¬e.gd.2; http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagegd.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/image/functions/imagegd.xml diff -u phpdoc-fr/reference/image/functions/imagegd.xml:1.14 phpdoc-fr/reference/image/functions/imagegd.xml:1.15 --- phpdoc-fr/reference/image/functions/imagegd.xml:1.14 Mon Apr 14 18:30:07 2008 +++ phpdoc-fr/reference/image/functions/imagegd.xml Sun Dec 28 14:33:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id='function.imagegd' xmlns="http://docbook.org/ns/docbook"> @@ -36,12 +36,61 @@ </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Affichage d'une image GD</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image vide et ajout d'un texte +$im = imagecreatetruecolor(120, 20); +$text_color = imagecolorallocate($im, 233, 14, 91); +imagestring($im, 1, 5, 5, "Un texte simple", $text_color); + +// Affichage de l'image +imagegd($im); + +// Libération de la mémoire +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>Sauvegarde d'une image GD</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image vide et ajout d'un texte +$im = imagecreatetruecolor(120, 20); +$text_color = imagecolorallocate($im, 233, 14, 91); +imagestring($im, 1, 5, 5, "Un texte simple", $text_color); + +// Sauvegarde de l'image GD +// Le format de fichier pour les images GD est .gd, voir http://www.libgd.org/GdFileFormats +imagegd($im, 'simple.gd'); + +// Libération de la mémoire +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; <note> @@ -52,6 +101,7 @@ </para> </note> </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagegif.xml?r1=1.25&r2=1.26&diff_format=u Index: phpdoc-fr/reference/image/functions/imagegif.xml diff -u phpdoc-fr/reference/image/functions/imagegif.xml:1.25 phpdoc-fr/reference/image/functions/imagegif.xml:1.26 --- phpdoc-fr/reference/image/functions/imagegif.xml:1.25 Sat Jun 21 20:51:34 2008 +++ phpdoc-fr/reference/image/functions/imagegif.xml Sun Dec 28 14:33:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.25 $ --> -<!-- EN-Revision: 1.18 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.26 $ --> +<!-- EN-Revision: 1.19 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.imagegif" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -28,6 +28,7 @@ <acronym>GIF89a</acronym>. </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -45,12 +46,63 @@ </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Affichage d'une image en utilisant <function>imagegif</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image +$im = imagecreatetruecolor(100, 100); + +// Définit l'arrière-plan en blanc +imagefilledrectangle($im, 0, 0, 99, 99, 0xFFFFFF); + +// Dessine un texte dans l'image +imagestring($im, 3, 40, 20, 'GD Library', 0xFFBA00); + +// Affiche l'image sur le navigateur +header('Content-type: image/gif'); + +imagegif($im); +imagedestroy($im); +?> +]]> + </programlisting> + </example> + <example> + <title>Convertion d'une image PNG en GIF, en utilisant <function>imagegif</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Chargement de l'image PNG +$png = imagecreatefrompng('./php.png'); + +// Sauvegarde de l'image en GIF +imagegif($png, './php.gif'); + +// Libération de la mémoire +imagedestroy($png); + +// C'est fait ! +echo 'Convertion avec succès de l'image PNG en GIF !'; +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; <note> @@ -71,20 +123,52 @@ <programlisting role="php"> <![CDATA[ <?php -if (function_exists("imagegif")) { - header("Content-type: image/gif"); +// Création d'une image +$im = imagecreatetruecolor(100, 100); + +// On fait quelques opérations sur l'image ici... + +// Gestion de l'affichage +if(function_exists('imagegif')) +{ + // Pour GIF + header('Content-type: image/gif'); + imagegif($im); -} elseif (function_exists("imagejpeg")) { - header("Content-type: image/jpeg"); - imagejpeg($im, "", 0.5); -} elseif (function_exists("imagepng")) { - header("Content-type: image/png"); +} +elseif(function_exists('imagejpeg')) +{ + // Pour JPEG + header('Content-type: image/jpeg'); + + imagejpeg($im, NULL, 100); +} +elseif(function_exists('imagepng')) +{ + // Pour PNG + header('Content-type: image/png'); + imagepng($im); -} elseif (function_exists("imagewbmp")) { - header("Content-type: image/vnd.wap.wbmp"); +} +elseif(function_exists('imagewbmp')) +{ + // Pour WBMP + header('Content-type: image/vnd.wap.wbmp'); + imagewbmp($im); -} else { - die("Pas de support graphique avec PHP sur ce serveur"); +} +else +{ + imagedestroy($im); + + die('Aucun support sur ce serveur PHP n\'a été trouvé'); +} + +// Si un support a été trouvé pour un de ces formats, +// nous libérons la mémoire +if($im) +{ + imagedestroy($im); } ?> ]]> @@ -94,7 +178,7 @@ </note> <note> <para> - Depuis les versions 3.0.18 et 4.0.2, vous pouvez utiliser la + Depuis les versions 3.0.18 et 4.0.2 de PHP, vous pouvez utiliser la fonction <function>imagetypes</function> au lieu de <function>function_exists</function> pour vérifier la présence des différents formats d'images supportés.: @@ -102,10 +186,13 @@ <programlisting role="php"> <![CDATA[ <?php -if (imagetypes() & IMG_GIF) { - header ("Content-type: image/gif"); - imagegif ($im); -} elseif (imagetypes() & IMG_JPG) { +if(imagetypes() & IMG_GIF) +{ + header('Content-type: image/gif'); + imagegif($im); +} +elseif(imagetypes() & IMG_JPG) +{ /* ... etc. */ } ?> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imageinterlace.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/image/functions/imageinterlace.xml diff -u phpdoc-fr/reference/image/functions/imageinterlace.xml:1.15 phpdoc-fr/reference/image/functions/imageinterlace.xml:1.16 --- phpdoc-fr/reference/image/functions/imageinterlace.xml:1.15 Thu May 22 22:54:34 2008 +++ phpdoc-fr/reference/image/functions/imageinterlace.xml Sun Dec 28 14:33:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.imageinterlace" xmlns="http://docbook.org/ns/docbook"> @@ -23,6 +23,7 @@ l'image créée sera un <acronym>JPEG</acronym> progressif. </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -40,12 +41,38 @@ </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne 1 si l'entrelacement est activé pour l'image, 0 sinon. </para> </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Activation de l'entrelacement en utilisant la fonction <function>imageinterlace</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Création d'une image +$im = imagecreatefrom('php.gif'); + +// Activation de l'entrelacement +imageinterlace($im, true); + +// Sauvegarde de l'image +imagegif($im, './php_interlaced.gif'); +imagedestroy($im); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file