Ellipse

楕円の関心領域

このページをすべて展開する

説明

Ellipse オブジェクトは、楕円の関心領域 (ROI) の形状と位置を指定します。この ROI に対し、外観や対話型動作をカスタマイズできます。

キーボードショートカットを含むこの ROI の使用方法の詳細については、ヒントを参照してください。

Blue Ellipse ROI drawn over a round object in an image.

作成

Ellipse オブジェクトは次の 2 つの方法で作成できます。詳細については、ROI の形状の作成を参照してください。

関数 drawellipse を使用。ROI の作成と外観の設定を 1 つのコマンドで行う場合、この関数を使用します。ROI の形状と位置は、マウスを使ってイメージの上に ROI を描画することで対話形式で指定することも、名前と値の引数を使用してプログラムで指定することもできます。
ここで説明する関数 images.roi.Ellipse を使用。ROI の形状や位置を指定する前に ROI の外観や動作を指定する場合、この関数を使用します。形状と位置は、オブジェクトを作成した後に、関数 draw を使用して対話形式で指定するか、オブジェクトのプロパティを変更してプログラムで指定することができます。

構文

roi = images.roi.Ellipse

roi = images.roi.Ellipse(ax)

roi = images.roi.Ellipse(___,Name,Value)

説明

例

roi = images.roi.Ellipse は、既定のプロパティ値を使用して Ellipse オブジェクトを作成します。

roi = images.roi.Ellipse(ax) は、ax で指定される座標軸に ROI を作成します。

roi = images.roi.Ellipse(___,Name,Value) は、名前と値の引数を使用してプロパティを設定します。複数の名前と値の引数を指定できます。各プロパティ名を一重引用符で囲みます。

例: images.roi.Ellipse('Color','y') は、黄色の Ellipse オブジェクトを作成します。

入力引数

すべて展開する

`ax` — ROI の親
`gca` (既定値) | `Axes` オブジェクト | `UIAxes` オブジェクト

ROI の親。Axes オブジェクトまたは UIAxes オブジェクトとして指定します。重要な制限など UIAxes で ROI を使用する方法の詳細については、App Designer を使って作成したアプリでの ROI の使用を参照してください。

プロパティ

すべて展開する

`AspectRatio` — 楕円の縦横比
正の数値

楕円の縦横比。正の数値として指定します。このプロパティの値は、楕円の描画やサイズ変更を行ったり SemiAxes プロパティを設定したりすると自動的に変化します。Ellipse オブジェクトは、この値を height/width として計算します。既定値は (1+sqrt(5))/2 です。

`Center` — ROI の中心
`[]` (既定値) | 1 行 2 列の数値ベクトル

ROI の中心。[x y] 形式の 1 行 2 列の数値ベクトルとして指定します。値 x と y は ROI の中心点の座標です。ROI を描画または移動すると、このプロパティの値は自動的に変化します。

`Color` — ROI の色
`[0 0.4470 0.7410]` (既定値) | RGB 3 成分 | 色の名前 | 色の省略名

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]`

以下に、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]`

例: 'Color','r'

例: 'Color','green'

例: 'Color',[0 0.4470 0.7410]

`ContextMenu` — コンテキストメニュー
`ContextMenu` オブジェクト

ROI を右クリックしたときに表示されるコンテキストメニュー。ContextMenu オブジェクトとして指定します。関数 uicontextmenu を使用してコンテキストメニュープロパティを設定することによって、カスタムコンテキストメニューを作成できます。

`Deletable` — ROI を削除するオプションをコンテキストメニューに表示するかどうか
`true` (既定値) | `false`

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

どちらの場合も、コンテキストメニューではなく関数 delete を使用して ROI を削除できます。

`DrawingArea` — ROI を対話形式で配置できる座標軸の領域
`'auto'` (既定値) | `'unlimited'` | `[x,y,w,h]`

ROI を対話形式で配置できる座標軸の領域。次の表のいずれかの値で指定します。

