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

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

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

A = imread(___,idx) читает заданное изображение или изображения от мультифайла изображения. Этот синтаксис применяется только к GIF, CUR, ICO, TIF и файлам 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)

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

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

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

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

imshow(X,cmap)

Преобразуйте индексируемое изображение в изображение 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 пуст.

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

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 должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: 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' и массива структур, возвращенного функцией 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-by-n массив.
Если файл содержит индексируемое изображение, то A является m-by-n массив индексных значений, соответствующих цвету в том индексе в map.
Если файл содержит изображение истинного цвета, то A является m-by-n-by-3 массив.
Если файл является файлом TIFF, содержащим цветные изображения, которые используют цветовое пространство CMYK, то A является m-by-n-by-4 массив.

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

`map` — Палитра
`m`-by-3 матрица

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

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

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

Больше о

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

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

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

Алгоритмы