ドキュメンテーション

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

imtool

画像ビューアー アプリケーション

構文

imtool
imtool(I)
imtool(I,[low high])
imtool(RGB)
imtool(BW)
imtool(X,map)
imtool(filename)
hfigure = imtool(...)
imtool close all
imtool(...,param1,val1,param2,val2,...)

説明

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

imtool(I) は、画像ビューアーでグレースケール イメージ I を表示します。

imtool(I,[low high]) は、ベクトル [low high]I の表示範囲を指定して、画像ビューアーでグレースケール イメージ I を表示します。値 low (と low より小さい値) は黒で表示され、値 high (と high より大きい値) は白で表示されます。その間の値は、中間のグレー階調で表示されます。画像ビューアーは既定数のグレー レベルを使用します。[low high] に対して空行列 ([]) を使用する場合、画像ビューアーは [min(I(:)) max(I(:))] を使用します。これにより、I の最小値は黒、最大値は白として表示されます。

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

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

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

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

hfigure = imtool(...) は、画像ビューアーで作成された Figure のハンドル hfigure を返します。close(Hfigure) は画像ビューアーを閉じます。

imtool close all は、開いているすべての画像ビューアーを閉じます。

imtool(...,param1,val1,param2,val2,...) は、イメージの表示のさまざまな見方を制御するパラメーターとそれに対応する値を指定して、イメージを表示します。次の表は、すべての imshow パラメーターの一覧です。パラメーター名は省略形でも構いません。大文字と小文字は区別されません。

パラメーター

'Colormap'

Figure の colormap プロパティを使用するためにカラーマップを指定する 2 次元の実数の m 行 3 列の行列。トゥルーカラーではない色でグレースケール イメージを表示するには、このパラメーターを使用してください。空のカラーマップ ([]) を指定すると、imtool はこのパラメーターを無視します。

'DisplayRange'

グレースケール イメージの表示範囲を制御する 2 要素ベクトル [LOW HIGH]。このパラメーターの設定方法の詳細については、imtool(I,[low high]) 構文の項を参照してください。

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

'InitialMagnification'

2 つの文字列 'adaptive''fit' のいずれか、またはイメージの表示に使用される初期倍率を指定する数値のスカラー値。

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

'fit' に設定すると、画像ビューアーではイメージ全体がウィンドウに収まるように拡大縮小されます。

値が数値に設定されている場合、その値は倍率をパーセンテージで指定します。たとえば、100 を指定した場合、画像ビューアーでは、100% の倍率 (イメージ ピクセルあたり 1 スクリーン ピクセル) でイメージを表示します。

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

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

クラス サポート

トゥルーカラー イメージは、uint8uint16singledouble のいずれかです。インデックス付きイメージは、logicaluint8singledouble のいずれかです。グレースケール イメージは、uint8uint16int16singledouble のいずれかです。バイナリ イメージは logical でなければなりません。バイナリ イメージのクラスは logical です。

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

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

大規模データのサポート

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

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

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

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

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

    imtool(...,'InitialMagnification',initial_mag).
  • 'ImtoolStartWithOverview' は、画像ビューアーを使用してイメージを開く場合に、自動的に概要ツールを開くかどうかを制御します。取りうる値は以下のとおりです。

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

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

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

ファイルのイメージを表示します。

imtool('board.tif')

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

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

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

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

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

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

詳細

すべて展開する

ヒント

imshow は、イメージ表示のための Figure、Axes、および image オブジェクトのプロパティを最適化するためのツールボックスの基本のイメージ表示関数です。画像ビューアーは、imshow のすべてのイメージ表示機能に加えて、ピクセル領域ツール、イメージ情報ツール、コントラスト調整ツールなど、イメージのナビゲートや調査のためのその他のツールへのアクセスも提供します。画像ビューアーでは、イメージの表示と一般的な画像処理の作業を行うための統合環境が提供されます。

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

この情報は役に立ちましたか?