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 的值以硬件允许