<?xml version="1.0" encoding="UTF-8"?>
<!--
 * Scilab ( http://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="plot3d2" xml:lang="pt">
    <refnamediv>
        <refname>plot3d2</refname>
        <refpurpose>Esboço de superfície definida por facetas
            retangulares
        </refpurpose>
    </refnamediv>
    <refsynopsisdiv>
        <title>Seqüência de Chamamento</title>
        <synopsis>plot3d2(X,Y,Z [,vect,theta,alpha,leg,flag,ebox])
            plot3d2(X,Y,Z, &lt;opt_args&gt;)
        </synopsis>
    </refsynopsisdiv>
    <refsection>
        <title>Parâmetros</title>
        <variablelist>
            <varlistentry>
                <term>X, Y, Z:</term>
                <listitem>
                    <para>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 três.
                        <literal>flag=[mode,type,box]</literal>.
                    </para>
                    <variablelist>
                        <varlistentry>
                            <term>mode</term>
                            <listitem>
                                <para>um inteiro (cor da superfície).</para>
                                <variablelist>
                                    <varlistentry>
                                        <term>mode&gt;0</term>
                                        <listitem>
                                            <para>a superfície é pintada com a cor
                                                <literal>"mode"</literal> ; a borda da faceta é
                                                desenhada com os estilos correntes de linha e cor.
                                            </para>
                                        </listitem>
                                    </varlistentry>
                                    <varlistentry>
                                        <term>mode=0:</term>
                                        <listitem>
                                            <para>uma malha da superfície é desenhada. </para>
                                        </listitem>
                                    </varlistentry>
                                    <varlistentry>
                                        <term>mode&lt;0:</term>
                                        <listitem>
                                            <para>a superfície é pintada com a cor
                                                <literal>"-mode"</literal> ; a borda da faceta não é
                                                desenhada.
                                            </para>
                                            <para>Note que o tratamento de cor da superfície pode
                                                ser feito utilizando-se as opções
                                                <literal>color_mode</literal> e
                                                <literal>color_flag</literal> através das propriedades
                                                da entidade superfície (ver <link linkend="surface_properties">surface_properties</link>).
                                            </para>
                                        </listitem>
                                    </varlistentry>
                                </variablelist>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>type</term>
                            <listitem>
                                <para>um inteiro (tipo de escala). </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 Axes
                                                (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)</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>. Este 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.
                    </para>
                    <para>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>plot3d2</literal> esboça uma superfície definida por
            facetas retangulares. (X,Y,Z) são três matrizes que descrevem uma
            superfície. A superfície é composta de 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. Como
            em <literal>plot3d</literal>, as mesmas propriedades são editáveis (ver
            <link linkend="surface_properties">surface_properties</link> e <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);
plot3d2(X,Y,Z);
// apenas no novo modo de gráficos
e=gce();
e.color_mode=4; // mudando a cor
f_data=e.data;
TL = tlist(["3d" "x" "y" "z" "color"],f_data.x,f_data.y,f_data.z,10*(f_data.z)+1);
e.data=TL;
e.color_flag=2;
 ]]></programlisting>
    </refsection>
    <refsection role="see also">
        <title>Ver Também</title>
        <simplelist type="inline">
            <member>
                <link linkend="plot3d">plot3d</link>
            </member>
            <member>
                <link linkend="genfac3d">genfac3d</link>
            </member>
        </simplelist>
    </refsection>
</refentry>
