ドキュメンテーション

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

imfinfo

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

構文

  • info = imfinfo(filename)
  • info = imfinfo(filename,fmt)
  • info = imfinfo(URL)

説明

info = imfinfo(filename) は、グラフィックス ファイル filename 内のイメージに関する情報を含むフィールドをもつ構造体を返します。ファイルは、現在のフォルダーまたは MATLAB® パス上のフォルダーになければなりません。

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

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

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

info = imfinfo(URL) は、指定されたインターネット リソース URL にあるイメージに関する情報を返します。

すべて展開する

グラフィックス ファイルに関する情報を返す

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

info = imfinfo('ngc6543a.jpg')
info = 

           Filename: 'matlabroot\toolbox\matlab\demos\ngc6543a.jpg'
        FileModDate: '01-Oct-1996 16:19:44'
           FileSize: 27387
             Format: 'jpg'
      FormatVersion: ''
              Width: 600
             Height: 650
           BitDepth: 24
          ColorType: 'truecolor'
    FormatSignature: ''
    NumberOfSamples: 3
       CodingMethod: 'Huffman'
      CodingProcess: 'Sequential'
            Comment: {'CREATOR: XV Version 3.00b  Rev: 6/15/94  Quality = 75, Smoothing = 0
'}

入力引数

すべて展開する

filename — グラフィックス ファイルの名前文字列

グラフィックス ファイルの名前。文字列として指定します。

例: 'myImage.jpg'

データ型: char

fmt — イメージ形式文字列

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

例: 'gif'

データ型: char

URL — イメージの場所文字列

イメージの場所。文字列として指定します。URL には、プロトコル タイプ (http:// など) を含めなければなりません。

データ型: char

出力引数

すべて展開する

info — グラフィックス ファイルの情報構造体配列

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

フィールド名

説明

Filename

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

文字列

FileModDate

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

文字列

FileSize

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

整数

Format

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

文字列

FormatVersion

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

文字列または数値

Width

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

整数

Height

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

整数

BitDepth

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

整数

ColorType

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

文字列

一部のファイル形式では次のフィールドも返されます。

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

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

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

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