ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

fill3

3 次元の多角形の塗りつぶし

構文

fill3(X,Y,Z,C)
fill3(X,Y,Z,ColorSpec)
fill3(X1,Y1,Z1,C1,X2,Y2,Z2,C2,...)
fill3(...,'PropertyName',PropertyValue)
fill3(ax,...)
h = fill3(...)

説明

関数 fill3 は、フラットなシェーディングの多角形と Gouraud シェーディングの多角形を作成します。

fill3(X,Y,Z,C) は、3 次元の多角形を塗りつぶします。XY、および Z の 3 成分で多角形の頂点を指定します。XYZ のいずれかが行列の場合、関数 fill3n 個の多角形を作成します。ここで、n は行列の列数です。また、関数 fill3 は、必要に応じて最後の頂点を最初の頂点に接続して多角形を閉じます。XY、および Z の値は、数値、datetime 値、duration 値、またはカテゴリカル値にすることができます。

C は色を指定します。ここで、C は現在のカラーマップへのインデックスからなるベクトルまたは行列です。C が行ベクトルの場合、length(C)size(X,2) およびsize(Y,2) に等しくなければなりません。また、C が列ベクトルの場合、length(C)size(X,1) および size(Y,1) に等しくなければなりません。

fill3(X,Y,Z,ColorSpec) は、ColorSpec で指定される色を使用して、XY、および Z で定義される 3 次元の多角形を塗りつぶします。

fill3(X1,Y1,Z1,C1,X2,Y2,Z2,C2,...) は、複数の 3 次元の塗りつぶし領域を指定します。

fill3(...,'PropertyName',PropertyValue) では、特定のパッチのプロパティに値を設定することができます。

fill3(ax,...) は、現在の座標軸 (gca) ではなく ax で指定された座標軸に多角形を作成します。オプションの ax は、前述の構文のすべての入力引数の組み合わせより前に指定できます。

h = fill3(...) は、patch オブジェクトのベクトルを返します。

すべて折りたたむ

内挿された色をもつ 4 個の三角形を作成します。

X = [0 1 1 2; 1 1 2 2; 0 0 1 1];
Y = [1 1 1 1; 1 0 1 0; 0 0 0 0];
Z = [1 1 1 1; 1 0 1 0; 0 0 0 0];
C = [0.5000 1.0000 1.0000 0.5000;
     1.0000 0.5000 0.5000 0.1667;
     0.3330 0.3330 0.5000 0.5000];

figure
fill3(X,Y,Z,C)

アルゴリズム

XY、および Z が同じサイズの行列の場合、関数 fill3 は、XY、および Z の対応する要素 (すべてが行列内の同じ位置にある要素) から頂点を形成し、各列のデータから 1 つの多角形を作成します。

XYZ のいずれかが行列の場合、関数 fill3 は、列ベクトルの引数を複写して、必要なサイズの行列を生成します。

ColorSpec を使用して色を指定すると、fill3 は、フラットなシェーディングの多角形を生成し、patch オブジェクトの FaceColor プロパティを RGB 3 成分に設定します。

C を使用して色を指定すると、関数 fill3 は、座標軸の CLim プロパティによって CLim の要素をスケーリングします。これは、現在のカラーマップにインデックスを付ける前に、色軸のスケーリング パラメーターを指定します。

C が行ベクトルの場合、関数 fill3 はフラットなシェーディングの多角形を生成し、Patch オブジェクトの FaceColor プロパティを 'flat' に設定します。各要素は、対応する patch オブジェクトの CData プロパティの値になります。

C が列ベクトルまたは行列の場合、関数 fill3 は、内挿された色をもつ多角形を生成し、Patch オブジェクトの FaceColor プロパティを 'interp' に設定します。関数 fill3 は、内挿された色をもつ多角形を生成する際には、頂点のカラーマップ インデックスの線形内挿を使用します。1 つの列の要素は、それぞれの Patch オブジェクトの CData プロパティの値になります。C が列ベクトルの場合、関数 fill3 はその列ベクトルを複写して、必要なサイズの行列を生成します。

拡張機能

R2006a より前に導入