格式 fmt

响应图像格式。

fmt=format[, [pixelType][compression]]

format - avif-alpha | avif | eps | f4m | gif-alpha | gif | heic | jpeg | jpeg2000-alpha | jpeg2000 | jpegxr-alpha | jpegxr | jpg | m3u8 | pdf | pjpeg | png-alpha | png | png8-alpha | png8 | swf-alpha | swf | swf3-alpha | swf3 | tif-alpha | tif | web-alpha | webp

format
说明
avif-alpha
带有Alpha通道的有损无损AVIF。
avif
有损、无损的AVIF。
eps
未压缩的二进制封装的PostScript。
f4m
Streaming Server清单格式Flash。
gif-alpha
2到255色GIF加上键色透明度。
gif
GIF为2到256色。
heic
无损HEIC。 如果不支持此格式,则默认从浏览器下载。
jpeg
JPEG有损。
jpeg2000-alpha
具有Alpha通道的有损和无损JPEG2000。
jpeg2000
有损和无损JPEG2000。
jpegxr-alpha
带Alpha通道的有损无损JPEGXR。
jpegxr
有损无损JPEGXR。
jpg
JPG有损。
m3u8
Apple流服务器清单格式。
pdf
嵌入到PDF中的图像。
pjpeg
渐进式JPEG。
png-alpha
带有Alpha通道的24位无损PNG。
png
24位无损PNG。
png8-alpha
带有Alpha通道的8位无损PNG。
png8
8位无损PNG。
swf-alpha
嵌入到AdobeAS2 swf文件中的有损JPEG和Deflate-Compressed掩码。
swf
嵌入到AdobeAS2 swf文件中的有损JPEG。
swf3-alpha
嵌入到AdobeAS3 swf文件中的有损JPEG和Deflate-Compressed掩码。 注意: swf和swf-alpha格式最适合ActionScript2应用程序(Flash Player8及更早版本)。 建议将swf3和swf3-alpha格式用于ActionScript3应用程序(Flash Player9及更高版本)。
swf3
嵌入到AdobeAS3 swf文件中的有损JPEG。
tif-alpha
带有Alpha通道的TIFF。
tif
TIFF。
webp-alpha
带有Alpha通道的有损无损WebP。
webp
有损无损WebP。

| pixelType - rgb | 灰色 | cmyk |

pixelType
说明
cmyk
返回CMYK图像数据。
gray
返回灰度图像数据。
rgb
返回RGB图像数据。

| compression - jpeg | 有损 | 无损 | lzw | 无 | zip |

compression
说明
jpeg
JPEG压缩(有损)。
lossy
JPEG2000、JPEGXR压缩(有损)和WebP。
lossless
HEIC、JPEG2000、JPEGXR压缩(无损)和WebP。
lzw
LZW (Lempel-Ziv-Welch)压缩(无损)。
none
未压缩。
zip
“Deflate”压缩(无损)。
  • format 指定发送到客户端的图像数据的图像编码格式以及HTTP响应标头对应的响应MIME类型。

  • pixelType 可以在以下情况下用于实现输出色彩空间转换 icc= 未指定。

    与对应的默认颜色配置文件 pixelType 中所有规则都适用的URL的区域。 如果禁用颜色管理,则应用朴素转换。 pixelType 被忽略的时间 icc= 指定,它确定输出像素类型。

  • compression 仅在 tiftif-alphapdfwebpwebp-alphajpeg2000jpeg2000-alphajpegxr,或 jpegxr-alpha 指定为 format. 有关这些图像格式支持的压缩选项,请参阅下表。

您可以使用 qlt= 为以下格式设置JPEG编码选项:JPEG、使用JPEG压缩的TIFF、使用JPEG压缩的PDF和SWF。 WebP、JPEG2000和JPEGXR也使用 qlt= 但是这些值会根据不同的格式产生不同的品质。 使用 quantize= 如果 fmt=giffmt=gif-alpha. 有关详细信息,请参阅命令说明。 其他格式没有可设置的选项。

对于所有像素,每像素组件返回8位 formatspixelTypes (GIF每像素8位)。

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

格式
像素类型
响应MIME类型
嵌入ICC配置文件
选项
avif,avif-alpha
rgb
<image/avif>

压缩 ( 有损 , 无损 )

qlt= 被忽略 无损 .

由于没有使用WebP格式进行色度缩减像素采样的概念,因此如果您使用第二个值 qlt (例如, qlt=80,1 )第二个值( 1 )将被忽略。

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

rgb,灰度

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

<image/gif>
量化=
heic
rgb
<image/heic>
jpeg2000, jpeg2000-alpha
rgb,灰度
<image/jp2>

压缩 ( 有损 , 无损 )

qlt= 被忽略 无损 .

