ドキュメンテーション

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

imshow

構文

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

説明

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

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

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

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

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

imshow(filename) は、文字ベクトル filename で指定されたグラフィックス ファイルに格納されたイメージを表示します。

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

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

himage = imshow(___) は、imshow で作成された image オブジェクトを返します。

すべて折りたたむ

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

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);

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

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

これを表示します。

figure; imshow(X)

入力引数

すべて折りたたむ

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

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

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

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

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

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

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

データ型: char

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

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

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

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

例: [50 250]

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

名前/値のペアの引数

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

例: 'Border','tight'

すべて折りたたむ

Figure ウィンドウに境界を含めるかどうかの制御。'tight' または 'loose' に指定します。イメージが非常に小さい、または Figure 内の image と axes 以外に他のオブジェクトが存在する場合、境界が残ることがあります。

データ型: char

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

データ型: double

グレースケール イメージの表示範囲。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' パラメーターを指定しなければなりません。

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

イメージの表示に使用される初期倍率。数値スカラーまたは文字ベクトル 'fit' として指定します。

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

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

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

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

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

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

image オブジェクトの親の座標軸。axes オブジェクトとして指定します。これは imshow で作成される座標軸です。

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

イメージのサブサンプリングのインジケーター。truefalse1 または 0 のいずれかに指定します。この引数は TIFF ファイルの名前と共に使用する場合にのみ有効です。非常に大きなイメージの概要を表示するために、Reduce 引数を使用します。

データ型: logical

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

例: [100 200]

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

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

例: [100 200]

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

出力引数

すべて折りたたむ

imshow によって作成されるイメージ オブジェクト。1 つの image オブジェクトとして指定します。

ヒント

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

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

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

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

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

代替機能

アプリ

imshow は、イメージ表示のための figure、axes、および image オブジェクトのプロパティ設定を最適化する基本のイメージ表示関数です。他方のツールボックス表示関数 imtool は、imshow のすべてのイメージ表示機能に加えて、ピクセル領域ツール、イメージ情報ツール、コントラスト調整ツールなど、イメージ内を移動したり調査したりするためのその他のツールを利用することができます。imtool では、イメージの表示といくつかの一般的な画像処理タスクを行うための統合環境が提供されます。

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

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

R2006a より前に導入

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