4ec065475a5f0cb774e251a46736c98717547690
[scilab.git] / scilab / modules / graphics / help / pt_BR / 3d_plot / param3d1.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="param3d1" xml:lang="pt">
17     <refnamediv>
18         <refname>param3d1</refname>
19         <refpurpose>esboço 3d de curvas parametrizadas</refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>Seqüência de Chamamento</title>
23         <synopsis>param3d1(x,y,z,[theta,alpha,leg,flag,ebox])
24             param3d1(x,y,list(z,colors),[theta,alpha,leg,flag,ebox])
25         </synopsis>
26     </refsynopsisdiv>
27     <refsection>
28         <title>Parâmetros</title>
29         <variablelist>
30             <varlistentry>
31                 <term>x,y,z</term>
32                 <listitem>
33                     <para>matrizes de mesmo tamanho (nl,nc). </para>
34                     <para>Cada coluna i das matrizes corresponde às coordenadas da
35                         i-ésima curva. Você pode fornecer uma cor específica para cada curva
36                         utilizando <literal>list(z,colors)</literal> ao invés de
37                         <literal>z</literal>, onde <literal>colors</literal> é um vetor de
38                         tamanho <literal>nc</literal>. Se <literal>color(i)</literal> for
39                         negativo, a curva é esboçada utilizando-se a marca com identificador
40                         <literal>abs(style(i))</literal>; se <literal>style(i)</literal> for
41                         estritamente positivo, uma linha simples com idenficador de cor
42                         <literal>style(i)</literal> ou uma linha tracejada com identificador
43                         de tipo de tracejado <literal>style(i)</literal> é utilizada.
44                     </para>
45                 </listitem>
46             </varlistentry>
47             <varlistentry>
48                 <term>theta,alpha</term>
49                 <listitem>
50                     <para>valores reais fornecendo em graus as coordenadas esféricas do
51                         ponto de observação. <emphasis>Os valores padrões são 35 e 45
52                             graus.
53                         </emphasis>
54                     </para>
55                 </listitem>
56             </varlistentry>
57             <varlistentry>
58                 <term>leg</term>
59                 <listitem>
60                     <para>string definindo rótulos para cada eixo com @ como separador
61                         de campo, por exemplo " X@Y@Z" .
62                     </para>
63                 </listitem>
64             </varlistentry>
65             <varlistentry>
66                 <term>flag=[type,box]</term>
67                 <listitem>
68                     <para>
69                         <literal>type</literal> e <literal>box</literal> possuem o
70                         mesmo significado que em <literal>plot3d</literal>:
71                     </para>
72                     <variablelist>
73                         <varlistentry>
74                             <term>type</term>
75                             <listitem>
76                                 <para>um inteiro (tipo de escala).</para>
77                                 <variablelist>
78                                     <varlistentry>
79                                         <term>type=0</term>
80                                         <listitem>
81                                             <para>o esboço é feito utilizando-se a escala 3d
82                                                 corrente (definida por uma chamada anterior a
83                                                 <literal>param3d</literal>, <literal>plot3d</literal>,
84                                                 <literal>contour</literal> ou
85                                                 <literal>plot3d1</literal>).
86                                             </para>
87                                         </listitem>
88                                     </varlistentry>
89                                     <varlistentry>
90                                         <term>type=1</term>
91                                         <listitem>
92                                             <para>re-escala automaticamente caixas 3d com relação de
93                                                 aspecto extrema, as fronteiras são especificadas pelo
94                                                 valor do argumento opcional
95                                                 <literal>ebox</literal>.
96                                             </para>
97                                         </listitem>
98                                     </varlistentry>
99                                     <varlistentry>
100                                         <term>type=2</term>
101                                         <listitem>
102                                             <para> re-escala automaticamente caixas 3d com relação
103                                                 de aspecto extrema, as fronteiras são computadas
104                                                 utilizando-se dados fornecidos. <emphasis>Este é o valor
105                                                     padrão
106                                                 </emphasis>
107                                             </para>
108                                         </listitem>
109                                     </varlistentry>
110                                     <varlistentry>
111                                         <term>type=3</term>
112                                         <listitem>
113                                             <para> fronteiras 3d isométricas com fronteiras da caixa
114                                                 dadas por <literal>ebox</literal>, de modo semelhante a
115                                                 <literal>type=1</literal>.
116                                             </para>
117                                         </listitem>
118                                     </varlistentry>
119                                     <varlistentry>
120                                         <term>type=4</term>
121                                         <listitem>
122                                             <para> fronteiras 3d isométricas derivadas dos dados, de
123                                                 modo semelhante a<literal> type=2</literal>.
124                                             </para>
125                                         </listitem>
126                                     </varlistentry>
127                                     <varlistentry>
128                                         <term>type=5</term>
129                                         <listitem>
130                                             <para> fronteiras 3d isométricas expandidas com
131                                                 fronteiras fornecidas por <literal>ebox</literal>, de
132                                                 modo semelhante a <literal>type=1</literal>.
133                                             </para>
134                                         </listitem>
135                                     </varlistentry>
136                                     <varlistentry>
137                                         <term>type=6</term>
138                                         <listitem>
139                                             <para>fronteiras 3d isométricas expandidas derivadas dos
140                                                 dados, de modo semelhante a <literal>type=2</literal>.
141                                                 Note que as fronteiras dos eixos podem ser customizadas
142                                                 através das propriedades da entidade de eixos (ver <link linkend="axes_properties">axes_properties</link>).
143                                             </para>
144                                         </listitem>
145                                     </varlistentry>
146                                 </variablelist>
147                             </listitem>
148                         </varlistentry>
149                         <varlistentry>
150                             <term>box</term>
151                             <listitem>
152                                 <para>um inteiro (moldura ao redor do esboço).</para>
153                                 <variablelist>
154                                     <varlistentry>
155                                         <term>box=0</term>
156                                         <listitem>
157                                             <para>nada é desenhado ao redor do esboço.</para>
158                                         </listitem>
159                                     </varlistentry>
160                                     <varlistentry>
161                                         <term>box=1</term>
162                                         <listitem>
163                                             <para>não implementado (é como box=0). </para>
164                                         </listitem>
165                                     </varlistentry>
166                                     <varlistentry>
167                                         <term>box=2</term>
168                                         <listitem>
169                                             <para> apenas os eixos atrás da superfície são
170                                                 desenhados.
171                                             </para>
172                                         </listitem>
173                                     </varlistentry>
174                                     <varlistentry>
175                                         <term>box=3</term>
176                                         <listitem>
177                                             <para>uma caixa cercando a superfície é desenhada e
178                                                 legendas são adicionadas.
179                                             </para>
180                                         </listitem>
181                                     </varlistentry>
182                                     <varlistentry>
183                                         <term>box=4</term>
184                                         <listitem>
185                                             <para>uma caixa cercando a superfície é desenhada e
186                                                 legendas e eixos são adicionados. Note que o aspecto dos
187                                                 eixos também pode ser customizado através das
188                                                 propriedades da entidade Axes (ver <link linkend="axes_properties">axes_properties</link>).
189                                                 <emphasis>Este é o valor padrão.</emphasis>
190                                             </para>
191                                         </listitem>
192                                     </varlistentry>
193                                 </variablelist>
194                             </listitem>
195                         </varlistentry>
196                     </variablelist>
197                 </listitem>
198             </varlistentry>
199             <varlistentry>
200                 <term>ebox</term>
201                 <listitem>
202                     <para>especifica as fronteiras do esboço através do vetor
203                         <literal>[xmin,xmax,ymin,ymax,zmin,zmax]</literal>. Este argumento é
204                         utilizado junto com <literal>type</literal> em
205                         <literal>flag</literal> se este estiver ajustado para
206                         <literal>1</literal>, <literal>3</literal> ou <literal>5</literal>
207                         (volte acima para ver o comportamento correspondente). Se
208                         <literal>flag</literal> estiver faltando, <literal>ebox</literal>
209                         não é levado em conta. Note que, quando especificado, o argumento
210                         <literal>ebox</literal> age no campo <literal>data_bounds</literal>
211                         fque também pode ser ajustado através das propriedades da entidade
212                         de eixos (ver <link linkend="axes_properties">axes_properties</link>). O valor padrão de
213                         <literal>ebox</literal> é <literal>[0,1,0,1,0,1]</literal>.
214                     </para>
215                 </listitem>
216             </varlistentry>
217         </variablelist>
218     </refsection>
219     <refsection>
220         <title>Descrição</title>
221         <para>
222             <literal>param3d1</literal> usado para esboçar curvas 3d definidas
223             por suas coordenadas <literal>x</literal>, <literal>y</literal> e
224             <literal>z</literal>. Note que os dados também podem ser ajustados ou
225             recebidos através das propriedades da entidade Surface (ver <link linkend="surface_properties">surface_properties</link>).
226         </para>
227         <para>
228             Note que propriedades como <literal>rotation angles</literal>,
229             <literal>colors</literal> e <literal>thickness</literal> das curvas
230             esboçadas também podem ser ajustadas através das propriedades de param3d
231             (ver <link linkend="param3d_properties">param3d_properties</link>).
232         </para>
233         <para>
234             Entre com o comando <literal>param3d1()</literal> para visualizar
235             uma demonstração.
236         </para>
237     </refsection>
238     <refsection>
239         <title>Exemplos</title>
240         <programlisting role="example"><![CDATA[ 
241 scf(20); // criando janela de número 20
242 t=[0:0.1:5*%pi]';
243 param3d1([sin(t),sin(2*t)],[cos(t),cos(2*t)],..
244          list([t/10,sin(t)],[3,2]),35,45,"X@Y@Z",[2,3])
245
246 xdel(20);
247 a=gca();//obtendo manipulador dos novos eixos criados
248 t=[0:0.1:5*%pi]';
249 param3d1([sin(t),sin(2*t)],[cos(t),cos(2*t)],[t/10,sin(t)])
250 a.rotation_angles=[65,75];
251 a.data_bounds=[-1,-1,-1;1,1,2]; //limites fornecidos por data_bounds
252 a.thickness = 2;
253 h=a.children //obtendo o manipulador para a entidade Param3d: um Compound composto de duas curvas
254 h.children(1).foreground = 3 // primeira curva
255 curve2 = h.children(2);
256 curve2.foreground = 6;
257 curve2.mark_style = 2;
258  ]]></programlisting>
259         <scilab:image>
260             a=gca();
261             t=[0:0.1:5*%pi]';
262             param3d1([sin(t),sin(2*t)],[cos(t),cos(2*t)],[t/10,sin(t)]);
263             a.rotation_angles=[65,75];
264             a.data_bounds=[-1,-1,-1;1,1,2];
265             a.thickness = 2;
266             h=a.children;
267             h.children(1).foreground = 3;
268             curve2 = h.children(2);
269             curve2.foreground = 6;
270             curve2.mark_style = 2;
271         </scilab:image>
272     </refsection>
273     <refsection>
274         <title>Ver Também</title>
275         <simplelist type="inline">
276             <member>
277                 <link linkend="param3d">param3d</link>
278             </member>
279             <member>
280                 <link linkend="plot3d">plot3d</link>
281             </member>
282             <member>
283                 <link linkend="plot2d">plot2d</link>
284             </member>
285             <member>
286                 <link linkend="gca">gca</link>
287             </member>
288             <member>
289                 <link linkend="xdel">xdel</link>
290             </member>
291             <member>
292                 <link linkend="delete">delete</link>
293             </member>
294         </simplelist>
295     </refsection>
296 </refentry>