格式 fmt

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

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

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

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

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

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

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

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

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

tiffCompression

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

( qlt= 被忽略,除非 tiffCompression 设置为“jpeg”。)

swf, swf-alpha
rgb,灰度
<application/x-shockwave-flash>

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

qlt= ,属性::TrustedDomains
pdf
rgb、灰度、cmyk
<application/pdf>

tiffCompression

(none|zip|jpeg),qlt=

( qlt= 被忽略,除非 tiffCompression 设置为“jpeg”。)

eps
rgb、灰度、cmyk
<image/eps>
pathEmbed=
gif, gif-alpha

rgb,灰度

(数据在转换为灰色或rgb后转换为调色板。)

<image/gif>

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

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

属性 section-eb12a82c69d84622bcea153dd84d95b3

可以在请求中的任意位置发生。

默认 section-d2c2af11fa974e1a84e0c6cb7fb646fe

format ​默认为attribute::FormattiffCompression ​默认为attribute::TiffEncodingpixelType ​如果未指定icc=,则默认为rgb,否则它对应于指定ICC配置文件的像素类型。

另请参阅 section-c55efc881fc94c70bff91b870e026a7b

attribute::Formatattribute::JpegQualityattribute::TiffEncodingqlt=iccEmbed=pathEmbed=req=quantize=

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49