本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

imfinfo

有关图形文件的信息

说明

示例

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

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

  • 如果 filename 为包含多个图像的 TIFF、PGM、PBM、PPM、HDF、ICO、GIF 或 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 Storagewasb, 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

图像高度(以像素为单位)。

整数

BitDepth

每像素位数。

整数

ColorType

图像类型。ColorType 包括但不限于:用于真彩色 (RGB) 图像的 'truecolor'、用于灰阶强度图像的 'grayscale' 或用于索引图像的 'indexed'

字符向量

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

  • 仅限 JPEG 和 TIFF - 如果 filename 包含可交换图像文件格式 (EXIF) 标记,则 info 还可能包含 'DigitalCamera''GPSInfo'(全球定位系统信息)字段。

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

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

另请参阅

| |

在 R2006a 之前推出