値	説明
`'auto'`	描画領域は現在の座標軸の範囲です (既定の設定)。
`'unlimited'`	描画領域には境界がなく、座標軸の範囲を超えて ROI を描画したりドラッグしたりできます。
`[x,y,w,h]`	描画領域は、(x,y) を基準として幅 w と高さ h まで広がる四角形の領域に制限されます。

`FaceAlpha` — ROI 面の透明度
`0.2` (既定値) | 範囲 [0, 1] の数値

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

`FaceSelectable` — ROI 面でクリックをキャプチャ可能
`true` (既定値) | `false`

ROI 面でクリックをキャプチャ可能。true または false を指定します。true (既定の設定) の場合、ROI 面でマウスクリックをキャプチャします。false (既定の設定) の場合、ROI 面でマウスクリックをキャプチャしません。

`FixedAspectRatio` — 縦横比を一定に維持
`false` (既定値) | `true`

対話型の操作中に縦横比を一定に維持。true または false を指定します。値が true の場合、ROI の描画やサイズ変更を行うときに縦横比が維持されます。値が false の場合、ROI の描画やサイズ変更を行うときに縦横比を変更できます。このプロパティの状態は、既定のコンテキストメニューを使用して変更できます。

`HandleVisibility` — 親の `Children` プロパティでの ROI ハンドルの可視性
`'on'` (既定値) | `'off'` | `'callback'`

親の Children プロパティでの ROI ハンドルの可視性。次の表のいずれかの値として指定します。

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

`InteractionsAllowed` — ROI の対話性
`'all'` (既定値) | `'none'` | `'reshape'` | `'translate'`

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

値	説明
`'all'`	ROI は完全に対話形式で操作できます (既定の設定)。
`'none'`	ROI は対話形式で操作できず、ドラッグポイントが表示されません。
`'translate'`	ROI は描画領域内で平行移動できますが、形状の変更はできません。
`'reshape'`	ROI は形状の変更はできますが、平行移動はできません。

`Label` — ROI ラベル
`''` (既定値) | 文字ベクトル | string スカラー

ROI ラベル。文字ベクトルまたは string スカラーとして指定します。既定では、ROI にラベルはありません ('')。

`LabelAlpha` — テキストの背景の透明度
`1` (既定値) | 範囲 [0, 1] の数値

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

`LabelTextColor` — ラベルテキストの色
`'black'` (既定値) | RGB 3 成分 | 色の名前 | 色の省略名

ラベルテキストの色。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]`

以下に、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]`

例: 'LabelTextColor','r'

例: 'LabelTextColor','green'

例: 'LabelTextColor',[0 0.4470 0.7410]

`LabelVisible` — ラベルの可視性
`'on'` (既定値) | `'off'` | `'hover'`

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

値	説明
`'on'`	ROI が表示されている場合、ラベルは表示されます。
`'hover'`	マウスのカーソルを ROI 上に置いている場合のみ、ラベルは表示されます。
`'off'`	ラベルは表示されません。

`LineWidth` — ROI の境界線の幅
正の数値

ROI の境界線の幅。ポイント単位の正の数値として指定します。既定値はスクリーンピクセルに対する点の数の 3 倍です。つまり、既定では境界線の幅は 3 ピクセルになります。

`MarkerSize` — マーカーサイズ
正の数値

マーカーサイズ。ポイント単位の正の数値として指定します。既定値はスクリーンピクセルに対する点の数の 8 倍です。つまり、既定ではマーカーサイズは 8 ピクセルになります。

`Parent` — ROI の親
`Axes` オブジェクト | `UIAxes` オブジェクト

ROI の親。Axes または UIAxes オブジェクトとして指定します。重要な制限など UIAxes で ROI を使用する方法の詳細については、App Designer を使って作成したアプリでの ROI の使用を参照してください。

`RotationAngle` — ROI の中心周りの角度
`0` (既定値) | 非負の数値スカラー

