Main Content

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

imtool

イメージ ビューアー アプリを開く

説明

関数 imtoolイメージ ビューアー アプリを開きます。このアプリでは、イメージの表示と一般的なイメージ処理タスクを行うための統合環境が提供されます。

イメージ ビューアーは、イメージ表示のための figure、axes、および image オブジェクトのプロパティ設定を最適化する imshow のすべてのイメージ表示機能を提供します。イメージ ビューアーでは、さらにピクセル領域ツール、イメージ情報ツール、コントラスト調整ツールなど、イメージ内を移動したり調査したりするためのツールを利用することができます。

imtool は、イメージ ビューアー アプリを空の状態で開きます。表示するイメージを選択するために、[ファイル] メニューの [開く] または [ワークスペースからインポート] オプションを使用します。

imtool(I) は、イメージ データ型の既定の表示範囲を使用して、イメージ ビューアー アプリでグレースケール イメージ I を表示します。

imtool(I,range) は、表示範囲を range として指定し、イメージ ビューアー アプリでグレースケール イメージ I を表示します。このアプリは、表示範囲外のピクセル値をクリップして黒または白で表示し、表示範囲内のピクセル値を中間のグレー階調で表示します。このアプリは既定数のグレー レベルを使用します。

imtool(RGB) は、イメージ ビューアー アプリでトゥルーカラー イメージ RGB を表示します。

imtool(BW) は、イメージ ビューアー アプリでバイナリ イメージ BW を表示します。0 のピクセル値は黒として表示され、1 のピクセル値は白として表示されます。

imtool(X,cmap) は、カラーマップ cmap を持つインデックス付きイメージ Xイメージ ビューアー アプリで表示します。

imtool(filename) は、グラフィックス ファイル filename に格納されたイメージをイメージ ビューアーで表示します。

imtool(___,Name,Value) は、イメージの表示のさまざまな特性を制御するパラメーターとそれに対応する値を指定して、イメージを表示します。

hfigure = imtool(___) は、イメージ ビューアー アプリで作成された Figure のハンドル hfigure を返します。

imtool close all は、イメージ ビューアーの開いているすべてのインスタンスを閉じます。

さまざまなイメージ タイプの表示

ファイルからカラー イメージを表示します。

imtool('board.tif')

インデックス付きイメージを表示します。

[X,map] = imread('trees.tif');
imtool(X,map)

グレースケール イメージを表示します。

I = imread('cameraman.tif');
imtool(I)

表示範囲を調整して、グレースケール イメージを表示します。

h = imtool(I,[0 80]);
close(h)

入力引数

すべて折りたたむ

2 次元グレースケール イメージ。m 行 n 列の数値行列を指定します。

データ型: single | double | int16 | uint8 | uint16

グレースケール イメージ I の表示範囲。次の値のいずれかを指定します。

説明

[low high]

イメージ ビューアーは値 low (および low より小さな任意の値) のピクセルを、黒で表示します。イメージ ビューアーは値 high (および high より大きな任意の値) のピクセルを、白で表示します。

[]

イメージ ビューアーは自動的に表示範囲を [min(I(:)) max(I(:))] に設定します。I の最小値を黒、最大値を白として表示します。

2 次元の RGB イメージ。m x n x 3 の数値行列として指定します。

データ型: single | double | uint8 | uint16

2 次元のバイナリ イメージ。m 行 n の logical 行列として指定します。

データ型: logical

2 次元のインデックス付きイメージ。m 行 n 列の数値行列として指定します。

データ型: single | double | uint8 | logical

インデックス付きイメージ X と関連付けられたカラーマップ。c カラーの RGB 値を含む c 行 3 列の数値行列として指定します。

データ型: single | double | int16 | uint8 | uint16

イメージを含むグラフィックス ファイルの名前。文字ベクトルとして指定します。ファイルは、imread または dicomread で読み取り可能なイメージ、または rsetwrite で作成された解像度を下げたデータセット (R-Set) を含んでいなければなりません。ファイルが複数のイメージを含む場合、最初の 1 つが表示されます。ファイルは、現在のディレクトリまたは MATLAB® パス上になければなりません。

データ型: char | string

名前と値のペアの引数

オプションの引数 Name,Value のコンマ区切りペアを指定します。Name は引数名で、Value は対応する値です。Name は引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を、任意の順番で指定できます。

例: imtool(I,'Colormap',jet) は、カラーマップ jet を使用してグレースケール イメージ I を表示します。

カラーマップ。'Colormap' と範囲 [0, 1] の値を持つ v 行 3 列の数値行列で構成されるコンマ区切りのペアとして指定します。parula または jet などの事前定義カラーマップ関数を使用してカラーマップ行列を作成することもできます。

