cvs: phpdoc-fr /reference/image configure.xml constants.xml ini.xml reference.xml
| From: | Damien Seguy | Date: | Wed, 18 Dec 2002 02:44:10 +0000 |
| Subject: | cvs: phpdoc-fr /reference/image configure.xml constants.xml ini.xml reference.xml | ||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-140@lists.php.net to get a copy of this message | ||
dams Tue Dec 17 21:44:10 2002 EDT
Added files:
/phpdoc-fr/reference/image configure.xml constants.xml ini.xml
Modified files:
/phpdoc-fr/reference/image reference.xml
Log:
Decembre 2002 update
Index: phpdoc-fr/reference/image/reference.xml diff -u phpdoc-fr/reference/image/reference.xml:1.2 phpdoc-fr/reference/image/reference.xml:1.3 --- phpdoc-fr/reference/image/reference.xml:1.2 Mon Apr 15 20:53:58 2002 +++ phpdoc-fr/reference/image/reference.xml Tue Dec 17 21:44:09 2002 @@ -1,42 +1,204 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <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> + <section id="image.intro"> + &reftitle.intro; + <para> + PHP ne se limite pas à la génération de pages HTML. Il peut aussi servir + à créer des et manipuler des images, dans un grand choix de formats, + comme gif, png, jpg, wbmp et xpm. Et même, PHP peut générer + directement des images pour le navigateur, avec la librarie GD. + GD et PHP auront aussi besoin de d'autres librairies, en fonction + des formats que vous souhaitez utiliser. + </para> + <para> + Vous pouvez utiliser les fonctions PHP pour obtenir les + tailles des images aux formats + <acronym>JPEG</acronym>, <acronym>GIF</acronym>, + <acronym>PNG</acronym>, <acronym>SWF</acronym>, + <acronym>TIFF</acronym> et <acronym>JPEG2000</acronym>. + </para> + <para> + <note> + <simpara> + Lisez la sections sur les pré-requis pour savoir comment améliorer + les possibilités le lecture, modification et écriture d'images, ainsi + que les possibilités de lecture d'images prises par des appareils + numériques. + </simpara> + </note> + </para> + </section> + + <section id="image.requirements"> + &reftitle.required; + <para> + Si vous disposez de la librairie <acronym>GD</acronym> (disponible + à <ulink url="&url.gd;">&url.gd;</ulink>) vous pourrez aussi créer + et manipuler ces images. + </para> + <para> Les formats des images que vous pourrez manipuler dépendent de la version de GD que vous installerez, et de toute autre librairie dont GD a besoin pour traiter à ces images. Les versions antérieures à la version 1.6 supportent le <acronym>GIF</acronym>, mais pas le <acronym>PNG</acronym>. Pour les versions plus récentes, c'est le contraire. - </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> + <note> + <simpara> + Depuis PHP 4.3, il existe une version de GD qui est distribuée avec + PHP. Cette version contient des fonctionnalités supplémentaires, comme + les canaux alpha, et il est recommandé de l'utiliser de préférence à + la librairie externe, car elle est mieux supportée, et bien plus + stable. + </simpara> + </note> + </para> + <para> + Vous pouvez aussi améliorer GD en lui ajoutant des formats + d'images supplémentaires. + <table> + <title>Formats d'images supportés</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Format d'image</entry> + <entry>Librairie à télécharger</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>gif</literal></entry> + <entry></entry> + <entry> + Uniquement supporté en versions de GF antérieure à gd-1.6. + Le support des images GIF est disponible <emphasis>en lecture seule</emphasis> + depuis PHP 4.3.0, et dans la version de la librairie qui est fournie + avec la distribution de &php;. + </entry> + </row> + <row> + <entry><literal>jpeg-6b</literal></entry> + <entry><ulink url="&url.jpeg;">&url.jpeg;</ulink></entry> + <entry></entry> + </row> + <row> + <entry><literal>png</literal></entry> + <entry><ulink url="&url.libpng;">&url.libpng;</ulink></entry> + <entry> + Uniquement supporté avec GD plus récente que gd-1.6. + </entry> + </row> + <row> + <entry><literal>xpm</literal></entry> + <entry><ulink url="&url.libxpm;">&url.libxpm;</ulink></entry> + <entry> + Il est probable que vous ayez déjà cette librairie disponible si + votre système dispose d'un environnement X. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + + <para> + Vous pouvez aussi améliorer GD en lui ajoutant des fonctionalités de + manipulation de polices. Les librairies suivantes sont supportées : + <table> + <title>Supported font libraries</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Librarie de police</entry> + <entry>Téléchargement</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>FreeType 1.x</literal></entry> + <entry><ulink url="&url.freetype;">&url.freetype;</ulink></entry> + <entry></entry> + </row> + <row> + <entry><literal>FreeType 2</literal></entry> + <entry><ulink url="&url.freetype;">&url.freetype;</ulink></entry> + <entry></entry> + </row> + <row> + <entry><literal>T1lib</literal></entry> + <entry><ulink url="&url.t1lib;">&url.t1lib;</ulink>)</entry> + <entry> + Support des polices de Type 1. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + Si vous avez compilé PHP avec l'option <option role="configure">--enable-exif</option> + vous serez capable d'accéder aux données stockées dans les entêtes des images + <acronym>JPEG</acronym> et <acronym>TIFF</acronym>. De cette façon, vous + pouvez lire les méta données générées par les appareils numériques. + Ces fonctions ne requièrent par la librairie <acronym>GD</acronym>. + <note> + <simpara> + PHP ne requiert aucune librairie supplémentaire pour gérer les données EXIF. + </simpara> + </note> + </para> + </section> + + &reference.image.configure; + + &reference.image.ini; + + <section id="image.resources"> + &reftitle.resources; + &no.resource; + </section> + + &reference.image.constants; + + + <section id="image.examples"> + &reftitle.examples; + <para> + <example> + <title>Création d'une image PNG avec PHP</title> + <programlisting role="php"> +<![CDATA[ +<?php + header("Content-type: image/png"); + $string = $_GET['text']; + $im = imagecreatefrompng("images/button1.png"); + $orange = imagecolorallocate($im, 220, 210, 60); + $px = (imagesx($im) - 7.5 * strlen($string)) / 2; + imagestring($im, 3, $px, 9, $string, $orange); + imagepng($im); + imagedestroy($im); +?> +]]> + </programlisting> + </example> + Cet exemple doit être appelé depuis une page HTML avec une balise + image telle que : <literal><img src="button.php?text"></literal>. + Le script ci-dessus, button.php, prend la chaîne + "text" et l'inscrit sur le fond d'image appelée + "images/button1.png" et l'affiche. C'est une méthode très + pratique pour éviter de redessiner un nouveau bouteau, dès que vous + changez le texte d'un bouton. De cette façon, les boutons sont dynamiquement + générés. + </para> + </section> </partintro> - <!-- 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. - --> &reference.image.functions; Index: phpdoc-fr/reference/image/configure.xml +++ phpdoc-fr/reference/image/configure.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <section id="image.installation"> &reftitle.install; <para> Pour activer le support de GD, vous devez compiler &php; avec l'option <option role="configure">--with-gd[=DIR]</option>, où DIR est le dossier d'installation de GD. Il est recommandé d'utiliser la version de GD qui est distribué avec PHP, en utilisant simplement l'option <option role="configure">--with-gd</option>. </para> <para> Augmentez les possibilités des GD de gérer d'autres formats d'images en spécifiant les options de compilations suivantes : <table> <title>Formats d'image supportés</title> <tgroup cols="2"> <thead> <row> <entry>Format d'image</entry> <entry>Option de compilation</entry> </row> </thead> <tbody> <row> <entry><literal>jpeg-6b</literal></entry> <entry> Pour activer le support de la librairie JPEG-6b, ajouter l'option <option role="configure">--with-jpeg-dir=DIR</option>. </entry> </row> <row> <entry><literal>png</literal></entry> <entry> Pour activer le support de la librairie PNG, ajouter l'option <option role="configure">--with-png-dir=DIR</option>. Notez que libpng requiert la librairie <link linkend="zlib.requirements">zlib</link>, et donc, il vous faudra ajouter aussi <option role="configure">--with-zlib-dir[=DIR]</option> dans votre ligne de compilation. </entry> </row> <row> <entry><literal>xpm</literal></entry> <entry> Pour activer le support de la librairie XPM, ajoutez l'option <option role="configure">--with-xpm-dir=DIR</option>. Si le script de compilation n'est pas capable de trouver les librairies nécessaires, il vous faudra ajouter le chemin vers les librairies X11. </entry> </row> </tbody> </tgroup> </table> </para> <para> Augmentez les possibilités de GD pour qu'elle manipule différentes types de polices de caractères en ajoutant les options de compilations suivantes : <table> <title>Librairies des polices de caractères supportées</title> <tgroup cols="2"> <thead> <row> <entry>Librairie</entry> <entry>Option de configuration</entry> </row> </thead> <tbody> <row> <entry><literal>FreeType 1.x</literal></entry> <entry> Pour activer le support de FreeType 1.x, ajoutez l'option <option role="configure">--with-ttf[=DIR]</option>. </entry> </row> <row> <entry><literal>FreeType 2</literal></entry> <entry> Pour activer le support de FreeType 2, ajoutez l'option <option role="configure">--with-freetype-dir=DIR</option>. </entry> </row> <row> <entry><literal>T1lib</literal></entry> <entry> Pour activer le support de T1lib (Type 1 fonts), ajoutez l'option <option role="configure">--with-t1lib[=DIR]</option>. </entry> </row> <row> <entry><literal>Native TrueType string function</literal></entry> <entry> Pour activer le support des chaînes de caractères TrueType, ajoutez l'option <option role="configure">--enable-gd-native-ttf</option>. </entry> </row> </tbody> </tgroup> </table> </para> </section> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/reference/image/constants.xml +++ phpdoc-fr/reference/image/constants.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <section id="image.constants"> &reftitle.constants; &extension.constants; <variablelist> <varlistentry> <term> <constant>IMG_GIF</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_JPG</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_JPEG</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_PNG</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_WBMP</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_XPM</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_COLOR_TILED</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_COLOR_STYLED</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_COLOR_BRUSHED</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_COLOR_STYLEDBRUSHED</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_COLOR_TRANSPARENT</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_ARC_ROUNDED</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_ARC_PIE</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_ARC_CHORD</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_ARC_NOFILL</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_ARC_EDGED</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_GIF</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_JPG</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_PNG</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_SWF</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_PSD</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_BMP</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_TIFF_II</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_TIFF_MM</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_JPC</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_JP2</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_JPX</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_SWC</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> </variablelist> </section> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/reference/image/ini.xml +++ phpdoc-fr/reference/image/ini.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <section id="image.configuration"> &reftitle.runtime; &extension.runtime; <para> Exif supporte automatiquement la conversion en Unicode et JIS pour les commentaires des utilisateurs, lorsque le module <link linkend="ref.mbstring">mbstring</link> est disponible. Cela se fait en décodant le commentaire avec le bon jeu de caractères. Le résultat peut alors être encodé dans le jeu de caractères de votre serveur HTTP. <table> &ini.table.title; <tgroup cols="3"> <thead> &ini.table.top; </thead> <tbody> <row> <entry>exif.encode_unicode</entry> <entry>"ISO-8859-15"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>exif.decode_unicode_motorola</entry> <entry>"UCS-2BE"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>exif.decode_unicode_intel</entry> <entry>"UCS-2LE"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>exif.encode_jis</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>exif.decode_jis_motorola</entry> <entry>"JIS"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>exif.decode_jis_intel</entry> <entry>"JIS"</entry> <entry>PHP_INI_ALL</entry> </row> </tbody> </tgroup> </table> &ini.table.bottom; </para> <para> &ini.explain; <variablelist> <varlistentry id="ini.exif.encode_unicode"> <term> <parameter>exif.encode_unicode</parameter> <type>string</type> </term> <listitem> <para> <literal>exif.encode_unicode</literal> définit le jeu de caractères UNICODE utilisé pour les commentaires. Par défaut, c'est <literal>ISO-8859-15</literal>, qui devrait fonctionner pour les pays non asiatiques. Cette option peut être vide, ou bien contenir un jeu de caractères qui qui est supporté par mbstring. Si cette option est vide, la configuration de mbstring sera utilisée. </para> </listitem> </varlistentry> <varlistentry id="ini.exif.decode_unicode_motorola"> <term> <parameter>exif.decode_unicode_motorola</parameter> <type>string</type> </term> <listitem> <para> <literal>exif.decode_unicode_motorola</literal> définit le jeu de caractères interne pour les utilisateurs Unicode, si le commentaire de l'image est en big-endian (ordre de motorola). Cette option ne peut être vide, mais vous pouvez y spécifier une liste de jeux de caractères utilisés par mbstring. Par défaut, c'est <literal>UCS-2BE</literal>. </para> </listitem> </varlistentry> <varlistentry id="ini.exif.decode_unicode_intel"> <term> <parameter>exif.decode_unicode_intel</parameter> <type>string</type> </term> <listitem> <para> <literal>exif.decode_unicode_intel</literal> définit le jeu de caractères interne pour les utilisateurs Unicode, si le commentaire de l'image est en little-endian (ordre d'intel). Cette option ne peut être vide, mais vous pouvez y spécifier une liste de jeux de caractères utilisés par mbstring. Par défaut, c'est <literal>UCS-2LE</literal>. </para> </listitem> </varlistentry> <varlistentry id="ini.exif.encode_jis"> <term> <parameter>exif.encode_jis</parameter> <type>string</type> </term> <listitem> <para> <literal>exif.encode_jis</literal> définit le jeux de caractères pour les commentaires en JIS. Par défaut, c'est une valeur vide, ce qui force la fonction à utiliser le jeu de caractères interne de mbstring. </para> </listitem> </varlistentry> <varlistentry id="ini.exif.decode_jis_motorola"> <term> <parameter>exif.decode_jis_motorola</parameter> <type>string</type> </term> <listitem> <para> <literal>exif.decode_jis_motorola</literal> définit le jeu de caractères interne pour les utilisateurs JIS, si le commentaire de l'image est en big-endian (ordre de motorola). Cette option ne peut être vide, mais vous pouvez y spécifier une liste de jeux de caractères utilisés par mbstring. Par défaut, c'est <literal>JIS</literal>. </para> </listitem> </varlistentry> <varlistentry id="ini.exif.decode_jis_intel"> <term> <parameter>exif.decode_jis_intel</parameter> <type>string</type> </term> <listitem> <para> <literal>exif.decode_jis_intel</literal> définit le jeu de caractères interne pour les utilisateurs JIS, si le commentaire de l'image est en little-endian (ordre d'intel). Cette option ne peut être vide, mais vous pouvez y spécifier une liste de jeux de caractères utilisés par mbstring. Par défaut, c'est <literal>JIS</literal>. </para> </listitem> </varlistentry> </variablelist> </para> </section> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
Index: phpdoc-fr/reference/image/reference.xml diff -u phpdoc-fr/reference/image/reference.xml:1.2 phpdoc-fr/reference/image/reference.xml:1.3 --- phpdoc-fr/reference/image/reference.xml:1.2 Mon Apr 15 20:53:58 2002 +++ phpdoc-fr/reference/image/reference.xml Tue Dec 17 21:44:09 2002 @@ -1,42 +1,204 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <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> + <section id="image.intro"> + &reftitle.intro; + <para> + PHP ne se limite pas à la génération de pages HTML. Il peut aussi servir + à créer des et manipuler des images, dans un grand choix de formats, + comme gif, png, jpg, wbmp et xpm. Et même, PHP peut générer + directement des images pour le navigateur, avec la librarie GD. + GD et PHP auront aussi besoin de d'autres librairies, en fonction + des formats que vous souhaitez utiliser. + </para> + <para> + Vous pouvez utiliser les fonctions PHP pour obtenir les + tailles des images aux formats + <acronym>JPEG</acronym>, <acronym>GIF</acronym>, + <acronym>PNG</acronym>, <acronym>SWF</acronym>, + <acronym>TIFF</acronym> et <acronym>JPEG2000</acronym>. + </para> + <para> + <note> + <simpara> + Lisez la sections sur les pré-requis pour savoir comment améliorer + les possibilités le lecture, modification et écriture d'images, ainsi + que les possibilités de lecture d'images prises par des appareils + numériques. + </simpara> + </note> + </para> + </section> + + <section id="image.requirements"> + &reftitle.required; + <para> + Si vous disposez de la librairie <acronym>GD</acronym> (disponible + à <ulink url="&url.gd;">&url.gd;</ulink>) vous pourrez aussi créer + et manipuler ces images. + </para> + <para> Les formats des images que vous pourrez manipuler dépendent de la version de GD que vous installerez, et de toute autre librairie dont GD a besoin pour traiter à ces images. Les versions antérieures à la version 1.6 supportent le <acronym>GIF</acronym>, mais pas le <acronym>PNG</acronym>. Pour les versions plus récentes, c'est le contraire. - </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> + <note> + <simpara> + Depuis PHP 4.3, il existe une version de GD qui est distribuée avec + PHP. Cette version contient des fonctionnalités supplémentaires, comme + les canaux alpha, et il est recommandé de l'utiliser de préférence à + la librairie externe, car elle est mieux supportée, et bien plus + stable. + </simpara> + </note> + </para> + <para> + Vous pouvez aussi améliorer GD en lui ajoutant des formats + d'images supplémentaires. + <table> + <title>Formats d'images supportés</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Format d'image</entry> + <entry>Librairie à télécharger</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>gif</literal></entry> + <entry></entry> + <entry> + Uniquement supporté en versions de GF antérieure à gd-1.6. + Le support des images GIF est disponible <emphasis>en lecture seule</emphasis> + depuis PHP 4.3.0, et dans la version de la librairie qui est fournie + avec la distribution de &php;. + </entry> + </row> + <row> + <entry><literal>jpeg-6b</literal></entry> + <entry><ulink url="&url.jpeg;">&url.jpeg;</ulink></entry> + <entry></entry> + </row> + <row> + <entry><literal>png</literal></entry> + <entry><ulink url="&url.libpng;">&url.libpng;</ulink></entry> + <entry> + Uniquement supporté avec GD plus récente que gd-1.6. + </entry> + </row> + <row> + <entry><literal>xpm</literal></entry> + <entry><ulink url="&url.libxpm;">&url.libxpm;</ulink></entry> + <entry> + Il est probable que vous ayez déjà cette librairie disponible si + votre système dispose d'un environnement X. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + + <para> + Vous pouvez aussi améliorer GD en lui ajoutant des fonctionalités de + manipulation de polices. Les librairies suivantes sont supportées : + <table> + <title>Supported font libraries</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Librarie de police</entry> + <entry>Téléchargement</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>FreeType 1.x</literal></entry> + <entry><ulink url="&url.freetype;">&url.freetype;</ulink></entry> + <entry></entry> + </row> + <row> + <entry><literal>FreeType 2</literal></entry> + <entry><ulink url="&url.freetype;">&url.freetype;</ulink></entry> + <entry></entry> + </row> + <row> + <entry><literal>T1lib</literal></entry> + <entry><ulink url="&url.t1lib;">&url.t1lib;</ulink>)</entry> + <entry> + Support des polices de Type 1. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + Si vous avez compilé PHP avec l'option <option role="configure">--enable-exif</option> + vous serez capable d'accéder aux données stockées dans les entêtes des images + <acronym>JPEG</acronym> et <acronym>TIFF</acronym>. De cette façon, vous + pouvez lire les méta données générées par les appareils numériques. + Ces fonctions ne requièrent par la librairie <acronym>GD</acronym>. + <note> + <simpara> + PHP ne requiert aucune librairie supplémentaire pour gérer les données EXIF. + </simpara> + </note> + </para> + </section> + + &reference.image.configure; + + &reference.image.ini; + + <section id="image.resources"> + &reftitle.resources; + &no.resource; + </section> + + &reference.image.constants; + + + <section id="image.examples"> + &reftitle.examples; + <para> + <example> + <title>Création d'une image PNG avec PHP</title> + <programlisting role="php"> +<![CDATA[ +<?php + header("Content-type: image/png"); + $string = $_GET['text']; + $im = imagecreatefrompng("images/button1.png"); + $orange = imagecolorallocate($im, 220, 210, 60); + $px = (imagesx($im) - 7.5 * strlen($string)) / 2; + imagestring($im, 3, $px, 9, $string, $orange); + imagepng($im); + imagedestroy($im); +?> +]]> + </programlisting> + </example> + Cet exemple doit être appelé depuis une page HTML avec une balise + image telle que : <literal><img src="button.php?text"></literal>. + Le script ci-dessus, button.php, prend la chaîne + "text" et l'inscrit sur le fond d'image appelée + "images/button1.png" et l'affiche. C'est une méthode très + pratique pour éviter de redessiner un nouveau bouteau, dès que vous + changez le texte d'un bouton. De cette façon, les boutons sont dynamiquement + générés. + </para> + </section> </partintro> - <!-- 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. - --> &reference.image.functions; Index: phpdoc-fr/reference/image/configure.xml +++ phpdoc-fr/reference/image/configure.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <section id="image.installation"> &reftitle.install; <para> Pour activer le support de GD, vous devez compiler &php; avec l'option <option role="configure">--with-gd[=DIR]</option>, où DIR est le dossier d'installation de GD. Il est recommandé d'utiliser la version de GD qui est distribué avec PHP, en utilisant simplement l'option <option role="configure">--with-gd</option>. </para> <para> Augmentez les possibilités des GD de gérer d'autres formats d'images en spécifiant les options de compilations suivantes : <table> <title>Formats d'image supportés</title> <tgroup cols="2"> <thead> <row> <entry>Format d'image</entry> <entry>Option de compilation</entry> </row> </thead> <tbody> <row> <entry><literal>jpeg-6b</literal></entry> <entry> Pour activer le support de la librairie JPEG-6b, ajouter l'option <option role="configure">--with-jpeg-dir=DIR</option>. </entry> </row> <row> <entry><literal>png</literal></entry> <entry> Pour activer le support de la librairie PNG, ajouter l'option <option role="configure">--with-png-dir=DIR</option>. Notez que libpng requiert la librairie <link linkend="zlib.requirements">zlib</link>, et donc, il vous faudra ajouter aussi <option role="configure">--with-zlib-dir[=DIR]</option> dans votre ligne de compilation. </entry> </row> <row> <entry><literal>xpm</literal></entry> <entry> Pour activer le support de la librairie XPM, ajoutez l'option <option role="configure">--with-xpm-dir=DIR</option>. Si le script de compilation n'est pas capable de trouver les librairies nécessaires, il vous faudra ajouter le chemin vers les librairies X11. </entry> </row> </tbody> </tgroup> </table> </para> <para> Augmentez les possibilités de GD pour qu'elle manipule différentes types de polices de caractères en ajoutant les options de compilations suivantes : <table> <title>Librairies des polices de caractères supportées</title> <tgroup cols="2"> <thead> <row> <entry>Librairie</entry> <entry>Option de configuration</entry> </row> </thead> <tbody> <row> <entry><literal>FreeType 1.x</literal></entry> <entry> Pour activer le support de FreeType 1.x, ajoutez l'option <option role="configure">--with-ttf[=DIR]</option>. </entry> </row> <row> <entry><literal>FreeType 2</literal></entry> <entry> Pour activer le support de FreeType 2, ajoutez l'option <option role="configure">--with-freetype-dir=DIR</option>. </entry> </row> <row> <entry><literal>T1lib</literal></entry> <entry> Pour activer le support de T1lib (Type 1 fonts), ajoutez l'option <option role="configure">--with-t1lib[=DIR]</option>. </entry> </row> <row> <entry><literal>Native TrueType string function</literal></entry> <entry> Pour activer le support des chaînes de caractères TrueType, ajoutez l'option <option role="configure">--enable-gd-native-ttf</option>. </entry> </row> </tbody> </tgroup> </table> </para> </section> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/reference/image/constants.xml +++ phpdoc-fr/reference/image/constants.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <section id="image.constants"> &reftitle.constants; &extension.constants; <variablelist> <varlistentry> <term> <constant>IMG_GIF</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_JPG</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_JPEG</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_PNG</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_WBMP</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_XPM</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_COLOR_TILED</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_COLOR_STYLED</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_COLOR_BRUSHED</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_COLOR_STYLEDBRUSHED</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_COLOR_TRANSPARENT</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_ARC_ROUNDED</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_ARC_PIE</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_ARC_CHORD</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_ARC_NOFILL</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMG_ARC_EDGED</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_GIF</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_JPG</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_PNG</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_SWF</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_PSD</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_BMP</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_TIFF_II</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_TIFF_MM</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_JPC</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_JP2</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_JPX</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IMAGETYPE_SWC</constant> (&integer;) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> </variablelist> </section> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/reference/image/ini.xml +++ phpdoc-fr/reference/image/ini.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <section id="image.configuration"> &reftitle.runtime; &extension.runtime; <para> Exif supporte automatiquement la conversion en Unicode et JIS pour les commentaires des utilisateurs, lorsque le module <link linkend="ref.mbstring">mbstring</link> est disponible. Cela se fait en décodant le commentaire avec le bon jeu de caractères. Le résultat peut alors être encodé dans le jeu de caractères de votre serveur HTTP. <table> &ini.table.title; <tgroup cols="3"> <thead> &ini.table.top; </thead> <tbody> <row> <entry>exif.encode_unicode</entry> <entry>"ISO-8859-15"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>exif.decode_unicode_motorola</entry> <entry>"UCS-2BE"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>exif.decode_unicode_intel</entry> <entry>"UCS-2LE"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>exif.encode_jis</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>exif.decode_jis_motorola</entry> <entry>"JIS"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>exif.decode_jis_intel</entry> <entry>"JIS"</entry> <entry>PHP_INI_ALL</entry> </row> </tbody> </tgroup> </table> &ini.table.bottom; </para> <para> &ini.explain; <variablelist> <varlistentry id="ini.exif.encode_unicode"> <term> <parameter>exif.encode_unicode</parameter> <type>string</type> </term> <listitem> <para> <literal>exif.encode_unicode</literal> définit le jeu de caractères UNICODE utilisé pour les commentaires. Par défaut, c'est <literal>ISO-8859-15</literal>, qui devrait fonctionner pour les pays non asiatiques. Cette option peut être vide, ou bien contenir un jeu de caractères qui qui est supporté par mbstring. Si cette option est vide, la configuration de mbstring sera utilisée. </para> </listitem> </varlistentry> <varlistentry id="ini.exif.decode_unicode_motorola"> <term> <parameter>exif.decode_unicode_motorola</parameter> <type>string</type> </term> <listitem> <para> <literal>exif.decode_unicode_motorola</literal> définit le jeu de caractères interne pour les utilisateurs Unicode, si le commentaire de l'image est en big-endian (ordre de motorola). Cette option ne peut être vide, mais vous pouvez y spécifier une liste de jeux de caractères utilisés par mbstring. Par défaut, c'est <literal>UCS-2BE</literal>. </para> </listitem> </varlistentry> <varlistentry id="ini.exif.decode_unicode_intel"> <term> <parameter>exif.decode_unicode_intel</parameter> <type>string</type> </term> <listitem> <para> <literal>exif.decode_unicode_intel</literal> définit le jeu de caractères interne pour les utilisateurs Unicode, si le commentaire de l'image est en little-endian (ordre d'intel). Cette option ne peut être vide, mais vous pouvez y spécifier une liste de jeux de caractères utilisés par mbstring. Par défaut, c'est <literal>UCS-2LE</literal>. </para> </listitem> </varlistentry> <varlistentry id="ini.exif.encode_jis"> <term> <parameter>exif.encode_jis</parameter> <type>string</type> </term> <listitem> <para> <literal>exif.encode_jis</literal> définit le jeux de caractères pour les commentaires en JIS. Par défaut, c'est une valeur vide, ce qui force la fonction à utiliser le jeu de caractères interne de mbstring. </para> </listitem> </varlistentry> <varlistentry id="ini.exif.decode_jis_motorola"> <term> <parameter>exif.decode_jis_motorola</parameter> <type>string</type> </term> <listitem> <para> <literal>exif.decode_jis_motorola</literal> définit le jeu de caractères interne pour les utilisateurs JIS, si le commentaire de l'image est en big-endian (ordre de motorola). Cette option ne peut être vide, mais vous pouvez y spécifier une liste de jeux de caractères utilisés par mbstring. Par défaut, c'est <literal>JIS</literal>. </para> </listitem> </varlistentry> <varlistentry id="ini.exif.decode_jis_intel"> <term> <parameter>exif.decode_jis_intel</parameter> <type>string</type> </term> <listitem> <para> <literal>exif.decode_jis_intel</literal> définit le jeu de caractères interne pour les utilisateurs JIS, si le commentaire de l'image est en little-endian (ordre d'intel). Cette option ne peut être vide, mais vous pouvez y spécifier une liste de jeux de caractères utilisés par mbstring. Par défaut, c'est <literal>JIS</literal>. </para> </listitem> </varlistentry> </variablelist> </para> </section> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->