文档Dynamic Media图像服务和渲染API

格式 fmt

Last update: Wed Jul 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 开发人员
  • 用户

响应图像格式。

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，这决定了输出像素类型。

  • 仅当将tif、tif-alpha、pdf、webp、webp-alpha、jpeg2000、jpeg2000-alpha、jpegxr或jpegxr-alpha指定为​ format ​时才允许​ compression。 有关这些图像格式支持的压缩选项，请参阅下表。

您可以使用qlt=为以下格式设置JPEG编码选项：JPEG、使用JPEG压缩的TIFF、使用JPEG压缩的PDF和SWF。 WebP、JPEG2000和JPEGXR也使用qlt=，但是这些值导致不同格式的品质不同。 如果fmt=gif或fmt=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=mask，defaultType ​为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