doc-fr/reference/image/functions/imagepstext.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.17 $ -->
<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
 <refentry id="function.imagepstext">
  <refnamediv>
   <refname>imagepstext</refname>
   <refpurpose>Dessine un texte sur une image avec une police PostScript Type1</refpurpose>
  </refnamediv>
  <refsect1>
   &reftitle.description;
     <methodsynopsis>
      <type>array</type><methodname>imagepstext</methodname>
      <methodparam><type>resource</type><parameter>image</parameter></methodparam>
      <methodparam><type>string</type><parameter>text</parameter></methodparam>
      <methodparam><type>resource</type><parameter>font</parameter></methodparam>
      <methodparam><type>int</type><parameter>size</parameter></methodparam>
      <methodparam><type>int</type><parameter>foreground</parameter></methodparam>
      <methodparam><type>int</type><parameter>background</parameter></methodparam>
      <methodparam><type>int</type><parameter>x</parameter></methodparam>
      <methodparam><type>int</type><parameter>y</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>space</parameter></methodparam>
      <methodparam><type>int</type><parameter>tightness</parameter></methodparam>
      <methodparam><type>float</type><parameter>angle</parameter></methodparam>
      <methodparam><type>int</type><parameter>antialias_steps</parameter></methodparam>
     </methodsynopsis>
   <para>
    <parameter>foreground</parameter> est la couleur avec 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 caractère. 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>size</parameter> est exprimé en pixels.
   </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ée 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'espaces caractère, ce qui vaut 1/1000ème d'un 
    em-carré (un em : unité de mesure représentée par un carré 
    dont la dimension horizontale est la même que le corps du caractère).
   </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>

   &note.config.t1lib;

   <para>
    Voir aussi
    <function>imagepsbbox</function>.
   </para>
  </refsect1>
 </refentry>

<!-- 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
-->