imread

A = imread(filename) は、filename で指定されたファイルの形式をコンテンツから推定して、そのファイルからイメージを読み取ります。filename が複数のイメージを含むファイルである場合、imread はファイルの最初のイメージを読み取ります。

A = imread(filename,fmt) ではさらに、fmt で示す標準のファイル拡張子でファイルの形式を指定します。filename で指定された名前のファイルを見つけることができない場合、imread は名前が filename.fmt のファイルを検索します。

A = imread(___,idx) は、複数のイメージを含むファイルから、指定された 1 つ以上のイメージを読み取ります。この構文は、GIF、PGM、PBM、PPM、CUR、ICO、TIF、SVS および HDF4 のファイルにのみ適用されます。filename の入力は必須であり、オプションで fmt を指定できます。

A = imread(___,Name,Value) は、前述の構文の入力引数のいずれかに加え、1 つ以上の名前と値のペアの引数を使用して、形式に固有のオプションを指定します。

[A,map] = imread(___) は filename のインデックス付きイメージを A、その関連カラーマップを map に読み取ります。イメージファイルのカラーマップ値は、自動的に、範囲 [0,1] に再スケーリングされます。

[A,map,transparency] = imread(___) はさらに、イメージの透明度を返します。この構文は、PNG、CUR および ICO のファイルにのみ適用されます。PNG ファイルの場合、transparency はアルファチャネルです (存在する場合)。CUR および ICO のファイルの場合、これは AND (不透明性) マスクです。

例

イメージの読み取りと表示

サンプルイメージを読み取ります。

A = imread('ngc6543a.jpg');

imread は、650×600×3 の配列 A を返します。

イメージを表示します。

image(A)

Figure contains an axes object. The axes object contains an object of type image.

インデックス付きイメージを RGB に変換

サンプルのインデックス付きイメージファイル corn.tif の最初のイメージを読み取ります。

[X,cmap] = imread('corn.tif');

インデックス付きイメージ X は、uint8 型の 415 行 312 列の配列です。カラーマップ cmap は double 型の 256 行 3 列の行列であるため、インデックス付きイメージには 256 色あります。イメージを表示します。

imshow(X,cmap)

Figure contains an axes object. The axes object contains an object of type image.

インデックス付きイメージを RGB イメージに変換します。結果は double 型の 415×312×3 の配列になります。

RGB = ind2rgb(X,cmap);

RGB イメージの値が範囲 [0, 1] 内にあることを確認します。

disp(['Range of RGB image is [',num2str(min(RGB(:))),', ',num2str(max(RGB(:))),'].'])

Range of RGB image is [0.0078431, 0.97647].

マルチページ TIFF ファイルの特定のイメージの読み取り

サンプルファイル corn.tif の 3 番目のイメージを読み取ります。

[X,map] = imread('corn.tif',3);

PNG イメージのアルファチャネルを返す

サンプルイメージ peppers.png のアルファチャネルを返します。

[X,map,alpha] = imread('peppers.png');
whos alpha

  Name       Size            Bytes  Class     Attributes

  alpha      0x0                 0  double

アルファチャネルが存在しないため、alpha は空です。

TIFF イメージの指定された領域を読み取る

サンプルイメージ corn.tif の特定のピクセル領域を読み取ります。

読み取る領域の境界を示すベクトルの cell 配列で 'PixelRegion' パラメーターを指定します。最初のベクトルでは読み取る行の範囲を指定し、2 番目のベクトルでは読み取る列の範囲を指定します。

A = imread('corn.tif','PixelRegion',{[1,2],[2,5]});

imread は、corn.tif から行 1 ～ 2、列 2 ～ 5 のイメージデータを読み取り、2 行 4 列の配列 A を返します。

入力引数

`filename` — グラフィックスファイルの名前
文字ベクトル | string スカラー

グラフィックスファイルの名前。文字ベクトルまたは string スカラーとして指定します。

ファイルの場所によって、filename は次のいずれかの形式をとります。

場所

形式

現在のフォルダー、または MATLAB^® パス上のフォルダー

ファイル名を filename で指定します。

例: 'myImage.jpg'

フォルダー内のファイル

ファイルが現在のフォルダーまたは MATLAB パス上のフォルダーにない場合は、絶対パス名または相対パス名を指定します。

例: 'C:\myFolder\myImage.ext'

例: '\imgDir\myImage.ext'

URL

ファイルがインターネット URL にある場合、filename には http:// などのプロトコルタイプが含まれていなければなりません。

例: 'http://hostname/path_to_file/my_image.jpg'

リモートの場所

リモートの場所に保存されたファイルの場合、filename は次の形式の Uniform Resource Locator (URL) として指定されたファイルの絶対パスを含まなければなりません。

scheme_name://path_to_file/my_file.ext

リモートの場所に基づいて、scheme_name には次の表の値のいずれかを指定できます。

