doc-fr/reference/image/reference.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.20 $ -->
<!-- EN-Revision: 1.22 Maintainer: didou Status: ready -->
<!-- Reviewed: yes -->
<reference id="ref.image">
 <title>Images</title>
 <titleabbrev>Images</titleabbrev>

 <partintro>
   <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 et manipuler des images, dans un grand choix de formats,
     comme <acronym>GIF</acronym>, <acronym>PNG</acronym>, <acronym>JPEG</acronym>, <acronym>WBMP</acronym> et <acronym>XPM</acronym>. Et &php; peut même générer
     directement des images pour le navigateur, avec la bibliothèque <acronym>GD</acronym>.
     <acronym>GD</acronym> et &php; auront aussi besoin d'autres bibliothèques, 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 section sur les pré-requis pour savoir comment améliorer
       les possibilités de 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 bibliothèque <acronym>GD</acronym> (disponible
     à <ulink url="&url.gd;">&url.gd;</ulink>) vous pourrez aussi créer
     et manipuler des images.
    </para>
    <para>
     Les formats des images que vous pourrez manipuler dépendent de la
     version de <acronym>GD</acronym> que vous installerez, et de toutes autres bibliothèques
     dont <acronym>GD</acronym> 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>.
     A partir de <acronym>GD</acronym> 1.6, c'est le contraire.
     <note>
      <simpara>
       Depuis &php; 4.3, il existe une version de <acronym>GD</acronym> 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 bibliothèque externe, car elle est mieux supportée, et bien plus 
       stable.
      </simpara>
     </note>
    </para>
    <para>
     Vous pouvez aussi améliorer <acronym>GD</acronym> 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>Bibliothèque à télécharger</entry>
         <entry>Notes</entry>
        </row>
       </thead>
       <tbody>
        <row>
         <entry><literal>gif</literal></entry>
         <entry></entry>
         <entry>
          Uniquement supporté en versions de <acronym>GD</acronym> antérieures à la version 1.6. 
          Le support des images <acronym>GIF</acronym> est disponible <emphasis>en lecture seule</emphasis>
          depuis &php; 4.3.0, et dans la version de la bibliothèque qui est fournie
          avec la distribution de &php;.
          L'<emphasis>écriture</emphasis> est supportée depuis &php; 4.3.9 et &php; 5.0.1.
         </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 <acronym>GD</acronym> plus récente que la version 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 bibliothèque disponible si
          votre système dispose d'un environnement X.
         </entry>
        </row>
       </tbody>
      </tgroup>
     </table>
    </para>

    <para>
     Vous pouvez aussi améliorer <acronym>GD</acronym> en lui ajoutant des fonctionnalités de 
     manipulation de polices. Les bibliothèques suivantes sont supportées : 
     <table>
     <title>Bibliothèques de polices supportées</title>
      <tgroup cols="3">
       <thead>
        <row>
         <entry>Bibliothèque 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 en-tê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 bibliothèque <acronym>GD</acronym>.
    </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 <acronym>PNG</acronym> 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>&lt;img src=&quot;button.php?text&quot;&gt;</literal>. 
     Le script ci-dessus, <filename>button.php</filename>, prend la chaîne 
     <literal>&quot;texte&quot;</literal> et l'inscrit
     sur le fond d'image appelé <literal>&quot;images/button1.png&quot;</literal>, 
     puis l'affiche. C'est une méthode très pratique pour éviter de redessiner un 
     nouveau bouton, dès que vous changez son texte. De cette façon, ils sont 
     générés dynamiquement.
    </para>
   </section>
 </partintro>

&reference.image.functions;

</reference>
<!-- 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:
-->