Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

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 次元の多角形を塗りつぶします。X、Y、および Z の 3 成分で多角形の頂点を指定します。X、Y、Z のいずれかが行列の場合、関数 fill3 は n 個の多角形を作成します。ここで、n は行列の列数です。また、関数 fill3 は、必要に応じて最後の頂点を最初の頂点に接続して多角形を閉じます。X、Y、および 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 で指定された色で多角形を塗りつぶします。色には次の値を指定できます。

  • 色の名前または省略名: 'red' (または 'r')、'green' (または 'g')、'blue' (または 'b')、'cyan' (または 'c')、'magenta' (または 'm')、'yellow' (または 'y')、'black' (または 'k')、'white' (または 'w')。

  • 各要素が色の赤、緑、青の成分の強度を指定する 1 行 3 列のベクトルとして指定される RGB 3 成分。強度値は [0, 1] の範囲でなければなりません。たとえば、[0.7 0.8 1] では薄い青が指定されます。

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)

Figure contains an axes object. The axes object contains 4 objects of type patch.

アルゴリズム

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

X、Y、Z のいずれかが行列の場合、関数 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 より前に導入

すべて展開する

R2021a での動作変更

参考

関数

プロパティ

トピック