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

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 オブジェクトのベクトルを返します。

例

塗りつぶされた 3 次元多角形の作成

内挿された色をもつ 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)

アルゴリズム

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 はその列ベクトルを複写して、必要なサイズの行列を生成します。

互換性についての考慮事項

関数 fill と関数 fill3 で作成された Patch オブジェクトの XData、YData および ZData プロパティによって元のデータ型の値が返される

R2021a での動作変更

関数 fill または関数 fill3 で作成された Patch オブジェクトの XData、YData および ZData プロパティは、座標を double 値として返すのではなく、元の入力データ型を使用して返します。

以前のリリースでは、datetime 座標、duration 座標および categorical 座標は、XData、YData および ZData プロパティに格納される際に double 値に変換されます。

たとえば、次のコードは datetime x 座標をもつ塗りつぶされた 3 次元多角形を作成します。次に、XData プロパティに格納されている値を使用して x2 を計算します。R2020b では、h.XData と x2 は double 配列です。R2021a では、h.XData と x2 は datetime 配列です。

x = datetime('01-Jan-2018') + days([0 1 1 0]);
y = [0 0 1 1];
z = [0 0 1 1];
h = fill3(x,y,z,'red');
x2 = h.XData + 1;

コード内で double 値を保持するには、Patch オブジェクトの Vertices プロパティから double 値を取得します。x 座標、y 座標および z 座標は、Vertices 配列の 1 列目、2 列目および 3 列目に double 値として格納されています。

x2 = h.Vertices(:,1) + 1;

あるいは、関数 ruler2num を使用します。座標値と対応する軸ルーラーを関数 ruler2num に渡します。

ax = gca;
x2 = ruler2num(h.XData,ax.XAxis) + 1;

拡張機能

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

使用上の注意事項および制限事項:

• この関数は GPU 配列を受け入れますが、GPU 上では実行されません。

詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

使用上の注意事項および制限事項:

• この関数は分散配列に対して演算を行いますが、クライアントの MATLAB^® で実行されます。

詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

参考

関数

• fill | axis | colormap | caxis | patch

プロパティ

• Patch のプロパティ

トピック

• 日付と期間のプロット
• categorical データのプロット

R2006a より前に導入

×

例を開く

この例の変更されたバージョンがあります。編集された方の例を開きますか?

いいえ、変更されたバージョンを上書きします。 はい