exponenta event banner

imwrite

Запись изображения в графический файл

Описание

пример

imwrite(A,filename) записывает данные изображения A в файл, указанный filename, выводя формат файла из расширения. imwrite создает новый файл в текущей папке. Битовая глубина выходного изображения зависит от типа данных A и формат файла. Для большинства форматов:

  • Если A имеет тип данных uint8, то imwrite выводит 8-разрядные значения.

  • Если A имеет тип данных uint16 и формат выходного файла поддерживает 16-битные данные (JPEG, PNG и TIFF), затем imwrite выводит 16-разрядные значения. Если формат выходного файла не поддерживает 16-разрядные данные, то imwrite возвращает ошибку.

  • Если A - цветное изображение типа данных в градациях серого или RGB double или single, то imwrite предполагает, что динамический диапазон равен [0,1], и автоматически масштабирует данные на 255, прежде чем записать их в файл как 8-битные значения. Если данные в A является single, преобразовать A кому double перед записью в файл GIF или TIFF.

  • Если A имеет тип данных logical, то imwrite предполагает, что данные являются двоичным изображением и записывают их в файл с битовой глубиной 1, если это разрешено форматом. Форматы BMP, PNG или TIFF принимают двоичные изображения в качестве входных массивов.

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

пример

imwrite(A,map,filename) записывает индексированное изображение в A и связанную с ним карту цвета, map, в файл, указанный filename.

  • Если A является индексированным изображением типа данных double или single, то imwrite преобразует индексы в индексы, основанные на нулях, вычитая 1 из каждого элемента, а затем записывает данные как uint8. Если данные в A является single, преобразовать A кому double перед записью в файл GIF или TIFF.

imwrite(___,fmt) записывает изображение в формате, указанном fmt, независимо от расширения файла в filename. Можно указать fmt после входных аргументов в любом из предыдущих синтаксисов.

пример

imwrite(___,Name,Value) задает дополнительные параметры для выходных файлов GIF, HDF, JPEG, PBM, PGM, PNG, PPM и TIFF, используя один или несколько аргументов пары имя-значение. Можно указать Name,Value после входных аргументов в любом из предыдущих синтаксисов.

Примеры

свернуть все

Запишите массив значений оттенков серого 50 на 50 в PNG-файл в текущей папке.

A = rand(50);
imwrite(A,'myGray.png')

Запись массива индексированных изображений и связанной с ним карты цветов в PNG-файл.

Загрузите образец данных изображения из файла, clown.mat.

load clown.mat

Массив изображений X и связанную с ним карту цвета, map, загружаются в рабочую область MATLAB ®.

Запишите данные в новый PNG-файл.

imwrite(X,map,'myclown.png')

imwrite создает файл, myclown.png, в текущей папке.

Просмотрите новый файл, открыв его за пределами MATLAB.

Запись данных изображения в новый файл PNG со встроенной картой цветов MATLAB, copper.

Загрузить образец данных изображения из файла clown.mat.

load clown.mat

Массив изображений X и связанную с ним карту цвета, map, загружаются в рабочую область MATLAB. map является матрицей из 81 RGB векторов.

Определите карту цветов медного тона с 81 вектором RGB. Затем запишите данные изображения в PNG-файл, используя новую карту цветов.

newmap = copper(81);
imwrite(X,newmap,'copperclown.png');

imwrite создает файл, copperclown.png, в текущей папке.

Просмотрите новый файл, открыв его за пределами MATLAB.

Создание и запись данных изображения truecolor в файл JPEG.

Создайте множество случайных ценностей RGB 49 на 49 на 3.

A = rand(49,49);
A(:,:,2) = rand(49,49);
A(:,:,3) = rand(49,49);

Запишите данные изображения в файл JPEG, указав формат вывода с помощью 'jpg'. Добавление комментария к файлу с помощью 'Comment' аргумент пары имя-значение.

imwrite(A,'newImage.jpg','jpg','Comment','My JPEG file')

Просмотр сведений о новом файле.

imfinfo('newImage.jpg')
ans = 

           Filename: 'S:\newImage.jpg'
        FileModDate: '25-Jan-2013 16:18:41'
           FileSize: 2339
             Format: 'jpg'
      FormatVersion: ''
              Width: 49
             Height: 49
           BitDepth: 24
          ColorType: 'truecolor'
    FormatSignature: ''
    NumberOfSamples: 3
       CodingMethod: 'Huffman'
      CodingProcess: 'Sequential'
            Comment: {'My JPEG file'}

