Update unzoom and zoom_rect help pages. Warning message appeared: Syntax vector ...
[scilab.git] / scilab / modules / graphics / help / pt_BR / axes_operations / zoom_rect.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) INRIA - Serge Steer
5  * Copyright (C) INRIA - 2008 - Jean-Baptiste Silvy
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="zoom_rect" xml:lang="en">
15     <refnamediv>
16         <refname>zoom_rect</refname>
17         <refpurpose>Amplia uma seleção da figura gráfica corrente</refpurpose>
18     </refnamediv>
19     <refsynopsisdiv>
20         <title>Seqüência de Chamamento</title>
21         <synopsis>zoom_rect()
22             zoom_rect(rect)
23             zoom_rect(h)
24             zoom_rect(h,rect)
25         </synopsis>
26     </refsynopsisdiv>
27     <refsection>
28         <title>Parâmetros</title>
29         <variablelist>
30             <varlistentry>
31                 <term>rect</term>
32                 <listitem>
33                     <para>
34                         vetor de tamanho 4 <literal>[xmin,ymin,xmax,ymax]</literal>
35                         fornece o retângulo a ser ampliado 
36                     </para>
37                 </listitem>
38             </varlistentry>
39             <varlistentry>
40                 <term>h</term>
41                 <listitem>
42                     <para>manipulador gráfico do tipo Figure ou Axes. Especifica sobre
43                         que eixos se realizará a ampliação.
44                     </para>
45                 </listitem>
46             </varlistentry>
47         </variablelist>
48     </refsection>
49     <refsection>
50         <title>Descrição</title>
51         <para>
52             <literal>zoom_rect</literal> é a função utilizada para realizar
53             ampliações dentro de um conjunto de objetos Axes.
54         </para>
55         <para>
56             O argumento de entrada <literal>h</literal> especifica sobre que
57             eixos se realizará a ampliação. Se <literal>h</literal> for um manipulador
58             do tipo Figure, então a ampliação ocorrerá sobre seus galhos Axes. Se
59             <literal>h</literal> for um manipulador Axes, a ampliação será aplicada
60             apenas sobre este objeto. Se <literal>h</literal> não for especificado,
61             então a ampliação será aplicada sobre a entidade Figure corrente.
62         </para>
63         <para>
64             Se o argumento de entrada <literal>rect</literal> for especificada,
65             então a propriedade <literal>zoom_box</literal> dos eixos ampliados será
66             modificada por este argumento (ver <link linkend="axes_properties">axes_properties</link>). Seus limites ao longo
67             dos eixos X e Y serão substituídos por <literal>rect</literal>. Se
68             <literal>rect</literal> não for especificado zoom_rect será uma ampliação
69             interativa. Requer-se que o usuário selecione um retângulo utilizando o
70             mouse. A nova propriedade <literal>zoom_box</literal> dos eixos ampliados
71             é então computada encontrando-se as interseções do retângulo com suas
72             caixas de eixos.
73         </para>
74     </refsection>
75     <refsection>
76         <title>Exemplos</title>
77         <programlisting role="example"><![CDATA[ 
78 clf()
79 x=0:0.01:6*%pi;
80 plot2d(x,sin(x.^2))
81 zoom_rect([16,-1,18,1])
82 //mais zoom
83 zoom_rect([16,0,16.2,1])
84 //de volta ao original
85 unzoom()
86 // ajustando o zoom através de axes_properties
87 a=gca();
88 a.zoom_box=[16,0,16.2,1];
89 a.zoom_box=[];
90
91 //ajustando zoom de sub-esboços
92 clf()
93 x=0:0.01:6*%pi;
94 subplot(211)
95 plot2d(x,cos(x))
96 subplot(212)
97 plot2d(x,cos(2*x))
98 rect=[3 -2 7 10]; //um retângulo especificado nas coordenadas dos eixos correntes (os últimos)
99 zoom_rect(rect) 
100 unzoom()
101 //ajustando os eixos subjascentes globais como sendo os correntes
102 f=gcf();set('current_axes',f.children($)) 
103 rect=[0.4 0 0.6 1] //um retângulo especificado em razão do tamanho da janela
104 zoom_rect(rect) 
105 rect=[0.4 0.2 0.6 0.8]; //um retângulo especificado em razão do tamanho da janela
106 zoom_rect(rect)
107
108 // ampliação interativa sob a figura corrente
109 zoom_rect();
110 // ou
111 zoom_rect(gcf());
112  ]]></programlisting>
113     </refsection>
114     <refsection role="see also">
115         <title>Ver Também</title>
116         <simplelist type="inline">
117             <member>
118                 <link linkend="unzoom">unzoom</link>
119             </member>
120             <member>
121                 <link linkend="axes_properties">axes_properties</link>
122             </member>
123         </simplelist>
124     </refsection>
125 </refentry>