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

A = imread(filename) читает изображение из файла, заданного filename, выведение формата файла от его содержимого. Если filename мультифайл изображения, затем imread читает первое изображение в файле.

A = imread(filename,fmt) дополнительно задает формат файла со стандартным расширением файла, обозначенным fmt. Если imread не может найти файл с именем заданным filename, это ищет файл с именем filename.fmt.

A = imread(___,idx) читает заданное изображение или изображения от мультифайла изображения. Этот синтаксис применяется только к GIF, PGM, PBM, PPM, CUR, ICO, TIF, SVS и файлам HDF4. Необходимо задать filename введите, и можно опционально задать fmt.

A = imread(___,Name,Value) задает параметры формата с помощью одного или нескольких аргументов пары "имя-значение", в дополнение к любому из входных параметров в предыдущих синтаксисах.

[A,map] = imread(___) читает индексируемое изображение в filename в A и читает его связанную палитру в map. Значения палитры в файле изображения автоматически перемасштабируются в область значений [0,1].

[A,map,transparency] = imread(___) дополнительно возвращает прозрачность изображения. Этот синтаксис применяется только к PNG, CUR и файлам ICO. Для файлов PNG, transparency альфа-канал, если вы присутствуете. Для CUR и файлов ICO, это - AND (непрозрачность) маска.

Примеры

Чтение и изображение на дисплее

Считайте демонстрационное изображение.

A = imread('ngc6543a.jpg');

imread возвращает 650 600 3 массивами, A.

Отобразите изображение.

image(A)

Figure contains an axes. The axes contains an object of type image.

Преобразуйте индексируемое изображение в RGB

Читайте первое изображение в выборке индексировало файл изображения, corn.tif.

[X,cmap] = imread('corn.tif');

Индексируемое изображение X 415 312 массив типа uint8. Палитра cmap 256 3 матрица типа double, поэтому существуют 256, раскрашивает индексируемое изображение. Отобразите изображение.

imshow(X,cmap)

Figure contains an axes. The axes contains an object of type image.

Преобразуйте индексируемое изображение в изображение RGB. Результатом являются 415 312 3 массивами типа double.

RGB = ind2rgb(X,cmap);

Проверяйте, что значения изображения RGB находятся в области значений [0, 1].

disp(['Range of RGB image is [',num2str(min(RGB(:))),', ',num2str(max(RGB(:))),'].'])

Range of RGB image is [0.0078431, 0.97647].

Чтение определенного изображения в многостраничном файле TIFF

Считайте третье изображение в файле примера, corn.tif.

[X,map] = imread('corn.tif',3);

Возвратите альфа-канал изображения PNG

Возвратите альфа-канал демонстрационного изображения, peppers.png.

[X,map,alpha] = imread('peppers.png');
whos alpha

  Name       Size            Bytes  Class     Attributes

  alpha      0x0                 0  double

Никакой альфа-канал не присутствует, таким образом, alpha isempty.

Чтение заданной области изображения TIFF

Считайте определенную область пикселей демонстрационного изображения, corn.tif.

Задайте 'PixelRegion' параметр с массивом ячеек векторов, указывающих на контуры области, чтобы читать. Первый вектор указывает диапазон строк, чтобы читать, и второй вектор указывает диапазон столбцов, чтобы читать.

A = imread('corn.tif','PixelRegion',{[1,2],[2,5]});

imread читает данные изображения в строках 1-2 и столбцах 2-5 от corn.tif и возвращается 2 4 массив, A.

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

`filename` — Имя графического файла
вектор символов | строковый скаляр

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

В зависимости от местоположения вашего файла, 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^® Blob	`wasb`, `wasbs`
HDFS™	`hdfs`

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

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

Для получения информации о битовых глубинах схемы сжатия и цветовые пространства, поддержанные для каждого типа файла, видят Алгоритмы.

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

`fmt` 'imageFormat'
вектор символов | строковый скаляр

Формат изображения в виде вектора символов или строкового скаляра, указывающего на стандартное расширение файла. Вызовите imformats видеть список поддерживаемых форматов и их расширений файла.

Пример: 'png'

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

`idx` — Отобразите, чтобы читать
целочисленный скаляр | вектор из целых чисел