Запись нескольких изображений в один многостраничный файл TIFF.

Создайте два набора случайных данных изображения, im1 и im2.

im1 = rand(50,40,3);
im2 = rand(50,50,3);

Запишите первое изображение в новый файл TIFF. Затем добавьте второе изображение в тот же файл.

imwrite(im1,'myMultipageFile.tif')
imwrite(im2,'myMultipageFile.tif','WriteMode','append')

Нарисуйте ряд графиков, скопируйте их в виде изображений и запишите в один анимированный GIF-файл.

Участок$y = x^{n}$ для.$n = 3$

x = 0:0.01:1;
n = 3;
y = x.^n;
plot(x,y,'LineWidth',3)
title(['y = x^n,  n = ' num2str(n) ])

Захват ряда графиков для увеличения значений.$n$

n = 1:0.5:5;
nImages = length(n);

fig = figure;
for idx = 1:nImages
    y = x.^n(idx);
    plot(x,y,'LineWidth',3)
    title(['y = x^n,  n = ' num2str( n(idx)) ])
    drawnow
    frame = getframe(fig);
    im{idx} = frame2im(frame);
end
close;

Отображение последовательности изображений на одном рисунке.

figure;
for idx = 1:nImages
    subplot(3,3,idx)
    imshow(im{idx});
end

Сохраните девять изображений в GIF-файл. Поскольку трехмерные данные не поддерживаются для GIF-файлов, вызовите rgb2ind преобразование данных RGB в изображении в индексированное изображение A с картой цветов map. Чтобы добавить несколько изображений к первому изображению, вызовите imwrite с аргументом пара имя-значение 'WriteMode','append'.

filename = 'testAnimated.gif'; % Specify the output file name
for idx = 1:nImages
    [A,map] = rgb2ind(im{idx},256);
    if idx == 1
        imwrite(A,map,filename,'gif','LoopCount',Inf,'DelayTime',1);
    else
        imwrite(A,map,filename,'gif','WriteMode','append','DelayTime',1);
    end
end

imwrite записывает GIF-файл в текущую папку. Пара имя-значение 'LoopCount',Inf приводит к непрерывному закольцовыванию анимации. 'DelayTime',1 задает 1-секундную задержку между отображением каждого изображения в анимации.

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

свернуть все

Данные изображения, указанные как полная (непарабельная) матрица.

  • Для изображений в градациях серого A может быть mоколо-n.

  • Для индексированных изображений A может быть mоколо-n. Укажите связанную карту цветов в map входной аргумент.

  • Для цветных изображений, A должно быть mоколо-n-к-3. imwrite не поддерживает запись изображений RGB в GIF-файлы.

Для файлов TIFF: A может быть mоколо-nМассив -by-4, содержащий цветовые данные, использующие цветовое пространство CMYK.

Для многокадровых GIF-файлов: A может быть mоколо-n-by-1-by-p массив, содержащий изображения в градациях серого или индексированные изображения, где p - количество кадров для записи. Образы RGB в данном случае не поддерживаются.

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

Имя выходного файла, указанное как вектор символа или скаляр строки.

В зависимости от места, в которое вы пишете, filename может принимать одну из этих форм.

Местоположение

Форма

Текущая папка

Для записи в текущую папку укажите имя файла в filename.

filename должен включать расширение файла. Список типов изображений, которые imwrite может писать, см. описание для fmt входной аргумент.

Пример: 'myImage.jpg'

Другие папки

Чтобы записать в папку, отличную от текущей, укажите полный или относительный путь в filename.

Пример: 'C:\myFolder\myImage.ext'

Пример: '\imgDir\myImage.ext'

Удаленное расположение

Для записи в удаленное расположение 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

Карта цветов, связанная с данными индексированного изображения в A, указано как mмассив -by-3. map должен быть действительной картой цветов MATLAB. Посмотрите colormap список встроенных карт цветов MATLAB. Большинство форматов файлов изображений не поддерживают карты цветов, содержащие более 256 записей.

Пример: [0,0,0;0.5,0.5,0.5;1,1,1]

Пример: jet(60)

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

Формат выходного файла, указанный в этой таблице в качестве одного из форматов.

