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_data=e.data;
 295 TL = tlist(["3d" "x" "y" "z" "color"],f_data.x,f_data.y,f_data.z,10*(f_data.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>