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

fmt fmt

Last update: Tue Feb 27 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • Developer
  • User

回應影像格式。

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
Flash串流伺服器資訊清單格式。
gif-alpha
2到255色GIF，加上關鍵色彩透明度。
gif
使用2到256色GIF。
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 | 無 | 郵遞區號 |

compression
說明
jpeg
JPEG壓縮（失真）。
lossy
JPEG2000、JPEGXR壓縮（失真）和WebP。
lossless
HEIC、JPEG 2000和JPEGXR壓縮（不失真）和WebP。
lzw
LZW (Lempel-Ziv-Welch)壓縮（不失真）。
none
未壓縮。
zip
"Deflate"壓縮（不失真）。

  • format 為傳送至使用者端的影像資料指定影像編碼格式，並為HTTP回應標頭指定對應的回應MIME型別。

  • pixelType 可用於在下列情況下實現輸出色域轉換 icc= 未指定。

    與對應的預設色彩設定檔 pixelType 中所有規則的URL區段。 如果停用色彩管理，則會套用天真的轉換。 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、JPEG2000和JPEGXR也使用 qlt= 但是這些值會為不同的格式產生不同的品質。 使用 quantize= 如果 fmt=gif 或 fmt=gif-alpha. 如需詳細資訊，請參閱命令說明。 其他格式沒有可設定的選項。

所有畫素會傳回8位元每畫素元件 formats 和 pixelTypes (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；否則會忽略。

type 被忽略，如果 iccProfile= 已指定。

預設 section-f885a785b32c44fea347db15fdb2ab1f

fmt=jpeg, *預設型別*,none，其中 defaultType 處理方式如下：如果 icc= 已指定， defaultType 對應於指定ICC設定檔的畫素型別。 如果 icc= 未指定， defaultType 是 gray 如果 req=mask，否則為 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= ， 量化=， 需要=， icc=， iccEmbed=， pathEmbed=， pscan.

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