В этой таблице также представлены типы изображений, которые imwrite может писать. Реестр форматов файлов MATLAB определяет, какие форматы файлов поддерживаются. Посмотрите imformats для получения дополнительных сведений об этом реестре.

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

Значение fmt

Формат выходного файла

Описание

'bmp'

Битовая карта Windows ® (BMP)

1-разрядные, 8-разрядные и 24-разрядные несжатые изображения

'gif'

GIF - формат обмена графикой

8-битные изображения

'hdf'

HDF4 - Иерархический формат данных

8-битные наборы данных растрового изображения с соответствующей картой цветов или без нее, 24-битные наборы данных растрового изображения

'jpg' или 'jpeg'

JPEG - Совместная группа экспертов по фотографии

8-разрядные, 12-разрядные и 16-разрядные изображения JPEG базовой линии

Примечание

imwrite преобразует индексированные изображения в RGB перед записью данных в файлы JPEG, поскольку формат JPEG не поддерживает индексированные изображения.

'jp2' или 'jpx'

JPEG 2000 - Совместная группа фотографических экспертов 2000

1-разрядные, 8-разрядные и 16-разрядные изображения JPEG 2000

'pbm'

Портативное растровое изображение (PBM)

Любое 1-битное изображение PBM, ASCII (простое) или необработанное (двоичное) кодирование

'pcx'

Кисть Windows (PCX)

8-битные изображения

'pgm'

Портативная карта серого (PGM)

Любой стандартный образ PGM; ASCII (равнина), закодированная с произвольной глубиной цвета; необработанное (двоичное) кодирование со значением до 16 бит на серый цвет

'png'

PNG - портативная сетевая графика

1-разрядные, 2-разрядные, 4-разрядные, 8-разрядные и 16-разрядные изображения в градациях серого; 8-битные и 16-битные изображения в градациях серого с альфа-каналами; 1-разрядные, 2-разрядные, 4-разрядные и 8-разрядные индексированные изображения; 24-битные и 48-битные изображения в цвете; 24-битные и 48-битные изображения в цвете с альфа-каналами

Примечание

imwrite функция не поддерживает запись индексированных PNG-файлов с недостаточным количеством записей карты цветов.

'pnm'

Портативная Anymap (PNM)

Любой формат PPM/PGM/PBM, выбранный автоматически

'ppm'

Portable Pixmap (PPM)

Любое стандартное изображение PPM: ASCII (plain), закодированное с произвольной глубиной цвета, или необработанное (binary), закодированное с 16 битами на компонент цвета

'ras'

Sun™ Растр (РАН)

Любое изображение RAS, включая 1-битовое растровое изображение, 8-битное индексированное изображение, 24-битное изображение truecolor и 32-битное изображение truecolor с alpha

'tif' или 'tiff'

Формат файла изображения с тегами (TIFF)

Базовые изображения TIFF, включая:

  • 1-битные, 8-битные, 16-битные, 24-битные и 48-битные несжатые изображения и изображения с пакетным сжатием, сжатием LZW или Deflate

  • 1-битные изображения со сжатием CCITT 1D, группы 3 и группы 4

  • Изображения CIELAB, ICCLAB и CMYK

'xwd'

Дамп X Windows (XWD)

8-битные ZPixmaps

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

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

Пример: imwrite(A,'myFile.png','BitDepth',8) записывает данные в A использование 8 битов для представления каждого пикселя.
GIF - формат обмена графикой

свернуть все

Цвет для использования в качестве цвета фона для индексированного изображения, заданный как пара, разделенная запятыми, состоящая из 'BackgroundColor' и скалярное целое число, соответствующее индексу карты цветов.

Цвет фона используется для некоторых методов утилизации в анимированных GIF.

  • Если данные изображения A является uint8 или logical, то индекс карты цветов основан на нуле.

  • Если данные изображения A является double, то индекс карты цветов основан на единице.

Цвет фона по умолчанию соответствует первому цвету в карте цветов.

Пример: 'BackgroundColor',15

Комментарий для добавления к изображению, указанный как разделенная запятыми пара, состоящая из 'Comment' и вектор символа, строковый скаляр, 1-by-n массив ячеек символьных векторов или строковый массив. Для массива ячеек символьных векторов: imwrite добавляет возврат каретки после каждого вектора символов.

