DokumentationDynamic Media Image Serving and Rendering API

fmt

Senast uppdaterad: 31 juli 2024
  • Ämnen:

Skapat för:

  • Utvecklare
  • Användare

Svarsbildformat.

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

formatBeskrivning
avif-alphaFörstörande och förlustfri AVIF med alfakanal.
avifFörstörande och förlustfri AVIF.
epsOkomprimerad binär kapslad PostScript.
f4mFlash Streaming Server-manifestformat.
gif-alphaGIF med 2 till 255 färger plus genomskinlighet för nyckelfärger.
gifGIF med 2 till 256 färger.
heicFörlustfri HEIC. Det här formatet hämtas som standard från webbläsaren om det inte stöds.
jpegFörstörande JPEG.
jpeg2000-alphaFörstörande och förlustfri JPEG 2000 med alfakanal.
jpeg2000Förstörande och förlustfri JPEG 2000.
jpegxr-alphaFörstörande och förlustfri JPEG XR med alfakanal.
jpegxrFörstörande och förlustfri JPEG XR.
jpgFörstörande JPG.
m3u8Apple Streaming Server, manifestformat.
pdfBilden är inbäddad i PDF.
pjpegProgressiv JPEG.
png-alpha24-bitars förlustfri PNG med alfakanal.
png24-bitars förlustfri PNG.
png8-alpha8-bitars förlustfri PNG med alfakanal.
png88-bitars förlustfri PNG.
swf-alphaFörstörande JPEG och dekomprimerad mask inbäddad i en Adobe AS2-swf-fil.
swfFörstörande JPEG inbäddad i en Adobe AS2-swf-fil.
swf3-alphaFörstörande JPEG och dekomprimerad mask inbäddad i en Adobe AS3-swf-fil. Obs! swf- och swf-alpha-format används bäst för ActionScript 2-program (Flash Player 8 och tidigare). Formaten swf3 och swf3-alpha rekommenderas för ActionScript3-program (Flash Player 9 och senare).
swf3Förstörande JPEG inbäddad i en SWF-fil i Adobe.
tif-alphaTIFF med alfakanal.
tifTIFF.
webp-alphaFörstörande och förlustfri WebP med alfakanal.
webpFörstörande och förlustfri WebP.

pixelType - rgb | grå | cmyk

pixelTypeBeskrivning
cmykReturnera CMYK-bilddata.
grayReturnera gråskalebilddata.
rgbReturnera bilddata för RGB.

compression - jpeg | förstörande | förlustfri | lzw | ingen | zip

compressionBeskrivning
jpegJPEG-komprimering (förstörande).
lossyJPEG 2000, JPEG XR-komprimering (förstörande) och WebP.
losslessHEIC, JPEG 2000, JPEG XR-komprimering (icke-förstörande) och WebP.
lzwLZW-komprimering (icke-förstörande) (Lempel-Ziv-Welch).
noneOkomprimerad.
zipDeflate-komprimering (icke-förstörande).

  • format anger bildkodningsformatet för bilddata som skickas till klienten och motsvarande MIME-svarstyp för HTTP-svarshuvudet.

  • pixelType kan användas för att påverka konvertering av färgrymd för utdata när icc= inte har angetts.

    Standardfärgprofilen som motsvarar pixelType används. Om färghantering är inaktiverat används tidigare konvertering. pixelType ignoreras när icc= anges, vilket avgör utdatapixeltypen.

  • compression tillåts bara om tif, tif-alpha, pdf, webp, webp-alpha, jpeg2000, jpeg2000-alpha, jpegxr eller jpegxr-alpha har angetts som format. I tabellen nedan finns information om vilka komprimeringsalternativ som stöds för dessa bildformat.

Du kan använda qlt= för att ange kodningsalternativ för JPEG för följande format: JPEG, TIFF med JPEG-komprimering, PDF med JPEG-komprimering och SWF. WebP, JPEG 2000 och JPEG XR använder också qlt=, men värdena ger olika kvaliteter för de olika formaten. Använd quantize= om fmt=gif eller fmt=gif-alpha. Mer information finns i kommandobeskrivningarna. De andra formaten har inga inställningsbara alternativ.

8 bitar per pixelkomponent returneras för alla formats och pixelTypes (8 bitar per pixel för GIF).

I följande tabell visas giltiga kombinationer av *format*och pixelType, motsvarande MIME-typer för HTTP-svar, om ICC-profiler kan bäddas in (se iccEmbed=) och vilka formatspecifika alternativ du kan använda.

format
pixelType
MIME-svarstyp
Bädda in ICC-profil
alternativ
avif, avif-alpha
rgb
<image/avif>
Nej

komprimering ( förstörande , förlustfri )

qlt= ignoreras för förlustfri .

Eftersom det inte finns något koncept för krominanshämtning med WebP-formatet ignoreras det andra värdet ( qlt ) om du använder ett andra värde (till exempel qlt=80,1 ). 1 ignoreras.

eps
rgb, gray, cmyk
<image/eps>
Ja
pathEmbed=
gif-alfa

rgb, grå

Data konverteras till palett efter konvertering till grå eller rgb.

