Exponenta Banner

imfinfo

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

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

Синтаксис

info = imfinfo(filename)
info = imfinfo(filename,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.

Примеры

свернуть все

Открыть Live Script

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

info = imfinfo('ngc6543a.jpg');

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

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

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

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

Совет

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

См. также

| | | (Image Processing Toolbox)

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

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

Поддержка