DokumentationDynamic Media Image Serving and Rendering-API

fmt fmt

Last update: Mon Dec 30 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Entwickler
  • Benutzende

Format des Antwortbildes.

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
Verlust- und verlustfreies AVIF mit Alphakanal.
avif
Verlustbehaftete und verlustfreie AVIF.
eps
Unkomprimierte binär verkapselte PostScript.
f4m
Flash-Streaming-Server-Manifestformat.
gif-alpha
GIF mit 2 bis 255 Farben plus Key-Color-Transparenz.
gif
GIF mit 2 bis 256 Farben.
heic
Verlustfreie HEIC. Dieses Format wird standardmäßig vom Browser heruntergeladen, wenn es nicht unterstützt wird.
jpeg
Verlustbehaftetes JPEG.
jpeg2000-alpha
Verlustbehaftete und verlustfreie JPEG 2000 mit Alphakanal.
jpeg2000
Verlustbehaftete und verlustfreie JPEG 2000.
jpegxr-alpha
Verlustbehaftete und verlustfreie JPEG XR mit Alphakanal.
jpegxr
Verlustbehaftetes und verlustfreies JPEG XR.
jpg
Verlustbehaftete JPG.
m3u8
Apple-Streaming-Server-Manifestformat.
pdf
Bild eingebettet in PDF.
pjpeg
Progressives 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
Verlustbehaftetes JPEG und eine Deflate-komprimierte Maske, eingebettet in eine Adobe AS2 SWF-Datei.
swf
Verlorene JPEG eingebettet in eine Adobe AS2 SWF-Datei.
swf3-alpha
Verlustbehaftetes 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 ActionScript3-Anwendungen (Flash Player 9 und höher) empfohlen.
swf3
Verlorene JPEG eingebettet in eine Adobe AS3 SWF-Datei.
tif-alpha
TIFF mit Alphakanal.
tif
TIFF.
webp-alpha
Verlorenes und verlustfreies WebP mit Alphakanal.
webp
Verlust- und verlustfreies WebP.

pixelType - rgb | grau | CMYK

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

compression - JPEG | verlustreich | verlustfrei | Gesetz | Keine | PLZ

compression
Beschreibung
jpeg
JPEG-Komprimierung (verlustbehaftet)
lossy
JPEG 2000 und JPEG XR-Komprimierung (verlustbehaftet) und WebP.
lossless
HEIC, JPEG 2000 und JPEG XR-Komprimierung (verlustfrei) und WebP.
lzw
LZW (Lempel-Ziv-Welch) Kompression (verlustfrei).
none
Unkomprimiert.
zip
Kompression „Deflate“ (verlustfrei).

  • format gibt das Bildcodierungsformat für die an den Client gesendeten Bilddaten sowie den entsprechenden Antwort-MIME-Typ für den HTTP-Antwort-Header an.

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

    Das Standardfarbprofil, das pixelType entspricht, wird angewendet. Wenn das Farbmanagement deaktiviert ist, wird eine naive Konvertierung angewendet. pixelType wird ignoriert, wenn icc= angegeben wird, was den Pixel-Ausgabetyp 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. In der folgenden Tabelle finden Sie die Komprimierungsoptionen, die für diese Bildformate unterstützt werden.

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. Einzelheiten finden Sie in den Befehlsbeschreibungen. Für die anderen Formate gibt es keine einstellbaren Optionen.

Für alle formats und pixelTypes werden 8 Bit pro Pixelkomponente zurückgegeben (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, die Frage, ob ICC-Profile eingebettet werden können (siehe iccEmbed=), und die möglichen formatspezifischen Optionen aufgeführt.

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

Komprimierung ( verlustbehaftetes , verlustfreie )

qlt= wird für verlustfreie ignoriert.

Da es kein Konzept für die Neuberechnung der Chrominanz mit dem WebP-Format gibt, wird bei Verwendung eines zweiten Werts mit qlt- (z. B. qlt=80,1 ) der zweite Wert ( 1 ) 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

Komprimierung ( verlustbehaftetes , verlustfreie )

qlt= wird für verlustfreie ignoriert.

Da es kein Konzept für die Neuberechnung der Chrominanz mit dem WebP-Format gibt, wird bei Verwendung eines zweiten Werts mit qlt- (z. B. qlt=80,1 ) der zweite Wert ( 1 ) ignoriert.

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 ( verlustbehaftetes , verlustfreie )

qlt= wird für verlustfreie ignoriert.

Da es kein Konzept für die Neuberechnung der Chrominanz mit dem WebP-Format gibt, wird bei Verwendung eines zweiten Werts mit qlt- (z. B. qlt=80,1 ) der zweite Wert ( 1 ) ignoriert.

pdf
RGB, Grau, CMYK
<application/pdf>
Ja

Komprimierung

( none|zip|jpeg ), qlt=

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

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= , Attribut::TrustedDomains
TIF, TIF-Alpha
RGB, Grau, CMYK
<image/tiff>-
Ja

Komprimierung

( none|lzw|zip|jpeg )

Nur „tiff“; „tiff-alpha“ unterstützt keine JPEG-Komprimierung.

qlt=

qlt= wird ignoriert, es sei denn, Komprimierungs- ist auf JPEG- festgelegt.

, pathEmbed=, xmpEmbed=

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

Komprimierung ( verlustbehaftetes , verlustfreie )

qlt= wird für verlustfreie ignoriert.

Da es kein Konzept für die Neuberechnung der Chrominanz mit dem WebP-Format gibt, wird bei Verwendung eines zweiten Werts mit qlt- (z. B. qlt=80,1 ) der zweite Wert ( 1 ) ignoriert.

Eigenschaften section-5f96b0ce7c5a4df1bf52e24ea78c3dae

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

type wird ignoriert, wenn iccProfile= angegeben ist.

Standard section-f885a785b32c44fea347db15fdb2ab1f

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

Beispiele section-b93222e652df404a84c69025247f07df

Anfordern eines kleinen Vorschaubilds in niedriger Qualität im JPEG-Format (Standard):

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

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

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

Anfordern des Alphakanals für dasselbe Bild wie ein Graustufen-TIFF-Bild:

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 zweifarbige 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

verlustbehaftet 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

verlustbehaftet 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

verlustbehaftet 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