Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

immagbox

スクロール パネル内に表示されたイメージの倍率ボックス

説明

関数 immagbox を使用して、スクロール パネルに含まれるイメージと同じ Figure に倍率ボックスを追加します。倍率ボックスは、ターゲット イメージの現在の倍率を含む編集可能なテキスト ボックスです。倍率ボックスに新しい値を入力すると、ターゲット イメージの倍率が変更されます。ターゲット イメージの倍率が何らかの理由で変更されると、倍率ボックスの倍率値が更新されます。

hbox = immagbox(hparent,himage) は、スクロール パネルに表示されているイメージの倍率ボックスを作成します。himage は、スクロール パネル内のターゲット イメージのハンドルです。hparent は、倍率ボックスを含む figure または uipanel オブジェクトのハンドルです。この関数は、倍率ボックスのハンドル hbox を返します。

すべて折りたたむ

イメージを Figure に表示します。Figure ウィンドウの標準のツール バーとメニュー バーはスクロール パネルで動作しないため、この例では、それらを非表示にします。

hFig = figure('Toolbar','none','Menubar','none');
hIm = imshow('pears.png');

イメージを表示するスクロール パネルを作成します。

hSP = imscrollpanel(hFig,hIm);
set(hSP,'Units','normalized','Position',[0 .1 1 .9])

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

倍率ボックスを Figure に追加します。倍率ボックスの位置を Figure の左下隅に設定します。

hMagBox = immagbox(hFig,hIm);
pos = get(hMagBox,'Position');
set(hMagBox,'Position',[0 0 pos(3) pos(4)])

Figure contains an axes object and other objects of type uipanel, uicontrol. The axes object contains an object of type image.

ビューをプログラム内で制御できるようにスクロール パネル API を取得します。

apiSP = iptgetapi(hSP);

スクロール パネルの API 関数 setMagnification を使用してイメージの倍率を 200% に設定します。倍率ボックスが更新される様子に注目してください。

apiSP.setMagnification(2)

Figure contains an axes object and other objects of type uipanel, uicontrol. The axes object contains an object of type image.

入力引数

すべて折りたたむ

倍率ボックスを含む figure または uipanel オブジェクトのハンドル。ハンドルとして指定します。

ターゲット イメージのハンドル。ハンドルとして指定します。イメージは、imscrollpanel で作成したスクロール パネルに表示されていなければなりません。

出力引数

すべて折りたたむ

倍率ボックスのハンドル。ハンドルとして返されます。倍率ボックスは uipanel オブジェクトの一種です。

詳細

すべて折りたたむ

倍率ボックスの API 構造体

倍率ボックスには、API と呼ばれる関数ハンドルの構造体が含まれます。この API の関数を使用して倍率ボックスを操作できます。この構造体を取得するには、次の例に示すように関数 iptgetapi を使用します。

api = iptgetapi(hbox)

次の表に、構造体に表示される順序で倍率ボックスの API 関数を示します。

関数

説明

setMagnification

ターゲット イメージの倍率をイメージ ピクセルのスクリーン ピクセル単位で設定します。

mag = api.setMagnification(new_mag)

new_mag はスカラーの倍率係数です。

バージョン履歴

R2006a より前に導入