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.

Постройте$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. Поскольку 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- n.

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

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

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

Для файлов GIF сверхкадра, A может быть m- n- 1 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
Amazon S3™s3
Устройство хранения данных Windows Azure® Blobwasb, wasbs
HDFS™hdfs

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

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

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

Палитра сопоставлена с индексируемыми данными изображения в AВ виде m- 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-битный истинный цвет отображает с альфа-каналами

Примечание

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

'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 имя аргумента и 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- 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- n) и истинный цвет (m- n- 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- n- 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- n- 3). Чтобы использовать цветовое пространство CMYK в файле TIFF, не используйте 'ColorSpace' аргумент пары "имя-значение". Вместо этого задайте m- n- 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

Поддержка

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