リモートの場所	`scheme_name`
Amazon S3™	`s3`
Windows Azure^® Blob Storage	`wasb`, `wasbs`
HDFS™	`hdfs`

詳細については、リモートデータの操作を参照してください。

例: 's3://bucketname/path_to_file/my_image.jpg'

それぞれのファイルの種類でサポートされるビット深度、圧縮方式および色空間は、アルゴリズムを参照してください。

データ型: char | string

`fmt` — イメージ形式
文字ベクトル | string スカラー

イメージ形式。標準のファイル拡張子を示す文字ベクトルまたは string スカラーとして指定します。サポートする形式とそのファイル拡張子の一覧を表示するには、imformats を呼び出します。

例: 'png'

データ型: char | string

`idx` — 読み取るイメージ
整数値スカラー | 整数のベクトル

読み取るイメージ。整数スカラー、GIF ファイルの場合は整数ベクトルとして指定します。たとえば、idx が 3 の場合、関数 imread は、ファイルの 3 番目のイメージを返します。GIF ファイルで idx が 1:5 の場合、imread は最初の 5 フレームのみを返します。引数 idx は、複数のイメージを含む GIF、CUR、ICO および HDF4 のファイルでのみサポートされています。

1 つの GIF ファイルから複数のフレームを読み取る場合は、idx をフレームのベクトルとして指定するか、名前と値のペアの引数 'Frames','all' を使用します。GIF ファイルの構造的な仕組みにより、これらの構文を使用すると、ループ内で imread を呼び出すよりも高速のパフォーマンスが得られます。

HDF4 ファイルの場合、idx は読み取るイメージの参照番号に対応します。参照番号は、必ずしもファイル内のイメージの順番と対応しません。関数 imfinfo を使用すると、イメージの順番と参照番号を対応付けることができます。

例: 3

データ型: double

名前と値の引数

引数のオプションのペアを Name1=Value1,...,NameN=ValueN として指定します。ここで Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は重要ではありません。

R2021a より前では、コンマを使用してそれぞれの名前と値を区切り、Name を引用符で囲みます。

例: 'Index',5 は、TIFF ファイルの 5 番目のイメージを読み取ります。

GIF ファイル

`Frames` — 読み取るフレーム
1 (既定値) | 正の整数 | 整数のベクトル | `'all'`

読み取るフレーム。'Frames' と、正の整数、整数ベクトルまたは 'all' からなるコンマ区切りのペアとして指定します。たとえば、3 を指定した場合、imread はファイルの 3 番目のフレームを読み取ります。'all' を指定した場合、imread はすべてのフレームをファイル内の順序で読み取って返します。

例: 'frames',5

JPEG 2000 ファイル

`PixelRegion` — 読み取るサブイメージ
`{rows,cols}` の形式の cell 配列

読み取るサブイメージ。'PixelRegion' と、{rows,cols} の形式をもつ cell 配列とで構成されるコンマ区切りのペアとして指定します。rows の入力は、読み取る行の範囲を指定します。cols の入力は、読み取る列の範囲を指定します。rows と cols は両方とも、1 ベースのインデックスを含む 2 要素ベクトルでなければなりません。たとえば、'PixelRegion',{[1 2],[3 4]} は、イメージデータ内の第 1 行と第 2 行、第 3 列と第 4 列で囲まれたサブイメージを読み取ります。'ReductionLevel' の値が 0 より大きい場合、rows と cols がサブイメージの座標です。

例: 'PixelRegion',{[1 100],[4 500]}

`ReductionLevel` — イメージ解像度の低減
0 (既定値) | 非負の整数

イメージ解像度の低減。'ReductionLevel' と非負の整数で構成されるコンマ区切りのペアとして指定します。低減レベルが L の場合、イメージの解像度は 2^L の係数で低減されます。低減レベルは、関数 imfinfo の出力の 'WaveletDecompositionLevels' フィールドで指定された分解レベルの総数によって制限されます。

例: 'ReductionLevel',5

データ型: single | double

`V79Compatible` — MATLAB 7.9 (R2009b) 以前との互換性
`false` (既定値) | `true`

MATLAB 7.9 (R2009b) 以前との互換性。'V79Compatible' と、true または false のいずれかとで構成されるコンマ区切りのペアとして指定します。true を指定した場合、返されるグレースケールまたは RGB のイメージは、旧バージョンの imread (MATLAB 7.9 (R2009b) 以前) と互換性をもちます。

例: 'V79Compatible',true

データ型: logical

PNG ファイル

`BackgroundColor` — 背景色
`'none'` | 整数 | 整数の 3 要素ベクトル

背景色。'none'、整数、あるいは整数の 3 要素ベクトルとして指定します。BackgroundColor が 'none' の場合、imread は合成を実行しません。それ以外の場合、imread は透明ピクセルに背景色をブレンドします。

