Main Content

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

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' と v 行 3 列の数値行列で構成されるコンマ区切りのペアとして指定します。parula または jet などの事前定義カラーマップ関数を使用してカラーマップ行列を作成することもできます。

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

例: 'Colormap',jet

例: 'Colormap',parula(128)

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

メモ

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

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

パラメーター

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

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

数値スカラー

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

メモ

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

既定の設定では、初期倍率パラメーターは、iptgetpref('ImtoolInitialMagnification') によって返される値に設定されます。

イメージのスケーリング時に使用する内挿手法。'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」を参照してください。

ヒント

  • イメージ ビューアーは、imshow のすべてのイメージ表示機能に加えて、ピクセル領域ツール、イメージ情報ツール、コントラスト調整ツールなど、イメージ内を移動したり調査したりするためのその他のツールを利用することができます。イメージ ビューアーでは、イメージの表示といくつかの一般的な画像処理タスクを行うための統合環境が提供されます。

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

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

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

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

R2006a より前に導入