scilab/modules/graphics/help/pt_BR/xsetech.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  *
   6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
   7  *
   8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
   9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
  10  * This file was originally licensed under the terms of the CeCILL v2.1,
  11  * and continues to be available under such terms.
  12  * For more information, see the COPYING file which you should have received
  13  * along with this program.
  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:ns3="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="xsetech" xml:lang="pt">
  17     <refnamediv>
  18         <refname>xsetech</refname>
  19         <refpurpose>ajusta a sub-janela de uma janela de gráficos para
  20             esboço
  21         </refpurpose>
  22     </refnamediv>
  23     <refsynopsisdiv>
  24         <title>Seqüência de Chamamento</title>
  25         <synopsis>xsetech(wrect,[frect,logflag])
  26             xsetech(wrect=[...],frect=[..],logflag="..", arect=[...])
  27             xsetech()
  28         </synopsis>
  29     </refsynopsisdiv>
  30     <refsection>
  31         <title>Parâmetros</title>
  32         <variablelist>
  33             <varlistentry>
  34                 <term>wrect</term>
  35                 <listitem>
  36                     <para>vetor de tamanho 4 definindo a sub-janela a ser utilizada.
  37                     </para>
  38                 </listitem>
  39             </varlistentry>
  40             <varlistentry>
  41                 <term>frect</term>
  42                 <listitem>
  43                     <para>vetor de tamanho 4. </para>
  44                 </listitem>
  45             </varlistentry>
  46             <varlistentry>
  47                 <term>logflag</term>
  48                 <listitem>
  49                     <para>string de tamanho 2 "xy", onde x e y podem ser "n" ou "l". "n"
  50                         escala normal e "l" significa escala logarítmica. x refere-se ao
  51                         eixo x e y ao eixo y.
  52                     </para>
  53                 </listitem>
  54             </varlistentry>
  55             <varlistentry>
  56                 <term>arect</term>
  57                 <listitem>
  58                     <para>vetor de tamanho 4.</para>
  59                 </listitem>
  60             </varlistentry>
  61         </variablelist>
  62     </refsection>
  63     <refsection>
  64         <title>Descrição </title>
  65         <para>
  66             <literal>xsetech</literal> é principalmente utilizado para ajustar a
  67             sub-janela da janela de gráficos que será utilizada para esboço. A
  68             sub-janela é especificada através do parâmetro
  69             <literal>wrect=[x,y,w,h]</literal> (ponto superior esquerdo, largura,
  70             altura). Os valores em <literal>wrect</literal> a são especificados
  71             utilizando-se a proporção de largura ou altura da janela de gráficos
  72             corrente. Por exemplo, <literal>wrect=[0,0,1,1]</literal> significa que
  73             toda a janela será utilizada e <literal>wrect=[0.5,0,0.5,1]</literal>
  74             significa que a região gráfica será a metade direita da janela de
  75             gráficos.
  76         </para>
  77         <para>
  78             <literal>xsetech</literal> também ajusta as escalas gráficas
  79             correntes para esboço 2d e pode ser utilizada juntamente a rotinas
  80             gráficas que requerem a escala de gráficos corrente (por exemplo
  81             <literal>strf="x0z"</literal> ou <literal>frameflag=0</literal> em
  82             <literal>plot2d</literal>).
  83         </para>
  84         <para>
  85             <literal>frect=[xmin,ymin,xmax,ymax]</literal> é utilizado para
  86             ajustar a escala gráfica e é igual ao argumento <literal>rect</literal> de
  87             <literal>plot2d</literal>. Se <literal>frect</literal> não for fornecido,
  88             o valor corrente da escala de gráficos permanece inalterado. O valor
  89             padrão de <literal>rect</literal> é <literal>[0,0,1,1]</literal> (na
  90             criação de janelas, quando se volta para o valor padrão com
  91             <literal>xset('default')</literal> ou quando se limpa eventos gráficos
  92             gravados <literal>clf()</literal>).
  93         </para>
  94         <para>
  95             <literal>arect=[x_left, x_right,y_up,y_down]</literal> é utilizado
  96             para ajustar a moldura gráfica dentro da sub-janela. A moldura gráfica é
  97             especificada (como <literal>wrect</literal>) utilizando-se a proporção de
  98             largura ou altura da sub-janela de gráficos corrente. O valor padrão é
  99             <literal>1/8*[1,1,1,1]</literal>. Se <literal>arect</literal> não for
 100             fornecido, o valor padrão permanece inalterado.
 101         </para>
 102     </refsection>
 103     <refsection>
 104         <title>Exemplos</title>
 105         <programlisting role="example"><![CDATA[
 106 // para obter uma explanação gráfica dos parâmetros de xsetech entre com:
 107 exec('SCI/modules/graphics/demos/xsetechfig.sce');
 108
 109 // aqui xsetech é usado para dividir a janela de gráficos em duas partes
 110 // o primeiro xsetech é usado para se ajustar a primeira sub-janela
 111 // e a escala de gráficos corrente
 112 xsetech([0,0,1.0,0.5],[-5,-3,5,3])
 113 // chamamos plot2d com a opção "001" para utilizar a escala de gráficos
 114 // ajustada por xsetech
 115 plot2d([1:10]',[1:10]',1,"001"," ")
 116 // então xsetech é usado para ajustar a segunda sub-janela
 117 xsetech([0,0.5,1.0,0.5])
 118 // a escala de gráficos é ajustada por xsetech para [0,0,1,1] por padrão
 119 // e nós a modificamos utilizando o argumento rect em plot2d
 120 plot2d([1:10]',[1:10]',1,"011"," ",[-6,-6,6,6])
 121 // quatro esboços em uma única janela de gráficos
 122 clf()
 123 xset("font",2,0)
 124 xsetech([0,0,0.5,0.5]); plot3d()
 125 xsetech([0.5,0,0.5,0.5]); plot2d()
 126 xsetech([0.5,0.5,0.5,0.5]); grayplot()
 127 xsetech([0,0.5,0.5,0.5]); histplot()
 128 // de volta aos valores padrões para a sub-janela
 129 xsetech([0,0,1,1])
 130 // um esboço com arect modificado
 131 clf()
 132 xset("default")
 133 xsetech(arect=[0,0,0,0])
 134 x=1:0.1:10;plot2d(x',sin(x)')
 135 clf()
 136 xsetech(arect=[1/8,1/8,1/16,1/4])
 137 x=1:0.1:10;plot2d(x',sin(x)')
 138 clf()
 139 xset("default")
 140  ]]></programlisting>
 141     </refsection>
 142     <refsection>
 143         <title>Ver Também </title>
 144         <simplelist type="inline">
 145             <member>
 146                 <link linkend="xgetech">xgetech</link>
 147             </member>
 148             <member>
 149                 <link linkend="subplot">subplot</link>
 150             </member>
 151             <member>
 152                 <link linkend="isoview">isoview</link>
 153             </member>
 154             <member>
 155                 <link linkend="replot">replot</link>
 156             </member>
 157         </simplelist>
 158     </refsection>
 159 </refentry>