DokumentationDynamic Media Image Serving and Rendering API

fmt fmt

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Entwickler
  • Benutzende

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
Unkomprimierte binäre 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
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: swf- und swf-alpha-Formate 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 MIME-Typ der Antwort für den HTTP-Antwortheader an.

  • pixelType kann verwendet werden, um die Konvertierung des Ausgabefarbraums auszuführen, wenn icc= nicht angegeben ist.

    Das Standardfarbprofil, das pixelType entspricht, wird angewendet. Wenn das Farbmanagement deaktiviert ist, wird eine naive Konversion angewendet. pixelType wird ignoriert, wenn icc= angegeben ist, was den Typ des Ausgabepixels bestimmt.

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

Sie können qlt= verwenden, um die JPEG-Kodierungsoptionen für die folgenden 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. Verwenden Sie quantize=, wenn 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 formats und pixelTypes (8 Bit pro Pixel für GIF) zurückgegeben.

In der folgenden Tabelle sind die gültigen Kombinationen aus *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

Komprimierung ( verlustbehaftet , verlustfrei )

qlt= wird für verlustfreies ignoriert.

Da es kein Konzept für Chrominanz-Downsampling mit dem WebP-Format gibt, wird der zweite Wert ( 1 ) ignoriert, wenn Sie einen zweiten Wert mit qlt (z. B. qlt=80,1 ) verwenden.

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

Komprimierung ( verlustbehaftet , verlustfrei )

qlt= wird für verlustfreies ignoriert.

Da es kein Konzept für Chrominanz-Downsampling mit dem WebP-Format gibt, wird der zweite Wert ( 1 ) ignoriert, wenn Sie einen zweiten Wert mit qlt (z. B. qlt=80,1 ) verwenden.

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

pathEmbed= , pscan= , qlt= , xmpEmbed=

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

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

Komprimierung ( verlustbehaftet , verlustfrei )

qlt= wird für verlustfreies ignoriert.

Da es kein Konzept für Chrominanz-Downsampling mit dem WebP-Format gibt, wird der zweite Wert ( 1 ) ignoriert, wenn Sie einen zweiten Wert mit qlt (z. B. qlt=80,1 ) verwenden.

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

Komprimierung

( none|zip|jpeg ), qlt=

qlt= wird ignoriert, es sei denn, Komprimierung ist auf jpeg gesetzt.

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

Komprimierung

( none|lzw|zip|jpeg )

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

qlt=

qlt= wird ignoriert, es sei denn, die Komprimierung ist auf jpeg eingestellt.

, pathEmbed=, xmpEmbed=

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

Komprimierung ( verlustbehaftet , verlustfrei )

qlt= wird für verlustfreies ignoriert.

Da es kein Konzept für Chrominanz-Downsampling mit dem WebP-Format gibt, wird der zweite Wert ( 1 ) ignoriert, wenn Sie einen zweiten Wert mit qlt (z. B. qlt=80,1 ) verwenden.

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= angegeben ist.

Standard section-f885a785b32c44fea347db15fdb2ab1f

fmt=jpeg, *defaultType*,none, wobei der defaultType wie folgt verarbeitet wird: Wenn icc= angegeben ist, entspricht defaultType dem Pixeltyp des angegebenen ICC-Profils. Wenn icc= nicht angegeben ist, ist defaultType gray, wenn req=mask, sonst ist es 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 Pixeltypkonvertierung 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

verlustfrei 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

verlustfrei 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

verlustfrei 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