Пример: 'Comment',{'Sample #314','January 5, 2013'}

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

Задержка перед отображением следующего изображения в секундах, указанного как разделенная запятыми пара, состоящая из 'DelayTime' и скалярное значение в диапазоне [0,655]. Значение 0 отображает изображения так быстро, как позволяет оборудование.

Пример: 'DelayTime',60

Метод удаления анимированного GIF, определяемый как разделенная запятыми пара, состоящая из 'DisposalMethod' и один из методов в этой таблице.

Значение DisposalMethod Результат
'doNotSpecify' (по умолчанию)Замените один полноразмерный непрозрачный кадр на другой.
'leaveInPlace'Все пикселы, не покрытые следующим кадром, продолжают отображаться.
'restoreBG'Цвет фона или мозаика фона отображается через прозрачные пикселы.
'restorePrevious'Восстановление в состояние предыдущего, неразмещенного кадра.

Пример: 'DisposalMethod','restoreBG'

Смещение экрана относительно изображения, измеренное от верхнего левого угла каждого, указанного как разделенная запятыми пара, состоящая из 'Location' и двухэлементный вектор. Первый векторный элемент определяет смещение сверху, а второй элемент - влево в пикселях.

Пример: 'Location',[10,15]

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

Число повторений анимации, указанное как разделенная запятыми пара, состоящая из 'LoopCount' и либо целое число в диапазоне [0,65535], или значение Inf. Если задано значение 0, анимация воспроизводится один раз. Если задано значение 1, анимация воспроизводится дважды и т.д. A LoopCount значение Inf приводит к непрерывному закольцовыванию анимации.

Чтобы включить анимацию в Microsoft ® PowerPoint ®, укажите значение для'LoopCount' в пределах диапазона [165535]. Некоторые приложения Microsoft интерпретируют значение 0 как означающее, что оно вообще не закольцовывается.

Пример: 'LoopCount',3

Высота и ширина рамки, заданная как разделенная запятыми пара, состоящая из 'ScreenSize' и двухэлементный вектор. При использовании ScreenSize аргумент с 'Location', он обеспечивает способ записи кадров в изображение, которые меньше, чем весь кадр. 'DisposalMethod' определяет значение заливки для пикселов вне кадра.

Пример: 'ScreenSize',[1000 1060]

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

Цвет для использования в качестве прозрачного цвета для изображения, заданный как разделенная запятыми пара, состоящая из 'TransparentColor' и скалярное целое число, соответствующее индексу карты цветов.

  • Если данные изображения A является uint8 или logical, то индексация начинается в 0.

  • Если данные изображения A является double, то индексация начинается в 1.

Пример: 'TransparentColor',20

Режим записи, заданный как разделенная запятыми пара, состоящая из 'WriteMode' и либо 'overwrite' или 'append'. В overwrite режим, imwrite перезаписывает существующий файл,filename. В append режим, imwrite добавляет один кадр к существующему файлу.

Пример: 'WriteMode','append'

HDF4 - Иерархический формат данных

свернуть все

Схема сжатия, заданная как разделенная запятыми пара, состоящая из 'Compression' и один из вариантов в этой таблице.

Значение Compression Результат
'none' (по умолчанию)Без сжатия
'jpeg'Сжатие JPEG. Допустимо только для изображений в градациях серого и RGB.
'rle'Кодирование длины прогона. Допустимо только для изображений в градациях серого и индексированных изображений.

Пример: 'Compression','jpeg'

Качество файла, сжатого JPEG, указанного как пара, разделенная запятыми, состоящая из 'Quality' и скаляр в диапазоне [0,100], где 0 - более низкое качество и более высокое сжатие, а 100 - более высокое качество и более низкое сжатие. Этот параметр применяется только в том случае, если 'Compression' является 'jpeg'.

Пример: 'Quality',25

Режим записи, заданный как разделенная запятыми пара, состоящая из 'WriteMode' и либо 'overwrite' или 'append'. В overwrite режим, imwrite перезаписывает существующий файл,filename. В append режим, imwrite добавляет один кадр к существующему файлу.

Пример: 'WriteMode','append'

JPEG - Совместная группа экспертов по фотографии

свернуть все

