<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
* Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
* Copyright (C) ENPC - Jean-Philippe Chancelier
*
* This file must be used under the terms of the CeCILL.
* This source file is licensed as described in the file COPYING, which
* you should have received as part of this distribution. The terms
* are also available at
* http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
*
-->
<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">
<refnamediv>
<refname>xset</refname>
<refpurpose>ajusta valores para o contexto gr�fico. Fun��o
obsoleta
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<title>Seq��ncia de Chamamento</title>
<synopsis>xset(choice-name,x1,x2,x3,x4,x5)
xset()
</synopsis>
</refsynopsisdiv>
<refsection>
<title>Par�metros</title>
<variablelist>
<varlistentry>
<term>choice-name</term>
<listitem>
<para>string</para>
</listitem>
</varlistentry>
<varlistentry>
<term>x1,...,x5</term>
<listitem>
<para>
dependem de <literal>choice-name</literal>
</para>
</listitem>
</varlistentry>
</variablelist>
</refsection>
<refsection>
<title>Descri��o</title>
<para>Aviso: est� fun��o est� obsoleta. Utilize a representa��o de objetos
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
p�gina <link linkend="graphics_entities">graphics_entities</link>).
</para>
<para>
<literal>xset</literal> � utilizado para ajustar valores padr�es do
contexto da janela de gr�ficos corrente.
</para>
<para>Quando chamado sem argumento, um menu de escolha � criado exibindo
os valores correntes e mudan�as podem ser realizadas atrav�s e bot�es de
escolha.
</para>
<para>
Use <literal>xset()</literal> para exibir ou ajustar a cor corrente,
marca e fontes utilizadas.
</para>
<para/>
<variablelist>
<varlistentry>
<term>xset("alufunction",number)</term>
<listitem>
<para>usado para ajustar a fun��o l�gica para desenho. A fun��o
l�gica utilizada � ajustada por <literal>x1</literal>. Os valores
usuais s�o: 3 para c�pia (padr�o), 6 para anima��o e 0 para limpeza.
Ver alufunctions para mais detalhes.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("auto clear","on"|"off")</term>
<listitem>
<para>alterna o modo de limpeza autom�tica para gr�ficos entre "on"
e "off" . Quando o modo de limpeza autom�tica � "on", esbo�os
sucessivos n�o s�o superpostos, ie, uma opera��o
<literal>clf()</literal> (a janela de gr�ficos � limpa e os
gr�ficos gravados associados s�o apagados) � realizada antes de cada
fun��o gr�fica de alto-n�vel. O valor padr�o � "off".
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("background",color)</term>
<listitem>
<para>ajusta a cor de plano de fundo do objeto Axes corrente. O
argumento <literal>color</literal> � um �ndice no mapa de cores da
cor a ser utilizada.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("clipping",x,y,w,h)</term>
<listitem>
<para>ajusta a zona de recorte (a zona da janela de gr�ficos onde os
esbo�os podem ser desenhados) como sendo o ret�ngulo (x,y,w,h)
(ponto superior esquerdo, largura, altura). Esta fun��o utiliza a
utiliza as coordenadas correntes do esbo�o.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("color",value)</term>
<listitem>
<para>ajusta a cor padr�o para fun��es de preechimento, linha ou
impress�o de textos. <literal>value</literal> � um inteiro projetado
no intervalo [0,whiteid]. 0 � usado para preenchimento com preto e
whiteid para preenchimento com branco. O valor do identificador do
branco pode ser obtido atrav�s de
<literal>xget("white")</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("colormap",cmap)</term>
<listitem>
<para>ajusta o mapa de cores como sendo uma matriz m x 3. m � o
n�mero de cores. A cor de n�mero i � dada como sendo a tripla
cmap(i,1), cmap(i,2), cmap(i,3) correspondentes respectivamente �s
intensidades de vermelho, verde e azul entre 0 e 1.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("dashes",i)</term>
<listitem>
<para>
no modo preto e branco (<literal>xset("use
color",0)
</literal>
), ajusta o estilo de tracejado como o estilo i
(0 para linha s�lida). No modo colorido (<literal>xset("use color",1
)
</literal>
)� utilizado para ajustar a cor da linha, da marca e do
texto. Esta palavra-chave est� obsoleta, utilize
<literal>xset('color',i)</literal> ou <literal>xset('line
style',i)
</literal>
ao inv�s.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("default")</term>
<listitem>
<para>reajusta o contexto gr�fico para valores padr�es.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("font",fontid,fontsize) :</term>
<listitem>
<para>ajusta a fonte corrente e seu tamanho. Note que
<literal>fontsize</literal> se aplica a todas as fontes, n�o s� a
<literal>fontid</literal> .
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("font size",fontsize)</term>
<listitem>
<para>ajusta o tamanho da fonte.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("foreground",color)</term>
<listitem>
<para>ajusta a cor de primeiro plano do objeto Axes corrente. O
argumento <literal>color</literal> � um �ndice no mapa de cores da
cor a ser utilizada.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("fpf",string)</term>
<listitem>
<para>ajusta o formato de exibi��o de ponto flutuante para fun��es
de contorno. <literal>string</literal> � um string fornecendo o
formato em sintaxe C (por exemplo <literal>string="%.3f"</literal>).
Use <literal>string=""</literal> para retornar ao formato
padr�o.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("hidden3d",colorid) :</term>
<listitem>
<para>ajusta o n�mero de cor para as faces escondidas em um
<literal>plot3d. colorid=0</literal> suprime o desenho de faces
escondidas de objetos 3d. Isto � tecnicamente chamdo 'culling' e
acelera a renderiza��o de superf�cies fechadas.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("line mode",type)</term>
<listitem>
<para>esta fun��o � utilizada para se ajustar o modo de desenho da
linha. O modo absoluto � ajustado com type= 1 e o modo relativo com
type=0. (aviso: o modo type= 0 possui defeitos)
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("line style",value)</term>
<listitem>
<para>ajusta o estilo de linha corrente (1: s�lida, >1 estilos
tracejados).
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("mark",markid,marksize)</term>
<listitem>
<para>ajusta a marca corrente e seu tamanho. Use
<literal>xset()</literal> para visualizar as marcas. Note que
<literal>marksize</literal> se aplica a todas as marcas, n�o apenas
a <literal>markid</literal> .
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("mark size",marksize)</term>
<listitem>
<para>ajusta o tamanho da marca.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("pattern",value)</term>
<listitem>
<para>ajusta o padr�o (pattern, n�o confundir com padr�o = default)
corrente para fun��es de preenchimento. O valor � um inteiro
projetado no intervalo [0,whiteid]. 0 � utilizado para preenchimento
com preto e whiteid para preenchimento com branco. O valor de
whiteid pode ser obtido com <literal>xget("white")</literal>.
"pattern" � equivalente a "color".
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("thickness",value)</term>
<listitem>
<para>ajusta o valor de espessura das linhas em pixel (0 e 1 t�m o
mesmo significado: 1 pixel de espessura).
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("use color",flag)</term>
<listitem>
<para>
se flag=1, ent�o <literal>xset("pattern",.)</literal> ou
<literal>xset("dashes",.)</literal> ser� utilizado de modo a
modificar a cor padr�o para desenho ou para padr�es de
preenchimento. Se flag=0 ent�o retorna-se ao modo de escalas de
cinza e tracejados.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("viewport",x,y)</term>
<listitem>
<para>ajusta a posi��o do cursor.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("wdim",width,height)</term>
<listitem>
<para>ajusta a largura e altura da janela de gr�ficos corrente. Esta
op��o n�o � utilizada pelo driver Postscript.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("wpdim",width,height)</term>
<listitem>
<para>ajusta a largura e altura da janela de gr�ficos f�sica
corrente (que pode ser diferente do tamanho atual no modo wresize
1). Esta op��o n�o � utilizada pelo driver Postscript.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("window",window-number)</term>
<listitem>
<para>
ajusta a janela <literal>window-number</literal> como sendo a
janela corrente e cria a janela se esta n�o existir.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("wpos",x,y)</term>
<listitem>
<para>ajusta a posi��o do ponto superior esquerdo da janela de
gr�ficos.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>xset("wresize",flag)</term>
<listitem>
<para>se flag= 1ent�o o gr�fico � automaticamente redimensionado
para preencher a janela de gr�ficos.
</para>
<programlisting role=""><![CDATA[
xdel();
xset("wresize",1);
plot2d();
xset("wdim",1000,500)
]]></programlisting>
<para>Se flag=0 a escala do gr�fico � inalterada quando a janela de
gr�fico � redimensionada. O cursor no canto superior esquerdo ou as
setas do teclado podem ser utilizadas para rolar o gr�fico .
</para>
<programlisting role=""><![CDATA[
xdel();
plot2d();
xset("wresize",0);
xset("wdim",1000,500)
]]></programlisting>
</listitem>
</varlistentry>
</variablelist>
</refsection>
<refsection role="see also">
<title>Ver Tamb�m</title>
<simplelist type="inline">
<member>
<link linkend="xget">xget</link>
</member>
<member>
<link linkend="getcolor">getcolor</link>
</member>
<member>
<link linkend="ged">ged</link>
</member>
<member>
<link linkend="set">set</link>
</member>
<member>
<link linkend="graphics_entities">graphics_entities</link>
</member>
</simplelist>
</refsection>
</refentry>