imfinfo
グラフィックス ファイルの情報
説明
例
グラフィックス ファイルに関する情報を返す
サンプル イメージ ngc6543a.jpg
に関する情報を検索します。
info = imfinfo('ngc6543a.jpg');
info
構造体には、次の情報フィールドが含まれます。Filename
、FileModDate
、FileSize
、Format
、FormatVersion
、Width
、Height
、BitDepth
、ColorType
、FormatSignature
、NumberOfSamples
、CodingMethod
、CodingProcess
および Comment
。
構造体から情報 (たとえば、CodingMethod
) を表示するには、コマンド ウィンドウに info.CodingMethod
と入力します。
info.CodingMethod
ans = 'Huffman'
構造体のすべてのプロパティを表示するには、コマンド ウィンドウに info
と入力します。
入力引数
filename
— グラフィックス ファイルの名前
文字ベクトル | string スカラー
グラフィックス ファイルの名前。文字ベクトルまたは string スカラーとして指定します。
ファイルの場所に応じて、filename
は次のいずれかの形式にできます。
場所 | 形式 | ||||||||
---|---|---|---|---|---|---|---|---|---|
現在のフォルダー、または MATLAB パス上のフォルダー | ファイル名を 例: | ||||||||
フォルダー内のファイル | ファイルが現在のフォルダーまたは MATLAB パス上のフォルダーにない場合は、絶対パス名または相対パス名を指定します。 例: 例: | ||||||||
URL | ファイルがインターネット URL にある場合、 例: | ||||||||
リモートの場所 | リモートの場所に保存されたファイルの場合、
リモートの場所に基づいて、
詳細については、リモート データの操作を参照してください。 例: |
データ型: char
| string
fmt
— イメージ形式
文字ベクトル | string スカラー
イメージ形式。文字ベクトルまたは string スカラーとして指定します。fmt
の可能な値は、MATLAB ファイル形式レジストリに含まれています。これらの形式を表示するには、imformats
コマンドを実行します。
例: 'gif'
データ型: char
| string
出力引数
info
— グラフィックス ファイルの情報
構造体配列
グラフィックス ファイルの情報。構造体配列として返されます。info
のフィールドの設定は、個々のファイルとその形式に依存します。次の表で、常に含まれる 9 個のフィールドを説明します。
フィールド名 | 説明 | 値 |
---|---|---|
| 指定されたファイル名またはインターネット URL。ファイルが現在のフォルダーにない場合、文字ベクトルにはファイルの絶対パス名が含まれます。 | 文字ベクトル |
| ファイルが最後に変更された日付。 | 文字ベクトル |
| ファイルのサイズ (バイト単位)。 | 整数 |
|
| 文字ベクトル |
| ファイル形式のバージョン。 | 文字ベクトルまたは数値 |
| イメージの幅 (ピクセル単位)。 | 整数 |
| イメージの高さ (ピクセル単位)。(BMP ファイルの詳細については、ヒントを参照してください。) | 整数 |
| ピクセルあたりのビット数。 | 整数 |
| イメージの種類。 | 文字ベクトル |
一部のファイル形式では追加のフィールドが含まれます。
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 より前に導入R2023a: JPEG ファイルに埋め込まれた Extensible Metadata Platform (XMP) メタデータに関する情報の取得
関数 imfinfo
は、出力構造体の 'XMPData'
フィールドで、JPEG ファイルに埋め込まれた XMP メタデータを返します。この関数は、XMP 名前空間に埋め込まれた International Press Telecommunications Council (IPTC) メタデータも返します。IPTC データは、'XMPData'
の 'Iptc4xmpCore'
(コア メタデータ) および 'Iptc4xmpExt'
(拡張メタデータ) サブフィールドに保存されます。
R2021a: Adobe Digital Negative (DNG) タグに関する情報の取得
関数 imfinfo
は、version 1.5 以下に属する DNG ファイル タグに関する情報を出力構造体で個々の名前付きフィールドとして返します。以前、version 1.2 ~ 1.5 に属している DNG ファイル タグに関する情報は出力構造体の 'UnknownTags'
フィールドに保存されていました。
R2019b: 出力に PGM、PBM、および PPM ファイルからの複数のイメージに関する情報が含まれる
PGM、PBM、または PPM ファイルに複数のイメージが存在する場合、imfinfo
は、複数のイメージの情報が格納された構造体配列を返すようになりました。以前、imfinfo
は、最初のイメージの情報のみが格納されている 1 行 1 列の構造体を返していました。
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)