Differential_equations tests: fix warnings and wrong quotes
[scilab.git] / scilab / modules / graphics / help / pt_BR / xset.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  * This file must be used under the terms of the CeCILL.
7  * This source file is licensed as described in the file COPYING, which
8  * you should have received as part of this distribution.  The terms
9  * are also available at
10  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
11  *
12  -->
13 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="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="xset" xml:lang="en">
14     <refnamediv>
15         <refname>xset</refname>
16         <refpurpose>ajusta valores para o contexto gráfico. Função
17             obsoleta
18         </refpurpose>
19     </refnamediv>
20     <refsynopsisdiv>
21         <title>Seqüência de Chamamento</title>
22         <synopsis>xset(choice-name,x1,x2,x3,x4,x5)
23             xset()
24         </synopsis>
25     </refsynopsisdiv>
26     <refsection>
27         <title>Parâmetros</title>
28         <variablelist>
29             <varlistentry>
30                 <term>choice-name</term>
31                 <listitem>
32                     <para>string</para>
33                 </listitem>
34             </varlistentry>
35             <varlistentry>
36                 <term>x1,...,x5</term>
37                 <listitem>
38                     <para>
39                         dependem de <literal>choice-name</literal>
40                     </para>
41                 </listitem>
42             </varlistentry>
43         </variablelist>
44     </refsection>
45     <refsection>
46         <title>Descrição</title>
47         <para>Aviso: está função está obsoleta. Utilize a representação de objetos
48             do Scilab ao invés (ver as documentações das funções <link linkend="set">set</link> e <link linkend="get">get</link> bem como a
49             página <link linkend="graphics_entities">graphics_entities</link>).
50         </para>
51         <para>
52             <literal>xset</literal> é utilizado para ajustar valores padrões do
53             contexto da janela de gráficos corrente.
54         </para>
55         <para>Quando chamado sem argumento, um menu de escolha é criado exibindo
56             os valores correntes e mudanças podem ser realizadas através e botões de
57             escolha.
58         </para>
59         <para>
60             Use <literal>xset()</literal> para exibir ou ajustar a cor corrente,
61             marca e fontes utilizadas.
62         </para>
63         <para/>
64         <variablelist>
65             <varlistentry>
66                 <term>xset("alufunction",number)</term>
67                 <listitem>
68                     <para>usado para ajustar a função lógica para desenho. A função
69                         lógica utilizada é ajustada por <literal>x1</literal>. Os valores
70                         usuais são: 3 para cópia (padrão), 6 para animação e 0 para limpeza.
71                         Ver alufunctions para mais detalhes.
72                     </para>
73                 </listitem>
74             </varlistentry>
75             <varlistentry>
76                 <term>xset("auto clear","on"|"off")</term>
77                 <listitem>
78                     <para>alterna o modo de limpeza automática para gráficos entre "on"
79                         e "off" . Quando o modo de limpeza automática é "on", esboços
80                         sucessivos não são superpostos, ie, uma operação
81                         <literal>clf()</literal> (a janela de gráficos é limpa e os
82                         gráficos gravados associados são apagados) é realizada antes de cada
83                         função gráfica de alto-nível. O valor padrão é "off".
84                     </para>
85                 </listitem>
86             </varlistentry>
87             <varlistentry>
88                 <term>xset("background",color)</term>
89                 <listitem>
90                     <para>ajusta a cor de plano de fundo do objeto Axes corrente. O
91                         argumento <literal>color</literal> é um índice no mapa de cores da
92                         cor a ser utilizada.
93                     </para>
94                 </listitem>
95             </varlistentry>
96             <varlistentry>
97                 <term>xset("clipping",x,y,w,h)</term>
98                 <listitem>
99                     <para>ajusta a zona de recorte (a zona da janela de gráficos onde os
100                         esboços podem ser desenhados) como sendo o retângulo (x,y,w,h)
101                         (ponto superior esquerdo, largura, altura). Esta função utiliza a
102                         utiliza as coordenadas correntes do esboço.
103                     </para>
104                 </listitem>
105             </varlistentry>
106             <varlistentry>
107                 <term>xset("color",value)</term>
108                 <listitem>
109                     <para>ajusta a cor padrão para funções de preechimento, linha ou
110                         impressão de textos. <literal>value</literal> é um inteiro projetado
111                         no intervalo [0,whiteid]. 0 é usado para preenchimento com preto e
112                         whiteid para preenchimento com branco. O valor do identificador do
113                         branco pode ser obtido através de
114                         <literal>xget("white")</literal>.
115                     </para>
116                 </listitem>
117             </varlistentry>
118             <varlistentry>
119                 <term>xset("colormap",cmap)</term>
120                 <listitem>
121                     <para>ajusta o mapa de cores como sendo uma matriz m x 3. m é o
122                         número de cores. A cor de número i é dada como sendo a tripla
123                         cmap(i,1), cmap(i,2), cmap(i,3) correspondentes respectivamente às
124                         intensidades de vermelho, verde e azul entre 0 e 1.
125                     </para>
126                 </listitem>
127             </varlistentry>
128             <varlistentry>
129                 <term>xset("dashes",i)</term>
130                 <listitem>
131                     <para>
132                         no modo preto e branco (<literal>xset("use
133                             color",0)
134                         </literal>
135                         ), ajusta o estilo de tracejado como o estilo i
136                         (0 para linha sólida). No modo colorido (<literal>xset("use color",1
137                             )
138                         </literal>
139                         )é utilizado para ajustar a cor da linha, da marca e do
140                         texto. Esta palavra-chave está obsoleta, utilize
141                         <literal>xset('color',i)</literal> ou <literal>xset('line
142                             style',i)
143                         </literal>
144                         ao invés.
145                     </para>
146                 </listitem>
147             </varlistentry>
148             <varlistentry>
149                 <term>xset("default")</term>
150                 <listitem>
151                     <para>reajusta o contexto gráfico para valores padrões.</para>
152                 </listitem>
153             </varlistentry>
154             <varlistentry>
155                 <term>xset("font",fontid,fontsize) :</term>
156                 <listitem>
157                     <para>ajusta a fonte corrente e seu tamanho. Note que
158                         <literal>fontsize</literal> se aplica a todas as fontes, não só a
159                         <literal>fontid</literal> .
160                     </para>
161                 </listitem>
162             </varlistentry>
163             <varlistentry>
164                 <term>xset("font size",fontsize)</term>
165                 <listitem>
166                     <para>ajusta o tamanho da fonte.</para>
167                 </listitem>
168             </varlistentry>
169             <varlistentry>
170                 <term>xset("foreground",color)</term>
171                 <listitem>
172                     <para>ajusta a cor de primeiro plano do objeto Axes corrente. O
173                         argumento <literal>color</literal> é um índice no mapa de cores da
174                         cor a ser utilizada.
175                     </para>
176                 </listitem>
177             </varlistentry>
178             <varlistentry>
179                 <term>xset("fpf",string)</term>
180                 <listitem>
181                     <para>ajusta o formato de exibição de ponto flutuante para funções
182                         de contorno. <literal>string</literal> é um string fornecendo o
183                         formato em sintaxe C (por exemplo <literal>string="%.3f"</literal>).
184                         Use <literal>string=""</literal> para retornar ao formato
185                         padrão.
186                     </para>
187                 </listitem>
188             </varlistentry>
189             <varlistentry>
190                 <term>xset("hidden3d",colorid) :</term>
191                 <listitem>
192                     <para>ajusta o número de cor para as faces escondidas em um
193                         <literal>plot3d. colorid=0</literal> suprime o desenho de faces
194                         escondidas de objetos 3d. Isto é tecnicamente chamdo 'culling' e
195                         acelera a renderização de superfícies fechadas.
196                     </para>
197                 </listitem>
198             </varlistentry>
199             <varlistentry>
200                 <term>xset("line mode",type)</term>
201                 <listitem>
202                     <para>esta função é utilizada para se ajustar o modo de desenho da
203                         linha. O modo absoluto é ajustado com type= 1 e o modo relativo com
204                         type=0. (aviso: o modo type= 0 possui defeitos)
205                     </para>
206                 </listitem>
207             </varlistentry>
208             <varlistentry>
209                 <term>xset("line style",value)</term>
210                 <listitem>
211                     <para>ajusta o estilo de linha corrente (1: sólida, &gt;1 estilos
212                         tracejados).
213                     </para>
214                 </listitem>
215             </varlistentry>
216             <varlistentry>
217                 <term>xset("mark",markid,marksize)</term>
218                 <listitem>
219                     <para>ajusta a marca corrente e seu tamanho. Use
220                         <literal>xset()</literal> para visualizar as marcas. Note que
221                         <literal>marksize</literal> se aplica a todas as marcas, não apenas
222                         a <literal>markid</literal> .
223                     </para>
224                 </listitem>
225             </varlistentry>
226             <varlistentry>
227                 <term>xset("mark size",marksize)</term>
228                 <listitem>
229                     <para>ajusta o tamanho da marca.</para>
230                 </listitem>
231             </varlistentry>
232             <varlistentry>
233                 <term>xset("pattern",value)</term>
234                 <listitem>
235                     <para>ajusta o padrão (pattern, não confundir com padrão = default)
236                         corrente para funções de preenchimento. O valor é um inteiro
237                         projetado no intervalo [0,whiteid]. 0 é utilizado para preenchimento
238                         com preto e whiteid para preenchimento com branco. O valor de
239                         whiteid pode ser obtido com <literal>xget("white")</literal>.
240                         "pattern" é equivalente a "color".
241                     </para>
242                 </listitem>
243             </varlistentry>
244             <varlistentry>
245                 <term>xset("thickness",value)</term>
246                 <listitem>
247                     <para>ajusta o valor de espessura das linhas em pixel (0 e 1 têm o
248                         mesmo significado: 1 pixel de espessura).
249                     </para>
250                 </listitem>
251             </varlistentry>
252             <varlistentry>
253                 <term>xset("use color",flag)</term>
254                 <listitem>
255                     <para>
256                         se flag=1, então <literal>xset("pattern",.)</literal> ou
257                         <literal>xset("dashes",.)</literal> será utilizado de modo a
258                         modificar a cor padrão para desenho ou para padrões de
259                         preenchimento. Se flag=0 então retorna-se ao modo de escalas de
260                         cinza e tracejados.
261                     </para>
262                 </listitem>
263             </varlistentry>
264             <varlistentry>
265                 <term>xset("viewport",x,y)</term>
266                 <listitem>
267                     <para>ajusta a posição do cursor.</para>
268                 </listitem>
269             </varlistentry>
270             <varlistentry>
271                 <term>xset("wdim",width,height)</term>
272                 <listitem>
273                     <para>ajusta a largura e altura da janela de gráficos corrente. Esta
274                         opção não é utilizada pelo driver Postscript.
275                     </para>
276                 </listitem>
277             </varlistentry>
278             <varlistentry>
279                 <term>xset("wpdim",width,height)</term>
280                 <listitem>
281                     <para>ajusta a largura e altura da janela de gráficos física
282                         corrente (que pode ser diferente do tamanho atual no modo wresize
283                         1). Esta opção não é utilizada pelo driver Postscript.
284                     </para>
285                 </listitem>
286             </varlistentry>
287             <varlistentry>
288                 <term>xset("window",window-number)</term>
289                 <listitem>
290                     <para>
291                         ajusta a janela <literal>window-number</literal> como sendo a
292                         janela corrente e cria a janela se esta não existir.
293                     </para>
294                 </listitem>
295             </varlistentry>
296             <varlistentry>
297                 <term>xset("wpos",x,y)</term>
298                 <listitem>
299                     <para>ajusta a posição do ponto superior esquerdo da janela de
300                         gráficos.
301                     </para>
302                 </listitem>
303             </varlistentry>
304             <varlistentry>
305                 <term>xset("wresize",flag)</term>
306                 <listitem>
307                     <para>se flag= 1então o gráfico é automaticamente redimensionado
308                         para preencher a janela de gráficos.
309                     </para>
310                     <programlisting role=""><![CDATA[
311 xdel();
312 xset("wresize",1);
313 plot2d();
314 xset("wdim",1000,500)
315  ]]></programlisting>
316                     <para>Se flag=0 a escala do gráfico é inalterada quando a janela de
317                         gráfico é redimensionada. O cursor no canto superior esquerdo ou as
318                         setas do teclado podem ser utilizadas para rolar o gráfico .
319                     </para>
320                     <programlisting role=""><![CDATA[
321 xdel();
322 plot2d();
323 xset("wresize",0);
324 xset("wdim",1000,500)
325  ]]></programlisting>
326                 </listitem>
327             </varlistentry>
328         </variablelist>
329     </refsection>
330     <refsection role="see also">
331         <title>Ver Também</title>
332         <simplelist type="inline">
333             <member>
334                 <link linkend="xget">xget</link>
335             </member>
336             <member>
337                 <link linkend="getcolor">getcolor</link>
338             </member>
339             <member>
340                 <link linkend="ged">ged</link>
341             </member>
342             <member>
343                 <link linkend="set">set</link>
344             </member>
345             <member>
346                 <link linkend="graphics_entities">graphics_entities</link>
347             </member>
348         </simplelist>
349     </refsection>
350 </refentry>