A - 图像数据

矩阵

图像数据，指定为满(非稀疏)矩阵。

对灰度图像而言，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 中指定文件名。

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_nameAmazon S3™s3

Windows Azure® Blob Storagewasb、wasbs

HDFS™hdfs

有关详细信息，请参阅处理远程数据。

示例：'s3://bucketname/path_to_file/my_image.jpg'

数据类型：char | string

map - 索引图像的颜色图

m×3 数组

A 中与索引图像数据相关联的颜色图，指定为 m×数组。map 必须是有效的 MATLAB 颜色图。请参阅 colormap 以了解 MATLAB 内置颜色图列表。大多数图像文件格式都不支持条目数超过 256 个的颜色图。

示例：[0,0,0;0.5,0.5,0.5;1,1,1]

示例：jet(60)

数据类型：double

fmt - 输出文件格式

'bmp' | 'gif' | 'hdf' | 'jpg' | 'jp2' | ...

输出文件的格式，指定为下表中的格式之一。

此表还概述了 imwrite 可写入的图像类型。MATLAB 文件格式注册表会确定支持哪些文件格式。有关此注册表的详细信息，请参阅 imformats。

对某些格式而言，imwrite 可以接受其他名称-值对组参数。要查看这些参数，可点击下面的链接格式名称。

fmt 的值输出文件格式说明'bmp'Windows® 位图 (BMP)1 位、8 位和 24 位未压缩图像

'hdf'带或不带关联颜色图的 8 位光栅图像数据集、24 位光栅图像数据集

'jpg' 或 'jpeg'8 位、12 位和 16 位基准 JPEG 图像

注意

imwrite 会先将索引图像转换为 RGB 图像，然后再将数据写入 JPEG 文件，因为 JPEG 格式不支持索引图像。

'jp2' 或 'jpx'1 位、8 位 和 16 位 JPEG 2000 图像

'pbm'任何 1 位 PBM 图像、ASCII(普通)或原始(二进制)编码

'pcx'Windows 画笔 (PCX)8 位图像

'pgm'任何标准 PGM 图像；使用任意颜色深度编码的 ASCII(普通)图像；每个灰度值最多使用 16 位编码的原始(二进制)图像

'png'1 位、2 位、4 位、8 位和 16 位灰度图像；带有 alpha 通道的 8 位和 16 位灰度图像；1 位、2 位、4 位和 8 位索引图像；24 位和 48 位真彩色图像；带有 alpha 通道的 24 位和 48 位真彩色图像

注意

imwrite 函数不支持写入颜色图条目不足的索引 PNG 文件。

'pnm'自动选择的 PPM/PGM/PBM 任意格式

'ppm'任何标准 PPM 图像：使用任意颜色深度编码的 ASCII(普通)图像，或每个颜色分量最多使用 16 位编码的原始(二进制)图像

'ras'任何 RAS 图像，包括 1 位位图、8 位索引图像、带有 alpha 的 24 位真彩色图像和 32 位真彩色图像

'tif' 或 'tiff'基线 TIFF 图像，包括：

1 位、8 位、16 位、24 位和 48 位未压缩的图像以及采用 Packbit 、LZW 或 Deflate 压缩的图像

采用 CCITT 1D、Group 3 和 Group 4 压缩的 1 位图像

CIELAB、ICCLAB 和 CMYK 图像

'xwd'X 窗口转储 (XWD)8 位 ZPixmaps

名称-值对组参数

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称，Value 为对应的值。Name 必须放在引号中。您可采用任意顺序指定多个名称-值对组参数，如 Name1,Value1,...,NameN,ValueN 所示。示例：imwrite(A,'myFile.png','BitDepth',8) 使用可表现每个像素的 8 位图像将数据写入 A 中。

GIF - 图形交换格式

'BackgroundColor' - 要用作背景色的颜色

整数标量

用作索引图像背景色的颜色，指定为逗号分隔的对组，包含 'BackgroundColor' 和与颜色图索引对应的整数标量。

背景色用于一些 GIF 动画的处置方法。

如果图像数据 A 是 uint8 或 logical，则颜色图索引从 0 开始。

如果图像数据 A 是 double，则颜色图索引从 1 开始。

默认背景色对应于颜色图中的第一个颜色。

示例：'BackgroundColor',15

'Comment' - 添加到图像的注释

字符向量 | 字符串标量 | 字符向量元胞数组 | 字符串数组