Количество битов на пиксель, указанное как разделенная запятыми пара, состоящая из 'BitDepth' и скаляр.

  • Для изображений в градациях серого BitDepth может быть 8, 12 или 16. Значение по умолчанию - 8. Для 16-разрядных изображений: 'Mode' аргумент пары имя-значение должен быть 'lossless'.

  • Для цветных изображений, BitDepth значение - количество битов на плоскость, может быть 8 или 12. Значение по умолчанию - 8 бит на плоскость.

Пример: 'BitDepth',12

Комментарий для добавления к изображению, указанный как разделенная запятыми пара, состоящая из 'Comment' и символьный вектор, строковый скаляр, символьный массив, n-by-1 - массив ячеек символьных векторов или строковый массив. imwrite записывает каждую строку входных данных в виде комментария в файл JPEG.

Пример: 'Comment',{'First line';'second line';'third line'}

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

Тип сжатия, указанный как разделенная запятыми пара, состоящая из 'Mode' и один из следующих вариантов:

  • 'lossy'

  • 'lossless'

Пример: 'Mode','lossless'

Качество выходного файла, указанного как разделенная запятыми пара, состоящая из 'Quality' и скаляр в диапазоне [0,100], где 0 - более низкое качество и более высокое сжатие, а 100 - более высокое качество и более низкое сжатие. A Quality значение 100 не записывает образ JPEG без потерь. Вместо этого используйте 'Mode','lossless' аргумент пары имя-значение.

Пример: 'Quality',100

JPEG 2000 - Совместная группа фотографических экспертов 2000

свернуть все

Комментарий для добавления к изображению, указанный как разделенная запятыми пара, состоящая из 'Comment' и символьный вектор, символьный массив, строковый скаляр, клеточный массив символьных векторов или строковый массив. imwrite записывает каждую строку входных данных в виде комментария в файл JPEG 2000.

Пример: 'Comment',{'First line';'second line';'third line'}

Пример: 'Comment',{'First line','second line','third line'}

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

Целевая степень сжатия, указанная как разделенная запятыми пара, состоящая из 'CompressionRatio' и действительный скаляр, больший или равный 1. Степень сжатия представляет собой отношение размера входного изображения к размеру выходного сжатия. Например, значение 2,0 подразумевает, что размер выходного изображения равен половине размера входного изображения или меньше. Более высокое значение подразумевает меньший размер файла и снижение качества изображения. Степень сжатия не учитывает размер заголовка.

Определение CompressionRatio действителен только тогда, когда 'Mode' является 'lossy'.

Пример: 'CompressionRatio',3

Тип сжатия, указанный как разделенная запятыми пара, состоящая из 'Mode' и один из следующих вариантов:

  • 'lossy'

  • 'lossless'

Пример: 'Mode','lossless'

Порядок пакетов в кодовом потоке, определяемый как разделенная запятыми пара, состоящая из 'ProgressionOrder' и один из следующих вариантов:

  • 'LRCP'

  • 'RLCP'

  • 'RPCL'

  • 'PCRL'

  • 'CPRL'

Символы обозначают следующее: L = слой, R = разрешение, C = компонент и P = положение.

Пример: 'ProgressionOrder','RLCP'

Количество слоев качества, указанное как разделенная запятыми пара, состоящая из 'QualityLayers' и целое число в диапазоне [1,20].

Пример: 'QualityLayers',8

Количество уровней редукции или уровней вейвлет-декомпозиции, указанных как разделенная запятыми пара, состоящая из 'ReductionLevels' и целое число в диапазоне [1,8].

Пример: 'ReductionLevels',6

Высота и ширина плитки, заданная как разделенная запятыми пара, состоящая из 'TileSize' и двухэлементный вектор. Минимальный размер, который можно указать: [128 128].

Пример: 'TileSize',[130 130]

PBM, PGM и PPM - переносной растровый рисунок, Graymap, Pixmap

свернуть все

Кодировка, заданная как разделенная запятыми пара, состоящая из 'Encoding' и либо 'rawbits' для двоичного кодирования, или 'ASCII' для простой кодировки.

Пример: 'Encoding','ASCII'

Максимальное значение серого или цвета, указанное как разделенная запятыми пара, состоящая из 'MaxValue' и скаляр.

Доступно только для файлов PGM и PPM. Для файлов PBM это значение всегда равно 1.

Если массив изображений uint16, то значение по умолчанию для MaxValue является 65535. В противном случае значением по умолчанию является 255.

