makeConstrainToRectFcn

四角形の範囲のドラッグの制約関数を作成

makeConstrainToRectFcn は推奨されません。代わりに、新しい ROI で DrawingArea プロパティを使用してください。詳細については、バージョン履歴を参照してください。

構文

fcn = makeConstrainToRectFcn(roi,x,y)

説明

fcn = makeConstrainToRectFcn(roi,x,y) は、特定の ROI タイプのドラッグ可能なツールに対する位置の制約関数を作成します。ツールの位置は、位置ベクトル x および y によって記述される四角形の境界で制約されます。

例

impoint のドラッグのイメージ範囲への制約

イメージを表示します。

imshow("cell.tif")

impoint オブジェクトを (x,y) 座標 (20,60) に作成します。イメージ内で、正の y 方向は下向きです。

h = impoint(gca,20,60);

impoint をイメージ範囲に制約する関数を作成します。

x = get(gca,"XLim");
y = get(gca,"YLim");
fcn = makeConstrainToRectFcn("impoint",x,y);

制約関数を impoint に適用します。点をドラッグしてイメージの境界の通過を試みます。制約関数により、点はイメージの境界を越えることができません。

setPositionConstraintFcn(h,fcn);

入力引数

roi — ROI タイプ

'imellipse' | 'imfreehand' | 'imline' | 'impoint' | 'impoly' | 'imrect'

ROI タイプ。'imellipse'、'imfreehand'、'imline'、'impoint'、'impoly'、または 'imrect' として指定します。

データ型: char | string

x — x 方向の四角形の境界

2 要素の数値ベクトル

x 方向の四角形の境界。[xmin xmax] 形式の 2 要素の数値ベクトルとして指定します。

y — y 方向の四角形の境界

2 要素の数値ベクトル

y 方向の四角形の境界。[ymin ymax] 形式の 2 要素の数値ベクトルとして指定します。

出力引数

fcn — 関数ハンドル

ハンドル

関数ハンドル。ハンドルとして返されます。詳細については、関数ハンドルの作成を参照してください。

バージョン履歴

R2006a で導入

R2018b: makeConstrainToRectFcn は非推奨

R2018b 以降、既存の ROI オブジェクトのセットが新しい ROI オブジェクトのセットに置き換えられています。新しいオブジェクトは、面の色の透明度など、さらに便利な機能を提供します。新しいクラスでは、移動やクリックなどの ROI の変化に応答するために使用できるイベントもサポートされています。現時点では、以前の ROI オブジェクトを削除する予定はありませんが、追加された機能や柔軟性を活用するために、新しい ROI に切り替えてください。新しい ROI 関数を使用した ROI の作成方法の詳細については、ROI の形状の作成を参照してください。

新しい ROI では、ROI の DrawingArea プロパティを使用して、ROI を描画または移動できる範囲を指定します。

コードの更新

makeConstrainToRectFcn のすべてのインスタンスを更新してください。

非推奨の使用方法	推奨される代替案
この例では、関数 makeConstrainToRectFcn を使用して、ROI を作成または移動できる範囲をベースのイメージのサイズに制限する関数を作成します。既定では、ROI をイメージ領域の外に移動できます。 imshow('cell.tif') h = impoint(gca,20,60); % Make a function that constrains movement of the point x = get(gca,'XLim'); y = get(gca,'YLim'); fcn = makeConstrainToRectFcn('impoint',x,y);; % Apply the constraint function to the ROI. setPositionConstraintFcn(h,fcn);	次のコードは等価なコードで、関数 makeConstrainToRectFcn を使用する代わりに、ROI の DrawingArea プロパティを使用しています。既定では、新しい ROI の作成と移動がベースのイメージのサイズに制限されているため、この例ではその部分を再作成する必要がありません。代わりに、この例では、ROI を移動できない 10 ピクセルの余白をイメージ境界内に作成します。 I = imread('cell.tif'); imshow(I) h = drawpoint(gca,'Position',[20 60]) [height width] = size(I); %Get image dimensions h.DrawingArea = [10,10,(width-20),(height-20)];

参考

imdistline | imellipse | imfreehand | imline | impoint | impoly | imrect

トピック

• ROI の移行