文件Dynamic Media影像提供與轉譯API

fmt

最後更新: 2024年7月22日
  • 主題:

建立對象:

  • 開發人員
  • 使用者

回覆影像格式。 指定傳送至使用者端之影像資料的影像編碼格式,以及HTTP回應標題的對應回應MIME型別。

fmt= *格式*[,[ *pixelType*][, *tiffCompression*]]

格式jpeg有損JPEG。
jpgJPG有損。
png無遺失的PNG。
png-alpha含Alpha色版的無損PNG。
tifTIFF。
tif-alpha使用Alpha色版TIFF。
swf內嵌於Macromedia swf檔案中的有損JPEG。
swf-alpha有損JPEG和嵌入到Macromedia swf檔案中的Deflate壓縮遮色片。
pdf內嵌於PDF中的影像。
eps未壓縮的二進位封裝的PostScript。
gif256色GIF。
gif-alpha255色GIF加上關鍵色彩透明度。
pixelTypergb傳回RGB影像資料。
灰色傳回灰階影像資料。
cmyk傳回CMYK影像資料。
tiffCompression無未壓縮。
lzwLZW (Lempel-Ziv-Welch)壓縮(不失真)。
郵遞區號"Deflate"壓縮(不失真)。
jpegJPEG壓縮(失真)。

未指定icc=時,pixelType ​效果輸出色域轉換;套用與​ pixelType ​對應的預設色彩設定檔。 如果停用色彩管理,則會套用天真的轉換。 指定icc=時會略過​ pixelType,這會決定輸出畫素型別。

compression ​只有在指定tif、tif-alpha或PDF為​ format ​時才允許。 如需這些影像格式支援的壓縮選項,請參閱下表。

qlt-設定下列格式的JPEG編碼選項:JPEG、使用JPEG壓縮的TIFF、使用JPEG壓縮的PDF以及SWF檔案。 如果fmt=gif或fmt=gif-alpha,請使用quantize=。 如需詳細資訊,請參閱命令說明。 其他格式沒有可設定的選項。

對於所有格式和畫素型別,每畫素元件會傳回8位元。

下表列出​ format ​與​ pixelType ​的有效組合、對應的HTTP回應MIME型別、是否可以內嵌ICC設定檔(請參閱iccEmbed=),以及可以套用哪些格式特定選項命令。

格式pixelType回應MIME型別內嵌ICC設定檔選項
jpeg, jpgrgb、灰色、cmyk<image/jpeg>是qlt=
png, png-alphargb,灰色<image/png>是
png8, png8-alphargb<image/png>是
tif, tif-alphargb、灰色、cmyk<image/tiff>是

tiffCompression

(none|lzw|zip|jpeg), pathEmbed=, qlt

( qlt= 被忽略,除非 tiffCompression 設定為'jpeg'。)

swf, swf-alphargb,灰色<application/x-shockwave-flash>

否

(Flash Player會忽略內嵌的ICC設定檔。)

qlt= ,屬性::TrustedDomains
pdfrgb、灰色、cmyk<application/pdf>是

tiffCompression

(none|zip|jpeg),qlt=

( qlt= 被忽略,除非 tiffCompression 設定為'jpeg'。)

epsrgb、灰色、cmyk<image/eps>是pathEmbed=
gif, gif-alpha

rgb,灰色

(資料在轉換為灰色或rgb之後,會轉換為調色盤。)

<image/gif>否

指定傳送至使用者端的回覆影像資料的編碼格式,以及HTTP回覆標頭對應的回應MIME型別。

png-alpha傳回未關聯的Alpha (即Alpha不會預先乘以畫素值),而tif-alpha和swf-alpha傳回關聯的Alpha (即Alpha值會預先乘以Alpha值)。 Alpha色版對應至req=img暈映背景遮色片的反面,如果有req=object,則對應至群組或物件遮色片。 若要在使用巢狀IR要求時套用Alpha,請將具有適當Alpha檔案格式的fmt=新增至內嵌IR要求與主要要求。 如果以icc=指定CMYK或灰階ICC設定檔,則不會傳回Alpha資料。

屬性

可能發生在請求中的任何位置。

預設

format ​預設為attribute::Format,tiffCompression ​預設為attribute::TiffEncoding。 如果未指定icc=,則預設為rgb,否則會對應到指定ICC設定檔的畫素型別。pixelType

另請參閱

attribute::Format , attribute::JpegQuality, attribute::TiffEncoding, qlt=, iccEmbed=, pathEmbed=, req=, quantize=

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