update banners
[scilab.git] / scilab / modules / graphics / help / pt_BR / 3d_plot / param3d.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) ENPC - Jean-Philippe Chancelier
5  *
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  -->
16 <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="param3d" xml:lang="pt">
17     <refnamediv>
18         <refname>param3d</refname>
19         <refpurpose>esboço 3d de uma curva parametrizada</refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>Seqüência de Chamamento</title>
23         <synopsis>param3d(x,y,z,[theta,alpha,leg,flag,ebox])</synopsis>
24     </refsynopsisdiv>
25     <refsection>
26         <title>Parâmetros</title>
27         <variablelist>
28             <varlistentry>
29                 <term>x,y,z</term>
30                 <listitem>
31                     <para>três vetores de mesmo tamanho (pontos da curva
32                         parametrizada).
33                     </para>
34                 </listitem>
35             </varlistentry>
36             <varlistentry>
37                 <term>theta, alpha</term>
38                 <listitem>
39                     <para>valores reais fornecendo em graus as coordenadas esféricas do
40                         ponto de observação. <emphasis>os valores padrões são 35 e 45
41                             graus.
42                         </emphasis>
43                     </para>
44                 </listitem>
45             </varlistentry>
46             <varlistentry>
47                 <term>leg</term>
48                 <listitem>
49                     <para>string definindo rótulos para cada eixo com @ como separador
50                         de campo, por exemplo"X@Y@Z".
51                     </para>
52                 </listitem>
53             </varlistentry>
54             <varlistentry>
55                 <term>flag=[type,box]</term>
56                 <listitem>
57                     <para>
58                         <literal>type</literal> e <literal>box</literal> possuem o
59                         mesmo significado que em <literal>plot3d</literal>:
60                     </para>
61                     <variablelist>
62                         <varlistentry>
63                             <term>type</term>
64                             <listitem>
65                                 <para>um inteiro (tipo de escala).</para>
66                                 <variablelist>
67                                     <varlistentry>
68                                         <term>type=0</term>
69                                         <listitem>
70                                             <para>o esboço é feito utilizando-se a escala 3d
71                                                 corrente (definida por uma chamada anterior a
72                                                 <literal>param3d</literal>, <literal>plot3d</literal>,
73                                                 <literal>contour</literal> ou
74                                                 <literal>plot3d1</literal>).
75                                             </para>
76                                         </listitem>
77                                     </varlistentry>
78                                     <varlistentry>
79                                         <term>type=1</term>
80                                         <listitem>
81                                             <para>re-escala automaticamente caixas 3d com relação de
82                                                 aspecto extrema, as fronteiras são especificadas pelo
83                                                 valor do argumento opcional
84                                                 <literal>ebox</literal>.
85                                             </para>
86                                         </listitem>
87                                     </varlistentry>
88                                     <varlistentry>
89                                         <term>type=2</term>
90                                         <listitem>
91                                             <para>re-escala automaticamente caixas 3d com relação de
92                                                 aspecto extrema, as fronteiras são computadas
93                                                 utilizando-se dados fornecidos. <emphasis>Este é o valor
94                                                     padrão
95                                                 </emphasis>
96                                             </para>
97                                         </listitem>
98                                     </varlistentry>
99                                     <varlistentry>
100                                         <term>type=3</term>
101                                         <listitem>
102                                             <para>fronteiras 3d isométricas com fronteiras da caixa
103                                                 dadas por <literal>ebox</literal>, de modo semelhante a
104                                                 <literal>type=1</literal>.
105                                             </para>
106                                         </listitem>
107                                     </varlistentry>
108                                     <varlistentry>
109                                         <term>type=4</term>
110                                         <listitem>
111                                             <para>fronteiras 3d isométricas derivadas dos dados, de
112                                                 modo semelhante a<literal> type=2</literal>.
113                                             </para>
114                                         </listitem>
115                                     </varlistentry>
116                                     <varlistentry>
117                                         <term>type=5</term>
118                                         <listitem>
119                                             <para>fronteiras 3d isométricas expandidas com
120                                                 fronteiras fornecidas por <literal>ebox</literal>, de
121                                                 modo semelhante a <literal>type=1</literal>.
122                                             </para>
123                                         </listitem>
124                                     </varlistentry>
125                                     <varlistentry>
126                                         <term>type=6</term>
127                                         <listitem>
128                                             <para>fronteiras 3d isométricas expandidas derivadas dos
129                                                 dados, de modo semelhante a
130                                                 <literal>type=2</literal>.Note que as fronteiras dos
131                                                 eixos podem ser customizadas através das propriedades da
132                                                 entidade de eixos (ver <link linkend="axes_properties">axes_properties</link>).
133                                             </para>
134                                         </listitem>
135                                     </varlistentry>
136                                 </variablelist>
137                             </listitem>
138                         </varlistentry>
139                         <varlistentry>
140                             <term>box</term>
141                             <listitem>
142                                 <para>um inteiro (moldura ao redor do esboço).</para>
143                                 <variablelist>
144                                     <varlistentry>
145                                         <term>box=0</term>
146                                         <listitem>
147                                             <para>nada é desenhado ao redor do esboço.</para>
148                                         </listitem>
149                                     </varlistentry>
150                                     <varlistentry>
151                                         <term>box=1</term>
152                                         <listitem>
153                                             <para>não implementado (é como box=0).</para>
154                                         </listitem>
155                                     </varlistentry>
156                                     <varlistentry>
157                                         <term>box=2</term>
158                                         <listitem>
159                                             <para>apenas os eixos atrás da superfície são
160                                                 desenhados.
161                                             </para>
162                                         </listitem>
163                                     </varlistentry>
164                                     <varlistentry>
165                                         <term>box=3</term>
166                                         <listitem>
167                                             <para>uma caixa cercando a superfície é desenhada e
168                                                 legendas são adicionadas.
169                                             </para>
170                                         </listitem>
171                                     </varlistentry>
172                                     <varlistentry>
173                                         <term>box=4</term>
174                                         <listitem>
175                                             <para>uma caixa cercando a superfície é desenhada e
176                                                 legendas e eixos são adicionados. Note que o aspecto dos
177                                                 eixos também pode ser customizado através das
178                                                 propriedades da entidade Axes (ver <link linkend="axes_properties">axes_properties</link>).
179                                                 <emphasis>Este é o padrão</emphasis>
180                                             </para>
181                                         </listitem>
182                                     </varlistentry>
183                                 </variablelist>
184                             </listitem>
185                         </varlistentry>
186                     </variablelist>
187                 </listitem>
188             </varlistentry>
189             <varlistentry>
190                 <term>ebox</term>
191                 <listitem>
192                     <para>especifica as fronteiras do esboço através do vetor
193                         <literal>[xmin,xmax,ymin,ymax,zmin,zmax]</literal>. Este argumento é
194                         utilizado junto com <literal>type</literal> em
195                         <literal>flag</literal> se este for ajustado para
196                         <literal>1</literal>, <literal>3</literal> ou <literal>5</literal>
197                         (volte acima para ver o comportamento correspondente). Se
198                         <literal>flag</literal> estiver faltando, <literal>ebox</literal>
199                         não é levado em conta. Note que, quando especificado, o argumento
200                         <literal>ebox</literal> age no campo <literal>data_bounds</literal>
201                         field que também pode ser ajustado através das propriedades da
202                         entidade de eixos (ver <link linkend="axes_properties">axes_properties</link>). O valor padrão de
203                         ebox é [0,1,0,1,0,1].
204                     </para>
205                 </listitem>
206             </varlistentry>
207         </variablelist>
208     </refsection>
209     <refsection>
210         <title>Descrição</title>
211         <para>
212             <literal>param3d</literal> é usado para esboçar uma curva 3d
213             definida por suas coordenadas <literal>x</literal>, <literal>y</literal> e
214             <literal>z</literal>. Note que os dados também podem ser ajustados ou
215             recebidos através das propriedades da entidade superfície (ver <link linkend="surface_properties">surface_properties</link>).
216         </para>
217         <para>
218             Note que propriedades como <literal>rotation angles</literal>,
219             <literal>colors</literal> e <literal>thickness</literal> da superfície
220             esboçada também podem ser ajustadas através das propriedades de param3d
221             (ver <link linkend="param3d_properties">param3d_properties</link>).
222         </para>
223         <para>
224             Use <literal>param3d1</literal> para realizar esboços
225             múltiplos.
226         </para>
227         <para>
228             Entre com o comando <literal>param3d()</literal> para visualizar uma
229             demonstração.
230         </para>
231     </refsection>
232     <refsection>
233         <title>Exemplos</title>
234         <programlisting role="example"><![CDATA[
235 t=0:0.1:5*%pi;
236 param3d(sin(t),cos(t),t/10,35,45,"X@Y@Z",[2,3])
237
238 e=gce() //o manipulador para a poligonal 3d
239
240 e.foreground=color('red');
241
242 a=gca(); //o manipulador para os eixos
243 a.rotation_angles=[10 70];
244  ]]></programlisting>
245     </refsection>
246     <refsection>
247         <title>Ver Também</title>
248         <simplelist type="inline">
249             <member>
250                 <link linkend="param3d1">param3d1</link>
251             </member>
252             <member>
253                 <link linkend="plot3d">plot3d</link>
254             </member>
255         </simplelist>
256     </refsection>
257 </refentry>