1b8a6be88ec973e416704889ac352398a12eede5
[scilab.git] / scilab / modules / graphics / help / fr_FR / xclip.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" version="5.0-subset Scilab" xml:lang="fr" xml:id="xclip">
3   <info>
4     <pubdate>$LastChangedDate$</pubdate>
5   </info>
6   <refnamediv>
7     <refname>xclip</refname>
8     <refpurpose> (obsolète) définit une zone de "clipping"  </refpurpose>
9   </refnamediv>
10   <refsynopsisdiv>
11     <title>Séquence d'appel</title>
12     <synopsis>xclip([x,y,w,h])
13 xclip(rect)
14 xclip("clipgrf")</synopsis>
15   </refsynopsisdiv>
16   <refsection>
17     <title>Paramètres</title>
18     <variablelist>
19       <varlistentry>
20         <term>x,y,w,h  </term>
21         <listitem>
22           <para>valeurs réelles.
23 </para>
24         </listitem>
25       </varlistentry>
26       <varlistentry>
27         <term>rect  </term>
28         <listitem>
29           <para>vecteur ligne de taille 4.
30 </para>
31         </listitem>
32       </varlistentry>
33     </variablelist>
34   </refsection>
35   <refsection>
36     <title>Description</title>
37     <para><literal>xclip</literal> définit une zone de "clipping" définie par les coordonnées, dans l'échelle courante, du rectangle <literal>x,y,w,h</literal> (point en haut à gauche, largeur, hauteur) : les opérations graphiques sont restreintes à ce rectangle.
38   </para>
39     <para>
40     Si un seul argument est donné, il est considéré comme une spécification de rectangle <literal>rect=[x,y,w,h]</literal>.
41   </para>
42     <para><literal>xclip("clipgrf")</literal> est utilisé pour utiliser la zone de clipping égale au cadre du dessin courant.
43   </para>
44     <para>
45     Pour supprimer l'effet d'une commande xclip précédente, utiliser <literal>xclip()</literal>.
46         </para><para>
47                 La fonction <literal>xclip</literal> est obsolète et sera supprimée définitivement de Scilab 5.2.
48                 Pour définir une zone de "clipping", les propriétés <literal>clip_state</literal> et <literal>clip_box</literal>
49                 des entités graphiques peuvent être utilisées.
50         </para>
51   </refsection>
52   <refsection>
53     <title>Exemples</title>
54     <programlisting role="example"><![CDATA[ 
55 x=0:0.2:2*%pi;
56 x1=[sin(x);100*sin(x)];
57 y1=[cos(x);100*cos(x)];
58 y1=y1+20*ones(y1);
59
60 // set the frame
61 clf();a=gca();a.data_bounds=[-100 -100;500 600];
62     
63 // No clipping
64 xsegs(10*x1+200*ones(x1),10*y1+200*ones(y1))
65 e=gce(); //handle on the Segs entity
66
67 // draw rectangle clipping zone 
68 xrect(150,460,100,150)
69 // set clip_box for  Segs entity
70 e.clip_box=[150,460,100,150];
71
72 // Set usual rectangle boundaries clipping zone 
73 e.clip_state='clipgrf';
74 xclip("clipgrf")
75 // remove clipping
76 e.clip_state='off';
77  ]]></programlisting>
78   </refsection>
79   <refsection>
80     <title>Voir Aussi</title>
81     <simplelist type="inline">
82       <member>
83         <link linkend="axes_properties">axes_properties</link>
84       </member>
85     </simplelist>
86   </refsection>
87   <refsection>
88     <title>Auteurs</title>
89     <para>J.Ph.C.  </para>
90   </refsection>
91 </refentry>