scilab/modules/graphics/help/pt_BR/axes_operations/replot.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2
   3 <!--
   4  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
   5  * Copyright (C) ENPC - Jean-Philippe Chancelier
   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
  16 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="replot" xml:lang="pt">
  17
  18     <refnamediv>
  19
  20         <refname>replot</refname>
  21
  22         <refpurpose>reformula a área de exibição de um ou mais gráficos
  23
  24         </refpurpose>
  25
  26     </refnamediv>
  27
  28     <refsynopsisdiv>
  29
  30         <title>Seqüência de Chamamento</title>
  31
  32         <synopsis>replot(area)</synopsis>
  33
  34         <synopsis>replot(area, axesHandles)</synopsis>
  35
  36     </refsynopsisdiv>
  37
  38     <refsection>
  39
  40         <title>Parâmetros</title>
  41
  42         <variablelist>
  43
  44             <varlistentry>
  45
  46                 <term>area</term>
  47
  48                 <listitem>
  49
  50                     <para>vetor linha de tamanho 4.</para>
  51
  52                 </listitem>
  53
  54             </varlistentry>
  55
  56             <varlistentry>
  57
  58                 <term>axesHandles</term>
  59
  60                 <listitem>
  61
  62                     <para>argumento opcional. Manipulador(es) do tipo Axes para
  63
  64                         selecionar uma ou várias entidades Axes válidas. Disponível apenas
  65
  66                         no novo modo de gráficos.
  67
  68                     </para>
  69
  70                 </listitem>
  71
  72             </varlistentry>
  73
  74         </variablelist>
  75
  76     </refsection>
  77
  78     <refsection>
  79
  80         <title>Descrição</title>
  81
  82         <para>
  83
  84             <literal>replot</literal> é utilizado para redesenhar o conteúdo da
  85
  86             janela de gráficos atual com novas fronteiras definidas por
  87
  88             <literal>area = [xmin,ymin,xmax,ymax]</literal> ou <literal> rect = [xmin, ymin, zmin, xmax, ymax, zmax] </literal>.
  89
  90         </para>
  91
  92         <para>Sob o novo modo de gráficos, esta transformação pode ser aplicada a
  93
  94             eixos específicos fornecidos por manipuladores gráficos Axes via o
  95
  96             argumento <varname>axesHandles</varname>. Se <varname>axesHandles</varname>
  97
  98             não for especificado, as novas fronteiras são
  99
 100             aplicadas aos eixos correntes da figura corrente. A transformação muda os
 101
 102             valores de <literal>data_bounds</literal> para estes eixos.
 103
 104             <note>
 105                 A propriedade de eixos <literal>tight_limits</literal> também deve ser
 106
 107                 ajustada para "on" para selecionar estritamente estas fronteiras (ver
 108
 109                 <link linkend="axes_properties">axes_properties</link>).
 110
 111             </note>
 112
 113         </para>
 114
 115     </refsection>
 116
 117     <refsection>
 118
 119         <title>Exemplos</title>
 120
 121         <programlisting role="example"><![CDATA[
 122 // primeiro exemplo
 123 x=[0:0.1:2*%pi]';
 124 plot2d(x,sin(x))
 125 replot([-1,-1,10,2])
 126
 127 // segundo exemplo
 128 xdel(winsid());
 129 plot() // esboçando demonstração
 130 f=gcf();
 131 replot([-1,-1,10,2],f.children(1)) // especificando o valor do manipulador dos eixos
 132 replot([-3,-2,8,4],f.children(2))
 133  ]]></programlisting>
 134
 135         <programlisting role="example"><![CDATA[
 136 // ?????
 137 xdel(winsid());
 138 plot() // plot demo
 139 f=gcf();
 140 replot([-1,-1,10,2],f.children(1)) // axes?????????
 141 replot([-3,-2,8,4],f.children(2))
 142  ]]></programlisting>
 143
 144         <scilab:image>
 145
 146             xdel(winsid());
 147
 148             plot()
 149
 150             f2=gcf();
 151
 152             replot([-1,-1,10,2],f2.children(1))
 153
 154             replot([-3,-2,8,4],f2.children(2))
 155
 156         </scilab:image>
 157
 158         <programlisting role="example"><![CDATA[
 159 // Os fronteiras indicadas pelo valor %nan não são alterados:
 160 x = linspace(0,360,200).';
 161 clf
 162 plot2d(x,[sind(x) tand(x)])
 163 ax = gca();
 164 ax.data_bounds                          // Fronteiras iniciais
 165 replot([%nan,-10,%nan,10])      // Ymin e Ymax só são modificados
 166 ax.data_bounds                          // novas fronteiras
 167
 168 // 3D Fronteiras Z também pode ser modificadas :
 169 clf
 170 x = linspace(-4,4,100);
 171 X = meshgrid(x);
 172 R = (X-0.5).^2 + (X.'+0.7).^2;
 173 Z = sinc(R);
 174 surf(x-0.5,x+0.7,Z)
 175 f = gcf();
 176 f.color_map = autumncolormap(100);
 177 ax = gca();
 178 ax.data_bounds
 179 sleep(3000)
 180 replot([-5 0 -0.4 0 5 0.5])
 181 ax.data_bounds
 182
 183 // Diversos gráficos podem ser cortadas simultaneamente :
 184 clf
 185 x = linspace(-%pi,%pi,400);
 186 subplot(2,2,1)
 187 plot2d(x,sin(1 ./sqrt(abs(x))))
 188 ax1 = gca();
 189 subplot(2,2,2)
 190 plot2d(x,sinh(sqrt(abs(x))))
 191 subplot(2,1,2)
 192 plot2d(x,cos(1 ./sqrt(abs(x))))
 193 ax2 = gca();
 194 sleep(4000)
 195 f = gcf();
 196 replot([-1 %nan 1.5 %nan], [ax1 ax2])
 197       ]]></programlisting>
 198
 199     </refsection>
 200
 201     <refsection role="see also">
 202
 203         <title>Ver Também</title>
 204
 205         <simplelist type="inline">
 206
 207             <member>
 208
 209                 <link linkend="zoom_rect">zoom_rect</link>
 210
 211             </member>
 212
 213             <member>
 214
 215                 <link linkend="rubberbox">rubberbox</link>
 216
 217             </member>
 218
 219             <member>
 220
 221                 <link linkend="axes_properties">axes_properties</link>
 222
 223             </member>
 224
 225         </simplelist>
 226
 227     </refsection>
 228
 229     <refsection>
 230
 231         <title>histórico</title>
 232
 233         <revhistory>
 234
 235             <revision>
 236
 237                 <revnumber>5.5.0</revnumber>
 238
 239                 <revdescription>
 240
 241                     <itemizedlist>
 242
 243                         <listitem>
 244
 245                             <para>Extensão para o 3D</para>
 246
 247                         </listitem>
 248
 249                         <listitem>
 250
 251                             <para>Vários coordenadas gráficos podem agora ser redimensionadas simultaneamente</para>
 252
 253                         </listitem>
 254
 255                         <listitem>
 256
 257                             <para>
 258                                 <literal>%nan</literal> pode ser usado para manter um limite como está.
 259                             </para>
 260
 261                         </listitem>
 262
 263                     </itemizedlist>
 264
 265                 </revdescription>
 266
 267             </revision>
 268
 269         </revhistory>
 270
 271     </refsection>
 272
 273 </refentry>
 274