入力イメージがインデックス付きの場合、BackgroundColor の値は、範囲 [1,P] の整数でなければなりません。ここで、P は、カラーマップの長さです。
入力イメージがグレースケールの場合、BackgroundColor の値は、範囲 [0,1] の整数でなければなりません
入力イメージが RGB の場合、BackgroundColor の値は範囲 [0,1] の 3 要素ベクトルでなければなりません。

BackgroundColor の既定値は、出力引数 transparency の有無およびイメージの種類によって異なります。

出力引数 transparency を要求した場合、BackgroundColor の既定値は 'none' です。
transparency の出力を要求せず、PNG ファイルに背景色チャンクが含まれる場合、この色は BackgroundColor の既定値になります。
transparency の出力を要求せず、ファイルに背景色チャンクが含まれない場合、BackgroundColor の既定値は、インデックス付きイメージでは 1、グレースケールイメージでは 0、トゥルーカラー (RGB) イメージでは [0 0 0] になります。

TIFF ファイル

`Index` — 読み取るイメージ
1 (既定値) | 正の整数

読み取るイメージ。'Index' と正の整数で構成されるコンマ区切りのペアとして指定します。たとえば、Index の値が 3 の場合、imread はファイルの 3 番目のイメージを読み取ります。

データ型: single | double

`Info` — イメージに関する情報
構造体配列

イメージに関する情報。'Info' と、関数 imfinfo から返された構造体配列とで構成されるコンマ区切りのペアとして指定します。名前と値のペアの引数 Info を使用すると、複数のイメージを含む TIFF ファイルから imread がより高速にイメージを検出できるようになります。

データ型: struct

`PixelRegion` — 領域の境界
cell 配列

領域の境界。'PixelRegion' と、{rows,cols} の形式をもつ cell 配列とで構成されるコンマ区切りのペアとして指定します。rows の入力は、読み取る行の範囲を指定します。cols の入力は、読み取る列の範囲を指定します。rows と cols は、1 ベースのインデックスをもつ 2 要素ベクトルまたは 3 要素ベクトルのいずれかでなければなりません。読み取りの最初と最後の行または列は、2 要素ベクトルで指定します。たとえば、'PixelRegion',{[1 2],[3 4]} は、イメージデータ内の第 1 行と第 2 行、第 3 列と第 4 列で囲まれた領域を読み取ります。

3 要素ベクトルは、[start increment stop] の形式でなければなりません。ここで、start は読み取る最初の行または列、increment は増分値、stop は読み取る最後の行または列です。この構文を使用すると、イメージのダウンサンプリングができます。たとえば、'PixelRegion',{[1 2 10],[4 3 12]} は、第 1 行と第 10 行、第 4 列と第 12 列で囲まれた領域を読み取り、垂直方向は 2 ピクセルごと、水平方向は 3 ピクセルごとにデータをサンプリングします。

例: 'PixelRegion',{[1 100],[4 500]}

データ型: cell

出力引数

`A` — イメージデータ
配列

イメージデータ。配列として返されます。

ファイルにグレースケールイメージが含まれる場合、A は m 行 n 列の配列です。
ファイルにインデックス付きイメージが含まれる場合、A は map 内の色のインデックスに対応するインデックス値からなる m 行 n 列の配列です。
ファイルにトゥルーカラーイメージが含まれる場合、A は m×n×3 の配列です。
ファイルが TIFF ファイルで、CMYK 色空間を使用するカラーイメージを含む場合、A は m ×n×4 の配列です。

A のクラスは、イメージの形式と、イメージデータのビット深度によって異なります。詳細については、アルゴリズムを参照してください。

`map` — カラーマップ
`m` 行 3 列の行列

A 内のインデックス付きイメージデータに関連付けられたカラーマップ。クラス double の m 行 3 列の行列として返されます。

`transparency` — 透明度の情報
行列

透明度の情報。行列として返されます。PNG ファイルの場合、transparency はアルファチャネルです (存在する場合)。アルファチャネルが存在しない場合や、名前と値のペアの引数 'BackgroundColor' を指定した場合、transparency は空になります。CUR および ICO のファイルの場合、transparency は AND マスクです。カーソルファイルの場合、このマスクには使用可能なデータのみが含まれることがあります。

詳細

ビット深度

ビット深度は、各イメージのピクセルを表すために使われるビット数です。

ビット深度は、サンプル単位のビットとピクセル単位のサンプルを乗算することで計算されます。そのため、各色要素 (またはサンプル) に 8 ビットおよびピクセルあたり 3 サンプルを使用する形式のビット深度は 24 になります。場合によっては、ビット深度に関連するサンプルサイズがあいまいなことがあります。たとえば、48 ビットのビット深度は、6 つの 8 ビットサンプル、4 つの 12 ビットサンプル、 3 つの 16 ビットサンプルのすべてに該当します。このあいまいさを避けるためのサンプルサイズの情報は、アルゴリズムを参照してください。

アルゴリズム