<?xml version="1.0" encoding="UTF-8"?>
<!--
 * Scilab ( https://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C)  2009 - Digiteo - Jean-Baptiste Silvy
 *
 * Copyright (C) 2012 - 2016 - Scilab Enterprises
 *
 * This file is hereby licensed under the terms of the GNU GPL v2.0,
 * pursuant to article 5.3.4 of the CeCILL v.2.1.
 * This file was originally licensed under the terms of the CeCILL v2.1,
 * and continues to be available under such terms.
 * For more information, see the COPYING file which you should have received
 * along with this program.
 *
 -->
<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="graphics_fonts" xml:lang="pt">
    <refnamediv>
        <refname>graphics_fonts</refname>
        <refpurpose>Descrição de fontes utilizadas em figuras
            gráficas
        </refpurpose>
    </refnamediv>
    <refsection>
        <title>Descrição</title>
        <para>Algumas entidades gráficas como Text, Axes, Label ou Legend exibem
            um ou mais strings em suas figuras gráficas. A aparência dos strings
            exibidos pode ser modificada especificando diferentes fontes e tamanhos de
            caracteres.
        </para>
        <para/>
        <variablelist>
            <varlistentry>
                <term>Mudando a fonte</term>
                <listitem>
                    <para>Fontes utilizadas em figuras gráficas são selecionadas de um
                        conjunto de fontes chamado fontes carregadas. Em outras palavras, as
                        fontes carregadas são aquelas correntemente disponíveis em figuras
                        gráficas. Uma lista destas fontes pode ser obtida utilizando-se a
                        função <literal>xlfont</literal> sem argumento. Por padrão, o Scilab
                        possui um conjunto de 11 fontes carregadas. Este conjunto pode ser
                        modificado e estendido utilizando-se a função
                        <literal>xlfont</literal> com um nome de fonte como argumento. A
                        fonte carregada pode ser de um arquivo ou mesmo uma uma do sistema.
                        Para conhecer a lista de fontes disponíveis no sistema, utilize o
                        comando <literal>xlfont('AVAILABLE_FONTS')</literal>. Para mais
                        informações sobre como manipular fontes, veja <link linkend="xlfont">xlfont</link>.
                    </para>
                    <para>Aqui está a lista das 11 fontes padrões</para>
                    <informaltable border="1">
                        <tr>
                            <td>
                                <emphasis role="bold">Número da fonte</emphasis>
                            </td>
                            <td>
                                <emphasis role="bold">Família de Fontes</emphasis>
                            </td>
                            <td>
                                <emphasis role="bold">Negrito</emphasis>
                            </td>
                            <td>
                                <emphasis role="bold">Itálico</emphasis>
                            </td>
                        </tr>
                        <tr>
                            <td>0</td>
                            <td>Monospaced</td>
                            <td>Não</td>
                            <td>Não</td>
                        </tr>
                        <tr>
                            <td>1</td>
                            <td>ScilabSymbols</td>
                            <td>Não</td>
                            <td>Não</td>
                        </tr>
                        <tr>
                            <td>2</td>
                            <td>Serif</td>
                            <td>Não</td>
                            <td>Não</td>
                        </tr>
                        <tr>
                            <td>3</td>
                            <td>Serif</td>
                            <td>Não</td>
                            <td>Sim</td>
                        </tr>
                        <tr>
                            <td>4</td>
                            <td>Serif</td>
                            <td>Sim</td>
                            <td>Não</td>
                        </tr>
                        <tr>
                            <td>5</td>
                            <td>Serif</td>
                            <td>Sim</td>
                            <td>Sim</td>
                        </tr>
                        <tr>
                            <td>6</td>
                            <td>SansSerif</td>
                            <td>Não</td>
                            <td>Não</td>
                        </tr>
                        <tr>
                            <td>7</td>
                            <td>SansSerif</td>
                            <td>Não</td>
                            <td>Sim</td>
                        </tr>
                        <tr>
                            <td>8</td>
                            <td>SansSerif</td>
                            <td>Sim</td>
                            <td>Não</td>
                        </tr>
                        <tr>
                            <td>9</td>
                            <td>SansSerif</td>
                            <td>Sim</td>
                            <td>Sim</td>
                        </tr>
                        <tr>
                            <td>10</td>
                            <td>SansSerif</td>
                            <td>Sim</td>
                            <td>Sim</td>
                        </tr>
                    </informaltable>
                    <para>A fonte utilizada por uma entidade gráfica pode ser alterada
                        através da propriedade <literal>font_style</literal>. Esta é um
                        inteiro positivo fazendo referência a uma das fontes. Seu valor deve
                        estar entre 0, fazendo referência à primeira fonte, e o número de
                        fontes carregadas menos um, fazendo referência à última
                        fonte.
                    </para>
                    <para>
                        A propriedade <literal>fractional_font</literal> controla o
                        anti-serrilhamento da fonte. Seu valor pode ser
                        <literal>'on'</literal> ou <literal>'off'</literal>. Se for
                        <literal>'on'</literal>a fonte é suavizada, em caso contrário, ela
                        não é.
                    </para>
                    <para/>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>Mudando o tamanho dos caracteres</term>
                <listitem>
                    <para>O tamanho do texto de uma entidade gráfica é modificado
                        através da propriedade <literal>font_size</literal>. É um escalar
                        especificando o tamanho dos caracteres exibidos.
                    </para>
                    <para>O tamanho do caractere do Scilab é diferente do tamanho do
                        caractere Java. Aqui está uma equivalência entre as duas
                        escalas.
                    </para>
                    <informaltable border="1">
                        <tr>
                            <td>
                                <emphasis role="bold">Tamanho Scilab</emphasis>
                            </td>
                            <td>
                                <emphasis role="bold">Tamanho Java</emphasis>
                            </td>
                        </tr>
                        <tr>
                            <td>0</td>
                            <td>8</td>
                        </tr>
                        <tr>
                            <td>1</td>
                            <td>10</td>
                        </tr>
                        <tr>
                            <td>2</td>
                            <td>12</td>
                        </tr>
                        <tr>
                            <td>3</td>
                            <td>14</td>
                        </tr>
                        <tr>
                            <td>4</td>
                            <td>18</td>
                        </tr>
                        <tr>
                            <td>5</td>
                            <td>24</td>
                        </tr>
                        <tr>
                            <td>6</td>
                            <td>30</td>
                        </tr>
                        <tr>
                            <td>7</td>
                            <td>36</td>
                        </tr>
                        <tr>
                            <td>8</td>
                            <td>42</td>
                        </tr>
                        <tr>
                            <td>9</td>
                            <td>48</td>
                        </tr>
                        <tr>
                            <td>10</td>
                            <td>54</td>
                        </tr>
                    </informaltable>
                    <para>O tamanho do caractere pode não ser um inteiro. Neste caso, o
                        resultado depende da propriedade <literal>fractional_font</literal>
                        da entidade. Se a propriedade <literal>fractional_font</literal> for
                        <literal>'on'</literal>, então o tamanho da fonte é interpolado
                        entre os dois inteiros mais próximos. Por exemplo, um tamanho de
                        fonte 2.5 exibe caracteres com tamanho Java 13. Se a propriedade
                        <literal>fractional_font</literal> for <literal>'off'</literal>,
                        então a fonte exibida é truncada para a sua parte inteira. Por
                        exemplo, um tamanho de fonte 2.5 exibe caracteres Java de tamanho
                        12.
                    </para>
                    <para/>
                </listitem>
            </varlistentry>
        </variablelist>
    </refsection>
    <refsection role="see also">
        <title>Ver Também</title>
        <simplelist type="inline">
            <member>
                <link linkend="xlfont">xlfont</link>
            </member>
            <member>
                <link linkend="graphics_entities">graphics_entities</link>
            </member>
        </simplelist>
    </refsection>
</refentry>
