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，此格式的發行時間表：
北美 — 現已提供
歐洲、中東、非洲 - 2021年6月28日
亞太 - 2021年6月29日
avif 有損和無損的AVIF

此格式的發行時間表：
​北美 — 現已提供
歐洲、中東、非洲 - 2021年6月28日
亞太 - 2021年6月29日
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和嵌入到AdobeAS2swf檔案的減縮壓縮掩碼
swf 嵌入到AdobeAS2swf檔案中的有損JPEG
swf3-alpha 有損JPEG和嵌入到AdobeAS3swf檔案中的減縮壓縮掩碼。 注意： 最適合ActionScript2應用程式(Flash Player8及更舊版本)的swf和swf-alpha格式。建議將swf3和swf3-alpha格式用於ActionScript3應用程式(Flash Player9和更新版本)
swf3 有損JPEG嵌入到AdobeAS3swf檔案中
tif-alpha 含Alpha通道的TIFF
tif TIFF
webp-alpha 帶Alpha通道的有損和無損WebP
webp 有損和無損WebP

| pixelType – rgb | 灰色 | cmy |

pixelType 說明
cmyk 返回CMYK影像資料。
gray 傳回灰階影像資料。
rgb 返回RGB影像資料。

| compression – none | lzw | 郵遞區號 | jpeg | 有損 | 無損 |

compression 說明
jpeg JPEG壓縮（有損）
lossy WebP、JPEG 2000和JPEG XR壓縮（有損）
lossless WebP、JPEG 2000和JPEG XR壓縮（無損）
lzw LZW(Lempel-Ziv-Welch)壓縮（無損）
none 未壓縮
zip "Deflate"壓縮（無損）

  • 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、TIFF（含JPEG壓縮）、PDF（含JPEG壓縮）和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=，如果req=mask，則​defaultType​為gray，否則為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

以JPEG壓縮的TIF檔案形式傳送此影像，而不進行像素類型轉換：

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。

本頁內容