ROI の中心周りの角度。非負の数値スカラーとして指定します。角度は時計回りの方向に度単位で測定します。ROI を描画または移動すると、このプロパティの値は自動的に変化します。

RotationAngle の値は、Position の値には影響を与えません。Position プロパティは回転前の ROI の初期位置を表します。回転した ROI の位置を決定するには、Vertices プロパティを使用します。

`Selected` — ROI の選択状態
`false` (既定値) | `true`

ROI の選択状態。論理値 true または false を指定します。このプロパティは対話形式で設定することもできます。たとえば、ROI をクリックすると、その ROI が選択され、このプロパティが true に設定されます。同様に、Ctrl キーを押したまま ROI をクリックすると、ROI は選択解除され、このプロパティの値が false に設定されます。

`SelectedColor` — 選択したときの ROI の色
`'none'` (既定値) | RGB 3 成分 | 色の名前 | 色の省略名

選択したときの ROI の色。RGB 3 成分、色の名前、色の省略名、または 'none' として指定します。'none' を指定した場合、Color の値はすべての状態 (選択または未選択) の ROI の色を定義します。

色の名前	省略名	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]`

以下に、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]`

例: 'SelectedColor','r'

例: 'SelectedColor','green'

例: 'SelectedColor',[0 0.4470 0.7410]

`SemiAxes` — 楕円の半軸の長さ
1 行 2 列の数値ベクトル

楕円の半軸の長さ。[semiaxis1 semiaxis2] 形式の 1 行 2 列の数値ベクトルとして指定します。Ellipse オブジェクトは x 方向に最も近い半軸の長さを semiaxis1 に割り当てます。ただし、楕円の形状と方向は、対話型の操作により変化する場合があることに注意してください。ROI の描画または形状変更を行うと、このプロパティの値は自動的に変化します。

`StripeColor` — ROI ストライプの色
`'none'` (既定値) | RGB 3 成分 | 色の名前 | 色の省略名

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

色の名前	省略名	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]`

以下に、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]`

例: 'StripeColor','r'

例: 'StripeColor','green'

例: 'StripeColor',[0 0.4470 0.7410]

`Tag` — ROI に関連付けるタグ
`''` (既定値) | 文字ベクトル | string スカラー

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

`UserData` — ROI に関連付けるデータ
任意の MATLAB データ

ROI に関連付けるデータ。任意の MATLAB データとして指定します。たとえば、スカラー、ベクトル、行列、cell 配列、string、文字配列、table、または構造体を指定できます。Ellipse オブジェクトはこのデータを使用しません。

`Vertices` — 円周上の点の位置
n 行 2 列の数値行列

このプロパティは読み取り専用です。

楕円周上の点の位置。n 行 2 列の数値行列として返されます。

`Visible` — ROI の可視性
`'on'` (既定値) | `'off'` | on/off の logical 値

ROI の可視性。'on' か 'off'、または数値か logical の 1 (true) か 0 (false) として指定します。値 'on' は true と等価であり、'off' は false と等価です。この値は、OnOffSwitchState 型の on/off の logical 値として格納されます。

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

オブジェクト関数

`addlistener`	イベントソースにバインドされたイベントリスナーの作成
`beginDrawingFromPoint`	指定された点からの ROI の描画の開始
`bringToFront`	Axes のスタックの順番の最前面への ROI の移動
`createMask`	ROI からのバイナリマスクイメージの作成
`draw`	対話形式による ROI の描画の開始
`inROI`	点が ROI 内にあるかどうかのクエリ
`wait`	ROI の操作が完了するまで MATLAB コマンドラインをブロック

例

すべて折りたたむ

非対話形式による楕円 ROI の作成

ライブスクリプトを開く

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

I = imread('baby.jpg');
figure
imshow(I)

Figure contains an axes object. The axes object contains an object of type image.

