scilab/modules/graphics/help/ja_JP/3d_plot/plot3d.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  * 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:ns4="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="plot3d" xml:lang="ja">
  14   <refnamediv>
  15     <refname>plot3d</refname>
  16     <refpurpose>曲面の3次元プロット</refpurpose>
  17   </refnamediv>
  18   <refsynopsisdiv>
  19     <title>呼び出し手順</title>
  20     <synopsis>plot3d(x,y,z,[theta,alpha,leg,flag,ebox])
  21       plot3d(x,y,z,&lt;opt_args&gt;)
  22
  23       plot3d(xf,yf,zf,[theta,alpha,leg,flag,ebox])
  24       plot3d(xf,yf,zf,&lt;opt_args&gt;)
  25
  26       plot3d(xf,yf,list(zf,colors),[theta,alpha,leg,flag,ebox])
  27       plot3d(xf,yf,list(zf,colors),&lt;opt_args&gt;)
  28     </synopsis>
  29   </refsynopsisdiv>
  30   <refsection>
  31     <title>パラメータ</title>
  32     <variablelist>
  33       <varlistentry>
  34         <term>x,y</term>
  35         <listitem>
  36           <para>大きさ n1 および n2の行ベクトル (x軸およびy軸座標).
  37             これらの座標は単調である必要があります.
  38           </para>
  39         </listitem>
  40       </varlistentry>
  41       <varlistentry>
  42         <term>z</term>
  43         <listitem>
  44           <para>
  45             大きさ (n1,n2)の行列. <literal>z(i,j)</literal> は点(x(i),y(j))における
  46             曲面の値です.
  47           </para>
  48         </listitem>
  49       </varlistentry>
  50       <varlistentry>
  51         <term>xf,yf,zf</term>
  52         <listitem>
  53           <para>大きさ (nf,n)の行列. 曲面を描画する際に使用される小平面を定義します.
  54             <literal>n</literal>個の小平面があります. 各小平面
  55             <literal>i</literal> は<literal>nf</literal>個の点を有するポリゴンで定義されます.
  56             i番目の小平面の点のx軸,y軸,z軸座標はそれぞれ<literal>xf(:,i)</literal>,
  57             <literal>yf(:,i)</literal> および  <literal>zf(:,i)</literal>により指定されます.
  58           </para>
  59         </listitem>
  60       </varlistentry>
  61       <varlistentry>
  62         <term>colors</term>
  63         <listitem>
  64           <para>大きさnのベクトルで,各小平面の色を指定します,もしくは,
  65             大きさ(nf,n)の行列で各小平面の境界近傍の色を指定します
  66             (小平面の色は補間されます).
  67           </para>
  68         </listitem>
  69       </varlistentry>
  70       <varlistentry>
  71         <term>&lt;opt_args&gt;</term>
  72         <listitem>
  73           <para>
  74             一連の命令<literal>key1=value1,
  75               key2=value2
  76             </literal>
  77             ,...を表し, <literal>key1</literal>,
  78             <literal>key2,...</literal> は以下のどれかとすることができます: theta,
  79             alpha ,leg,flag,ebox (以下の定義を参照).
  80           </para>
  81         </listitem>
  82       </varlistentry>
  83       <varlistentry>
  84         <term>theta, alpha</term>
  85         <listitem>
  86           <para>観測点の球座標を指定する実数値(単位:度).</para>
  87         </listitem>
  88       </varlistentry>
  89       <varlistentry>
  90         <term>leg</term>
  91         <listitem>
  92           <para>各軸のラベルを定義する文字列. @ をフィールドセパレータとし,
  93             "X@Y@Z"のようになります.
  94           </para>
  95         </listitem>
  96       </varlistentry>
  97       <varlistentry>
  98         <term>flag</term>
  99         <listitem>
 100           <para>大きさ3の実数ベクトル.
 101             <literal>flag=[mode,type,box]</literal>.
 102           </para>
 103           <variablelist>
 104             <varlistentry>
 105               <term>mode</term>
 106               <listitem>
 107                 <para>整数 (曲面の色).</para>
 108                 <variablelist>
 109                   <varlistentry>
 110                     <term>mode&gt;0</term>
 111                     <listitem>
 112                       <para>
 113                         曲面は色<literal>"mode"</literal>で塗られます ;
 114                         小平面の境界はカレントの線種と色で描画されます.
 115                       </para>
 116                     </listitem>
 117                   </varlistentry>
 118                   <varlistentry>
 119                     <term>mode=0:</term>
 120                     <listitem>
 121                       <para>曲面のメッシュが描画されます.</para>
 122                     </listitem>
 123                   </varlistentry>
 124                   <varlistentry>
 125                     <term>mode&lt;0:</term>
 126                     <listitem>
 127                       <para>
 128                         曲面は色<literal>"-mode"</literal>で塗られます ;
 129                         小平面の境界は描画されません.
 130                       </para>
 131                       <para>曲面の色の取り扱いは,
 132                         surfaceエンティティプロパティによる
 133                         <literal>color_mode</literal>および
 134                         <literal>color_flag</literal>オプションを用いて
 135                         行われることに注意してください (<link linkend="surface_properties">surface_properties</link>参照).
 136                       </para>
 137                     </listitem>
 138                   </varlistentry>
 139                 </variablelist>
 140               </listitem>
 141             </varlistentry>
 142             <varlistentry>
 143               <term>type</term>
 144               <listitem>
 145                 <para>整数 (スケール).</para>
 146                 <variablelist>
 147                   <varlistentry>
 148                     <term>type=0:</term>
 149                     <listitem>
 150                       <para>プロットは
 151                         (前の<literal>param3d</literal>,
 152                         <literal>plot3d</literal>, <literal>contour</literal> または
 153                         <literal>plot3d1</literal>のコールで設定された)
 154                         カレントの3次元スケールで行われます.
 155                       </para>
 156                     </listitem>
 157                   </varlistentry>
 158                   <varlistentry>
 159                     <term>type=1:</term>
 160                     <listitem>
 161                       <para>
 162                         3次元ボックスのスケールがアスペクト比の最大値に基づき
 163                         自動的に調整され,
 164                         境界はオプションの引数<literal>ebox</literal>の値で
 165                         指定されます.
 166                       </para>
 167                     </listitem>
 168                   </varlistentry>
 169                   <varlistentry>
 170                     <term>type=2:</term>
 171                     <listitem>
 172                       <para>
 173                         3次元ボックスのスケールがアスペクト比の最大値に基づき
 174                         自動的に調整され,
 175                         境界は指令したデータにより計算されます.
 176                       </para>
 177                     </listitem>
 178                   </varlistentry>
 179                   <varlistentry>
 180                     <term>type=3:</term>
 181                     <listitem>
 182                       <para>
 183                         オプション<literal>ebox</literal>で指定したボックス境界を有する
 184                         3次元等軸プロットで,<literal>type=1</literal>に似ています.
 185                       </para>
 186                     </listitem>
 187                   </varlistentry>
 188                   <varlistentry>
 189                     <term>type=4:</term>
 190                     <listitem>
 191                       <para>データで定義された境界に基づく3次元等軸プロットで,
 192                         <literal>type=2</literal>に似ています.
 193                       </para>
 194                     </listitem>
 195                   </varlistentry>
 196                   <varlistentry>
 197                     <term>type=5:</term>
 198                     <listitem>
 199                       <para>
 200                         オプション<literal>ebox</literal>で指定されたボックス境界で
 201                         定義された境界に基づく3次元拡張等軸プロットで,
 202                         <literal>type=1</literal>に似ています.
 203                       </para>
 204                     </listitem>
 205                   </varlistentry>
 206                   <varlistentry>
 207                     <term>type=6:</term>
 208                     <listitem>
 209                       <para>
 210                         データで定義された境界に基づく3次元拡張等軸プロットで,
 211                         <literal>type=2</literal>に似ています.
 212                         軸の境界は axes エンティティプロパティによりカスタマイズできる
 213                         ことに注意してください(<link linkend="axes_properties">axes_properties</link>参照).
 214                       </para>
 215                     </listitem>
 216                   </varlistentry>
 217                 </variablelist>
 218               </listitem>
 219             </varlistentry>
 220             <varlistentry>
 221               <term>box</term>
 222               <listitem>
 223                 <para>整数 (プロットの周囲のフレーム).</para>
 224                 <variablelist>
 225                   <varlistentry>
 226                     <term>box=0:</term>
 227                     <listitem>
 228                       <para>プロットの周囲に何も描画されません.</para>
 229                     </listitem>
 230                   </varlistentry>
 231                   <varlistentry>
 232                     <term>box=1:</term>
 233                     <listitem>
 234                       <para>実装されていません (box=0と同様).</para>
 235                     </listitem>
 236                   </varlistentry>
 237                   <varlistentry>
 238                     <term>box=2:</term>
 239                     <listitem>
 240                       <para>曲面の背後の軸のみが描画されます.</para>
 241                     </listitem>
 242                   </varlistentry>
 243                   <varlistentry>
 244                     <term>box=3:</term>
 245                     <listitem>
 246                       <para>曲面を囲うボックスが描画され,キャプションが追加されます.</para>
 247                     </listitem>
 248                   </varlistentry>
 249                   <varlistentry>
 250                     <term>box=4:</term>
 251                     <listitem>
 252                       <para>
 253                         曲面を囲うボックスが描画され,キャプションと軸が追加されます.
 254                       </para>
 255                       <para>
 256                         軸のアスペクトもaxesエンティティのプロパティによりカスタマイズ
 257                         できることに注意してください (<link linkend="axes_properties">axes_properties</link>参照).
 258                       </para>
 259                     </listitem>
 260                   </varlistentry>
 261                 </variablelist>
 262               </listitem>
 263             </varlistentry>
 264           </variablelist>
 265         </listitem>
 266       </varlistentry>
 267       <varlistentry>
 268         <term>ebox</term>
 269         <listitem>
 270           <para>
 271             プロットの境界をベクトル
 272             <literal>[xmin,xmax,ymin,ymax,zmin,zmax]</literal>で指定します.
 273             この引数は,<literal>flag</literal>の<literal>type</literal>が<literal>1</literal>,
 274             <literal>3</literal> または <literal>5</literal>に設定された場合,
 275             使用されます (対応する動作については上記参照).
 276             <literal>flag</literal> が指定されない場合
 277             <literal>ebox</literal> は無視されます.
 278           </para>
 279           <para>
 280             指定された場合, <literal>ebox</literal>引数は,
 281             <literal>data_bounds</literal>に基づいて動作し,
 282             axesエンティティのプロパティによりリセットすることも可能であることに
 283             注意してください. ebox のデフォルト値は[0,1,0,1,0,1]です.(<link linkend="axes_properties">axes_properties</link>参照)
 284           </para>
 285         </listitem>
 286       </varlistentry>
 287     </variablelist>
 288   </refsection>
 289   <refsection>
 290     <title>説明</title>
 291     <para>
 292       <literal>plot3d(x,y,z,[theta,alpha,leg,flag,ebox])</literal> は
 293       パラメータ表現の曲面 <literal>z=f(x,y)</literal>を描画します.
 294     </para>
 295     <para>
 296       <literal>plot3d(xf,yf,zf,[theta,alpha,leg ,flag,ebox])</literal>
 297       は小平面の集合で定義された曲面を描画します.
 298       <literal>xf</literal>, <literal>yf</literal> および
 299       <literal>zf</literal>を
 300       <literal>[xf1 xf2 ...]</literal>, <literal>[yf1 yf2 ...]</literal> および
 301       <literal>[zf1 zf2 ...]</literal>のように行単位で集約した
 302       複数の行列で置き換えることにより
 303       複数のプロットを描画することができます.
 304       データはsurfaceエンティティパラメータにより設定または取得できること
 305       に注意してください (<link linkend="surface_properties">surface_properties</link>参照).
 306     </para>
 307     <para/>
 308     <para>
 309       小平面の色を<literal>zf</literal>ではなく<literal>list(zf,colors)</literal>
 310       により指定することができます.
 311       ただし,<literal>colors</literal> は大きさ<literal>n</literal>の
 312       ベクトルです.
 313       <literal>colors(i)</literal> が正の場合,この値が小平面<literal>i</literal>の
 314       色を指定し,小平面の境界はカレントの線種と色で描画されます.
 315       <literal>colors(i)</literal> が負の場合, 色ID
 316       <literal>-colors(i)</literal>が使用され,小平面の境界は描画されません.
 317     </para>
 318     <para/>
 319     <para>小平面に補間された色を適用することも可能です.
 320       この場合, color 引数は nf x n の行列とする必要があり,その要素は
 321       各小平面の極回近傍の色を指定します.
 322       この場合, 正の値の色は境界が描画されないことを意味します.
 323       色は( <literal>tlist</literal> affectationsにより)
 324       surface エンティティプロパティでも設定可能であり,
 325       <literal>color_flag</literal>オプションにより編集可能です
 326       ( <link linkend="surface_properties">surface_properties</link>参照).
 327     </para>
 328     <para/>
 329     <para>
 330       オプションの引数 <literal>theta, alpha, leg ,flag,
 331         ebox
 332       </literal>
 333       ,を一連の命令
 334       <literal>key1=value1, key2=value2</literal>, ...により指定することができます.
 335       この場合,順番は任意です.
 336       これらの<literal>flag</literal>以外のオプションの引数は
 337       axesエンティティプロパティによりカスタマイズできます
 338       (see <link linkend="axes_properties">axes_properties</link>参照).
 339       前述の通り, <literal>flag</literal> オプションは
 340       <literal>mode</literal>についてはsurfaceエンティティプロパティ( <link linkend="surface_properties">surface_properties</link>参照) ,
 341       <literal>type</literal> および<literal>box</literal>については
 342       axes プロパティ (<link linkend="axes_properties">axes_properties</link>参照)
 343       で扱うことができます.
 344     </para>
 345     <para/>
 346     <para>
 347       曲面<literal>z=f(x,y)</literal>から4角形の小平面を計算する際に
 348       関数<literal>genfac3d</literal>を使用することができます.
 349       <literal>eval3dp</literal> も使用できます.
 350     </para>
 351     <para/>
 352     <para>
 353       コマンド <literal>plot3d()</literal> を入力するとデモを参照できます.
 354     </para>
 355   </refsection>
 356   <refsection>
 357     <title>例</title>
 358     <programlisting role="example"><![CDATA[
 359 //  z=f(x,y) による簡単な例
 360 t=[0:0.3:2*%pi]';
 361 z=sin(t)*cos(t');
 362 plot3d(t,t,z)
 363 // genfac3dにより計算された小平面を用いて同じ図をプロット
 364 [xx,yy,zz]=genfac3d(t,t,z);
 365 clf()
 366 plot3d(xx,yy,zz)
 367 // 複数のプロット
 368 clf()
 369 plot3d([xx xx],[yy yy],[zz 4+zz])
 370 // カラーで複数のプロット
 371 clf()
 372 plot3d([xx xx],[yy yy],list([zz zz+4],[4*ones(1,400) 5*ones(1,400)]))
 373 // 視点とキャプションを指定してプロット
 374 clf()
 375 plot3d(1:10,1:20,10*rand(10,20),alpha=35,theta=45,flag=[2,2,3])
 376 // eval3dp で計算された小平面により球をプロット
 377 deff("[x,y,z]=sph(alp,tet)",["x=r*cos(alp).*cos(tet)+orig(1)*ones(tet)";..
 378      "y=r*cos(alp).*sin(tet)+orig(2)*ones(tet)";..
 379      "z=r*sin(alp)+orig(3)*ones(tet)"]);
 380 r=1; orig=[0 0 0];
 381 [xx,yy,zz]=eval3dp(sph,linspace(-%pi/2,%pi/2,40),linspace(0,%pi*2,20));
 382 clf();plot3d(xx,yy,zz)
 383 clf();
 384 f=gcf();
 385 f.color_map = hotcolormap(128);
 386 r=0.3;orig=[1.5 0 0];
 387 [xx1,yy1,zz1]=eval3dp(sph,linspace(-%pi/2,%pi/2,40),linspace(0,%pi*2,20));
 388 cc=(xx+zz+2)*32;cc1=(xx1-orig(1)+zz1/r+2)*32;
 389 clf();plot3d1([xx xx1],[yy yy1],list([zz,zz1],[cc cc1]),theta=70,alpha=80,flag=[5,6,3])
 390
 391 delete(gcf());
 392 t=[0:0.3:2*%pi]'; z=sin(t)*cos(t');
 393 [xx,yy,zz]=genfac3d(t,t,z);
 394 plot3d([xx xx],[yy yy],list([zz zz+4],[4*ones(1,400) 5*ones(1,400)]))
 395 e=gce();
 396 f=e.data;
 397 TL = tlist(["3d" "x" "y" "z" "color"],f.x,f.y,f.z,6*rand(f.z)); // ランダムな色の行列
 398 e.data = TL;
 399 TL2 = tlist(["3d" "x" "y" "z" "color"],f.x,f.y,f.z,4*rand(1,800)); // ランダムな色のベクトル
 400 e.data = TL2;
 401 TL3 = tlist(["3d" "x" "y" "z" "color"],f.x,f.y,f.z,[20*ones(1,400) 6*ones(1,400)]);
 402 e.data = TL3;
 403 TL4 = tlist(["3d" "x" "y" "z"],f.x,f.y,f.z); // no color
 404 e.data = TL4;
 405 e.color_flag=1 // 高度 (z座標)に比例する色インデックス
 406 e.color_flag=2; // デフォルトモードに戻る
 407 e.color_flag= 3; // 補間陰影モード (デフォルト色の青に基づく)
 408 clf()
 409 plot3d([xx xx],[yy yy],list([zz zz+4],[4*ones(1,400) 5*ones(1,400)]))
 410 h=gce(); //カレントのエンティティ(ここでは曲面)のハンドルを取得
 411 a=gca(); //カレントの軸を取得
 412 a.rotation_angles=[40,70];
 413 a.grid=[1 1 1]; //グリッドを作成
 414 a.data_bounds=[-6,0,-1;6,6,5];
 415 a.axes_visible="off"; //軸を隠す
 416 a.axes_bounds=[.2 0 1 1];
 417 h.color_flag=1; //色は zに比例
 418 h.color_mode=-2;  //color_modeを白色に設定することにより小平面の境界を削除
 419 h.color_flag=2; //指定した色に基づく色
 420 h.color_mode = -1; //color_modeを黒色に設定することにより小平面の境界を戻す
 421 f=gcf();//親のfigureのハンドルを取得
 422 f.color_map=hotcolormap(512);
 423 c=[1:400,1:400];
 424 TL.color = [c;c+1;c+2;c+3];
 425 h.data = TL;
 426 h.color_flag=3; // 補間陰影モード
 427  ]]></programlisting>
 428     <para>一連のパッチ(3角形,4角形,など)をプロットする際にplot3d関数を使用することができます.</para>
 429     <programlisting role="example"><![CDATA[
 430 // パッチを描画するe plot3d 関数:
 431 // patch(x,y,[z])
 432 // patch(x,y,[list(z,c)])
 433 // x の大きさ: パッチの点の数 x パッチの数
 434 // y および z は x と同じ大きさ
 435 // c:
 436 // - パッチの数を大きさとするベクトル: パッチの色
 437 // - 大きさがパッチの点の数 x パッチの数の行列
 438 //   : 各パッチの各点の色
 439
 440 // 例 1: 3角形パッチの集合
 441
 442 x = [0 0;
 443      0 1;
 444      1 1];
 445
 446 y = [1 1;
 447      2 2;
 448      2 1];
 449
 450 z = [1 1;
 451      1 1;
 452      1 1];
 453
 454 tcolor = [2 3]';
 455
 456 subplot(2,2,1);
 457 plot3d(x,y,list(z,tcolor));
 458 xtitle('A triangle set of patches');
 459
 460 // 例2: 3角形および4角形パッチが混在
 461
 462 xquad = [5, 0;
 463          10,0;
 464          15,5;
 465          10,5];
 466
 467 yquad = [15,0;
 468          20,10;
 469          15,15;
 470          10,5];
 471
 472 zquad = ones(4,2);
 473
 474 xtri = [ 0,10,10, 5, 0;
 475         10,20,20, 5, 0;
 476         20,20,15,10,10];
 477
 478 ytri = [ 0,10,20, 5,10;
 479         10,20,20,15,20;
 480          0, 0,15,10,20];
 481
 482 ztri = zeros(3,5);
 483
 484 subplot(2,2,3);
 485 plot3d(xquad,yquad,zquad);
 486 plot3d(xtri,ytri,ztri);
 487 xtitle('Mixing triangle and quadrangle set of patches');
 488
 489 // 例3: いくつかのうさぎ
 490
 491 rabxtri = [ 5,  5, 2.5,  7.5, 10;
 492             5, 15, 5,   10,   10;
 493            15, 15, 5,   10,   15];
 494
 495 rabytri = [10, 10, 9.5,  2.5, 0;
 496            20, 10, 12,   5,   5;
 497            10   0   7    0    0];
 498 rabztri = [0,0,0,0,0;
 499            0,0,0,0,0;
 500            0,0,0,0,0];
 501
 502 rabtricolor_byface = [2 2 2 2 2];
 503
 504 rabtricolor = [2,2,2,2,2;
 505                3,3,3,3,3;
 506                4,4,4,4,4];
 507
 508 rabxquad = [0, 1;
 509             0, 6;
 510             5,11;
 511             5, 6];
 512
 513 rabyquad = [18,23;
 514             23,28;
 515             23,28;
 516             18,23];
 517
 518 rabzquad = [1,1;
 519             1,1;
 520             1,1;
 521             1,1];
 522
 523 rabquadcolor_byface = [2 2];
 524
 525 rabquadcolor = [2,2;
 526                 3,3;
 527                 4,4;
 528                 5,5];
 529
 530 subplot(2,2,2);
 531 plot3d(rabxtri, rabytri, list(rabztri,rabtricolor));
 532 plot3d(rabxquad,rabyquad,list(rabzquad,rabquadcolor));
 533 h = gcf();
 534 h.children(1).background = 1;
 535 xtitle('A psychedelic rabbit set of patches');
 536
 537 subplot(2,2,4);
 538 plot3d(rabxtri, rabytri, list(rabztri,rabtricolor_byface));
 539 plot3d(rabxquad,rabyquad,list(rabzquad,rabquadcolor_byface));
 540 h = gcf();
 541 h.children(1).background = 1;
 542 xtitle('A standard rabbit set of patches');
 543  ]]></programlisting>
 544     <para>頂点と面により一連のパッチをプロットするために
 545       plot3d関数を使用することもできます.
 546     </para>
 547     <programlisting role="example"><![CDATA[
 548 // 頂点 / 面の例: 3次元の例
 549
 550 // 各パッチを構成するユニークな点の一覧を有する頂点のリスト
 551 // 2つのパッチに共通な点は頂点のリストで反復されません
 552
 553 vertex = [0 1 1;
 554           0 2 2;
 555           1 2 3;
 556           1 1 4];
 557
 558 // 頂点のリストはどの点がパッチを構成するかを示します.
 559 face = [1 2 3;
 560         1 3 4];
 561
 562 tcolor = [2 3]';
 563
 564 // x, y, z のリストで表された頂点/面を変換する際に使用される式
 565
 566 xvf = matrix(vertex(face,1),size(face,1),length(vertex(face,1))/size(face,1))';
 567 yvf = matrix(vertex(face,2),size(face,1),length(vertex(face,1))/size(face,1))';
 568 zvf = matrix(vertex(face,3),size(face,1),length(vertex(face,1))/size(face,1))';
 569
 570 scf();
 571 subplot(2,1,1);
 572 plot3d(xvf,yvf,list(zvf,tcolor));
 573 xtitle('A triangle set of patches - vertex / face mode - 3d');
 574
 575 // 2次元のテスト
 576 // 0 Z 値を有する3次元表現を使用した後, 2次元表現に切り替えます
 577
 578 // 頂点/面の例: 3次元の例
 579
 580 // 頂点のリストには各パッチを構成するユニークな点の一覧を有します
 581 // 2つのパッチに共通する点は頂点のリスト内で繰り返されません
 582
 583 vertex = [0 1;
 584           0 2;
 585           1 2;
 586           1 1];
 587
 588 // 頂点のリストはどの点がパッチを構成するかを示します.
 589 face = [1 2 3;
 590         1 3 4];
 591
 592 // x, y, z のリストで表された頂点/面を変換する際に使用される式
 593
 594 xvf = matrix(vertex(face,1),size(face,1),length(vertex(face,1))/size(face,1))';
 595 yvf = matrix(vertex(face,2),size(face,1),length(vertex(face,1))/size(face,1))';
 596 zvf = matrix(zeros(vertex(face,2)),size(face,1),length(vertex(face,1))/size(face,1))';
 597
 598 subplot(2,1,2);
 599 plot3d(xvf,yvf,list(zvf,tcolor));
 600 xtitle('A triangle set of patches - vertex / face mode - 2D');
 601 a = gca();
 602 a.view = '2d';
 603  ]]></programlisting>
 604     <para>マニュアルで目盛を設定する方法</para>
 605     <programlisting role="example"><![CDATA[
 606 plot3d();
 607 h = gca();
 608 h.x_ticks = tlist(['ticks','locations','labels'],[-2,-1,0,1,2],['-2','-1','0','1','2']);
 609 h.y_ticks = tlist(['ticks','locations','labels'],[-4,-3-2,-1,0,1,2,3,4],['-4','-3','-2','-1','0','1','2','3','4']);
 610 h.z_ticks = tlist(['ticks','locations','labels'],[-1,0,1],['Point 1','Point 2','Point 3']);
 611  ]]></programlisting>
 612     <para/>
 613   </refsection>
 614   <refsection role="see also">
 615     <title>参照</title>
 616     <simplelist type="inline">
 617       <member>
 618         <link linkend="eval3dp">eval3dp</link>
 619       </member>
 620       <member>
 621         <link linkend="genfac3d">genfac3d</link>
 622       </member>
 623       <member>
 624         <link linkend="geom3d">geom3d</link>
 625       </member>
 626       <member>
 627         <link linkend="param3d">param3d</link>
 628       </member>
 629       <member>
 630         <link linkend="plot3d1">plot3d1</link>
 631       </member>
 632       <member>
 633         <link linkend="clf">clf</link>
 634       </member>
 635       <member>
 636         <link linkend="gca">gca</link>
 637       </member>
 638       <member>
 639         <link linkend="gcf">gcf</link>
 640       </member>
 641       <member>
 642         <link linkend="xdel">xdel</link>
 643       </member>
 644       <member>
 645         <link linkend="delete">delete</link>
 646       </member>
 647       <member>
 648         <link linkend="axes_properties">axes_properties</link>
 649       </member>
 650     </simplelist>
 651   </refsection>
 652 </refentry>