イメージビューアーアプリ入門

イメージビューアー アプリでは、イメージの表示と一般的なイメージ処理タスクを行うための統合環境が提供されます。イメージビューアーを使用するためのワークフローには、通常、次の手順の組み合わせが含まれます。

次の図は、イメージビューアーに表示されたイメージを示しています。関連ツールの多くが開かれ、アクティブな状態になっています。

Grayscale image displayed in Image Viewer with the Distance tool open in the app figure window. An Overview tool, Adjust Contrast tool, Pixel Region tool, and Image Information tool are open in separate figure windows.

メモ

個々のツールはイメージビューアー アプリの外からでもアクセスできます。このためには、imshow などの関数を使用して Figure ウィンドウにイメージを表示し、ツールボックス関数を使用して 1 つ以上のツールを作成します。たとえば、個々のツールを組み合わせて使用し、独自のレイアウトと動作を持つイメージ処理アプリを作成できます。詳細については、対話型ツールのワークフローを参照してください。

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

イメージビューアー アプリの起動には、3 通りの方法があります。どの場合も、ワークスペースの変数からイメージを選択するか、またはイメージファイルの名前を指定します。イメージビューアーは、imread で読み取り可能なファイルであれば開くことができます。

関数 imtool を使用して、コマンドラインからイメージビューアー アプリを開くことができます。この関数は、初期倍率、カラーマップ、表示範囲など、イメージの初期表示のさまざまな特性を制御する場合に使用します。たとえば、このコードはイメージビューアーを開き、ファイル名が cameraman.tif のイメージを読み込みます。
```
imtool("cameraman.tif")
```
[アプリ] タブの [イメージ処理とコンピュータービジョン] からイメージビューアー アプリを開くことができます。ファイル名からイメージデータをイメージビューアーに表示するには、[ファイル] メニューの [開く] を選択します。ワークスペースからイメージデータをイメージビューアーに表示するには、[ファイル] メニューの [ワークスペースからインポート] を選択します。オプションで、ワークスペースの変数をフィルター処理し、バイナリ、インデックス付き、強度 (グレースケール)、トゥルーカラー (RGB) イメージなど、目的のタイプのイメージのみを表示します。
[ファイル] メニューの [新規作成] オプションを使用することで、既存のイメージビューアー内から新しいイメージビューアーを起動できます。

メモ

ファイル名を指定する場合、イメージビューアーはイメージデータをワークスペース変数には保存しません。ただし、イメージビューアーのイメージはワークスペースにエクスポートできます。詳細については、結果の保存とエクスポートを参照してください。

イメージビューアーアプリ内のイメージのナビゲート

イメージビューアーを開いた後、イメージはアプリウィンドウに表示されます。イメージビューアーは、ナビゲーション支援ツールやイメージの詳細な調査に役立つツールを提供します。

操作	ナビゲーション支援ツールなどのツール	ツールの画面
イメージ概要の確認	イメージの拡大時に現在表示されているイメージの部分を確認するには、概要ツールを使用します。概要ツールでは、イメージ全体が画面に収まるようにスケールされて表示されます。イメージのこのビューの上には、イメージのどの部分がイメージビューアーに現在表示されているかを示す "詳細四角形" が重ねて表示されます。概要ツールで詳細四角形を移動およびリサイズすると、イメージビューアーに表示されるイメージの部分をパンまたはズームできます。下にあるイメージに対して詳細四角形のコントラストを向上させるには、四角形の色を変更します。四角形内の任意の場所を右クリックして、コンテキストメニューの [色の設定] オプションから色を選択します。詳細四角形の現在位置とサイズを取得するには、四角形内の任意の場所を右クリックして、コンテキストメニューから [位置のコピー] を選択します。`[xmin ymin width height]` の形式の 4 要素ベクトルとして、位置がクリップボードにコピーされます。この位置ベクトルは、ワークスペースまたは別のアプリケーションに貼り付けることができます。概要ツールに表示されたイメージの表示を印刷するには、概要ツールの [ファイル] メニューから [Figure に出力] オプションを選択します。詳細については、イメージの印刷を参照してください。
イメージの拡大	倍率を指定してイメージを拡大または縮小するには、[ツール] メニューの [倍率] オプションを使用します。イメージをクリックしてイメージを拡大または縮小するには、ズームツールを使用します。ツールは、クリックした点をイメージの新しい視点の中心とします。メモ Ctrl + プラスキーまたは Ctrl + マイナスキーを使用して拡大または縮小することもできます。これらは、キーボードの数値キーパッドのプラス (+) キーとマイナス (-) キーです。イメージビューアーがイメージをスケールする際には、内挿を使用してイメージ行列内の要素と直接対応しないスクリーンピクセルの値が決定されます。イメージのリサイズに使用する内挿法の詳細については、`imresize` を参照してください。
イメージのパン	イメージビューアーウィンドウに収まりきらない大きさのイメージをパンするには、スクロールバーまたはパンツールを使用します。
イメージのカラーマップの選択	グレースケールイメージおよびインデックス付きイメージの特徴の可視性を向上させるには、カラーマップの選択ツールを使用してイメージのカラーマップを変更します。MATLAB^® カラーマップを選択するか、ワークスペースからカラーマップ変数を選択できます。MATLAB コマンドを入力してカラーマップを作成することもできます。イメージビューアーではカラーバーが提供されません。カラーバーを追加するには、別の Figure ウィンドウでイメージを開きます。詳細については、結果の保存とエクスポートを参照してください。

