cvs: phpdoc-fr /reference/image/functions image-type-to-extension.xml image-type-to-mime-type.xml imagearc.xml imagechar.xml imagecharup.xml
imagecolorallocate.xml imagecolorallocatealpha.xml imagecolorat.xml imageconvolution.xml imagecopy.xml imagecopymerge.xml imagecopymergegray.xml
imagecopyresampled.xml imagecopyresized.xml imagecreate.xml imagecreatefromgd.xml imagecreatefromgd2.xml imagecreatefromgd2part.xml
| From: | Yannick Torres | Date: | Sun, 28 Jan 2007 09:01:29 +0000 |
| Subject: | cvs: phpdoc-fr /reference/image/functions image-type-to-extension.xml image-type-to-mime-type.xml imagearc.xml imagechar.xml imagecharup.xml imagecolorallocate.xml imagecolorallocatealpha.xml imagecolorat.xml imageconvolution.xml imagecopy.xml imagecopymerge.xml imagecopymergegray.xml imagecopyresampled.xml imagecopyresized.xml imagecreate.xml imagecreatefromgd.xml imagecreatefromgd2.xml imagecreatefromgd2part.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-5199@lists.php.net to get a copy of this message | ||
yannick Sun Jan 28 09:01:29 2007 UTC
Modified files:
/phpdoc-fr/reference/image/functions imagearc.xml imagecharup.xml
imagechar.xml
imagecolorallocatealpha.xml
imagecolorallocate.xml
imagecolorat.xml
imageconvolution.xml
imagecopymergegray.xml
imagecopymerge.xml
imagecopyresampled.xml
imagecopyresized.xml
imagecopy.xml
imagecreatefromgd2part.xml
imagecreatefromgd2.xml
imagecreatefromgd.xml
imagecreate.xml
image-type-to-extension.xml
image-type-to-mime-type.xml
Log:
sync with EN
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagearc.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/reference/image/functions/imagearc.xml diff -u phpdoc-fr/reference/image/functions/imagearc.xml:1.16 phpdoc-fr/reference/image/functions/imagearc.xml:1.17 --- phpdoc-fr/reference/image/functions/imagearc.xml:1.16 Sun Jan 14 13:37:18 2007 +++ phpdoc-fr/reference/image/functions/imagearc.xml Sun Jan 28 09:01:28 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry id="function.imagearc"> @@ -113,10 +113,17 @@ // Allocation de couleurs $white = imagecolorallocate($img, 255, 255, 255); -$black = imagecolorallocate($img, 0, 0, 0); - -// Dessine d'un cercle noir -imagearc($img, 100, 100, 150, 150, 0, 360, $black); +$red = imagecolorallocate($img, 255, 0, 0); +$green = imagecolorallocate($img, 0, 255, 0); +$blue = imagecolorallocate($img, 0, 0, 255); + +// Dessine la tête +imagearc($img, 100, 100, 200, 200, 0, 360, $white); +// La bouche +imagearc($img, 100, 100, 150, 150, 25, 155, $red); +// les yeux gauche et droit +imagearc($img, 60, 75, 50, 50, 0, 360, $green); +imagearc($img, 140, 75, 50, 50, 0, 360, $blue); // Affichage au navigateur header("Content-type: image/png"); @@ -128,6 +135,10 @@ ?> ]]> </programlisting> + &example.outputs.similar; + <screenshot> + <graphic fileref="figures/image.imagearc.png" /> + </screenshot> </example> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecharup.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecharup.xml diff -u phpdoc-fr/reference/image/functions/imagecharup.xml:1.14 phpdoc-fr/reference/image/functions/imagecharup.xml:1.15 --- phpdoc-fr/reference/image/functions/imagecharup.xml:1.14 Sun Jan 14 13:37:18 2007 +++ phpdoc-fr/reference/image/functions/imagecharup.xml Sun Jan 28 09:01:28 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.11 Maintainer: didou Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry id="function.imagecharup"> @@ -97,6 +97,10 @@ ?> ]]> </programlisting> + &example.outputs.similar; + <screenshot> + <graphic fileref="figures/image.imagecharup.png" /> + </screenshot> </example> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagechar.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/image/functions/imagechar.xml diff -u phpdoc-fr/reference/image/functions/imagechar.xml:1.14 phpdoc-fr/reference/image/functions/imagechar.xml:1.15 --- phpdoc-fr/reference/image/functions/imagechar.xml:1.14 Sun Jan 14 16:05:58 2007 +++ phpdoc-fr/reference/image/functions/imagechar.xml Sun Jan 28 09:01:28 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.12 Maintainer: didou Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry id="function.imagechar"> @@ -100,6 +100,10 @@ ?> ]]> </programlisting> + &example.outputs.similar; + <screenshot> + <graphic fileref="figures/image.imagechar.png" /> + </screenshot> </example> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecolorallocatealpha.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecolorallocatealpha.xml diff -u phpdoc-fr/reference/image/functions/imagecolorallocatealpha.xml:1.12 phpdoc-fr/reference/image/functions/imagecolorallocatealpha.xml:1.13 --- phpdoc-fr/reference/image/functions/imagecolorallocatealpha.xml:1.12 Sun Jan 14 16:05:58 2007 +++ phpdoc-fr/reference/image/functions/imagecolorallocatealpha.xml Sun Jan 28 09:01:28 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry id="function.imagecolorallocatealpha"> @@ -74,6 +74,29 @@ Un identifiant de couleur ou &false; si l'allocation échoue. </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Avant la version 5.1.3</entry> + <entry> + Retourne -1 si l'allocation échoue. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> @@ -118,6 +141,10 @@ ?> ]]> </programlisting> + &example.outputs.similar; + <screenshot> + <graphic fileref="figures/image.imagecolorallocatealpha.png" /> + </screenshot> </example> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecolorallocate.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecolorallocate.xml diff -u phpdoc-fr/reference/image/functions/imagecolorallocate.xml:1.18 phpdoc-fr/reference/image/functions/imagecolorallocate.xml:1.19 --- phpdoc-fr/reference/image/functions/imagecolorallocate.xml:1.18 Sun Jan 14 16:05:58 2007 +++ phpdoc-fr/reference/image/functions/imagecolorallocate.xml Sun Jan 28 09:01:28 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry id="function.imagecolorallocate"> @@ -70,7 +70,30 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Un identifiant de couleur ou -1 si l'allocation échoue. + Un identifiant de couleur ou &false; si l'allocation échoue. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Avant la version 5.1.3</entry> + <entry> + Retourne -1 si l'allocation échoue. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </para> </refsect1> <refsect1 role="examples"> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecolorat.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecolorat.xml diff -u phpdoc-fr/reference/image/functions/imagecolorat.xml:1.13 phpdoc-fr/reference/image/functions/imagecolorat.xml:1.14 --- phpdoc-fr/reference/image/functions/imagecolorat.xml:1.13 Sun Jan 14 20:41:53 2007 +++ phpdoc-fr/reference/image/functions/imagecolorat.xml Sun Jan 28 09:01:28 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry id="function.imagecolorat"> @@ -65,14 +65,22 @@ <programlisting role="php"> <![CDATA[ <?php -$im = ImageCreateFromPng("rockym.png"); -$rgb = ImageColorAt($im, 100, 100); +$im = imagecreatefrompng("php.png"); +$rgb = imagecolorat($im, 10, 15); $r = ($rgb >> 16) & 0xFF; $g = ($rgb >> 8) & 0xFF; $b = $rgb & 0xFF; ?> ]]> </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +int(119) +int(123) +int(180) +]]> + </screen> </example> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imageconvolution.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/image/functions/imageconvolution.xml diff -u phpdoc-fr/reference/image/functions/imageconvolution.xml:1.3 phpdoc-fr/reference/image/functions/imageconvolution.xml:1.4 --- phpdoc-fr/reference/image/functions/imageconvolution.xml:1.3 Sun Jan 14 20:41:53 2007 +++ phpdoc-fr/reference/image/functions/imageconvolution.xml Sun Jan 28 09:01:28 2007 @@ -1,23 +1,25 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry id="function.imageconvolution"> <refnamediv> <refname>imageconvolution</refname> - <refpurpose>Applique une matrice de la convolution 3x3, en utilisant la division de coefficient et l'excentrage</refpurpose> + <refpurpose>Applique une matrice de la convolution 3x3, en utilisant le coefficient et l'excentrage</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>imageconvolution</methodname> <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>array</type><parameter>matrix3x3</parameter></methodparam> + <methodparam><type>array</type><parameter>matrix</parameter></methodparam> <methodparam><type>float</type><parameter>div</parameter></methodparam> <methodparam><type>float</type><parameter>offset</parameter></methodparam> </methodsynopsis> - &warn.undocumented.func; + <para> + Applique une matrice de la convolution 3x3, en utilisant le coefficient et l'excentrage. + </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; @@ -25,9 +27,10 @@ <variablelist> &gd.image.description; <varlistentry> - <term><parameter>matrix3x3</parameter></term> + <term><parameter>matrix</parameter></term> <listitem> <para> + Une matrice 3x3 : un tableau contenant trois tableaux de trois nombres à virgules flottantes. </para> </listitem> </varlistentry> @@ -35,6 +38,7 @@ <term><parameter>div</parameter></term> <listitem> <para> + Le diviseur du résultat de la convolution, utilisé pour la normalisation. </para> </listitem> </varlistentry> @@ -54,10 +58,68 @@ &return.success; </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Impression du logo PHP.net</title> + <programlisting role="php"> +<![CDATA[ +<?php +$image = imagecreatefromgif('http://www.php.net/images/php.gif'); + +$emboss = array(array(2, 0, 0), array(0, -1, 0), array(0, 0, -1)); +imageconvolution($image, $emboss, 1, 127); + +header('Content-Type: image/png'); +imagepng($image, null, 9); +?> +]]> + </programlisting> + &example.outputs; + <screenshot> + <graphic fileref="figures/image.imageconvolution_emboss.png" /> + </screenshot> + </example> + <example> + <title>Floue gaussien</title> + <programlisting role="php"> +<![CDATA[ +<?php +$image = imagecreatetruecolor(180,40); + +// Écrit le texte et applique un floue gaussien sur l'image +imagestring($image, 5, 10, 8, 'Texte floue goussien', 0x00ff00); +$gaussian = array(array(1.0, 2.0, 1.0), array(2.0, 4.0, 2.0), array(1.0, 2.0, 1.0)); +imageconvolution($image, $gaussian, 16, 0); + +// Récrit le texte pour la comparaison +imagestring($image, 5, 10, 18, 'Texte floue goussien', 0x00ff00); + +header('Content-Type: image/png'); +imagepng($image, null, 9); +?> +]]> + </programlisting> + &example.outputs; + <screenshot> + <graphic fileref="figures/image.imageconvolution_gaussian.png" /> + </screenshot> + </example> + </para> + </refsect1> <refsect1 role="notes"> &reftitle.notes; ¬e.bundled.gd; </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imagefilter</function></member> + </simplelist> + </para> + </refsect1> </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecopymergegray.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecopymergegray.xml diff -u phpdoc-fr/reference/image/functions/imagecopymergegray.xml:1.11 phpdoc-fr/reference/image/functions/imagecopymergegray.xml:1.12 --- phpdoc-fr/reference/image/functions/imagecopymergegray.xml:1.11 Sat Jun 25 09:33:27 2005 +++ phpdoc-fr/reference/image/functions/imagecopymergegray.xml Sun Jan 28 09:01:28 2007 @@ -1,57 +1,136 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imagecopymergegray"> - <refnamediv> - <refname>imagecopymergegray</refname> - <refpurpose> - Copie et fusionne une partie d'une image en niveaux de gris - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>imagecopymergegray</methodname> - <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam> - <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_x</parameter></methodparam> - <methodparam><type>int</type><parameter>src_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_w</parameter></methodparam> - <methodparam><type>int</type><parameter>src_h</parameter></methodparam> - <methodparam><type>int</type><parameter>pct</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagecopymergegray</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>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 - copiée aux coordonnées (<parameter>dst_x</parameter>, <parameter>dst_y</parameter>), - dans l'image de destination. Les deux images seront fusionnées - suivant le paramètre <parameter>pct</parameter>, qui peut valoir de - 0 à 100. Si <parameter>pct</parameter> = 0, aucune action n'est - faite, alors que si <parameter>pct</parameter> = 100, - <function>imagecopymerge</function> se comporte exactement comme - <function>imagecopy</function>. - </para> - <para> - <function>imagecopymergegray</function> est identique à la fonction - <function>imagecopymerge</function>, hormis le fait que lors de la - fusion, le "hue" de l'image sera conservé grâce à la conversion - de la zone dans l'image de destination en gris, avant l'opération - de copie. - </para> - <note> - <para> - <function>imagecopymergegray</function> a été ajoutée en &php; 4.0.6. - </para> - </note> - </refsect1> - </refentry> + +<refentry id="function.imagecopymergegray"> + <refnamediv> + <refname>imagecopymergegray</refname> + <refpurpose>Copie et fusionne une partie d'une image en niveaux de gris</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>imagecopymergegray</methodname> + <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam> + <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_x</parameter></methodparam> + <methodparam><type>int</type><parameter>src_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_w</parameter></methodparam> + <methodparam><type>int</type><parameter>src_h</parameter></methodparam> + <methodparam><type>int</type><parameter>pct</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecopymergegray</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>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 + copiée aux coordonnées (<parameter>dst_x</parameter>, <parameter>dst_y</parameter>), + dans l'image de destination. + </para> + <para> + <function>imagecopymergegray</function> est identique à la fonction + <function>imagecopymerge</function>, hormis le fait que lors de la + fusion, le "hue" de l'image sera conservé grâce à la conversion + de la zone dans l'image de destination en gris, avant l'opération + de copie. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dst_im</parameter></term> + <listitem> + <para> + Ressource de l'image de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_im</parameter></term> + <listitem> + <para> + Ressource de l'image source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_x</parameter></term> + <listitem> + <para> + X : coordonnée du point de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_y</parameter></term> + <listitem> + <para> + Y : coordonnée du point de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_x</parameter></term> + <listitem> + <para> + X : coordonnée du point source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_y</parameter></term> + <listitem> + <para> + Y : coordonnée du point source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_w</parameter></term> + <listitem> + <para> + Largeur de la source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_h</parameter></term> + <listitem> + <para> + Hauteur de la source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>pct</parameter></term> + <listitem> + <para> + Les deux images seront fusionnées + suivant le paramètre <parameter>pct</parameter>, qui peut valoir de + 0 à 100. Si <parameter>pct</parameter> = 0, aucune action n'est + faite, alors que si <parameter>pct</parameter> = 100, + <function>imagecopymerge</function> se comporte exactement comme + <function>imagecopy</function>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -72,4 +151,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecopymerge.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecopymerge.xml diff -u phpdoc-fr/reference/image/functions/imagecopymerge.xml:1.12 phpdoc-fr/reference/image/functions/imagecopymerge.xml:1.13 --- phpdoc-fr/reference/image/functions/imagecopymerge.xml:1.12 Sat Jun 25 09:33:27 2005 +++ phpdoc-fr/reference/image/functions/imagecopymerge.xml Sun Jan 28 09:01:28 2007 @@ -1,51 +1,130 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imagecopymerge"> - <refnamediv> - <refname>imagecopymerge</refname> - <refpurpose> - Copie et fusionne une partie d'une image - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>imagecopymerge</methodname> - <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam> - <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_x</parameter></methodparam> - <methodparam><type>int</type><parameter>src_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_w</parameter></methodparam> - <methodparam><type>int</type><parameter>src_h</parameter></methodparam> - <methodparam><type>int</type><parameter>pct</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagecopymerge</function> copie une partie de - l'image <parameter>src_im</parameter> dans l'image de destination - <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 - copiée aux coordonnées (<parameter>dst_x</parameter>, <parameter>dst_y</parameter>), - dans l'image de destination. Les deux images seront fusionnées - suivant le paramètre <parameter>pct</parameter>, qui peut valoir de - 0 à 100. Si <parameter>pct</parameter> = 0, aucune action n'est - faite, alors que si <parameter>pct</parameter> = 100, - <function>imagecopymerge</function> se comporte exactement comme - <function>imagecopy</function> pour les images de palette, - tandis qu'il implémente la transparence alpha pour les images en couleur vraies. - </para> - <note> - <para> - <function>imagecopymerge</function> a été ajoutée en &php; 4.0.6. - </para> - </note> - </refsect1> - </refentry> + +<refentry id="function.imagecopymerge"> + <refnamediv> + <refname>imagecopymerge</refname> + <refpurpose>Copie et fusionne une partie d'une image</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>imagecopymerge</methodname> + <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam> + <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_x</parameter></methodparam> + <methodparam><type>int</type><parameter>src_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_w</parameter></methodparam> + <methodparam><type>int</type><parameter>src_h</parameter></methodparam> + <methodparam><type>int</type><parameter>pct</parameter></methodparam> + </methodsynopsis> + <para> + Copie une partie de l'image <parameter>src_im</parameter> + dans l'image de destination <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 copiée aux coordonnées + (<parameter>dst_x</parameter>, <parameter>dst_y</parameter>), + dans l'image de destination. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dst_im</parameter></term> + <listitem> + <para> + Ressource de l'image de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_im</parameter></term> + <listitem> + <para> + Ressource de l'image source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_x</parameter></term> + <listitem> + <para> + X : coordonnée du point de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_y</parameter></term> + <listitem> + <para> + Y : coordonnée du point de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_x</parameter></term> + <listitem> + <para> + X : coordonnée du point source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_y</parameter></term> + <listitem> + <para> + Y : coordonnée du point source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_w</parameter></term> + <listitem> + <para> + Largeur de la source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_h</parameter></term> + <listitem> + <para> + Hauteur de la source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>pct</parameter></term> + <listitem> + <para> + Les deux images seront fusionnées + suivant le paramètre <parameter>pct</parameter>, qui peut valoir de + 0 à 100. Si <parameter>pct</parameter> = 0, aucune action n'est + faite, alors que si <parameter>pct</parameter> = 100, + <function>imagecopymerge</function> se comporte exactement comme + <function>imagecopy</function> pour les images de palette, + tandis qu'il implémente la transparence alpha pour les images en couleur vraies. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -66,4 +145,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecopyresampled.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecopyresampled.xml diff -u phpdoc-fr/reference/image/functions/imagecopyresampled.xml:1.18 phpdoc-fr/reference/image/functions/imagecopyresampled.xml:1.19 --- phpdoc-fr/reference/image/functions/imagecopyresampled.xml:1.18 Sat Aug 5 19:59:29 2006 +++ phpdoc-fr/reference/image/functions/imagecopyresampled.xml Sun Jan 28 09:01:28 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry id="function.imagecopyresampled"> @@ -8,7 +8,7 @@ <refname>imagecopyresampled</refname> <refpurpose>Copie, redimensionne, rééchantillonne une image</refpurpose> </refnamediv> - <refsect1> + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>imagecopyresampled</methodname> @@ -29,37 +29,111 @@ l'image <parameter>dst_im</parameter>. Durant la copie, la zone est rééchantillonnée de manière à conserver la clarté de l'image durant une réduction. - &return.success; </para> <para> - <parameter>dst_im</parameter> est l'image de destination, - <parameter>src_im</parameter> est l'image source. Si les hauteurs et largeurs des source et destination - diffèrent, l'image copiée sera étirée - de manière appropriée. + 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, (si <parameter>dst_image</parameter> est la même que <parameter>src_image</parameter>) mais si les régions se chevauchent, les résultats sont imprévisibles. </para> - <note> - <para> - Il y a un problème dû aux limitations de la taille de la palette - (255 + 1 couleurs différentes). Filtrer ou rééchantillonner une image - demande plus de 255 couleurs, une approximation est alors utilisée pour - calculer le nouveau nombre de couleurs. Avec une palette, si une nouvelle - couleur ne peut être allouée, la couleur la plus proche (en théorie) - est utilisée. Ce n'est pas toujours la couleur la plus proche visuellement. - Cela peut générer des problèmes étranges, comme des images blanches. - Pour éviter ce problème, passez en image TrueColor, comme celles - générée par la fonction <function>imagecreatetruecolor</function>. - </para> - </note> - ¬e.gd.2; </refsect1> - - <refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dst_im</parameter></term> + <listitem> + <para> + Lien vers la ressource de l'image de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_im</parameter></term> + <listitem> + <para> + Lien vers la ressource de l'image source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_x</parameter></term> + <listitem> + <para> + X : coordonnées du point de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_y</parameter></term> + <listitem> + <para> + Y : coordonnées du point de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_x</parameter></term> + <listitem> + <para> + X : coordonnées du point source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_y</parameter></term> + <listitem> + <para> + Y : coordonnées du point source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_w</parameter></term> + <listitem> + <para> + Largueur de la destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_h</parameter></term> + <listitem> + <para> + Hauteur de la destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_w</parameter></term> + <listitem> + <para> + Largeur de la source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_h</parameter></term> + <listitem> + <para> + Hauteur de la source + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> <example> @@ -92,9 +166,12 @@ ?> ]]> </programlisting> + &example.outputs.similar; + <screenshot> + <graphic fileref="figures/image.imagecopyresampled.jpg" /> + </screenshot> </example> </para> - <para> <example> <title>Redimensionnement proportionnel d'une image</title> @@ -121,9 +198,9 @@ $ratio_orig = $width_orig/$height_orig; if ($width/$height > $ratio_orig) { - $width = $height*$ratio_orig; + $width = $height*$ratio_orig; } else { - $height = $width/$ratio_orig; + $height = $width/$ratio_orig; } // Redimensionnement @@ -136,14 +213,33 @@ ?> ]]> </programlisting> + &example.outputs.similar; + <screenshot> + <graphic fileref="figures/image.imagecopyresampled_2.jpg" /> + </screenshot> </example> </para> </refsect1> - - <refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Il y a un problème dû aux limitations de la taille de la palette + (255 + 1 couleurs différentes). Filtrer ou rééchantillonner une image + demande plus de 255 couleurs, une approximation est alors utilisée pour + calculer le nouveau nombre de couleurs. Avec une palette, si une nouvelle + couleur ne peut être allouée, la couleur la plus proche (en théorie) + est utilisée. Ce n'est pas toujours la couleur la plus proche visuellement. + Cela peut générer des problèmes étranges, comme des images blanches. + Pour éviter ce problème, passez en image TrueColor, comme celles + générée par la fonction <function>imagecreatetruecolor</function>. + </para> + </note> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> - <function>imagecopyresized</function>. + <function>imagecopyresized</function> </para> </refsect1> </refentry> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecopyresized.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecopyresized.xml diff -u phpdoc-fr/reference/image/functions/imagecopyresized.xml:1.16 phpdoc-fr/reference/image/functions/imagecopyresized.xml:1.17 --- phpdoc-fr/reference/image/functions/imagecopyresized.xml:1.16 Tue Aug 30 00:02:41 2005 +++ phpdoc-fr/reference/image/functions/imagecopyresized.xml Sun Jan 28 09:01:28 2007 @@ -1,65 +1,145 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imagecopyresized"> - <refnamediv> - <refname>imagecopyresized</refname> - <refpurpose>Copie et redimensionne une partie d'une image</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>imagecopyresized</methodname> - <methodparam><type>resource</type><parameter>dst_image</parameter></methodparam> - <methodparam><type>resource</type><parameter>src_image</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_x</parameter></methodparam> - <methodparam><type>int</type><parameter>src_y</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_w</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_h</parameter></methodparam> - <methodparam><type>int</type><parameter>src_w</parameter></methodparam> - <methodparam><type>int</type><parameter>src_h</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagecopyresized</function> copie une partie rectangulaire d'une image - dans une autre image de destination. <parameter>dst_image</parameter> est l'image - de destination, <parameter>src_image</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 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_image</parameter> et - <parameter>src_image</parameter> sont identiques), mais si les - régions se chevauchent, le résultat risque d'être - incohérent. - </para> - <note> + +<refentry id="function.imagecopyresized"> + <refnamediv> + <refname>imagecopyresized</refname> + <refpurpose>Copie et redimensionne une partie d'une image</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>imagecopyresized</methodname> + <methodparam><type>resource</type><parameter>dst_image</parameter></methodparam> + <methodparam><type>resource</type><parameter>src_image</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_x</parameter></methodparam> + <methodparam><type>int</type><parameter>src_y</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_w</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_h</parameter></methodparam> + <methodparam><type>int</type><parameter>src_w</parameter></methodparam> + <methodparam><type>int</type><parameter>src_h</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecopyresized</function> copie une partie rectangulaire d'une image + dans une autre image de destination. <parameter>dst_image</parameter> est l'image + de destination, <parameter>src_image</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 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_image</parameter> et + <parameter>src_image</parameter> sont identiques), mais si les + régions se chevauchent, le résultat risque d'être + incohérent. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dst_im</parameter></term> + <listitem> + <para> + Lien vers la ressource de l'image de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_im</parameter></term> + <listitem> + <para> + Lien vers la ressource de l'image source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_x</parameter></term> + <listitem> + <para> + X : coordonnée du point de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_y</parameter></term> + <listitem> + <para> + Y : coordonnée du point de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_x</parameter></term> + <listitem> + <para> + X : coordonnée du point source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_y</parameter></term> + <listitem> + <para> + Y : coordonnée du point source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_w</parameter></term> + <listitem> + <para> + Largeur de la destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_h</parameter></term> + <listitem> + <para> + Hauteur de la destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_w</parameter></term> + <listitem> + <para> + Largeur de la source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_h</parameter></term> + <listitem> + <para> + Hauteur de la source + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Redimensionnement d'une image</title> <para> - Il y a un problème dû aux limitations de la taille de la palette - (255 + 1 couleurs différentes). Filtrer ou rééchantillonner une image - demande plus de 255 couleurs, une approximation est alors utilisée pour - calculer le nouveau nombre de couleurs. Avec une palette, si une nouvelle - couleur ne peut être allouée, la couleur la plus proche (en théorie) - est utilisée ; ce n'est pas toujours celle qui est la plus proche visuellement. - Cela peut générer des problèmes étranges, comme des images blanches. - Pour éviter ce problème, passez en image TrueColor, comme celles - générée par la fonction <function>imagecreatetruecolor</function>. + Cet exemple affichera l'image redimensionné à la moitié de sa taille d'origine. </para> - </note> - </refsect1> - - <refsect1> - &reftitle.examples; - <para> - <example> - <title>Redimensionnement d'une image</title> - <para> - Cet exemple affichera l'image redimensionné à la moitié de sa taille d'origine. - </para> - <programlisting role="php"> + <programlisting role="php"> <![CDATA[ <?php // Fichier et nouvelle taille @@ -74,7 +154,7 @@ $newwidth = $width * $percent; $newheight = $height * $percent; -// chargement +// Chargement $thumb = imagecreatetruecolor($newwidth, $newheight); $source = imagecreatefromjpeg($filename); @@ -85,23 +165,42 @@ imagejpeg($thumb); ?> ]]> - </programlisting> - <para> - L'image affiché aura une taille de moitié moins que l'image d'origine, mais une - meilleur qualité peut être obtenue en utilisant la fonction - <function>imagecopyresampled</function>. - </para> - </example> - </para> - </refsect1> - - <refsect1> - &reftitle.seealso; + </programlisting> + &example.outputs.similar; + <screenshot> + <graphic fileref="figures/image.imagecopyresized.jpg" /> + </screenshot> + <para> + L'image affiché aura une taille de moitié moins que l'image d'origine, mais une + meilleur qualité peut être obtenue en utilisant la fonction + <function>imagecopyresampled</function>. + </para> + </example> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <note> <para> - <function>imagecopyresampled</function>. + Il y a un problème dû aux limitations de la taille de la palette + (255 + 1 couleurs différentes). Filtrer ou rééchantillonner une image + demande plus de 255 couleurs, une approximation est alors utilisée pour + calculer le nouveau nombre de couleurs. Avec une palette, si une nouvelle + couleur ne peut être allouée, la couleur la plus proche (en théorie) + est utilisée ; ce n'est pas toujours celle qui est la plus proche visuellement. + Cela peut générer des problèmes étranges, comme des images blanches. + Pour éviter ce problème, passez en image TrueColor, comme celles + générée par la fonction <function>imagecreatetruecolor</function>. </para> - </refsect1> - </refentry> + </note> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <function>imagecopyresampled</function> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -122,4 +221,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecopy.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecopy.xml diff -u phpdoc-fr/reference/image/functions/imagecopy.xml:1.10 phpdoc-fr/reference/image/functions/imagecopy.xml:1.11 --- phpdoc-fr/reference/image/functions/imagecopy.xml:1.10 Sat Jun 25 09:33:27 2005 +++ phpdoc-fr/reference/image/functions/imagecopy.xml Sun Jan 28 09:01:28 2007 @@ -1,37 +1,113 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imagecopy"> - <refnamediv> - <refname>imagecopy</refname> - <refpurpose> - Copie une partie d'une image - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>imagecopy</methodname> - <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam> - <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_x</parameter></methodparam> - <methodparam><type>int</type><parameter>src_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_w</parameter></methodparam> - <methodparam><type>int</type><parameter>src_h</parameter></methodparam> - </methodsynopsis> - <para> - Copie une partie de l'image <parameter>src_im</parameter> sur l'image de - destination <parameter>dst_im</parameter>, en commençant aux coordonnées - <parameter>src_x</parameter>, <parameter>src_y</parameter> et sur la largeur - de <parameter>src_w</parameter> et la hauteur de <parameter>src_h</parameter>. - La portion ainsi définie sera copiée et placée aux - coordonnées <parameter>dst_x</parameter> et <parameter>dst_y</parameter>. - </para> - </refsect1> - </refentry> + +<refentry id="function.imagecopy"> + <refnamediv> + <refname>imagecopy</refname> + <refpurpose>Copie une partie d'une image</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>imagecopy</methodname> + <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam> + <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_x</parameter></methodparam> + <methodparam><type>int</type><parameter>src_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_w</parameter></methodparam> + <methodparam><type>int</type><parameter>src_h</parameter></methodparam> + </methodsynopsis> + <para> + Copie une partie de l'image <parameter>src_im</parameter> sur l'image de + destination <parameter>dst_im</parameter>, en commençant aux coordonnées + <parameter>src_x</parameter>, <parameter>src_y</parameter> et sur la largeur + de <parameter>src_w</parameter> et la hauteur de <parameter>src_h</parameter>. + La portion ainsi définie sera copiée et placée aux coordonnées <parameter>dst_x</parameter> + et <parameter>dst_y</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dst_im</parameter></term> + <listitem> + <para> + Lien vers la ressource de l'image de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_im</parameter></term> + <listitem> + <para> + Lien vers la ressource de l'image source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_x</parameter></term> + <listitem> + <para> + X : coordonnées du point de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_y</parameter></term> + <listitem> + <para> + Y : coordonnées du point de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_x</parameter></term> + <listitem> + <para> + X : coordonnées du point source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_y</parameter></term> + <listitem> + <para> + Y : coordonnées du point source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_w</parameter></term> + <listitem> + <para> + Largeur de la source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_h</parameter></term> + <listitem> + <para> + Hauteur de la source + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -52,4 +128,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecreatefromgd2part.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecreatefromgd2part.xml diff -u phpdoc-fr/reference/image/functions/imagecreatefromgd2part.xml:1.10 phpdoc-fr/reference/image/functions/imagecreatefromgd2part.xml:1.11 --- phpdoc-fr/reference/image/functions/imagecreatefromgd2part.xml:1.10 Sat May 28 08:40:59 2005 +++ phpdoc-fr/reference/image/functions/imagecreatefromgd2part.xml Sun Jan 28 09:01:28 2007 @@ -1,30 +1,74 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imagecreatefromgd2part"> - <refnamediv> - <refname>imagecreatefromgd2part</refname> - <refpurpose>Crée une nouvelle image à partir d'une partie de fichier GD2 ou d'une URL</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>imagecreatefromgd2part</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>int</type><parameter>srcX</parameter></methodparam> - <methodparam><type>int</type><parameter>srcY</parameter></methodparam> - <methodparam><type>int</type><parameter>width</parameter></methodparam> - <methodparam><type>int</type><parameter>height</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - ¬e.gd.2; - &tip.fopen-wrapper; - &warn.no-win32-fopen-wrapper; - </refsect1> - </refentry> + +<refentry id='function.imagecreatefromgd2part'> + <refnamediv> + <refname>imagecreatefromgd2part</refname> + <refpurpose>Crée une nouvelle image à partir d'une partie de fichier GD2 ou d'une URL</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>imagecreatefromgd2part</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam><type>int</type><parameter>srcX</parameter></methodparam> + <methodparam><type>int</type><parameter>srcY</parameter></methodparam> + <methodparam><type>int</type><parameter>width</parameter></methodparam> + <methodparam><type>int</type><parameter>height</parameter></methodparam> + </methodsynopsis> + &warn.undocumented.func; + &tip.fopen-wrapper; + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>srcX</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>srcY</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>width</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>height</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + ¬e.gd.2; + &warn.no-win32-fopen-wrapper; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -45,4 +89,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecreatefromgd2.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecreatefromgd2.xml diff -u phpdoc-fr/reference/image/functions/imagecreatefromgd2.xml:1.8 phpdoc-fr/reference/image/functions/imagecreatefromgd2.xml:1.9 --- phpdoc-fr/reference/image/functions/imagecreatefromgd2.xml:1.8 Sat May 28 08:40:59 2005 +++ phpdoc-fr/reference/image/functions/imagecreatefromgd2.xml Sun Jan 28 09:01:28 2007 @@ -1,26 +1,42 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imagecreatefromgd2"> - <refnamediv> - <refname>imagecreatefromgd2</refname> - <refpurpose>Crée une nouvelle image à partir d'un fichier GD2 ou d'une URL</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>imagecreatefromgd2</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - ¬e.gd.2; - &tip.fopen-wrapper; - &warn.no-win32-fopen-wrapper; - </refsect1> - </refentry> + +<refentry id='function.imagecreatefromgd2'> + <refnamediv> + <refname>imagecreatefromgd2</refname> + <refpurpose>Crée une nouvelle image à partir d'un fichier GD2 ou d'une URL</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>imagecreatefromgd2</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + &warn.undocumented.func; + &tip.fopen-wrapper; + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + ¬e.gd.2; + &warn.no-win32-fopen-wrapper; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecreatefromgd.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecreatefromgd.xml diff -u phpdoc-fr/reference/image/functions/imagecreatefromgd.xml:1.7 phpdoc-fr/reference/image/functions/imagecreatefromgd.xml:1.8 --- phpdoc-fr/reference/image/functions/imagecreatefromgd.xml:1.7 Tue Nov 16 21:46:38 2004 +++ phpdoc-fr/reference/image/functions/imagecreatefromgd.xml Sun Jan 28 09:01:28 2007 @@ -1,25 +1,43 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imagecreatefromgd"> - <refnamediv> - <refname>imagecreatefromgd</refname> - <refpurpose>Crée une nouvelle image à partir d'un fichier GD ou d'une URL</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>imagecreatefromgd</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - &tip.fopen-wrapper; - &warn.no-win32-fopen-wrapper; - </refsect1> - </refentry> + +<refentry id='function.imagecreatefromgd'> + <refnamediv> + <refname>imagecreatefromgd</refname> + <refpurpose>Crée une nouvelle image à partir d'un fichier GD ou d'une URL</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>imagecreatefromgd</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + &warn.undocumented.func; + </para> + &tip.fopen-wrapper; + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + &warn.no-win32-fopen-wrapper; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -40,4 +58,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecreate.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecreate.xml diff -u phpdoc-fr/reference/image/functions/imagecreate.xml:1.14 phpdoc-fr/reference/image/functions/imagecreate.xml:1.15 --- phpdoc-fr/reference/image/functions/imagecreate.xml:1.14 Tue Nov 16 21:46:38 2004 +++ phpdoc-fr/reference/image/functions/imagecreate.xml Sun Jan 28 09:01:28 2007 @@ -1,56 +1,97 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imagecreate"> - <refnamediv> - <refname>imagecreate</refname> - <refpurpose>Crée une nouvelle image à palette</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>imagecreate</methodname> - <methodparam><type>int</type><parameter>x_size</parameter></methodparam> - <methodparam><type>int</type><parameter>y_size</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagecreate</function> retourne un identifiant d'image - représentant une image vide, de largeur <parameter>x_size</parameter> - et longueur <parameter>y_size</parameter>. - </para> - <para> - Nous recommandons l'utilisation de <function>imagecreatetruecolor</function> - à la place de <function>imagecreate</function>. - </para> - <para> - <example> - <title> - Création d'une image GD et affichage de cette image - </title> - <programlisting role="php"> + +<refentry id="function.imagecreate"> + <refnamediv> + <refname>imagecreate</refname> + <refpurpose>Crée une nouvelle image à palette</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>imagecreate</methodname> + <methodparam><type>int</type><parameter>width</parameter></methodparam> + <methodparam><type>int</type><parameter>height</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecreate</function> retourne un identifiant d'image + représentant une image vide. + </para> + <para> + Nous recommandons l'utilisation de <function>imagecreatetruecolor</function> + à la place de <function>imagecreate</function>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>width</parameter></term> + <listitem> + <para> + La largeur de l'image + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>height</parameter></term> + <listitem> + <para> + La hauteur de l'image + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un identifiant de ressource d'image en cas de succès, + &false; si une erreur survient. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title> + Création d'une image GD et affichage de cette image + </title> + <programlisting role="php"> <![CDATA[ <?php -header ("Content-type: image/png"); -$im = @imagecreate (100, 50) - or die ("Impossible d'initialiser la bibliothèque GD"); -$background_color = imagecolorallocate ($im, 255, 255, 255); -$text_color = imagecolorallocate ($im, 233, 14, 91); -imagestring ($im, 1, 5, 5, "A Simple Text String", $text_color); -imagepng ($im); +header("Content-type: image/png"); +$im = @imagecreate(110, 20) + or die("Impossible d'initialiser la bibliothèque GD"); +$background_color = imagecolorallocate($im, 0, 0, 0); +$text_color = imagecolorallocate($im, 233, 14, 91); +imagestring($im, 1, 5, 5, "A Simple Text String", $text_color); +imagepng($im); imagedestroy($im); ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>imagedestroy</function> et - <function>imagecreatetruecolor</function>. - </para> - </refsect1> - </refentry> + </programlisting> + &example.outputs.similar; + <screenshot> + <graphic fileref="figures/image.imagecreate.png" /> + </screenshot> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imagedestroy</function></member> + <member><function>imagecreatetruecolor</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -71,4 +112,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/image-type-to-extension.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/image/functions/image-type-to-extension.xml diff -u phpdoc-fr/reference/image/functions/image-type-to-extension.xml:1.3 phpdoc-fr/reference/image/functions/image-type-to-extension.xml:1.4 --- phpdoc-fr/reference/image/functions/image-type-to-extension.xml:1.3 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/image/functions/image-type-to-extension.xml Sun Jan 28 09:01:28 2007 @@ -1,24 +1,53 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.1 Maintainer: didou Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> + <refentry id="function.image-type-to-extension"> <refnamediv> <refname>image_type_to_extension</refname> - <refpurpose> - Retourne l'extension du fichier pour le type d'image - </refpurpose> + <refpurpose>Retourne l'extension du fichier pour le type d'image</refpurpose> </refnamediv> - <refsect1> + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>image_type_to_extension</methodname> <methodparam><type>int</type><parameter>imagetype</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>include_dot</parameter></methodparam> </methodsynopsis> - - &warn.undocumented.func; -<!-- returned by getimagesize, exif_read_data, exif_thumbnail, exif_imagetype --> + <para> + Retourne l'extension pour la constante <literal>IMAGETYPE_XXX</literal> + fournie. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>imagetype</parameter></term> + <listitem> + <para> + Une des constantes <literal>IMAGETYPE_XXX</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>include_dot</parameter></term> + <listitem> + <para> + Si l'on doit ajouter un point à l'extension ou non. Par défaut, vaut &true;. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Une &string; avec l'extension, correspondant au type de l'image fournie. + </para> </refsect1> </refentry> @@ -41,4 +70,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/image-type-to-mime-type.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/image/functions/image-type-to-mime-type.xml diff -u phpdoc-fr/reference/image/functions/image-type-to-mime-type.xml:1.12 phpdoc-fr/reference/image/functions/image-type-to-mime-type.xml:1.13 --- phpdoc-fr/reference/image/functions/image-type-to-mime-type.xml:1.12 Tue Jul 5 20:39:56 2005 +++ phpdoc-fr/reference/image/functions/image-type-to-mime-type.xml Sun Jan 28 09:01:28 2007 @@ -1,135 +1,159 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.image-type-to-mime-type"> - <refnamediv> - <refname>image_type_to_mime_type</refname> - <refpurpose>Lit le Mime-Type d'un type d'image</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>image_type_to_mime_type</methodname> - <methodparam><type>int</type><parameter>imagetype</parameter></methodparam> - </methodsynopsis> - <para> - <function>image_type_to_mime_type</function> détermine le type - Mime (Mime-Type), à utiliser dans l'en-tête HTTP <literal>Content-type</literal>. - <parameter>imagetype</parameter> est une constante, représentant un - type d'image et retournée par - <function>getimagesize</function>, - <function>exif_read_data</function>, <function>exif_thumbnail</function> ou - <function>exif_imagetype</function>. - <example> - <title>image_type_to_mime_type (fichier)</title> - <programlisting role="php"> + +<refentry id="function.image-type-to-mime-type"> + <refnamediv> + <refname>image_type_to_mime_type</refname> + <refpurpose>Lit le Mime-Type d'un type d'image</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>image_type_to_mime_type</methodname> + <methodparam><type>int</type><parameter>imagetype</parameter></methodparam> + </methodsynopsis> + <para> + Détermine le type Mime (Mime-Type), à utiliser dans l'en-tête + HTTP <literal>Content-type</literal>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>imagetype</parameter></term> + <listitem> + <para> + Une des constantes <literal>IMAGETYPE_XXX</literal> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Les valeurs retournées sont les suivantes + <table> + <title>Valeurs des constantes retournées</title> + <tgroup cols="2"> + <thead> + <row> + <entry><parameter>imagetype</parameter></entry> + <entry>Valeur retournée</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>IMAGETYPE_GIF</constant></entry> + <entry><literal>image/gif</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_JPEG</constant></entry> + <entry><literal>image/jpeg</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_PNG</constant></entry> + <entry><literal>image/png</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_SWF</constant></entry> + <entry><literal>application/x-shockwave-flash</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_PSD</constant></entry> + <entry><literal>image/psd</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_BMP</constant></entry> + <entry><literal>image/bmp</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_TIFF_II</constant> (ordre intel)</entry> + <entry><literal>image/tiff</literal></entry> + </row> + <row> + <entry> + <constant>IMAGETYPE_TIFF_MM</constant> (ordre motorola) + </entry> + <entry><literal>image/tiff</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_JPC</constant></entry> + <entry><literal>application/octet-stream</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_JP2</constant></entry> + <entry><literal>image/jp2</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_JPX</constant></entry> + <entry><literal>application/octet-stream</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_JB2</constant></entry> + <entry><literal>application/octet-stream</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_SWC</constant></entry> + <entry><literal>application/x-shockwave-flash</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_IFF</constant></entry> + <entry><literal>image/iff</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_WBMP</constant></entry> + <entry><literal>image/vnd.wap.wbmp</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_XBM</constant></entry> + <entry><literal>image/xbm</literal></entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>image_type_to_mime_type (fichier)</title> + <programlisting role="php"> <![CDATA[ <?php header("Content-type: " . image_type_to_mime_type(IMAGETYPE_PNG)); ?> ]]> - </programlisting> - </example> - </para> - <para> - Les valeurs de retour sont les suivantes : - <table> - <title>Valeur de constante retournée</title> - <tgroup cols="2"> - <thead> - <row> - <entry><parameter>imagetype</parameter></entry> - <entry>Valeur retournée</entry> - </row> - </thead> - <tbody> - <row> - <entry><constant>IMAGETYPE_GIF</constant></entry> - <entry><literal>image/gif</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_JPEG</constant></entry> - <entry><literal>image/jpeg</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_PNG</constant></entry> - <entry><literal>image/png</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_SWF</constant></entry> - <entry><literal>application/x-shockwave-flash</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_PSD</constant></entry> - <entry><literal>image/psd</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_BMP</constant></entry> - <entry><literal>image/bmp</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_TIFF_II</constant> (ordre intel)</entry> - <entry><literal>image/tiff</literal></entry> - </row> - <row> - <entry> - <constant>IMAGETYPE_TIFF_MM</constant> (ordre motorola) - </entry> - <entry><literal>image/tiff</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_JPC</constant></entry> - <entry><literal>application/octet-stream</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_JP2</constant></entry> - <entry><literal>image/jp2</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_JPX</constant></entry> - <entry><literal>application/octet-stream</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_JB2</constant></entry> - <entry><literal>application/octet-stream</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_SWC</constant></entry> - <entry><literal>application/x-shockwave-flash</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_IFF</constant></entry> - <entry><literal>image/iff</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_WBMP</constant></entry> - <entry><literal>image/vnd.wap.wbmp</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_XBM</constant></entry> - <entry><literal>image/xbm</literal></entry> - </row> - </tbody> - </tgroup> - </table> - </para> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <note> <para> - <note> - <simpara> - Cette fonction ne requiert par la bibliothèque GD. - </simpara> - <para> - Voir aussi - <function>getimagesize</function>, - <function>exif_imagetype</function>, - <function>exif_read_data</function> et - <function>exif_thumbnail</function>. - </para> - </note> + Cette fonction ne requiert par la bibliothèque GD. </para> - </refsect1> - </refentry> + </note> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>getimagesize</function></member> + <member><function>exif_imagetype</function></member> + <member><function>exif_read_data</function></member> + <member><function>exif_thumbnail</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -150,4 +174,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagearc.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/reference/image/functions/imagearc.xml diff -u phpdoc-fr/reference/image/functions/imagearc.xml:1.16 phpdoc-fr/reference/image/functions/imagearc.xml:1.17 --- phpdoc-fr/reference/image/functions/imagearc.xml:1.16 Sun Jan 14 13:37:18 2007 +++ phpdoc-fr/reference/image/functions/imagearc.xml Sun Jan 28 09:01:28 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry id="function.imagearc"> @@ -113,10 +113,17 @@ // Allocation de couleurs $white = imagecolorallocate($img, 255, 255, 255); -$black = imagecolorallocate($img, 0, 0, 0); - -// Dessine d'un cercle noir -imagearc($img, 100, 100, 150, 150, 0, 360, $black); +$red = imagecolorallocate($img, 255, 0, 0); +$green = imagecolorallocate($img, 0, 255, 0); +$blue = imagecolorallocate($img, 0, 0, 255); + +// Dessine la tête +imagearc($img, 100, 100, 200, 200, 0, 360, $white); +// La bouche +imagearc($img, 100, 100, 150, 150, 25, 155, $red); +// les yeux gauche et droit +imagearc($img, 60, 75, 50, 50, 0, 360, $green); +imagearc($img, 140, 75, 50, 50, 0, 360, $blue); // Affichage au navigateur header("Content-type: image/png"); @@ -128,6 +135,10 @@ ?> ]]> </programlisting> + &example.outputs.similar; + <screenshot> + <graphic fileref="figures/image.imagearc.png" /> + </screenshot> </example> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecharup.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecharup.xml diff -u phpdoc-fr/reference/image/functions/imagecharup.xml:1.14 phpdoc-fr/reference/image/functions/imagecharup.xml:1.15 --- phpdoc-fr/reference/image/functions/imagecharup.xml:1.14 Sun Jan 14 13:37:18 2007 +++ phpdoc-fr/reference/image/functions/imagecharup.xml Sun Jan 28 09:01:28 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.11 Maintainer: didou Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry id="function.imagecharup"> @@ -97,6 +97,10 @@ ?> ]]> </programlisting> + &example.outputs.similar; + <screenshot> + <graphic fileref="figures/image.imagecharup.png" /> + </screenshot> </example> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagechar.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/image/functions/imagechar.xml diff -u phpdoc-fr/reference/image/functions/imagechar.xml:1.14 phpdoc-fr/reference/image/functions/imagechar.xml:1.15 --- phpdoc-fr/reference/image/functions/imagechar.xml:1.14 Sun Jan 14 16:05:58 2007 +++ phpdoc-fr/reference/image/functions/imagechar.xml Sun Jan 28 09:01:28 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.12 Maintainer: didou Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry id="function.imagechar"> @@ -100,6 +100,10 @@ ?> ]]> </programlisting> + &example.outputs.similar; + <screenshot> + <graphic fileref="figures/image.imagechar.png" /> + </screenshot> </example> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecolorallocatealpha.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecolorallocatealpha.xml diff -u phpdoc-fr/reference/image/functions/imagecolorallocatealpha.xml:1.12 phpdoc-fr/reference/image/functions/imagecolorallocatealpha.xml:1.13 --- phpdoc-fr/reference/image/functions/imagecolorallocatealpha.xml:1.12 Sun Jan 14 16:05:58 2007 +++ phpdoc-fr/reference/image/functions/imagecolorallocatealpha.xml Sun Jan 28 09:01:28 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry id="function.imagecolorallocatealpha"> @@ -74,6 +74,29 @@ Un identifiant de couleur ou &false; si l'allocation échoue. </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Avant la version 5.1.3</entry> + <entry> + Retourne -1 si l'allocation échoue. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> @@ -118,6 +141,10 @@ ?> ]]> </programlisting> + &example.outputs.similar; + <screenshot> + <graphic fileref="figures/image.imagecolorallocatealpha.png" /> + </screenshot> </example> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecolorallocate.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecolorallocate.xml diff -u phpdoc-fr/reference/image/functions/imagecolorallocate.xml:1.18 phpdoc-fr/reference/image/functions/imagecolorallocate.xml:1.19 --- phpdoc-fr/reference/image/functions/imagecolorallocate.xml:1.18 Sun Jan 14 16:05:58 2007 +++ phpdoc-fr/reference/image/functions/imagecolorallocate.xml Sun Jan 28 09:01:28 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry id="function.imagecolorallocate"> @@ -70,7 +70,30 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Un identifiant de couleur ou -1 si l'allocation échoue. + Un identifiant de couleur ou &false; si l'allocation échoue. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Avant la version 5.1.3</entry> + <entry> + Retourne -1 si l'allocation échoue. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </para> </refsect1> <refsect1 role="examples"> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecolorat.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecolorat.xml diff -u phpdoc-fr/reference/image/functions/imagecolorat.xml:1.13 phpdoc-fr/reference/image/functions/imagecolorat.xml:1.14 --- phpdoc-fr/reference/image/functions/imagecolorat.xml:1.13 Sun Jan 14 20:41:53 2007 +++ phpdoc-fr/reference/image/functions/imagecolorat.xml Sun Jan 28 09:01:28 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry id="function.imagecolorat"> @@ -65,14 +65,22 @@ <programlisting role="php"> <![CDATA[ <?php -$im = ImageCreateFromPng("rockym.png"); -$rgb = ImageColorAt($im, 100, 100); +$im = imagecreatefrompng("php.png"); +$rgb = imagecolorat($im, 10, 15); $r = ($rgb >> 16) & 0xFF; $g = ($rgb >> 8) & 0xFF; $b = $rgb & 0xFF; ?> ]]> </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +int(119) +int(123) +int(180) +]]> + </screen> </example> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imageconvolution.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/image/functions/imageconvolution.xml diff -u phpdoc-fr/reference/image/functions/imageconvolution.xml:1.3 phpdoc-fr/reference/image/functions/imageconvolution.xml:1.4 --- phpdoc-fr/reference/image/functions/imageconvolution.xml:1.3 Sun Jan 14 20:41:53 2007 +++ phpdoc-fr/reference/image/functions/imageconvolution.xml Sun Jan 28 09:01:28 2007 @@ -1,23 +1,25 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry id="function.imageconvolution"> <refnamediv> <refname>imageconvolution</refname> - <refpurpose>Applique une matrice de la convolution 3x3, en utilisant la division de coefficient et l'excentrage</refpurpose> + <refpurpose>Applique une matrice de la convolution 3x3, en utilisant le coefficient et l'excentrage</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>imageconvolution</methodname> <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam><type>array</type><parameter>matrix3x3</parameter></methodparam> + <methodparam><type>array</type><parameter>matrix</parameter></methodparam> <methodparam><type>float</type><parameter>div</parameter></methodparam> <methodparam><type>float</type><parameter>offset</parameter></methodparam> </methodsynopsis> - &warn.undocumented.func; + <para> + Applique une matrice de la convolution 3x3, en utilisant le coefficient et l'excentrage. + </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; @@ -25,9 +27,10 @@ <variablelist> &gd.image.description; <varlistentry> - <term><parameter>matrix3x3</parameter></term> + <term><parameter>matrix</parameter></term> <listitem> <para> + Une matrice 3x3 : un tableau contenant trois tableaux de trois nombres à virgules flottantes. </para> </listitem> </varlistentry> @@ -35,6 +38,7 @@ <term><parameter>div</parameter></term> <listitem> <para> + Le diviseur du résultat de la convolution, utilisé pour la normalisation. </para> </listitem> </varlistentry> @@ -54,10 +58,68 @@ &return.success; </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Impression du logo PHP.net</title> + <programlisting role="php"> +<![CDATA[ +<?php +$image = imagecreatefromgif('http://www.php.net/images/php.gif'); + +$emboss = array(array(2, 0, 0), array(0, -1, 0), array(0, 0, -1)); +imageconvolution($image, $emboss, 1, 127); + +header('Content-Type: image/png'); +imagepng($image, null, 9); +?> +]]> + </programlisting> + &example.outputs; + <screenshot> + <graphic fileref="figures/image.imageconvolution_emboss.png" /> + </screenshot> + </example> + <example> + <title>Floue gaussien</title> + <programlisting role="php"> +<![CDATA[ +<?php +$image = imagecreatetruecolor(180,40); + +// Écrit le texte et applique un floue gaussien sur l'image +imagestring($image, 5, 10, 8, 'Texte floue goussien', 0x00ff00); +$gaussian = array(array(1.0, 2.0, 1.0), array(2.0, 4.0, 2.0), array(1.0, 2.0, 1.0)); +imageconvolution($image, $gaussian, 16, 0); + +// Récrit le texte pour la comparaison +imagestring($image, 5, 10, 18, 'Texte floue goussien', 0x00ff00); + +header('Content-Type: image/png'); +imagepng($image, null, 9); +?> +]]> + </programlisting> + &example.outputs; + <screenshot> + <graphic fileref="figures/image.imageconvolution_gaussian.png" /> + </screenshot> + </example> + </para> + </refsect1> <refsect1 role="notes"> &reftitle.notes; ¬e.bundled.gd; </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imagefilter</function></member> + </simplelist> + </para> + </refsect1> </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecopymergegray.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecopymergegray.xml diff -u phpdoc-fr/reference/image/functions/imagecopymergegray.xml:1.11 phpdoc-fr/reference/image/functions/imagecopymergegray.xml:1.12 --- phpdoc-fr/reference/image/functions/imagecopymergegray.xml:1.11 Sat Jun 25 09:33:27 2005 +++ phpdoc-fr/reference/image/functions/imagecopymergegray.xml Sun Jan 28 09:01:28 2007 @@ -1,57 +1,136 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imagecopymergegray"> - <refnamediv> - <refname>imagecopymergegray</refname> - <refpurpose> - Copie et fusionne une partie d'une image en niveaux de gris - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>imagecopymergegray</methodname> - <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam> - <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_x</parameter></methodparam> - <methodparam><type>int</type><parameter>src_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_w</parameter></methodparam> - <methodparam><type>int</type><parameter>src_h</parameter></methodparam> - <methodparam><type>int</type><parameter>pct</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagecopymergegray</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>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 - copiée aux coordonnées (<parameter>dst_x</parameter>, <parameter>dst_y</parameter>), - dans l'image de destination. Les deux images seront fusionnées - suivant le paramètre <parameter>pct</parameter>, qui peut valoir de - 0 à 100. Si <parameter>pct</parameter> = 0, aucune action n'est - faite, alors que si <parameter>pct</parameter> = 100, - <function>imagecopymerge</function> se comporte exactement comme - <function>imagecopy</function>. - </para> - <para> - <function>imagecopymergegray</function> est identique à la fonction - <function>imagecopymerge</function>, hormis le fait que lors de la - fusion, le "hue" de l'image sera conservé grâce à la conversion - de la zone dans l'image de destination en gris, avant l'opération - de copie. - </para> - <note> - <para> - <function>imagecopymergegray</function> a été ajoutée en &php; 4.0.6. - </para> - </note> - </refsect1> - </refentry> + +<refentry id="function.imagecopymergegray"> + <refnamediv> + <refname>imagecopymergegray</refname> + <refpurpose>Copie et fusionne une partie d'une image en niveaux de gris</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>imagecopymergegray</methodname> + <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam> + <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_x</parameter></methodparam> + <methodparam><type>int</type><parameter>src_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_w</parameter></methodparam> + <methodparam><type>int</type><parameter>src_h</parameter></methodparam> + <methodparam><type>int</type><parameter>pct</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecopymergegray</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>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 + copiée aux coordonnées (<parameter>dst_x</parameter>, <parameter>dst_y</parameter>), + dans l'image de destination. + </para> + <para> + <function>imagecopymergegray</function> est identique à la fonction + <function>imagecopymerge</function>, hormis le fait que lors de la + fusion, le "hue" de l'image sera conservé grâce à la conversion + de la zone dans l'image de destination en gris, avant l'opération + de copie. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dst_im</parameter></term> + <listitem> + <para> + Ressource de l'image de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_im</parameter></term> + <listitem> + <para> + Ressource de l'image source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_x</parameter></term> + <listitem> + <para> + X : coordonnée du point de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_y</parameter></term> + <listitem> + <para> + Y : coordonnée du point de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_x</parameter></term> + <listitem> + <para> + X : coordonnée du point source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_y</parameter></term> + <listitem> + <para> + Y : coordonnée du point source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_w</parameter></term> + <listitem> + <para> + Largeur de la source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_h</parameter></term> + <listitem> + <para> + Hauteur de la source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>pct</parameter></term> + <listitem> + <para> + Les deux images seront fusionnées + suivant le paramètre <parameter>pct</parameter>, qui peut valoir de + 0 à 100. Si <parameter>pct</parameter> = 0, aucune action n'est + faite, alors que si <parameter>pct</parameter> = 100, + <function>imagecopymerge</function> se comporte exactement comme + <function>imagecopy</function>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -72,4 +151,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecopymerge.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecopymerge.xml diff -u phpdoc-fr/reference/image/functions/imagecopymerge.xml:1.12 phpdoc-fr/reference/image/functions/imagecopymerge.xml:1.13 --- phpdoc-fr/reference/image/functions/imagecopymerge.xml:1.12 Sat Jun 25 09:33:27 2005 +++ phpdoc-fr/reference/image/functions/imagecopymerge.xml Sun Jan 28 09:01:28 2007 @@ -1,51 +1,130 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imagecopymerge"> - <refnamediv> - <refname>imagecopymerge</refname> - <refpurpose> - Copie et fusionne une partie d'une image - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>imagecopymerge</methodname> - <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam> - <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_x</parameter></methodparam> - <methodparam><type>int</type><parameter>src_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_w</parameter></methodparam> - <methodparam><type>int</type><parameter>src_h</parameter></methodparam> - <methodparam><type>int</type><parameter>pct</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagecopymerge</function> copie une partie de - l'image <parameter>src_im</parameter> dans l'image de destination - <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 - copiée aux coordonnées (<parameter>dst_x</parameter>, <parameter>dst_y</parameter>), - dans l'image de destination. Les deux images seront fusionnées - suivant le paramètre <parameter>pct</parameter>, qui peut valoir de - 0 à 100. Si <parameter>pct</parameter> = 0, aucune action n'est - faite, alors que si <parameter>pct</parameter> = 100, - <function>imagecopymerge</function> se comporte exactement comme - <function>imagecopy</function> pour les images de palette, - tandis qu'il implémente la transparence alpha pour les images en couleur vraies. - </para> - <note> - <para> - <function>imagecopymerge</function> a été ajoutée en &php; 4.0.6. - </para> - </note> - </refsect1> - </refentry> + +<refentry id="function.imagecopymerge"> + <refnamediv> + <refname>imagecopymerge</refname> + <refpurpose>Copie et fusionne une partie d'une image</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>imagecopymerge</methodname> + <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam> + <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_x</parameter></methodparam> + <methodparam><type>int</type><parameter>src_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_w</parameter></methodparam> + <methodparam><type>int</type><parameter>src_h</parameter></methodparam> + <methodparam><type>int</type><parameter>pct</parameter></methodparam> + </methodsynopsis> + <para> + Copie une partie de l'image <parameter>src_im</parameter> + dans l'image de destination <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 copiée aux coordonnées + (<parameter>dst_x</parameter>, <parameter>dst_y</parameter>), + dans l'image de destination. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dst_im</parameter></term> + <listitem> + <para> + Ressource de l'image de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_im</parameter></term> + <listitem> + <para> + Ressource de l'image source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_x</parameter></term> + <listitem> + <para> + X : coordonnée du point de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_y</parameter></term> + <listitem> + <para> + Y : coordonnée du point de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_x</parameter></term> + <listitem> + <para> + X : coordonnée du point source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_y</parameter></term> + <listitem> + <para> + Y : coordonnée du point source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_w</parameter></term> + <listitem> + <para> + Largeur de la source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_h</parameter></term> + <listitem> + <para> + Hauteur de la source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>pct</parameter></term> + <listitem> + <para> + Les deux images seront fusionnées + suivant le paramètre <parameter>pct</parameter>, qui peut valoir de + 0 à 100. Si <parameter>pct</parameter> = 0, aucune action n'est + faite, alors que si <parameter>pct</parameter> = 100, + <function>imagecopymerge</function> se comporte exactement comme + <function>imagecopy</function> pour les images de palette, + tandis qu'il implémente la transparence alpha pour les images en couleur vraies. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -66,4 +145,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecopyresampled.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecopyresampled.xml diff -u phpdoc-fr/reference/image/functions/imagecopyresampled.xml:1.18 phpdoc-fr/reference/image/functions/imagecopyresampled.xml:1.19 --- phpdoc-fr/reference/image/functions/imagecopyresampled.xml:1.18 Sat Aug 5 19:59:29 2006 +++ phpdoc-fr/reference/image/functions/imagecopyresampled.xml Sun Jan 28 09:01:28 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry id="function.imagecopyresampled"> @@ -8,7 +8,7 @@ <refname>imagecopyresampled</refname> <refpurpose>Copie, redimensionne, rééchantillonne une image</refpurpose> </refnamediv> - <refsect1> + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>imagecopyresampled</methodname> @@ -29,37 +29,111 @@ l'image <parameter>dst_im</parameter>. Durant la copie, la zone est rééchantillonnée de manière à conserver la clarté de l'image durant une réduction. - &return.success; </para> <para> - <parameter>dst_im</parameter> est l'image de destination, - <parameter>src_im</parameter> est l'image source. Si les hauteurs et largeurs des source et destination - diffèrent, l'image copiée sera étirée - de manière appropriée. + 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, (si <parameter>dst_image</parameter> est la même que <parameter>src_image</parameter>) mais si les régions se chevauchent, les résultats sont imprévisibles. </para> - <note> - <para> - Il y a un problème dû aux limitations de la taille de la palette - (255 + 1 couleurs différentes). Filtrer ou rééchantillonner une image - demande plus de 255 couleurs, une approximation est alors utilisée pour - calculer le nouveau nombre de couleurs. Avec une palette, si une nouvelle - couleur ne peut être allouée, la couleur la plus proche (en théorie) - est utilisée. Ce n'est pas toujours la couleur la plus proche visuellement. - Cela peut générer des problèmes étranges, comme des images blanches. - Pour éviter ce problème, passez en image TrueColor, comme celles - générée par la fonction <function>imagecreatetruecolor</function>. - </para> - </note> - ¬e.gd.2; </refsect1> - - <refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dst_im</parameter></term> + <listitem> + <para> + Lien vers la ressource de l'image de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_im</parameter></term> + <listitem> + <para> + Lien vers la ressource de l'image source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_x</parameter></term> + <listitem> + <para> + X : coordonnées du point de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_y</parameter></term> + <listitem> + <para> + Y : coordonnées du point de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_x</parameter></term> + <listitem> + <para> + X : coordonnées du point source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_y</parameter></term> + <listitem> + <para> + Y : coordonnées du point source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_w</parameter></term> + <listitem> + <para> + Largueur de la destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_h</parameter></term> + <listitem> + <para> + Hauteur de la destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_w</parameter></term> + <listitem> + <para> + Largeur de la source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_h</parameter></term> + <listitem> + <para> + Hauteur de la source + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> <example> @@ -92,9 +166,12 @@ ?> ]]> </programlisting> + &example.outputs.similar; + <screenshot> + <graphic fileref="figures/image.imagecopyresampled.jpg" /> + </screenshot> </example> </para> - <para> <example> <title>Redimensionnement proportionnel d'une image</title> @@ -121,9 +198,9 @@ $ratio_orig = $width_orig/$height_orig; if ($width/$height > $ratio_orig) { - $width = $height*$ratio_orig; + $width = $height*$ratio_orig; } else { - $height = $width/$ratio_orig; + $height = $width/$ratio_orig; } // Redimensionnement @@ -136,14 +213,33 @@ ?> ]]> </programlisting> + &example.outputs.similar; + <screenshot> + <graphic fileref="figures/image.imagecopyresampled_2.jpg" /> + </screenshot> </example> </para> </refsect1> - - <refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Il y a un problème dû aux limitations de la taille de la palette + (255 + 1 couleurs différentes). Filtrer ou rééchantillonner une image + demande plus de 255 couleurs, une approximation est alors utilisée pour + calculer le nouveau nombre de couleurs. Avec une palette, si une nouvelle + couleur ne peut être allouée, la couleur la plus proche (en théorie) + est utilisée. Ce n'est pas toujours la couleur la plus proche visuellement. + Cela peut générer des problèmes étranges, comme des images blanches. + Pour éviter ce problème, passez en image TrueColor, comme celles + générée par la fonction <function>imagecreatetruecolor</function>. + </para> + </note> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> - <function>imagecopyresized</function>. + <function>imagecopyresized</function> </para> </refsect1> </refentry> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecopyresized.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecopyresized.xml diff -u phpdoc-fr/reference/image/functions/imagecopyresized.xml:1.16 phpdoc-fr/reference/image/functions/imagecopyresized.xml:1.17 --- phpdoc-fr/reference/image/functions/imagecopyresized.xml:1.16 Tue Aug 30 00:02:41 2005 +++ phpdoc-fr/reference/image/functions/imagecopyresized.xml Sun Jan 28 09:01:28 2007 @@ -1,65 +1,145 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imagecopyresized"> - <refnamediv> - <refname>imagecopyresized</refname> - <refpurpose>Copie et redimensionne une partie d'une image</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>imagecopyresized</methodname> - <methodparam><type>resource</type><parameter>dst_image</parameter></methodparam> - <methodparam><type>resource</type><parameter>src_image</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_x</parameter></methodparam> - <methodparam><type>int</type><parameter>src_y</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_w</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_h</parameter></methodparam> - <methodparam><type>int</type><parameter>src_w</parameter></methodparam> - <methodparam><type>int</type><parameter>src_h</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagecopyresized</function> copie une partie rectangulaire d'une image - dans une autre image de destination. <parameter>dst_image</parameter> est l'image - de destination, <parameter>src_image</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 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_image</parameter> et - <parameter>src_image</parameter> sont identiques), mais si les - régions se chevauchent, le résultat risque d'être - incohérent. - </para> - <note> + +<refentry id="function.imagecopyresized"> + <refnamediv> + <refname>imagecopyresized</refname> + <refpurpose>Copie et redimensionne une partie d'une image</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>imagecopyresized</methodname> + <methodparam><type>resource</type><parameter>dst_image</parameter></methodparam> + <methodparam><type>resource</type><parameter>src_image</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_x</parameter></methodparam> + <methodparam><type>int</type><parameter>src_y</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_w</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_h</parameter></methodparam> + <methodparam><type>int</type><parameter>src_w</parameter></methodparam> + <methodparam><type>int</type><parameter>src_h</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecopyresized</function> copie une partie rectangulaire d'une image + dans une autre image de destination. <parameter>dst_image</parameter> est l'image + de destination, <parameter>src_image</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 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_image</parameter> et + <parameter>src_image</parameter> sont identiques), mais si les + régions se chevauchent, le résultat risque d'être + incohérent. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dst_im</parameter></term> + <listitem> + <para> + Lien vers la ressource de l'image de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_im</parameter></term> + <listitem> + <para> + Lien vers la ressource de l'image source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_x</parameter></term> + <listitem> + <para> + X : coordonnée du point de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_y</parameter></term> + <listitem> + <para> + Y : coordonnée du point de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_x</parameter></term> + <listitem> + <para> + X : coordonnée du point source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_y</parameter></term> + <listitem> + <para> + Y : coordonnée du point source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_w</parameter></term> + <listitem> + <para> + Largeur de la destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_h</parameter></term> + <listitem> + <para> + Hauteur de la destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_w</parameter></term> + <listitem> + <para> + Largeur de la source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_h</parameter></term> + <listitem> + <para> + Hauteur de la source + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Redimensionnement d'une image</title> <para> - Il y a un problème dû aux limitations de la taille de la palette - (255 + 1 couleurs différentes). Filtrer ou rééchantillonner une image - demande plus de 255 couleurs, une approximation est alors utilisée pour - calculer le nouveau nombre de couleurs. Avec une palette, si une nouvelle - couleur ne peut être allouée, la couleur la plus proche (en théorie) - est utilisée ; ce n'est pas toujours celle qui est la plus proche visuellement. - Cela peut générer des problèmes étranges, comme des images blanches. - Pour éviter ce problème, passez en image TrueColor, comme celles - générée par la fonction <function>imagecreatetruecolor</function>. + Cet exemple affichera l'image redimensionné à la moitié de sa taille d'origine. </para> - </note> - </refsect1> - - <refsect1> - &reftitle.examples; - <para> - <example> - <title>Redimensionnement d'une image</title> - <para> - Cet exemple affichera l'image redimensionné à la moitié de sa taille d'origine. - </para> - <programlisting role="php"> + <programlisting role="php"> <![CDATA[ <?php // Fichier et nouvelle taille @@ -74,7 +154,7 @@ $newwidth = $width * $percent; $newheight = $height * $percent; -// chargement +// Chargement $thumb = imagecreatetruecolor($newwidth, $newheight); $source = imagecreatefromjpeg($filename); @@ -85,23 +165,42 @@ imagejpeg($thumb); ?> ]]> - </programlisting> - <para> - L'image affiché aura une taille de moitié moins que l'image d'origine, mais une - meilleur qualité peut être obtenue en utilisant la fonction - <function>imagecopyresampled</function>. - </para> - </example> - </para> - </refsect1> - - <refsect1> - &reftitle.seealso; + </programlisting> + &example.outputs.similar; + <screenshot> + <graphic fileref="figures/image.imagecopyresized.jpg" /> + </screenshot> + <para> + L'image affiché aura une taille de moitié moins que l'image d'origine, mais une + meilleur qualité peut être obtenue en utilisant la fonction + <function>imagecopyresampled</function>. + </para> + </example> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <note> <para> - <function>imagecopyresampled</function>. + Il y a un problème dû aux limitations de la taille de la palette + (255 + 1 couleurs différentes). Filtrer ou rééchantillonner une image + demande plus de 255 couleurs, une approximation est alors utilisée pour + calculer le nouveau nombre de couleurs. Avec une palette, si une nouvelle + couleur ne peut être allouée, la couleur la plus proche (en théorie) + est utilisée ; ce n'est pas toujours celle qui est la plus proche visuellement. + Cela peut générer des problèmes étranges, comme des images blanches. + Pour éviter ce problème, passez en image TrueColor, comme celles + générée par la fonction <function>imagecreatetruecolor</function>. </para> - </refsect1> - </refentry> + </note> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <function>imagecopyresampled</function> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -122,4 +221,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecopy.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecopy.xml diff -u phpdoc-fr/reference/image/functions/imagecopy.xml:1.10 phpdoc-fr/reference/image/functions/imagecopy.xml:1.11 --- phpdoc-fr/reference/image/functions/imagecopy.xml:1.10 Sat Jun 25 09:33:27 2005 +++ phpdoc-fr/reference/image/functions/imagecopy.xml Sun Jan 28 09:01:28 2007 @@ -1,37 +1,113 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imagecopy"> - <refnamediv> - <refname>imagecopy</refname> - <refpurpose> - Copie une partie d'une image - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>imagecopy</methodname> - <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam> - <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> - <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_x</parameter></methodparam> - <methodparam><type>int</type><parameter>src_y</parameter></methodparam> - <methodparam><type>int</type><parameter>src_w</parameter></methodparam> - <methodparam><type>int</type><parameter>src_h</parameter></methodparam> - </methodsynopsis> - <para> - Copie une partie de l'image <parameter>src_im</parameter> sur l'image de - destination <parameter>dst_im</parameter>, en commençant aux coordonnées - <parameter>src_x</parameter>, <parameter>src_y</parameter> et sur la largeur - de <parameter>src_w</parameter> et la hauteur de <parameter>src_h</parameter>. - La portion ainsi définie sera copiée et placée aux - coordonnées <parameter>dst_x</parameter> et <parameter>dst_y</parameter>. - </para> - </refsect1> - </refentry> + +<refentry id="function.imagecopy"> + <refnamediv> + <refname>imagecopy</refname> + <refpurpose>Copie une partie d'une image</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>imagecopy</methodname> + <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam> + <methodparam><type>resource</type><parameter>src_im</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_x</parameter></methodparam> + <methodparam><type>int</type><parameter>dst_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_x</parameter></methodparam> + <methodparam><type>int</type><parameter>src_y</parameter></methodparam> + <methodparam><type>int</type><parameter>src_w</parameter></methodparam> + <methodparam><type>int</type><parameter>src_h</parameter></methodparam> + </methodsynopsis> + <para> + Copie une partie de l'image <parameter>src_im</parameter> sur l'image de + destination <parameter>dst_im</parameter>, en commençant aux coordonnées + <parameter>src_x</parameter>, <parameter>src_y</parameter> et sur la largeur + de <parameter>src_w</parameter> et la hauteur de <parameter>src_h</parameter>. + La portion ainsi définie sera copiée et placée aux coordonnées <parameter>dst_x</parameter> + et <parameter>dst_y</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dst_im</parameter></term> + <listitem> + <para> + Lien vers la ressource de l'image de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_im</parameter></term> + <listitem> + <para> + Lien vers la ressource de l'image source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_x</parameter></term> + <listitem> + <para> + X : coordonnées du point de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>dst_y</parameter></term> + <listitem> + <para> + Y : coordonnées du point de destination + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_x</parameter></term> + <listitem> + <para> + X : coordonnées du point source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_y</parameter></term> + <listitem> + <para> + Y : coordonnées du point source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_w</parameter></term> + <listitem> + <para> + Largeur de la source + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>src_h</parameter></term> + <listitem> + <para> + Hauteur de la source + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -52,4 +128,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecreatefromgd2part.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecreatefromgd2part.xml diff -u phpdoc-fr/reference/image/functions/imagecreatefromgd2part.xml:1.10 phpdoc-fr/reference/image/functions/imagecreatefromgd2part.xml:1.11 --- phpdoc-fr/reference/image/functions/imagecreatefromgd2part.xml:1.10 Sat May 28 08:40:59 2005 +++ phpdoc-fr/reference/image/functions/imagecreatefromgd2part.xml Sun Jan 28 09:01:28 2007 @@ -1,30 +1,74 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imagecreatefromgd2part"> - <refnamediv> - <refname>imagecreatefromgd2part</refname> - <refpurpose>Crée une nouvelle image à partir d'une partie de fichier GD2 ou d'une URL</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>imagecreatefromgd2part</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>int</type><parameter>srcX</parameter></methodparam> - <methodparam><type>int</type><parameter>srcY</parameter></methodparam> - <methodparam><type>int</type><parameter>width</parameter></methodparam> - <methodparam><type>int</type><parameter>height</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - ¬e.gd.2; - &tip.fopen-wrapper; - &warn.no-win32-fopen-wrapper; - </refsect1> - </refentry> + +<refentry id='function.imagecreatefromgd2part'> + <refnamediv> + <refname>imagecreatefromgd2part</refname> + <refpurpose>Crée une nouvelle image à partir d'une partie de fichier GD2 ou d'une URL</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>imagecreatefromgd2part</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam><type>int</type><parameter>srcX</parameter></methodparam> + <methodparam><type>int</type><parameter>srcY</parameter></methodparam> + <methodparam><type>int</type><parameter>width</parameter></methodparam> + <methodparam><type>int</type><parameter>height</parameter></methodparam> + </methodsynopsis> + &warn.undocumented.func; + &tip.fopen-wrapper; + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>srcX</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>srcY</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>width</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>height</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + ¬e.gd.2; + &warn.no-win32-fopen-wrapper; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -45,4 +89,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecreatefromgd2.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecreatefromgd2.xml diff -u phpdoc-fr/reference/image/functions/imagecreatefromgd2.xml:1.8 phpdoc-fr/reference/image/functions/imagecreatefromgd2.xml:1.9 --- phpdoc-fr/reference/image/functions/imagecreatefromgd2.xml:1.8 Sat May 28 08:40:59 2005 +++ phpdoc-fr/reference/image/functions/imagecreatefromgd2.xml Sun Jan 28 09:01:28 2007 @@ -1,26 +1,42 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imagecreatefromgd2"> - <refnamediv> - <refname>imagecreatefromgd2</refname> - <refpurpose>Crée une nouvelle image à partir d'un fichier GD2 ou d'une URL</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>imagecreatefromgd2</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - ¬e.gd.2; - &tip.fopen-wrapper; - &warn.no-win32-fopen-wrapper; - </refsect1> - </refentry> + +<refentry id='function.imagecreatefromgd2'> + <refnamediv> + <refname>imagecreatefromgd2</refname> + <refpurpose>Crée une nouvelle image à partir d'un fichier GD2 ou d'une URL</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>imagecreatefromgd2</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + &warn.undocumented.func; + &tip.fopen-wrapper; + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + ¬e.gd.2; + &warn.no-win32-fopen-wrapper; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecreatefromgd.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecreatefromgd.xml diff -u phpdoc-fr/reference/image/functions/imagecreatefromgd.xml:1.7 phpdoc-fr/reference/image/functions/imagecreatefromgd.xml:1.8 --- phpdoc-fr/reference/image/functions/imagecreatefromgd.xml:1.7 Tue Nov 16 21:46:38 2004 +++ phpdoc-fr/reference/image/functions/imagecreatefromgd.xml Sun Jan 28 09:01:28 2007 @@ -1,25 +1,43 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imagecreatefromgd"> - <refnamediv> - <refname>imagecreatefromgd</refname> - <refpurpose>Crée une nouvelle image à partir d'un fichier GD ou d'une URL</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>imagecreatefromgd</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - &tip.fopen-wrapper; - &warn.no-win32-fopen-wrapper; - </refsect1> - </refentry> + +<refentry id='function.imagecreatefromgd'> + <refnamediv> + <refname>imagecreatefromgd</refname> + <refpurpose>Crée une nouvelle image à partir d'un fichier GD ou d'une URL</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>imagecreatefromgd</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + &warn.undocumented.func; + </para> + &tip.fopen-wrapper; + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + &warn.no-win32-fopen-wrapper; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -40,4 +58,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/imagecreate.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/image/functions/imagecreate.xml diff -u phpdoc-fr/reference/image/functions/imagecreate.xml:1.14 phpdoc-fr/reference/image/functions/imagecreate.xml:1.15 --- phpdoc-fr/reference/image/functions/imagecreate.xml:1.14 Tue Nov 16 21:46:38 2004 +++ phpdoc-fr/reference/image/functions/imagecreate.xml Sun Jan 28 09:01:28 2007 @@ -1,56 +1,97 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imagecreate"> - <refnamediv> - <refname>imagecreate</refname> - <refpurpose>Crée une nouvelle image à palette</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>imagecreate</methodname> - <methodparam><type>int</type><parameter>x_size</parameter></methodparam> - <methodparam><type>int</type><parameter>y_size</parameter></methodparam> - </methodsynopsis> - <para> - <function>imagecreate</function> retourne un identifiant d'image - représentant une image vide, de largeur <parameter>x_size</parameter> - et longueur <parameter>y_size</parameter>. - </para> - <para> - Nous recommandons l'utilisation de <function>imagecreatetruecolor</function> - à la place de <function>imagecreate</function>. - </para> - <para> - <example> - <title> - Création d'une image GD et affichage de cette image - </title> - <programlisting role="php"> + +<refentry id="function.imagecreate"> + <refnamediv> + <refname>imagecreate</refname> + <refpurpose>Crée une nouvelle image à palette</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>imagecreate</methodname> + <methodparam><type>int</type><parameter>width</parameter></methodparam> + <methodparam><type>int</type><parameter>height</parameter></methodparam> + </methodsynopsis> + <para> + <function>imagecreate</function> retourne un identifiant d'image + représentant une image vide. + </para> + <para> + Nous recommandons l'utilisation de <function>imagecreatetruecolor</function> + à la place de <function>imagecreate</function>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>width</parameter></term> + <listitem> + <para> + La largeur de l'image + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>height</parameter></term> + <listitem> + <para> + La hauteur de l'image + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un identifiant de ressource d'image en cas de succès, + &false; si une erreur survient. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title> + Création d'une image GD et affichage de cette image + </title> + <programlisting role="php"> <![CDATA[ <?php -header ("Content-type: image/png"); -$im = @imagecreate (100, 50) - or die ("Impossible d'initialiser la bibliothèque GD"); -$background_color = imagecolorallocate ($im, 255, 255, 255); -$text_color = imagecolorallocate ($im, 233, 14, 91); -imagestring ($im, 1, 5, 5, "A Simple Text String", $text_color); -imagepng ($im); +header("Content-type: image/png"); +$im = @imagecreate(110, 20) + or die("Impossible d'initialiser la bibliothèque GD"); +$background_color = imagecolorallocate($im, 0, 0, 0); +$text_color = imagecolorallocate($im, 233, 14, 91); +imagestring($im, 1, 5, 5, "A Simple Text String", $text_color); +imagepng($im); imagedestroy($im); ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>imagedestroy</function> et - <function>imagecreatetruecolor</function>. - </para> - </refsect1> - </refentry> + </programlisting> + &example.outputs.similar; + <screenshot> + <graphic fileref="figures/image.imagecreate.png" /> + </screenshot> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imagedestroy</function></member> + <member><function>imagecreatetruecolor</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -71,4 +112,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/image-type-to-extension.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/image/functions/image-type-to-extension.xml diff -u phpdoc-fr/reference/image/functions/image-type-to-extension.xml:1.3 phpdoc-fr/reference/image/functions/image-type-to-extension.xml:1.4 --- phpdoc-fr/reference/image/functions/image-type-to-extension.xml:1.3 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/image/functions/image-type-to-extension.xml Sun Jan 28 09:01:28 2007 @@ -1,24 +1,53 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.1 Maintainer: didou Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> + <refentry id="function.image-type-to-extension"> <refnamediv> <refname>image_type_to_extension</refname> - <refpurpose> - Retourne l'extension du fichier pour le type d'image - </refpurpose> + <refpurpose>Retourne l'extension du fichier pour le type d'image</refpurpose> </refnamediv> - <refsect1> + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>image_type_to_extension</methodname> <methodparam><type>int</type><parameter>imagetype</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>include_dot</parameter></methodparam> </methodsynopsis> - - &warn.undocumented.func; -<!-- returned by getimagesize, exif_read_data, exif_thumbnail, exif_imagetype --> + <para> + Retourne l'extension pour la constante <literal>IMAGETYPE_XXX</literal> + fournie. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>imagetype</parameter></term> + <listitem> + <para> + Une des constantes <literal>IMAGETYPE_XXX</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>include_dot</parameter></term> + <listitem> + <para> + Si l'on doit ajouter un point à l'extension ou non. Par défaut, vaut &true;. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Une &string; avec l'extension, correspondant au type de l'image fournie. + </para> </refsect1> </refentry> @@ -41,4 +70,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/image/functions/image-type-to-mime-type.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/image/functions/image-type-to-mime-type.xml diff -u phpdoc-fr/reference/image/functions/image-type-to-mime-type.xml:1.12 phpdoc-fr/reference/image/functions/image-type-to-mime-type.xml:1.13 --- phpdoc-fr/reference/image/functions/image-type-to-mime-type.xml:1.12 Tue Jul 5 20:39:56 2005 +++ phpdoc-fr/reference/image/functions/image-type-to-mime-type.xml Sun Jan 28 09:01:28 2007 @@ -1,135 +1,159 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.image-type-to-mime-type"> - <refnamediv> - <refname>image_type_to_mime_type</refname> - <refpurpose>Lit le Mime-Type d'un type d'image</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>image_type_to_mime_type</methodname> - <methodparam><type>int</type><parameter>imagetype</parameter></methodparam> - </methodsynopsis> - <para> - <function>image_type_to_mime_type</function> détermine le type - Mime (Mime-Type), à utiliser dans l'en-tête HTTP <literal>Content-type</literal>. - <parameter>imagetype</parameter> est une constante, représentant un - type d'image et retournée par - <function>getimagesize</function>, - <function>exif_read_data</function>, <function>exif_thumbnail</function> ou - <function>exif_imagetype</function>. - <example> - <title>image_type_to_mime_type (fichier)</title> - <programlisting role="php"> + +<refentry id="function.image-type-to-mime-type"> + <refnamediv> + <refname>image_type_to_mime_type</refname> + <refpurpose>Lit le Mime-Type d'un type d'image</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>image_type_to_mime_type</methodname> + <methodparam><type>int</type><parameter>imagetype</parameter></methodparam> + </methodsynopsis> + <para> + Détermine le type Mime (Mime-Type), à utiliser dans l'en-tête + HTTP <literal>Content-type</literal>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>imagetype</parameter></term> + <listitem> + <para> + Une des constantes <literal>IMAGETYPE_XXX</literal> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Les valeurs retournées sont les suivantes + <table> + <title>Valeurs des constantes retournées</title> + <tgroup cols="2"> + <thead> + <row> + <entry><parameter>imagetype</parameter></entry> + <entry>Valeur retournée</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>IMAGETYPE_GIF</constant></entry> + <entry><literal>image/gif</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_JPEG</constant></entry> + <entry><literal>image/jpeg</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_PNG</constant></entry> + <entry><literal>image/png</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_SWF</constant></entry> + <entry><literal>application/x-shockwave-flash</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_PSD</constant></entry> + <entry><literal>image/psd</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_BMP</constant></entry> + <entry><literal>image/bmp</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_TIFF_II</constant> (ordre intel)</entry> + <entry><literal>image/tiff</literal></entry> + </row> + <row> + <entry> + <constant>IMAGETYPE_TIFF_MM</constant> (ordre motorola) + </entry> + <entry><literal>image/tiff</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_JPC</constant></entry> + <entry><literal>application/octet-stream</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_JP2</constant></entry> + <entry><literal>image/jp2</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_JPX</constant></entry> + <entry><literal>application/octet-stream</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_JB2</constant></entry> + <entry><literal>application/octet-stream</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_SWC</constant></entry> + <entry><literal>application/x-shockwave-flash</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_IFF</constant></entry> + <entry><literal>image/iff</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_WBMP</constant></entry> + <entry><literal>image/vnd.wap.wbmp</literal></entry> + </row> + <row> + <entry><constant>IMAGETYPE_XBM</constant></entry> + <entry><literal>image/xbm</literal></entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>image_type_to_mime_type (fichier)</title> + <programlisting role="php"> <![CDATA[ <?php header("Content-type: " . image_type_to_mime_type(IMAGETYPE_PNG)); ?> ]]> - </programlisting> - </example> - </para> - <para> - Les valeurs de retour sont les suivantes : - <table> - <title>Valeur de constante retournée</title> - <tgroup cols="2"> - <thead> - <row> - <entry><parameter>imagetype</parameter></entry> - <entry>Valeur retournée</entry> - </row> - </thead> - <tbody> - <row> - <entry><constant>IMAGETYPE_GIF</constant></entry> - <entry><literal>image/gif</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_JPEG</constant></entry> - <entry><literal>image/jpeg</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_PNG</constant></entry> - <entry><literal>image/png</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_SWF</constant></entry> - <entry><literal>application/x-shockwave-flash</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_PSD</constant></entry> - <entry><literal>image/psd</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_BMP</constant></entry> - <entry><literal>image/bmp</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_TIFF_II</constant> (ordre intel)</entry> - <entry><literal>image/tiff</literal></entry> - </row> - <row> - <entry> - <constant>IMAGETYPE_TIFF_MM</constant> (ordre motorola) - </entry> - <entry><literal>image/tiff</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_JPC</constant></entry> - <entry><literal>application/octet-stream</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_JP2</constant></entry> - <entry><literal>image/jp2</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_JPX</constant></entry> - <entry><literal>application/octet-stream</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_JB2</constant></entry> - <entry><literal>application/octet-stream</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_SWC</constant></entry> - <entry><literal>application/x-shockwave-flash</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_IFF</constant></entry> - <entry><literal>image/iff</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_WBMP</constant></entry> - <entry><literal>image/vnd.wap.wbmp</literal></entry> - </row> - <row> - <entry><constant>IMAGETYPE_XBM</constant></entry> - <entry><literal>image/xbm</literal></entry> - </row> - </tbody> - </tgroup> - </table> - </para> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <note> <para> - <note> - <simpara> - Cette fonction ne requiert par la bibliothèque GD. - </simpara> - <para> - Voir aussi - <function>getimagesize</function>, - <function>exif_imagetype</function>, - <function>exif_read_data</function> et - <function>exif_thumbnail</function>. - </para> - </note> + Cette fonction ne requiert par la bibliothèque GD. </para> - </refsect1> - </refentry> + </note> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>getimagesize</function></member> + <member><function>exif_imagetype</function></member> + <member><function>exif_read_data</function></member> + <member><function>exif_thumbnail</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -150,4 +174,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file