<?xml version="1.0" encoding="UTF-8"?>
<!--
 * Scilab ( https://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C) ENPC - Jean-Philippe Chancelier
 *
 * 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="geom3d" xml:lang="pt">
    <refnamediv>
        <refname>geom3d</refname>
        <refpurpose>projeção 3d para 2d após um esboço 3d</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
        <title>Seqüência de Chamamento</title>
        <synopsis>[x,y]=geom3d(x1,y1,z1)</synopsis>
    </refsynopsisdiv>
    <refsection>
        <title>Parâmetros</title>
        <variablelist>
            <varlistentry>
                <term>x1,y1,z1</term>
                <listitem>
                    <para>vetores reais de mesmo tamanho (pontos em 3d). </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>x,y</term>
                <listitem>
                    <para>
                        vetores reais de mesmos tamanhos que <literal>x1</literal>,
                        <literal>y1</literal> e <literal>z1</literal>.
                    </para>
                </listitem>
            </varlistentry>
        </variablelist>
    </refsection>
    <refsection>
        <title>Descrição</title>
        <para>Após o uso de uma função de esboço 3d como
            <literal>plot3d</literal>, <literal>plot3d1</literal> ou
            <literal>param3d</literal>, <literal>geom3d</literal> gives the mapping
            between a point in 3D space <literal>(x1(i),y1(i),z1(i))</literal> e o
            ponto correspondente <literal>(x(i),y(i))</literal> no plano 2d projetado.
            Então, todas as primitivas de gráficos 2d que funcionam em
            <literal>(x,y)</literal> podem ser usadas para superposição no esboço
            3d.
        </para>
    </refsection>
    <refsection>
        <title>Exemplos</title>
        <programlisting role="example"><![CDATA[
deff("[z]=surface(x,y)","z=sin(x)*cos(y)")
t=%pi*(-10:10)/10;
// esboço 3d da superfície
fplot3d(t,t,surface,35,45,"X@Y@Z")
// agora, (t,t,sin(t).*cos(t)) é uma curva na superfície
// que pode ser desenhada utilizando-se geom3d e xpoly
[x,y]=geom3d(%pi/2,0,surface(%pi/2,0))
 ]]></programlisting>
    </refsection>
</refentry>
