fmt

最後更新： 2024年7月31日
  • 主題：

建立對象：

  • 開發人員
  • 使用者

回應影像格式。

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。
f4mFlash串流伺服器資訊清單格式。
gif-alpha2到255色GIF，加上關鍵色彩透明度。
gif使用2到256色GIF。
heic不失真HEIC。 如果不支援此格式，預設會從瀏覽器下載。
jpeg有損JPEG。
jpeg2000-alpha含Alpha色版的有損和無損JPEG2000。
jpeg2000有損和無損JPEG2000。
jpegxr-alpha含Alpha色版的有損和無損JPEGXR。
jpegxr有損和無損JPEGXR。
jpgJPG有損。
m3u8Apple串流伺服器資訊清單格式。
pdf內嵌於PDF中的影像。
pjpeg漸進式JPEG。
png-alpha含Alpha通道的24位元無失真PNG。
png24位元無失真PNG。
png8-alpha含Alpha色版的8位元無失真PNG。
png88位元無失真PNG。
swf-alphaAdobeAS2 SWF檔中內嵌的有損JPEG和Deflate-Compressed遮罩。
swf內嵌於AdobeAS2 SWF檔中的有損JPEG。
swf3-alphaAdobeAS3 SWF檔中內嵌的有損JPEG和Deflate-Compressed遮罩。 注意： swf和swf-alpha格式最適合用於ActionScript2應用程式(Flash Player8或更早版本)。 建議將swf3和swf3-alpha格式用於ActionScript3應用程式(Flash Player9和更新版本)。
swf3內嵌於AdobeAS3 SWF檔中的有損JPEG。
tif-alpha使用Alpha色版TIFF。
tifTIFF。
webp-alpha含Alpha色版的有損和無損WebP。
webp有損和無損WebP。

pixelType - rgb | 灰色 | cmyk

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

compression - jpeg | 有損 | 不失真 | lzw | 無 | zip

compression說明
jpegJPEG壓縮（失真）。
lossyJPEG2000、JPEGXR壓縮（失真）和WebP。
losslessHEIC、JPEG 2000和JPEGXR壓縮（不失真）和WebP。
lzwLZW (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-alphargb<image/avif>否

壓縮 （失真，無失真）

已忽略 qlt= （因為不失真）。

因為沒有WebP格式的色度縮減取樣概念，如果您使用含 qlt 的第二個值（例如， qlt=80,1 ），則會忽略第二個值( 1 )。

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

rgb，灰色

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

<image/gif>否量化=
heicrgb<image/heic>否
jpeg2000， jpeg2000-alphargb，灰色<image/jp2>否

壓縮 （失真，無失真）

已忽略 qlt= （因為不失真）。

因為沒有WebP格式的色度縮減取樣概念，如果您使用含 qlt 的第二個值（例如， qlt=80,1 ），則會忽略第二個值( 1 )。

jpeg， jpg， pjpegrgb、灰色、cmyk<image/jpeg>是

pathEmbed= ， pscan= ， qlt= ， xmpEmbed=

pscan= 引數僅適用於pjpeg格式。

jpegxr， jpegxr-alphargb<image/vnd.ms-photo>否

壓縮 （失真，無失真）

已忽略 qlt= （因為不失真）。

因為沒有WebP格式的色度縮減取樣概念，如果您使用含 qlt 的第二個值（例如， qlt=80,1 ），則會忽略第二個值( 1 )。

pdfrgb、灰色、cmyk<application/pdf>是

壓縮

( none|zip|jpeg )， qlt=

已忽略 qlt= ，除非 壓縮 設定為 jpeg 。

png8， png8-alphargb<image/png>是
png， png-alphargb，灰色<image/png>是
swf，swf3， swf-alpha， swf-alpha3rgb，灰色<application/x-shockwave-flash>

否

注意：AdobeFlash Player會忽略內嵌的ICC設定檔。

qlt= ，屬性：：TrustedDomains
tif， tif-alphargb、灰色、cmyk<image/tiff>是

壓縮

( none|lzw|zip|jpeg )

僅限'tiff'；'tiff-alpha'不支援jpeg壓縮。

qlt=

已忽略 qlt= ，除非壓縮設定為 jpeg 。

， pathEmbed=， xmpEmbed=

webp， webp-alphargb<image/webp>否

壓縮 （失真，無失真）

已忽略 qlt= （因為不失真）。

因為沒有WebP格式的色度縮減取樣概念，如果您使用含 qlt 的第二個值（例如， qlt=80,1 ），則會忽略第二個值( 1 )。

屬性

要求屬性。 若為req=img （預設）或req=mask，則無論目前的圖層設定為何，皆適用；否則會忽略。

如果指定iccProfile=，則會忽略​ type。

預設

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