Fix help issues (warnings + wrong format in files)
[scilab.git] / scilab / modules / graphics / help / fr_FR / axes_operations / replot.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) ENPC - Jean-Philippe Chancelier
5  * Copyright (C) 2012 - Scilab Enterprises
6  * Copyright (C) 2013 - Samuel GOUGEON
7  * 
8  * This file must be used under the terms of the CeCILL.
9  * This source file is licensed as described in the file COPYING, which
10  * you should have received as part of this distribution.  The terms
11  * are also available at    
12  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
13  *
14  -->
15 <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">
16     <refnamediv>
17         <refname>replot</refname>
18         <refpurpose>recadre la zone affichée d'un ou plusieurs repères graphiques
19         </refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>Séquence d'appel</title>
23         <synopsis>replot(area)</synopsis>
24         <synopsis>replot(area, axesHandles)</synopsis>
25     </refsynopsisdiv>
26     <refsection>
27         <title>Paramètres</title>
28         <variablelist>
29             <varlistentry>
30                 <term>area</term>
31                 <listitem>
32                     <para>vecteur [xmin ymin xmax ymax] ou [xmin ymin zmin xmax ymax zmax]: nouvelles bornes de la zone à réafficher. 
33                         Utiliser <literal>%nan</literal> pour conserver une borne telle quelle.
34                     </para>
35                 </listitem>
36             </varlistentry>
37             <varlistentry>
38                 <term>axesHandles</term>
39                 <listitem>
40                     <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é.
41                     </para>
42                 </listitem>
43             </varlistentry>
44         </variablelist>
45     </refsection>
46     <refsection>
47         <title>Description</title>
48         <para>
49             <literal>replot</literal> est utilisée pour recadrer les repères graphiques spécifiés par <literal>axesHandles</literal> 
50             (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
51             <literal>rect = [xmin,ymin, xmax,ymax]</literal> ou <literal>rect = [xmin,ymin,zmin, xmax,ymax,zmax]</literal>.
52         </para>
53         <para>
54             <varname>replot</varname> modifie les valeurs <literal>data_bounds</literal> des repères. 
55             <note>
56                 La propriété <literal>tight_limits</literal> des repères doit
57                 être mise à  <literal>"on"</literal> pour sélectionner strictement ces bornes
58                 (voir <link linkend="axes_properties">axes_properties</link>).
59             </note>
60         </para>
61     </refsection>
62     <refsection>
63         <title>Exemples</title>
64         <programlisting role="example"><![CDATA[ 
65       // Premier exemple
66       x=[0:0.1:2*%pi]';
67       plot2d(x,sin(x))
68       replot([-1,-1,10,2])
69  ]]></programlisting>
70         <scilab:image>
71             x=[0:0.1:2*%pi]';
72             plot2d(x,sin(x))
73             replot([-1,-1,10,2])
74         </scilab:image>
75         <programlisting role="example"><![CDATA[ 
76 // second exemple
77 xdel(winsid());
78 plot() // plot demo
79 f=gcf();
80 replot([-1,-1,10,2],f.children(1)) // specify axes handle's value
81 replot([-3,-2,8,4],f.children(2)) 
82  ]]></programlisting>
83         <scilab:image>
84             xdel(winsid());
85             plot()
86             f2=gcf();
87             replot([-1,-1,10,2],f2.children(1))
88             replot([-3,-2,8,4],f2.children(2))
89         </scilab:image>
90         <programlisting role="example"><![CDATA[
91 // Les bornes signalées par la valeur %nan ne sont pas modifiées :
92 x = linspace(0,360,200).';
93 clf
94 plot2d(x,[sind(x) tand(x)])
95 ax = gca();
96 ax.data_bounds                          // bornes initiales
97 replot([%nan,-10,%nan,10])      // Seules Ymin and Ymax sont modifiées
98 ax.data_bounds                          // nouvelles bornes
99 // En 3D, les bornes en Z peuvent également être modifiées :
100 clf
101 x = linspace(-4,4,100);
102 X = meshgrid(x);
103 R = (X-0.5).^2 + (X.'+0.7).^2;
104 Z = sinc(R);
105 surf(x-0.5,x+0.7,Z)
106 f = gcf();
107 f.color_map = autumncolormap(100);
108 ax = gca();
109 ax.data_bounds
110 sleep(3000)
111 replot([-5 0 -0.4 0 5 0.5])
112 ax.data_bounds
113 // Plusieurs repères graphiques peuvent être simultanément recadrés :
114 clf
115 x = linspace(-%pi,%pi,400);
116 subplot(2,2,1)
117 plot2d(x,sin(1 ./sqrt(abs(x))))
118 ax1 = gca();
119 subplot(2,2,2)
120 plot2d(x,sinh(sqrt(abs(x))))
121 subplot(2,1,2)
122 plot2d(x,cos(1 ./sqrt(abs(x))))
123 ax2 = gca();
124 sleep(4000)
125 f = gcf();
126 replot([-1 %nan 1.5 %nan], [ax1 ax2])
127       ]]></programlisting>
128     </refsection>
129     <refsection role="see also">
130         <title>Voir aussi</title>
131         <simplelist type="inline">
132             <member>
133                 <link linkend="zoom_rect">zoom_rect</link>
134             </member>
135             <member>
136                 <link linkend="rubberbox">rubberbox</link>
137             </member>
138             <member>
139                 <link linkend="axes_properties">axes_properties</link>
140             </member>
141         </simplelist>
142     </refsection>
143     <refsection>
144         <title>Historique</title>
145         <revhistory>
146             <revision>
147                 <revnumber>5.5.0</revnumber>
148                 <revdescription>
149                     <itemizedlist>
150                         <listitem>
151                             <para>Extension en 3D</para>
152                         </listitem>
153                         <listitem>
154                             <para>Plusieurs repères graphiques peuvent être désormais redimensionnés simultanément</para>
155                         </listitem>
156                         <listitem>
157                             <para>
158                                 <literal>%nan</literal> peut être utilisé pour spécifier une borne inchangée.
159                             </para>
160                         </listitem>
161                     </itemizedlist>
162                 </revdescription>
163             </revision>
164         </revhistory>
165     </refsection>
166 </refentry>