bf02cb4318bdd31e32d383d38b65bf1221c3447a
[scilab.git] / 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