例: 'Colormap',repmat([1:256]',1,3);

例: 'Colormap',jet

例: 'Colormap',parula(128)

データ型: double

表示範囲。'DisplayRange' と形式 [low high] の 2 要素ベクトルで構成されるコンマ区切りのペアとして指定します。

メモ

ファイル名でイメージを指定する場合を除いて、パラメーター名の入力はオプションです。構文 imtool(I,[low high]) は、imtool(I,'DisplayRange',[low high]) と等価です。ただし、ファイル名を付けて imtool を呼び出す場合は、構文 imtool(filename,'DisplayRange',[low high]) のように、'DisplayRange' パラメーターを指定しなければなりません。

初期倍率。'InitialMagnification' と次の値のいずれかで構成されるコンマ区切りのペアとして指定します。

パラメーター

'adaptive'初期表示で全体のイメージが表示されます。イメージが大きすぎてスクリーン上で表示できない場合、イメージ ビューアーは、スクリーンに収まる最も大きい倍率でイメージを表示します。
'fit'

イメージ ビューアーではイメージ全体がウィンドウに収まるように拡大縮小されます。

数値スカラー

イメージ ビューアーではイメージ全体が元のイメージ サイズの割合で拡大縮小されます。たとえば、100 を指定した場合、イメージ ビューアーでは、100% の倍率 (イメージ ピクセルあたり 1 スクリーン ピクセル) でイメージを表示します。

メモ

イメージの縦横比が、指定された倍率でいずれかの次元の表示が 1 ピクセル未満になるような場合、イメージ ビューアーで警告が出力され、イメージは 100% で表示されます。

既定の設定では、初期倍率パラメーターは、iptgetpref('ImtoolInitialMagnification') によって返される値に設定されます。既定の初期倍率の動作を変更するには、関数 iptsetpref を使用するか、Image Processing Toolbox™ 基本設定パネルを開いて、ImtoolInitialMagnification ツールボックス基本設定を設定します。基本設定パネルの詳細については、iptprefs を参照してください。

イメージのスケーリング時に使用する内挿手法。'Interpolation' と次のいずれかの値から構成されるコンマ区切りのペアとして指定します。

説明
'nearest'最近傍内挿 (既定の設定)
'bilinear'双一次内挿

出力引数

すべて折りたたむ

イメージ ビューアーの Figure のハンドル。ハンドルとして返されます。

詳細

すべて折りたたむ

大規模データのサポート

メモリに収まらない非常に大きな TIFF または NITF イメージを表示するには、rsetwrite を使用して、イメージ ビューアー内で表示可能な解像度を下げたデータセット (R-Set) を作成できます。メモリに収まる場合でも、R-Set を使用すると、大きいイメージに対するイメージ ビューアーのパフォーマンスを向上できます。

次のツールは R-Set とともに使用できます。概要、ズーム、移動、イメージ情報、距離。その他のツールは、R-Set と一緒には使用できません。ピクセル領域、コントラスト調整、イメージのトリミング、およびウィンドウ/レベル ツールは使用できません。ピクセル情報ツールに表示されるのは、ピクセルの x および y 座標のみで、関連する強度、インデックス、RGB 値は表示されないことに注意してください。

関連するツールボックスの基本設定

Image Processing の基本設定ダイアログ ボックスを使用すると、イメージ ビューアーの動作を変更するさまざまなツールボックスの設定が可能です。このダイアログにアクセスするには、MATLAB デスクトップまたはイメージ ビューアーのメニューの [ファイル][基本設定] を選択します。また、関数 iptsetpref を使用してプログラム的にこれらの基本設定を設定することもできます。

基本設定

説明

'ImtoolInitialMagnification'

イメージ表示に対する初期倍率を制御します。このツールボックスの基本設定をオーバーライドするには、imtool を呼び出すときに、以下のように 'InitialMagnification' パラメーターを指定します。

imtool(...,'InitialMagnification',initial_mag)

'ImtoolStartWithOverview'

イメージ ビューアーを使用してイメージを開く場合に、自動的に概要ツールを開くかどうかを制御します。取りうる値は以下のとおりです。

  • true— イメージを開くときに概要ツールを開く。

  • false — イメージを開くときに概要ツールを開かない。これは既定の動作です。

これらの基本設定の詳細については、「iptprefs」を参照してください。

ヒント

  • 整数型を持つグレースケール イメージの場合、既定の表示範囲は [intmin(class(I)) intmax(class(I))] です。

    グレースケール イメージが single クラスまたは double クラスの場合、既定の表示範囲は [0 1] になります。single または double イメージのデータ範囲が、既定の表示範囲より大きすぎるか、小さすぎる場合、既定の表示範囲を使用して表示されないイメージ内の特徴を見るために、表示範囲の設定を試行する必要があるかもしれません。

  • イメージ ビューアーには、[アプリ] タブからアクセスできます。[イメージ処理とコンピューター ビジョン] グループに移動して、イメージ ビューアーを選択します。

  • ハンドル hfigure で指定された特定のイメージ ビューアーを、コマンド close(hfigure) を使用して閉じることができます。

R2006a より前に導入