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

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!--
   3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
   4  * Copyright (C) ENPC - Jean-Philippe Chancelier
   5  * Copyright (C) 2013 - Samuel GOUGEON
   6  *
   7  * This file must be used under the terms of the CeCILL.
   8  * This source file is licensed as described in the file COPYING, which
   9  * you should have received as part of this distribution.  The terms
  10  * are also available at
  11  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  12  *
  13  -->
  14 <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">
  15     <refnamediv>
  16         <refname>replot</refname>
  17         <refpurpose>reformula a área de exibição de um ou mais gráficos
  18         </refpurpose>
  19     </refnamediv>
  20     <refsynopsisdiv>
  21         <title>Seqüência de Chamamento</title>
  22         <synopsis>replot(area)</synopsis>
  23         <synopsis>replot(area, axesHandles)</synopsis>
  24     </refsynopsisdiv>
  25     <refsection>
  26         <title>Parâmetros</title>
  27         <variablelist>
  28             <varlistentry>
  29                 <term>area</term>
  30                 <listitem>
  31                     <para>vetor linha de tamanho 4.</para>
  32                 </listitem>
  33             </varlistentry>
  34             <varlistentry>
  35                 <term>axesHandles</term>
  36                 <listitem>
  37                     <para>argumento opcional. Manipulador(es) do tipo Axes para
  38                         selecionar uma ou várias entidades Axes válidas. Disponível apenas
  39                         no novo modo de gráficos.
  40                     </para>
  41                 </listitem>
  42             </varlistentry>
  43         </variablelist>
  44     </refsection>
  45     <refsection>
  46         <title>Descrição</title>
  47         <para>
  48             <literal>replot</literal> é utilizado para redesenhar o conteúdo da
  49             janela de gráficos atual com novas fronteiras definidas por
  50             <literal>area = [xmin,ymin,xmax,ymax]</literal> ou <literal> rect = [xmin, ymin, zmin, xmax, ymax, zmax] </literal>.
  51         </para>
  52         <para>Sob o novo modo de gráficos, esta transformação pode ser aplicada a
  53             eixos específicos fornecidos por manipuladores gráficos Axes via o
  54             argumento <varname>axesHandles</varname>. Se <varname>axesHandles</varname>
  55             não for especificado, as novas fronteiras são
  56             aplicadas aos eixos correntes da figura corrente. A transformação muda os
  57             valores de <literal>data_bounds</literal> para estes eixos.
  58             <note>
  59                 A propriedade de eixos <literal>tight_limits</literal> também deve ser
  60                 ajustada para "on" para selecionar estritamente estas fronteiras (ver
  61                 <link linkend="axes_properties">axes_properties</link>).
  62             </note>
  63         </para>
  64     </refsection>
  65     <refsection>
  66         <title>Exemplos</title>
  67         <programlisting role="example"><![CDATA[
  68 // primeiro exemplo
  69 x=[0:0.1:2*%pi]';
  70 plot2d(x,sin(x))
  71 replot([-1,-1,10,2])
  72 // segundo exemplo
  73 xdel(winsid());
  74 plot() // esboçando demonstração
  75 f=gcf();
  76 replot([-1,-1,10,2],f.children(1)) // especificando o valor do manipulador dos eixos
  77 replot([-3,-2,8,4],f.children(2))
  78  ]]></programlisting>
  79         <programlisting role="example"><![CDATA[
  80 // ?????
  81 xdel(winsid());
  82 plot() // plot demo
  83 f=gcf();
  84 replot([-1,-1,10,2],f.children(1)) // axes?????????
  85 replot([-3,-2,8,4],f.children(2))
  86  ]]></programlisting>
  87         <scilab:image>
  88             xdel(winsid());
  89             plot()
  90             f2=gcf();
  91             replot([-1,-1,10,2],f2.children(1))
  92             replot([-3,-2,8,4],f2.children(2))
  93         </scilab:image>
  94         <programlisting role="example"><![CDATA[
  95 // Os fronteiras indicadas pelo valor %nan não são alterados:
  96 x = linspace(0,360,200).';
  97 clf
  98 plot2d(x,[sind(x) tand(x)])
  99 ax = gca();
 100 ax.data_bounds                          // Fronteiras iniciais
 101 replot([%nan,-10,%nan,10])      // Ymin e Ymax só são modificados
 102 ax.data_bounds                          // novas fronteiras
 103 // 3D Fronteiras Z também pode ser modificadas :
 104 clf
 105 x = linspace(-4,4,100);
 106 X = meshgrid(x);
 107 R = (X-0.5).^2 + (X.'+0.7).^2;
 108 Z = sinc(R);
 109 surf(x-0.5,x+0.7,Z)
 110 f = gcf();
 111 f.color_map = autumncolormap(100);
 112 ax = gca();
 113 ax.data_bounds
 114 sleep(3000)
 115 replot([-5 0 -0.4 0 5 0.5])
 116 ax.data_bounds
 117 // Diversos gráficos podem ser cortadas simultaneamente :
 118 clf
 119 x = linspace(-%pi,%pi,400);
 120 subplot(2,2,1)
 121 plot2d(x,sin(1 ./sqrt(abs(x))))
 122 ax1 = gca();
 123 subplot(2,2,2)
 124 plot2d(x,sinh(sqrt(abs(x))))
 125 subplot(2,1,2)
 126 plot2d(x,cos(1 ./sqrt(abs(x))))
 127 ax2 = gca();
 128 sleep(4000)
 129 f = gcf();
 130 replot([-1 %nan 1.5 %nan], [ax1 ax2])
 131       ]]></programlisting>
 132     </refsection>
 133     <refsection role="see also">
 134         <title>Ver Também</title>
 135         <simplelist type="inline">
 136             <member>
 137                 <link linkend="zoom_rect">zoom_rect</link>
 138             </member>
 139             <member>
 140                 <link linkend="rubberbox">rubberbox</link>
 141             </member>
 142             <member>
 143                 <link linkend="axes_properties">axes_properties</link>
 144             </member>
 145         </simplelist>
 146     </refsection>
 147     <refsection>
 148         <title>histórico</title>
 149         <revhistory>
 150             <revision>
 151                 <revnumber>5.5.0</revnumber>
 152                 <revdescription>
 153                     <itemizedlist>
 154                         <listitem>
 155                             <para>Extensão para o 3D</para>
 156                         </listitem>
 157                         <listitem>
 158                             <para>Vários coordenadas gráficos podem agora ser redimensionadas simultaneamente</para>
 159                         </listitem>
 160                         <listitem>
 161                             <para>
 162                                 <literal>%nan</literal> pode ser usado para manter um limite como está.
 163                             </para>
 164                         </listitem>
 165                     </itemizedlist>
 166                 </revdescription>
 167             </revision>
 168         </revhistory>
 169     </refsection>
 170 </refentry>