Пример: 'MaxValue',510

PNG - портативная сетевая графика

свернуть все

Прозрачность каждого пикселя, определяемая как разделенная запятыми пара, состоящая из 'Alpha' и матрицу значений в диапазоне [0,1]. Размеры строки и столбца Alpha матрица должна совпадать с матрицей данных изображения. Можно указать Alpha только для оттенков серого (mоколо-n) и truecolor (mоколо-n-by-3) данные изображения.

Примечание

Вы не можете указать оба 'Alpha' и 'Transparency' одновременно.

Типы данных: double | uint8 | uint16

Информация об авторе, указанная как разделенная запятыми пара, состоящая из 'Author' и вектор символов или строковый скаляр.

Пример: "Author','Ann Smith'

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

Цвет фона при компоновке прозрачных пикселов, заданный как разделенная запятыми пара, состоящая из 'Background' и значение, зависящее от данных изображения, следующим образом.

Тип изображенияФорма Background Стоимость
Изображения в градациях серогоСкаляр в диапазоне [0,1].
Индексированные изображенияЦелое число в диапазоне [1,P], где P - длина карты цветов. Например, 'Background',50 задает цвет фона, заданный 50-м индексом в карте цветов.
Изображения TruecolorТрехэлементный вектор интенсивностей RGB в диапазоне [0,1]. Например, 'Background',[0 1 1] задает голубой цвет фона.

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

Количество битов на пиксель, указанное как разделенная запятыми пара, состоящая из 'BitDepth' и скаляр. В зависимости от выходного изображения скаляром может быть одно из следующих значений.

Тип изображенияДопустимые значения для BitDepth
Изображения в градациях серого1, 2, 4, 8, или 16
Изображения в градациях серого с альфа-каналом8 или 16
Индексированные изображения1, 2, 4, или 8
Изображения Truecolor8 или 16
  • Если изображение имеет класс double или uint8, тогда битовая глубина по умолчанию составляет 8 бит на пиксель.

  • Если изображение uint16, то значение по умолчанию - 16 бит на пиксель.

  • Если изображение logical, то значение по умолчанию - 1 бит на пиксель.

Пример: 'BitDepth',4

Контрольная белая точка и первичные цветности, указанные как разделенная запятыми пара, состоящая из 'Chromaticities' и 8-элементный вектор, [wx wy rx ry gx gy bx by]. Элементы wx и wy координаты цветности точки белого и элементы rx, ry, gx, gy, bx, и by - координаты цветности трех основных цветов.

При указании Chromaticities, вы также должны указать Gamma аргумент пары имя-значение.

Пример: 'Chromaticities',[0.312,0.329,0.002,0.002,0.001,0.001,0.115,0.312]

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

Комментарий для добавления к изображению, указанный как разделенная запятыми пара, состоящая из 'Comment' и вектор символов или строковый скаляр.

Время создания исходного изображения, определяемое как вектор символа или скаляр строки.

Описание изображения, указанное как разделенная запятыми пара, состоящая из 'Description' и вектор символов или строковый скаляр.

Юридический отказ от ответственности, указанный как пара, разделенная запятыми, состоящая из 'Disclaimer' и вектор символов или строковый скаляр.

Гамма файла, указанная как разделенная запятыми пара, состоящая из 'Gamma' и скаляр.

Пример: 'Gamma',2.2

Время последнего изменения изображения, указанное как разделенная запятыми пара, состоящая из 'ImageModTime' и порядковый номер даты MATLAB или вектор символов или строковый скаляр даты, который может быть преобразован в вектор даты с помощью datevec функция. Значения должны находиться в согласованном универсальном времени (UTC).

Дефолт ImageModTime значение - время, когда вы звоните imwrite.

Пример: 'ImageModTime','17-Jan-2013 11:23:10'

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

Схема чередования, заданная как разделенная запятыми пара, состоящая из 'InterlaceType' и либо 'none' без чередования, или 'adam7' для использования алгоритма Adam7.

Пример: 'InterlaceType','adam7'

Единица измерения разрешения изображения, указанная как разделенная запятыми пара, состоящая из 'ResolutionUnit' и либо 'unknown' или 'meter'. При указании ResolutionUnit, необходимо включить хотя бы один из XResolution и YResolution аргументы пары имя-значение. Когда значение ResolutionUnit является 'meter', XResolution и YResolution значения интерпретируются в пикселях на метр.