イメージ上に楕円 ROI を作成します。Center プロパティを使用して位置を指定し、SemiAxes プロパティを使用してその形状を指定します。プログラムによって ROI を作成する場合、特定の座標軸に ROI を描画するには、座標軸を入力引数として指定しなければなりません。そうでない場合、images.roi.Ellipse クラスのインスタンスは作成されますが表示されません。この例では、現在の座標軸 (gca) を指定して、その座標軸にあるイメージに ROI を描画します。

h = images.roi.Ellipse(gca,'Center',[1000 1000],'Semiaxes',[350 150]);

Figure contains an axes object. The axes object contains 2 objects of type image, images.roi.ellipse.

楕円 ROI イベントのリスナーの設定

ライブスクリプトを開く

イメージをワークスペースに読み取ります。

I = imread('cameraman.tif');

イメージを表示します。

imshow(I);

イメージ上に楕円 ROI を描画します。この例では、ROI のサイズと位置を指定するので、draw メソッドを呼び出して対話形式による描画を有効にする必要はありません。

roi = images.roi.Ellipse(gca,'Center',[100 100],'Semiaxes',[50 80]);

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

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

コールバック関数 allevents は楕円 ROI の現在の中心と現在の半軸をコマンドラインに表示します。

function allevents(src,evt)
evname = evt.EventName;
    switch(evname)
        case{'MovingROI'}
            disp(['ROI moving Current Center: ' mat2str(evt.CurrentCenter)]);
            disp(['ROI moving Current SemiAxes: ' mat2str(evt.CurrentSemiAxes)]);
        case{'ROIMoved'}
            disp(['ROI moved Current Center: ' mat2str(evt.CurrentCenter)]);
            disp(['ROI moved Current SemiAxes: ' mat2str(evt.CurrentSemiAxes)]);
    end
end

詳細

すべて展開する

イベント

特定のイベントが発生したときに ROI から通知を受け取るには、これらのイベントに対する "リスナー" を設定します。これらのイベントのいずれかが発生したときに実行するコールバック関数を指定できます。ROI がリスナーを通じてアプリケーションに通知するとき、イベントに固有のデータを返します。特定のイベントのイベントクラスを確認して何が返されたかを調べます。

例については、楕円 ROI イベントのリスナーの設定を参照してください。

イベント名	トリガー	イベントデータ	イベント属性
`DeletingROI`	ROI が対話的に削除されようとしている。	`event.EventData`	`NotifyAccess`: `private` `ListenAccess`: `public`
`DrawingStarted`	ROI が対話的に描画されようとしている。	`event.EventData`	`NotifyAccess`: `private` `ListenAccess`: `public`
`DrawingFinished`	ROI が対話的に描画された。	`event.EventData`	`NotifyAccess`: `private` `ListenAccess`: `public`
`MovingROI`	ROI の形状または位置が対話的に変更中である。	`images.roi.EllipseMovingEventData`	`NotifyAccess`: `private` `ListenAccess`: `public`
`ROIMoved`	ROI の形状または位置が対話的に変更された。	`images.roi.EllipseMovingEventData`	`NotifyAccess`: `private` `ListenAccess`: `public`
`ROIClicked`	ROI がクリックされた。	`images.roi.ROIClickedEventData`	`NotifyAccess`: `private` `ListenAccess`: `public`

ヒント

関数 draw または drawellipse を使用して対話形式で ROI を描画するには、カーソルを座標軸に配置し、クリックアンドドラッグして形状を作成します。ROI の描画を終了するには、マウスボタンを離します。

ROI は、キーボードショートカットを含む以下の対話性をサポートします。

