DokumentationDynamic Media Image Serving and Rendering API

fmt fmt

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

Erstellt für:

  • Developer
  • User

Antwortbildformat.

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
Beschreibung
avif-alpha
verlustfreies AVIF mit Alphakanal.
avif
verlustfreies AVIF.
eps
Unkomprimiertes binäres Encapsulated PostScript.
f4m
Flash Streaming Server-Manifestformat.
gif-alpha
GIF mit 2 bis 255 Farben plus Key-Farbtransparenz.
gif
GIF mit 2 bis 256 Farben.
heic
Verlustfreier HEIC. Dieses Format wird standardmäßig vom Browser heruntergeladen, wenn es nicht unterstützt wird.
jpeg
Lossy JPEG.
jpeg2000-alpha
Verlust und verlustfreie JPEG 2000 mit Alphakanal.
jpeg2000
Verlust und verlustfreie JPEG 2000.
jpegxr-alpha
Verlust und verlustfreies JPEG XR mit Alphakanal.
jpegxr
Verlust und verlustfreie JPEG XR.
jpg
Lossy JPG.
m3u8
Manifestformat des Apple-Streaming-Servers.
pdf
In PDF eingebettetes Bild.
pjpeg
Progressive JPEG.
png-alpha
24-Bit-verlustfreies PNG mit Alphakanal.
png
24-Bit-verlustfreies PNG.
png8-alpha
8-Bit-verlustfreies PNG mit Alphakanal.
png8
8-Bit-verlustfreies PNG.
swf-alpha
Lossy JPEG und eine deflate-komprimierte Maske eingebettet in eine Adobe AS2 swf-Datei.
swf
Lossy JPEG eingebettet in eine Adobe AS2 swf-Datei.
swf3-alpha
Lossy JPEG und eine deflate-komprimierte Maske eingebettet in eine Adobe AS3 swf-Datei. Hinweis: Die Formate swf und swf-alpha eignen sich am besten für ActionScript 2 Anwendungen (Flash Player 8 und früher). Die Formate swf3 und swf3-alpha werden für ActionScript 3 Anwendungen (Flash Player 9 und höher) empfohlen.
swf3
Lossy JPEG eingebettet in eine Adobe AS3 swf-Datei.
tif-alpha
TIFF mit Alphakanal.
tif
TIFF.
webp-alpha
Verlust und verlustfreies WebP mit Alphakanal.
webp
Verlust und verlustfreies WebP.

| pixelType - rgb | grau | cmyk |

pixelType
Beschreibung
cmyk
CMYK-Bilddaten zurückgeben.
gray
Graustufen-Bilddaten zurückgeben.
rgb
Gibt RGB-Bilddaten zurück.

| compression - jpeg | verlustbehaftet | verlustfrei | lzw | keine | zip |

compression
Beschreibung
jpeg
JPEG-Komprimierung (verlustreich).
lossy
JPEG 2000 und JPEG XR-Komprimierung (verlustbehaftet) und WebP.
lossless
HEIC, JPEG 2000 und JPEG XR-Komprimierung (verlustfrei) und WebP.
lzw
LZW-Komprimierung (Lempel-Ziv-Welch) (verlustfrei).
none
unkomprimiert.
zip
Komprimierung "Deflate"(verlustfrei).

  • format gibt das Bildkodierungsformat für an den Client gesendete Bilddaten und den entsprechenden Antwort-MIME-Typ für den HTTP-Antwort-Header an.

  • pixelType kann verwendet werden, um die Konvertierung des Ausgabefarbraums zu beeinflussen, wenn icc= nicht angegeben ist.

    Das standardmäßige Farbprofil, das pixelType angewendet wird. Wenn das Farbmanagement deaktiviert ist, wird eine naive Konversion angewendet. pixelType wird ignoriert, wenn icc= angegeben ist, der den Typ des Ausgabepixels bestimmt.

  • compression ist nur zulässig, wenn tif, tif-alpha, pdf, webp, webp-alpha, jpeg2000, jpeg2000-alpha, jpegxroder jpegxr-alpha wird als format. Die für diese Bildformate unterstützten Komprimierungsoptionen finden Sie in der folgenden Tabelle.

Sie können qlt= um die JPEG-Kodierungsoptionen für diese Formate festzulegen: JPEG, TIFF mit JPEG-Komprimierung, PDF mit JPEG-Komprimierung und SWF. WebP, JPEG 2000 und JPEG XR verwenden ebenfalls qlt= aber die Werte führen zu unterschiedlichen Qualitäten für die verschiedenen Formate. Verwendung quantize= if fmt=gif oder fmt=gif-alpha. Weitere Informationen finden Sie in den Befehlsbeschreibungen. Die anderen Formate verfügen nicht über konfigurierbare Optionen.

8 Bit pro Pixelkomponente werden für alle zurückgegeben formats und pixelTypes (8 Bit pro Pixel für GIF).

