Main Content

imfinfo

有关图形文件的信息

说明

示例

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 结构体包含以下信息字段:FilenameFileModDateFileSizeFormatFormatVersionWidthHeightBitDepthColorTypeFormatSignatureNumberOfSamplesCodingMethodCodingProcessComment

要显示结构体中的信息,例如 CodingMethod,请在命令行窗口中键入 info.CodingMethod

info.CodingMethod
ans = 
'Huffman'

要显示结构体中的所有属性,请在命令行窗口中键入 info

输入参数

全部折叠

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

根据文件的位置,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 存储wasb, wasbs
HDFS™hdfs

有关详细信息,请参阅处理远程数据

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

数据类型: char | string

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

示例: 'gif'

数据类型: char | string

输出参数

全部折叠

有关图形文件的信息,以结构体数组形式返回。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'(全球定位系统信息)字段。

  • 仅限 JPEG - 如果 filename 包含嵌入式可扩展元数据平台 (XMP) 元数据,则 info 包含 'XMPData' 字段。如果 filename 的 XMP 元数据包含国际新闻电信理事会 (IPTC) 数据,则此数据位于 'XMPData' 字段的 'Iptc4xmpCore'(核心元数据)和 'Iptc4xmpExt'(扩展元数据)子字段中。

  • 仅限 GIF - imfinfo 返回 'DelayTime' 字段的值(以百分之一秒为单位)。

  • 仅限 JPEG2000 - info 结构体包含一个 m×3 元胞数组 'ChannelDefinition''ChannelDefinition' 的第一列报告文件中存在的通道的位置。第二列报告通道类型,第三列报告通道映射。

  • 仅限 DNG - imfinfo 以输出结构体中的各个命名字段返回属于 Adobe® DNG 文件版本 1.5 及之前版本的标记。有关 DNG 文件标记的完整列表,请参阅 Adobe Digital Negative (DNG) Specification 的第 4 章。

提示

  • 当您使用 imfinfo 获取有关 Adobe DNG 文件的信息时,它会返回 info 结构体的 'Height''Width' 字段中预览图像的图像维度。

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

版本历史记录

在 R2006a 之前推出

全部展开

另请参阅

| | | (Image Processing Toolbox)