imfinfo

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

Синтаксис

info = imfinfo(filename)
info = imfinfo(filename,fmt)

Описание

пример

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

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

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

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

Примеры

свернуть все

Найдите информацию об изображении в качестве примера, 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 может взять одну из следующих форм.

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

Форма

Текущая папка или папка на пути 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 должен содержать полный путь файла, заданного как интернационализировавший идентификатор ресурса (IRI) формы:

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 and TIFF only — Если filename содержит Формат Файла обмена изображениями (EXIF) теги, то info может также содержать 'DigitalCamera' или 'GPSInfo' (информация о системе глобального позиционирования) поля.

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

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

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

| |

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