主要内容

このページ最新ではありませ。をクリックし,英语のの最新版版を参照参照し。

drawpolygon

カスタマイズ可能な多角形 ROI の作成

説明

関数drawpolygonは,关心(ROI)ののと位置するするする多边形オブジェクトを作成ます。ROI は、マウスを使ってイメージの上に ROI を描画することで対話形式で作成することも、名前と値の引数を使用してプログラムで作成することもできます。ROI の初期状態の外観と動作を指定することもできます。

Blue Polygon ROI with 10 vertices drawn over an object in an image.

ROIを作成した後に、オブジェクト プロパティ、オブジェクト関数、およびイベント通知を使用して、その ROI の形状、位置、外観、および動作をカスタマイズできます。これらの機能の使用方法の詳細については、ヒントを参照しください。

roi= drawpolygon多边形オブジェクトを,の座标轴で対话によるによる多角形多角形のの描画描画有效にし。。

ROIを描画するには、ポインターをイメージ上に配置します。カーソルが花形に変わります。クリックして多角形の頂点を描画し、ドラッグして頂点間にラインを描画します。ROI の描画を終了するには、マウス ボタンをダブルクリックします。キーボード ショートカットやコンテキスト メニュー オプションを含む ROI の使用方法の詳細については、ヒントを参照しください。

roi= drawpolygon(ax)は、axROIをを作成作成。。。。。。。。

roi= drawpolygon(___,姓名,Value)は、1 つ以上の名前と値の引数を使用して ROI の外観や動作を変更します。

すべて折りたたむ

イメージをスペース読み取って表示し。。

imshow(imread('草莓.jpg'))

ROIをを描画します。名前値のペアペアペアペア'facealpha'roiのののを透明にし。。。。

h = drawpolygon('facealpha',0);

ROIの'颜色'プロパティを設定して、多角形の輪郭の色を変更します。

h.Color ='黄色';

イメージをスペース読み取って表示し。。

i = imread('baby.jpg');图Imshow(i)

图包含一个轴对象。The axes object contains an object of type image.

Positionパラメーターを使用して頂点の位置を指定し、イメージ上に多角形 ROI を描画します。

my_vertices = [500 500; 400 600; 400 700; 500 800; 600 800; 700 700;700 600];h = drawpolygon('位置',my_vertices);

图包含一个轴对象。轴对象包含2个类型图像的对象,images.roi.polygon。

イメージをスペースに読み取り。。

i = imread('cameraman.tif');

イメージを表示ます。

imshow(I);

イメージ上に多角形 ROI を描画します。

ROI = drawpolygon('颜色','r');

ROI 移動イベントのリスナーを設定します。移動すると、ROI は、それらのイベントの通知を送信し、指定されたコールバック関数を実行します。

