fmt

响应图像格式。

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

format - avif-alpha | avif | eps | f4m | gif-alpha | gif | 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 Flash流服务器清单格式。
gif-alpha 2到255色加上键色透明度的GIF动图。
gif 2到256色的GIF。
jpeg 有损JPEG。
jpeg2000-alpha 带Alpha通道的有损和无损JPEG 2000。
jpeg2000 有损和无损JPEG 2000。
jpegxr-alpha 带Alpha通道的有损和无损JPEG XR。
jpegxr 有损和无损JPEG XR。
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 有损JPEG和嵌入到AdobeAS2 swf文件中的通缩压缩蒙版。
swf 嵌入到AdobeAS2 swf文件中的有损JPEG。
swf3-alpha 有损JPEG和嵌入到AdobeAS3 swf文件中的通缩压缩蒙版。 注意: 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 | 灰色 | cmy |

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

| compression – none | lzw | zip | jpeg | 有损 | 无损 |

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

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

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

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

可以使用qlt=为以下格式设置JPEG编码选项:JPEG、带JPEG压缩的TIFF、带JPEG压缩的PDF和SWF。 WebP、JPEG 2000和JPEG XR也使用qlt=,但值会导致不同格式的质量不同。 如果为fmt=giffmt=gif-alpha,则使用quantize=。 有关详细信息,请参阅命令描述。 其他格式没有可设置的选项。

为所有​formats​和​pixelTypes​返回每像素8位的组件(GIF为每像素8位)。

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

格式 pixelType 响应MIME类型 嵌入ICC配置文件 选项

jpeg, jpg, pjpeg

rgb,灰色,cmyk

<image>

pathEmbed= , pscan= , qlt= , xmpEmbed=

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

png, png-alpha

rgb,灰色

<image>

png8、png8-alpha

rgb

<image>

tif, tif-alpha

rgb,灰色,cmyk

<image>

压缩

无|lzw|zip|jpeg

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

qlt=

除非将 压缩设置 jpeg,否则将 忽略qlt =

, pathEmbed=, xmpEmbed=

swf,swf3,swf-alpha,swf-alpha3

rgb,灰色

<application>

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

qlt= , 属性::TrustedDomains

pdf

rgb,灰色,cmyk

<application>

压缩

无|zip|jpeg , qlt=

除非将 压缩设置 jpeg,否则将 忽略qlt =

eps

rgb,灰色,cmyk

<image>

pathEmbed=

gif,gif-alpha

rgb,灰色

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

<image>

数量=

webp、webp-alpha

rgb

<image>

缩( 有损 、无 )

qlt=会 忽略无

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

jpeg2000、jpeg2000-alpha

rgb,灰色

<image>

与上文相同。

jpegxr, jpegxr-alpha

rgb

<image>

与上文相同。

阿维夫、阿维夫 — 阿尔法

rgb

<image>

与上文相同。

属性

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

type 如果指定, iccProfile= 则忽略。

默认

fmt=jpeg, *defaultType*,none,其中 defaultType 的处理方式如下:如果 icc= 指定,则对 defaultType 应于指定ICC配置文件的像素类型。如果未指定icc=,则​defaultType​为gray(如果为req=mask),否则为rgb

示例

请求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

另请参阅

qlt= , quantize=, req=, icc=, iccEmbed=, pathEmbed=, pscan

在此页面上