imfinfo

Информация о графическом файле

Описание

пример

info = imfinfo(filename) возвращает структуру, поля которой содержат информацию об изображении в графическом файле, filename.

Формат файла выведен из своего содержимого.

  • Если filename TIFF, PGM, PBM, PPM, HDF, ICO, GIF, SVS или файл CUR, содержащий больше чем одно изображение, затем info массив структур с одним элементом для каждого изображения в файле. Например, info(3) содержал бы информацию о третьем изображении в файле.

info = imfinfo(filename,fmt) дополнительно ищет файл с именем filename.fmt, если MATLAB® не может найти файл с именем filename.

Примеры

свернуть все

Найдите информацию об изображении в качестве примера, ngc6543a.jpg.

info = imfinfo('ngc6543a.jpg');

info структура содержит следующие информационные поля: Filename, FileModDate, FileSizeформат, FormatVersionwidthвысотаБитовая глубина, ColorType, FormatSignature, NumberOfSamples, CodingMethod, CodingProcess, и Comment.

Отобразить информацию от структуры, например, CodingMethod, введите info.CodingMethod в Командном окне.

info.CodingMethod
ans = 
'Huffman'

Чтобы отобразить все свойства в структуре, введите info в Командном окне.

Входные параметры

свернуть все

Имя графического файла в виде вектора символов или строкового скаляра.

В зависимости от местоположения файла, filename может взять одну из следующих форм.

Местоположение

Форма

Текущая папка или папка на пути MATLAB

Задайте имя файла в filename.

Пример: 'myImage.jpg'

Файл в папке

Если файл не находится в текущей папке или в папке на пути MATLAB, то задайте полное имя или относительный путь.

Пример: 'C:\myFolder\myImage.ext'

Пример: '\imgDir\myImage.ext'

URL

Если файл расположен Интернетом 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® Blobwasb, wasbs
HDFS™hdfs

Для получения дополнительной информации смотрите работу с Удаленными данными.

Пример: 's3://bucketname/path_to_file/my_image.jpg'

Типы данных: char | string

Формат изображения в виде вектора символов или строкового скаляра. Возможные значения для fmt содержатся в реестре формата файла MATLAB. К представлению списка этих форматов запуститесь imformats команда.

Пример: 'gif'

Типы данных: char | string

Выходные аргументы

свернуть все

Информация о графическом файле, возвращенном как массив структур. Набор полей в info зависит от отдельного файла и его формата. Эта таблица приводит девять полей, которые всегда появляются, и описывает их значения.

Имя поля

Описание

Значение

Filename

Имя файла или Интернета URL задано. Если файл не находится в текущей папке, вектор символов содержит имя полного пути файла.

символьный вектор

FileModDate

Дата, когда файл был в последний раз изменен.

символьный вектор

FileSize

Размер файла, в байтах.

целое число

Format

Формат файла, как задано fmt. Для форматов больше чем с одним возможным расширением (например, JPEG и файлы TIFF), imfinfo возвращает первый вариант в реестре формата файла.

символьный вектор

FormatVersion

Версия формата файла.

вектор символов или номер

Width

Ширина изображения, в пикселях.

целое число

Height

Высота изображения, в пикселях.

целое число

BitDepth

Количество бит на пиксель.

целое число

ColorType

Тип изображения. ColorType включает, но не ограничивается, 'truecolor' для истинного цвета (RGB) изображение, 'grayscale' для полутонового изображения интенсивности или 'indexed' для индексируемого изображения.

символьный вектор

Дополнительные поля возвращены некоторыми форматами файлов:

  • JPEG, DNG, and TIFF only — Если filename содержит Формат Файла обмена изображениями (EXIF) теги, затем info может также содержать 'DigitalCamera' или 'GPSInfo' (информация о системе глобального позиционирования) поля.

  • GIF onlyimfinfo возвращает значение 'DelayTime' поле за сотые части секунд.

  • JPEG2000 onlyinfo структура содержит m-3 массив ячеек, 'ChannelDefinition'. Первый столбец 'ChannelDefinition' сообщает положение канала, когда оно существует в файле. Второй столбец сообщает о типе канала, и третий столбец сообщает об отображении канала.

  • DNG onlyimfinfo возвращает теги, принадлежащие версиям файла Adobe® DNG 1.2 до 1,5 как индивидуум, названный полями в структуре output. Для полного списка тегов файла DNG см. Главу 4 Adobe Digital Negative (DNG) Спецификация.

Советы

  • Когда вы используете imfinfo чтобы получить информацию о файле Adobe DNG, это возвращает размеры изображения изображения предварительного просмотра в 'Height' и 'Width' поля info структура.

Смотрите также

| | | (Image Processing Toolbox)

Представлено до R2006a