* bug #14558: square() is obsolete
[scilab.git] / 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 <<<<<<< HEAD
106         <programlisting role="example"><![CDATA[
107 // para obter uma explanação gráfica dos parâmetros de xsetech entre com:
108 exec('SCI/modules/graphics/demos/xsetechfig.sce');
109
110 // aqui xsetech é usado para dividir a janela de gráficos em duas partes
111 // o primeiro xsetech é usado para se ajustar a primeira sub-janela
112 // e a escala de gráficos corrente
113 xsetech([0,0,1.0,0.5],[-5,-3,5,3])
114 // chamamos plot2d com a opção "001" para utilizar a escala de gráficos
115 // ajustada por xsetech
116 =======
117         <programlisting role="example"><![CDATA[ 
118 // para obter uma explanação gráfica dos parâmetros de xsetech entre com:
119 exec('SCI/modules/graphics/demos/xsetechfig.sce');
120
121 // aqui xsetech é usado para dividir a janela de gráficos em duas partes
122 // o primeiro xsetech é usado para se ajustar a primeira sub-janela 
123 // e a escala de gráficos corrente
124 xsetech([0,0,1.0,0.5],[-5,-3,5,3])
125 // chamamos plot2d com a opção "001" para utilizar a escala de gráficos
126 // ajustada por xsetech 
127 >>>>>>> 7f4fe15... * bug #14558: square() is obsolete
128 plot2d([1:10]',[1:10]',1,"001"," ")
129 // então xsetech é usado para ajustar a segunda sub-janela
130 xsetech([0,0.5,1.0,0.5])
131 <<<<<<< HEAD
132 // a escala de gráficos é ajustada por xsetech para [0,0,1,1] por padrão
133 // e nós a modificamos utilizando o argumento rect em plot2d
134 =======
135 // a escala de gráficos é ajustada por xsetech para [0,0,1,1] por padrão
136 // e nós a modificamos utilizando o argumento rect em plot2d 
137 >>>>>>> 7f4fe15... * bug #14558: square() is obsolete
138 plot2d([1:10]',[1:10]',1,"011"," ",[-6,-6,6,6])
139 // quatro esboços em uma única janela de gráficos
140 clf()
141 xset("font",2,0)
142 xsetech([0,0,0.5,0.5]); plot3d()
143 xsetech([0.5,0,0.5,0.5]); plot2d()
144 xsetech([0.5,0.5,0.5,0.5]); grayplot()
145 xsetech([0,0.5,0.5,0.5]); histplot()
146 // de volta aos valores padrões para a sub-janela
147 xsetech([0,0,1,1])
148 <<<<<<< HEAD
149 // um esboço com arect modificado
150 =======
151 // um esboço com arect modificado 
152 >>>>>>> 7f4fe15... * bug #14558: square() is obsolete
153 clf()
154 xset("default")
155 xsetech(arect=[0,0,0,0])
156 x=1:0.1:10;plot2d(x',sin(x)')
157 clf()
158 xsetech(arect=[1/8,1/8,1/16,1/4])
159 x=1:0.1:10;plot2d(x',sin(x)')
160 clf()
161 xset("default")
162  ]]></programlisting>
163     </refsection>
164     <refsection>
165         <title>Ver Também </title>
166         <simplelist type="inline">
167             <member>
168                 <link linkend="xgetech">xgetech</link>
169             </member>
170             <member>
171                 <link linkend="subplot">subplot</link>
172             </member>
173             <member>
174                 <link linkend="isoview">isoview</link>
175             </member>
176             <member>
177                 <link linkend="replot">replot</link>
178             </member>
179         </simplelist>
180     </refsection>
181 </refentry>