doc-fr/reference/printer/functions/printer-create-font.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.12 $ -->
<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->

<refentry xml:id="function.printer-create-font" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>printer_create_font</refname>
  <refpurpose>Crée une nouvelle police</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>resource</type><methodname>printer_create_font</methodname>
   <methodparam><type>string</type><parameter>face</parameter></methodparam>
   <methodparam><type>int</type><parameter>height</parameter></methodparam>
   <methodparam><type>int</type><parameter>width</parameter></methodparam>
   <methodparam><type>int</type><parameter>font_weight</parameter></methodparam>
   <methodparam><type>bool</type><parameter>italic</parameter></methodparam>
   <methodparam><type>bool</type><parameter>underline</parameter></methodparam>
   <methodparam><type>bool</type><parameter>strikeout</parameter></methodparam>
   <methodparam><type>int</type><parameter>orientation</parameter></methodparam>
  </methodsynopsis>
  <para>
   Cette fonction crée une nouvelle police et retourne un gestionnaire représentant
   celle-ci. Une police est utilisée pour dessiner le texte. Pour un exemple,
   voir la documentation de la fonction <function>printer_select_font</function>.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>face</parameter></term>
     <listitem>
      <para>
       <parameter>face</parameter> doit être une &string; spécifiant le nom de la police.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>height</parameter></term>
     <listitem>
      <para>
       <parameter>height</parameter> spécifie la hauteur de la police.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>width</parameter></term>
     <listitem>
      <para>
       <parameter>width</parameter> spécifie la largeur de la police.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>font_weight</parameter></term>
     <listitem>
      <para>
       <parameter>font_weight</parameter> spécifie le poids de la police
       (400 est normal), et peut prendre comme valeur l'une des constantes suivantes :
       <itemizedlist>
        <listitem>
         <simpara>
          <constant>PRINTER_FW_THIN</constant>:
          fixe un poids de police mince (100).
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>PRINTER_FW_ULTRALIGHT</constant>:
          fixe un poids de police très léger (200).
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>PRINTER_FW_LIGHT</constant>:
          fixe un poids de police léger (300).
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>PRINTER_FW_NORMAL</constant>:
          fixe un poids de police normal (400).
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>PRINTER_FW_MEDIUM</constant>:
          fixe un poids de police moyen (500).
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>PRINTER_FW_BOLD</constant>:
          fixe un poids de police gras (700).
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>PRINTER_FW_ULTRABOLD</constant>:
          fixe un poids de police très gras (800).
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>PRINTER_FW_HEAVY</constant>:
          fixe un poids de police lourd (900).
         </simpara>
        </listitem>
       </itemizedlist>
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>italic</parameter></term>
     <listitem>
      <para>
       <parameter>italic</parameter> vaut &true; pour indiquer
       que la police est en italique, et &false; sinon.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>underline</parameter></term>
     <listitem>
      <para>
       <parameter>underline</parameter> vaut &true; pour indiquer
       que la police est soulignée, et &false; sinon.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>strikeout</parameter></term>
     <listitem>
      <para>
       <parameter>strikeout</parameter> vaut &true; pour indiquer
       que la police est barrée, et &false; sinon.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>orientaton</parameter></term>
     <listitem>
      <para>
       <parameter>orientation</parameter> spécifie l'orientation.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Retourne un gestionnaire de police en cas de succès,
   &false; si une erreur survient.
  </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
-->