Exponenta Banner
exponenta event banner

imfinfo

Сведения о графическом файле

свернуть все на странице

Синтаксис

info = imfinfo (имя файла)
info = imfinfo (имя файла, fmt)

Описание

пример

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

scheme_name://path_to_file/my_file.ext

На основе удаленного местоположения, scheme_name может быть одним из значений в этой таблице.

Удаленное расположениеscheme_name
Амазонский S3™s3
Хранилище больших двоичных объектов Windows Azure ®wasb, 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' для изображения truecolor (RGB), 'grayscale' для изображения интенсивности в градациях серого или 'indexed' для индексированного изображения.

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

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

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

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

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

  • Только DNG - imfinfo возвращает теги, принадлежащие файлам Adobe ® DNG версий 1.2-1.5, в виде отдельных именованных полей в структуре вывода. Полный список тегов файлов DNG см. в главе 4 спецификации Adobe Digital Negative (DNG).

Совет

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

См. также

| | | (Панель инструментов обработки изображений)

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

Документация MATLAB

Поддержка