動作	キーボードショートカット
ROI の描画をキャンセルする。	Esc キーを押します。関数は `Position` プロパティが空の有効な ROI オブジェクトを返します。
描画中に楕円の幅を微調整する。	楕円の描画中に、スクロールホイールを使用して、楕円の幅を少し変更します。
ROI を回転する。	ポインターを頂点の近くに配置します。ポインターが回転ポインターに変わります。ROI をクリックし、その中心に対して回転させます。回転を 15 度間隔でスナップさせるには、回転中に Shift キーを押します。
描画中に縦横比を維持する。	描画中は Shift キーを押したままにします。円 ROI を作成します。縦横比をロックするには、ポインターを ROI に配置し、右クリックして表示されたコンテキストメニューから [縦横比を固定] を選択します。
ROI をサイズ変更 (形状変更) する。	頂点にポインターを配置し、クリックアンドドラッグします。サイズ変更中に縦横比を維持するには、Shift キーを押したままにします。
ROI を移動する。	ROI 上にポインターを配置します。ポインターが花形に変わります。クリックアンドドラッグして ROI を移動します。
ROI を削除する。	ROI の任意の位置にポインターを配置し、右クリックします。コンテキストメニューから [楕円の削除] を選択します。関数 `delete` を使用して、プログラムによって ROI を削除することもできます。

App Designer を使って作成したアプリで ROI を使用する方法の詳細については、App Designer を使って作成したアプリでの ROI の使用を参照してください。
円 ROI を描画するには、Circle オブジェクトを使用します。

バージョン履歴

R2018b で導入

すべて展開する

R2020a: `UIContextMenu` プロパティは推奨されません

R2020a 以降は非推奨

R2020a 以降では、UIContextMenu プロパティを使用してコンテキストメニューをグラフィックスオブジェクトや UI コンポーネントに割り当てることは推奨されません。代わりに ContextMenu プロパティを使用してください。プロパティの値は同じです。

現時点では UIContextMenu プロパティのサポートを削除する予定はありません。ただし、グラフィックスオブジェクトまたは UI コンポーネントに対して関数 get を呼び出すことにより返されるリストに、UIContextMenu プロパティは表示されなくなりました。

参考

drawellipse | Circle

トピック

ROI の形状の作成

Ellipse

説明

作成

構文

説明

入力引数

ax — ROI の親 gca (既定値) | Axes オブジェクト | UIAxes オブジェクト

プロパティ

AspectRatio — 楕円の縦横比 正の数値

Center — ROI の中心 [] (既定値) | 1 行 2 列の数値ベクトル

Color — ROI の色 [0 0.4470 0.7410] (既定値) | RGB 3 成分 | 色の名前 | 色の省略名

ContextMenu — コンテキスト メニュー ContextMenu オブジェクト

Deletable — ROI を削除するオプションをコンテキスト メニューに表示するかどうか true (既定値) | false

DrawingArea — ROI を対話形式で配置できる座標軸の領域 'auto' (既定値) | 'unlimited' | [x,y,w,h]

FaceAlpha — ROI 面の透明度 0.2 (既定値) | 範囲 [0, 1] の数値

FaceSelectable — ROI 面でクリックをキャプチャ可能 true (既定値) | false

FixedAspectRatio — 縦横比を一定に維持 false (既定値) | true

HandleVisibility — 親の Children プロパティでの ROI ハンドルの可視性 'on' (既定値) | 'off' | 'callback'

InteractionsAllowed — ROI の対話性 'all' (既定値) | 'none' | 'reshape' | 'translate'

Label — ROI ラベル '' (既定値) | 文字ベクトル | string スカラー

LabelAlpha — テキストの背景の透明度 1 (既定値) | 範囲 [0, 1] の数値

LabelTextColor — ラベル テキストの色 'black' (既定値) | RGB 3 成分 | 色の名前 | 色の省略名

LabelVisible — ラベルの可視性 'on' (既定値) | 'off' | 'hover'

LineWidth — ROI の境界線の幅 正の数値

MarkerSize — マーカー サイズ 正の数値

Parent — ROI の親 Axes オブジェクト | UIAxes オブジェクト

RotationAngle — ROI の中心周りの角度 0 (既定値) | 非負の数値スカラー

Selected — ROI の選択状態 false (既定値) | true