addlistener(roi,'MovingROI',@allevents); addlistener(roi,',@allevents);

コールバック関数alleventsroi roiの以前位置との位置表示します。。。

function根除(SRC,EVT)evname = evt.eventname;switch(evname)案子{'MovingROI'} disp([“ ROI移动先前的位置:”mat2str(evt.previousposition)]);disp([['ROI moving current position: 'mat2str(evt.CurrentPosition)]);案子{'} disp(['ROI moved previous position: 'mat2str(evt.previousposition)]);disp([[“ ROI移动了当前的位置:'mat2str(evt.CurrentPosition)]);endend

入力引数

すべて折りたたむ

ROIの親。オブジェクトまたはuiaxesroiをででををををををを使用する方法方法App Designer を使って作成したアプリでの ROI の使用を参照しください。

名前と値の引数

例:“颜色”,'y'は,黄色の多边形オブジェクトを作成ます。

オプションの引数姓名,Valueのコンマ区切りペアを指定します。姓名は引数名,Valueは対応する値です。姓名は引用でなければなりませ。。NAME1,Value1,...,Namen,Valuenのように、複数の名前と値のペアの引数を、任意の順番で指定できます。

ROIのRGB3成分成分色名前またはの省略名として指定。。。。

rgb 3成分使用と,任意の色でき。。。。。。。。。成分成分成分成分は,,色色の赤赤,,绿绿,,,青青青青青のの成分成分成分のののするするするするするするするするするするするするするするするするするのののののののの范囲なければなり。。

stringスカラー,,なのをををををスカラースカラースカラースカラーベクトルとしてとしてとして指定指定指定できできできできますます。次のの表表表表ににににに,,,名前名前付き付きのの

色の名前 省略名 RGB 3 成分 外観
“红色” 'r' [1 0 0]

A rectangle colored pure red

'green' 'G' [0 1 0]

矩形彩色纯绿色

'蓝色的' 'b' [0 0 1]

A rectangle colored pure blue

'cyan' 'C' [0 1 1]

A rectangle colored pure cyan

'品红' 'M' [1 0 1]

A rectangle colored pure magenta

'黄色' 'y' [1 1 0]

矩形彩色纯黄色

'黑色的' 'K' [0 0 0]

矩形彩色黑色

“白色” 'w' (1 1 1)

矩形彩色白色

以下に,matlab®がさまざまなタイプのプロットで使用する既定の色の RGB 3 成分を示します。

RGB 3 成分 外観
[0 0.4470 0.7410]

矩形彩色中等蓝色

[0.8500 0.3250 0.0980]

矩形颜色的红橙色

[0.9290 0.6940 0.1250]

矩形彩色的深黄色

[0.4940 0.1840 0.5560]

矩形彩色的深紫色

[0.4660 0.6740 0.1880]

矩形彩色浅绿色

[0.3010 0.7450 0.9330]

矩形彩色浅蓝色

[0.6350 0.0780 0.1840]

A rectangle colored dark red

例:“颜色”,“r”

例:“颜色”,“绿色”

例:“颜色”,[0 0.4470 0.7410]

ROIを右クリックしたときに表示されるコンテキスト メニュー。上下文菜单オブジェクトとしてします。关数Uicontextmenuを使用コンテキストプロパティを设定するによってカスタムコンテキストメニューをできます。

roiを削除をコンテキストに表示かか。。。trueまたはfalseとして指定ます。値がtrueの場合、コンテキスト メニューを使用して ROI を対話形式で削除できます。値がfalseの場合、ROI を削除するコンテキスト メニュー オプションは無効になります。

どちらのも,コンテキスト关数关数deleteROIををを削除ます。。。。

roiを形式配置座标轴领域次表のいずれかの値で指定。。。。

説明
'auto' 描画領域は現在の座標軸の範囲です (既定の設定)。
'无限' 描画领域境界なく,座标轴の范囲をてててををを描画したりドラッグし
[X,Y,W,H] 描画領域は、(x,y) を基準として幅 w と高さ h まで広がる四角形の領域に制限されます。

roi面透明[0,1]のの数値としてします。がが1の場合、ROI 面は完全に不透明になります。値が0ROI面面はに透明になり。。。。

ROI 面でクリックをキャプチャ可能。trueまたはfalseを指定します。true(既定设定)のの,,面面クリックキャプチャし。。false(既定设定)のの,,面面をキャプチャません。

親のChildrenroiハンドルハンドル可视性。ののいずれの値として指定します。。。

説明
'on' オブジェクト ハンドルは常に参照できます (既定の設定)。
'离开' オブジェクトハンドル常に参照でき。。
'callback' オブジェクト ハンドルはコールバックまたはコールバックによって呼び出された関数内から参照できますが、コマンド ラインから呼び出された関数内からは参照できません。

ROIの対话性。次の表のいずれかの値で指定します。

説明
'all' ROIは完全対话で操作ます(既定设定)。
'none' roiは形式操作でき,ポイント表示されません。。
'translate' ROI は描画領域内で平行移動できますが、形状の変更はできません。
'reshape' ROI は形状の変更はできますが、平行移動はできません。

roiラベル文字またはまたはまたはスカラースカラー指定し。既定既定では,,,,,,'')。

テキストの背景の透明度。[0, 1] の範囲の数値として指定します。1に设定,テキスト背景は完全不にになります。0に設定すると、テキストの背景は完全に透明になります。

ラベル テキストの色。RGB 3 成分、色の名前、または色の省略名として指定します。

rgb 3成分使用と,任意の色でき。。。。。。。。。成分成分成分成分は,,色色の赤赤,,绿绿,,,青青青青青のの成分成分成分のののするするするするするするするするするするするするするするするするするのののののののの范囲なければなり。。

stringスカラー,,なのをををををスカラースカラースカラースカラーベクトルとしてとしてとして指定指定指定できできできできますます。次のの表表表表ににににに,,,名前名前付き付きのの

色の名前 省略名 RGB 3 成分 外観
“红色” 'r' [1 0 0]

A rectangle colored pure red

'green' 'G' [0 1 0]

矩形彩色纯绿色

'蓝色的' 'b' [0 0 1]

A rectangle colored pure blue

'cyan' 'C' [0 1 1]

A rectangle colored pure cyan

'品红' 'M' [1 0 1]

A rectangle colored pure magenta

'黄色' 'y' [1 1 0]

矩形彩色纯黄色

'黑色的' 'K' [0 0 0]

矩形彩色黑色

“白色” 'w' (1 1 1)

矩形彩色白色

以下に,matlabがさまざまなタイプのプロットで使用する既定の色の RGB 3 成分を示します。

RGB 3 成分 外観
[0 0.4470 0.7410]

矩形彩色中等蓝色

