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

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 это маска И (непрозрачность).

Примеры

Чтение и отображение изображения

Прочтите образец изображения.

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 пуст.

Считывание указанной области изображения 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`
Амазонский S3™	`s3`
Хранилище больших двоичных объектов Windows Azure ®	`wasb`, `wasbs`
HDFS™	`hdfs`

Дополнительные сведения см. в разделе Работа с удаленными данными.

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

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

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

`fmt` - Формат изображения
вектор символов | строковый скаляр

Формат изображения, заданный как вектор символа или скаляр строки, указывающий стандартное расширение файла. Звонить 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 2000

`'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 раза. Уровень снижения ограничен общим количеством уровней разложения, как указано в'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

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

Файлы PNG

`'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] для изображений truecolor (RGB).

Файлы TIFF

`'Index'` - Изображение для чтения
1 (по умолчанию) | положительное целое число

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

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

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

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

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

`'PixelRegion'` - Граница области
массив ячеек

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

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

`map` - Цветовая карта
`m`-по-3 матрица

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

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

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

Подробнее

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

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

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

Алгоритмы