Отобразите, чтобы читать в виде целочисленного скаляра или, для файлов GIF, вектора из целых чисел. Например, если idx 3, затем imread возвращает третье изображение в файле. Для файла GIF, если idx 1:5, затем imread возвращает только первые пять систем координат. idx аргумент поддерживается только для GIF мультиизображений, CUR, ICO и файлов HDF4.

При чтении нескольких систем координат из того же файла GIF задайте idx как вектор из систем координат или использования 'Frames','all' аргумент пары "имя-значение". Из-за способа, которым структурированы файлы GIF, эти синтаксисы обеспечивают более быструю эффективность по сравнению с вызовом imread в цикле.

Для файлов HDF4, idx соответствует ссылочному номеру изображения, чтобы читать. Ссылочные номера не обязательно соответствуют порядку изображений в файле. Можно использовать imfinfo совпадать с порядком изображений ссылочному номеру.

Пример 3

Типы данных: double

Аргументы в виде пар имя-значение

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'Index',5 читает пятое изображение файла TIFF.

Файлы GIF

`'Frames'` — Структурируйте, чтобы читать
1 (значение по умолчанию) | положительное целое число | вектор из целых чисел | `'all'`

Системы координат, чтобы читать в виде разделенной запятой пары, состоящей из 'Frames' и положительное целое число, вектор из целых чисел или 'all'. Например, если вы задаете значение 3, imread читает третью систему координат в файле. Если вы задаете 'all', затем imread чтения все системы координат и возвращают их в порядке, в котором они появляются в файле.

Пример: 'frames',5

JPEG 2 000 файлов

`'PixelRegion'` — Подотобразите, чтобы читать
массив ячеек в форме `{rows,cols}`

Подотобразите, чтобы читать в виде разделенной запятой пары, состоящей из 'PixelRegion' и массив ячеек формы {rows,cols}. rows введите указывает диапазон строк, чтобы читать. cols введите указывает диапазон столбцов, чтобы читать. Оба rows и cols должны быть двухэлементные векторы, содержащие индексы на основе 1. Например, 'PixelRegion',{[1 2],[3 4]} читает подызображение, ограниченное строками 1 и 2 и столбцами 3 и 4 в данных изображения. Если 'ReductionLevel' значение больше 0, затем rows и cols координаты подызображения.

Пример: 'PixelRegion',{[1 100],[4 500]}

`'ReductionLevel'` — Сокращение разрешения изображения
0 (значений по умолчанию) | неотрицательное целое число

Сокращение разрешения изображения в виде разделенной запятой пары, состоящей из 'ReductionLevel' и неотрицательное целое число. Для уровня сокращения L разрешение изображения уменьшается на коэффициент 2^L. Уровень сокращения ограничивается общим количеством уровней разложения, как задано the'WaveletDecompositionLevels' поле в выходе imfinfo функция.

Пример: 'ReductionLevel',5

Типы данных: single | double

`'V79Compatible'` — Совместимость с MATLAB 7.9 (R2009b) и ранее
`false` (значение по умолчанию) | `true`

Совместимость с MATLAB 7.9 (R2009b) и ранее в виде разделенной запятой пары, состоящей из 'V79Compatible' и любой true или false. Если вы задаете true, затем возвращенное изображение шкалы полутонов или RGB сопоставимо с предыдущими версиями imread (MATLAB 7.9 (R2009b) и ранее).

Пример: 'V79Compatible',true

Типы данных: логический

Файлы PNG

`'BackgroundColor'` BackgroundColor
`'none'` | целое число | вектор с 3 элементами из целых чисел

Цвет фона в виде 'none', целое число или трехэлементный вектор из целых чисел. Если BackgroundColor 'none'то imread не выполняет составления композита. В противном случае, imread прозрачные пиксели смешений с цветом фона.

Если входное изображение индексируется, то значение BackgroundColor должно быть целое число в области значений [1,P], где P длина палитры.
Если входное изображение является шкалой полутонов, то значение BackgroundColor должно быть целое число в области значений [0,1].
Если входное изображение является RGB, то значение BackgroundColor должен быть трехэлементный вектор со значениями в области значений [0,1].

Значение по умолчанию для BackgroundColor зависит от присутствия transparency выходной аргумент и тип изображения:

