88148f90002da3d9c86a8177b5085bac115805ce
[scilab.git] / scilab / modules / graphics / help / fr_FR / axes_operations / replot.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2
3 <!--
4  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
5  * Copyright (C) ENPC - Jean-Philippe Chancelier
6  * Copyright (C) 2012 - Scilab Enterprises
7  * Copyright (C) 2013 - Samuel GOUGEON
8  * 
9  * This file must be used under the terms of the CeCILL.
10  * This source file is licensed as described in the file COPYING, which
11  * you should have received as part of this distribution.  The terms
12  * are also available at    
13  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
14  *
15  -->
16
17 <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="replot">
18     
19     <refnamediv>
20         
21         <refname>replot</refname>
22         
23         <refpurpose>recadre la zone affichée d'un ou plusieurs repères graphiques
24             
25         </refpurpose>
26         
27     </refnamediv>
28     
29     <refsynopsisdiv>
30         
31         <title>Séquence d'appel</title>
32         
33         <synopsis>replot(area)</synopsis>
34         
35         <synopsis>replot(area, axesHandles)</synopsis>
36         
37     </refsynopsisdiv>
38     
39     <refsection>
40         
41         <title>Paramètres</title>
42         
43         <variablelist>
44             
45             <varlistentry>
46                 
47                 <term>area</term>
48                 
49                 <listitem>
50                     
51                     <para>vecteur [xmin ymin xmax ymax] ou [xmin ymin zmin xmax ymax zmax]: nouvelles bornes de la zone à réafficher. 
52                         
53                         Utiliser <literal>%nan</literal> pour conserver une borne telle quelle.
54                     </para>
55                     
56                 </listitem>
57                 
58             </varlistentry>
59             
60             <varlistentry>
61                 
62                 <term>axesHandles</term>
63                 
64                 <listitem>
65                     
66                     <para>Vecteur d'identifiants graphiques de type Axes: repères graphiques à retailler. Par défaut, le repère graphique actif de la fenêtre graphique active est considéré.
67                         
68                     </para>
69                     
70                 </listitem>
71                 
72             </varlistentry>
73             
74         </variablelist>
75         
76     </refsection>
77     
78     <refsection>
79         
80         <title>Description</title>
81         
82         <para>
83             
84             <literal>replot</literal> est utilisée pour recadrer les repères graphiques spécifiés par <literal>axesHandles</literal> 
85             
86             (ou par défaut le repère graphique actif de la fenêtre graphique active) en changeant leurs bornes communes spécifiées sous la forme
87             
88             <literal>rect = [xmin,ymin, xmax,ymax]</literal> ou <literal>rect = [xmin,ymin,zmin, xmax,ymax,zmax]</literal>.
89             
90         </para>
91         
92         <para>
93             <varname>replot</varname> modifie les valeurs <literal>data_bounds</literal> des repères. 
94             
95             <note>
96                 La propriété <literal>tight_limits</literal> des repères doit
97                 
98                 être mise à  <literal>"on"</literal> pour sélectionner strictement ces bornes
99                 
100                 (voir <link linkend="axes_properties">axes_properties</link>).
101                 
102             </note>
103             
104         </para>
105         
106     </refsection>
107     
108     <refsection>
109         
110         <title>Exemples</title>
111         
112         <programlisting role="example"><![CDATA[ 
113       // Premier exemple
114       x=[0:0.1:2*%pi]';
115       plot2d(x,sin(x))
116       replot([-1,-1,10,2])
117  ]]></programlisting>
118         
119         <scilab:image>
120             
121             x=[0:0.1:2*%pi]';
122             
123             plot2d(x,sin(x))
124             
125             replot([-1,-1,10,2])
126             
127         </scilab:image>
128         
129         
130         
131         <programlisting role="example"><![CDATA[ 
132 // second exemple
133 xdel(winsid());
134 plot() // plot demo
135 f=gcf();
136 replot([-1,-1,10,2],f.children(1)) // specify axes handle's value
137 replot([-3,-2,8,4],f.children(2)) 
138  ]]></programlisting>
139         
140         <scilab:image>
141             
142             xdel(winsid());
143             
144             plot()
145             
146             f2=gcf();
147             
148             replot([-1,-1,10,2],f2.children(1))
149             
150             replot([-3,-2,8,4],f2.children(2))
151             
152         </scilab:image>
153         
154         <programlisting role="example"><![CDATA[
155 // Les bornes signalées par la valeur %nan ne sont pas modifiées :
156 x = linspace(0,360,200).';
157 clf
158 plot2d(x,[sind(x) tand(x)])
159 ax = gca();
160 ax.data_bounds                          // bornes initiales
161 replot([%nan,-10,%nan,10])      // Seules Ymin and Ymax sont modifiées
162 ax.data_bounds                          // nouvelles bornes
163
164 // En 3D, les bornes en Z peuvent également être modifiées :
165 clf
166 x = linspace(-4,4,100);
167 X = meshgrid(x);
168 R = (X-0.5).^2 + (X.'+0.7).^2;
169 Z = sinc(R);
170 surf(x-0.5,x+0.7,Z)
171 f = gcf();
172 f.color_map = autumncolormap(100);
173 ax = gca();
174 ax.data_bounds
175 sleep(3000)
176 replot([-5 0 -0.4 0 5 0.5])
177 ax.data_bounds
178
179 // Plusieurs repères graphiques peuvent être simultanément recadrés :
180 clf
181 x = linspace(-%pi,%pi,400);
182 subplot(2,2,1)
183 plot2d(x,sin(1 ./sqrt(abs(x))))
184 ax1 = gca();
185 subplot(2,2,2)
186 plot2d(x,sinh(sqrt(abs(x))))
187 subplot(2,1,2)
188 plot2d(x,cos(1 ./sqrt(abs(x))))
189 ax2 = gca();
190 sleep(4000)
191 f = gcf();
192 replot([-1 %nan 1.5 %nan], [ax1 ax2])
193       ]]></programlisting>
194         
195         
196         
197     </refsection>
198     
199     <refsection role="see also">
200         
201         <title>Voir aussi</title>
202         
203         <simplelist type="inline">
204             
205             <member>
206                 
207                 <link linkend="zoom_rect">zoom_rect</link>
208                 
209             </member>
210             
211             <member>
212                 
213                 <link linkend="rubberbox">rubberbox</link>
214                 
215             </member>
216             
217             <member>
218                 
219                 <link linkend="axes_properties">axes_properties</link>
220                 
221             </member>
222             
223         </simplelist>
224         
225     </refsection>
226     
227     <refsection>
228         
229         <title>Historique</title>
230         
231         <revhistory>
232             
233             <revision>
234                 
235                 <revnumber>5.5.0</revnumber>
236                 
237                 <revdescription>
238                     
239                     <itemizedlist>
240                         
241                         <listitem>
242                             
243                             <para>Extension en 3D</para>
244                             
245                         </listitem>
246                         
247                         <listitem>
248                             
249                             <para>Plusieurs repères graphiques peuvent être désormais redimensionnés simultanément</para>
250                             
251                         </listitem>
252                         
253                         <listitem>
254                             
255                             <para>
256                                 <literal>%nan</literal> peut être utilisé pour spécifier une borne inchangée.
257                             </para>
258                             
259                         </listitem>
260                         
261                     </itemizedlist>
262                     
263                 </revdescription>
264                 
265             </revision>
266             
267         </revhistory>
268         
269     </refsection>
270     
271 </refentry>
272