createMask

ROI からのバイナリ マスク イメージの作成

構文

bw = createMask(ROI)

bw = createMask(ROI,m,n)

bw = createMask(ROI,I)

bw = createMask(ROI,hImage)

説明

bw = createMask(ROI) は true に設定された ROI 内部のピクセルと false に設定された ROI 外部のピクセルから成るバイナリ マスク イメージを返します。

bw = createMask(ROI,m,n) はサイズが [m,n] のバイナリ マスク イメージを返します。

bw = createMask(ROI,I) はイメージ I のサイズのバイナリ マスク イメージを返します。

bw = createMask(ROI,hImage) は Image オブジェクト hImage のサイズのバイナリ マスク イメージを返します。

例

楕円 ROI からのマスクの作成

イメージをワークスペースに読み取って表示します。

I = imread('pears.png');
imshow(I)

Center パラメーターを使用して楕円の位置を指定し、SemiAxes パラメーターを使用して楕円の形状を指定して、イメージ上に楕円 ROI を描画します。また、この例では楕円のエッジがストライプ状のラインになるように指定しています。

h = drawellipse('Center',[447 204],'SemiAxes',[78 72], ...
    'RotationAngle',287,'StripeColor','m');

ROI からバイナリ マスクを取得します。ROI 内部のピクセルは true で、ROI の外部のピクセルは false です。マスクを表示します。

mask = createMask(h);
imshow(mask)

入力引数

ROI — 関心領域

ROI オブジェクト

関心領域。次のいずれかのタイプの ROI オブジェクトを指定します。

AssistedFreehand	Freehand	Polyline
Circle	Line	Rectangle
Ellipse	Polygon

m — マスク イメージの行の次元

正の整数

マスク イメージの行の次元。正の整数を指定します。

n — マスク イメージの列の次元

正の整数

マスク イメージの列の次元。正の整数を指定します。

I — 入力イメージの配列

数値配列

入力イメージの配列。数値配列として指定します。

hImage — 入力イメージ オブジェクト

Image オブジェクト

入力イメージ オブジェクト。Image オブジェクトとして指定します。詳細については、Image のプロパティを参照してください。

出力引数

bw — バイナリ マスク イメージ

logical 配列

バイナリ マスク イメージ。logical 配列として返されます。

データ型: logical

ヒント

• ROI 境界上のピクセルの分類の詳細については、ROI によって部分的に囲まれたピクセルの分類を参照してください。

• ROI オブジェクトに関連付けられたイメージのサイズと一致しないマスク サイズを指定した場合、createMask は指定されたサイズになるようにマスクをトリミングまたはゼロ パディングします。ROI オブジェクトに関連付けられたイメージは ROI.Parent.Children(2,1).CData です。

バージョン履歴

R2018b で導入

参考

drawassisted | drawcircle | drawellipse | drawfreehand | drawline | drawpolygon | drawpolyline | drawrectangle | inROI | circles2mask

トピック

• ROI 関数を使用したバイナリ マスクの作成
• ROI の形状の作成