fmt 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
GIF配備2至255色,加上按鍵色彩透明度。
gif
GIF提供2到256種色彩。
heic
不失真HEIC。 如果不支援此格式,預設會從瀏覽器下載。
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以及內嵌於Adobe AS2 swf檔案中的deflate-compressed遮色片。
swf
內嵌於Adobe AS2 swf檔案中的有損JPEG。
swf3-alpha
有損的JPEG以及內嵌於Adobe AS3 swf檔案中的Deflate壓縮遮色片。 注意: swf和swf-alpha格式最適合用於ActionScript 2應用程式(Flash Player 8和更早版本)。 ActionScript3應用程式(Flash Player 9和更新版本)建議使用swf3和swf3-alpha格式。
swf3
內嵌於Adobe AS3 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
JPEG 2000、JPEG XR壓縮(失真)和WebP。
lossless
HEIC、JPEG 2000和JPEG XR壓縮(不失真)和WebP。
lzw
LZW (Lempel-Ziv-Welch)壓縮(不失真)。
none
未壓縮。
zip
"Deflate"壓縮(不失真)。
  • format ​會指定傳送至使用者端之影像資料的影像編碼格式,以及HTTP回應標頭的對應回應MIME型別。

  • 未指定​ pixelType ​時,可以使用icc=進行輸出色域轉換。

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

  • 只有在將​ compressiontiftif-alphapdfwebpwebp-alphajpeg2000jpeg2000-alphajpegxr指定為jpegxr-alpha時,才允許​ format。 如需這些影像格式支援的壓縮選項,請參閱下表。

您可以使用qlt=來設定這些格式的JPEG編碼選項:JPEG、具有JPEG壓縮的TIFF、具有JPEG壓縮的PDF以及SWF。 WebP、JPEG 2000和JPEG XR也使用qlt=,但值會針對不同的格式產生不同的品質。 如果quantize=fmt=gif,請使用fmt=gif-alpha。 如需詳細資訊,請參閱命令說明。 其他格式沒有可設定的選項。

所有​ formats ​和​ pixelTypes ​會傳回8位元/畫素元件(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>

注意: Adobe Flash 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, *defaultType*,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=quantize=req=icc=iccEmbed=pathEmbed=pscan

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