# plot3d2

矩形の小平面により定義された曲面をプロット

## 呼び出し手順

    plot3d2(X,Y,Z [,vect,theta,alpha,leg,flag,ebox])
                plot3d2(X,Y,Z, <opt_args>)

## パラメータ

X, Y, Z:

  データ構造を定義する実数行列.

vect

  実数ベクトル.

<opt_args>

  一連の命令`key1=value1, key2=value2` ,...を表し, `key1`, `key2,...` は以下のどれかとすることができます: theta, alpha ,leg,flag,ebox (以下の定義を参照).

theta, alpha

  観測点の球座標を指定する実数値(単位:度).

leg

  各軸のラベルを定義する文字列. @ をフィールドセパレータとし, "X@Y@Z"のようになります.

flag

  大きさ3の実数ベクトル. `flag=[mode,type,box]`.

  mode

    整数 (曲面の色).

    mode>0

      曲面は色`"mode"`で塗られます ; 小平面の境界はカレントの線種と色で描画されます.

    mode=0:

      曲面のメッシュが描画されます.

    mode<0:

      曲面は色`"-mode"`で塗られます ; 小平面の境界は描画されません.

      曲面の色の取り扱いは, surfaceエンティティプロパティによる `color_mode`および `color_flag`オプションを用いて 行われることに注意してください (surface_properties参照).

  type

    整数 (スケール).

    type=0:

      プロットは (前の`param3d`, `plot3d`, `contour` または `plot3d1`のコールで設定された) カレントの3次元スケールで行われます.

    type=1:

      3次元ボックスのスケールがアスペクト比の最大値に基づき 自動的に調整され, 境界はオプションの引数`ebox`の値で 指定されます.

    type=2:

      3次元ボックスのスケールがアスペクト比の最大値に基づき 自動的に調整され,境界は指令したデータにより計算されます.

    type=3:

      オプション`ebox`で指定したボックス境界を有する 3次元等軸プロットで,`type=1`に似ています.

    type=4:

      データで定義された境界に基づく3次元等軸プロットで, `type=2`に似ています.

    type=5:

      オプション`ebox`で指定されたボックス境界で 定義された境界に基づく3次元拡張等軸プロットで, `type=1`に似ています.

    type=6:

      データで定義された境界に基づく3次元拡張等軸プロットで, `type=2`に似ています. 軸の境界は axes エンティティプロパティによりカスタマイズできる ことに注意してください(axes_properties参照).

  box

    整数 (プロットの周囲のフレーム).

    box=0:

      プロットの周囲に何も描画されません.

    box=1:

      実装されていません (box=0と同様).

    box=2:

      曲面の背後の軸のみが描画されます.

    box=3:

      曲面を囲うボックスが描画され,キャプションが追加されます.

    box=4:

      曲面を囲うボックスが描画され,キャプションと軸が追加されます.

      軸のアスペクトもaxesエンティティのプロパティによりカスタマイズ できることに注意してください (axes_properties参照).

ebox

  プロットの境界をベクトル `[xmin,xmax,ymin,ymax,zmin,zmax]`で指定します. この引数は,`flag`の`type`が`1`, `3` または `5`に設定された場合, 使用されます (対応する動作については上記参照). `flag` が指定されない場合 `ebox` は無視されます.

  指定された場合, `ebox`引数は, `data_bounds`に基づいて動作し, axesエンティティのプロパティによりリセットすることも可能であることに 注意してください. ebox のデフォルト値は[0,1,0,1,0,1]です.(axes_properties参照)

## 説明

`plot3d2` は矩形の小平面で定義された曲面をプロットします. (X,Y,Z) は曲面を記述する3つの行列です. 曲面は4角形のポリゴンから構成されます.

小平面のX座標は X(i,j), X(i+1,j), X(i+1,j+1) および X(i,j+1)で指定されます. 同様に Y および Z 行列は Y および Z座標を有します.

`vect` ベクトルは,同じ(X,Y,Z)行列に複数の曲面が コード化される場合に使用されます. `vect(j)` はj番目の曲面が開始されるコードの場所の 行番号です. `plot3d`と同じプロパティが編集可能です ( surface_properties および axes_propertiesを参照ください).

## 例

    u = linspace(-%pi/2,%pi/2,40);
    v = linspace(0,2*%pi,20);
    X = cos(u)'*cos(v);
    Y = cos(u)'*sin(v);
    Z = sin(u)'*ones(v);
    plot3d2(X,Y,Z);
    e=gce();
    e.color_mode=4; // 色を変更
    f=e.data;
    TL = tlist(["3d" "x" "y" "z" "color"],f_data.x,f_data.y,f_data.z,10*(f_data.z)+1);
    e.data=TL;
    e.color_flag=2;

## 参照

- plot3d
- genfac3d