Пример: 'ResolutionUnit','meter','XResolution',1000

Количество битов в массиве данных, считающихся значимыми, указанное как разделенная запятыми пара, состоящая из 'SignificantBits' и скаляр или вектор в диапазоне [1,BitDepth]. В зависимости от типа выходного изображения значение должно быть в следующей форме.

Тип изображенияФорма SignificantBits Стоимость
Изображение в градациях серого без альфа-каналаСкаляр
Изображение в градациях серого с альфа-каналом2-элементный вектор
Индексированное изображение3-элементный вектор
Изображение Truecolor без альфа-канала3-элементный вектор
Изображение Truecolor с альфа-каналом4-элементный вектор

Пример: 'SignificantBits',[2,3]

Программное обеспечение, используемое для создания образа, указанное как разделенная запятыми пара, состоящая из 'Software' и вектор символов или строковый скаляр.

Устройство, используемое для создания изображения, указанное как разделенная запятыми пара, состоящая из 'Source' и вектор символов или строковый скаляр.

Пикселы, которые считаются прозрачными, если альфа-канал не используется, задаются как разделенная запятыми пара, состоящая из 'Transparency' и скаляр или вектор. В зависимости от выходного изображения значение должно быть в следующей форме.

Тип изображенияФорма Transparency Стоимость
Изображения в градациях серогоСкаляр в диапазоне [0,1], указывающий цвет в градациях серого, который должен считаться прозрачным.
Индексированные изображенияQ-вектор элементов значений в диапазоне [0,1], где Q не превышает длину карты цветов, и каждое значение указывает прозрачность, связанную с соответствующей записью карты цветов. В большинстве случаев Q = 1.
Изображения Truecolor3-элементный вектор интенсивностей RGB в диапазоне [0,1], обозначающий цвет, который следует считать прозрачным.

Примечание

Вы не можете указать оба 'Transparency' и 'Alpha' одновременно.

Пример: 'Transparency',[1 1 1]

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

Предупреждение о характере содержимого, указанного как разделенная запятыми пара, состоящая из 'Warning' и вектор символов или строковый скаляр.

Разрешение изображения в горизонтальном направлении, в пикселях/единицах, указанное как разделенная запятыми пара, состоящая из 'XResolution' и скаляр. Определите единицу измерения, указав ResolutionUnit аргумент пары имя-значение.

Если также не указать YResolution, то XResolution значение применяется как к горизонтальному, так и к вертикальному направлению.

Пример: 'XResolution',900

Разрешение изображения в вертикальном направлении, в пикселях/единицах, указанное как разделенная запятыми пара, состоящая из 'XResolution' и скаляр. Определите единицу измерения, указав ResolutionUnit аргумент пары имя-значение.

Если также не указать XResolution, то YResolution значение применяется как к горизонтальному, так и к вертикальному направлению.

Пример: 'YResolution',900

В дополнение к перечисленным аргументам пары имя-значение для PNG можно использовать любое имя параметра, удовлетворяющее спецификации PNG для ключевых слов. То есть имя использует только печатаемые символы, содержит не более 80 символов и не содержит пробелов в начале или конце. Значение, соответствующее указанным пользователем именам, должно быть символьным вектором или строковым скаляром, не содержащим управляющих символов, отличных от linefeed.

RAS - растровое изображение солнца

свернуть все

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

Действительно только для truecolor (mоколо-n-by-3) данные изображения.

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

Тип изображения, указанный как разделенная запятыми пара, состоящая из 'Type' и один из вариантов в этой таблице.

Значение TypeОписание
'standard' (по умолчанию)Несжатый цветовой порядок B-G-R для цветных изображений
'rgb'Несжатый цветовой порядок R-G-B для цветных изображений
'rleКодирование 1-разрядных и 8-разрядных изображений с длительностью выполнения

Пример: 'Type','rgb'

TIFF - формат файла изображения с тегами

свернуть все

Цветовое пространство, представляющее цветовые данные, указанное как разделенная запятыми пара, состоящая из 'ColorSpace' и один из следующих вариантов:

  • 'rgb'

  • 'cielab'

  • 'icclab'

