<?xml version="1.0" encoding="UTF-8"?>
<!--
 * Scilab ( https://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C) INRIA
 *
 * 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="plot3d3" xml:lang="pt">
    <refnamediv>
        <refname>plot3d3</refname>
        <refpurpose>Esboço de malha de uma superfície definida por facetas
            retangulares
        </refpurpose>
    </refnamediv>
    <refsynopsisdiv>
        <title>Seqüência de Chamamento</title>
        <synopsis>plot3d3(X,Y,Z [,vect,theta,alpha,leg,flag,ebox])
            plot3d3(X,Y,Z, &lt;opt_args&gt;)
        </synopsis>
    </refsynopsisdiv>
    <refsection>
        <title>Parâmetros</title>
        <variablelist>
            <varlistentry>
                <term>X, Y, Z:</term>
                <listitem>
                    <para>3 três matrizes de reais definindo uma estrutura de dados.
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>vect</term>
                <listitem>
                    <para>vetor de reais. </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>&lt;opt_args&gt;</term>
                <listitem>
                    <para>
                        representa uma seqüência de declarações <literal>key1=value1,
                            key2=value2
                        </literal>
                        ,... onde <literal>key1</literal>,
                        <literal>key2,...</literal> podem ser um dos seguintes: theta, alpha
                        ,leg,flag,ebox (ver definições abaixo).
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>theta, alpha</term>
                <listitem>
                    <para>valores reais de dados em graus, as coordenadas esféricas do
                        ponto de observação.
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>leg</term>
                <listitem>
                    <para>string definindo os rótulos para cada eixo com @ como um
                        separador de campos, por exemplo "X@Y@Z".
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>flag</term>
                <listitem>
                    <para>um vetor real de tamanho quatro.
                        <literal>flag=[vertical_color,
                            horizontal_color,type,box]
                        </literal>
                        .
                    </para>
                    <variablelist>
                        <varlistentry>
                            <term>vertical_color</term>
                            <listitem>
                                <para>um inteiro (cor da superfície), o padrão é 3.</para>
                                <para>Índice do mapa de cores definindo a cor a ser utilizada
                                    para se desenhar as bordas verticais.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>horizontal_color</term>
                            <listitem>
                                <para>um inteiro (cor da superfície), o padrão é 4.</para>
                                <para>Índice do mapa de cores definindo a cor a ser utilizada
                                    para se desenhar as bordas horizontais.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>type</term>
                            <listitem>
                                <para>um inteiro (escala) o padrão é 2.</para>
                                <variablelist>
                                    <varlistentry>
                                        <term>type=0:</term>
                                        <listitem>
                                            <para>o esboço é feito utilizando-se a escala 3d
                                                corrente (definida por uma chamada anterior a
                                                <literal>param3d</literal>, <literal>plot3d</literal>,
                                                <literal>contour</literal> ou
                                                <literal>plot3d1</literal>).
                                            </para>
                                        </listitem>
                                    </varlistentry>
                                    <varlistentry>
                                        <term>type=1:</term>
                                        <listitem>
                                            <para>re-escala automaticamente caixas 3d com relação de
                                                aspecto extrema, as fronteiras são especificadas pelo
                                                valor do argumento opcional
                                                <literal>ebox</literal>.
                                            </para>
                                        </listitem>
                                    </varlistentry>
                                    <varlistentry>
                                        <term>type=2:</term>
                                        <listitem>
                                            <para> re-escala automaticamente caixas 3d com relação
                                                de aspecto extrema, as fronteiras são computadas
                                                utilizando-se dados fornecidos.
                                            </para>
                                        </listitem>
                                    </varlistentry>
                                    <varlistentry>
                                        <term>type=3:</term>
                                        <listitem>
                                            <para> fronteiras 3d isométricas com fronteiras da caixa
                                                dadas por <literal>ebox</literal>, de modo semelhante a
                                                <literal>type=1</literal>.
                                            </para>
                                        </listitem>
                                    </varlistentry>
                                    <varlistentry>
                                        <term>type=4:</term>
                                        <listitem>
                                            <para> fronteiras 3d isométricas derivadas dos dados, de
                                                modo semelhante a <literal>type=2</literal>.
                                            </para>
                                        </listitem>
                                    </varlistentry>
                                    <varlistentry>
                                        <term>type=5:</term>
                                        <listitem>
                                            <para> fronteiras 3d isométricas expandidas com
                                                fronteiras fornecidas por <literal>ebox</literal>, de
                                                modo semelhante a <literal>type=1</literal>.
                                            </para>
                                        </listitem>
                                    </varlistentry>
                                    <varlistentry>
                                        <term>type=6:</term>
                                        <listitem>
                                            <para> fronteiras 3d isométricas expandidas derivadas
                                                dos dados, de modo semelhante a
                                                <literal>type=2</literal>.
                                            </para>
                                            <para>Note que as fronteiras dos eixos podem ser
                                                customizadas através das propriedades da entidade de
                                                eixos (ver <link linkend="axes_properties">axes_properties</link>).
                                            </para>
                                        </listitem>
                                    </varlistentry>
                                </variablelist>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>box</term>
                            <listitem>
                                <para>um inteiro (moldura ao redor do esboço), o padrão é
                                    4.
                                </para>
                                <variablelist>
                                    <varlistentry>
                                        <term>box=0:</term>
                                        <listitem>
                                            <para>nada é desenhado ao redor do esboço. </para>
                                        </listitem>
                                    </varlistentry>
                                    <varlistentry>
                                        <term>box=1:</term>
                                        <listitem>
                                            <para>não implementado (é como box=0) </para>
                                        </listitem>
                                    </varlistentry>
                                    <varlistentry>
                                        <term>box=2:</term>
                                        <listitem>
                                            <para>apenas os eixos atrás da superfície são
                                                desenhados.
                                            </para>
                                        </listitem>
                                    </varlistentry>
                                    <varlistentry>
                                        <term>box=3:</term>
                                        <listitem>
                                            <para>uma caixa cercando a superfície é desenhada e
                                                legendas são adicionadas.
                                            </para>
                                        </listitem>
                                    </varlistentry>
                                    <varlistentry>
                                        <term>box=4:</term>
                                        <listitem>
                                            <para>uma caixa cercando a superfície é desenhada e
                                                legendas e eixos são adicionados.
                                            </para>
                                            <para>Note que o aspecto dos eixos pode ser customizado
                                                através das propriedades da entidade Axes (ver <link linkend="axes_properties">axes_properties</link>).
                                            </para>
                                        </listitem>
                                    </varlistentry>
                                </variablelist>
                            </listitem>
                        </varlistentry>
                    </variablelist>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>ebox</term>
                <listitem>
                    <para>especifica as fronteiras do esboço através do vetor
                        <literal>[xmin,xmax,ymin,ymax,zmin,zmax]</literal>. TEste argumento
                        é utilizado junto com <literal>type</literal> em
                        <literal>flag</literal>, se for ajustado para <literal>1</literal>,
                        <literal>3</literal> ou <literal>5</literal> (volte acima para ver o
                        comportamento correspondente). Se <literal>flag</literal> estiver
                        faltando, <literal>ebox</literal> não é levado em conta. Note que,
                        quando especificado, o argumento <literal>ebox</literal> age no
                        campo <literal>data_bounds</literal> que também pode ser ajustado
                        através das propriedades da entidade Axes (ver <link linkend="axes_properties">axes_properties</link>).
                    </para>
                </listitem>
            </varlistentry>
        </variablelist>
    </refsection>
    <refsection>
        <title>Descrição</title>
        <para>
            <literal>plot3d3</literal> realiza um esboço de malha de uma
            superfície definida por facetas retangulares. (X,Y,Z) são três matrizes
            que descrevem uma superfície. A superfície é composta por polígonos de
            quatro lados.
        </para>
        <para>As coordenadas X de uma faceta são dadas por
            X(i,j),X(i+1,j),X(i,j+1),X(i+1,j+1). De modo semelhante Y e Z são
            coordenadas Y e Z.
        </para>
        <para>
            O vetor <literal>vect</literal> é usado quando múltiplas superfícies
            são codificadas nas mesmas matrizes (X,Y,Z). <literal>vect(j)</literal>
            fornece a linha na qual a codificação da j-ésima superfície começa. Ver
            <literal>plot3d2</literal> para uma descrição completa. Como um esboço de
            malha, a única propriedade disponível que você pode editar é a opção
            <literal>visible</literal> (ver <link linkend="axes_properties">axes_properties</link>).
        </para>
    </refsection>
    <refsection>
        <title>Exemplos</title>
        <programlisting role="example"><![CDATA[
u = linspace(-%pi/2,%pi/2,40);
v = linspace(0,2*%pi,20);
X = cos(u)'*cos(v);
Y = cos(u)'*sin(v);
Z = sin(u)'*ones(v);
plot3d3(X,Y,Z);
// apenas no novo modo de gráficos
e=gce(); // obtendo a entidade corrente
e.visible='off';
e.visible='on'; // de volta à visão da malha
 ]]></programlisting>
    </refsection>
    <refsection role="see also">
        <title>Ver Também</title>
        <simplelist type="inline">
            <member>
                <link linkend="plot3d2">plot3d2</link>
            </member>
            <member>
                <link linkend="plot3d">plot3d</link>
            </member>
            <member>
                <link linkend="param3d">param3d</link>
            </member>
        </simplelist>
    </refsection>
</refentry>
