imwrite

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

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

Синтаксис

imwrite(A,filename)
imwrite(A,map,filename)
imwrite(___,fmt)
imwrite(___,Name,Value)

Описание

пример

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 после входных параметров в любом из предыдущих синтаксисов.

Примеры

свернуть все

Скрипт Open Live Script

Запишите 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.

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

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

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

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

Создайте и запишите данные изображения истинного цвета в файл JPEG.

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

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'}
Скрипт Open Live Script

Запишите повторные изображения в один многостраничный файл 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.

Постройте для.

x = 0:0.01:1;
n = 3;
y = x.^n;
plot(x,y,'LineWidth',3)
title(['y = x^n,  n = ' num2str(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. Поскольку 3D данные не поддержаны для файлов 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-by-n.

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

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

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

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

scheme_name://path_to_file/my_file.ext

На основе вашего удаленного местоположения scheme_name может быть одним из значений в этой таблице.

Удаленное местоположениеscheme_name
Amazon S3™s3
Устройство хранения данных Windows Azure® Blobwasb, 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® Bitmap (BMP)

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

'gif'

GIF - формат обмена графическими данными

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

'hdf'

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

8-битные наборы данных растрового изображения с или без связанной палитры, 24-битных наборов данных растрового изображения

'jpg' или 'jpeg'

JPEG - формат графических данных JPEG

8-битные, 12-битные, и 16-битные Базовые изображения JPEG

Примечание

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

'jp2' или 'jpx'

JPEG 2000-форматов графических данных JPEG 2000

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

'pbm'

Портативный битовый массив (PBM)

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

'pcx'

Windows Paintbrush (PCX)

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

'pgm'

Портативный Graymap (PGM)

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

'png'

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

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

'pnm'

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

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

'ppm'

Портативная пиксельная карта (PPM)

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

'ras'

Растр Sun™ (RAS)

Любое изображение RAS, включая 1-битный битовый массив, 8-битный индексируемый, 24-битный истинный цвет и 32-битный истинный цвет с альфой

'tif' или 'tiff'

Теговый формат графических файлов (TIFF)

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

  • 1-битные, 8-битные, 16-битные, 24-битные, и 48-битные несжатые изображения и изображения с packbits, LZW, или Выкачивают сжатие

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

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

'xwd'

Дамп X-окон (XWD)

8-битный ZPixmaps

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

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (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 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, анимация вопроизводит дважды и так далее. Значение LoopCount Inf вызывает анимацию к постоянно циклу.

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

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

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

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

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

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

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

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

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

Режим Writing, заданный как пара, разделенная запятой, состоящая из '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

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

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

JPEG - формат графических данных 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, является более высоким качеством и более низким сжатием. Значение Quality 100 не пишет изображение JPEG без потерь. Вместо этого используйте аргумент пары "имя-значение" 'Mode','lossless'.

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

JPEG 2000-форматов графических данных JPEG 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, пиксельная карта

свернуть все

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

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

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

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

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

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

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

свернуть все

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

Примечание

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

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

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

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

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

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

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

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

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

Тип изображенияПозволенные значения для BitDepth
Полутоновые изображения1, 2, 4, 8 или 16
Полутоновые изображения с альфа-каналом8 или 16
Индексируемые изображения1, 2, 4 или 8
Изображения истинного цвета8 или 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' и вектора символов или представить скаляр в виде строки.

Уведомление об авторском праве, заданное как пара, разделенная запятой, состоящая из 'Copyright' и вектора символов или скаляра строки.

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

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

Заявление об отказе от ответственности, заданное как пара, разделенная запятой, состоящая из 'Disclaimer' и вектора символов или скаляра строки.

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

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

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

Значение ImageModTime по умолчанию является временем, когда вы вызываете imwrite.

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

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

Схема Interlacing, заданная как пара, разделенная запятой, состоящая из '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 элементами
Изображение истинного цвета без альфа-каналаВектор с 3 элементами
Изображение истинного цвета с альфа-каналомВектор с 4 элементами

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

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

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

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

Тип изображенияФорма значения Transparency
Полутоновые изображенияСкаляр в области значений [0,1], указывая на полутоновый цвет, который будет рассмотрен прозрачным.
Индексируемые изображенияВектор элемента Q- значений в области значений [0,1], где Q не больше, чем длина палитры и каждое значение, указывает на прозрачность, сопоставленную с соответствующей записью палитры. В большинстве случаев, Q = 1.
Изображения истинного цветаВектор с 3 элементами интенсивности 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 или меньше символов и не содержит продвижение или конечные пробелы. Значение, соответствующее этим пользовательским указанным именам, должно быть вектором символов или представить в виде строки скаляр, который не содержит управляющих символов кроме перевода строки.

RAS Графический растр Sun

свернуть все

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

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

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

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

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

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

TIFF - теговый формат графических файлов

свернуть все

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

  • 'rgb'

  • 'cielab'

  • 'icclab'

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

imwrite может записать данные о цветном изображении, которые используют L*a*b* цветовое пространство к файлам TIFF. 1 976 CIE L*a*b* спецификация задает числовые значения, которые представляют яркость (L*) и цветность (* и 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 добавляется и к* и к b* значения.

'icclab'

8-битный ICCLAB

'cielab'

8-битный CIELAB

16-битный ICCLAB


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

'icclab'

16-битный ICCLAB

'cielab'

16-битный CIELAB

С двойной точностью 1 976 CIE L*a*b* значения


L* находится в динамическом диапазоне [0, 100].* и b* может принять любое значение. Установка a* и 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

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

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

Советы

  • Дополнительные сведения см. в файле libtiffcopyright.txt.

Смотрите также

| | | | |

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

Документация MATLAB
Поддержка
Для просмотра документации необходимо авторизоваться на сайте