Допустимо только в том случае, если массив данных изображения, A, является truecolor (mоколо-n-к-3). Чтобы использовать цветовое пространство CMYK в файле TIFF, не используйте 'ColorSpace' аргумент пары имя-значение. Вместо этого укажите mоколо-nмассив данных изображения -на-4.

imwrite может записывать данные цветового изображения, в котором используется цветовое пространство L * a * b *, в файлы TIFF. Спецификация CIE L * a * b * 1976 года определяет числовые значения, которые представляют информацию яркости (L *) и цветности (a * и b *). Чтобы сохранить цветовые данные L * a * b * в файле TIFF, значения должны быть закодированы, чтобы поместиться в 8-битное или 16-битное хранилище.imwrite может хранить цветовые данные L * a * b * в файле TIFF с использованием следующих кодировок:

  • Кодировки CIELAB - 8-битные и 16-битные кодировки, определенные спецификацией TIFF

  • Кодировки ICCLAB - 8-битные и 16-битные кодировки, определенные Международным консорциумом цветов

Класс вывода и кодировка, используемые imwrite зависит от класса массива данных входного изображения и ColorSpace , как показано в следующей таблице. (8-разрядные и 16-разрядные кодировки CIELAB не могут быть входными массивами, поскольку они используют смесь подписанных и неподписанных значений и не могут быть представлены в виде одного массива MATLAB.)

Класс ввода и кодировка

Значение ColorSpace

Класс вывода и кодировка

8-битный ICCLAB


Значения являются целыми числами в диапазоне [0 255]. Значения L * умножаются на255/100.
128 добавляется к значениям a * и b *.

'icclab'

8-битный ICCLAB

'cielab'

8-разрядный CIELAB

16-разрядный ICCLAB


Значения - целые числа в диапазоне [0, 65280]. Значения L * умножаются на65280/100.
32768 добавляется к значениям a * и b *, которые представлены в виде целых чисел в диапазоне [0,65535 ].

'icclab'

16-разрядный ICCLAB

'cielab'

16-разрядный CIELAB

Значения CIE L * a * b * 1976 с двойной точностью


L * находится в динамическом диапазоне [0, 100]. a * и b * могут принимать любое значение. При установке для * и b * значения 0 (ноль) возникает нейтральный цвет (серый).

'icclab'

8-битный ICCLAB

'cielab'

8-разрядный CIELAB

Пример: 'ColorSpace','cielab'

Схема сжатия, заданная как разделенная запятыми пара, состоящая из 'Compression' и один из следующих вариантов:

  • 'packbits' (по умолчанию для небинарных изображений)

  • 'none'

  • 'lzw'

  • 'deflate'

  • 'jpeg'

  • 'ccitt' (только двоичные изображения и значение по умолчанию для таких изображений)

  • 'fax3' (только двоичные изображения)

  • 'fax4' (только двоичные изображения)

'jpeg' - схема сжатия с потерями; другие режимы сжатия не имеют потерь. Кроме того, если указать 'jpeg' сжатие, необходимо указать 'RowsPerStrip' и значение должно быть кратным 8.

Пример: 'Compression','none'

Описание изображения, определяемое разделенной запятыми парой, состоящей из 'Description' и вектор символов или строковый скаляр. Это текст, который imfinfo возвращает в ImageDescription поле для выходного изображения.

Пример: 'Description','Sample 2A301'

Разрешение X и Y, указанное как пара, разделенная запятыми, состоящая из 'Resolution' и скаляр, указывающий как разрешение, так и двухэлементный вектор, содержащий разрешение X и разрешение Y.

Пример: 'Resolution',80

Пример: 'Resolution',[320,72]

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

Количество строк для включения в каждую полосу, указанное как разделенная запятыми пара, состоящая из 'RowsPerStrip' и скаляр. Значение по умолчанию таково, что каждая полоса составляет около 8 килобайт.

Необходимо указать RowsPerStrip при указании 'jpeg' сжатие. Значение должно быть кратным 8.

Пример: 'RowsPerStrip',16

Типы данных: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Режим записи, заданный как разделенная запятыми пара, состоящая из 'WriteMode' и либо 'overwrite' или 'append'. В overwrite режим, imwrite перезаписывает существующий файл. В append режим, imwrite добавляет страницу в существующий файл.

Пример: 'WriteMode','append'

Совет

  • Для получения информации об авторских правах см. libtiffcopyright.txt файл.

Расширенные возможности

См. также

| | | | |

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