[0.8500 0.3250 0.0980]

矩形颜色的红橙色

[0.9290 0.6940 0.1250]

矩形彩色的深黄色

[0.4940 0.1840 0.5560]

矩形彩色的深紫色

[0.4660 0.6740 0.1880]

矩形彩色浅绿色

[0.3010 0.7450 0.9330]

矩形彩色浅蓝色

[0.6350 0.0780 0.1840]

A rectangle colored dark red

例:'LabelTextColor','r'

例:'LabelTextColor','green'

例:'LabelTextColor',[0 0.4470 0.7410]

ラベルの可视性。次のいずれかの値として指定します。

説明
'on' ROI が表示されている場合、ラベルは表示されます。
'徘徊' ROI上上上置いているのみラベルは表示され。。。
'离开' ラベルはされません。

ROI ro境界。ポイントのの数値数値指定。。既定値既定値はスクリーンスクリーンスクリーンピクセルピクセルに対する点の数数数数数ののののの倍倍倍倍です。。つまり,

マーカーサイズ単位正正数値としてとして指定。。既定値スクリーンスクリーンピクセルに対するに対するに対する点のののの数数数数数数数数数数のののののののののののののののののののののののののの倍ですですです

ROIの親。またはuiaxesroiをででををををををを使用する方法方法App Designer を使って作成したアプリでの ROI の使用を参照しください。

ROIの。n行2列列数値行列行列指定ますます。,,,,,,,,ははははははは。

ROIの選択状態。論理値trueまたはfalseを指定します。

ROIのの色RGB3成分成分,色の名前,色の省略名またはまたは'none'として指定し。'none'を指定し场合,ColorROIのののののの色色をを定义。。。

rgb 3成分使用と,任意の色でき。。。。。。。。。成分成分成分成分は,,色色の赤赤,,绿绿,,,青青青青青のの成分成分成分のののするするするするするするするするするするするするするするするするするのののののののの范囲なければなり。。

stringスカラー,,なのをををををスカラースカラースカラースカラーベクトルとしてとしてとして指定指定指定できできできできますます。次のの表表表表ににににに,,,名前名前付き付きのの

色の名前 省略名 RGB 3 成分 外観
“红色” 'r' [1 0 0]

A rectangle colored pure red

'green' 'G' [0 1 0]

矩形彩色纯绿色

'蓝色的' 'b' [0 0 1]

A rectangle colored pure blue

'cyan' 'C' [0 1 1]

A rectangle colored pure cyan

'品红' 'M' [1 0 1]

A rectangle colored pure magenta

'黄色' 'y' [1 1 0]

矩形彩色纯黄色

'黑色的' 'K' [0 0 0]

矩形彩色黑色

“白色” 'w' (1 1 1)

矩形彩色白色

以下に,matlabがさまざまなタイプのプロットで使用する既定の色の RGB 3 成分を示します。

RGB 3 成分 外観
[0 0.4470 0.7410]

矩形彩色中等蓝色

[0.8500 0.3250 0.0980]

矩形颜色的红橙色

[0.9290 0.6940 0.1250]

矩形彩色的深黄色

[0.4940 0.1840 0.5560]

矩形彩色的深紫色

[0.4660 0.6740 0.1880]

矩形彩色浅绿色

[0.3010 0.7450 0.9330]

矩形彩色浅蓝色

[0.6350 0.0780 0.1840]

A rectangle colored dark red

例:“选择彩色”,“ r”

例:“选择彩色”,“绿色”

例:'SelectedColor',[0 0.4470 0.7410]

ROI ストライプの色。RGB 3 成分、色の名前、色の省略名、または'none'として指定し。'none'を指定し场合,ROIのエッジはColorで指定たになります。そうでない场合,,のののはストライプ状状になりなります。,,ColorおよびStripeColorで指定れ色がに现れます。

rgb 3成分使用と,任意の色でき。。。。。。。。。成分成分成分成分は,,色色の赤赤,,绿绿,,,青青青青青のの成分成分成分のののするするするするするするするするするするするするするするするするするのののののののの范囲なければなり。。

stringスカラー,,なのをををををスカラースカラースカラースカラーベクトルとしてとしてとして指定指定指定できできできできますます。次のの表表表表ににににに,,,名前名前付き付きのの

色の名前 省略名 RGB 3 成分 外観
“红色” 'r' [1 0 0]

A rectangle colored pure red

'green' 'G' [0 1 0]

矩形彩色纯绿色

'蓝色的' 'b' [0 0 1]

A rectangle colored pure blue

'cyan' 'C' [0 1 1]

A rectangle colored pure cyan

'品红' 'M' [1 0 1]

A rectangle colored pure magenta

'黄色' 'y' [1 1 0]

矩形彩色纯黄色

'黑色的' 'K' [0 0 0]