In der folgenden Tabelle sind die gültigen Kombinationen von *format*und pixelType, die entsprechenden HTTP-Antwort-MIME-Typen, ob ICC-Profile eingebettet werden können (siehe iccEmbed=) und welche formatspezifischen Optionen Sie anwenden können.

format
pixelType
Antwort-MIME-Typ
ICC-Profil einbetten
Optionen
avif, avif-alpha
rgb
<image/avif>
Nein

compression ( verlustbehaftet , verlustfrei )

qlt= wird ignoriert für verlustfrei .

Da es kein Konzept für Chrominanz-Downsampling mit dem WebP-Format gibt, sollten Sie einen zweiten Wert mit qlt (zum Beispiel: qlt=80,1 ) der zweite Wert ( 1 ) wird ignoriert.

eps
rgb, grau, cmyk
<image/eps>
Ja
pathEmbed=
gif, gif-alpha

rgb, grau

Die Daten werden nach der Konvertierung in Grau oder RGB in eine Palette umgewandelt.

<image/gif>
Nein
quantize=
heic
rgb
<image/heic>
Nein
jpeg2000, jpeg2000-alpha
rgb, grau
<image/jp2>
Nein

compression ( verlustbehaftet , verlustfrei )

qlt= wird ignoriert für verlustfrei .

Da es kein Konzept für Chrominanz-Downsampling mit dem WebP-Format gibt, sollten Sie einen zweiten Wert mit qlt (zum Beispiel: qlt=80,1 ) der zweite Wert ( 1 ) wird ignoriert.

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

pathEmbed= , pscan= , qlt= , xmpEmbed=

Die pscan= -Parameter gilt nur für das PJPEG-Format.

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

compression ( verlustbehaftet , verlustfrei )

qlt= wird ignoriert für verlustfrei .

Da es kein Konzept für Chrominanz-Downsampling mit dem WebP-Format gibt, sollten Sie einen zweiten Wert mit qlt (zum Beispiel: qlt=80,1 ) der zweite Wert ( 1 ) wird ignoriert.

pdf
rgb, grau, cmyk
<application/pdf>
Ja

compression

( none|zip|jpeg ), qlt=

qlt= wird ignoriert, wenn compression auf jpeg .

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

Nein

Hinweis: Die Adobe-Flash Player ignoriert eingebettete ICC-Profile.

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

compression

( none|lzw|zip|jpeg )

'tiff' nur; 'tiff-alpha' unterstützt keine JPEG-Komprimierung.

qlt=

qlt= wird ignoriert, wenn compression auf jpeg .

, pathEmbed=, xmpEmbed=

webp, webp-alpha
rgb
<image/webp>
Nein

compression ( verlustbehaftet , verlustfrei )

qlt= wird ignoriert für verlustfrei .

Da es kein Konzept für Chrominanz-Downsampling mit dem WebP-Format gibt, sollten Sie einen zweiten Wert mit qlt (zum Beispiel: qlt=80,1 ) der zweite Wert ( 1 ) wird ignoriert.

Eigenschaften section-5f96b0ce7c5a4df1bf52e24ea78c3dae

Anforderungsattribut. Gilt unabhängig von der aktuellen Ebeneneinstellung, wenn req=img (Standard) oder req=mask; andernfalls ignoriert.

type wird ignoriert, wenn iccProfile= festgelegt ist.

Standard section-f885a785b32c44fea347db15fdb2ab1f

fmt=jpeg, *defaultType*,none, wobei defaultType wie folgt behandelt wird: Wenn icc= festgelegt ist, defaultType entspricht dem Pixeltyp des angegebenen ICC-Profils. Wenn icc= nicht angegeben ist, defaultType is gray if req=mask, andernfalls rgb.

Beispiele section-b93222e652df404a84c69025247f07df

Anfordern eines kleinen, qualitativ minderwertigen Vorschaubilds im JPEG-Format (Standard):

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

Fordern Sie dasselbe Bild, das in Graustufen konvertiert wurde, an:

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

Fordern Sie dasselbe Bild in einem verlustfreien Format mit Alphakanal und hoher Auflösung an:

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

Fordern Sie den Alphakanal für dasselbe Bild wie ein Graustufenbild an:

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

Konvertieren Sie dasselbe Bild mithilfe der standardmäßigen ICC-Profile in cmyk:

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

Konvertieren Sie dasselbe Bild mithilfe eines anderen ICC-Profils in cmyk und betten Sie das Profil in das TIFF-Bild ein:

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

Stellen Sie dieses Bild als TIF-Datei mit JPEG-Komprimierung ohne Konvertierung des Pixeltyps bereit:

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

Konvertieren Sie das Bild in eine bi-tonale GIF mit Schlüsselfarbtransparenz und erzwingen Sie Farben in Schwarzweiß:

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

Verlust mit einer Qualitätseinstellung von 80:

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

Lossless mit Alpha:

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

Verlust mit einer Qualitätseinstellung von 80:

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

Lossless mit Alpha:

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

Verlust mit einer Qualitätseinstellung von 80:

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

Lossless mit Alpha:

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

Verwandte Themen section-fce8d69c74234bf48cf814d799409541

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

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