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 仅当将 tif、 tif-alpha、 pdf、 webp、 webp-alpha、 jpeg2000、 jpeg2000-alpha jpegxr或 jpegxr-alpha 指定为 format​时，才允许使用。有关这些图像格式支持的压缩选项，请参阅下表。

可以使用qlt=为以下格式设置JPEG编码选项：JPEG、带JPEG压缩的TIFF、带JPEG压缩的PDF和SWF。 WebP、JPEG 2000和JPEG XR也使用qlt=，但值会导致不同格式的质量不同。 如果为fmt=gif或fmt=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。

在此页面上