ドキュメンテーション

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

imshow

構文

  • imshow(X,map)
  • imshow(X,RX,map)
  • imshow(filename)
  • imshow(___,Name,Value...)
  • imshow(gpuarrayIM,___)
  • imshow(I,[low high])
  • himage = imshow(___)

説明

imshow(I) は、イメージ I を Handle Graphics® の図に表示します。ここで、I は、グレースケール イメージ、RGB (トゥルーカラー) イメージまたはバイナリ イメージです。バイナリ イメージの場合、imshow は値 0 (ゼロ) を黒とし、1 を白としてピクセルを表示します。

imshow(I,RI) は、関連付けられている 2 次元空間参照オブジェクト RI を用いてイメージ I を表示します。

imshow(X,map) は、カラーマップ map をもつインデックス付きイメージ X を表示します。カラーマップの行列は、任意の行数をもつことができますが、列は 3 列でなければなりません。各行は、1 番目の要素が赤の強度を指定し、2 番目の要素が緑を指定し、3 番目の要素が青を指定する色として解釈されます。色の輝度は、0.0 ~ 1.0 の範囲で指定されます。

imshow(X,RX,map) は、関連付けられている 2 次元空間参照オブジェクト RX およびカラーマップ MAP を用いて、インデックス付きイメージ X を表示します。

imshow(filename) は、グラフィックス ファイル filename に格納されたイメージを表示します。ファイルは、現在のディレクトリまたは MATLAB® パスに存在していなければならず、imread または dicomread で読み取ることができるイメージを含んでいなければなりません。imshowimread または dicomread を呼び出してファイルからイメージを読み取りますが、イメージ データを MATLAB ワークスペースに保存することはありません。ファイルが複数のイメージを含む場合、imshow は最初の 1 つのみを表示します。

imshow(___,Name,Value...) は、上記の任意の構文を用いて、1 つまたは複数の Name,Value の引数ペアで追加オプションを指定してイメージを表示します。

imshow(gpuarrayIM,___) は、gpuArray に含まれているイメージを表示します。この構文では Parallel Computing Toolbox™ が必要です。

imshow(I,[low high]) は、表示範囲を 2 要素ベクトル [low high] の形で指定して、グレースケール イメージ I を表示します。詳細は、DisplayRange パラメーターを参照してください。

himage = imshow(___) は、imshow で作成されたイメージ オブジェクトにハンドルを出力します。

すべて展開する

ファイルからのイメージの表示

イメージ ファイルを指定します。

imshow('board.tif')

インデックス付きイメージの表示

インデックス付きイメージおよび関連付けられているカラーマップをファイルから読み取って表示します。

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

グレースケール イメージの表示

グレースケール イメージをファイルから読み取って表示します。

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

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

グレースケール イメージを読み取って、表示範囲を指定します。

I = imread('cameraman.tif');
h = imshow(I,[0 80]);

関連付けられている空間参照オブジェクトを使用したグレースケール イメージの表示

イメージをワークスペースに読み取ります。

I = imread('pout.tif');

入力イメージに関連付けられた空間参照オブジェクトを作成します。次に、ワールド座標系における X および Y の範囲を指定します。

RI = imref2d(size(I));
RI.XWorldLimits = [0 3];
RI.YWorldLimits = [2 5];

空間参照オブジェクトを指定して、イメージを表示します。

imshow(I,RI);

GPU でのイメージの表示

イメージを gpuArray に読み取ります。

X = gpuArray(imread('pout.tif'));

これを表示します。

figure; imshow(X)

入力引数

すべて展開する

I — 入力イメージグレースケール イメージ | RGB イメージ | バイナリ イメージ

入力イメージであり、グレースケール イメージ、RGB イメージまたはバイナリ イメージとして指定されます。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

X — インデックス付きイメージ実数値の 2 次元配列。

インデックス付きイメージであり、実数値の 2 次元配列として指定されます。X の値は Map のインデックスであり、RGB 値の n 行 3 列の配列です。

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

map — カラーマップn 行 3 列の配列

カラーマップであり、n 行 3 列の配列として指定されます。各行が RGB カラーの値を指定します。

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

filename — イメージを含んでいるファイルの名前テキスト文字列

イメージを含んでいるファイルの名前であり、文字列として指定されます。イメージは imread または dicomread によって読み取り可能でなければなりません。imshowimread または dicomread を呼び出してファイルからイメージを読み取りますが、イメージ データを MATLAB ワークスペースに保存することはありません。ファイルが複数のイメージを含んでいる場合、imshow にはファイルの最初のイメージが表示されます。

データ型: char

RI — 入力イメージに関連付けられている 2 次元空間参照オブジェクトimref2d オブジェクト

入力イメージに関連付けられている 2 次元空間参照オブジェクトであり、imref2d オブジェクトとして指定されます。

RX — インデックス付きイメージに関連付けられている 2 次元空間参照オブジェクトimref2d オブジェクト

インデックス付きイメージに関連付けられている 2 次元空間参照オブジェクトであり、imref2d オブジェクトとして指定されます。

gpuarrayIM — GPU (グラフィックス処理装置) で処理されるイメージgpuArray オブジェクト

グラフィックス処理装置 (GPU) で処理されるイメージであり、gpuArray オブジェクトとして指定されます。

[low high] — イメージの表示範囲2 要素ベクトル

イメージの表示範囲であり、2 要素ベクトルとして指定されます。

例: [50 250]

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

名前/値のペアの引数

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

例: ‘Border’,’tight’

'Border' — Figure ウィンドウに境界を含めるかどうかの制御iptgetpref('ImshowBorder') によって返される値 (既定値) | 'tight' または 'loose'

