MATLAB 图像文件信息读取函数 imfinfo 详解
在 MATLAB 中,imfinfo 函数用于检索图形文件的各种属性和元数据。该函数能够识别多种标准图像格式,并返回包含文件详细信息的结构体。
函数语法
fileMetadata = imfinfo(filename)
fileMetadata = imfinfo(filename, fmt)
基本说明
fileMetadata = imfinfo(filename):返回一个包含指定文件信息的结构体。MATLAB 会根据文件内容自动推断格式。如果文件是包含多帧图像的格式(如多页 TIFF、GIF、ICO 或 CUR),则返回结构体数组,每个元素对应一帧图像。fileMetadata = imfinfo(filename, fmt):如果 MATLAB 无法直接通过文件名找到文件,它会尝试寻找名为filename.fmt的文件。
代码示例
以下示例展示了如何获取内置示例图像 peppers.png 的属性信息:
% 获取图像元数据
imgDetails = imfinfo('peppers.png');
% 访问特定的元数据字段
pixelWidth = imgDetails.Width;
pixelHeight = imgDetails.Height;
colorSpace = imgDetails.ColorType;
fprintf('图像宽度: %d 像素\n', pixelWidth);
fprintf('图像高度: %d 像素\n', pixelHeight);
fprintf('颜色类型: %s\n', colorSpace);
执行 imfinfo 后返回的结构体通常包含 Filename(文件名)、FileSize(文件大小)、Format(格式)、BitDepth(位深)以及 ColorType(如 'truecolor' 或 'grayscale')等核心字段。
输入参数
| 参数名称 | 描述 |
|---|---|
filename |
图形文件名,支持字符向量或字符串。可以包含绝对路径、相对路径或 URL(如 http://)。对于存储在远程云端(如 Amazon S3 或 Azure Blob)的数据,需提供完整的 URI。 |
fmt |
图像格式描述。可以通过 imformats 命令查看 MATLAB 支持的所有格式列表。 |
常见返回值字段
返回的结构体字段内容会根据文件格式有所不同,但以下字段通常是共有的:
- Filename: 文件的完整路径或 URL。
- FileModDate: 文件最后一次修改的日期。
- FileSize: 以字节(Bytes)为单位的文件大小。
- Format: 检测到的文件格式(如 'png', 'jpg', 'tiff')。
- Width / Height: 图像的宽度和高度(单位:像素)。
- BitDepth: 图像中每个像素的位数。
- ColorType: 颜色表现形式,常见的有
'truecolor'(RGB)、'grayscale'(灰度) 或'indexed'(索引图)。
特定格式的附加信息
- TIFF 与 JPEG: 若图像包含 EXIF 数据,可能会额外包含
DigitalCamera或GPSInfo字段。 - GIF: 会包含
DelayTime字段,用于指示各帧之间的延迟(单位:百分之一秒)。 - JPEG2000: 会提供
ChannelDefinition元胞数组,描述通道位置、类型及其映射关系。