SelectedColor — 選択したときの ROI の色 'none' (既定値) | RGB 3 成分 | 色の名前 | 色の省略名

SemiAxes — 楕円の半軸の長さ 1 行 2 列の数値ベクトル

StripeColor — ROI ストライプの色 'none' (既定値) | RGB 3 成分 | 色の名前 | 色の省略名

Tag — ROI に関連付けるタグ '' (既定値) | 文字ベクトル | string スカラー

UserData — ROI に関連付けるデータ 任意の MATLAB データ

Vertices — 円周上の点の位置 n 行 2 列の数値行列

Visible — ROI の可視性 'on' (既定値) | 'off' | on/off の logical 値

オブジェクト関数

例

非対話形式による楕円 ROI の作成

楕円 ROI イベントのリスナーの設定

詳細

イベント

ヒント

バージョン履歴

R2020a: UIContextMenu プロパティは推奨されません

参考

トピック

`ax` — ROI の親
`gca` (既定値) | `Axes` オブジェクト | `UIAxes` オブジェクト

`AspectRatio` — 楕円の縦横比
正の数値

`Center` — ROI の中心
`[]` (既定値) | 1 行 2 列の数値ベクトル

`Color` — ROI の色
`[0 0.4470 0.7410]` (既定値) | RGB 3 成分 | 色の名前 | 色の省略名

`ContextMenu` — コンテキストメニュー
`ContextMenu` オブジェクト

`Deletable` — ROI を削除するオプションをコンテキストメニューに表示するかどうか
`true` (既定値) | `false`

`DrawingArea` — ROI を対話形式で配置できる座標軸の領域
`'auto'` (既定値) | `'unlimited'` | `[x,y,w,h]`

`FaceAlpha` — ROI 面の透明度
`0.2` (既定値) | 範囲 [0, 1] の数値

`FaceSelectable` — ROI 面でクリックをキャプチャ可能
`true` (既定値) | `false`

`FixedAspectRatio` — 縦横比を一定に維持
`false` (既定値) | `true`

`HandleVisibility` — 親の `Children` プロパティでの ROI ハンドルの可視性
`'on'` (既定値) | `'off'` | `'callback'`

`InteractionsAllowed` — ROI の対話性
`'all'` (既定値) | `'none'` | `'reshape'` | `'translate'`

`Label` — ROI ラベル
`''` (既定値) | 文字ベクトル | string スカラー

`LabelAlpha` — テキストの背景の透明度
`1` (既定値) | 範囲 [0, 1] の数値

`LabelTextColor` — ラベルテキストの色
`'black'` (既定値) | RGB 3 成分 | 色の名前 | 色の省略名

`LabelVisible` — ラベルの可視性
`'on'` (既定値) | `'off'` | `'hover'`

`LineWidth` — ROI の境界線の幅
正の数値

`MarkerSize` — マーカーサイズ
正の数値

`Parent` — ROI の親
`Axes` オブジェクト | `UIAxes` オブジェクト

`RotationAngle` — ROI の中心周りの角度
`0` (既定値) | 非負の数値スカラー

`Selected` — ROI の選択状態
`false` (既定値) | `true`

`SelectedColor` — 選択したときの ROI の色
`'none'` (既定値) | RGB 3 成分 | 色の名前 | 色の省略名

`SemiAxes` — 楕円の半軸の長さ
1 行 2 列の数値ベクトル

`StripeColor` — ROI ストライプの色
`'none'` (既定値) | RGB 3 成分 | 色の名前 | 色の省略名

`Tag` — ROI に関連付けるタグ
`''` (既定値) | 文字ベクトル | string スカラー

`UserData` — ROI に関連付けるデータ
任意の MATLAB データ

`Vertices` — 円周上の点の位置
n 行 2 列の数値行列

`Visible` — ROI の可視性
`'on'` (既定値) | `'off'` | on/off の logical 値

R2020a: `UIContextMenu` プロパティは推奨されません