<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C) INRIA - Fabrice Leray
 * 
 * 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="LineSpec" 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:ns3="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>LineSpec</refname>

    <refpurpose>Customizao rpida de linhas que aparecem em um
    esboo</refpurpose>
  </refnamediv>

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

    <synopsis>    Nenhuma. LineSpec  um argumento opcional que pode ser utilizado dentro de um comando plot para customizar os aspectos de cada linha nova. Deve ser fornecido um string concatenado contendo as informaes sobre cor, estilo de linha e marcas.  muito til para especificar de forma rpida estas propriedades de linha bsicas. 
    Para especificar uma linha vermelha de trao longo com marcas de rombo, o string pode ser 'r--diam'. Como voc pode ver, no  necessrio escrita completa de cada de cada valor de propriedade, mas o string, que  uma concatenao (em qualquer ordem destas trs propriedades), no pode conter ambigidade. Alm disso, a especificao de strings no diferencia letras maisculas de minsculas. </synopsis>
  </refsynopsisdiv>

  <refsection>
    <title>Descrio</title>

    <para>Aqui est uma lista completa dos tipos <literal>LineSpec</literal>
    que voc pode especificar (utilizando <link
    linkend="plot">plot</link>).</para>

    <variablelist>
      <varlistentry>
        <term>LineStyle:</term>

        <listitem>
          <para>um string definindo o estilo de linha. Esta propriedade est
          ligada  propriedade <literal>line_style</literal> do objeto (ver
          <link
          linkend="polyline_properties">polyline_properties</link>).</para>

          <para></para>

          <informaltable border="1">
            <tr>
              <td><literal>especificador</literal></td>

              <td><literal>estilo de linha</literal></td>
            </tr>

            <tr>
              <td><literal>-</literal></td>

              <td>linha slida (padro)</td>
            </tr>

            <tr>
              <td><literal>--</literal></td>

              <td>linha tracejada</td>
            </tr>

            <tr>
              <td><literal>:</literal></td>

              <td>linha pontilhada</td>
            </tr>

            <tr>
              <td><literal>-.</literal></td>

              <td>linha tracejada-pontilhada</td>
            </tr>
          </informaltable>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Color:</term>

        <listitem>
          <para>um string definindo a cor da linha. Esta propriedade est
          ligada  propriedade <literal>foreground</literal> do objeto (ver
          <link
          linkend="polyline_properties">polyline_properties</link>).</para>

          <para></para>

          <informaltable border="1">
            <tr>
              <td><literal>especificador </literal></td>

              <td><literal>cor</literal></td>
            </tr>

            <tr>
              <td><literal>r</literal></td>

              <td>vermelho</td>
            </tr>

            <tr>
              <td><literal>g</literal></td>

              <td>verde</td>
            </tr>

            <tr>
              <td><literal>b</literal></td>

              <td>azul</td>
            </tr>

            <tr>
              <td><literal>c</literal></td>

              <td>ciano</td>
            </tr>

            <tr>
              <td><literal>m</literal></td>

              <td>magenta</td>
            </tr>

            <tr>
              <td><literal>y</literal></td>

              <td>amarelo</td>
            </tr>

            <tr>
              <td><literal>k</literal></td>

              <td>preto</td>
            </tr>

            <tr>
              <td><literal>w</literal></td>

              <td>branco</td>
            </tr>
          </informaltable>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term></term>

        <listitem>
          <para>Uma tabela de cores padro  utilizada para colorir curvas
          esboadas se voc no especificar as cores (nem com
          <literal>LineSpec</literal> nem com <link
          linkend="GlobalProperty">GlobalProperty</link>). Quando linhas
          mltiplas so desenhadas, o comando plot automaticamente atribui em
          ciclos as cores a seguir:</para>

          <para></para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term></term>

        <listitem>
          <informaltable border="1">
            <tr>
              <td><literal>R</literal></td>

              <td><literal>G</literal></td>

              <td><literal>B</literal></td>
            </tr>

            <tr>
              <td>0.</td>

              <td>0.</td>

              <td>1.</td>
            </tr>

            <tr>
              <td>0.</td>

              <td>0.5</td>

              <td>0.</td>
            </tr>

            <tr>
              <td>1.</td>

              <td>0.</td>

              <td>0.</td>
            </tr>

            <tr>
              <td>0.</td>

              <td>0.75</td>

              <td>0.75</td>
            </tr>

            <tr>
              <td>0.75</td>

              <td>0.</td>

              <td>0.75</td>
            </tr>

            <tr>
              <td>0.75</td>

              <td>0.75</td>

              <td>0.</td>
            </tr>

            <tr>
              <td>0.25</td>

              <td>0.25</td>

              <td>0.25</td>
            </tr>
          </informaltable>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Marker type:</term>

        <listitem>
          <para>um string definindo o tipo do marcador. Note que se voc
          especificar um marcador (ou marca) sem um estilo de linha, apenas o
          marcador  desenhado. Esta propriedade est ligada  propriedade do
          objeto <literal>mark_style</literal> e <literal>mark_mode</literal>
          do objeto (ver <link
          linkend="polyline_properties">polyline_properties</link>).</para>

          <para></para>

          <informaltable border="1">
            <tr>
              <td><literal>especificador</literal></td>

              <td><literal>tipo de marcador</literal></td>
            </tr>

            <tr>
              <td><literal>+</literal></td>

              <td>sinal de mais</td>
            </tr>

            <tr>
              <td><literal>o</literal></td>

              <td>crculo</td>
            </tr>

            <tr>
              <td><literal>*</literal></td>

              <td>astersco</td>
            </tr>

            <tr>
              <td><literal>.</literal></td>

              <td>ponto</td>
            </tr>

            <tr>
              <td><literal>x</literal></td>

              <td>cruz</td>
            </tr>

            <tr>
              <td><literal>'square'</literal> ou <literal>'s'</literal></td>

              <td>quadrado</td>
            </tr>

            <tr>
              <td><literal>'diamond'</literal> ou <literal>'d'</literal></td>

              <td>rombo (ou diamante)</td>
            </tr>

            <tr>
              <td><literal>^</literal></td>

              <td>tringulo para cima</td>
            </tr>

            <tr>
              <td><literal>v</literal></td>

              <td>tringulo para baixo</td>
            </tr>

            <tr>
              <td><literal>&gt;</literal></td>

              <td>tringulo para a direita</td>
            </tr>

            <tr>
              <td><literal>&lt;</literal></td>

              <td>tringulo para a esquerda</td>
            </tr>

            <tr>
              <td><literal>'pentagram'</literal></td>

              <td>estrela de cinco pontas (pentagrama)</td>
            </tr>

            <tr>
              <td><literal>'none'</literal></td>

              <td>nenhum marcador (padro)</td>
            </tr>
          </informaltable>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsection>

  <refsection>
    <title>Exemplos</title>

    <programlisting role="example"><![CDATA[ 
x=1:0.1:10; // inicializao
plot(x,sin(x),'r.->') // esboando um linha de traos e pontos com um trungulo apontando para a direita centrado em cada ponto.
clf();

// se voc especificar um marcador sem um estilo de linha, apenas a marca  desenhada
plot(x,sin(x),'d') // esboando um linha de traos e pontos com um trungulo apontando para a direita centrado em cada ponto

x=1:10; // Init.
// a ordem das combinaes no importa
plot(x,x.*x,'*cya--') 

//mltiplos esbooes com diferentes LineSpecs
clf();
t=0:%pi/20:2*%pi;
plot(t,sin(t),'ro-.',t,cos(t),'cya+',t,abs(sin(t)),'--mo')
 ]]></programlisting>
  </refsection>

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

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

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

      <member><link linkend="clf">clf</link></member>
    </simplelist>
  </refsection>

  <refsection>
    <title>Autor</title>

    <para>F.Leray</para>
  </refsection>
</refentry>