Если вы запрашиваете transparency выходной аргумент, затем значение по умолчанию BackgroundColor 'none'.
Если вы не запрашиваете transparency выведите и файл PNG содержит фрагмент цвета фона, затем тот цвет является значением по умолчанию для BackgroundColor.
Если вы не запрашиваете transparency выведите и файл не содержит фрагмент цвета фона, затем значение по умолчанию для BackgroundColor 1 для индексируемых изображений, 0 для полутоновых изображений и [0 0 0] для истинного цвета (RGB) изображения.

Файлы TIFF

`'Index'` — Отобразите, чтобы читать
1 (значение по умолчанию) | положительное целое число

Отобразите, чтобы читать в виде разделенной запятой пары, состоящей из 'Index' и положительное целое число. Например, если значение Index 3, затем imread читает третье изображение в файле.

Типы данных: single | double

`'Info'` — Информация об изображении
массив структур

Информация об изображении в виде разделенной запятой пары, состоящей из 'Info' и массив структур, возвращенный imfinfo функция. Используйте Info аргумент пары "имя-значение" справке imread найдите изображения в файле TIFF мультиизображений более быстро.

Типы данных: struct

`'PixelRegion'` — Контур области
cellArray

Контур области в виде разделенной запятой пары, состоящей из 'PixelRegion' и массив ячеек формы {rows,cols}. rows введите указывает диапазон строк, чтобы читать. cols введите указывает диапазон столбцов, чтобы читать. rows и cols должны быть или двухэлементные или трехэлементные векторы из индексов на основе 1. Двухэлементный вектор задает первые и последние строки или столбцы, чтобы читать. Например, 'PixelRegion',{[1 2],[3 4]} читает область, ограниченную строками 1 и 2 и столбцами 3 и 4 в данных изображения.

Трехэлементный вектор должен быть в форме [start increment stop], где start первая строка или столбец, чтобы читать, increment инкрементное значение и stop последняя строка или столбец, чтобы читать. Этот синтаксис позволяет субдискретизацию изображений. Например, 'PixelRegion',{[1 2 10],[4 3 12]} читает область, ограниченную строками 1 и 10 и столбцами 4 и 12 и демонстрационными данными из каждых 2 пикселей в вертикальном направлении и каждых 3 пикселей в горизонтальном направлении.

Пример: 'PixelRegion',{[1 100],[4 500]}

Типы данных: cell

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

`A` Данные изображения
массив

Данные изображения, возвращенные как массив.

Если файл содержит полутоновое изображение, то A является m- n массив.
Если файл содержит индексируемое изображение, то A является m- n массив значений индекса, соответствующих цвету в том индексе в map.
Если файл содержит изображение истинного цвета, то A является m- n- 3 массива.
Если файл является файлом TIFF, содержащим цветные изображения, которые используют цветовое пространство CMYK, то A является m- n- 4 массива.

Класс A зависит от формата изображения и битовой глубины данных изображения. Для получения дополнительной информации см. Алгоритмы

`map` палитра
`m`- 3 матрицы

Палитра сопоставлена с индексируемыми данными изображения в A, возвращенный как m- 3 матрицы класса double.

`transparency` — Информация о прозрачности
матрица

Информация о прозрачности, возвращенная как матрица. Для файлов PNG, transparency альфа-канал, если существующий. Если никакой альфа-канал не присутствует, или если вы задаете 'BackgroundColor' аргумент пары "имя-значение", затем transparency isempty. Для CUR и файлов ICO, transparency маска AND. Для файлов курсора эта маска иногда содержит единственные полезные данные.

Больше о

Битовая глубина

Битовая глубина является количеством битов, используемых, чтобы представлять каждый пиксель изображения.

Битовая глубина вычисляется путем умножения битов на выборку с выборками на пиксель. Таким образом формат, который использует 8 битов для каждого компонента цвета (или выборка) и три выборки на пиксель, имеет немного глубины 24. Иногда объем выборки, сопоставленный с небольшой глубиной, может быть неоднозначным. Например, 48-битная битовая глубина представляет шесть 8-битных выборок, четыре 12-битных выборки или три 16-битных выборки? См. Алгоритмы для получения информации об объеме выборки, чтобы избежать этой неоднозначности.

Алгоритмы