Fix help issues (warnings + wrong format in files)
[scilab.git] / 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>