dams Tue Apr 17 07:03:03 2001 EDT
Modified files:
/phpdoc/fr/functions image.xml
Log:
Added latest GD 2.0 functions.
Index: phpdoc/fr/functions/image.xml
diff -u phpdoc/fr/functions/image.xml:1.17 phpdoc/fr/functions/image.xml:1.18
--- phpdoc/fr/functions/image.xml:1.17 Thu Mar 22 02:38:22 2001
+++ phpdoc/fr/functions/image.xml Tue Apr 17 07:03:03 2001
@@ -1,67 +1,67 @@
- <reference id="ref.image">
- <title>Images</title>
- <titleabbrev>Graphisme</titleabbrev>
- <partintro>
- <simpara>
- Vous pouvez utiliser les fonctions PHP pour obtenir les
- tailles des images aux formats <acronym>JPEG</acronym>,
- <acronym>GIF</acronym>, <acronym>PNG</acronym> et
- <acronym>SWF</acronym>, et si vous avez la librairie GD (disponible
- à <ulink url="&url.gd;">&url.gd;</ulink>) vous pourrez aussi
- créer et manipuler ces images.
- </simpara>
- <simpara>
- Les formats des images que vous pourrez manipuler dépend de la
- version de GD que vous installereez, et de toute autre librairie
- dont GD a besoin pour accéder à ces images. Les versions
- antérieures à la version 1.6 supportent le
- <acronym>GIF</acronym>, mais pas le <acronym>PNG</acronym>.
- Pour les versions plus récentes, c'est le contraire.
- </simpara>
- <simpara>
- Pour accéder aux images en <acronym>JPEG</acronym>, vous devez
- installer la librairie jpeg-6b (disponible à
- <ulink url="&url.jpeg;">&url.jpeg;</ulink>), puis, recompiler GD
- pour qu'elle utilise jpeg-6b. Vous devrez aussi compiler PHP avec
- <option role="configure">--with-jpeg-dir=/path/to/jpeg-6b</option>.
- </simpara>
- <simpara>
- Pour ajouter le support des polices Type 1, vous devez installer t1lib
- (disponible à <ulink url="&url.t1lib;">&url.t1lib;</ulink>), puis ajouter
- l'option <option role="configure">--with-t1lib[=dir]</option>.
- </simpara>
- </partintro>
- <refentry id="function.getimagesize">
- <refnamediv>
- <refname>GetImageSize</refname>
- <refpurpose>Retourne la taille d'une image GIF, JPG ou PNG.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>getimagesize</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- <paramdef>array <parameter><optional>imageinfo</optional></parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>getimagesize</function> va déterminer la taille des images
- de type <acronym>GIF</acronym>, <acronym>JPG</acronym>,
- <acronym>PNG</acronym> ou <acronym>SWF</acronym> et en retourner
- les dimensions avec le type d'image, et une chaîne type
- "height/width", à placer dans une
- balise <acronym>HTML</acronym> ou <sgmltag>IMG</sgmltag> normale.
- </para>
- <para>
- <function>getimagesize</function> retourne un tableau de 4
éléments.
- L'index 0 contient la largeur. L'index 1 contient la longueur. L'index 2
- contient le type de l'image : 1 = <acronym>GIF</acronym>, 2 = JPG, 3 = PNG.
L'index 3 contient la
- chaîne à placer dans les balises HTML :
- "height=xxx width=xxx".
- <example>
- <title><function>getimagesize</function></title>
- <programlisting role="php">
+<reference id="ref.image">
+ <title>Images</title>
+ <titleabbrev>Graphisme</titleabbrev>
+ <partintro>
+ <simpara>
+ Vous pouvez utiliser les fonctions PHP pour obtenir les
+ tailles des images aux formats <acronym>JPEG</acronym>,
+ <acronym>GIF</acronym>, <acronym>PNG</acronym> et
+ <acronym>SWF</acronym>, et si vous avez la librairie GD (disponible
+ à <ulink url="&url.gd;">&url.gd;</ulink>) vous pourrez aussi
+ créer et manipuler ces images.
+ </simpara>
+ <simpara>
+ Les formats des images que vous pourrez manipuler dépend de la
+ version de GD que vous installereez, et de toute autre librairie
+ dont GD a besoin pour accéder à ces images. Les versions
+ antérieures à la version 1.6 supportent le
+ <acronym>GIF</acronym>, mais pas le <acronym>PNG</acronym>.
+ Pour les versions plus récentes, c'est le contraire.
+ </simpara>
+ <simpara>
+ Pour accéder aux images en <acronym>JPEG</acronym>, vous devez
+ installer la librairie jpeg-6b (disponible à
+ <ulink url="&url.jpeg;">&url.jpeg;</ulink>), puis, recompiler GD
+ pour qu'elle utilise jpeg-6b. Vous devrez aussi compiler PHP avec
+ <link linkend="install.configure.with-jpeg-dir"><option
+role="configure">--with-jpeg-dir=/path/to/jpeg-6b</option></link>.
+ </simpara>
+ <simpara>
+ Pour ajouter le support des polices Type 1, vous devez installer t1lib
+ (disponible à <ulink url="&url.t1lib;">&url.t1lib;</ulink>), puis ajouter
+ l'option <link linkend="install.configure.enable-t1lib"><option
+role="configure">--with-t1lib[=dir]</option></link>.
+ </simpara>
+ </partintro>
+ <refentry id="function.getimagesize">
+ <refnamediv>
+ <refname>GetImageSize</refname>
+ <refpurpose>Retourne la taille d'une image GIF, JPG ou PNG.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>getimagesize</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ <paramdef>array <parameter><optional>imageinfo</optional></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>getimagesize</function> va déterminer la taille des images
+ de type <acronym>GIF</acronym>, <acronym>JPG</acronym>,
+ <acronym>PNG</acronym> ou <acronym>SWF</acronym> et en retourner
+ les dimensions avec le type d'image, et une chaîne type
+ "height/width", à placer dans une
+ balise <acronym>HTML</acronym> ou <sgmltag>IMG</sgmltag> normale.
+ </para>
+ <para>
+ <function>getimagesize</function> retourne un tableau de 4 éléments.
+ L'index 0 contient la largeur. L'index 1 contient la longueur. L'index 2
+ contient le type de l'image : 1 = <acronym>GIF</acronym>, 2 = JPG, 3 = PNG.
+L'index 3 contient la
+ chaîne à placer dans les balises HTML :
+ "height=xxx width=xxx".
+ <example>
+ <title><function>getimagesize</function></title>
+ <programlisting role="php">
<?php
$size = GetImageSize("img/flag.jpg");
?>
@@ -69,32 +69,32 @@
<?php
echo $size[3];
?>>
- </programlisting>
- </example>
- </para>
- <para>
- <example>
- <title><function>getimagesize</function> avec une URL</title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title><function>getimagesize</function> avec une URL</title>
+ <programlisting role="php">
<?php
$size = getimagesize("http://www.php.net/gifs/logo.gif");
?gt;
- </programlisting>
- </example>
- </para>
- <para>
- Le paramètre optionnel <parameter>imageinfo</parameter> permet
- d'extraire des informations supplémentaires du fichier image.
- Actuellement, cette option va retourner différents marqueurs
- <acronym>JPG</acronym> APP dans un tableau associatif. Certains programmes
- utilisent ces marqueur APP pour préciser les informations dans
- les balises HTML. Un marqueur commun est le marqueur APP13, décrit
- à <ulink url="&url.iptc;">&url.iptc;</ulink>. Vous pouvez utiliser
- la fonction <function>iptcparse</function> pour analyser ce marqueur, et
- obtenir des informations intelligibles.
- <example>
- <title><function>getimagesize</function> qui retourne IPTC</title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Le paramètre optionnel <parameter>imageinfo</parameter> permet
+ d'extraire des informations supplémentaires du fichier image.
+ Actuellement, cette option va retourner différents marqueurs
+ <acronym>JPG</acronym> APP dans un tableau associatif. Certains programmes
+ utilisent ces marqueur APP pour préciser les informations dans
+ les balises HTML. Un marqueur commun est le marqueur APP13, décrit
+ à <ulink url="&url.iptc;">&url.iptc;</ulink>. Vous pouvez utiliser
+ la fonction <function>iptcparse</function> pour analyser ce marqueur, et
+ obtenir des informations intelligibles.
+ <example>
+ <title><function>getimagesize</function> qui retourne IPTC</title>
+ <programlisting role="php">
<?php
$size = getimagesize("testimg.jpg",&$info);
if (isset($info["APP13"])) {
@@ -102,575 +102,1007 @@
var_dump($iptc);
}
?>
- </programlisting>
- </example>
- <note>
- <simpara>
- <function>getimagesize</function> ne requiert par la bibliothèque GD.
- </simpara>
- </note>
- <note>
- <simpara>
- Le support URL a été ajouté en PHP 4.0.5.
- </simpara>
- </note>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagearc">
- <refnamediv>
- <refname>ImageArc</refname>
- <refpurpose>Dessine une ellipse partielle.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagearc</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>int <parameter>cx</parameter></paramdef>
- <paramdef>int <parameter>cy</parameter></paramdef>
- <paramdef>int <parameter>w</parameter></paramdef>
- <paramdef>int <parameter>h</parameter></paramdef>
- <paramdef>int <parameter>s</parameter></paramdef>
- <paramdef>int <parameter>e</parameter></paramdef>
- <paramdef>int <parameter>col</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagearc</function> dessine une ellipse partielle, centrée sur
- <parameter>cx</parameter>, <parameter>cy</parameter> (le coin en haut à
- gauche est l'origine (0,0)) dans l'image référencée par
- <parameter>im</parameter>. <parameter>w</parameter> et
- <parameter>h</parameter> spécifient la largeur et la hauteur de
l'ellipse,
- tandis que le début et la fin de l'arc sont donnés en
- degrés, par les arguments <parameter>s</parameter> et
- <parameter>e</parameter>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagechar">
- <refnamediv>
- <refname>ImageChar</refname>
- <refpurpose>Dessine un caractère horizontalement.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagechar</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>resource <parameter>font</parameter></paramdef>
- <paramdef>int <parameter>x</parameter></paramdef>
- <paramdef>int <parameter>y</parameter></paramdef>
- <paramdef>string <parameter>c</parameter></paramdef>
- <paramdef>int <parameter>col</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
+ </programlisting>
+ </example>
+ <note>
+ <simpara>
+ <function>getimagesize</function> ne requiert par la bibliothèque GD.
+ </simpara>
+ </note>
+ <note>
+ <simpara>
+ Le support URL a été ajouté en PHP 4.0.5.
+ </simpara>
+ </note>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagealphablending">
+ <refnamediv>
+ <refname>ImageAlphaBlending</refname>
+ <refpurpose>Modifie le mode de blending d'une image</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagealphablending</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>bool <parameter>blendmode</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagealphablending</function> fournit deux modes de dessins
+ des images en vraies couleurs (truecolors). En mode "blending", le canal
+ alpha de chaque couleur fournie à chaque fonction de dessin, telles que
+ <function>imagesetpixel</function> détermine sa transparence. GD va alors
+ automatiquement mixer la couleur à ce point, et stocker le résultat
+dans
+ l'image. Le pixel résultant est alors opaque. En mode non-mixant, la
+ couleur est copiée litéralement avec ses informations de canal
+alpha,
+ et remplace le pixel de destination. Le mixage n'est pas disponible
+ avec les images à palette. Si <parameter>blendmode</parameter> vaut
+ <literal>TRUE</literal>, alors le mode de mixage sera activé, et sinon
+ il sera désactivé.
+ </para>
+ <note>
<para>
- <function>imagechar</function> dessine le premier caractère de la
chaîne
- <parameter>c</parameter> dans l'image <parameter>id</parameter> avec le coin
- supérieur gauche placé à la position
<parameter>x</parameter>,<parameter>y</parameter>
- (le coin en haut à gauche est l'origine (0,0)) avec la couleur
- <parameter>col</parameter>. Si la police est 1, 2, 3, 4 ou 5, une police
intégrée
- sera utilisée (plus le chiffre est grand, plus grande est la police).0
+ <function>imagealphablending</function> a été ajoutée en
+PHP 4.0.6
+ et nécessite GD 2.0.1.
</para>
+ </note>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagearc">
+ <refnamediv>
+ <refname>ImageArc</refname>
+ <refpurpose>Dessine une ellipse partielle.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagearc</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>cx</parameter></paramdef>
+ <paramdef>int <parameter>cy</parameter></paramdef>
+ <paramdef>int <parameter>w</parameter></paramdef>
+ <paramdef>int <parameter>h</parameter></paramdef>
+ <paramdef>int <parameter>s</parameter></paramdef>
+ <paramdef>int <parameter>e</parameter></paramdef>
+ <paramdef>int <parameter>col</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagearc</function> dessine une ellipse partielle, centrée sur
+ <parameter>cx</parameter>, <parameter>cy</parameter> (le coin en haut à
+ gauche est l'origine (0,0)) dans l'image référencée par
+ <parameter>im</parameter>. <parameter>w</parameter> et
+ <parameter>h</parameter> spécifient la largeur et la hauteur de l'ellipse,
+ tandis que le début et la fin de l'arc sont donnés en
+ degrés, par les arguments <parameter>s</parameter> et
+ <parameter>e</parameter>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagefilledarc">
+ <refnamediv>
+ <refname>imagefilledarc</refname>
+ <refpurpose>Dessine une ellipse partielle et la remplit</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagefilledarc</function></funcdef>
+ <paramdef>int <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>cx</parameter></paramdef>
+ <paramdef>int <parameter>cy</parameter></paramdef>
+ <paramdef>int <parameter>w</parameter></paramdef>
+ <paramdef>int <parameter>h</parameter></paramdef>
+ <paramdef>int <parameter>s</parameter></paramdef>
+ <paramdef>int <parameter>e</parameter></paramdef>
+ <paramdef>int <parameter>col</parameter></paramdef>
+ <paramdef>int <parameter>style</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagefilledarc</function> dessine une ellipse partielle, centrée
+ sur le point (<parameter>cx</parameter>, <parameter>cy</parameter>).
+ Le coin supérieur gauche est (0, 0), dans l'image
+<parameter>im</parameter>.
+ <parameter>w</parameter> et <parameter>h</parameter> spécifient
+ respectivement la largeur et la hauteur de l'ellipse, tandis que les points
+ de début et de fin sont représentés par
+<parameter>s</parameter> et
+ <parameter>e</parameter>, en degrés. L'argument
+<parameter>style</parameter>
+ est un champ de bit, combiné avec l'opérateur OR :
+ <orderedlist>
+ <listitem><simpara><literal>IMG_ARC_PIE</literal></simpara></listitem>
+ <listitem><simpara><literal>IMG_ARC_CHORD</literal></simpara></listitem>
+ <listitem><simpara><literal>IMG_ARC_NOFILL</literal></simpara></listitem>
+ <listitem><simpara><literal>IMG_ARC_EDGED</literal></simpara></listitem>
+ </orderedlist>
+ <literal>IMG_ARC_PIE</literal> et <literal>IMG_ARC_CHORD</literal> sont
+ mutellememnt exclusives; <literal>IMG_ARC_CHORD</literal> ne fait que
+ connecter les angles de début et de fin avec une ligne droite, tandis
+ que <literal>IMG_ARC_PIE</literal> produit une ligne courbe.
+ <literal>IMG_ARC_NOFILL</literal> indique que l'arc (ou corde) doit être
+ dessiné mais pas rempli. <literal>IMG_ARC_EDGED</literal>, utilisé
+conjointement
+ avec <literal>IMG_ARC_NOFILL</literal>, indique que les angles de
+ début et de fin doivent être connecté au centre. Cette
+fonction est
+ recommandée pour faire les graphiques de type camenbert.
+ </para>
+ <note>
<para>
- Voir aussi <function>imageloadfont</function>.
+ <function>imagefilledarc</function> a été ajoutée en PHP
+4.0.6
+ et nécessite GD 2.0.1.
</para>
- </refsect1>
- </refentry>
- <refentry id="function.imagecharup">
- <refnamediv>
- <refname>ImageCharUp</refname>
- <refpurpose>Dessine un caractère verticalement.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagecharup</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>resource <parameter>font</parameter></paramdef>
- <paramdef>int <parameter>x</parameter></paramdef>
- <paramdef>int <parameter>y</parameter></paramdef>
- <paramdef>string <parameter>c</parameter></paramdef>
- <paramdef>int <parameter>col</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
+ </note>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imageellipse">
+ <refnamediv>
+ <refname>ImageEllipse</refname>
+ <refpurpose>Dessine une ellipse</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imageellipse</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>cx</parameter></paramdef>
+ <paramdef>int <parameter>cy</parameter></paramdef>
+ <paramdef>int <parameter>w</parameter></paramdef>
+ <paramdef>int <parameter>h</parameter></paramdef>
+ <paramdef>int <parameter>col</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imageellipse</function> dessine une ellipse centrée sur
+ le point (<parameter>cx</parameter>, <parameter>cy</parameter>).
+ Le coin supérieur gauche est aux coordonnées (0,0). L'image
+ de dessin est <parameter>im</parameter>. <parameter>w</parameter> et
+ <parameter>h</parameter> spécifient respectivement la largeur
+ et la hauteur de l'ellipse. La couleur de dessin de l'ellipse
+ est <parameter>color</parameter>.
+ </para>
+ <note>
<para>
- <function>imagecharup</function> dessine le premier caractère
- de la chaîne <parameter>c</parameter> dans l'image
- <parameter>id</parameter> avec le coin supérieur gauche
- placé à la position
(<parameter>x</parameter>,<parameter>y</parameter>)
- (le coin en haut à gauche est l'origine (0,0)), avec la couleur
- <parameter>col</parameter>. Si la police est 1, 2, 3, 4 ou 5, une police
- intégrée sera utilisée (plus le chiffre est grand,
- plus grande est la police).
+ <function>imageellipse</function> a été ajoutée en PHP 4.0.6
+ et nécessite GD 2.0.1.
</para>
+ </note>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagefilledellipse">
+ <refnamediv>
+ <refname>ImageFilledEllipse</refname>
+ <refpurpose>Dessine une ellipse pleine</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagefilledellipse</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>cx</parameter></paramdef>
+ <paramdef>int <parameter>cy</parameter></paramdef>
+ <paramdef>int <parameter>w</parameter></paramdef>
+ <paramdef>int <parameter>h</parameter></paramdef>
+ <paramdef>int <parameter>col</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagefilledellipse</function> dessine une ellipse centrée sur
+ le point (<parameter>cx</parameter>, <parameter>cy</parameter>).
+ Le coin supérieur gauche est aux coordonnées (0,0). L'image
+ de dessin est <parameter>im</parameter>. <parameter>w</parameter> et
+ <parameter>h</parameter> spécifient respectivement la largeur
+ et la hauteur de l'ellipse. La couleur de remplissage de l'ellipse
+ est <parameter>color</parameter>.
+ </para>
+ <note>
<para>
- Voir aussi <function>imageloadfont</function>.
+ <function>imagefilledellipse</function> a été ajoutée en
+PHP 4.0.6
+ et nécessite GD 2.0.1.
</para>
- </refsect1>
- </refentry>
- <refentry id="function.imagecolorallocate">
- <refnamediv>
- <refname>ImageColorAllocate</refname>
- <refpurpose>Alloue une couleur pour une image.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagecolorallocate</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>int <parameter>red</parameter></paramdef>
- <paramdef>int <parameter>green</parameter></paramdef>
- <paramdef>int <parameter>blue</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagecolorallocate</function> retourne un identifiant de couleur,
- représentant la couleur composée avec les couleurs RGB
- (<parameter>red</parameter>, <parameter>green</parameter>,
- <parameter>blue</parameter>). L'argument <parameter>im</parameter> est
- le résultat de la fonction <function>imagecreate</function>.
- <function>imagecolorallocate</function>
- doit être appelée pour créer chaque couleur
- qui sera représentée par <parameter>im</parameter>.
- <informalexample>
- <programlisting role="php">
+ </note>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagechar">
+ <refnamediv>
+ <refname>ImageChar</refname>
+ <refpurpose>Dessine un caractère horizontalement.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagechar</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>resource <parameter>font</parameter></paramdef>
+ <paramdef>int <parameter>x</parameter></paramdef>
+ <paramdef>int <parameter>y</parameter></paramdef>
+ <paramdef>string <parameter>c</parameter></paramdef>
+ <paramdef>int <parameter>col</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagechar</function> dessine le premier caractère de la
+chaîne
+ <parameter>c</parameter> dans l'image <parameter>id</parameter> avec le coin
+ supérieur gauche placé à la position
+<parameter>x</parameter>,<parameter>y</parameter>
+ (le coin en haut à gauche est l'origine (0,0)) avec la couleur
+ <parameter>col</parameter>. Si la police est 1, 2, 3, 4 ou 5, une police
+intégrée
+ sera utilisée (plus le chiffre est grand, plus grande est la police).0
+ </para>
+ <para>
+ Voir aussi
+ <function>imageloadfont</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecharup">
+ <refnamediv>
+ <refname>ImageCharUp</refname>
+ <refpurpose>Dessine un caractère verticalement.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagecharup</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>resource <parameter>font</parameter></paramdef>
+ <paramdef>int <parameter>x</parameter></paramdef>
+ <paramdef>int <parameter>y</parameter></paramdef>
+ <paramdef>string <parameter>c</parameter></paramdef>
+ <paramdef>int <parameter>col</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecharup</function> dessine le premier caractère
+ de la chaîne <parameter>c</parameter> dans l'image
+ <parameter>id</parameter> avec le coin supérieur gauche
+ placé à la position
+(<parameter>x</parameter>,<parameter>y</parameter>)
+ (le coin en haut à gauche est l'origine (0,0)), avec la couleur
+ <parameter>col</parameter>. Si la police est 1, 2, 3, 4 ou 5, une police
+ intégrée sera utilisée (plus le chiffre est grand,
+ plus grande est la police).
+ </para>
+ <para>
+ Voir aussi
+ <function>imageloadfont</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecolorallocate">
+ <refnamediv>
+ <refname>ImageColorAllocate</refname>
+ <refpurpose>Alloue une couleur pour une image.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagecolorallocate</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>red</parameter></paramdef>
+ <paramdef>int <parameter>green</parameter></paramdef>
+ <paramdef>int <parameter>blue</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecolorallocate</function> retourne un identifiant de couleur,
+ représentant la couleur composée avec les couleurs RGB
+ (<parameter>red</parameter>, <parameter>green</parameter>,
+ <parameter>blue</parameter>). L'argument <parameter>im</parameter> est
+ le résultat de la fonction <function>imagecreate</function>.
+ <function>imagecolorallocate</function>
+ doit être appelée pour créer chaque couleur
+ qui sera représentée par <parameter>im</parameter>.
+ <informalexample>
+ <programlisting role="php">
<?php
$white = imagecolorallocate($im, 255,255,255);
$black = imagecolorallocate($im, 0,0,0);
?>
- </programlisting>
- </informalexample>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagecolordeallocate">
- <refnamediv>
- <refname>ImageColorDeAllocate</refname>
- <refpurpose>
- Désallouune une couleur pour une image
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int
- <function>imagecolordeallocate</function>
- </funcdef>
- <paramdef>resource
- <parameter>im</parameter>
- </paramdef>
- <paramdef>int
- <parameter>index</parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagecolordeallocate</function> désalloue une couleur
- précédemment allouée avec la fonction
<function>imagecolorallocate</function>.
- <informalexample>
- <programlisting role="php">
+ </programlisting>
+ </informalexample>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecolordeallocate">
+ <refnamediv>
+ <refname>ImageColorDeAllocate</refname>
+ <refpurpose>
+ Désallouune une couleur pour une image
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int
+ <function>imagecolordeallocate</function>
+ </funcdef>
+ <paramdef>resource
+ <parameter>im</parameter>
+ </paramdef>
+ <paramdef>int
+ <parameter>index</parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecolordeallocate</function> désalloue une couleur
+ précédemment allouée avec la fonction
+ <function>imagecolorallocate</function>.
+ <informalexample>
+ <programlisting role="php">
<?php
$white = imagecolorallocate($im, 255, 255, 255);
imagecolordeallocate($im, $white);
?>
- </programlisting>
- </informalexample>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagecolorat">
- <refnamediv>
- <refname>ImageColorAt</refname>
- <refpurpose>Retourne l'index de la couleur d'un pixel donné.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagecolorat</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>int <parameter>x</parameter></paramdef>
- <paramdef>int <parameter>y</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagecolorat</function> retourne l'index de la couleur du pixel
situé
- aux coordonnées (<parameter>x</parameter>, <parameter>y</parameter>),
dans l'image
- <parameter>im</parameter>.
- </para>
- <para>
- Voir aussi <function>imagecolorset</function> et
<function>imagecolorsforindex</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagecolorclosest">
- <refnamediv>
- <refname>ImageColorClosest</refname>
- <refpurpose>
- Retourne l'index de la couleur la plus proche d'une couleur donnée.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagecolorclosest</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>int <parameter>red</parameter></paramdef>
- <paramdef>int <parameter>green</parameter></paramdef>
- <paramdef>int <parameter>blue</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagecolorclosest</function> retourne l'index de la couleur de la
- palette qui est la plus proche de la valeur RGB passée.
- </para>
- <para>
- La "distance" entre la couleur souhaitée et les couleurs de la palette
est calculée
- en considérant l'espace RGB comme un espace à 3 dimensions.
- </para>
- <para>
- Voir aussi <function>imagecolorexact</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagecolorexact">
- <refnamediv>
- <refname>ImageColorExact</refname>
- <refpurpose>Retourne l'index de la couleur donnée.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagecolorexact</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>int <parameter>red</parameter></paramdef>
- <paramdef>int <parameter>green</parameter></paramdef>
- <paramdef>int <parameter>blue</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagecolorexact</function> retourne l'index de la couleur
spécifiée
- dans la palette de l'image <parameter>im</parameter>.
- </para>
- <para>
- Si la couleur n'existe pas dans cette palettre, retourne -1.
- </para>
- <para>
- Voir aussi <function>imagecolorclosest</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagecolorresolve">
- <refnamediv>
- <refname>ImageColorResolve</refname>
- <refpurpose>
- Retourne l'index de la couleur donnée, ou la plus proche possible.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagecolorresolve</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>int <parameter>red</parameter></paramdef>
- <paramdef>int <parameter>green</parameter></paramdef>
- <paramdef>int <parameter>blue</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagecolorresolve</function> retourne un index de couleur
- à tous les coups. Soit il arrive à trouver la couleur
- demandée dans la palette, soit il recherche la couleur la plus
- proche.
- </para>
- <para>
- Voir aussi <function>imagecolorclosest</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagegammacorrect">
- <refnamediv>
- <refname>ImageGammaCorrect</refname>
- <refpurpose>
- Applique une correction gamma à l'image
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagegammacorrect</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>double
- <parameter>inputgamma</parameter>
- </paramdef>
- <paramdef>double
- <parameter>outputgamma</parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagegammacorrect</function> applique une correction gamma
- au flot d'image GD <parameter>im</parameter>. Le facteur d'entrée est
- <parameter>inputgamma</parameter>, et le facteur de sortie est
- <parameter>outputgamma</parameter>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagecolorset">
- <refnamediv>
- <refname>ImageColorSet</refname>
- <refpurpose>
- Change la couleur dans une palette à l'index donné.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>bool <function>imagecolorset</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>int <parameter>index</parameter></paramdef>
- <paramdef>int <parameter>red</parameter></paramdef>
- <paramdef>int <parameter>green</parameter></paramdef>
- <paramdef>int <parameter>blue</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagecolorset</function> permet d'attribuer à un index
- d'une palette une couleur spécifique. C'est une fonction très
- pratique pour effectuer du remplissage de couleur sans le faire
- réellement.
- </para>
- <para>
- Voir aussi <function>imagecolorat</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagecolorsforindex">
- <refnamediv>
- <refname>ImageColorsForIndex</refname>
- <refpurpose>Retourne la couleur associée à un index.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>imagecolorsforindex</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>int <parameter>index</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagecolorsforindex</function> retourne un tableau associatif
- avec les couleur rouge (red) , vert (green), bleu (blue) qui contiennent
- les valeurs de la couleur correspondante.
- </para>
- <para>
- Voir aussi <function>imagecolorat</function> et
- <function>imagecolorexact</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagecolorstotal">
- <refnamediv>
- <refname>ImageColorsTotal</refname>
- <refpurpose>Calcule le nombre de couleur d'une palette.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagecolorstotal</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagecolorstotal</function> retourne le nombre de couleurs
- de la palette.
- </para>
- <para>
- Voir aussi <function>imagecolorat</function> et
- <function>imagecolorsforindex</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagecolortransparent">
- <refnamediv>
- <refname>ImageColorTransparent</refname>
- <refpurpose>Définit la couleur transparente.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagecolortransparent</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>int <parameter><optional>col</optional></parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
+ </programlisting>
+ </informalexample>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecolorat">
+ <refnamediv>
+ <refname>ImageColorAt</refname>
+ <refpurpose>Retourne l'index de la couleur d'un pixel donné.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagecolorat</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>x</parameter></paramdef>
+ <paramdef>int <parameter>y</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecolorat</function> retourne l'index de la couleur du pixel
+situé
+ aux coordonnées (<parameter>x</parameter>, <parameter>y</parameter>), dans
+l'image
+ <parameter>im</parameter>.
+ </para>
+ <para>
+ Voir aussi
+ <function>imagecolorset</function> et
+ <function>imagecolorsforindex</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecolorclosestalpha">
+ <refnamediv>
+ <refname>ImageColorClosestAlpha</refname>
+ <refpurpose>
+ Retourne la couleur la plus proche, en tenant compte du canal alpha
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagecolorclosestalpha</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>red</parameter></paramdef>
+ <paramdef>int <parameter>green</parameter></paramdef>
+ <paramdef>int <parameter>blue</parameter></paramdef>
+ <paramdef>int <parameter>alpha</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecolorclosestalpha</function> retourne l'index de la
+ couleur, dans la palette de l'image <parameter>im</parameter>,
+ la plus proche de la couleur spécifiée par les autres
+paramètres,
+ au format <acronym>RGB</acronym> et de canal alpha <parameter>alpha</parameter>.
+ </para>
+ <para>
+ Voir aussi <function>imagecolorexactalpha</function>.
+ </para>
+ <note>
<para>
- <function>imagecolortransparent</function> permet de choisir la couleur
- transparente d'une image, et de lui donner la valeur de col.
- <parameter>im</parameter> est un identifiant d'image, retourné
- par <function>imagecreate</function> et
- <parameter><optional>col</optional></parameter> est un identifiant de couleur
- retourné par <function>imagecolorallocate</function>.
+ <function>imagecolorclosestalpha</function> a été ajoutée
+en PHP 4.0.6
+ et nécessite GD 2.0.1.
</para>
+ </note>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecolorclosest">
+ <refnamediv>
+ <refname>ImageColorClosest</refname>
+ <refpurpose>
+ Retourne l'index de la couleur la plus proche d'une couleur donnée.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagecolorclosest</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>red</parameter></paramdef>
+ <paramdef>int <parameter>green</parameter></paramdef>
+ <paramdef>int <parameter>blue</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecolorclosest</function> retourne l'index de la couleur de la
+ palette qui est la plus proche de la valeur RGB passée.
+ </para>
+ <para>
+ La "distance" entre la couleur souhaitée et les couleurs de la palette est
+calculée
+ en considérant l'espace RGB comme un espace à 3 dimensions.
+ </para>
+ <para>
+ Voir aussi
+ <function>imagecolorexact</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecolorexact">
+ <refnamediv>
+ <refname>ImageColorExact</refname>
+ <refpurpose>Retourne l'index de la couleur donnée.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagecolorexact</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>red</parameter></paramdef>
+ <paramdef>int <parameter>green</parameter></paramdef>
+ <paramdef>int <parameter>blue</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecolorexact</function> retourne l'index de la couleur
+ spécifiée dans la palette de l'image
+ <parameter>im</parameter>.
+ </para>
+ <para>
+ Si la couleur n'existe pas dans cette palettre, retourne -1.
+ </para>
+ <para>
+ Voir aussi
+ <function>imagecolorclosest</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecolorexactalpha">
+ <refnamediv>
+ <refname>ImageColorExactAlpha</refname>
+ <refpurpose>Retourne l'index d'une couleur avec son canal alpha</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagecolorexactalpha</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>red</parameter></paramdef>
+ <paramdef>int <parameter>green</parameter></paramdef>
+ <paramdef>int <parameter>blue</parameter></paramdef>
+ <paramdef>int <parameter>alpha</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecolorexactalpha</function> retourne l'index de
+ la couleur fournie au format <acronym>RGB</acronym> et son canal
+ alpha <parameter>alpha</parameter>, dans l'image <parameter>im</parameter>.
+ </para>
+ <para>
+ Si la couleur n'existe pas dans la palette de l'image,
+ <function>imagecolorexactalpha</function> retourne -1.
+ </para>
+ <para>
+ Voir aussi
+ <function>imagecolorclosestalpha</function>.
+ </para>
+ <note>
<para>
- L'identifiant de la nouvelle (ou courante) couleur transparante est
- retourné.
+ <function>imagecolorexactalpha</function> a été ajoutée en
+PHP 4.0.6
+ et nécessite GD 2.0.1.
</para>
- </refsect1>
- </refentry>
- <refentry id="function.imagecopy">
- <refnamediv>
- <refname>ImageCopy</refname>
- <refpurpose>
- Copie une partie d'une image
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int
- <function>imagecopy</function>
- </funcdef>
- <paramdef>resource
- <parameter>dst_im</parameter>
- </paramdef>
- <paramdef>resource
- <parameter>src_im</parameter>
- </paramdef>
- <paramdef>int
- <parameter>dst_x</parameter>
- </paramdef>
- <paramdef>int
- <parameter>dst_y</parameter>
- </paramdef>
- <paramdef>int
- <parameter>src_x</parameter>
- </paramdef>
- <paramdef>int
- <parameter>src_y</parameter>
- </paramdef>
- <paramdef>int
- <parameter>src_w</parameter>
- </paramdef>
- <paramdef>int
- <parameter>src_h</parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
+ </note>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecolorresolve">
+ <refnamediv>
+ <refname>ImageColorResolve</refname>
+ <refpurpose>
+ Retourne l'index de la couleur donnée, ou la plus proche possible.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagecolorresolve</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>red</parameter></paramdef>
+ <paramdef>int <parameter>green</parameter></paramdef>
+ <paramdef>int <parameter>blue</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecolorresolve</function> retourne un index de couleur
+ à tous les coups. Soit il arrive à trouver la couleur
+ demandée dans la palette, soit il recherche la couleur la plus
+ proche.
+ </para>
+ <para>
+ Voir aussi
+ <function>imagecolorclosest</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecolorresolvealpha">
+ <refnamediv>
+ <refname>ImageColorResolveAlpha</refname>
+ <refpurpose>
+ Retourne un index de couleur ou son alternative la plus proche,
+ y compris le canal alpha
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagecolorresolvealpha</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>red</parameter></paramdef>
+ <paramdef>int <parameter>green</parameter></paramdef>
+ <paramdef>int <parameter>blue</parameter></paramdef>
+ <paramdef>int <parameter>alpha</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecolorresolvealpha</function> retourne toujours un
+ index de couleur, disponible dans la palette de l'image
+ <parameter>im</parameter> : soit c'est la couleur exacte,
+ soit c'est la meilleure approximation.
+ </para>
+ <para>
+ Voir aussi
+ <function>imagecolorclosestalpha</function>.
+ </para>
+ <note>
<para>
- Copie une partie de l'image <parameter>src_im</parameter> sur l'image de
- destination <parameter>dst_im</parameter>, en commencant aux coordonnées
- <parameter>src_x</parameter>, <parameter>src_y </parameter> et sur la largeur
- de <parameter>src_w</parameter> et la hauteur de <parameter>src_h</parameter>.
- La portion ainsi définie sera copiée et placée aux
- coordonnées <parameter>dst_x</parameter> et <parameter>dst_y</parameter>.
+ <function>imagecolorresolvealpha</function> a été ajoutée
+en PHP 4.0.6
+ et nécessite GD 2.0.1.
</para>
- </refsect1>
- </refentry>
- <refentry id="function.imagecopyresized">
- <refnamediv>
- <refname>ImageCopyResized</refname>
- <refpurpose>Copie et redimensionne une partie d'une image.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagecopyresized</function></funcdef>
- <paramdef>resource <parameter>dst_im</parameter></paramdef>
- <paramdef>resource <parameter>src_im</parameter></paramdef>
- <paramdef>int <parameter>dstX</parameter></paramdef>
- <paramdef>int <parameter>dstY</parameter></paramdef>
- <paramdef>int <parameter>srcX</parameter></paramdef>
- <paramdef>int <parameter>srcY</parameter></paramdef>
- <paramdef>int <parameter>dstW</parameter></paramdef>
- <paramdef>int <parameter>dstH</parameter></paramdef>
- <paramdef>int <parameter>srcW</parameter></paramdef>
- <paramdef>int <parameter>srcH</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
+ </note>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagegammacorrect">
+ <refnamediv>
+ <refname>ImageGammaCorrect</refname>
+ <refpurpose>
+ Applique une correction gamma à l'image
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagegammacorrect</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>double
+ <parameter>inputgamma</parameter>
+ </paramdef>
+ <paramdef>double
+ <parameter>outputgamma</parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagegammacorrect</function> applique une correction gamma
+ au flot d'image GD <parameter>im</parameter>. Le facteur d'entrée est
+ <parameter>inputgamma</parameter>, et le facteur de sortie est
+ <parameter>outputgamma</parameter>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecolorset">
+ <refnamediv>
+ <refname>ImageColorSet</refname>
+ <refpurpose>
+ Change la couleur dans une palette à l'index donné.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>imagecolorset</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>index</parameter></paramdef>
+ <paramdef>int <parameter>red</parameter></paramdef>
+ <paramdef>int <parameter>green</parameter></paramdef>
+ <paramdef>int <parameter>blue</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecolorset</function> permet d'attribuer à un index
+ d'une palette une couleur spécifique. C'est une fonction très
+ pratique pour effectuer du remplissage de couleur sans le faire
+ réellement.
+ </para>
+ <para>
+ Voir aussi <function>imagecolorat</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecolorsforindex">
+ <refnamediv>
+ <refname>ImageColorsForIndex</refname>
+ <refpurpose>Retourne la couleur associée à un index.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>imagecolorsforindex</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>index</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecolorsforindex</function> retourne un tableau associatif
+ avec les couleur rouge (red) , vert (green), bleu (blue) qui contiennent
+ les valeurs de la couleur correspondante.
+ </para>
+ <para>
+ Voir aussi
+ <function>imagecolorat</function> et
+ <function>imagecolorexact</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecolorstotal">
+ <refnamediv>
+ <refname>ImageColorsTotal</refname>
+ <refpurpose>Calcule le nombre de couleur d'une palette.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagecolorstotal</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecolorstotal</function> retourne le nombre de couleurs
+ de la palette.
+ </para>
+ <para>
+ Voir aussi
+ <function>imagecolorat</function> et
+ <function>imagecolorsforindex</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecolortransparent">
+ <refnamediv>
+ <refname>ImageColorTransparent</refname>
+ <refpurpose>Définit la couleur transparente.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagecolortransparent</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter><optional>col</optional></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecolortransparent</function> permet de choisir la couleur
+ transparente d'une image, et de lui donner la valeur de col.
+ <parameter>im</parameter> est un identifiant d'image, retourné
+ par <function>imagecreate</function> et
+ <parameter><optional>col</optional></parameter> est un identifiant de couleur
+ retourné par <function>imagecolorallocate</function>.
+ </para>
+ <para>
+ L'identifiant de la nouvelle (ou courante) couleur transparante est
+ retourné.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecopy">
+ <refnamediv>
+ <refname>ImageCopy</refname>
+ <refpurpose>
+ Copie une partie d'une image
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int
+ <function>imagecopy</function>
+ </funcdef>
+ <paramdef>resource
+ <parameter>dst_im</parameter>
+ </paramdef>
+ <paramdef>resource
+ <parameter>src_im</parameter>
+ </paramdef>
+ <paramdef>int
+ <parameter>dst_x</parameter>
+ </paramdef>
+ <paramdef>int
+ <parameter>dst_y</parameter>
+ </paramdef>
+ <paramdef>int
+ <parameter>src_x</parameter>
+ </paramdef>
+ <paramdef>int
+ <parameter>src_y</parameter>
+ </paramdef>
+ <paramdef>int
+ <parameter>src_w</parameter>
+ </paramdef>
+ <paramdef>int
+ <parameter>src_h</parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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.imagecopymerge">
+ <refnamediv>
+ <refname>ImageCopyMerge</refname>
+ <refpurpose>
+ Copie et fusionne une partie d'une image
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagecopymerge</function></funcdef>
+ <paramdef>resource <parameter>dst_im</parameter> </paramdef>
+ <paramdef>resource <parameter>src_im</parameter> </paramdef>
+ <paramdef>int <parameter>dst_x</parameter> </paramdef>
+ <paramdef>int <parameter>dst_y</parameter> </paramdef>
+ <paramdef>int <parameter>src_x</parameter> </paramdef>
+ <paramdef>int <parameter>src_y</parameter> </paramdef>
+ <paramdef>int <parameter>src_w</parameter> </paramdef>
+ <paramdef>int <parameter>src_h</parameter> </paramdef>
+ <paramdef>int <parameter>pct</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecopymerge</function> copie une partie de
+ l'image <parameter>src_im</parameter> dans l'image de destination
+ <parameter>dst_im</parameter> commencant 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>
+ <note>
<para>
- <function>imagecopyresized</function> copie une partie rectangulaire d'une image
- dans une autre image de destination. <parameter>dst_im</parameter> est l'image
- de destination, <parameter>src_im</parameter> est l'image source. Si les
dimensions
- de la source et de la destination ne sont pas égales, un
- étirement adéquat est effectué pour faire correspondre
- les deux. Les coordonnées fournies se repère par rapport
- au coin supérieur gauche. Cete fonction peut être
- utilisée pour recopier des régions à l'intérieur
- d'une même image, si <parameter>dst_im</parameter> et
- <parameter>src_im</parameter> sont identiques : mais si les
- régions se chevauchent, le résultat risque d'être
- incohérent.
+ <function>imagecopymerge</function> a été ajoutée en PHP
+4.0.6.
</para>
- </refsect1>
- </refentry>
- <refentry id="function.imagecreate">
- <refnamediv>
- <refname>ImageCreate</refname>
- <refpurpose>Crée une nouvelle image.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>resource <function>imagecreate</function></funcdef>
- <paramdef>int <parameter>x_size</parameter></paramdef>
- <paramdef>int <parameter>y_size</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
+ </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>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagecopymergegray</function> </funcdef>
+ <paramdef>resource <parameter>dst_im</parameter> </paramdef>
+ <paramdef>resource <parameter>src_im</parameter> </paramdef>
+ <paramdef>int <parameter>dst_x</parameter> </paramdef>
+ <paramdef>int <parameter>dst_y</parameter> </paramdef>
+ <paramdef>int <parameter>src_x</parameter> </paramdef>
+ <paramdef>int <parameter>src_y</parameter> </paramdef>
+ <paramdef>int <parameter>src_w</parameter> </paramdef>
+ <paramdef>int <parameter>src_h</parameter> </paramdef>
+ <paramdef>int <parameter>pct</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecopymergegray</function> copie une partie de
+ l'image <parameter>src_im</parameter> dans l'image de destination
+ <parameter>dst_im</parameter> commencant 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>imagecreate</function> retourne un identifiant d'image
- représentant une image vide, de largeur <parameter>x_size</parameter>
- et longueur <parameter>y_size</parameter>.
+ <function>imagecopymergegray</function> a été ajoutée en
+PHP 4.0.6.
</para>
- </refsect1>
- </refentry>
- <refentry id="function.imagecreatefromgif">
- <refnamediv>
- <refname>imagecreatefromgif</refname>
- <refpurpose>
- Crée une nouvelle image à partir d'un fichier ou d'une URL.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>resource <function>imagecreatefromgif</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
+ </note>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecopyresized">
+ <refnamediv>
+ <refname>ImageCopyResized</refname>
+ <refpurpose>Copie et redimensionne une partie d'une image.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagecopyresized</function></funcdef>
+ <paramdef>resource <parameter>dst_im</parameter></paramdef>
+ <paramdef>resource <parameter>src_im</parameter></paramdef>
+ <paramdef>int <parameter>dstX</parameter></paramdef>
+ <paramdef>int <parameter>dstY</parameter></paramdef>
+ <paramdef>int <parameter>srcX</parameter></paramdef>
+ <paramdef>int <parameter>srcY</parameter></paramdef>
+ <paramdef>int <parameter>dstW</parameter></paramdef>
+ <paramdef>int <parameter>dstH</parameter></paramdef>
+ <paramdef>int <parameter>srcW</parameter></paramdef>
+ <paramdef>int <parameter>srcH</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecopyresized</function> copie une partie rectangulaire d'une image
+ dans une autre image de destination. <parameter>dst_im</parameter> est l'image
+ de destination, <parameter>src_im</parameter> est l'image source. Si les
+dimensions
+ de la source et de la destination ne sont pas égales, un
+ étirement adéquat est effectué pour faire correspondre
+ les deux. Les coordonnées fournies se repère par rapport
+ au coin supérieur gauche. Cete fonction peut être
+ utilisée pour recopier des régions à l'intérieur
+ d'une même image, si <parameter>dst_im</parameter> et
+ <parameter>src_im</parameter> sont identiques : mais si les
+ régions se chevauchent, le résultat risque d'être
+ incohérent.
+ </para>
+ <para>
+ Voir aussi
+ <function>imagecopyresampled</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecopyresampled">
+ <refnamediv>
+ <refname>ImageCopyResampled</refname>
+ <refpurpose>Copie, redimensionne, rééchantillonne une
+image</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagecopyresampled</function></funcdef>
+ <paramdef>resource <parameter>dst_im</parameter></paramdef>
+ <paramdef>resource <parameter>src_im</parameter></paramdef>
+ <paramdef>int <parameter>dstX</parameter></paramdef>
+ <paramdef>int <parameter>dstY</parameter></paramdef>
+ <paramdef>int <parameter>srcX</parameter></paramdef>
+ <paramdef>int <parameter>srcY</parameter></paramdef>
+ <paramdef>int <parameter>dstW</parameter></paramdef>
+ <paramdef>int <parameter>dstH</parameter></paramdef>
+ <paramdef>int <parameter>srcW</parameter></paramdef>
+ <paramdef>int <parameter>srcH</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecopyresampled</function> copie une zone
+ rectangulaire de l'image <parameter>src_im</parameter> vers
+ l'image <parameter>src_im</parameter>. Durant la copie,
+ la zone est rééchantillonnée de manière à
+conserver la clarté
+ de l'image durant une réduction.
+ <parameter>Dst_im</parameter> est l'image de destination,
+ <parameter>src_im</parameter> est l'image source.
+ Si les coordonnées, hauteurs et largeur des source et destinations
+ diffèrent, l'image copié sera étiré de manière
+appropriée.
+ Les coordonnées sont celles du coin supérieur gauche.
+ <function>imagecopyresampled</function> peut servir à copier
+ des zones d'une image vers elle-même, mais si les régions se
+ chevauchent, les résultats sont imprévisibles.
+ </para>
+ <para>
+ Voir aussi
+ <function>imagecopyresized</function>.
+ </para>
+ <note>
<para>
- <function>imagecreatefromgif</function> retourne un identifiant d'image qui
- représente l'image obtenue à partir du fichier dont le nom est
- donné.
+ <function>imagecopyresampled</function> a été ajoutée en
+PHP 4.0.6
+ et nécessite GD 2.0.1.
</para>
- <para>
- <function>imagecreatefromgif</function> retourne une chaîne vide en
- cas d'échec. Il va aussi retourner une erreur qui va afficher un
- lien brisé dans un navigateur. Pour simplifier le débuggage,
- utilisez le code suivant, qui retourne une erreur <acronym>GIF</acronym> :
+ </note>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecreate">
+ <refnamediv>
+ <refname>ImageCreate</refname>
+ <refpurpose>Crée une nouvelle image à palette.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>resource <function>imagecreate</function></funcdef>
+ <paramdef>int <parameter>x_size</parameter></paramdef>
+ <paramdef>int <parameter>y_size</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecreatefromgif">
+ <refnamediv>
+ <refname>imagecreatefromgif</refname>
+ <refpurpose>
+ Crée une nouvelle image à partir d'un fichier ou d'une URL.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>resource <function>imagecreatefromgif</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecreatefromgif</function> retourne un identifiant d'image qui
+ représente l'image obtenue à partir du fichier dont le nom est
+ donné.
+ </para>
+ <para>
+ <function>imagecreatefromgif</function> retourne une chaîne vide en
+ cas d'échec. Il va aussi retourner une erreur qui va afficher un
+ lien brisé dans un navigateur. Pour simplifier le débuggage,
+ utilisez le code suivant, qui retourne une erreur <acronym>GIF</acronym> :
<example>
<title>
- Exemple de gestion des erreurs durant création d'image
- (grâcieusement offert par [EMAIL PROTECTED] )
+ Exemple de gestion des erreurs durant création d'image
+ (grâcieusement offert par [EMAIL PROTECTED] )
</title>
<programlisting role="php">
<?php
@@ -701,38 +1133,108 @@
</para>
</refsect1>
</refentry>
- <refentry id="function.imagecreatefromjpeg">
- <refnamediv>
- <refname>ImageCreateFromJPEG</refname>
- <refpurpose>
- Crée une nouvelle image <acronym>JPEG</acronym>
- à partir d'un fichier ou d'une URL
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>resource <function>imagecreatefromjpeg</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
+ <refentry id="function.imagecreatetruecolor">
+ <refnamediv>
+ <refname>ImageCreateTrueColor</refname>
+ <refpurpose>Crée une nouvelle image en vraies couleurs</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>resource <function>imagecreatetruecolor</function></funcdef>
+ <paramdef>int <parameter>x_size</parameter></paramdef>
+ <paramdef>int <parameter>y_size</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecreatetruecolor</function> retourne une resource
+ représentant une image noire de largeur <parameter>x_size</parameter>,
+ et de hauteur <parameter>y_size</parameter>.
+ </para>
+ <note>
<para>
- <function>imagecreatefromjpeg</function> retourne un identifiant d'image
- représentant un image obtenu à partir du fichier
- <parameter>filename</parameter>.
+ <function>imagecreatetruecolor</function> a été ajoutée en
+PHP 4.0.6
+ et nécessite GD 2.0.1.
</para>
+ </note>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagetruecolortopalette">
+ <refnamediv>
+ <refname>ImageTrueColorToPalette</refname>
+ <refpurpose>Convertit une image en vraies couleur en image à
+palette</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>imagetruecolortopalette</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>bool <parameter>dither</parameter></paramdef>
+ <paramdef>int <parameter>ncolors</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagetruecolortopalette</function> convertit l'image
+ en vraies couleurs <parameter>im</parameter> en image à palette.
+ Le code de cette fonction est directement tiré de la librairie du
+ "Independent JPEG Group", qui est tout simplement génial. Le code a
+ été modifié pour préserver l'essentiel du canal alph
+dans la nouvelle
+ palette, en plus de conserver les couleurs du mieux possible. Mais
+ cela ne fonctionne pas toujours comme voulu. Il est alors préférable
+ de générer un résultat en vraies couleurs, ce qui a toujours
+le
+ meilleur rendu.
+ </para>
+ <para>
+ Si <parameter>dither</parameter> vaut <literal>TRUE</literal>, cela
+ indique que l'image doit être ditherée : l'image sera un peu plus
+ granuleuse, mais l'approximation des couleurs sera meilleure.
+ </para>
+ <para>
+ <parameter>ncolors</parameter> est le nombre maximal de couleur dans la
+ palette finale.
+ </para>
+ <note>
<para>
- <function>imagecreatefromjpeg</function> retourne une chaîne vide en cas
- d'échec. Elle affiche aussi un message d'erreur, qui s'affiche comme un
- lien brisé dans un navigateur web. Pour faciliter le débuggage,
- voici une erreur <acronym>JPEG</acronym>:
+ <function>imagetruecolortopalette</function> a été ajoutée
+en PHP 4.0.6
+ et nécessite GD 2.0.1.
+ </para>
+ </note>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecreatefromjpeg">
+ <refnamediv>
+ <refname>ImageCreateFromJPEG</refname>
+ <refpurpose>
+ Crée une nouvelle image <acronym>JPEG</acronym>
+ à partir d'un fichier ou d'une URL
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>resource <function>imagecreatefromjpeg</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecreatefromjpeg</function> retourne un identifiant d'image
+ représentant un image obtenu à partir du fichier
+ <parameter>filename</parameter>.
+ </para>
+ <para>
+ <function>imagecreatefromjpeg</function> retourne une chaîne vide en cas
+ d'échec. Elle affiche aussi un message d'erreur, qui s'affiche comme un
+ lien brisé dans un navigateur web. Pour faciliter le débuggage,
+ voici une erreur <acronym>JPEG</acronym>:
<example>
<title>
- Exemple de gestion d'erreur lors de la création d'image
- (grâcieusement offert par [EMAIL PROTECTED] )
- </title>
- <programlisting role="php">
+ Exemple de gestion d'erreur lors de la création d'image
+ (grâcieusement offert par [EMAIL PROTECTED] )
+ </title>
+ <programlisting role="php">
<?php
function loadjpeg($imgname) {
$im = @imagecreatefromjpeg($imgname); /* Tentative d'ouverture */
@@ -747,43 +1249,43 @@
return $im;
}
?>
- </programlisting>
- </example>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagecreatefrompng">
- <refnamediv>
- <refname>ImageCreateFromPNG</refname>
- <refpurpose>
- Crée une nouvelle image <acronym>PNG</acronym> à
- partir d'un fichier ou d'une URL
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>resource <function>imagecreatefrompng</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagecreatefrompng</function> retourne un identifiant d'image
- représentant un image obtenu à partir du fichier
- <parameter>filename</parameter>.
- </para>
- <para>
- <function>imagecreatefromjpeg</function> retourne une chaîne vide en cas
- d'échec. Elle affiche aussi un message d'erreur, qui s'affiche comme un
- lien brisé dans un navigateur web. Pour faciliter le débuggage,
- voici une erreur <acronym>PNG</acronym>:
- <example>
- <title>
- Exemple de gestion d'erreur lors de la création d'image
- (grâcieusement offert par [EMAIL PROTECTED] )
- </title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecreatefrompng">
+ <refnamediv>
+ <refname>ImageCreateFromPNG</refname>
+ <refpurpose>
+ Crée une nouvelle image <acronym>PNG</acronym> à
+ partir d'un fichier ou d'une URL
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>resource <function>imagecreatefrompng</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecreatefrompng</function> retourne un identifiant d'image
+ représentant un image obtenu à partir du fichier
+ <parameter>filename</parameter>.
+ </para>
+ <para>
+ <function>imagecreatefromjpeg</function> retourne une chaîne vide en cas
+ d'échec. Elle affiche aussi un message d'erreur, qui s'affiche comme un
+ lien brisé dans un navigateur web. Pour faciliter le débuggage,
+ voici une erreur <acronym>PNG</acronym>:
+ <example>
+ <title>
+ Exemple de gestion d'erreur lors de la création d'image
+ (grâcieusement offert par [EMAIL PROTECTED] )
+ </title>
+ <programlisting role="php">
<?php
function LoadPNG($imgname) {
$im = @imagecreatefrompng($imgname); /* Tentative d'ouverture */
@@ -798,39 +1300,39 @@
return $im;
}
?>
- </programlisting>
- </example>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagecreatefromwbmp">
- <refnamediv>
- <refname>ImageCreateFromWBMP</refname>
- <refpurpose>Crée une image depuis un fichier WBMP</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>resource <function>imagecreatefromwbmp</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagecreatefromwbmp</function> retourne une ressource d'image
- PHP, représentant l'image <parameter>filename</parameter>.
- </para>
- <para>
- <function>imagecreatefromwbmp</function> retourne une chaîne vide en
- cas d'erreur. Il retourne aussi un message d'erreur qui s'affiche
- comme un lien mort dans un navigateur. Pour aider au débuggage,
- l'exemple suivant va produire une erreur <acronym>WBMP</acronym>:
- <example>
- <title>
- Exemple de gestion des erreurs durant la création d'une image
- WBMP (grâcieusement proposé par [EMAIL PROTECTED])
- </title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecreatefromwbmp">
+ <refnamediv>
+ <refname>ImageCreateFromWBMP</refname>
+ <refpurpose>Crée une image depuis un fichier WBMP</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>resource <function>imagecreatefromwbmp</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecreatefromwbmp</function> retourne une ressource d'image
+ PHP, représentant l'image <parameter>filename</parameter>.
+ </para>
+ <para>
+ <function>imagecreatefromwbmp</function> retourne une chaîne vide en
+ cas d'erreur. Il retourne aussi un message d'erreur qui s'affiche
+ comme un lien mort dans un navigateur. Pour aider au débuggage,
+ l'exemple suivant va produire une erreur <acronym>WBMP</acronym>:
+ <example>
+ <title>
+ Exemple de gestion des erreurs durant la création d'une image
+ WBMP (grâcieusement proposé par [EMAIL PROTECTED])
+ </title>
+ <programlisting role="php">
function loadwbmp($imgname) {
$im = @imagecreatefromwbmp($imgname); /* Tentative d'ouverture */
if (!$im) { /* Vérification que cela s'est bien passé */
@@ -843,277 +1345,277 @@
}
return $im;
}
- </programlisting>
- </example>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagecreatefromstring">
- <refnamediv>
- <refname>ImageCreateFromString</refname>
- <refpurpose>Crée une image à partir d'une chaîne</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>resource <function>imagecreatefromstring</function></funcdef>
- <paramdef>string <parameter>string</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagecreatefromstring</function> retourne un identifiant
- d'image représentant la chaîne <parameter>string</parameter>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagedashedline">
- <refnamediv>
- <refname>ImageDashedLine</refname>
- <refpurpose>Dessine une ligne pointillée.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagedashedline</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>int <parameter>x1</parameter></paramdef>
- <paramdef>int <parameter>y1</parameter></paramdef>
- <paramdef>int <parameter>x2</parameter></paramdef>
- <paramdef>int <parameter>y2</parameter></paramdef>
- <paramdef>int <parameter>col</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagedashedline</function> dessine une ligne pointillée
- entre les points (<parameter>x1</parameter>,<parameter>y1</parameter>)
- et (<parameter>x2</parameter>,<parameter>y2</parameter>) (le coin
- supérieur droit est l'origine (0,0)) dans l'image
- <parameter>im</parameter>, avec la couleur <parameter>col</parameter>.
- </para>
- <para>
- Voir aussi <function>imageline</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagedestroy">
- <refnamediv>
- <refname>ImageDestroy</refname>
- <refpurpose>détruit une image.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagedestroy</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagedestroy</function> libère toute la mémoire
- associée avec l'image <parameter>im</parameter>.
- <parameter>im</parameter> est un identifiant d'image valide retourné
- par <function>imagecreate</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagefill">
- <refnamediv>
- <refname>ImageFill</refname>
- <refpurpose>Remplit.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagefill</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>int <parameter>x</parameter></paramdef>
- <paramdef>int <parameter>y</parameter></paramdef>
- <paramdef>int <parameter>col</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagefill</function> effectue un remplissage avec la couleur
- <parameter>col</parameter>, dans l'image <parameter>im</parameter>,
- à partir du point de coordonnées (<parameter>x</parameter>,
- <parameter>y</parameter>) (le coin supérieur gauche est
- l'origine (0,0)).
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagefilledpolygon">
- <refnamediv>
- <refname>ImageFilledPolygon</refname>
- <refpurpose>Dessine un polygone rempli.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagefilledpolygon</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>array <parameter>points</parameter></paramdef>
- <paramdef>int <parameter>num_points</parameter></paramdef>
- <paramdef>int <parameter>col</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagefilledpolygon</function> dessine un polygone rempli dans l'image
- <parameter>im</parameter>. <parameter>points</parameter> est un tableau PHP qui
- contient les sommets des polygones sous la forme :. points[0] = x0,
- points[1] = y0, points[2] = x1, points[3] = y1, etc.
<parameter>num_points</parameter>
- est le nombre total de sommets.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagefilledrectangle">
- <refnamediv>
- <refname>ImageFilledRectangle</refname>
- <refpurpose>Dessine un rectangle rempli.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagefilledrectangle</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>int <parameter>x1</parameter></paramdef>
- <paramdef>int <parameter>y1</parameter></paramdef>
- <paramdef>int <parameter>x2</parameter></paramdef>
- <paramdef>int <parameter>y2</parameter></paramdef>
- <paramdef>int <parameter>col</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagefilledrectangle</function> dessine un rectangle de
- couleur <parameter>col</parameter> dans l'image <parameter>im</parameter>,
- en commencant par le sommet supérieur gauche (<parameter>x1</parameter>,
- <parameter>y1</parameter>) et finissant au sommet inférieur droit
- (<parameter>x2</parameter>, <parameter>y2</parameter>). Le coin supérieur
- gauche est l'origine (0, 0).
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagefilltoborder">
- <refnamediv>
- <refname>ImageFillToBorder</refname>
- <refpurpose>Remplit avec une région avec une couleur
spécifique.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagefilltoborder</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>int <parameter>x</parameter></paramdef>
- <paramdef>int <parameter>y</parameter></paramdef>
- <paramdef>int <parameter>border</parameter></paramdef>
- <paramdef>int <parameter>col</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagefilltoborder</function> remplit avec la couleur
<parameter>col</parameter>
- toute la région à l'intérieur de la région
limitée par la couleur
- <parameter>border</parameter>. Le point de départ est
- (<parameter>x</parameter>,<parameter>y</parameter>)
- (le coin supérieur gauche est l'origine (0,0)).
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagefontheight">
- <refnamediv>
- <refname>ImageFontHeight</refname>
- <refpurpose>Retourne la hauteur de la police.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagefontheight</function></funcdef>
- <paramdef>resource <parameter>font</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagefontheight</function> retourne la hauteur de la police
- <parameter>font</parameter>en pixel.
- </para>
- <para>
- Voir aussi
- <function>imagefontwidth</function> et
- <function>imageloadfont</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagefontwidth">
- <refnamediv>
- <refname>ImageFontWidth</refname>
- <refpurpose>Retourne la largeur de la police.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagefontwidth</function></funcdef>
- <paramdef>resource <parameter>font</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagefontwidth</function> retourne la largeur de la police
- <parameter>font</parameter> en pixels.
- </para>
- <para>
- Voir aussi
- <function>imagefontheight</function> et
- <function>imageloadfont</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagegif">
- <refnamediv>
- <refname>ImageGif</refname>
- <refpurpose>Envoie une image GIF vers un navigateur ou un fichier.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagegif</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagegif</function> crée un fichier image
<acronym>GIF</acronym> avec le nom
- <parameter>filename</parameter> d'après l'image <parameter>im</parameter>.
- L'argument <parameter>im</parameter> est un identifiant valide retourné
par la
- fonction <function>imagecreate</function>.
- </para>
- <para>
- Le format de l'image sera GIF87a à moins que l'image n'ai une couleur
transparente
- (mise en place grâce à la fonction
<function>imagecolortransparent</function>)),
- ce qui fera qu'elle sera au format GIF89a.
- </para>
- <para>
- Le nom du fichier est optionnel, et dans ce cas, l'image sera transmise
- directement à la sortie standard. En envoyant une image de type
- <literal>image/gifcontent-type</literal> , (grâce à la fonction
- <function>header</function>), vous pouvez créer des images avec
- des scripts PHP.
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagecreatefromstring">
+ <refnamediv>
+ <refname>ImageCreateFromString</refname>
+ <refpurpose>Crée une image à partir d'une chaîne</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>resource <function>imagecreatefromstring</function></funcdef>
+ <paramdef>string <parameter>string</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagecreatefromstring</function> retourne un identifiant
+ d'image représentant la chaîne <parameter>string</parameter>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagedashedline">
+ <refnamediv>
+ <refname>ImageDashedLine</refname>
+ <refpurpose>Dessine une ligne pointillée.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagedashedline</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>x1</parameter></paramdef>
+ <paramdef>int <parameter>y1</parameter></paramdef>
+ <paramdef>int <parameter>x2</parameter></paramdef>
+ <paramdef>int <parameter>y2</parameter></paramdef>
+ <paramdef>int <parameter>col</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagedashedline</function> dessine une ligne pointillée
+ entre les points (<parameter>x1</parameter>,<parameter>y1</parameter>)
+ et (<parameter>x2</parameter>,<parameter>y2</parameter>) (le coin
+ supérieur droit est l'origine (0,0)) dans l'image
+ <parameter>im</parameter>, avec la couleur <parameter>col</parameter>.
+ </para>
+ <para>
+ Voir aussi <function>imageline</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagedestroy">
+ <refnamediv>
+ <refname>ImageDestroy</refname>
+ <refpurpose>détruit une image.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagedestroy</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagedestroy</function> libère toute la mémoire
+ associée avec l'image <parameter>im</parameter>.
+ <parameter>im</parameter> est un identifiant d'image valide retourné
+ par <function>imagecreate</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagefill">
+ <refnamediv>
+ <refname>ImageFill</refname>
+ <refpurpose>Remplit.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagefill</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>x</parameter></paramdef>
+ <paramdef>int <parameter>y</parameter></paramdef>
+ <paramdef>int <parameter>col</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagefill</function> effectue un remplissage avec la couleur
+ <parameter>col</parameter>, dans l'image <parameter>im</parameter>,
+ à partir du point de coordonnées (<parameter>x</parameter>,
+ <parameter>y</parameter>) (le coin supérieur gauche est
+ l'origine (0,0)).
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagefilledpolygon">
+ <refnamediv>
+ <refname>ImageFilledPolygon</refname>
+ <refpurpose>Dessine un polygone rempli.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagefilledpolygon</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>array <parameter>points</parameter></paramdef>
+ <paramdef>int <parameter>num_points</parameter></paramdef>
+ <paramdef>int <parameter>col</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagefilledpolygon</function> dessine un polygone rempli dans l'image
+ <parameter>im</parameter>. <parameter>points</parameter> est un tableau PHP qui
+ contient les sommets des polygones sous la forme :. points[0] = x0,
+ points[1] = y0, points[2] = x1, points[3] = y1, etc.
+<parameter>num_points</parameter>
+ est le nombre total de sommets.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagefilledrectangle">
+ <refnamediv>
+ <refname>ImageFilledRectangle</refname>
+ <refpurpose>Dessine un rectangle rempli.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagefilledrectangle</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>x1</parameter></paramdef>
+ <paramdef>int <parameter>y1</parameter></paramdef>
+ <paramdef>int <parameter>x2</parameter></paramdef>
+ <paramdef>int <parameter>y2</parameter></paramdef>
+ <paramdef>int <parameter>col</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagefilledrectangle</function> dessine un rectangle de
+ couleur <parameter>col</parameter> dans l'image <parameter>im</parameter>,
+ en commençant par le sommet supérieur gauche
+(<parameter>x1</parameter>,
+ <parameter>y1</parameter>) et finissant au sommet inférieur droit
+ (<parameter>x2</parameter>, <parameter>y2</parameter>). Le coin supérieur
+ gauche est l'origine (0, 0).
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagefilltoborder">
+ <refnamediv>
+ <refname>ImageFillToBorder</refname>
+ <refpurpose>Remplit avec une région avec une couleur
+spécifique.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagefilltoborder</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>x</parameter></paramdef>
+ <paramdef>int <parameter>y</parameter></paramdef>
+ <paramdef>int <parameter>border</parameter></paramdef>
+ <paramdef>int <parameter>col</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagefilltoborder</function> remplit avec la couleur
+<parameter>col</parameter>
+ toute la région à l'intérieur de la région
+limitée par la couleur
+ <parameter>border</parameter>. Le point de départ est
+ (<parameter>x</parameter>,<parameter>y</parameter>)
+ (le coin supérieur gauche est l'origine (0,0)).
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagefontheight">
+ <refnamediv>
+ <refname>ImageFontHeight</refname>
+ <refpurpose>Retourne la hauteur de la police.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagefontheight</function></funcdef>
+ <paramdef>resource <parameter>font</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagefontheight</function> retourne la hauteur de la police
+ <parameter>font</parameter>en pixel.
+ </para>
+ <para>
+ Voir aussi
+ <function>imagefontwidth</function> et
+ <function>imageloadfont</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagefontwidth">
+ <refnamediv>
+ <refname>ImageFontWidth</refname>
+ <refpurpose>Retourne la largeur de la police.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagefontwidth</function></funcdef>
+ <paramdef>resource <parameter>font</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagefontwidth</function> retourne la largeur de la police
+ <parameter>font</parameter> en pixels.
+ </para>
+ <para>
+ Voir aussi
+ <function>imagefontheight</function> et
+ <function>imageloadfont</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagegif">
+ <refnamediv>
+ <refname>ImageGif</refname>
+ <refpurpose>Envoie une image GIF vers un navigateur ou un fichier.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagegif</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagegif</function> crée un fichier image <acronym>GIF</acronym>
+avec le nom
+ <parameter>filename</parameter> d'après l'image <parameter>im</parameter>.
+ L'argument <parameter>im</parameter> est un identifiant valide retourné
+par la
+ fonction <function>imagecreate</function>.
+ </para>
+ <para>
+ Le format de l'image sera GIF87a à moins que l'image n'ai une couleur
+transparente
+ (mise en place grâce à la fonction
+<function>imagecolortransparent</function>)),
+ ce qui fera qu'elle sera au format GIF89a.
+ </para>
+ <para>
+ Le nom du fichier est optionnel, et dans ce cas, l'image sera transmise
+ directement à la sortie standard. En envoyant une image de type
+ <literal>image/gifcontent-type</literal> , (grâce à la fonction
+ <function>header</function>), vous pouvez créer des images avec
+ des scripts PHP.
<note>
<para>
- Etant donné que toutes les fonctions <acronym>GIF</acronym> ont
été
- supprimées de la bibliothèque GD version 1.6, cette fonction
- ne sera pas accessible si vous avez cette version de la librairie.
+ Etant donné que toutes les fonctions <acronym>GIF</acronym> ont
+été
+ supprimées de la bibliothèque GD version 1.6, cette fonction
+ ne sera pas accessible si vous avez cette version de la librairie.
</para>
<para>
- Le code suivant vous permet d'écrire des scripts PHP plus portables :
- le type de GD est automatiquement détecté. Il remplace la
- séquence <literal>Header("Content-type: image/gif");
ImageGif($im);</literal>
- par un code plus souple :
- <informalexample>
- <programlisting role="php">
+ Le code suivant vous permet d'écrire des scripts PHP plus portables :
+ le type de GD est automatiquement détecté. Il remplace la
+ séquence <literal>Header("Content-type: image/gif");
+ImageGif($im);</literal>
+ par un code plus souple :
+ <informalexample>
+ <programlisting role="php">
<?php
if (function_exists("imagegif")) {
header("Content-type: image/gif");
@@ -1132,18 +1634,18 @@
} else
die("Pas de support graphique avec PHP sur ce serveur");
?>
- </programlisting>
- </informalexample>
- </para>
+ </programlisting>
+ </informalexample>
+ </para>
</note>
- <note>
- <para>
- En PHP 4, à partir de la version 4.0.2, vous pouvez utiliser la fonction
- <function>imagetypes</function> à la place de
- <function>function_exists</function> pour vérifier que certains
- formats d'images sont supportés :
- <informalexample>
- <programlisting role="php">
+ <note>
+ <para>
+ En PHP 4, à partir de la version 4.0.2, vous pouvez utiliser la fonction
+ <function>imagetypes</function> à la place de
+ <function>function_exists</function> pour vérifier que certains
+ formats d'images sont supportés :
+ <informalexample>
+ <programlisting role="php">
<?php
if (function_exists("imagegif")) {
header("Content-type: image/gif");
@@ -1162,1009 +1664,1124 @@
} else
die("Pas de support graphique avec PHP sur ce serveur");
?>
- </programlisting>
- </informalexample>
- </para>
- </note>
+ </programlisting>
+ </informalexample>
</para>
- <para>
- Voir aussi <function>imagepng</function>, <function>imagewbmp</function>,
- <function>imagejpeg</function>, <function>imagetypes</function>.
- </para>
- </refsect1>
- </refentry>
-<refentry id="function.imagepng">
- <refnamediv>
- <refname>ImagePNG</refname>
- <refpurpose>
- Envoie une image PNG vers un navigateur ou un fichier.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagepng</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>string
<parameter><optional>filename</optional></parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagepng</function> envoie l'image GD (<parameter>im</parameter>)
- au format <acronym>PNG</acronym> sur la sortie standard (typiquement,
- le navigateur web), ou si <parameter>filename</parameter> est fourni,
- l'envoie dans un fichier.
- <informalexample>
- <programlisting role="php">
+ </note>
+ </para>
+ <para>
+ Voir aussi <function>imagepng</function>, <function>imagewbmp</function>,
+ <function>imagejpeg</function>, <function>imagetypes</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagepng">
+ <refnamediv>
+ <refname>ImagePNG</refname>
+ <refpurpose>
+ Envoie une image PNG vers un navigateur ou un fichier.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagepng</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>string <parameter><optional>filename</optional></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagepng</function> envoie l'image GD (<parameter>im</parameter>)
+ au format <acronym>PNG</acronym> sur la sortie standard (typiquement,
+ le navigateur web), ou si <parameter>filename</parameter> est fourni,
+ l'envoie dans un fichier.
+ <informalexample>
+ <programlisting role="php">
<?php
$im = imagecreatefrompng("test.png");
imagepng($im);
?>
- </programlisting>
- </informalexample>
- </para>
- <para>
- Le nom du fichier est optionnel, et dans ce cas, l'image sera transmise
- directement à la sortie standard. En envoyant une image de type
- <literal>image/png content-type</literal> (grâce à la fonction
- <function>header</function>), vous pouvez créer des images
- <acronym>PNG</acronym> avec des scripts PHP.
- </para>
- <para>
- Voir aussi <function>imagegif</function>, <function>imagewbmp</function>,
- <function>imagejpeg</function>, <function>imagetypes</function>.
- </para>
- </refsect1>
- </refentry>
-<refentry id="function.imagejpeg">
- <refnamediv>
- <refname>ImageJPEG</refname>
- <refpurpose>
- Envoie une image JPEG vers un navigateur ou un fichier.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagejpeg</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>string
- <parameter><optional>filename</optional></parameter>
- </paramdef>
- <paramdef>int
- <parameter><optional>quality</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagejpeg</function> envoie l'image GD (<parameter>im</parameter>)
- au format <acronym>JPEG</acronym> sur la sortie standard (typiquement,
- le navigateur web), ou si <parameter>filename</parameter> est fourni,
- l'envoi dans un fichier. <parameter>im</parameter> a été
- créé par <function>imagecreate</function>.
- </para>
- <para>
- Le nom du fichier est optionnel, et dans ce cas, l'image sera transmise
- directement à la sortie standard. En envoyant une image de type
- <literal>image/jpeg content-type</literal> (grâce à la fonction
- <function>header</function>), vous pouvez créer des images
- <acronym>JPEG</acronym> avec des scripts PHP.
- </para>
- <note>
- <para>
- Le support <acronym>JPEG</acronym> n'est disponible que si PHP est
compilé
- avec GD-1.8 ou plus récent.
- </para>
- </note>
- <para>
- Voir aussi <function>imagepng</function>, <function>imagewbmp</function>,
- <function>imagegif</function>, <function>imagetypes</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagewbmp">
- <refnamediv>
- <refname>ImageWBMP</refname>
- <refpurpose>Affiche une image WBMP</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagewbmp</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>string
- <parameter><optional>filename</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagewbmp</function> crée l'image <acronym>WBMP</acronym>
- dans le fichier <parameter>filename</parameter>, à partir de l'image
- <parameter>im</parameter>. Le paramètre <parameter>im</parameter>
- a été créé avec la fonction
<function>imagecreate</function>.
- </para>
+ </programlisting>
+ </informalexample>
+ </para>
+ <para>
+ Le nom du fichier est optionnel, et dans ce cas, l'image sera transmise
+ directement à la sortie standard. En envoyant une image de type
+ <literal>image/png content-type</literal> (grâce à la fonction
+ <function>header</function>), vous pouvez créer des images
+ <acronym>PNG</acronym> avec des scripts PHP.
+ </para>
+ <para>
+ Voir aussi <function>imagegif</function>, <function>imagewbmp</function>,
+ <function>imagejpeg</function>, <function>imagetypes</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagejpeg">
+ <refnamediv>
+ <refname>ImageJPEG</refname>
+ <refpurpose>
+ Envoie une image JPEG vers un navigateur ou un fichier.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagejpeg</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>string
+ <parameter><optional>filename</optional></parameter>
+ </paramdef>
+ <paramdef>int
+ <parameter><optional>quality</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagejpeg</function> envoie l'image GD (<parameter>im</parameter>)
+ au format <acronym>JPEG</acronym> sur la sortie standard (typiquement,
+ le navigateur web), ou si <parameter>filename</parameter> est fourni,
+ l'envoi dans un fichier. <parameter>im</parameter> a été
+ créé par <function>imagecreate</function>.
+ </para>
+ <para>
+ Le nom du fichier est optionnel, et dans ce cas, l'image sera transmise
+ directement à la sortie standard. En envoyant une image de type
+ <literal>image/jpeg content-type</literal> (grâce à la fonction
+ <function>header</function>), vous pouvez créer des images
+ <acronym>JPEG</acronym> avec des scripts PHP.
+ </para>
+ <note>
<para>
- <parameter>filename</parameter> est optionnel, et s'il est omis,
- l'image sera envoyée directement au client. En placant l'entête
- <acronym>image/vnd.wap.wbmp</acronym>, dans le champs "content-type",
- vous pourrez afficher une image <acronym>WBMP</acronym>.
- <note>
- <para>
- Le support WBMP n'est disponible que si PHP a été compilé
- avec GD-1.8 ou plus récent.
- </para>
- </note>
+ Le support <acronym>JPEG</acronym> n'est disponible que si PHP est compilé
+ avec GD-1.8 ou plus récent.
</para>
+ </note>
+ <para>
+ Voir aussi
+ <function>imagepng</function>,
+ <function>imagewbmp</function>,
+ <function>imagegif</function> et
+ <function>imagetypes</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagewbmp">
+ <refnamediv>
+ <refname>ImageWBMP</refname>
+ <refpurpose>Affiche une image WBMP</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagewbmp</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>string
+ <parameter><optional>filename</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagewbmp</function> crée l'image <acronym>WBMP</acronym>
+ dans le fichier <parameter>filename</parameter>, à partir de l'image
+ <parameter>im</parameter>. Le paramètre <parameter>im</parameter>
+ a été créé avec la fonction
+<function>imagecreate</function>.
+ </para>
+ <para>
+ <parameter>filename</parameter> est optionnel, et s'il est omis,
+ l'image sera envoyée directement au client. En placant l'entête
+ <acronym>image/vnd.wap.wbmp</acronym>, dans le champs "content-type",
+ vous pourrez afficher une image <acronym>WBMP</acronym>.
+ <note>
<para>
- Voir aussi <function>imagepng</function>, <function>imagegif</function>,
- <function>imagejpeg</function>, <function>imagetypes</function>.
+ Le support WBMP n'est disponible que si PHP a été compilé
+ avec GD-1.8 ou plus récent.
</para>
- </refsect1>
- </refentry>
- <refentry id="function.imageinterlace">
- <refnamediv>
- <refname>ImageInterlace</refname>
- <refpurpose>Active ou désactive l'entrelacement.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imageinterlace</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>int <parameter><optional>interlace</optional></parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imageinterlace</function> active ou désactive le bit
d'entrelacement.
- Si l'entrelacement est à 1, l'image <parameter>im</parameter> sera
- interlacée, et sinon, elle ne le sera pas.
- </para>
- <para>
- <function>imageinterlace</function> retourne l'état courant
- d'entrelacement de l'image.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imageline">
- <refnamediv>
- <refname>ImageLine</refname>
- <refpurpose>Draw a line.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imageline</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>int <parameter>x1</parameter></paramdef>
- <paramdef>int <parameter>y1</parameter></paramdef>
- <paramdef>int <parameter>x2</parameter></paramdef>
- <paramdef>int <parameter>y2</parameter></paramdef>
- <paramdef>int <parameter>col</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imageline</function> dessine une ligne depuis le point
- (<parameter>x1</parameter>,<parameter>y1</parameter>) jusqu'au point
- (<parameter>x2</parameter>,<parameter>y2</parameter>)
- (le coin supérieur gauche est l'origine (0,0)) dans l'image
<parameter>im</parameter>
- et avec la couleur <parameter>col</parameter>.
- </para>
- <para>
- Voir aussi <function>imagecreate</function> et
<function>imagecolorallocate</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imageloadfont">
- <refnamediv>
- <refname>ImageLoadFont</refname>
- <refpurpose>Charge une nouvelle police.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>resource <function>imageloadfont</function></funcdef>
- <paramdef>string <parameter>file</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imageloadfont</function> charge une nouvelle police utilisateur et
- retourne un identifiant sur cette police. Cet identifiant sera
- toujours supérieur à 5, pour éviter les
- conflits avec les polices standard PHP).
- </para>
- <para>
- Le format des polices dépend actuellement du système
- d'exploitation. Ce qui signifie qu'il vous faut générer
- des fichiers de polices pour la machine qui fait tourner PHP.
- </para>
- <para>
- <table>
- <title>Format de fichier de police.</title>
- <tgroup cols="3">
- <thead>
- <row>
- <entry>position</entry>
- <entry>Type de donnés C</entry>
- <entry>description</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>Octets 0-3</entry>
- <entry>int</entry>
- <entry>Nombre de caractères de la police</entry>
- </row>
- <row>
- <entry>Octets 4-7</entry>
- <entry>int</entry>
- <entry>
- Valeur du premier caractère de la police (souvent 32 pour espace)
- </entry>
- </row>
- <row>
- <entry>Octets 8-11</entry>
- <entry>int</entry>
- <entry>Largeur en pixel des caractères</entry>
- </row>
- <row>
- <entry>Octets 12-15</entry>
- <entry>int</entry>
- <entry>Hauteur en pixel des caractères</entry>
- </row>
- <row>
- <entry>Octets 16-</entry>
- <entry>char</entry>
- <entry>
- Tableau avec les données des caractères, un octet par pixel
pour chaque
- caractère, avec un total de (nombre_caractères*largeur*hauteur)
octets.
- </entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- </para>
- <para>
- Voir aussi
- <function>imagefontwidth</function> et
- <function>imagefontheight</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagepolygon">
- <refnamediv>
- <refname>ImagePolygon</refname>
- <refpurpose>Dessine un polygone.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagepolygon</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>array <parameter>points</parameter></paramdef>
- <paramdef>int <parameter>num_points</parameter></paramdef>
- <paramdef>int <parameter>col</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagepolygon</function> dessine un polygone dans l'image
- <parameter>im</parameter>. <parameter>points</parameter> est un tableau
- PHP qui contient les sommets du polygone sous la forme : points[0] = x0,
- points[1] = y0, points[2] = x1, points[3] = y1, etc. num_points est le
- nombre de sommets.
- </para>
- <para>
- Voir aussi <function>imagecreate</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagepsbbox">
- <refnamediv>
- <refname>ImagePSBBox</refname>
- <refpurpose>
- Retourne le rectangle entourant un texte et dessiné avec une
- police PostScript Type1.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>imagepsbbox</function></funcdef>
- <paramdef>string <parameter>text</parameter></paramdef>
- <paramdef>resource <parameter>font</parameter></paramdef>
- <paramdef>int <parameter>size</parameter></paramdef>
- <paramdef>int <parameter>space</parameter></paramdef>
- <paramdef>int <parameter>width</parameter></paramdef>
- <paramdef>float <parameter>angle</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <parameter>size</parameter> est exprimé en pixels.
- </para>
- <para>
- <parameter>space</parameter> permet de changer la valeur par
- défaut du charactère espace. Cette valeur est ajoutée
- lors des dessins, et donc, peut être négative.
- </para>
- <para>
- <parameter>tightness</parameter> permet de contrôler la
- quantité d'espace entre les caractères. Cette quantité
- est ajouté lors des dessins, et peut donc être négative.
- </para>
- <para>
- <parameter>angle</parameter> est en degrés.
- </para>
- <para>
- Les paramètres <parameter>space</parameter> et
- <parameter>tightness</parameter> sont exprimés en unité
- d'espacement de caractères, avec 1 unité vaut 1/1000 d'un
- em carré (NDT : kesako?).
- </para>
- <para>
- Les paramètres <parameter>space</parameter>,
- <parameter>tightness</parameter> et <parameter>angle</parameter> sont optionnels.
- </para>
- <para>
- Le rectangle entourant est calculé en utilisant les informations
- disponibles sur les tailles de caractères, et, malheureusement,
- ont tendance à être légèrement différents
- du résultat réel final. Si l'angle est de 0 degré,
- vous pouvez vous attendre à avoir besoin d'un rectangle d'au moins
- un pixel plus grand dans toutes les directions.
- </para>
- <para>
- <function>imagepsbbox</function> retourne un tableau contenant les
- éléments suivants :
- <informaltable>
- <tgroup cols="2">
- <tbody>
- <row>
- <entry>0</entry>
- <entry>Abscisse inférieure gauche</entry>
- </row>
- <row>
- <entry>1</entry>
- <entry>Ordonnée inférieure gauche</entry>
- </row>
- <row>
- <entry>2</entry>
- <entry>Abscisse supérieure droite</entry>
- </row>
- <row>
- <entry>3</entry>
- <entry>Ordonnée supérieure droite</entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </para>
- <para>
- Voir aussi <function>imagepstext</function>.
- </para>
- </refsect1>
- </refentry>
-<!-- The function in t1lib which this function uses seems to be buggy...
-Currently, just comment out everywhere in the docs and source until time
-permits to find a solution.
- <refentry id="function.imagepscopyfont">
- <refnamediv>
- <refname>imagepscopyfont</refname>
- <refpurpose>
- Fait une copie d'une police chargée pour modification ultérieure.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagepscopyfont</function></funcdef>
- <paramdef>int <parameter>fontindex</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Utilisez cette fonction si vous devez faire des modifications dans une polie,
comme
- par exemple l'extension ou la condensation, ou encore, modifier son vecteur
- d'encodage, tout en conservant l'original. Notez que la police que vous copiez
- doit être obtenue par <function>imagepsloadfont</function>, et non pas une
police
- qui a elle même été copiée. Vous pouvez aussi faire
des modifications avant de
- la copier.
- </para>
- <para>
- Si vous utilisez cette fonction, vous <emphasis>DEVEZ</emphasis> libérer
les polices
- obtenues vous même, et dans l'ordre inverse. Sinon, votre script sera
- <emphasis>suspendu</emphasis>.
- </para>
- <para>
- Si tout a bien été fait, un index valide de police sera
retourné, et pourra être
- utilisé ultérieurement. Sinon, la fonction retournera
<literal>FALSE</literal>, et affichera un
- message décrivant l'erreur.
- </para>
- <para>
- Voir aussi <function>imageploadpsfont</function>.
- </para>
- </refsect1>
- </refentry>
--->
- <refentry id="function.imagepsencodefont">
- <refnamediv>
- <refname>ImagePSEncodeFont</refname>
- <refpurpose>
- Change le codage vectoriel d'un caractère dans une police.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagepsencodefont</function></funcdef>
- <paramdef>resource <parameter>font</parameter></paramdef>
- <paramdef>string <parameter>encodingfile</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagepsencodefont</function> charge le codage vectoriel d'un
- caractère depuis un fichier et change le codage vectoriel de la
- police correspondante. Etant donné que les polices PostScript ne
- disposent pas des caractères au-delà de 127, vous aurez
- sûrement besoin de les changer sur vous utilisez une autre langue que
- l'anglais. Le format exact est décrit dans la documentation T1libs.
- T1lib est disponible en deux formes : IsoLatin1.enc et IsoLatin2.enc.
- </para>
- <para>
- Si vous commencez à utiliser cette fonction régulièrement,
- une meilleure solution est de définir un encodage, et de l'utiliser
- avec set ps.default_encoding dans <link linkend="configuration.file">le fichier
- de configuration</link> pour utiliser par défaut l'encodage correct.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagepsfreefont">
- <refnamediv>
- <refname>ImagePSFreeFont</refname>
- <refpurpose>
- Libère la mémoire occupée par une police PostScript Type 1.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void <function>imagepsfreefont</function></funcdef>
- <paramdef>resource <parameter>font</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Voir aussi <function>imagepsloadfont</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagepsloadfont">
- <refnamediv>
- <refname>ImagePSLoadFont</refname>
- <refpurpose>Charge une police PostScript Type 1 depuis un fichier.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>resource <function>imagepsloadfont</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Au cas oú tout a bien marché, un index de police
- va être retourné, et pourra être utilisé
- pour des opérations ultérieures. Sinon, la fonction
- retourne <literal>FALSE</literal> et affiche un message décrivant
- ce qui est erroné.
- </para>
- <para>
- Voir aussi
- <function>imagepsfreefont</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagepsextendfont">
- <refnamediv>
- <refname>ImagePsExtendFont</refname>
- <refpurpose>
- Etend ou condense une police de caractères
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>bool <function>imagepsextendfont</function></funcdef>
- <paramdef>resource <parameter>font</parameter></paramdef>
- <paramdef>double <parameter>extend</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagepsextendfont</function> étend ou condense la police
- de caractères <parameter>font</parameter>. Si la valeur de
- <parameter>extend</parameter> est inférieure à 1, ce sera une
- condensation.
- </para>
- </refsect1>
- </refentry>
-<refentry id="function.imagepsslantfont">
- <refnamediv>
- <refname>ImagePsSlantFont</refname>
- <refpurpose>
- Incline une police de caractères
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>bool <function>imagepsslantfont</function></funcdef>
- <paramdef>resource <parameter>font</parameter></paramdef>
- <paramdef>double <parameter>slant</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagepsslantfont</function> met en italique
- la police de caractères <parameter>font</parameter> avec
- le coefficient <parameter>slant</parameter>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagepstext">
- <refnamediv>
- <refname>ImagePSText</refname>
- <refpurpose>Dessine un texte sur une image avec une police PostScript
Type1.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>imagepstext</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>string <parameter>text</parameter></paramdef>
- <paramdef>resource <parameter>font</parameter></paramdef>
- <paramdef>int <parameter>size</parameter></paramdef>
- <paramdef>int <parameter>foreground</parameter></paramdef>
- <paramdef>int <parameter>background</parameter></paramdef>
- <paramdef>int <parameter>x</parameter></paramdef>
- <paramdef>int <parameter>y</parameter></paramdef>
- <paramdef>int <parameter>
- <optional>space</optional></parameter></paramdef>
- <paramdef>int <parameter>
- <optional>tightness</optional></parameter></paramdef>
- <paramdef>float <parameter>
- <optional>angle</optional></parameter></paramdef>
- <paramdef>int <parameter>
- <optional>antialias_steps</optional></parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <parameter>size</parameter> est exprimé en pixels.
- </para>
- <para>
- <parameter>foreground</parameter> est la couleur dans laquelle le texte va
- être dessiné. <parameter>background</parameter> est la couleur
d'anti aliasing.
- Aucun pixel avec la couleur <parameter>background</parameter> n'est
dessiné, ce
- qui fait que l'arrière plan n'a pas besoin d'être dans une couleur
fixe.
- </para>
- <para>
- Les coordonnées données (<parameter>x</parameter>,
- <parameter>y</parameter>) définissent l'origine du premier
- caractère (grossièrement, le coin inférieur
- gauche du caractère). Ceci est différent de la fonction
- <function>imagestring</function>, oú (x, y) définissait le
- coin supérieur gauche du premier caracètre. Reportez vous
- à la documentation PostScript pour avoir des détails à
- propos des polices et de leurs tailles.
- </para>
- <para>
- <parameter>space</parameter> permet de changer la taille par défaut
- du caractère d'espacement. Cette valeur peut être négative.
- </para>
- <para>
- <parameter>tightness</parameter> permet de contrôler la quantité
- d'espace entre deux caractères. Cette valeur peut être
- négative.
- </para>
- <para>
- <parameter>angle</parameter> est en degrés.
- </para>
- <para>
- <parameter>antialias_steps</parameter> permet de contrôler le nombre de
couleurs
- du texte anti-aliasé. Les valeurs autorisées sont 4 et 16. 16 est
recommandé pour
- les polices de moins de 20 pixels, car l'effet est alors visible. Avec les
- tailles plus grandes, utilisez de préférence 4, qui est moins
gourmande en
- ressources.
- </para>
- <para>
- Les paramètres <parameter>space</parameter> et
<parameter>tightness</parameter>
- sont exprimés en unité d'espace caractère, ce qui vaut
1/1000ème d'un em-carré
- ( ? ? ?).
- </para>
- <para>
- Les paramètres <parameter>space</parameter>,
<parameter>tightness</parameter>,
- <parameter>angle</parameter> et <parameter>antialias</parameter> sont
optionnels.
- </para>
- <para>
- <function>imagepstext</function> retourne un tableau contenant les
- éléments suivants :
- <informaltable>
- <tgroup cols="2">
- <tbody>
- <row>
- <entry>0</entry>
- <entry>Abscisse inférieure gauche</entry>
- </row>
- <row>
- <entry>1</entry>
- <entry>Ordonnée inférieure gauche</entry>
- </row>
- <row>
- <entry>2</entry>
- <entry>Abscisse supérieure droite</entry>
- </row>
- <row>
- <entry>3</entry>
- <entry>Ordonnée supérieure droite</entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </para>
- <para>
- Voir aussi <function>imagepsbbox</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagerectangle">
- <refnamediv>
- <refname>ImageRectangle</refname>
- <refpurpose>Dessine un rectangle.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagerectangle</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>int <parameter>x1</parameter></paramdef>
- <paramdef>int <parameter>y1</parameter></paramdef>
- <paramdef>int <parameter>x2</parameter></paramdef>
- <paramdef>int <parameter>y2</parameter></paramdef>
- <paramdef>int <parameter>col</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagerectangle</function> dessine un rectangle dans la couleur
- <parameter>col</parameter>, dans l'image <parameter>im</parameter>, et en
- commencant au point supérieur gauche (<parameter>x1</parameter>,
- <parameter>y1</parameter>), et en finissant au point inférieur droit
- (<parameter>x2</parameter>,<parameter>y2</parameter>). Le coin supérieur
- gauche est l'origine (0,0).
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagesetpixel">
- <refnamediv>
- <refname>ImageSetPixel</refname>
- <refpurpose>Dessine un pixel.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagesetpixel</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>int <parameter>x</parameter></paramdef>
- <paramdef>int <parameter>y</parameter></paramdef>
- <paramdef>int <parameter>col</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagesetpixel</function> dessine un pixel au point
- (<parameter>x</parameter>,<parameter>y</parameter>)
- (le coin supérieur gauche est l'origine (0,0)) dans l'image
<parameter>im</parameter>,
- et avec la couleur <parameter>col</parameter>.
- </para>
- <para>
- Voir aussi <function>imagecreate</function> et
<function>imagecolorallocate</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagestring">
- <refnamediv>
- <refname>ImageString</refname>
- <refpurpose>Dessine une chaîne horizontale.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagestring</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>int <parameter>font</parameter></paramdef>
- <paramdef>int <parameter>x</parameter></paramdef>
- <paramdef>int <parameter>y</parameter></paramdef>
- <paramdef>string <parameter>s</parameter></paramdef>
- <paramdef>int <parameter>col</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagestring</function> dessine une la chaîne sur une ligne
- horizontale, dans l'image <parameter>im</parameter>, aux coordonnées
- (<parameter>x</parameter>,<parameter>y</parameter>) (le coin supérieur
- gauche est l'origine (0,0)) dans la couleur <parameter>col</parameter>.
- Si l'argument de police vaut 1, 2, 3, 4 ou 5, une des polices par défaut
sera
- utilisée).
- </para>
- <para>
- Voir aussi <function>imageloadfont</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagestringup">
- <refnamediv>
- <refname>ImageStringUp</refname>
- <refpurpose>Dessine une chaîne verticale.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagestringup</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>int <parameter>font</parameter></paramdef>
- <paramdef>int <parameter>x</parameter></paramdef>
- <paramdef>int <parameter>y</parameter></paramdef>
- <paramdef>string <parameter>s</parameter></paramdef>
- <paramdef>int <parameter>col</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagestringup</function> dessine une chaîne sur une ligne
- verticale dans l'image <parameter>im</parameter> aux coordonnées
- (<parameter>x</parameter>, <parameter>y</parameter>) (l'origine est le coin
- supérieur gauche (0,0)) dans la couleur <parameter>col</parameter>.
- Si la police utilisée est 1, 2, 3, 4 ou 5, une police par défaut
- sera utilisée.
- </para>
- <para>
- Voir aussi <function>imageloadfont</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagesx">
- <refnamediv>
- <refname>ImageSX</refname>
- <refpurpose>Retourne la largeur d'une image.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagesx</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagesx</function> retourne la largeur de l'image
référencée par
- <parameter>im</parameter>.
- </para>
- <para>
- Voir aussi <function>imagecreate</function> et <function>imagesy</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagesy">
- <refnamediv>
- <refname>ImageSY</refname>
- <refpurpose>Retourne la hauteur de l'image.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagesy</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagesy</function> retourne la hauteur de l'image
référencée par
- <parameter>im</parameter>.
- </para>
- <para>
- Voir aussi <function>imagecreate</function> et <function>imagesx</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagettfbbox">
- <refnamediv>
- <refname>ImageTTFBBox</refname>
- <refpurpose>retourne le rectangle entourant un texte et dessiné avec une
police TrueType.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>imagettfbbox</function></funcdef>
- <paramdef>int <parameter>size</parameter></paramdef>
- <paramdef>int <parameter>angle</parameter></paramdef>
- <paramdef>string <parameter>fontfile</parameter></paramdef>
- <paramdef>string <parameter>text</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagettfbbox</function> calcule et retourne le rectangle entourant
- le texte <parameter>text</parameter>, écrit avec une police truetype.
- <variablelist>
- <varlistentry>
- <term>
- <parameter>text</parameter>
- </term>
- <listitem>
- <simpara>
- La chaîne à mesurer.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <parameter>size</parameter>
- </term>
- <listitem>
- <simpara>
- La taille de la police en pixel.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <parameter>fontfile</parameter>
- </term>
- <listitem>
- <simpara>
- Le nom de la police TrueType (peut aussi être une URL.)
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <parameter>angle</parameter>
- </term>
- <listitem>
- <simpara>Angle en degré dans lequel le texte
<parameter>text</parameter>
- va être mesuré.
- </simpara>
- </listitem>
- </varlistentry>
- </variablelist>
- <function>imagettfbbox</function> retourne une tableau avec 8
- éléments, représentants les 4 sommets du rectangle
- ainsi définis.
- <informaltable>
- <tgroup cols="2">
- <tbody>
- <row>
- <entry>0</entry>
- <entry>Coin inférieur gauche, abscisse</entry>
- </row>
- <row>
- <entry>1</entry>
- <entry>Coin inférieur gauche, ordonnée</entry>
- </row>
- <row>
- <entry>2</entry>
- <entry>Coin inférieur droit, abscisse</entry>
- </row>
- <row>
- <entry>3</entry>
- <entry>Coin inférieur droit, ordonnée</entry>
- </row>
- <row>
- <entry>4</entry>
- <entry>Coin supérieur droit, abscisse</entry>
- </row>
- <row>
- <entry>5</entry>
- <entry>Coin supérieur droit, ordonnée</entry>
- </row>
- <row>
- <entry>6</entry>
- <entry>Coin supérieur gauche, abscisse</entry>
- </row>
- <row>
- <entry>7</entry>
- <entry>Coin supérieur gauche, ordonnée</entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- Les positions des points sont relatives au texte <emphasis>text</emphasis>,
- indépendamment de l'angle : coin supérieur gauche faire
- référence au coin supérieur gauche du texte écrit
- horizontalement.
- </para>
- <para>
- <function>imagettfbbox</function> requiert les bibliothèques
- GD et Freetype.
- </para>
- <para>
- Voir aussi <function>imagettftext</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagettftext">
- <refnamediv>
- <refname>ImageTTFText</refname>
- <refpurpose>Dessine un texte avec une police TrueType.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>imagettftext</function></funcdef>
- <paramdef>resource <parameter>im</parameter></paramdef>
- <paramdef>int <parameter>size</parameter></paramdef>
- <paramdef>int <parameter>angle</parameter></paramdef>
- <paramdef>int <parameter>x</parameter></paramdef>
- <paramdef>int <parameter>y</parameter></paramdef>
- <paramdef>int <parameter>col</parameter></paramdef>
- <paramdef>string <parameter>fontfile</parameter></paramdef>
- <paramdef>string <parameter>text</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagettftext</function> dessine la chaîne
<parameter>text</parameter>
- dans l'image <parameter>im</parameter>, en commancant aux coordonnées
- (<parameter>x</parameter>,<parameter>y</parameter>) (le coin supérieur
gauche est
- l'origine (0,0)), avec un angle de <parameter>angle</parameter>, et dans la
- couleur <parameter>col</parameter>, en utilisant la police TrueType
identifiée par
- <parameter>fontfile</parameter>.
- </para>
- <para>
- Les coordonnées (<parameter>x</parameter>,<parameter>y</parameter>)
serviront
- de référence pour le premier caractère (en gros, le coin
- inférieur gauche du caractère). C'est différent de
- <function>imagestring</function>, qui utilise le coin supérieur droit.
- </para>
+ </note>
+ </para>
+ <para>
+ Voir aussi
+ <function>imagepng</function>,
+ <function>imagegif</function>,
+ <function>imagejpeg</function> et
+ <function>imagetypes</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imageinterlace">
+ <refnamediv>
+ <refname>ImageInterlace</refname>
+ <refpurpose>Active ou désactive l'entrelacement.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imageinterlace</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter><optional>interlace</optional></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imageinterlace</function> active ou désactive le bit
+d'entrelacement.
+ Si l'entrelacement est à 1, l'image <parameter>im</parameter> sera
+ interlacée, et sinon, elle ne le sera pas.
+ </para>
+ <para>
+ <function>imageinterlace</function> retourne l'état courant
+ d'entrelacement de l'image.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imageline">
+ <refnamediv>
+ <refname>ImageLine</refname>
+ <refpurpose>Draw a line.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imageline</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>x1</parameter></paramdef>
+ <paramdef>int <parameter>y1</parameter></paramdef>
+ <paramdef>int <parameter>x2</parameter></paramdef>
+ <paramdef>int <parameter>y2</parameter></paramdef>
+ <paramdef>int <parameter>col</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imageline</function> dessine une ligne depuis le point
+ (<parameter>x1</parameter>,<parameter>y1</parameter>) jusqu'au point
+ (<parameter>x2</parameter>,<parameter>y2</parameter>)
+ (le coin supérieur gauche est l'origine (0,0)) dans l'image
+<parameter>im</parameter>
+ et avec la couleur <parameter>col</parameter>.
+ </para>
+ <para>
+ Voir aussi <function>imagecreate</function> et
+<function>imagecolorallocate</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imageloadfont">
+ <refnamediv>
+ <refname>ImageLoadFont</refname>
+ <refpurpose>Charge une nouvelle police.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>resource <function>imageloadfont</function></funcdef>
+ <paramdef>string <parameter>file</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imageloadfont</function> charge une nouvelle police utilisateur et
+ retourne un identifiant sur cette police. Cet identifiant sera
+ toujours supérieur à 5, pour éviter les
+ conflits avec les polices standard PHP).
+ </para>
+ <para>
+ Le format des polices dépend actuellement du système
+ d'exploitation. Ce qui signifie qu'il vous faut génèrer
+ des fichiers de polices pour la machine qui fait tourner PHP.
+ </para>
+ <para>
+ <table>
+ <title>Format de fichier de police.</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>position</entry>
+ <entry>Type de donnés C</entry>
+ <entry>description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Octets 0-3</entry>
+ <entry>int</entry>
+ <entry>Nombre de caractères de la police</entry>
+ </row>
+ <row>
+ <entry>Octets 4-7</entry>
+ <entry>int</entry>
+ <entry>
+ Valeur du premier caractère de la police (souvent 32 pour espace)
+ </entry>
+ </row>
+ <row>
+ <entry>Octets 8-11</entry>
+ <entry>int</entry>
+ <entry>Largeur en pixel des caractères</entry>
+ </row>
+ <row>
+ <entry>Octets 12-15</entry>
+ <entry>int</entry>
+ <entry>Hauteur en pixel des caractères</entry>
+ </row>
+ <row>
+ <entry>Octets 16-</entry>
+ <entry>char</entry>
+ <entry>
+ Tableau avec les données des caractères, un octet par pixel
+pour chaque
+ caractère, avec un total de
+(nombre_caractères*largeur*hauteur) octets.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+ <para>
+ Voir aussi
+ <function>imagefontwidth</function> et
+ <function>imagefontheight</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagepolygon">
+ <refnamediv>
+ <refname>ImagePolygon</refname>
+ <refpurpose>Dessine un polygone.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagepolygon</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>array <parameter>points</parameter></paramdef>
+ <paramdef>int <parameter>num_points</parameter></paramdef>
+ <paramdef>int <parameter>col</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagepolygon</function> dessine un polygone dans l'image
+ <parameter>im</parameter>. <parameter>points</parameter> est un tableau
+ PHP qui contient les sommets du polygone sous la forme : points[0] = x0,
+ points[1] = y0, points[2] = x1, points[3] = y1, etc. num_points est le
+ nombre de sommets.
+ </para>
+ <para>
+ Voir aussi <function>imagecreate</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagepsbbox">
+ <refnamediv>
+ <refname>ImagePSBBox</refname>
+ <refpurpose>
+ Retourne le rectangle entourant un texte et dessiné avec une
+ police PostScript Type1.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>imagepsbbox</function></funcdef>
+ <paramdef>string <parameter>text</parameter></paramdef>
+ <paramdef>resource <parameter>font</parameter></paramdef>
+ <paramdef>int <parameter>size</parameter></paramdef>
+ <paramdef>int <parameter>space</parameter></paramdef>
+ <paramdef>int <parameter>width</parameter></paramdef>
+ <paramdef>float <parameter>angle</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <parameter>size</parameter> est exprimé en pixels.
+ </para>
+ <para>
+ <parameter>space</parameter> permet de changer la valeur par
+ défaut du charactère espace. Cette valeur est ajoutée
+ lors des dessins, et donc, peut être négative.
+ </para>
+ <para>
+ <parameter>tightness</parameter> permet de contrôler la
+ quantité d'espace entre les caractères. Cette quantité
+ est ajouté lors des dessins, et peut donc être négative.
+ </para>
+ <para>
+ <parameter>angle</parameter> est en degrés.
+ </para>
+ <para>
+ Les paramètres <parameter>space</parameter> et
+ <parameter>tightness</parameter> sont exprimés en unité
+ d'espacement de caractères, avec 1 unité vaut 1/1000 d'un
+ em carré (NDT : kesako?).
+ </para>
+ <para>
+ Les paramètres <parameter>space</parameter>,
+ <parameter>tightness</parameter> et <parameter>angle</parameter> sont optionnels.
+ </para>
+ <para>
+ Le rectangle entourant est calculé en utilisant les informations
+ disponibles sur les tailles de caractères, et, malheureusement,
+ ont tendance à être légèrement différents
+ du résultat réel final. Si l'angle est de 0 degré,
+ vous pouvez vous attendre à avoir besoin d'un rectangle d'au moins
+ un pixel plus grand dans toutes les directions.
+ </para>
+ <para>
+ <function>imagepsbbox</function> retourne un tableau contenant les
+ éléments suivants :
+ <informaltable>
+ <tgroup cols="2">
+ <tbody>
+ <row>
+ <entry>0</entry>
+ <entry>Abscisse inférieure gauche</entry>
+ </row>
+ <row>
+ <entry>1</entry>
+ <entry>Ordonnée inférieure gauche</entry>
+ </row>
+ <row>
+ <entry>2</entry>
+ <entry>Abscisse supérieure droite</entry>
+ </row>
+ <row>
+ <entry>3</entry>
+ <entry>Ordonnée supérieure droite</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ <para>
+ Voir aussi <function>imagepstext</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <!-- The function in t1lib which this function uses seems to be buggy...
+ Currently, just comment out everywhere in the docs and source until time
+ permits to find a solution.
+ <refentry id="function.imagepscopyfont">
+ <refnamediv>
+ <refname>imagepscopyfont</refname>
+ <refpurpose>
+ Fait une copie d'une police chargée pour modification ultérieure.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagepscopyfont</function></funcdef>
+ <paramdef>int <parameter>fontindex</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Utilisez cette fonction si vous devez faire des modifications dans une polie,
+comme
+ par exemple l'extension ou la condensation, ou encore, modifier son vecteur
+ d'encodage, tout en conservant l'original. Notez que la police que vous copiez
+ doit être obtenue par <function>imagepsloadfont</function>, et non pas une
+police
+ qui a elle même été copiée. Vous pouvez aussi faire
+des modifications avant de
+ la copier.
+ </para>
+ <para>
+ Si vous utilisez cette fonction, vous <emphasis>DEVEZ</emphasis> libérer
+les polices
+ obtenues vous même, et dans l'ordre inverse. Sinon, votre script sera
+ <emphasis>suspendu</emphasis>.
+ </para>
+ <para>
+ Si tout a bien été fait, un index valide de police sera
+retourné, et pourra être
+ utilisé ultérieurement. Sinon, la fonction retournera
+<literal>FALSE</literal>, et affichera un
+ message décrivant l'erreur.
+ </para>
+ <para>
+ Voir aussi <function>imageploadpsfont</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ -->
+ <refentry id="function.imagepsencodefont">
+ <refnamediv>
+ <refname>ImagePSEncodeFont</refname>
+ <refpurpose>
+ Change le codage vectoriel d'un caractère dans une police.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagepsencodefont</function></funcdef>
+ <paramdef>resource <parameter>font</parameter></paramdef>
+ <paramdef>string <parameter>encodingfile</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagepsencodefont</function> charge le codage vectoriel d'un
+ caractère depuis un fichier et change le codage vectoriel de la
+ police correspondante. Etant donné que les polices PostScript ne
+ disposent pas des caractères au-delà de 127, vous aurez
+ sûrement besoin de les changer sur vous utilisez une autre langue que
+ l'anglais. Le format exact est décrit dans la documentation T1libs.
+ T1lib est disponible en deux formes : IsoLatin1.enc et IsoLatin2.enc.
+ </para>
+ <para>
+ Si vous commencez à utiliser cette fonction régulièrement,
+ une meilleure solution est de définir un encodage, et de l'utiliser
+ avec set ps.default_encoding dans <link linkend="configuration.file">le fichier
+ de configuration</link> pour utiliser par défaut l'encodage correct.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagepsfreefont">
+ <refnamediv>
+ <refname>ImagePSFreeFont</refname>
+ <refpurpose>
+ Libère la mémoire occupée par une police PostScript Type 1.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>imagepsfreefont</function></funcdef>
+ <paramdef>resource <parameter>font</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Voir aussi <function>imagepsloadfont</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagepsloadfont">
+ <refnamediv>
+ <refname>ImagePSLoadFont</refname>
+ <refpurpose>Charge une police PostScript Type 1 depuis un fichier.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>resource <function>imagepsloadfont</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Au cas ooúugrave; tout a bien marché, un index de police
+ va être retourné, et pourra être utilisé
+ pour des opérations ultérieures. Sinon, la fonction
+ retourne <literal>FALSE</literal> et affiche un message décrivant
+ ce qui est erroné.
+ </para>
+ <para>
+ Voir aussi
+ <function>imagepsfreefont</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagepsextendfont">
+ <refnamediv>
+ <refname>ImagePsExtendFont</refname>
+ <refpurpose>
+ Etend ou condense une police de caractères
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>imagepsextendfont</function></funcdef>
+ <paramdef>resource <parameter>font</parameter></paramdef>
+ <paramdef>double <parameter>extend</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagepsextendfont</function> étend ou condense la police
+ de caractères <parameter>font</parameter>. Si la valeur de
+ <parameter>extend</parameter> est inférieure à 1, ce sera une
+ condensation.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagepsslantfont">
+ <refnamediv>
+ <refname>ImagePsSlantFont</refname>
+ <refpurpose>
+ Incline une police de caractères
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>imagepsslantfont</function></funcdef>
+ <paramdef>resource <parameter>font</parameter></paramdef>
+ <paramdef>double <parameter>slant</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagepsslantfont</function> met en italique
+ la police de caractères <parameter>font</parameter> avec
+ le coefficient <parameter>slant</parameter>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagepstext">
+ <refnamediv>
+ <refname>ImagePSText</refname>
+ <refpurpose>Dessine un texte sur une image avec une police PostScript
+Type1.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>imagepstext</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>string <parameter>text</parameter></paramdef>
+ <paramdef>resource <parameter>font</parameter></paramdef>
+ <paramdef>int <parameter>size</parameter></paramdef>
+ <paramdef>int <parameter>foreground</parameter></paramdef>
+ <paramdef>int <parameter>background</parameter></paramdef>
+ <paramdef>int <parameter>x</parameter></paramdef>
+ <paramdef>int <parameter>y</parameter></paramdef>
+ <paramdef>int <parameter>
+ <optional>space</optional></parameter></paramdef>
+ <paramdef>int <parameter>
+ <optional>tightness</optional></parameter></paramdef>
+ <paramdef>float <parameter>
+ <optional>angle</optional></parameter></paramdef>
+ <paramdef>int <parameter>
+ <optional>antialias_steps</optional></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <parameter>size</parameter> est exprimé en pixels.
+ </para>
+ <para>
+ <parameter>foreground</parameter> est la couleur dans laquelle le texte va
+ être dessiné. <parameter>background</parameter> est la couleur
+d'anti aliasing.
+ Aucun pixel avec la couleur <parameter>background</parameter> n'est
+dessiné, ce
+ qui fait que l'arrière plan n'a pas besoin d'être dans une couleur
+fixe.
+ </para>
+ <para>
+ Les coordonnées données (<parameter>x</parameter>,
+ <parameter>y</parameter>) définissent l'origine du premier
+ caractère (grossièrement, le coin inférieur
+ gauche du caractère). Ceci est différent de la fonction
+ <function>imagestring</function>, ooúugrave; (x, y) définissait le
+ coin supérieur gauche du premier caracètre. Reportez vous
+ à la documentation PostScript pour avoir des détails à
+ propos des polices et de leurs tailles.
+ </para>
+ <para>
+ <parameter>space</parameter> permet de changer la taille par défaut
+ du caractère d'espacement. Cette valeur peut être négative.
+ </para>
+ <para>
+ <parameter>tightness</parameter> permet de contrôler la quantité
+ d'espace entre deux caractères. Cette valeur peut être
+ négative.
+ </para>
+ <para>
+ <parameter>angle</parameter> est en degrés.
+ </para>
+ <para>
+ <parameter>antialias_steps</parameter> permet de contrôler le nombre de
+couleurs
+ du texte anti-aliasé. Les valeurs autorisées sont 4 et 16. 16 est
+recommandé pour
+ les polices de moins de 20 pixels, car l'effet est alors visible. Avec les
+ tailles plus grandes, utilisez de préférence 4, qui est moins
+gourmande en
+ ressources.
+ </para>
+ <para>
+ Les paramètres <parameter>space</parameter> et
+<parameter>tightness</parameter>
+ sont exprimés en unité d'espace caractère, ce qui vaut
+1/1000ème d'un em-carré
+ ( ? ? ?).
+ </para>
+ <para>
+ Les paramètres <parameter>space</parameter>,
+<parameter>tightness</parameter>,
+ <parameter>angle</parameter> et <parameter>antialias</parameter> sont optionnels.
+ </para>
+ <para>
+ <function>imagepstext</function> retourne un tableau contenant les
+ éléments suivants :
+ <informaltable>
+ <tgroup cols="2">
+ <tbody>
+ <row>
+ <entry>0</entry>
+ <entry>Abscisse inférieure gauche</entry>
+ </row>
+ <row>
+ <entry>1</entry>
+ <entry>Ordonnée inférieure gauche</entry>
+ </row>
+ <row>
+ <entry>2</entry>
+ <entry>Abscisse supérieure droite</entry>
+ </row>
+ <row>
+ <entry>3</entry>
+ <entry>Ordonnée supérieure droite</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ <para>
+ Voir aussi <function>imagepsbbox</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagerectangle">
+ <refnamediv>
+ <refname>ImageRectangle</refname>
+ <refpurpose>Dessine un rectangle.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagerectangle</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>x1</parameter></paramdef>
+ <paramdef>int <parameter>y1</parameter></paramdef>
+ <paramdef>int <parameter>x2</parameter></paramdef>
+ <paramdef>int <parameter>y2</parameter></paramdef>
+ <paramdef>int <parameter>col</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagerectangle</function> dessine un rectangle dans la couleur
+ <parameter>col</parameter>, dans l'image <parameter>im</parameter>, et en
+ commençant au point supérieur gauche (<parameter>x1</parameter>,
+ <parameter>y1</parameter>), et en finissant au point inférieur droit
+ (<parameter>x2</parameter>,<parameter>y2</parameter>). Le coin supérieur
+ gauche est l'origine (0,0).
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagesetpixel">
+ <refnamediv>
+ <refname>ImageSetPixel</refname>
+ <refpurpose>Dessine un pixel.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagesetpixel</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>x</parameter></paramdef>
+ <paramdef>int <parameter>y</parameter></paramdef>
+ <paramdef>int <parameter>col</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagesetpixel</function> dessine un pixel au point
+ (<parameter>x</parameter>,<parameter>y</parameter>)
+ (le coin supérieur gauche est l'origine (0,0)) dans l'image
+<parameter>im</parameter>,
+ et avec la couleur <parameter>col</parameter>.
+ </para>
+ <para>
+ Voir aussi <function>imagecreate</function> et
+<function>imagecolorallocate</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagesetbrush">
+ <refnamediv>
+ <refname>ImageSetTile</refname>
+ <refpurpose>Modifie la brosse pour le dessin des lignes</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagesetbrush</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>resource <parameter>brush</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagesetbrush</function> remplace la brosse courante
+ pour le dessin des lignes par <parameter>brush</parameter>.
+ Cette brosse sera alors utilisée avec les fonctions
+ <function>imageline</function> et <function>imagepolygon</function>.
+ </para>
+ <note>
<para>
- <parameter>angle</parameter> est donné en degrés, avec
degré
- 0 pour un texte horizontal, et en comptant les angles dans le sens inverse des
- aiguilles d'une montre (sens direct).
+ Vous n'avez rien à faire lorsque vous en avez terminé avec une
+brosse,
+ mais si vous destruisez l'image de brosse, vous ne DEVEZ plus utiliser
+ les options IMG_COLOR_BRUSHED et IMG_COLOR_STYLEDBRUSHED des fonctions
+ <function>imageline</function> et <function>imagepolygon</function>,
+ avant d'avoir créé une nouvelle brosse.
</para>
+ </note>
+ <note>
<para>
- <parameter>fontfile</parameter> est le chemin jusqu'à la police
- TrueType à utiliser.
+ <function>imagesetbrush</function> a été ajoutée en PHP
+4.0.6.
</para>
+ </note>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagesettile">
+ <refnamediv>
+ <refname>ImageSetTile</refname>
+ <refpurpose>Set the tile image for filling</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagesettile</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>resource <parameter>tile</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagesettile</function> remplace l'image de
+ carrelage courante par l'image <parameter>tile</parameter>,
+ à utiliser dans toutes les remplissages (comme avec les fonctions
+ <function>imagefill</function> et <function>imagefilledpolygon</function>)
+ lors des remplissages avec l'option <literal>IMG_COLOR_TILED</literal>.
+ </para>
+ <para>
+ Une image de carrelage est une image utilisée pour remplir une zone,
+ de manière répétitive. N'importe quelle image GD peut servir
+d'image de
+ remplissage. L'utilisation de la couleur transparente (gérée avec
+ la fonction <function>imagecolortransparent</function>) permet à certaines
+ zone d'apparaître à travers le carrelage.
+ </para>
+ <note>
<para>
- <parameter>text</parameter> est le texte à dessiner, incluant
- aussi des séquences de caractères UTF-8 (de la forme: &#123; )
- pour générer des caractères au delà de 255.
+ Vous n'avez rien à faire lorsque vous en avez terminé avec une
+brosse,
+ mais si vous destruisez l'image de brosse, vous ne DEVEZ plus utiliser
+ l'option <literal>IMG_COLOR_TILED</literal> des fonctions
+ <function>imagefill</function> et <function>imagefilledpolygon</function>,
+ avant d'avoir créé une nouvelle brosse.
</para>
+ </note>
+ <note>
<para>
- <parameter>col</parameter> est l'index de la couleur dans la palette. Utiliser
- des index négatifs, revient à supprimer l'anti-aliasing.
+ <function>imagesettile</function> a été ajoutée en PHP
+4.0.6.
</para>
+ </note>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagesetthickness">
+ <refnamediv>
+ <refname>ImageSetThickness</refname>
+ <refpurpose>Modifie l'épaisseur d'un trait</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>imagesetthickness</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>thickness</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagesetthickness</function> modifie l'épaisseur
+ du trait des lignes de l'image <parameter>im</parameter>. Cette
+ épaisseur intervient dans les dessins de polygones, ellipses,
+ cercles, rectangles, etc... <parameter>thickness</parameter>
+ est en pixels.
+ </para>
+ <note>
<para>
- <function>imagettftext</function> retourne un tableau de 8
éléments
- représentants les 4 points marquant les limites du texte. L'ordre
- des points est :supérieur gauche, supérieur droit,
- inférieur droit, inférieur gauche. Les points sont nommés
- relativement au texte à l'horizontal.
+ <function>imagesetthickness</function> a été ajoutée en PHP
+4.0.6
+ et nécessite GD 2.0.1.
</para>
- <para>
- Cet exemple va générer une image <acronym>GIF</acronym> noire
- de 400x30 pixels, avec les mots "Test en cours..." en police blanche, Arial.
- <example>
- <title><function>imagettftext</function></title>
- <programlisting role="php">
+ </note>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagestring">
+ <refnamediv>
+ <refname>ImageString</refname>
+ <refpurpose>Dessine une chaîne horizontale.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagestring</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>font</parameter></paramdef>
+ <paramdef>int <parameter>x</parameter></paramdef>
+ <paramdef>int <parameter>y</parameter></paramdef>
+ <paramdef>string <parameter>s</parameter></paramdef>
+ <paramdef>int <parameter>col</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagestring</function> dessine une la chaîne sur une ligne
+ horizontale, dans l'image <parameter>im</parameter>, aux coordonnées
+ (<parameter>x</parameter>,<parameter>y</parameter>) (le coin supérieur
+ gauche est l'origine (0,0)) dans la couleur <parameter>col</parameter>.
+ Si l'argument de police vaut 1, 2, 3, 4 ou 5, une des polices par défaut
+sera
+ utilisée).
+ </para>
+ <para>
+ Voir aussi <function>imageloadfont</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagestringup">
+ <refnamediv>
+ <refname>ImageStringUp</refname>
+ <refpurpose>Dessine une chaîne verticale.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagestringup</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>font</parameter></paramdef>
+ <paramdef>int <parameter>x</parameter></paramdef>
+ <paramdef>int <parameter>y</parameter></paramdef>
+ <paramdef>string <parameter>s</parameter></paramdef>
+ <paramdef>int <parameter>col</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagestringup</function> dessine une chaîne sur une ligne
+ verticale dans l'image <parameter>im</parameter> aux coordonnées
+ (<parameter>x</parameter>, <parameter>y</parameter>) (l'origine est le coin
+ supérieur gauche (0,0)) dans la couleur <parameter>col</parameter>.
+ Si la police utilisée est 1, 2, 3, 4 ou 5, une police par défaut
+ sera utilisée.
+ </para>
+ <para>
+ Voir aussi <function>imageloadfont</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagesx">
+ <refnamediv>
+ <refname>ImageSX</refname>
+ <refpurpose>Retourne la largeur d'une image.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagesx</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagesx</function> retourne la largeur de l'image
+référencée par
+ <parameter>im</parameter>.
+ </para>
+ <para>
+ Voir aussi <function>imagecreate</function> et <function>imagesy</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagesy">
+ <refnamediv>
+ <refname>ImageSY</refname>
+ <refpurpose>Retourne la hauteur de l'image.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagesy</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagesy</function> retourne la hauteur de l'image
+référencée par
+ <parameter>im</parameter>.
+ </para>
+ <para>
+ Voir aussi <function>imagecreate</function> et <function>imagesx</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagettfbbox">
+ <refnamediv>
+ <refname>ImageTTFBBox</refname>
+ <refpurpose>retourne le rectangle entourant un texte et dessiné avec une
+police TrueType.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>imagettfbbox</function></funcdef>
+ <paramdef>int <parameter>size</parameter></paramdef>
+ <paramdef>int <parameter>angle</parameter></paramdef>
+ <paramdef>string <parameter>fontfile</parameter></paramdef>
+ <paramdef>string <parameter>text</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagettfbbox</function> calcule et retourne le rectangle entourant
+ le texte <parameter>text</parameter>, écrit avec une police truetype.
+ <variablelist>
+ <varlistentry>
+ <term>
+ <parameter>text</parameter>
+ </term>
+ <listitem>
+ <simpara>
+ La chaîne à mesurer.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <parameter>size</parameter>
+ </term>
+ <listitem>
+ <simpara>
+ La taille de la police en pixel.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <parameter>fontfile</parameter>
+ </term>
+ <listitem>
+ <simpara>
+ Le nom de la police TrueType (peut aussi être une URL.)
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <parameter>angle</parameter>
+ </term>
+ <listitem>
+ <simpara>Angle en degré dans lequel le texte <parameter>text</parameter>
+ va être mesuré.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <function>imagettfbbox</function> retourne une tableau avec 8
+ éléments, représentants les 4 sommets du rectangle
+ ainsi définis.
+ <informaltable>
+ <tgroup cols="2">
+ <tbody>
+ <row>
+ <entry>0</entry>
+ <entry>Coin inférieur gauche, abscisse</entry>
+ </row>
+ <row>
+ <entry>1</entry>
+ <entry>Coin inférieur gauche, ordonnée</entry>
+ </row>
+ <row>
+ <entry>2</entry>
+ <entry>Coin inférieur droit, abscisse</entry>
+ </row>
+ <row>
+ <entry>3</entry>
+ <entry>Coin inférieur droit, ordonnée</entry>
+ </row>
+ <row>
+ <entry>4</entry>
+ <entry>Coin supérieur droit, abscisse</entry>
+ </row>
+ <row>
+ <entry>5</entry>
+ <entry>Coin supérieur droit, ordonnée</entry>
+ </row>
+ <row>
+ <entry>6</entry>
+ <entry>Coin supérieur gauche, abscisse</entry>
+ </row>
+ <row>
+ <entry>7</entry>
+ <entry>Coin supérieur gauche, ordonnée</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ Les positions des points sont relatives au texte <emphasis>text</emphasis>,
+ indépendamment de l'angle : coin supérieur gauche faire
+ référence au coin supérieur gauche du texte écrit
+ horizontalement.
+ </para>
+ <para>
+ <function>imagettfbbox</function> requiert les bibliothèques
+ GD et Freetype.
+ </para>
+ <para>
+ Voir aussi <function>imagettftext</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagettftext">
+ <refnamediv>
+ <refname>ImageTTFText</refname>
+ <refpurpose>Dessine un texte avec une police TrueType.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>imagettftext</function></funcdef>
+ <paramdef>resource <parameter>im</parameter></paramdef>
+ <paramdef>int <parameter>size</parameter></paramdef>
+ <paramdef>int <parameter>angle</parameter></paramdef>
+ <paramdef>int <parameter>x</parameter></paramdef>
+ <paramdef>int <parameter>y</parameter></paramdef>
+ <paramdef>int <parameter>col</parameter></paramdef>
+ <paramdef>string <parameter>fontfile</parameter></paramdef>
+ <paramdef>string <parameter>text</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagettftext</function> dessine la chaîne
+<parameter>text</parameter>
+ dans l'image <parameter>im</parameter>, en commancant aux coordonnées
+ (<parameter>x</parameter>,<parameter>y</parameter>) (le coin supérieur
+gauche est
+ l'origine (0,0)), avec un angle de <parameter>angle</parameter>, et dans la
+ couleur <parameter>col</parameter>, en utilisant la police TrueType
+identifiée par
+ <parameter>fontfile</parameter>.
+ </para>
+ <para>
+ Les coordonnées (<parameter>x</parameter>,<parameter>y</parameter>)
+serviront
+ de référence pour le premier caractère (en gros, le coin
+ inférieur gauche du caractère). C'est différent de
+ <function>imagestring</function>, qui utilise le coin supérieur droit.
+ </para>
+ <para>
+ <parameter>angle</parameter> est donné en degrés, avec degré
+ 0 pour un texte horizontal, et en comptant les angles dans le sens inverse des
+ aiguilles d'une montre (sens direct).
+ </para>
+ <para>
+ <parameter>fontfile</parameter> est le chemin jusqu'à la police
+ TrueType à utiliser.
+ </para>
+ <para>
+ <parameter>text</parameter> est le texte à dessiner, incluant
+ aussi des séquences de caractères UTF-8 (de la forme: &#123; )
+ pour génèrer des caractères au delà de 255.
+ </para>
+ <para>
+ <parameter>col</parameter> est l'index de la couleur dans la palette. Utiliser
+ des index négatifs, revient à supprimer l'anti-aliasing.
+ </para>
+ <para>
+ <function>imagettftext</function> retourne un tableau de 8 éléments
+ représentants les 4 points marquant les limites du texte. L'ordre
+ des points est :supérieur gauche, supérieur droit,
+ inférieur droit, inférieur gauche. Les points sont nommés
+ relativement au texte à l'horizontal.
+ </para>
+ <para>
+ Cet exemple va génèrer une image <acronym>GIF</acronym> noire
+ de 400x30 pixels, avec les mots "Test en cours..." en police blanche, Arial.
+ <example>
+ <title><function>imagettftext</function></title>
+ <programlisting role="php">
<?php
Header("Content-type: image/gif");
$im = imagecreate(400,30);
@@ -2174,90 +2791,90 @@
ImageGif($im);
ImageDestroy($im);
?>
- </programlisting>
- </example>
- </para>
- <para>
- <function>imagettftext</function> requiert les bibliothèques GD et
- <ulink url="&url.freetype;">FreeType</ulink>.
- </para>
- <para>
- Voir aussi <function>imagettfbbox</function>.
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.imagetypes">
- <refnamediv>
- <refname>ImageTypes</refname>
- <refpurpose>
- Retourne les types d'images supportés par la version
- courante de PHP
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>imagetypes</function></funcdef>
- <paramdef>void</paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>imagetypes</function> retourne un champs de bit correspondant aux
- formats d'images supportés par la version de GD
- utilisée. Les valeurs suivantes sont valables : IMG_GIF |
- IMG_JPG | IMG_PNG | IMG_WBMP. Pour vous assurer du support
<acronym>PNG</acronym>,
- faites ceci :
- <example>
- <title>Exemple avec ImageTypes</title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <function>imagettftext</function> requiert les bibliothèques GD et
+ <ulink url="&url.freetype;">FreeType</ulink>.
+ </para>
+ <para>
+ Voir aussi <function>imagettfbbox</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.imagetypes">
+ <refnamediv>
+ <refname>ImageTypes</refname>
+ <refpurpose>
+ Retourne les types d'images supportés par la version
+ courante de PHP
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>imagetypes</function></funcdef>
+ <paramdef>void</paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>imagetypes</function> retourne un champs de bit correspondant aux
+ formats d'images supportés par la version de GD
+ utilisée. Les valeurs suivantes sont valables : <literal>IMG_GIF</literal>
+|
+ <literal>IMG_JPG</literal> | <literal>IMG_PNG</literal> |
+<literal>IMG_WBMP</literal>. Pour vous assurer du support <acronym>PNG</acronym>,
+ faites ceci :
+ <example>
+ <title>Exemple avec ImageTypes</title>
+ <programlisting role="php">
<?php
if (imagetypes() & IMG_PNG) {
echo "Le type PNG est supporté";
}
?>
- </programlisting>
- </example>
- </para>
- </refsect1>
- </refentry>
- <refentry id="function.read-exif-data">
- <refnamediv>
- <refname>read_exif_data</refname>
- <refpurpose>Lis les entêtes EXIF d'une image JPEG</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>read_exif_data</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>read_exif_data</function> lit les entêtes EXIF de
- l'image <acronym>JPEG</acronym> <parameter>filename</parameter>.
- Elle retourne un tableau associatif où les index sont les noms
- d'entêtes EXIF, et les valeurs sont leur valeur
- associée. Les entêtes EXIF sont souvent disponibles
- dans les images générées par les appareils
- phots digitals, mais chaque constructeur marque ses images d'une
- manière qui lui est propre : il est impossible de savoir
- quels entêtes seront présents.
- <example>
- <title>read_exif_data</title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.read-exif-data">
+ <refnamediv>
+ <refname>read_exif_data</refname>
+ <refpurpose>Lis les entêtes EXIF d'une image JPEG</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>read_exif_data</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>read_exif_data</function> lit les entêtes EXIF de
+ l'image <acronym>JPEG</acronym> nommée <parameter>filename</parameter>.
+ Elle retourne un tableau associatif où les index sont les noms
+ d'entêtes EXIF, et les valeurs sont leur valeur
+ associée. Les entêtes EXIF sont souvent disponibles
+ dans les images générées par les appareils
+ phots digitals, mais chaque constructeur marque ses images d'une
+ manière qui lui est propre : il est impossible de savoir
+ quels entêtes seront présents.
+ <example>
+ <title>read_exif_data</title>
+ <programlisting role="php">
<?php
$exif = read_exif_data('p0001807.jpg');
while(list($k,$v)=each($exif)) {
echo "$k: $v<br>\n";
}
?>
- </programlisting>
- <simpara>
- Cet exemple va afficher :
- </simpara>
- <literallayout>
+ </programlisting>
+ <simpara>
+ Cet exemple va afficher :
+ </simpara>
+ <literallayout>
<computeroutput>
FileName: p0001807.jpg
FileDateTime: 929353056
@@ -2280,24 +2897,24 @@
Orientation: 1
ExifVersion: 0200
</computeroutput>
- </literallayout>
- </example>
- </para>
- <para>
- <note>
- <simpara>
- <function>read_exif_data</function> n'est disponible que sous PHP 4 ,
- compilé avec
- <link linkend="install.configure.enable-exif">--enable-exif</link>.
- </simpara>
- <simpara>
- <function>read_exif_data</function> ne requiert par la librairie GD.
- </simpara>
- </note>
- </para>
- </refsect1>
- </refentry>
- </reference>
+ </literallayout>
+ </example>
+ </para>
+ <para>
+ <note>
+ <simpara>
+ <function>read_exif_data</function> n'est disponible que sous PHP 4 ,
+ compilé avec
+ <link linkend="install.configure.enable-exif">--enable-exif</link>.
+ </simpara>
+ <simpara>
+ <function>read_exif_data</function> ne requiert par la librairie GD.
+ </simpara>
+ </note>
+ </para>
+ </refsect1>
+ </refentry>
+</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