イメージデータに関する情報の取得

イメージビューアーは、イメージデータのピクセル値およびその他の特性に関する情報の取得に役立つツールを提供します。

ツール	説明	ツールの画面
ピクセル情報ツール	ポインターの下にある 1 つのピクセルの (x, y) 座標および値を取得します。詳細については、イメージビューアーでの個々のピクセル値の特定を参照してください。
表示範囲ツール	グレースケールイメージデータの表示範囲を指定します。このツールは、RGB、インデックス付きまたはバイナリイメージでは有効になりません。詳細については、イメージビューアーでのイメージ表示範囲の特定を参照してください。
ピクセル領域ツール	ピクセルのグループに関する情報を取得します。詳細については、イメージの領域内でのピクセル値の特定を参照してください。
距離ツール	2 つのピクセル間のユークリッド距離を測定します。詳細については、イメージビューアーアプリでのピクセル間の距離の測定を参照してください。
イメージ情報ツール	イメージとイメージファイルメタデータに関する情報を取得します。イメージ情報ツールは、幅、高さ、データ型、およびイメージタイプに関する基本情報を常に提供します。グレースケールおよびインデックス付きイメージの場合、この情報には最小および最大の強度値が含まれます。ファイル名を指定してイメージを選択し、イメージビューアーで開く場合は、イメージ情報ツールにイメージのメタデータも表示されます。このメタデータは、関数 `imfinfo` または `dicominfo` によって返される情報と同じです。

イメージデータの変更

イメージビューアーは、イメージコントラストの調整やイメージのトリミングに役立つツールを提供します。

既定の設定では、イメージビューアーを閉じると、変更したイメージデータは保存されません。ただし、変更したイメージをファイルにエクスポートするか、変更したデータをワークスペース変数に保存できます。詳細については、結果の保存とエクスポートを参照してください。

ツール	説明	ツールの画面
コントラスト調整ツール	ピクセル値のヒストグラム上にウィンドウを設定することにより、イメージのコントラストを調整します。詳細については、イメージビューアーアプリでのイメージコントラストの調整を参照してください。
ウィンドウ/レベルツール	イメージを操作することにより、イメージのコントラストを調整します。詳細については、イメージビューアーアプリでのイメージコントラストの調整を参照してください。
イメージのトリミングツール	イメージを四角形の関心領域にトリミングします。詳細については、イメージビューアーアプリを使用したイメージのトリミングを参照してください。

結果の保存とエクスポート

イメージビューアーを使用すると、イメージデータのワークスペースへのエクスポート、イメージデータのファイルへの保存、新しい Figure ウィンドウでのイメージの表示ができます。イメージデータを保存してエクスポートする場合、表示範囲の変更は保存されません。変更を保存する場合は、関数 imcontrast を使用します。

出力先手続き

ワークスペース変数の作成

出力先	手続き
ワークスペース変数の作成	イメージビューアー内のイメージデータからワークスペース変数を作成するには、3 通りの方法があります。イメージビューアーの [ファイル] メニューにある [ワークスペースにエクスポート] オプションを使用できます。関数 `imtool` を使用してアプリを起動し、ツールのハンドルを指定する場合は、関数 `getimage` を使用してツールのハンドルを指定します。たとえば、このコードはイメージビューアー内のファイル名が `moon.tif` というイメージを開き、そのイメージを変数 `moon` にエクスポートします。 t = imtool("moon.tif"); moon = getimage(t); ツールのハンドルを指定せずにアプリを起動した場合は、関数 `getimage` を使用して、Figure 内部の image オブジェクトのハンドルを指定します。たとえば、このコードはイメージビューアー内のファイル名が `moon.tif` というイメージを開き、そのイメージを変数 `moon` にエクスポートします。 imtool("moon.tif") moon = getimage(imgca);
ファイルに保存します	イメージビューアーの [ファイル] メニューにある [名前を付けて保存] オプションを選択して、イメージの保存ツールを使用します。このツールを使用すると、ファイルシステムをナビゲートし、ファイルの保存場所の決定、ファイル名の指定、およびファイル形式の選択ができます。
新しい Figure ウィンドウを開く	[ファイル] メニューから [Figure に出力] オプションを選択します。この Figure ウィンドウを使用すると、カラーバーの確認やイメージの印刷ができます。詳細については、表示されたグレースケールイメージへのカラーバーの追加とイメージの印刷を参照してください。

イメージビューアー内のイメージデータからワークスペース変数を作成するには、3 通りの方法があります。

イメージビューアーの [ファイル] メニューにある [ワークスペースにエクスポート] オプションを使用できます。
関数 imtool を使用してアプリを起動し、ツールのハンドルを指定する場合は、関数 getimage を使用してツールのハンドルを指定します。たとえば、このコードはイメージビューアー内のファイル名が moon.tif というイメージを開き、そのイメージを変数 moon にエクスポートします。
```
t = imtool("moon.tif");
moon = getimage(t);
```
ツールのハンドルを指定せずにアプリを起動した場合は、関数 getimage を使用して、Figure 内部の image オブジェクトのハンドルを指定します。たとえば、このコードはイメージビューアー内のファイル名が moon.tif というイメージを開き、そのイメージを変数 moon にエクスポートします。
```
imtool("moon.tif")
moon = getimage(imgca);
```