imshow が Figure ウィンドウ内に表示されるイメージに境界線を含めるかどうかを制御します。'tight' または 'loose' になります。イメージが非常に小さい場合や、Figure 内にイメージとその軸以外のオブジェクトがある場合は、境界が残る場合があります。

例:

データ型: char

'Colormap' — Figure の colormap プロパティの値 (既定値) | m 行 3 列の 2 次元実数行列

imshow は、これを使用して Figure の colormap プロパティを設定します。トゥルーカラーではない色でグレースケール イメージを表示するには、このパラメーターを使用してください。空のカラーマップ ([]) を指定すると、imshow はこのパラメーターを無視します。

例:

データ型: double

'DisplayRange' — グレースケール イメージの表示範囲[min(I(:)) max(I(:))] (既定値) | 2 要素ベクトル

グレースケール イメージの表示範囲。2 要素ベクトル [LOW HIGH] として指定します。imshow は値 low (および low より小さい値) を黒で表示し、値 high (および high より大きい値) を白で表示します。その間の値は、既定数のグレー レベルを使用して、中間のグレー階調で表示されます。空行列 ([]) を指定すると、imshow[min(I(:)) max(I(:))] を使用します。つまり、I の最小値を黒として、最大値を白として使用します。

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

例: h = imshow(I,'DisplayRange',[0 80]);

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

'InitialMagnification' — イメージの表示に使用される初期倍率iptgetpref('ImshowInitialMagnification') によって返される値 (既定値) | 数値のスカラー値 | 文字列 'fit'

イメージの表示に使用される初期倍率であり、数値または文字列 ‘fit’ として指定されます。

100 に設定すると、imshow は、100% の倍率 (イメージ ピクセルごとに 1 つのスクリーン ピクセル) でイメージを表示します。'fit' に設定すると、imshow はイメージ全体をウィンドウ内に適合させるようにスケーリングします。

初期表示では、imshow は常にイメージ全体を表示します。倍率の値が、イメージをスクリーン上に表示するには大きすぎる場合、imshow は警告を出力し、スクリーンに適合する最も大きな倍率でイメージを表示します。

'WindowStyle' プロパティが 'docked' に設定されている Figure にイメージが表示される場合、imshow は警告を発生し、Figure に適合する最大の倍率でイメージを表示します。

メモ: Axes の位置を指定すると (subplot または axes を使用)、imshow は、指定されている初期の倍率を無視し、'fit' の動作を既定の設定にします。

'Reduce' パラメーターを使用した場合、初期の倍率として使用されるのは 'fit' のみです。

例:

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | char

'Parent' — イメージ オブジェクトの親である Axesハンドル

イメージ オブジェクトの親である Axes であり、ハンドルとして指定されます。imshow によって作成されます。

    メモ:    Figure および Axes プロパティを制御する GUI を作成する場合、必ず imshow(..., 'Parent', ax) 構文を使用してください。

データ型: function_handle

'Reduce'filename 内のサブサンプル イメージ論理値

filename 内のサブサンプル イメージ。論理値として指定します。TIFF イメージの場合にのみ有効です。非常に大きなイメージの概要を表示する場合、このパラメーターを使用します。

データ型: logical

'Xdata' — 既定ではない空間座標系の X 軸上の範囲2 要素ベクトル

既定ではない空間座標系の X 軸上の範囲であり、2 要素ベクトルとして指定されます。イメージ XData を指定することにより、既定ではない空間座標系を設定します。値は、2 要素以上を設定することもできますが、実際には、最初と最後の要素しか使用されません。

例: [100 200]

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

'YData' — 既定ではない空間座標系の Y 軸上の範囲2 要素ベクトル

既定ではない空間座標系の Y 軸上の範囲であり、2 要素ベクトルとして指定されます。値は、2 要素以上を設定することもできますが、実際には、最初と最後の要素しか使用されません。

例: [100 200]

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

出力引数

すべて展開する

himageimshow によって作成されるイメージ オブジェクトハンドル

imshow によって作成されるイメージ オブジェクトであり、ハンドルとして指定されます。

代替機能

アプリケーション

imshow は、イメージ表示のための Figure、Axes、および image オブジェクトのプロパティを最適化するためのツールボックスの基本のイメージ表示関数です。imtool によって、imshow によるイメージ表示が可能になりますが、ピクセル領域ツール、イメージ情報ツール、コントラスト調整ツールのような、イメージのナビゲートや調査のためのさまざまな他のツールへのアクセスも可能になります。imtool は、イメージの表示といくつかの共通の画像処理の作業を行うための統合された環境を与えます。

MATLAB を -nojvm オプションで開始した場合、関数 imshow はサポートされません。

imshow には、アイコン で表されるプロット セレクターのワークスペース ツールを使用して、アクセスします。 。ワークスペースでは、表示するデータを選択します。プロット セレクター アイコンの表示が に変わります。[Image Processing Toolbox プロット] まで下方向にスクロールします。imshow(I) を選択します。

詳細

すべて展開する

ヒント

  • 関数 iptsetpref を使用して、imshow の動作を変更する複数のツールボックスの設定を指定できます。

    • 'ImshowBorder' は、imshow の周囲に境界線をもつイメージを表示するかどうかを制御します。

    • 'ImshowAxesVisible' は、imshow が Axes のボックスや目盛りラベルと共にイメージを表示するかどうかを制御します。

    • 'ImshowInitialMagnification' は、imshow(...,'InitialMagnification',initial_mag) を指定して、特定の呼び出しでオーバーライドするまで、イメージ表示の初期の倍率を制御します。

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

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