由于没有使用WebP格式进行色度缩减像素采样的概念,因此如果您使用第二个值 qlt (例如, qlt=80,1 )第二个值( 1 )将被忽略。

jpeg, jpg, pjpeg
rgb、灰度、cmyk
<image/jpeg>

pathEmbed= , pscan= , qlt= , xmpEmbed=

此 pscan= 参数仅适用于pjpeg格式。

jpegxr, jpegxr-alpha
rgb
<image/vnd.ms-photo>

压缩 ( 有损 , 无损 )

qlt= 被忽略 无损 .

由于没有使用WebP格式进行色度缩减像素采样的概念,因此如果您使用第二个值 qlt (例如, qlt=80,1 )第二个值( 1 )将被忽略。

pdf
rgb、灰度、cmyk
<application/pdf>

压缩

( none|zip|jpeg ), qlt=

qlt= 被忽略,除非 压缩 设置为 jpeg .

png8, png8-alpha
rgb
<image/png>
png, png-alpha
rgb,灰度
<image/png>
swf,swf3, swf-alpha, swf-alpha3
rgb,灰度
<application/x-shockwave-flash>

注意:AdobeFlash Player会忽略嵌入的ICC配置文件。

qlt= , 属性::TrustedDomains
tif, tif-alpha
rgb、灰度、cmyk
<image/tiff>

压缩

( none|lzw|zip|jpeg )

仅限“tiff”;“tiff-alpha”不支持jpeg压缩。

qlt=

qlt= 被忽略,除非 压缩 设置为 jpeg .

, pathEmbed=, xmpEmbed=

webp, webp-alpha
rgb
<image/webp>

压缩 ( 有损 , 无损 )

qlt= 被忽略 无损 .

由于没有使用WebP格式进行色度缩减像素采样的概念,因此如果您使用第二个值 qlt (例如, qlt=80,1 )第二个值( 1 )将被忽略。

属性 section-5f96b0ce7c5a4df1bf52e24ea78c3dae

请求属性。 无论当前图层设置如何,在以下情况下均适用: req=img (默认)或 req=mask;否则忽略。

type 忽略以下情况 iccProfile= 已指定。

默认 section-f885a785b32c44fea347db15fdb2ab1f

fmt=jpeg, *默认类型*,none,其中 defaultType 按以下方式处理:如果 icc= 已指定, defaultType 对应于指定ICC配置文件的像素类型。 如果 icc= 未指定, defaultTypegray 如果 req=mask,否则为 rgb.

示例 section-b93222e652df404a84c69025247f07df

请求JPEG格式的低质量小型预览图像(默认):

http:// *服务器*/myRootId/myImageId?qlt=60&wid=200

请求将相同的图像转换为灰度:

http:// *服务器*/myRootId/myImageId?fmt=jpeg,gray&qlt=60&wid=200

请以Alpha通道的无损失格式和高分辨率请求相同的图像:

http:// *服务器*/myRootId/myImageId?fmt=png-alpha&wid=300

请求将同一图像作为灰度TIFF图像的Alpha通道:

http:// *服务器*/myRootId/myImageId?req=mask&fmt=tif,gray&wid=300

使用默认ICC配置文件将同一图像转换为cmyk:

http:// *服务器*/myRootId/myImageId?fmt=tif,cmyk&wid=300

使用其他ICC配置文件将同一图像转换为cmyk,并将配置文件嵌入到TIFF图像中:

http:// *服务器*/myRootId/myImageId?fmt=tif&wid=300&icc=myPrinterProfile&iccEmbed=1

将此图像作为TIF文件传递,无需转换像素类型即可进行JPEG压缩:

http:// *服务器*/myRootId/myImageId?fmt=tif,,jpeg&qlt=95&wid=300

将图像转换为具有键色透明度的双调GIF,并强制将颜色转换为黑白色:

http:// *服务器*/myRootId/myImageId?fmt=gif-alpha&wid=100&quantize=adaptive,off,2,000000,ffffff

质量设置为80时为有损:

http:// *服务器*/myRootId/myImageId?wid=300&fmt=webp&qlt=80

带有Alpha的无损:

http:// *服务器*/myRootId/myImageId?wid=300&fmt=webp-alpha,,lossless

质量设置为80时为有损:

http://server/myRootId/myImageId?wid=300&fmt=jpeg2000&qlt=80

带有Alpha的无损:

http://server/myRootId/myImageId?wid=300&fmt=jpeg2000-alpha,,lossless

质量设置为80时为有损:

http://server/myRootId/myImageId?wid=300&fmt=jpegxr&qlt=80

带有Alpha的无损:

http://server/myRootId/myImageId?wid=300&fmt=jpegxr-alpha,,lossless

另请参阅 section-fce8d69c74234bf48cf814d799409541

qlt=量化=需要=icc=iccEmbed=pathEmbed=pscan.

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