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>