fmt
建立對象:
- 開發人員
- 使用者
回應影像格式。
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 | 無 | zip
compression | 說明 |
---|---|
jpeg | JPEG壓縮(失真)。 |
lossy | JPEG2000、JPEGXR壓縮(失真)和WebP。 |
lossless | HEIC、JPEG 2000和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=),以及您可以套用哪些格式特定選項。
壓縮 (失真,無失真)
已忽略 qlt= (因為不失真)。
因為沒有WebP格式的色度縮減取樣概念,如果您使用含 qlt 的第二個值(例如, qlt=80,1 ),則會忽略第二個值( 1 )。
rgb,灰色
資料在轉換為灰色或rgb之後,會轉換為調色盤。
壓縮 (失真,無失真)
已忽略 qlt= (因為不失真)。
因為沒有WebP格式的色度縮減取樣概念,如果您使用含 qlt 的第二個值(例如, qlt=80,1 ),則會忽略第二個值( 1 )。
pathEmbed= , pscan= , qlt= , xmpEmbed=
pscan= 引數僅適用於pjpeg格式。
壓縮 (失真,無失真)
已忽略 qlt= (因為不失真)。
因為沒有WebP格式的色度縮減取樣概念,如果您使用含 qlt 的第二個值(例如, qlt=80,1 ),則會忽略第二個值( 1 )。
壓縮
( none|zip|jpeg ), qlt=
已忽略 qlt= ,除非 壓縮 設定為 jpeg 。
否
注意:AdobeFlash Player會忽略內嵌的ICC設定檔。
壓縮
( none|lzw|zip|jpeg )
僅限'tiff';'tiff-alpha'不支援jpeg壓縮。
qlt=
已忽略 qlt= ,除非壓縮設定為 jpeg 。
, pathEmbed=, xmpEmbed=
壓縮 (失真,無失真)
已忽略 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