格式

最近更新： 2024年7月20日
  • 主题：

创建对象：

  • 开发人员
  • 用户

回复图像格式。 指定发送到客户端的图像数据的图像编码格式以及HTTP响应标头对应的响应MIME类型。

fmt= *格式*[,[ *pixelType*][, *tiffCompression*]]

格式jpegJPEG有损。
jpgJPG有损。
png无损失PNG。
png-alpha带有Alpha通道的无损PNG。
tifTIFF。
tif-alpha带有Alpha通道的TIFF。
swf嵌入到Macromedia swf文件中的有损JPEG。
swf-alpha有损JPEG和嵌入到Macromedia swf文件中的Deflate-compressed蒙版。
pdf嵌入到PDF中的图像。
eps未压缩的二进制文件封装的PostScript。
gif256色GIF。
gif-alpha255色GIF加上键色透明度。
pixelTypergb返回RGB图像数据。
灰色返回灰度图像数据。
cmyk返回CMYK图像数据。
tiffCompression无未压缩。
lzwLZW (Lempel-Ziv-Welch)压缩（无损）。
zip“Deflate”压缩（无损）。
jpegJPEG压缩（有损）。

pixelType ​在未指定icc=时影响输出色彩空间转换；应用与​ pixelType ​对应的默认色彩配置文件。 如果禁用颜色管理，则应用朴素转换。 pixelType ​在指定icc=时忽略，它决定了输出像素类型。

compression ​仅在将tif、tif-alpha或PDF指定为​ format ​时才允许。 有关这些图像格式支持的压缩选项，请参阅下表。

qlt-为以下格式设置JPEG编码选项：JPEG、使用JPEG压缩的TIFF、使用JPEG压缩的PDF和SWF文件。 如果fmt=gif或fmt=gif-alpha，则使用quantize=。 有关详细信息，请参阅命令说明。 其他格式没有可设置的选项。

对于所有格式和像素类型，每像素分量将返回8位。

下表列出了​ format ​和​ pixelType ​的有效组合、相应的HTTP响应MIME类型、是否可以嵌入ICC配置文件（请参阅iccEmbed=），以及可以应用哪些特定于格式的选项命令。

格式pixelType响应MIME类型嵌入ICC配置文件选项
jpeg， jpgrgb、灰度、cmyk<image/jpeg>是qlt=
png， png-alphargb，灰度<image/png>是
png8， png8-alphargb<image/png>是
tif， tif-alphargb、灰度、cmyk<image/tiff>是

tiffCompression

(none|lzw|zip|jpeg)， pathEmbed=， qlt

（ qlt= 被忽略，除非 tiffCompression 设置为“jpeg”。）

swf， swf-alphargb，灰度<application/x-shockwave-flash>

否

(Flash Player会忽略嵌入的ICC配置文件。)

qlt= ，属性：：TrustedDomains
pdfrgb、灰度、cmyk<application/pdf>是

tiffCompression

(none|zip|jpeg)，qlt=

（ qlt= 被忽略，除非 tiffCompression 设置为“jpeg”。）

epsrgb、灰度、cmyk<image/eps>是pathEmbed=
gif， gif-alpha

rgb，灰度

（数据在转换为灰色或rgb后转换为调色板。）

<image/gif>否

指定发送到客户端的回复图像数据的编码格式以及HTTP回复标头对应的响应MIME类型。

png-alpha返回不相关的alpha（即，alpha不预乘像素值），而tif-alpha和swf-alpha返回相关的alpha（即，alpha值与alpha值预乘）。 Alpha通道对应于req=img的晕影的背景蒙版的反面，如果存在req=object，则对应到组或对象蒙版。 要在使用嵌套IR请求时应用Alpha，请将具有相应Alpha文件格式的fmt=添加到嵌入的IR请求和主请求中。 如果使用icc=指定CMYK或灰度ICC配置文件，则不会返回Alpha数据。