要为图像添加的注释，指定为逗号分隔的对组，其中包含 'Comment' 和一个字符向量、字符串标量或 1×n 字符向量元胞数组或字符串数组。对于字符向量元胞数组，imwrite 会在每个字符向量后面添加一个回车符。

示例：'Comment',{'Sample #314','January 5,

2013'}

数据类型：char | cell | string

'DelayTime' - 显示下一个图像之前的时滞

0.5 (默认) | 范围 [0，655] 内的标量值

显示下一个图像之前的时滞(秒)，指定为逗号分隔的对组，包含 'DelayTime' 和范围 [0，655] 内的标量值。0 的值以硬件允许的最快速度显示图像。

示例：'DelayTime',60

'DisposalMethod' - GIF 动画的处置方法

'doNotSpecify' (默认) | 'leaveInPlace' | 'restoreBG' | 'restorePrevious'

GIF 动画的处置方法，指定为逗号分隔的对组，其中包含 'DisposalMethod' 和下表中的方法之一。

DisposalMethod 的值结果'doNotSpecify'(默认值)用另一个帧来替代一个完全尺寸的不透明的帧。

'leaveInPlace'没有被下一帧覆盖的任何像素都将继续显示。

'restoreBG'背景色或背景图块通过透明的像素显示。

'restorePrevious'恢复到以前未处理的帧状态。

示例：'DisposalMethod','restoreBG'

'Location' - 屏幕相对图像的偏移

[0,0] (默认) | 二元素向量

屏幕相对图像的偏移(从每个图像的左上角测量)，指定为逗号分隔的对组，包含 'Location' 和一个二元素向量。第一个向量元素指定自顶部的偏移，第二个元素指定自左侧的偏移，均以像素为单位。

示例：'Location',[10,15]

数据类型：double

'LoopCount' - 重复动画的次数

Inf (默认) | 范围 [0,65535] 内的整数

重复动画的次数，指定为以逗号分隔的对组，包含 'LoopCount' 和 [0,65535] 范围内的整数或 Inf 值。如果指定 0，动画将播放一次。如果指定值 1，动画将播放两次，以此类推。Inf 的 LoopCount 值可使动画连续循环。

要在 Microsoft® PowerPoint® 中启用动画，请为 'LoopCount' 指定 [1,65535] 范围内的值。某些 Microsoft 应用程序会将值 0 的含义解释为根本不进行循环。

示例：'LoopCount',3

'ScreenSize' - 帧的高度和宽度

输入图像的高度和宽度 (默认) | 二元素向量

帧的高度和宽度，指定为以逗号分隔的对组，包含 'ScreenSize' 和一个二元素向量。当与 ScreenSize 结合使用时，'Location' 提供了一种将帧写入小于整个帧的图像的方法。'DisposalMethod' 确定用于帧外部的像素的填充值。

示例：'ScreenSize',[1000 1060]

数据类型：double

'TransparentColor' - 用作透明色的颜色

整数标量

用作图像透明色的颜色，指定为逗号分隔的对组，包含 'TransparentColor' 和与颜色图索引对应的整数标量。

如果图像数据 A 是 uint8 或 logical，则索引从 0 开始。

如果图像数据 A 是 double，则索引从 1 开始。

示例：'TransparentColor',20

'WriteMode' - 写入模式

'overwrite' (默认) | 'append'

写入模式，指定为逗号分隔的对组，包含 'WriteMode' 和 'overwrite' 或 'append'。在 overwrite 模式下，imwrite 覆盖现有文件 filename。在 append 模式下，imwrite 会向现有文件添加单个帧。

示例：'WriteMode','append'

HDF4 - 分层数据格式

'Compression' - 压缩方案

'none' (默认) | 'jpeg' | 'rle'

压缩方案，指定为逗号分隔的对组，其中包含 'Compression' 和下表中的选项之一。

Compression 的值结果'none'(默认值)无压缩

'jpeg'JPEG 压缩。仅对灰度图像和 RGB 图像有效。

'rle'行程长度编码。仅对灰度图像和索引图像有效。

示例：'Compression','jpeg'

'Quality' - JPEG 压缩文件的质量

75 (默认) | 范围 [0，100] 内的标量

JPEG 压缩文件的质量，指定为以逗号分隔的对组，包含 'Quality' 和范围 [0，100] 内的标量，其中 0 表示较低质量和较高的压缩率，100 表示较高质量和较低的压缩率。此参数仅适用于 'Compression' 是 'jpeg' 的情况。

示例：'Quality',25

'WriteMode' - 写入模式

'overwrite' (默认) | 'append'

写入模式，指定为逗号分隔的对组，包含 'WriteMode' 和 'overwrite' 或 'append'。在 overwrite 模式下，imwrite 覆盖现有文件 filename。在 append 模式下，imwrite 会向现有文件添加单个帧。

示例：'WriteMode','append'

JPEG - 联合图像专家组

'BitDepth' - 每像素位数

8 (默认) | 标量

每像素位数，指定为以逗号分隔的对组，包含 'BitDepth' 和一个标量。

对于灰度图像，BitDepth 值可以是 8、12 或 16。默认值为 8。对于 16 位图像，'Mode' 名称-值对组参数必须为 'lossless'。

对彩色图像，BitDepth 的值是每平面的位数，可以是 8 或 12 位。每平面的默认值为 8 位。

示例：'BitDepth',12

'Comment' - 添加到图像的注释

字符向量 | 字符数组 | n×1 字符向量元胞数组

要为图像添加的注释，指定为逗号分隔的对组，其中包含 'Comment' 和一个字符向量、字符串标量、字符数组、由字符向量构成的 n×1 元胞数组，或字符串数组。imwrite 将每一行输入作为一个注释写入 JPEG 文件。

示例：'Comment',{'First line';'second line';'third

line'}

数据类型：char | string | cell

'Mode' - 压缩类型

'lossy' (默认) | 'lossless'

压缩类型，指定为逗号分隔的对组，其中包含 'Mode' 和下列选项之一：

'lossy'

'lossless'

示例：'Mode','lossless'

'Quality' - 输出文件质量

75 (默认) | 范围 [0，100] 内的标量

输出文件的质量，指定为以逗号分隔的对组，包含 'Quality' 和范围 [0，100] 内的标量，其中 0 表示较低质量和较高的压缩率，100 表示较高质量和较低的压缩率。100 的 Quality 值不会写入无损压缩的 JPEG 图像。相反，会使用 'Mode','lossless' 名称-值对组参数。

示例：'Quality',100

JPEG 2000 - 联合图像专家组 2000

'Comment' - 添加到图像的注释

字符向量 | 字符串标量 | 字符数组 | n×1 字符向量元胞数组 | 字符串数组

要为图像添加的注释，指定为逗号分隔的对组，其中包含 'Comment' 和一个字符向量、字符数组、字符串标量、字符向量元胞数组或字符串数组。imwrite 将每一行输入作为一个注释写入 JPEG 2000 文件。

示例：'Comment',{'First line';'second line';'third

line'}

示例：'Comment',{'First line','second line','third

line'}

数据类型：cell | char | string

'CompressionRatio' - 目标压缩比

1 (默认) | 标量

目标压缩比，指定为逗号分隔的对组，包含 'CompressionRatio' 和大于或等于 1 的实数标量。压缩比是输入图像大小与输出压缩大小之比。例如，值为 2.0 表示输出图像大小将是输入图像大小的一半或更小。值越高，表示文件大小越小，图像质量越低。压缩比不考虑标头大小。

指定 CompressionRatio 仅在 'Mode' 是 'lossy' 时有效。

示例：'CompressionRatio',3

'Mode' - 压缩类型

'lossy' (默认) | 'lossless'

压缩类型，指定为逗号分隔的对组，其中包含 'Mode' 和下列选项之一：

'lossy'

'lossless'

示例：'Mode','lossless'

'ProgressionOrder' - 代码流中数据包的顺序

'LRCP' (默认) | 'RLCP' | 'RPCL' | 'PCRL' | 'CPRL'

代码流中数据包的顺序，指定为逗号分隔的对组，其中包含 'ProgressionOrder' 和下列选项之一：

'LRCP'

'RLCP'

'RPCL'

'PCRL'

'CPRL'

字符分别代表如下内容：L = 层，R = 分辨率，C = 分量，P = 位置。

示例：'ProgressionOrder','RLCP'

'QualityLayers' - 质量层数

1 (默认) | 范围 [1，20] 内的整数

质量层数，指定为逗号分隔的对组，包含 'QualityLayers' 和范围 [1，20] 内的整数。

示例：'QualityLayers',8

'ReductionLevels' - 还原级数

4 (默认) | 范围 [1，8] 内的整数

还原级数或小波分解级数，指定为逗号分隔的对组，包含 'ReductionLevels' 和范围 [1，8] 内的整数。

示例：'ReductionLevels',6

'TileSize' - 图块高度和宽度

图像尺寸 (默认) | 二元素向量

图块高度和宽度，指定为以逗号分隔的对组，包含 'TileSize' 和一个二元素向量。可指定的最小尺寸为 [128 128]。

示例：'TileSize',[130 130]

PBM-、PGM- 和 PPM - 可移植位图、灰度图、像素图

'Encoding' - 编码

'rawbits' (默认) | 'ASCII'

编码，指定为以逗号分隔的对组，包含 'Encoding' 和二进制编码的 'rawbits' 或普通编码的 'ASCII'。

示例：'Encoding','ASCII'

'MaxValue' - 最大灰色或颜色值

标量

最大灰色或颜色值，指定为以逗号分隔的对组，包含 'MaxValue' 和一个标量。

仅适用于 PGM 和 PPM 文件。对于 PBM 文件，该值始终为 1。

如果图像数组为 uint16，则 MaxValue 的默认值为 65535。否则，默认值为 255。

示例：'MaxValue',510

PNG - 可移植网络图形

'Alpha' - 每个像素的透明度

范围 [0，1] 内的值矩阵

每个像素的透明度，指定为逗号分隔的对组，包含 'Alpha' 和范围 [0，1] 内的值矩阵。Alpha 矩阵的行和列维度都必须与图像数据数组的相同。仅可为灰度(m×n)和真彩色(m×n×3)图像数据指定 Alpha。

注意

您不能同时指定 'Alpha' 和 'Transparency'。

数据类型：double | uint8 | uint16

'Author' - 作者信息

字符向量 | 字符串标量

作者信息，指定为逗号分隔的对组，其中包含 'Author' 和一个字符向量或字符串标量。

示例："Author','Ann Smith'

数据类型：char

'Background' - 合成透明像素时的背景色

范围 [0,1] 中的标量 | 范围 [1,P] 内的整数 | 范围 [0,1] 内的三元素向量

合成透明像素时的背景色，指定为逗号分隔的对组，包含 'Background' 和依赖于图像数据的值，具体如下。

图像类型Background 值的格式灰度图像范围 [0,1] 内的标量。

索引图像[1,P] 范围内的整数，其中 P 是颜色图长度。例如，'Background',50 将背景色设置为颜色图中第 50 个索引指定的颜色。

真彩色图像范围 [0,1] 内 RGB 强度的三元素向量。例如，'Background',[0 1

1] 将背景色设置为青色。

数据类型：double

'BitDepth' - 每像素位数

标量

每像素位数，指定为以逗号分隔的对组，包含 'BitDepth' 和一个标量。根据输出图像，标量可以是下列值之一。

图像类型BitDepth 的允许值灰度图像1、2、4、8 或 16

带有 alpha 通道的灰度图像8 或 16

索引图像1、2、4 或 8

真彩色图像8 或 16

如果图像属于 double 或 uint8 类，则默认位深是 8 位/像素。

如果图像是 uint16，则默认值是 16 位/像素。

如果图像是 logical，则默认值是 1 位/像素。

示例：'BitDepth',4

'Chromaticities' - 参考白和原色色度

8 元素向量

参考白和原色色度，指定为逗号分隔的对组，包含 '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' - 添加到图像的注释

字符向量 | 字符串标量

为图像添加的注释，指定为逗号分隔的对组，其中包含 'Comment' 和一个字符向量或字符串标量。

'Copyright' - 版权声明

字符向量 | 字符串标量

版权声明，指定为逗号分隔的对组，其中包含 'Copyright' 和一个字符向量或字符串标量。

'CreationTime' - 原图创建的时间

字符向量 | 字符串标量

原图创建的时间，指定为字符向量或字符串标量。

'Description' - 图像的描述

字符向量 | 字符串标量

图像说明，指定为逗号分隔的对组，其中包含 'Description' 和一个字符向量或字符串标量。

'Disclaimer' - 法律免责声明

字符向量 | 字符串标量

法律免责声明，指定为逗号分隔的对组，其中包含 'Disclaimer' 和一个字符向量或字符串标量。

'Gamma' - 文件的 gamma 值

标量

文件的 gamma 值，指定为以逗号分隔的对组，包含 'Gamma' 和一个字符串。

示例：'Gamma',2.2

'ImageModTime' - 图像最后修改的时间

日期序列值 | 包含日期的字符向量或字符串标量

上次修改图像的时间，指定为逗号分隔的对组，其中包含 'ImageModTime' 和一个 MATLAB 日期序列值或日期字符向量或字符串标量，该字符向量可使用 datevec 函数转换为日期向量。值应为协调世界时 (UTC)。

ImageModTime 的默认值是调用 imwrite 的时间。

示例：'ImageModTime','17-Jan-2013 11:23:10'

数据类型：double | char | string

'InterlaceType' - 隔行扫描方案

'none' (默认) | 'adam7'

隔行扫描方案，指定为逗号分隔的对组，包含 'InterlaceType' 以及关于非隔行扫描的 'none' 或使用 Adam7 算法的 'adam7'。

示例：'InterlaceType','adam7'

'ResolutionUnit' - 图像分辨率单位

'unknown' (默认) | 'meter'

图像分辨率单位，指定为以逗号分隔的对组，包含 'ResolutionUnit' 和 'unknown' 或 'meter'。如果指定 ResolutionUnit，则必须至少包括 XResolution 和 YResolution 名称-值对组参数之一。当 ResolutionUnit 的值为 'meter' 时，XResolution 和 YResolution 的值解释为像素/米。

示例：'ResolutionUnit','meter','XResolution',1000

'SignificantBits' - 视作有效的位数

[] (默认) | 标量 | 向量

数据数组中视为有效的位数，指定为逗号分隔的对组，包含 'SignificantBits' 和范围 [1，BitDepth] 内的一个标量或向量。根据输出图像类型，该值必须有以下格式。

图像类型SignificantBits 值的格式不带 alpha 通道的灰度图像标量

带有 alpha 通道的灰度图像2 元素向量

索引图像3 元素向量

不带 alpha 通道的真彩色图像3 元素向量

带有 alpha 通道的真彩色图像4 元素向量

示例：'SignificantBits',[2,3]

'Software' - 用于创建图像的软件

字符向量 | 字符串标量

用于创建图像的软件，指定为逗号分隔的对组，其中包含 'Software' 和一个字符向量或字符串标量。

'Source' - 用于创建图像的设备

字符向量 | 字符串标量

用于创建图像的设备，指定为逗号分隔的对组，其中包含 'Source' 和一个字符向量或字符串标量。

'Transparency' - 视为透明的像素

[] (默认) | 范围 [0，1] 内的标量 | 向量

没有使用 alpha 通道时视为透明的像素，指定为以逗号分隔的对组，包含 'Transparency' 和一个字符串或向量。根据输出图像类型，该值必须具有以下格式。

图像类型Transparency 值的格式灰度图像范围 [0,1] 内的标量，表示视为透明的灰度颜色。

索引图像[0，1] 范围值的 Q- 元素向量，其中 Q 不超过颜色图长度，并且每个值指示与对应的颜色图条目关联的透明度。在大多数情况下，Q = 1。

真彩色图像范围 [0，1] 内 RGB 强度的 3 元素向量，表示视为透明的真彩色颜色。

注意

您不能同时指定 'Transparency' 和 'Alpha'。

示例：'Transparency',[1 1 1]

数据类型：double

'Warning' - 内容性质警告

字符向量 | 字符串标量

内容性质警告，指定为逗号分隔的对组，其中包含 'Warning' 和一个字符向量或字符串标量。

'XResolution' - 水平方向的图像分辨率

标量

水平方向的图像分辨率(单位为像素)，指定为逗号分隔的对组，包含 'XResolution' 和一个标量。通过指定 ResolutionUnit 名称-值对组参数来定义单位。

如果还没有指定 YResolution，则 XResolution 值同时适用于水平和垂直方向。

示例：'XResolution',900

'YResolution' - 垂直方向的图像分辨率

标量

垂直方向的图像分辨率(单位为像素)，指定为逗号分隔的对组，包含 'XResolution' 和一个标量。通过指定 ResolutionUnit 名称-值对组参数来定义单位。

如果还没有指定 XResolution，则 YResolution 值同时适用于水平和垂直方向。

示例：'YResolution',900

除了列出的适合 PNG 的名称-值对组参数之外，还可以使用满足 PNG 关键字设定的任何参数名称。也就是说，该名称只能使用可打印字符，包含 80 个或更少的字符，并且不包含前导或尾随空格。与用户指定的这些名称对应的值必须为不包含换行符以外的任何控制字符的字符向量或字符串标量。

RAS - Sun 光栅图形

'Alpha' - 每个像素的透明度

[] (默认) | 矩阵

每个像素的透明度，指定为逗号分隔的对组，包含 'Alpha' 和一个与图像数据数组具有相同的行和列维度的矩阵。

仅对真彩色(m×n×3)图像数据有效。

数据类型：double | single | uint8 | uint16

'Type' - 图像类型

'standard' (默认) | 'rgb' | 'rle'

图像类型，指定为逗号分隔的对组，其中包含 'Type' 和下表中的选项之一。

Type 的值说明'standard'(默认值)真彩色图像未压缩的 B-G-R 色序

'rgb'真彩色图像未压缩的 R-G-B 色序

'rle1 位和 8 位图像的行程编码

示例：'Type','rgb'

TIFF - 标记图像文件格式

'ColorSpace' - 表示颜色数据的颜色空间

'rgb' (默认) | 'cielab' | 'icclab'

表示颜色数据的颜色空间，指定为逗号分隔的对组，其中包含 'ColorSpace' 和下列选项之一：

'rgb'

'cielab'

'icclab'

仅当图像数据数组 A 为真彩色(m×n×3)时有效。要在 TIFF 文件中使用 CMYK 颜色空间，请不要使用 'ColorSpace' 名称-值对组参数。相反，应指定一个 m×n×4 图像数据数组。

imwrite 可以将使用 L*a*b* 颜色空间的彩色图像数据写入 TIFF 文件。1976 CIE L*a*b* 设定定义了表示亮度 (L*) 与色度(a* 和 b*)信息的数值。要将 L*a*b* 颜色数据存储在 TIFF 文件中，这些值必须经过编码以适合 8 位或 16 位数据存储。 imwrite 可以使用以下编码将 L*a*b* 颜色数据存储在 TIFF 文件：

CIELAB 编码 - 由 TIFF 规范定义的 8 位和 16 位编码

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

双精度的 1976 CIE L*a*b* 值

L* 位于 [0, 100] 动态范围中。a* 和 b* 可以接受任何值。将 a* 和 b* 设置为 0(零)会生成一种中性颜色(灰色)。'icclab'8 位 ICCLAB

'cielab'8 位 CIELAB

示例：'ColorSpace','cielab'

'Compression' - 压缩方案

'packbits' | 'none' | 'lzw' | 'deflate' | 'jpeg' | 'ccitt' | 'fax3' | 'fax4'

压缩方案，指定为逗号分隔的对组，其中包含 'Compression' 和下列选项之一：

'packbits'(非二值图像的默认值)

'none'

'lzw'

'deflate'

'jpeg'

'ccitt'(仅限于二值图像，此类图像的默认值)

'fax3'(仅限于二值图像)

'fax4'(仅限于二值图像)

'jpeg' 是一种有损压缩方案；其他压缩模式为无损压缩。此外，如果您指定 'jpeg' 压缩，则还必须指定 'RowsPerStrip' 参数并且该值必须为 8 的倍数。

示例：'Compression','none'

'Description' - 图像描述

字符向量 | 字符串标量

图像描述，指定为逗号分隔的对组，其中包含 'Description' 和一个字符向量或字符串标量。这是 imfinfo 返回到输出图像的 ImageDescription 字段内的文本。

示例：'Description','Sample 2A301'

'Resolution' - X 分辨率和 Y 分辨率

72 (默认) | 标量 | 二元素向量

X 分辨率和 Y 分辨率，指定为逗号分隔的对组，包含 'Resolution' 和表示 X 分辨率和 Y 分辨率或包含 X 分辨率和 Y 分辨率的二元素向量的标量。

示例：'Resolution',80

示例：'Resolution',[320,72]

数据类型：double

'RowsPerStrip' - 包含在每个条带中的行数

标量

包含在每个条带中的行数，指定为以逗号分隔的对组，包含 'RowsPerStrip' 和一个标量。默认值将使每个条带约为 8K 字节。

如果您指定 'jpeg' 压缩，则还必须指定 RowsPerStrip 参数。该值必须为 8 的倍数。

示例：'RowsPerStrip',16

数据类型：double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

'WriteMode' - 写入模式

'overwrite' (默认) | 'append'

写入模式，指定为逗号分隔的对组，包含 'WriteMode' 和 'overwrite' 或 'append'。在 overwrite 模式下，imwrite 覆盖现有文件。在 append 模式下，imwrite 会向现有文件添加一页。

示例：'WriteMode','append'