3030b08c89d505dc297a0d0d8c7b197fcb6a303d
[scilab.git] / scilab / modules / graphics / help / fr_FR / geometric_shapes / xrects.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="fr" xml:id="xrects">
3     <refnamediv>
4         <refname>xrects</refname>
5         <refpurpose>dessine ou remplit un ensemble de rectangles  </refpurpose>
6     </refnamediv>
7     <refsynopsisdiv>
8         <title>Séquence d'appel</title>
9         <synopsis>xrects(rects,[fill])</synopsis>
10     </refsynopsisdiv>
11     <refsection>
12         <title>Paramètres</title>
13         <variablelist>
14             <varlistentry>
15                 <term>rects  </term>
16                 <listitem>
17                     <para>matrice de taille (4,n).
18                     </para>
19                 </listitem>
20             </varlistentry>
21             <varlistentry>
22                 <term>fill  </term>
23                 <listitem>
24                     <para>vecteur de taille n.
25                     </para>
26                 </listitem>
27             </varlistentry>
28         </variablelist>
29     </refsection>
30     <refsection>
31         <title>Description</title>
32         <para>
33             <literal>xrects</literal> dessine ou remplit un ensemble de rectangles. 
34             Chaque colonne de <literal>rects</literal> décrit un 
35             rectangle (point en haut à gauche, largeur, hauteur) en coordonnées utilisateur:
36             <literal>rects=[x1 y1 w1 h1;x2 y2 w2 h2;...]'</literal>.
37         </para>
38         <para>
39             <literal>fill(i)</literal> définit le motif utilisé pour dessiner ou remplir le rectangle i:
40         </para>
41         <para>
42             si <literal>fill(i)&lt;0</literal>, le rectangle <literal>i</literal> est dessiné avec la couleur
43             <literal>-fill(i)</literal>.
44         </para>
45         <para>
46             si <literal>fill(i)&gt;0</literal>, le rectangle <literal>i</literal> est rempli avec la couleur
47             <literal>fill(i)</literal>.
48         </para>
49         <para>
50             si <literal>fill(i)=0</literal>, le rectangle <literal>i</literal> est dessiné avec le style de ligne courant.
51         </para>
52         <para>ATTENTION : notez que la valeur de la hauteur est positive en allant vers la bas.</para>
53     </refsection>
54     <refsection>
55         <title>Exemples</title>
56         <programlisting role="example"><![CDATA[ 
57 plot2d([-100,500],[-50,50],[-1,-1],"022")
58 cols=[-34,-33,-32,-20:5:20,32,33,34];
59 x=400*(0:14)/14; step=20;
60 rects=[x;10*ones(x);step*ones(x);30*ones(x)];
61 xrects(rects,cols)
62 xnumb(x,15*ones(x),cols)
63  ]]></programlisting>
64         <scilab:image>
65             plot2d([-100,500],[-50,50],[-1,-1],"022")
66             cols=[-34,-33,-32,-20:5:20,32,33,34];
67             x=400*(0:14)/14; step=20;
68             rects=[x;10*ones(x);step*ones(x);30*ones(x)];
69             xrects(rects,cols)
70             xnumb(x,15*ones(x),cols)
71         </scilab:image>
72         
73     </refsection>
74     <refsection role="see also">
75         <title>Voir aussi</title>
76         <simplelist type="inline">
77             <member>
78                 <link linkend="xfrect">xfrect</link>
79             </member>
80             <member>
81                 <link linkend="xrect">xrect</link>
82             </member>
83         </simplelist>
84     </refsection>
85 </refentry>