imfinfo

有关图形文件的信息

全页折叠

语法

info = imfinfo(filename)

info = imfinfo(filename,fmt)

说明

示例

info = imfinfo(filename) 返回一个结构体，该结构体的字段包含有关图形文件 filename 中的图像的信息。

此文件的格式从其内容推知。

如果 filename 为包含多个图像的 TIFF、PGM、PBM、PPM、HDF、ICO、GIF、SVS 或 CUR 文件，则 info 为一个结构体数组，其中每个元素对应文件中的一个图像。例如，info(3) 将包含文件中第三个图像的相关信息。

info = imfinfo(filename,fmt) 在 MATLAB^® 找不到名为 filename 的文件时另外查找名为 filename.fmt 的文件。

示例

全部折叠

返回有关图形文件的信息

打开实时脚本

查找有关示例图像 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` — 图形文件名
字符向量 | 字符串标量

图形文件的名称，指定为字符向量或字符串标量。

根据文件的位置，filename 可以采用下列形式之一。

位置

形式

当前文件夹或 MATLAB 路径上的文件夹

指定 filename 中文件的名称。

示例：'myImage.jpg'

文件夹中的文件

如果该文件不在当前文件夹或 MATLAB 路径下的文件夹中，则指定完整或相对路径名。

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

示例：'\imgDir\myImage.ext'

URL

如果文件是通过 Internet URL 定位的，则 filename 必须包含协议类型，例如 http://。

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

远程位置

如果文件存储在远程位置，则 filename 必须包含指定为统一资源定位器 (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` — 图像格式
字符向量 | 字符串标量

图像格式，指定为字符向量或字符串标量。fmt 的可能值包含在 MATLAB 文件格式注册表中。要查看这些格式的列表，请运行 imformats 命令。

示例： 'gif'

数据类型： char | string

输出参数

全部折叠

`info` — 有关图形文件的信息
结构体数组

有关图形文件的信息，以结构体数组形式返回。info 中的字段集取决于单个文件及其格式。下表描述了该结构数组始终包含的九个字段。

字段名称	描述	值
`Filename`	文件名或指定的 Internet URL。如果文件不在当前文件夹中，该字符向量将包含文件的完整路径名。	字符向量
`FileModDate`	上次修改文件的日期。	字符向量
`FileSize`	文件大小（以字节为单位）。	整数
`Format`	文件格式，由 `fmt` 指定。对于具有多个可能的扩展名的格式（例如 JPEG 和 TIFF 文件），`imfinfo` 返回文件格式注册表中的第一个变体。	字符向量
`FormatVersion`	文件格式版本。	字符向量或数字
`Width`	图像宽度（以像素为单位）。	整数
`Height`	图像高度（以像素为单位）。（有关 BMP 文件的其他详细信息，请参阅提示。）	整数
`BitDepth`	每像素位数。	整数
`ColorType`	图像类型。`ColorType` 包括但不限于：用于真彩色 (RGB) 图像的 `'truecolor'`、用于灰阶强度图像的 `'grayscale'` 或用于索引图像的 `'indexed'`。	字符向量

某些文件格式返回的其他字段：

仅限 JPEG、DNG 和 TIFF - 如果 filename 包含可交换图像文件格式 (EXIF) 标记，则 info 还可能包含 'DigitalCamera' 或 'GPSInfo'（全球定位系统信息）字段。
仅限 GIF - imfinfo 返回 'DelayTime' 字段的值（以百分之一秒为单位）。
仅限 JPEG2000 - info 结构体包含一个 m×3 元胞数组 'ChannelDefinition'。'ChannelDefinition' 的第一列报告文件中存在的通道的位置。第二列报告通道类型，第三列报告通道映射。
DNG only - imfinfo 以输出结构体中的各个命名字段返回属于 Adobe^® DNG 文件版本 1.2 到 1.5 的标记。有关 DNG 文件标记的完整列表，请参阅 Adobe Digital Negative (DNG) Specification 的第 4 章。

提示

当您使用 imfinfo 获取有关 Adobe DNG 文件的信息时，它会返回 info 结构体的 'Height' 和 'Width' 字段中预览图像的图像维度。
当您使用 imfinfo 获取有关 BMP 文件的信息时，它会返回一个 info 结构体，该结构体可以包含负的 'Height' 值。负值表示图像的原点在其左上角。在这种情况下，以像素为单位的图像的实际高度是 'Height' 值的绝对值。