206718f28f1e4d9de566735830663d760da10719
[scilab.git] / scilab / modules / graphics / help / pt_BR / 3d_plot / plot3d2.xml
1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) INRIA
5  * 
6  * This file must be used under the terms of the CeCILL.
7  * This source file is licensed as described in the file COPYING, which
8  * you should have received as part of this distribution.  The terms
9  * are also available at    
10  * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
11  *
12  -->
13 <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" version="5.0-subset Scilab" xml:id="plot3d2" xml:lang="en">
14     <refnamediv>
15         <refname>plot3d2</refname>
16         <refpurpose>Esboço de superfície definida por facetas
17             retangulares
18         </refpurpose>
19     </refnamediv>
20     <refsynopsisdiv>
21         <title>Seqüência de Chamamento</title>
22         <synopsis>plot3d2(X,Y,Z [,vect,theta,alpha,leg,flag,ebox])
23             plot3d2(X,Y,Z, &lt;opt_args&gt;)
24         </synopsis>
25     </refsynopsisdiv>
26     <refsection>
27         <title>Parâmetros</title>
28         <variablelist>
29             <varlistentry>
30                 <term>X, Y, Z:</term>
31                 <listitem>
32                     <para>três matrizes de reais definindo uma estrutura de dados.
33                     </para>
34                 </listitem>
35             </varlistentry>
36             <varlistentry>
37                 <term>vect</term>
38                 <listitem>
39                     <para>vetor de reais. </para>
40                 </listitem>
41             </varlistentry>
42             <varlistentry>
43                 <term>&lt;opt_args&gt;</term>
44                 <listitem>
45                     <para>
46                         representa uma seqüência de declarações <literal>key1=value1,
47                             key2=value2
48                         </literal>
49                         ,... onde <literal>key1</literal>,
50                         <literal>key2,...</literal> podem ser um dos seguintes: theta, alpha
51                         ,leg,flag,ebox (ver definições abaixo). 
52                     </para>
53                 </listitem>
54             </varlistentry>
55             <varlistentry>
56                 <term>theta, alpha</term>
57                 <listitem>
58                     <para>valores reais de dados em graus, as coordenadas esféricas do
59                         ponto de observação. 
60                     </para>
61                 </listitem>
62             </varlistentry>
63             <varlistentry>
64                 <term>leg</term>
65                 <listitem>
66                     <para>string definindo os rótulos para cada eixo com @ como um
67                         separador de campos, por exemplo "X@Y@Z". 
68                     </para>
69                 </listitem>
70             </varlistentry>
71             <varlistentry>
72                 <term>flag</term>
73                 <listitem>
74                     <para>um vetor real de tamanho três.
75                         <literal>flag=[mode,type,box]</literal>.
76                     </para>
77                     <variablelist>
78                         <varlistentry>
79                             <term>mode</term>
80                             <listitem>
81                                 <para>um inteiro (cor da superfície).</para>
82                                 <variablelist>
83                                     <varlistentry>
84                                         <term>mode&gt;0</term>
85                                         <listitem>
86                                             <para>a superfície é pintada com a cor
87                                                 <literal>"mode"</literal> ; a borda da faceta é
88                                                 desenhada com os estilos correntes de linha e cor.
89                                             </para>
90                                         </listitem>
91                                     </varlistentry>
92                                     <varlistentry>
93                                         <term>mode=0:</term>
94                                         <listitem>
95                                             <para>uma malha da superfície é desenhada. </para>
96                                         </listitem>
97                                     </varlistentry>
98                                     <varlistentry>
99                                         <term>mode&lt;0:</term>
100                                         <listitem>
101                                             <para>a superfície é pintada com a cor
102                                                 <literal>"-mode"</literal> ; a borda da faceta não é
103                                                 desenhada.
104                                             </para>
105                                             <para>Note que o tratamento de cor da superfície pode
106                                                 ser feito utilizando-se as opções
107                                                 <literal>color_mode</literal> e
108                                                 <literal>color_flag</literal> através das propriedades
109                                                 da entidade superfície (ver <link linkend="surface_properties">surface_properties</link>).
110                                             </para>
111                                         </listitem>
112                                     </varlistentry>
113                                 </variablelist>
114                             </listitem>
115                         </varlistentry>
116                         <varlistentry>
117                             <term>type</term>
118                             <listitem>
119                                 <para>um inteiro (tipo de escala). </para>
120                                 <variablelist>
121                                     <varlistentry>
122                                         <term>type=0:</term>
123                                         <listitem>
124                                             <para>o esboço é feito utilizando-se a escala 3d
125                                                 corrente (definida por uma chamada anterior a
126                                                 <literal>param3d</literal>, <literal>plot3d</literal>,
127                                                 <literal>contour</literal> ou
128                                                 <literal>plot3d1</literal>).
129                                             </para>
130                                         </listitem>
131                                     </varlistentry>
132                                     <varlistentry>
133                                         <term>type=1:</term>
134                                         <listitem>
135                                             <para>re-escala automaticamente caixas 3d com relação de
136                                                 aspecto extrema, as fronteiras são especificadas pelo
137                                                 valor do argumento opcional
138                                                 <literal>ebox</literal>.
139                                             </para>
140                                         </listitem>
141                                     </varlistentry>
142                                     <varlistentry>
143                                         <term>type=2:</term>
144                                         <listitem>
145                                             <para> re-escala automaticamente caixas 3d com relação
146                                                 de aspecto extrema, as fronteiras são computadas
147                                                 utilizando-se dados fornecidos. 
148                                             </para>
149                                         </listitem>
150                                     </varlistentry>
151                                     <varlistentry>
152                                         <term>type=3:</term>
153                                         <listitem>
154                                             <para> fronteiras 3d isométricas com fronteiras da caixa
155                                                 dadas por <literal>ebox</literal>, de modo semelhante a
156                                                 <literal>type=1</literal>.
157                                             </para>
158                                         </listitem>
159                                     </varlistentry>
160                                     <varlistentry>
161                                         <term>type=4:</term>
162                                         <listitem>
163                                             <para>fronteiras 3d isométricas derivadas dos dados, de
164                                                 modo semelhante a <literal>type=2</literal>.
165                                             </para>
166                                         </listitem>
167                                     </varlistentry>
168                                     <varlistentry>
169                                         <term>type=5:</term>
170                                         <listitem>
171                                             <para> fronteiras 3d isométricas expandidas com
172                                                 fronteiras fornecidas por <literal>ebox</literal>, de
173                                                 modo semelhante a <literal>type=1</literal>.
174                                             </para>
175                                         </listitem>
176                                     </varlistentry>
177                                     <varlistentry>
178                                         <term>type=6:</term>
179                                         <listitem>
180                                             <para> fronteiras 3d isométricas expandidas derivadas
181                                                 dos dados, de modo semelhante a
182                                                 <literal>type=2</literal>.
183                                             </para>
184                                             <para>Note que as fronteiras dos eixos podem ser
185                                                 customizadas através das propriedades da entidade Axes
186                                                 (ver <link linkend="axes_properties">axes_properties</link>).
187                                             </para>
188                                         </listitem>
189                                     </varlistentry>
190                                 </variablelist>
191                             </listitem>
192                         </varlistentry>
193                         <varlistentry>
194                             <term>box</term>
195                             <listitem>
196                                 <para>um inteiro (moldura ao redor do esboço)</para>
197                                 <variablelist>
198                                     <varlistentry>
199                                         <term>box=0:</term>
200                                         <listitem>
201                                             <para>nada é desenhado ao redor do esboço. </para>
202                                         </listitem>
203                                     </varlistentry>
204                                     <varlistentry>
205                                         <term>box=1:</term>
206                                         <listitem>
207                                             <para>não implementado (é como box=0) </para>
208                                         </listitem>
209                                     </varlistentry>
210                                     <varlistentry>
211                                         <term>box=2:</term>
212                                         <listitem>
213                                             <para>apenas os eixos atrás da superfície são
214                                                 desenhados. 
215                                             </para>
216                                         </listitem>
217                                     </varlistentry>
218                                     <varlistentry>
219                                         <term>box=3:</term>
220                                         <listitem>
221                                             <para>uma caixa cercando a superfície é desenhada e
222                                                 legendas são adicionadas. 
223                                             </para>
224                                         </listitem>
225                                     </varlistentry>
226                                     <varlistentry>
227                                         <term>box=4:</term>
228                                         <listitem>
229                                             <para> uma caixa cercando a superfície é desenhada e
230                                                 legendas e eixos são adicionados.
231                                             </para>
232                                             <para>Note que o aspecto dos eixos pode ser customizado
233                                                 através das propriedades da entidade Axes (ver <link linkend="axes_properties">axes_properties</link>).
234                                             </para>
235                                         </listitem>
236                                     </varlistentry>
237                                 </variablelist>
238                             </listitem>
239                         </varlistentry>
240                     </variablelist>
241                 </listitem>
242             </varlistentry>
243             <varlistentry>
244                 <term>ebox</term>
245                 <listitem>
246                     <para>especifica as fronteiras do esboço através do vetor
247                         <literal>[xmin,xmax,ymin,ymax,zmin,zmax]</literal>. Este argumento é
248                         utilizado junto com <literal>type</literal> em
249                         <literal>flag</literal>, se for ajustado para <literal>1</literal>,
250                         <literal>3</literal> ou <literal>5</literal> (volte acima para ver o
251                         comportamento correspondente). Se <literal>flag</literal> estiver
252                         faltando, <literal>ebox</literal> não é levado em conta. 
253                     </para>
254                     <para>Note que, quando especificado, o argumento
255                         <literal>ebox</literal> age no campo <literal>data_bounds</literal>
256                         que também pode ser ajustado através das propriedades da entidade
257                         Axes (ver <link linkend="axes_properties">axes_properties</link>).
258                     </para>
259                 </listitem>
260             </varlistentry>
261         </variablelist>
262     </refsection>
263     <refsection>
264         <title>Descrição</title>
265         <para>
266             <literal>plot3d2</literal> esboça uma superfície definida por
267             facetas retangulares. (X,Y,Z) são três matrizes que descrevem uma
268             superfície. A superfície é composta de polígonos de quatro lados.
269         </para>
270         <para>As coordenadas x de uma faceta são dadas por
271             X(i,j),X(i+1,j),X(i,j+1),X(i+1,j+1). De modo semelhante Y e Z são
272             coordenadas Y e Z.
273         </para>
274         <para>
275             O vetor <literal>vect</literal> é usado quando múltiplas superfícies
276             são codificadas nas mesmas matrizes (X,Y,Z). <literal>vect(j)</literal>
277             fornece a linha na qual a codificação da j-ésima superfície começa. Como
278             em <literal>plot3d</literal>, as mesmas propriedades são editáveis (ver
279             <link linkend="surface_properties">surface_properties</link> e <link linkend="axes_properties">axes_properties</link>).
280         </para>
281     </refsection>
282     <refsection>
283         <title>Exemplos</title>
284         <programlisting role="example"><![CDATA[ 
285 u = linspace(-%pi/2,%pi/2,40);
286 v = linspace(0,2*%pi,20);
287 X = cos(u)'*cos(v);
288 Y = cos(u)'*sin(v);
289 Z = sin(u)'*ones(v);
290 plot3d2(X,Y,Z);
291 // apenas no novo modo de gráficos 
292 e=gce();
293 e.color_mode=4; // mudando a cor
294 f=e.data;
295 TL = tlist(["3d" "x" "y" "z" "color"],f.x,f.y,f.z,10*(f.z)+1);
296 e.data=TL;
297 e.color_flag=2;
298  ]]></programlisting>
299     </refsection>
300     <refsection role="see also">
301         <title>Ver Também</title>
302         <simplelist type="inline">
303             <member>
304                 <link linkend="plot3d">plot3d</link>
305             </member>
306             <member>
307                 <link linkend="genfac3d">genfac3d</link>
308             </member>
309         </simplelist>
310     </refsection>
311 </refentry>