<?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-en.txt
 *
 -->
<refentry version="5.0-subset Scilab" xml:id="xset" xml:lang="en"
          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">
  <info>
    <pubdate>$LastChangedDate$</pubdate>
  </info>

  <refnamediv>
    <refname>xset</refname>

    <refpurpose>ajusta valores para o contexto grfico. Funo
    obsoleta</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <title>Seqncia de Chamamento</title>

    <synopsis>xset(choice-name,x1,x2,x3,x4,x5)
xset()</synopsis>
  </refsynopsisdiv>

  <refsection>
    <title>Parmetros</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>Descrio</title>

    <para>Aviso: est funo est obsoleta. Utilize a representao de objetos
    do Scilab ao invs (ver as documentaes das funes <link
    linkend="set">set</link> e <link linkend="get">get</link> bem como a
    pgina <link linkend="graphics_entities">graphics_entities</link>).</para>

    <para><literal>xset</literal>  utilizado para ajustar valores padres do
    contexto da janela de grficos corrente.</para>

    <para>Quando chamado sem argumento, um menu de escolha  criado exibindo
    os valores correntes e mudanas podem ser realizadas atravs e botes de
    escolha.</para>

    <para>Use <literal>xset()</literal> para exibir ou ajustar a cor corrente,
    marca e fontes utilizadas.</para>

    <para></para>

    <variablelist>
      <varlistentry>
        <term>xset("alufunction",number)</term>

        <listitem>
          <para>usado para ajustar a funo lgica para desenho. A funo
          lgica utilizada  ajustada por <literal>x1</literal>. Os valores
          usuais so: 3 para cpia (padro), 6 para animao 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 automtica para grficos entre "on"
          e "off" . Quando o modo de limpeza automtica  "on", esboos
          sucessivos no so superpostos, ie, uma operao
          <literal>xbasc()</literal> (a janela de grficos  limpa e os
          grficos gravados associados so apagados)  realizada antes de cada
          funo grfica de alto-nvel. O valor padro  "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 grficos onde os
          esboos podem ser desenhados) como sendo o retngulo (x,y,w,h)
          (ponto superior esquerdo, largura, altura). Esta funo utiliza a
          utiliza as coordenadas correntes do esboo.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>xset("color",value)</term>

        <listitem>
          <para>ajusta a cor padro para funes de preechimento, linha ou
          impresso 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 atravs 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
          nmero de cores. A cor de nmero 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 slida). 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 invs.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>xset("default")</term>

        <listitem>
          <para>reajusta o contexto grfico para valores padres.</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, no 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 exibio de ponto flutuante para funes
          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
          padro.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>xset("hidden3d",colorid) :</term>

        <listitem>
          <para>ajusta o nmero 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 renderizao de superfcies fechadas.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>xset("line mode",type)</term>

        <listitem>
          <para>esta funo  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: slida, &gt;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, no 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 padro (pattern, no confundir com padro = default)
          corrente para funes 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("pixmap",flag)</term>

        <listitem>
          <para>se flag=0, os grficos so diretamente exibidos na tela. Se
          flag=1, os grficos so feitos em um pixmap (mapa de pixel) e
          enviados  janela de grficos atravs do comando
          <literal>xset("wshow")</literal>. O pixmap  limpo com o comando
          <literal>xset("wwpc")</literal>. Note que o comando usual
          <literal>xbasc()</literal> tambm limpa o pixmap.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>xset("thickness",value)</term>

        <listitem>
          <para>ajusta o valor de espessura das linhas em pixel (0 e 1 tm o
          mesmo significado: 1 pixel de espessura).</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>xset("use color",flag)</term>

        <listitem>
          <para>se flag=1, ento <literal>xset("pattern",.)</literal> ou
          <literal>xset("dashes",.)</literal> ser utilizado de modo a
          modificar a cor padro para desenho ou para padres de
          preenchimento. Se flag=0 ento retorna-se ao modo de escalas de
          cinza e tracejados.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>xset("viewport",x,y)</term>

        <listitem>
          <para>ajusta a posio do cursor.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>xset("wdim",width,height)</term>

        <listitem>
          <para>ajusta a largura e altura da janela de grficos corrente. Esta
          opo no  utilizada pelo driver Postscript.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>xset("wpdim",width,height)</term>

        <listitem>
          <para>ajusta a largura e altura da janela de grficos fsica
          corrente (que pode ser diferente do tamanho atual no modo wresize
          1). Esta opo no  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 no existir.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>xset("wpos",x,y)</term>

        <listitem>
          <para>ajusta a posio do ponto superior esquerdo da janela de
          grficos.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>xset("wresize",flag)</term>

        <listitem>
          <para>se flag= 1ento o grfico  automaticamente redimensionado
          para preencher a janela de grficos.</para>

          <programlisting role = ""><![CDATA[ 
xdel();
xset("wresize",1);
plot2d();
xset("wdim",1000,500)
 ]]></programlisting>

          <para>Se flag=0 a escala do grfico  inalterada quando a janela de
          grfico  redimensionada. O cursor no canto superior esquerdo ou as
          setas do teclado podem ser utilizadas para rolar o grfico .</para>

          <programlisting role = ""><![CDATA[ 
xdel();
plot2d();
xset("wresize",0);
xset("wdim",1000,500)
 ]]></programlisting>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>xset("wshow")</term>

        <listitem>
          <para>ver <literal>xset("pixmap",1)</literal> acima.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>xset("wwpc")</term>

        <listitem>
          <para>ver <literal>xset("pixmap",1)</literal> acima.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsection>

  <refsection>
    <title>Ver Tambm</title>

    <simplelist type="inline">
      <member><link linkend="xget">xget</link></member>

      <member><link linkend="getcolor">getcolor</link></member>

      <member><link linkend="getsymbol">getsymbol</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>

  <refsection>
    <title>Autor</title>

    <para>J.Ph.C.</para>
  </refsection>
</refentry>