格式 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类型。

  • 如果未指定icc=,则可使用​ pixelType ​实现输出色彩空间转换。

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

  • 仅当将tiftif-alphapdfwebpwebp-alphajpeg2000jpeg2000-alphajpegxrjpegxr-alpha指定为​ format ​时才允许​ compression。 有关这些图像格式支持的压缩选项,请参阅下表。

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

对于所有​ formats ​和​ pixelTypes ​返回8位/像素组件(对于GIF,返回8位/像素)。

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

格式
pixelType
响应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为适用对象,而不考虑当前图层设置;否则将忽略。

如果指定了iccProfile=,则忽略​ type

默认 section-f885a785b32c44fea347db15fdb2ab1f

fmt=jpeg, *defaultType*,none,其中​ defaultType ​按如下方式处理:如果指定了icc=,则​ defaultType ​对应于指定ICC配置文件的像素类型。 如果未指定icc=,如果req=maskdefaultType ​为gray,否则为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=quantize=req=icc=iccEmbed=pathEmbed=pscan

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