archived-doc-fr/reference/ps/functions/ps-begin-pattern.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: c6fb604f39a0fa7bf1ae872064b2a3a24f23d855 Maintainer: jsgoupil Status: ready -->
<!-- Reviewed: no -->

<refentry xml:id="function.ps-begin-pattern" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>ps_begin_pattern</refname>
  <refpurpose>Démarre un nouveau motif</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type class="union"><type>int</type><type>false</type></type><methodname>ps_begin_pattern</methodname>
   <methodparam><type>resource</type><parameter>psdoc</parameter></methodparam>
   <methodparam><type>float</type><parameter>width</parameter></methodparam>
   <methodparam><type>float</type><parameter>height</parameter></methodparam>
   <methodparam><type>float</type><parameter>xstep</parameter></methodparam>
   <methodparam><type>float</type><parameter>ystep</parameter></methodparam>
   <methodparam><type>int</type><parameter>painttype</parameter></methodparam>
  </methodsynopsis>
  <para>
   Démarre un nouveau motif. Un motif est comme une page contenant par exemple
   un dessin qui peut être utilisé pour remplir des secteurs. Il est utilisé
   comme une couleur en appelant <function>ps_setcolor</function> et en
   configurant l'emplacement de la couleur au <literal>motif</literal>.
  </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>width</parameter></term>
     <listitem>
      <para>
       La largeur du motif en pixel.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>height</parameter></term>
     <listitem>
      <para>
       La hauteur du motif en pixel.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>xstep</parameter></term>
     <listitem>
      <para>
       La distance en pixel de l'emplacement du motif dans la direction
       horizontale.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>ystep</parameter></term>
     <listitem>
      <para>
       La distance en pixel de l'emplacement du motif dans la direction
       verticale.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>painttype</parameter></term>
     <listitem>
      <para>
       Doit être 1 ou 2.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   L'identifiant du motif &return.falseforfailure;.
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Création et utilisation d'un motif</title>
    <programlisting role="php">
<![CDATA[
<?php
$ps = ps_new();

if (!ps_open_file($ps, "pattern.ps")) {
  print "Impossible d'ouvrir le fichier PostScript\n";
  exit;
}

ps_set_parameter($ps, "warning", "true");
ps_set_info($ps, "Creator", "pattern.php");
ps_set_info($ps, "Author", "Uwe Steinmann");
ps_set_info($ps, "Title", "Exemple de Motif");


$pspattern = ps_begin_pattern($ps, 10.0, 10.0, 10.0, 10.0, 1);
ps_setlinewidth($ps, 0.2);
ps_setcolor($ps, "stroke", "rgb", 0.0, 0.0, 1.0, 0.0);
ps_moveto($ps, 0, 0);
ps_lineto($ps, 7, 7);
ps_stroke($ps);
ps_moveto($ps, 0, 7);
ps_lineto($ps, 7, 0);
ps_stroke($ps);
ps_end_pattern($ps);

ps_begin_page($ps, 596, 842);
ps_setcolor($ps, "both", "pattern", $pspattern, 0.0, 0.0, 0.0);
ps_rect($ps, 50, 400, 200, 200);
ps_fill($ps);
ps_end_page($ps);

ps_close($ps);
ps_delete($ps);
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>ps_end_pattern</function></member>
    <member><function>ps_setcolor</function></member>
    <member><function>ps_shading_pattern</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
-->