矩形彩色黑色

“白色” 'w' (1 1 1)

矩形彩色白色

以下に,matlabがさまざまなタイプのプロットで使用する既定の色の RGB 3 成分を示します。

RGB 3 成分 外観
[0 0.4470 0.7410]

矩形彩色中等蓝色

[0.8500 0.3250 0.0980]

矩形颜色的红橙色

[0.9290 0.6940 0.1250]

矩形彩色的深黄色

[0.4940 0.1840 0.5560]

矩形彩色的深紫色

[0.4660 0.6740 0.1880]

矩形彩色浅绿色

[0.3010 0.7450 0.9330]

矩形彩色浅蓝色

[0.6350 0.0780 0.1840]

A rectangle colored dark red

例:“脱衣舞”,'r'

例:'StripeColor','green'

例:'StripeColor',[0 0.4470 0.7410]

roiに关连付ける。ベクトルまたはまたはスカラースカラー指定し关数关数关数findobjを使用してオブジェクトの階層内の ROI オブジェクトを見つけるには、このタグ値を使用します。

roiに关连データ任意のののデータデータ指定しますたとえば,,スカラー,,ベクトルベクトルベクトル,,,,,,,,配列配列,,,,,,,,文字配列,drawpolygonオブジェクトはデータをしません。

ROIの可视。'on''离开',またはか逻辑の1(true) か0(false) として指定します。値'on'は true と等価であり、'离开'はfalseととです。この値,,,Onoffswitchstate型の on/off の logical 値として格納されます。

説明
'on' ROIを表示します。
'离开' ROIを削除せずに非表示にします。ただし、非表示の ROI のプロパティにアクセスすることはできます。

出力引数

すべて折りたたむ

ROI。多边形オブジェクトとして返されます。

ヒント

  • roiはキーボードカットを以下対话をサポートします。。

    动作 キーボードショートカット
    描画したラインを 15 度間隔でスナップさせる。 描画中にShiftキーをたままに。。
    ROIの描画する(闭じる)。

    ダブルクリック。により,ポインターの顶点が追加され,最初最初の顶点までまでラインが描画描画ささされ

    进入キーを。により,ポインターの顶点が追加され,最初最初の顶点までまでラインが描画描画ささされ

    右クリックします。これにより、新しい頂点は追加されませんが、前の頂点から多角形が閉じます。

    最初のポインターをして,し。。。

    ROIの描画キャンセル。。 Escキーをます。关数はPositionROIオブジェクトオブジェクトをを。。。。。。。。
    ROIににに。。。

    ROIのエッジ上にポインターを配置し、ダブルクリックします。

    ROIのエッジ上にポインターを配置し、右クリックして表示されたコンテキスト メニューから[顶点の]を選択します。

    最后にた顶点削除し,を。。。 Backspaceキーを。は,前のからの现在位置位置までラインラインををを再再再描画します。。戻ることができることができることができることができるののの
    ROIをサイズ変更 (形状変更) する。

    顶点にをし,アンドドラッグします。

    ROIに顶点をしクリックアンドし。。。

    頂点を削除します。ROI は、2 つの隣接する頂点を結ぶラインを再描画します。

    ROIを移动。 ROI上上にますポインターが花形に変わりますます。クリッククリックアンドアンドドラッグドラッグドラッグドラッグ
    ROIを削除。 ROIの任意の位置にポインターを配置し、右クリックします。コンテキスト メニューから[多角形の]を選択します。関数deleteROIをを削除することも。。。。。
  • 関数drawpolygonは、多边形オブジェクトを作成ます。オブジェクトを作成した後に、これらのオブジェクト機能を使用して ROI の形状、位置、外観、および動作を変更できます。

    Capability サポート
    オブジェクト プロパティ

    ROI roi,,の形状位置,,动作するプロパティがが用意用意されれて。。。。オブジェクト

    たとえば,roiの色黄色変更するにはそのそのColorプロパティを設定します。

    roi.Color ='黄色'

    オブジェクト関数 roiオブジェクト,,ををするオブジェクトオブジェクト用意さていますます。。。,,,,,,,,のののの,waitを使用し。
    イベント通知

    ROI roi roi roiに対してクリック移动など特定イベント発生したときにに,そのそのコードコードに通知通知するするすることができことができます"リスナー"を设定。ががリスナーアプリケーションにときときイベントに固有固有のデータデータを返しRoimavedroiオブジェクトオブジェクトオブジェクトその以前のと位置を返します。イベントイベントが発生したときに実行実行ささされるコールバック

    イベントリスナーを多边形オブジェクトと共に使用例については,,多角形 ROI イベントのリスナーの設定を参照しください。

バージョン履歴

R2018Bで导入

すべて展开する

R2020A以降は推奨推奨