このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

setPosition

(非推奨) ROI オブジェクトを新しい位置に移動

setPosition は推奨されません。代わりに、新しい ROI で、Position プロパティの値を設定します。詳細については、バージョン履歴を参照してください。

構文

setPosition(h,pos)

setPosition(h,x,y)

説明

setPosition(h,pos) は、ROI オブジェクト h の位置を pos で指定された位置に移動します。

setPosition(h,x,y) はラインまたは点 ROI オブジェクトの点の新しい x および y 座標を指定します。

入力引数

h — ROI オブジェクト

imellipse | imline | impoint | impoly | imrect

ROI オブジェクト。imellipse、imline、impoint、impoly または imrect オブジェクトとして指定します。

pos — ROI オブジェクト新しい位置

数値配列

ROI オブジェクトの新しい位置。数値配列として指定します。配列の形状は ROI オブジェクトのタイプによって異なります。

ROI オブジェクト	位置
imellipse	[xmin ymin width height] 形式の 4 要素のベクトル。楕円を囲む境界ボックスの新しいサイズと位置を表します。境界ボックスの新しいサイズは width x height ピクセルです。ボックスの左上隅の新しい (x,y) 座標は (xmin,ymin) です。
imline	[x1 y1; x2 y2] 形式の 2 行 2 列の行列。ラインの 2 つの端点の新しい位置を表します。
impoint	[x y] 形式の 1 行 2 列ベクトル。
impoly	n 行 2 列の行列。2 つの列は、n 個の各頂点に対して、新しい x と y 座標を定義します。
imrect	[xmin ymin width height] 形式の 4 要素ベクトル。四角形の新しいサイズは width x height ピクセルです。四角形の左上隅の新しい (x,y) 座標は (xmin,ymin) です。

x — 点の新しい x 座標

2 要素ベクトル | 数値スカラー

点の新しい x 座標。

• h が imline オブジェクトの場合、x は 2 要素ベクトルで、2 本のラインの端点の x 座標を表します。

• h が impoint オブジェクトの場合、x は数値スカラーで、1 つの点の x 座標を表します。

y — 点の新しい y 座標

2 要素ベクトル | 数値スカラー

点の新しい y 座標。

• h が imline オブジェクトの場合、y は 2 要素ベクトルで、2 本のラインの端点の y 座標を表します。

• h が impoint オブジェクトの場合、y は数値スカラーで、1 つの点の y 座標を表します。

バージョン履歴

R2008a で導入

R2018b: setPosition は非推奨

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

ROI の現在の位置を指定するには、ROI の Position プロパティに値を割り当てます。

コードの更新

setPosition メソッドのすべてのインスタンスを更新してください。

非推奨の使用方法	推奨される代替案
この例では、オブジェクト関数 setPosition を使用して ROI の現在の位置を設定します。 imshow('cameraman.tif'); h = imrect(gca,[10 10 100 100]); setPosition(h,[20 20 200 200]);;	新しい ROI オブジェクトの 1 つを作成し、オブジェクト関数 setPosition を使用する代わりに ROI の Position プロパティに値を割り当てます。 imshow('cameraman.tif'); h = drawrectangle(gca,'Position',[10 10 100 100]); h.Position = [20 20 200 200];

参考

Ellipse | Line | Point | Polygon | Polyline | Rectangle

トピック

• ROI の形状の作成
• ROI の移行