doc-fr/reference/ps/functions/ps-findfont.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: dams Status: ready -->
<!-- Reviewed: yes -->

<refentry xml:id="function.ps-findfont" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>ps_findfont</refname>
  <refpurpose>Charge une police</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>int</type><methodname>ps_findfont</methodname>
   <methodparam><type>resource</type><parameter>psdoc</parameter></methodparam>
   <methodparam><type>string</type><parameter>fontname</parameter></methodparam>
   <methodparam><type>string</type><parameter>encoding</parameter></methodparam>
   <methodparam choice="opt"><type>bool</type><parameter>embed</parameter><initializer>&false;</initializer></methodparam>
  </methodsynopsis>
  <para>
   <function>ps_findfont</function> charge une police pour utilisation ultérieure. 
   Avant que le texte soit écrit avec la police chargée, il doit être fixé avec
   <function>ps_setfont</function>. Cette fonction doit avoir le fichier de
   police métrique "adobe" afin de calculer l'espace utilisé par les
   caractères. Une police qui est chargée dans une page sera seulement
   disponible sur cette page. Les polices qui seront utilisées dans le
   document complet doivent être chargées avant le premier appel de
   <function>ps_begin_page</function>. L'appel de
   <function>ps_findfont</function> entre les pages rendra cette police
   disponible pour toutes les pages qui suivent.
  </para>
  <para>
   Le nom du fichier afm doit être
   <parameter>fontname</parameter><literal>.afm</literal>. Si la police doit
   être incorporée, le fichier
   <parameter>fontname</parameter><literal>.pfb</literal> contenant le dessin
   de la police doit être présent aussi.
  </para>
  <para>
   L'appel de <function>ps_findfont</function> avant la première page requiert
   l'affichage de l'en-tête du postscript qui inclut le BoundingBox pour le
   document entier. Normalement, le BoundingBox est fixé avec le premier appel
   de <function>ps_begin_page</function> qui vient maintenant après
   <function>ps_findfont</function>. En conséquence, le BoundingBox n'a pas
   été fixée et une erreur sera lancée lorsque
   <function>ps_findfont</function> sera appelée. Afin de prévenir cette
   situation, vous devriez appeler la fonction
   <function>ps_set_parameter</function> pour fixer le BoundingBox avant que
   <function>ps_findfont</function> soit appelée.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>psdoc</parameter></term>
     <listitem>
      <para>
       Identifiant d'un fichier postscript retourné par
       <function>ps_new</function>.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>fontname</parameter></term>
     <listitem>
      <para>
       Le nom de la police. 
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>encoding</parameter></term>
     <listitem>
      <para>
       <function>ps_findfont</function> essaiera de charger le fichier passé
       dans le paramètre <parameter>encoding</parameter>. Les fichiers
       d'encodage sont de même syntaxe que ceux utilisés par
       <command>dvips(1)</command>. Ils contiennent un vecteur de police
       d'encodage (qui n'est actuellement pas utilisé, mais qui doit être
       présent) et une liste de ligatures en extra pour prolonger la liste des
       ligatures dérivées du fichier AFM.
      </para>
      <para>
       <parameter>encoding</parameter> peut être &null; ou une &string; vide
       si l'encodage par défaut (TeXBase1) désire être utilisé.
      </para>
      <para>
       Si l'encodage est fixé à <literal>builtin</literal> alors il n'y aura
       pas d'encodage à nouveau et l'encodage spécifique de police sera
       utilisé. Cela est très utile pour les polices avec symboles.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>embed</parameter></term>
     <listitem>
      <para>
       Si fixé à une valeur >0, la police sera incorporée dans le document.
       Ceci requiert la présence du fichier dessin (.pfb).
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Retourne un identifiant de la police ou zéro en cas d'erreur. L'identifiant
   est un nombre positif.
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>ps_begin_page</function></member>
    <member><function>ps_setfont</function></member>
   </simplelist>
  </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:"~/.phpdoc/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
-->