<image/gif>
Nej
kvantize=
heic
rgb
<image/heic>
Nej
jpeg2000, jpeg2000-alpha
rgb, grå
<image/jp2>
Nej

komprimering ( förstörande , förlustfri )

qlt= ignoreras för förlustfri .

Eftersom det inte finns något koncept för krominanshämtning med WebP-formatet ignoreras det andra värdet ( qlt ) om du använder ett andra värde (till exempel qlt=80,1 ). 1 ignoreras.

jpeg, jpg, pjpeg
rgb, gray, cmyk
<image/jpeg>
Ja

pathEmbed= , pscan= , qlt= , xmpEmbed=

Parametern pscan= gäller bara för pjpeg-format.

jpegxr, jpegxr-alpha
rgb
<image/vnd.ms-photo>
Nej

komprimering ( förstörande , förlustfri )

qlt= ignoreras för förlustfri .

Eftersom det inte finns något koncept för krominanshämtning med WebP-formatet ignoreras det andra värdet ( qlt ) om du använder ett andra värde (till exempel qlt=80,1 ). 1 ignoreras.

PDF
rgb, gray, cmyk
<application/pdf>
Ja

komprimering

( none|zip|jpeg ), qlt=

qlt= ignoreras såvida inte compression är inställd på jpeg .

png8, png8-alpha
rgb
<image/png>
Ja
png, png-alpha
rgb, grå
<image/png>
Ja
swf,swf3, swf-alpha, swf-alpha3
rgb, grå
<application/x-shockwave-flash>

Nej

Obs! Flashen Player Adobe ignorerar inbäddade ICC-profiler.

qlt= , attribut::TrustedDomains
tif, tif-alpha
rgb, gray, cmyk
<image/tiff>
Ja

komprimering

( ingen|lzw|zip|jpeg )

Endast tiff; tiff-alpha stöder inte jpeg-komprimering.

qlt=

qlt= ignoreras såvida inte compression är inställd på jpeg .

, pathEmbed=, xmpEmbed=

webp, webp-alpha
rgb
<bild/webp>
Nej

komprimering ( förstörande , förlustfri )

qlt= ignoreras för förlustfri .

Eftersom det inte finns något koncept för krominanshämtning med WebP-formatet ignoreras det andra värdet ( qlt ) om du använder ett andra värde (till exempel qlt=80,1 ). 1 ignoreras.

Egenskaper

Begär attribut. Tillämpas oavsett aktuell lagerinställning om req=img (standard) eller req=mask; annars ignoreras.

type ignoreras om iccProfile= anges.

Standard

fmt=jpeg, *defaultType*,none, där defaultType hanteras enligt följande: Om icc= anges motsvarar defaultType pixeltypen för den angivna ICC-profilen. Om icc= inte anges är defaultType gray om req=mask, annars är det rgb.

Exempel

Begär en liten förhandsvisningsbild med låg kvalitet i JPEG-format (standard):

http:// *server*/myRootId/myImageId?qlt=60&wid=200

Begär samma bild konverterad till gråskala:

http:// *server*/myRootId/myImageId?fmt=jpeg,gray&qlt=60&wid=200

Begär samma bild i ett förlustfritt format med alfakanal och hög upplösning:

http:// *server*/myRootId/myImageId?fmt=png-alpha&wid=300

Begär alfakanalen för samma bild som en TIFF-bild i gråskala:

http:// *server*/myRootId/myImageId?req=mask&fmt=tif,gray&wid=300

Konvertera samma bild till cmyk med ICC-standardprofilerna:

http:// *server*/myRootId/myImageId?fmt=tif,cmyk&wid=300

Konvertera samma bild till CMYK med en annan ICC-profil och bädda in profilen i TIFF-bilden:

http:// *server*/myRootId/myImageId?fmt=tif&wid=300&icc=myPrinterProfile&iccEmbed=1

Leverera den här bilden som en TIF-fil med JPEG-komprimering utan konvertering av pixeltyp:

http:// *server*/myRootId/myImageId?fmt=tif,,jpeg&qlt=95&wid=300

Konvertera en bild till ett GIF med två toner med transparens och tvinga färger till svartvitt:

http:// *server*/myRootId/myImageId?fmt=gif-alpha&wid=100&quantize=adaptive,off,2,000000,ffffff

Förstörande med kvalitetsinställningen 80:

http:// *server*/myRootId/myImageId?wid=300&fmt=webp&qlt=80

Icke-förstörande med alfa:

http:// *server*/myRootId/myImageId?wid=300&fmt=webp-alpha,,lossless

Förstörande med kvalitetsinställningen 80:

http://server/myRootId/myImageId?wid=300&fmt=jpeg2000&qlt=80

Icke-förstörande med alfa:

http://server/myRootId/myImageId?wid=300&fmt=jpeg2000-alpha,,lossless

Förstörande med kvalitetsinställningen 80:

http://server/myRootId/myImageId?wid=300&fmt=jpegxr&qlt=80

Icke-förstörande med alfa:

http://server/myRootId/myImageId?wid=300&fmt=jpegxr-alpha,,lossless

Se även

qlt= , kvantize=, req=, icc=, iccEmbed=, pathEmbed=, pscan.

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