円
円の関心領域
説明
Circle オブジェクトは、円の関心領域 (ROI) のサイズと位置を指定します。この ROI に対し、外観や対話型動作をカスタマイズできます。
キーボード ショートカットを含むこの ROI の使用方法の詳細については、ヒントを参照してください。
作成
Circle オブジェクトは次の 2 つの方法で作成できます。詳細については、ROI の形状の作成を参照してください。
関数
drawcircleを使用。ROI の作成と外観の設定を 1 つのコマンドで行う場合、この関数を使用します。ROI のサイズと位置は、マウスを使ってイメージの上に ROI を描画することで対話形式で指定することも、名前と値の引数を使用してプログラムで指定することもできます。ここで説明する関数
images.roi.Circleを使用。ROI のサイズや位置を指定する前に ROI の外観や動作を指定する場合、この関数を使用します。サイズと位置は、オブジェクトを作成した後に、関数drawを使用して対話形式で指定するか、オブジェクトのプロパティを変更してプログラムで指定することができます。
説明
入力引数
プロパティ
形状と位置
ROI の中心。[x y] 形式の 1 行 2 列の数値ベクトルとして指定します。値 x と y は ROI の中心点の座標です。ROI を描画または移動すると、このプロパティの値は自動的に変化します。
円の半径。非負の数値として指定します。円の描画またはサイズ変更を行って、このプロパティを設定することもできます。
この プロパティ は読み取り専用です。
円周上の点の位置。n 行 2 列の数値行列として返されます。n は頂点の合計数です。
色とスタイル
ROI の色。RGB 3 成分、色の名前、または色の省略名として指定します。
RGB 3 成分を使用すると、任意の色を指定できます。RGB 3 成分は、色の赤、緑、青の成分の強度を指定する 3 つの要素から成る行ベクトルです。強度は [0, 1] の範囲でなければなりません。
いくつかの一般的な色については、色の名前を string スカラーまたは文字ベクトルとして指定できます。次の表に、名前付きの色のオプション、およびそれと等価な RGB 3 成分を示します。
| 色名 | 省略名 | RGB 3 成分 | 外観 |
|---|---|---|---|
"red" | "r" | [1 0 0] |
|
"green" | "g" | [0 1 0] |
|
"blue" | "b" | [0 0 1] |
|
"cyan" | "c" | [0 1 1] |
|
"magenta" | "m" | [1 0 1] |
|
"yellow" | "y" | [1 1 0] |
|
"black" | "k" | [0 0 0] |
|
"white" | "w" | [1 1 1] |
|
次の表に、ライト テーマとダーク テーマにおけるプロットの既定のカラー パレットを示します。
| パレット | パレット カラー |
|---|---|
R2025a より前: ほとんどのプロットでは既定でこれらの色が使用されます。 |
|
|
|
orderedcolors 関数を使用して、これらのパレットの RGB 3 成分を取得できます (R2023b 以降)。たとえば、"gem" パレットの RGB 3 成分を取得します。
RGB = orderedcolors("gem");例: Color="r"
例: Color="green"
例: Color=[0 0.4470 0.7410]
ROI 面の透明度。[0, 1] の範囲の数値として指定します。値が 1 の場合、ROI 面は完全に不透明になります。値が 0 の場合、ROI 面は完全に透明になります。
ROI の境界線の幅。ポイント単位の正の数値として指定します。既定値はスクリーン ピクセルに対する点の数の 3 倍です。つまり、既定では境界線の幅は 3 ピクセルになります。
マーカー サイズ。ポイント単位の正の数値として指定します。既定値はスクリーン ピクセルに対する点の数の 8 倍です。つまり、既定ではマーカー サイズは 8 ピクセルになります。
選択したときの ROI の色。RGB 3 成分、色の名前、色の省略名、または "none" として指定します。"none" を指定した場合、Color の値はすべての状態 (選択または未選択) の ROI の色を定義します。
RGB 3 成分を使用すると、任意の色を指定できます。RGB 3 成分は、色の赤、緑、青の成分の強度を指定する 3 つの要素から成る行ベクトルです。強度は [0, 1] の範囲でなければなりません。
いくつかの一般的な色については、色の名前を string スカラーまたは文字ベクトルとして指定できます。次の表に、名前付きの色のオプション、およびそれと等価な RGB 3 成分を示します。
| 色名 | 省略名 | RGB 3 成分 | 外観 |
|---|---|---|---|
"red" | "r" | [1 0 0] |
|
"green" | "g" | [0 1 0] |
|
"blue" | "b" | [0 0 1] |
|
"cyan" | "c" | [0 1 1] |
|
"magenta" | "m" | [1 0 1] |
|
"yellow" | "y" | [1 1 0] |
|
"black" | "k" | [0 0 0] |
|
"white" | "w" | [1 1 1] |
|
次の表に、ライト テーマとダーク テーマにおけるプロットの既定のカラー パレットを示します。
| パレット | パレット カラー |
|---|---|
R2025a より前: ほとんどのプロットでは既定でこれらの色が使用されます。 |
|
|
|
orderedcolors 関数を使用して、これらのパレットの RGB 3 成分を取得できます (R2023b 以降)。たとえば、"gem" パレットの RGB 3 成分を取得します。
RGB = orderedcolors("gem");例: SelectedColor="r"
例: SelectedColor="green"
例: SelectedColor=[0 0.4470 0.7410]
ROI ストライプの色。RGB 3 成分、色の名前、色の省略名、または "none" として指定します。"none" を指定した場合、ROI のエッジは Color で指定された単色になります。そうでない場合、ROI のエッジはストライプ状になります。このとき、Color および StripeColor で指定された色が交互に現れます。
RGB 3 成分を使用すると、任意の色を指定できます。RGB 3 成分は、色の赤、緑、青の成分の強度を指定する 3 つの要素から成る行ベクトルです。強度は [0, 1] の範囲でなければなりません。
いくつかの一般的な色については、色の名前を string スカラーまたは文字ベクトルとして指定できます。次の表に、名前付きの色のオプション、およびそれと等価な RGB 3 成分を示します。
| 色名 | 省略名 | RGB 3 成分 | 外観 |
|---|---|---|---|
"red" | "r" | [1 0 0] |
|
"green" | "g" | [0 1 0] |
|
"blue" | "b" | [0 0 1] |
|
"cyan" | "c" | [0 1 1] |
|
"magenta" | "m" | [1 0 1] |
|
"yellow" | "y" | [1 1 0] |
|
"black" | "k" | [0 0 0] |
|
"white" | "w" | [1 1 1] |
|
次の表に、ライト テーマとダーク テーマにおけるプロットの既定のカラー パレットを示します。
| パレット | パレット カラー |
|---|---|
R2025a より前: ほとんどのプロットでは既定でこれらの色が使用されます。 |
|
|
|
orderedcolors 関数を使用して、これらのパレットの RGB 3 成分を取得できます (R2023b 以降)。たとえば、"gem" パレットの RGB 3 成分を取得します。
RGB = orderedcolors("gem");例: StripeColor="r"
例: StripeColor="green"
例: StripeColor=[0 0.4470 0.7410]
ROI の可視性。"on" か "off"、または。"on" の値は true と等価であり、"off" は false と等価です。この値は、OnOffSwitchState 型の on/off の logical 値として格納されます。
| 値 | 説明 |
|---|---|
"on" | ROI を表示します。 |
"off" | ROI を削除せずに非表示にします。ただし、非表示の ROI のプロパティにアクセスすることはできます。 |
ラベル
ROI ラベル。文字ベクトルまたは string スカラーとして指定します。既定では、ROI にラベルはありません ('')。
テキストの背景の透明度。[0, 1] の範囲の数値として指定します。1 に設定すると、テキストの背景は完全に不透明になります。0 に設定すると、テキストの背景は完全に透明になります。
ラベル テキストの色。RGB 3 成分、色の名前、または色の省略名として指定します。
RGB 3 成分を使用すると、任意の色を指定できます。RGB 3 成分は、色の赤、緑、青の成分の強度を指定する 3 つの要素から成る行ベクトルです。強度は [0, 1] の範囲でなければなりません。
いくつかの一般的な色については、色の名前を string スカラーまたは文字ベクトルとして指定できます。次の表に、名前付きの色のオプション、およびそれと等価な RGB 3 成分を示します。
| 色名 | 省略名 | RGB 3 成分 | 外観 |
|---|---|---|---|
"red" | "r" | [1 0 0] |
|
"green" | "g" | [0 1 0] |
|
"blue" | "b" | [0 0 1] |
|
"cyan" | "c" | [0 1 1] |
|
"magenta" | "m" | [1 0 1] |
|
"yellow" | "y" | [1 1 0] |
|
"black" | "k" | [0 0 0] |
|
"white" | "w" | [1 1 1] |
|
次の表に、ライト テーマとダーク テーマにおけるプロットの既定のカラー パレットを示します。
| パレット | パレット カラー |
|---|---|
R2025a より前: ほとんどのプロットでは既定でこれらの色が使用されます。 |
|
|
|
orderedcolors 関数を使用して、これらのパレットの RGB 3 成分を取得できます (R2023b 以降)。たとえば、"gem" パレットの RGB 3 成分を取得します。
RGB = orderedcolors("gem");例: LabelTextColor="r"
例: LabelTextColor="green"
例: LabelTextColor=[0 0.4470 0.7410]
ラベルの可視性。次のいずれかの値として指定します。
| 値 | 説明 |
|---|---|
"on" | ROI が表示されている場合、ラベルは表示されます。 |
"hover" | マウスのカーソルを ROI 上に置いている場合のみ、ラベルは表示されます。 |
"off" | ラベルは表示されません。 |
対話性
ROI を右クリックしたときに表示されるコンテキスト メニュー。ContextMenu オブジェクトとして指定します。関数 uicontextmenu を使用してコンテキスト メニュー プロパティを設定することによって、カスタム コンテキスト メニューを作成できます。
ROI を削除するオプションをコンテキスト メニューに表示するかどうか。 として指定します。値が true の場合、コンテキスト メニューを使用して ROI を対話形式で削除できます。値が false の場合、ROI を削除するコンテキスト メニュー オプションは無効になります。
どちらの場合も、コンテキスト メニューではなく関数 delete を使用して ROI を削除できます。
ROI を対話形式で配置できる座標軸の領域。次の表のいずれかの値で指定します。
| 値 | 説明 |
|---|---|
"auto" | 描画領域は現在の座標軸の範囲です (既定の設定)。 |
"unlimited" | 描画領域には境界がなく、座標軸の範囲を超えて ROI を描画したりドラッグしたりできます。 |
[x,y,w,h] | 描画領域は、(x,y) を基準として幅 w と高さ h まで広がる四角形の領域に制限されます。 |
ROI 面でクリックをキャプチャ可能。 として指定します。true の場合、ROI 面でマウス クリックをキャプチャします。false (既定の設定) の場合、ROI 面でマウス クリックをキャプチャしません。
ROI の対話性。次の表のいずれかの値で指定します。
| 値 | 説明 |
|---|---|
"all" | ROI を完全に操作できます。個々の頂点の位置を変更して ROI の形状を変更したり、ROI 全体を移動 (平行移動) したりすることができます。 |
"none" | ROI の操作やコンテキスト メニューへのアクセスを行うことはできません。ドラッグ ポイントは表示されません。 |
"translate" | 描画領域内で ROI 全体を移動できます。頂点の相対位置は固定されており、ROI の形状を変更することはできません。 |
"reshape" | 個々の頂点の位置を変更することで、ROI の形状を変更できます。ROI を移動することはできません。 |
"none" を除く InteractionsAllowed のすべての値のコンテキスト メニューにアクセスできます。
ROI の選択状態。"off" か "on"、または。"off" の値は false と等価であり、"on" は true と等価です。
このプロパティは対話形式で設定することもできます。たとえば、ROI をクリックすると、その ROI が選択され、このプロパティが true に設定されます。同様に、Ctrl キーを押したまま ROI をクリックすると、ROI は選択解除され、このプロパティの値が false に設定されます。
親/子
親の Children プロパティでの ROI ハンドルの可視性。次の表のいずれかの値として指定します。
| 値 | 説明 |
|---|---|
"on" | オブジェクト ハンドルは常に参照できます (既定の設定)。 |
"off" | オブジェクト ハンドルは常に参照できません。 |
"callback" | オブジェクト ハンドルはコールバックまたはコールバックによって呼び出された関数内から参照できますが、コマンド ラインから呼び出された関数内からは参照できません。 |
ROI の親。Axes または UIAxes オブジェクトとして指定します。重要な制限など UI 座標軸で ROI を使用する方法の詳細については、App Designer を使って作成したアプリでの ROI の使用を参照してください。
識別子
ROI に関連付けるタグ。文字ベクトルまたは string スカラーとして指定します。関数 findobj を使用してオブジェクトの階層内の ROI オブジェクトを見つけるには、このタグ値を使用します。
ROI に関連付けるデータ。任意の MATLAB データとして指定します。たとえば、スカラー、ベクトル、行列、cell 配列、string、文字配列、table、または構造体を指定できます。円 オブジェクトはこのデータを使用しません。
オブジェクト関数
addlistener | イベント ソースにバインドされたイベント リスナーの作成 |
beginDrawingFromPoint | 指定された点からの ROI の描画の開始 |
bringToFront | Axes のスタックの順番の最前面への ROI の移動 |
createMask | ROI からのバイナリ マスク イメージの作成 |
draw | 対話形式による ROI の描画の開始 |
inROI | 点が ROI 内にあるかどうかのクエリ |
wait | ROI の操作が完了するまで MATLAB コマンド ラインをブロック |
例
イメージをワークスペースに読み取って表示します。
I = imread('baby.jpg');
figure
imshow(I)
イメージ上に円 ROI を作成します。'Center' プロパティを使用して位置を指定し、'Radius' プロパティを使用してサイズを指定します。プログラムによって ROI を作成する場合、特定の座標軸に ROI を描画するには、座標軸を入力引数として指定しなければなりません。そうでない場合、images.roi.Circle クラスのインスタンスは作成されますが表示されません。この例では、現在の座標軸 (gca) を指定して、その座標軸にあるイメージに ROI を描画します。
h = images.roi.Circle(gca,'Center',[1000 1000],'Radius',500);
イメージをワークスペースに読み取ります。
I = imread('cameraman.tif');イメージを表示します。
imshow(I);
イメージ上に円 ROI を描画します。この例では、ROI のサイズと位置を指定するので、draw メソッドを呼び出して対話形式による描画を有効にする必要はありません。
roi = images.roi.Circle(gca,'Center',[100 100],'Radius',50);
ROI 移動イベントのリスナーを設定します。移動すると、ROI は、それらのイベントの通知を送信し、指定されたコールバック関数を実行します。
addlistener(roi,'MovingROI',@allevents); addlistener(roi,'ROIMoved',@allevents);
コールバック関数 allevents は Circle ROI の現在の中心と現在の半径をコマンド ラインに表示します。
function allevents(src,evt) evname = evt.EventName; switch(evname) case{'MovingROI'} disp(['ROI moving Current Center: ' mat2str(evt.CurrentCenter)]); disp(['ROI moving Current Radius: ' mat2str(evt.CurrentRadius)]); case{'ROIMoved'} disp(['ROI moved Current Center: ' mat2str(evt.CurrentCenter)]); disp(['ROI moved Current Radius: ' mat2str(evt.CurrentRadius)]); end end
詳細
ヒント
関数
drawまたはdrawcircleを使用して対話形式で ROI を描画するには、カーソルを座標軸に配置し、クリック アンド ドラッグして形状を作成します。描画を終了するには、ポインターを離します。ROI は、キーボード ショートカットを含む以下の対話性をサポートします。
動作 キーボード ショートカット ROI の描画を終了する。 マウス カーソルを離します。
ROI の描画をキャンセルする。 Esc キーを押します。関数は Positionプロパティが空の有効な ROI オブジェクトを返します。ROI をサイズ変更 (形状変更) する。 頂点にポインターを配置し、クリック アンド ドラッグします。
ROI を移動する。 カーソルを ROI 内の任意の位置に移動し、マウス ボタンを押したまま、ROI をイメージの上で移動します。 ROI を削除する。 カーソルを円上に配置し、右クリックして表示されたコンテキスト メニューから [円の削除] を選択します。関数 deleteを使用して、プログラムによって ROI を削除することもできます。App Designer を使って作成したアプリで ROI を使用する方法の詳細については、App Designer を使って作成したアプリでの ROI の使用を参照してください。
