Main Content

imfinfo

グラフィックス ファイルの情報

説明

info = imfinfo(filename) は、グラフィックス ファイル filename 内のイメージに関する情報を含むフィールドをもつ構造体を返します。

ファイルの形式は、ファイルの内容から推測されます。

  • filename が複数のイメージを含む TIFF、PGM、PBM、PPM、HDF、ICO、GIF、SVS または CUR ファイルの場合、info はファイル内のイメージごとに 1 つの要素を含む構造体配列です。たとえば、info(3) は、ファイルの 3 番目のイメージの情報を含みます。

info = imfinfo(filename,fmt) は、MATLAB®filename という名前のファイルを見つけられない場合、filename.fmt という拡張子を付けた名前のファイルをさらに検索します。

すべて折りたたむ

サンプル イメージ ngc6543a.jpg に関する情報を検索します。

info = imfinfo('ngc6543a.jpg');

info 構造体には、次の情報フィールドが含まれます。FilenameFileModDateFileSizeFormatFormatVersionWidthHeightBitDepthColorTypeFormatSignatureNumberOfSamplesCodingMethodCodingProcess および Comment

構造体から情報 (たとえば、CodingMethod) を表示するには、コマンド ウィンドウに info.CodingMethod と入力します。

info.CodingMethod
ans = 
'Huffman'

構造体のすべてのプロパティを表示するには、コマンド ウィンドウに info と入力します。

入力引数

すべて折りたたむ

グラフィックス ファイルの名前。文字ベクトルまたは 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 Storagewasb, wasbs
HDFS™hdfs

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

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

データ型: char | string

イメージ形式。文字ベクトルまたは string スカラーとして指定します。fmt の可能な値は、MATLAB ファイル形式レジストリに含まれています。これらの形式を表示するには、imformats コマンドを実行します。

例: 'gif'

データ型: char | string

出力引数

すべて折りたたむ

グラフィックス ファイルの情報。構造体配列として返されます。info のフィールドの設定は、個々のファイルとその形式に依存します。次の表で、常に含まれる 9 個のフィールドを説明します。

フィールド名

説明

Filename

指定されたファイル名またはインターネット URL。ファイルが現在のフォルダーにない場合、文字ベクトルにはファイルの絶対パス名が含まれます。

文字ベクトル

FileModDate

ファイルが最後に変更された日付。

文字ベクトル

FileSize

ファイルのサイズ (バイト単位)。

整数

Format

fmt によって指定されたファイル形式。考えられる拡張子が複数ある形式の場合 (JPEG ファイルや TIFF ファイルなど)、imfinfo はファイル形式レジストリに最初に出現する変形バージョンの形式を返します。

文字ベクトル

FormatVersion

ファイル形式のバージョン。

文字ベクトルまたは数値

Width

イメージの幅 (ピクセル単位)。

整数

Height

イメージの高さ (ピクセル単位)。(BMP ファイルの詳細については、ヒントを参照してください。)

整数

BitDepth

ピクセルあたりのビット数。

整数

ColorType

イメージの種類。ColorType は、トゥルーカラー (RGB) イメージの場合は 'truecolor'、グレースケール強度イメージの場合は 'grayscale'、インデックス付きイメージの場合は 'indexed' などを含みます。

文字ベクトル

一部のファイル形式では追加のフィールドが含まれます。

  • JPEG、DNG および TIFF のみfilename に Exchangeable Image File Format (EXIF) タグが含まれている場合、info'DigitalCamera' フィールドや 'GPSInfo' (global positioning system information) フィールドが含まれている可能性があります。

  • JPEG のみfilename に、埋め込まれた Extensible Metadata Platform (XMP) メタデータが含まれている場合、info'XMPData' フィールドが含まれます。filename の XMP メタデータに International Press Telecommunications Council (IPTC) データが含まれている場合、そのデータは 'XMPData' フィールドの 'Iptc4xmpCore' (コア メタデータ) および 'Iptc4xmpExt' (拡張メタデータ) サブフィールドにあります。

  • GIF のみimfinfo'DelayTime' フィールドの値を 1/100 秒の単位で返します。

  • JPEG2000 のみinfo 構造体は、m 行 3 列の cell 配列 'ChannelDefinition' を含みます。'ChannelDefinition' の最初の列は、ファイル内に存在するチャネル位置を示します。2 番目の列はチャネルの種類、3 番目の列はチャネル マッピングをそれぞれ示します。

  • DNG のみimfinfo は、Adobe® DNG ファイル version 1.5 以下に属するタグを出力構造体で個々の名前付きフィールドとして返します。すべての DNG ファイル タグの一覧については、Adobe Digital Negative (DNG) Specification の第 4 章を参照してください。

ヒント

  • imfinfo を使用して Adobe DNG ファイルに関する情報を取得する場合は、プレビュー イメージのイメージ寸法が info 構造体の 'Height' フィールドと 'Width' フィールドに返されます。

  • imfinfo を使用して BMP ファイルに関する情報を取得する場合は、負の 'Height' 値を含むことができる info 構造体が返されます。負の値は、イメージの原点が左上隅にあることを示します。その場合、イメージの実際の高さ (ピクセル単位) は 'Height' 値の絶対値です。

バージョン履歴

R2006a より前に導入

すべて展開する

参考

| | | (Image Processing Toolbox)