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