fmt

Response Image Format.

fmt=format[, [pixelType],[compression]]

format — jpeg | jpg | pjpeg | png | png8 | png-alpha | png8-alpha | tif | tif-alpha | swf | swf-alpha | swf3 | swf3-alpha | eps | gif | gif-alpha | m3u8 | f4m | web | webp-alpha | jpeg2000 | jpeg2000-alpha | jpegxr | jpegxr-alpha

format Description
jpeg Lossy JPEG
jpg Lossy JPG
pjpeg Progressive JPEG
png 24-bit lossless PNG
png8 8-bit lossless PNG
png-alpha 24-bit lossless PNG with alpha channel
png8-alpha 8-bit lossless PNG with alpha channel
tif TIFF
tif-alpha TIFF with alpha channel
pdf Image embedded in PDF
eps Uncompressed binary Encapsulated PostScript
gif GIF with 2 to 256 colors
gif-alpha GIF with 2 to 255 colors plus key-color transparency
swf Lossy JPEG embedded into an Adobe AS2 swf file
swf-alpha Lossy JPEG and a deflate-compressed mask embedded into an Adobe AS2 swf file
swf3 Lossy JPEG embedded into an Adobe AS3 swf file
swf3-alpha Lossy JPEG and a deflate-compressed mask embedded into an Adobe AS3 swf file. Note: swf and swf-alpha formats are best used for ActionScript 2 applications (Flash Player 8 and earlier). swf3 and swf3-alpha is recommended for use for ActionScript3 applications (Flash Player 9 and later)
m3u8 Apple Streaming Server manifest format
f4m Flash Streaming Server manifest format
webp Lossy and lossless WebP
webp-alpha Lossy and lossless WebP with alpha channel
jpeg2000 Lossy and lossless JPEG 2000
jpeg2000-alpha Lossy and lossless JPEG 2000 with alpha channel
jpegxr Lossy and lossless JPEG XR
jpegxr-alpha Lossy and lossless JPEG XR with alpha channel

pixelType — rgb | gray | cmyk

pixelType Description
rgb Return RGB image data.
gray Return gray-scale image data.
cmyk Return CMYK image data.

compression — none | lzw | zip | jpeg | lossy | lossless

compression Description
none Uncompressed
lzw LZW (Lempel-Ziv-Welch) compression (lossless)
zip “Deflate” compression (lossless)
jpeg JPEG compression (lossy)
lossy WebP, JPEG 2000, and JPEG XR compression (lossy)
lossless WebP, JPEG 2000, and JPEG XR compression (lossless)
  • format specifies the image encoding format for image data sent to the client and the corresponding response MIME type for the HTTP response header.

  • pixelType can be used to effect output color space conversion when icc= is not specified.

    The default color profile corresponding to pixelType is applied. If color management is disabled, naïve conversion is applied. pixelType is ignored when icc= is specified, which determines the output pixel type.

  • compression is permitted only if tif, tif-alpha, pdf, webp, webp-alpha, jpeg2000, jpeg2000-alpha, jpegxr, or jpegxr-alpha is specified as the format. Refer to the table below for the compression options supported for these image formats.

You can use qlt= to set the JPEG encoding options for these formats: JPEG, TIFF with JPEG compression, PDF with JPEG compression, and SWF. WebP, JPEG 2000, and JPEG XR also use qlt= but the values result in different qualities for the different formats. Use quantize= if fmt=gif or fmt=gif-alpha. Refer to the command descriptions for details. The other formats do not have settable options.

8 bits per pixel component are returned for all formats and pixelTypes (8 bits per pixel for GIF).

The following table lists the valid combinations of *format*and pixelType, the corresponding HTTP response MIME types, whether ICC profiles can be embedded (see iccEmbed=), and what format-specific options you can apply.

format pixelType Response MIME type Embed ICC profile Options

jpeg, jpg, pjpeg

rgb, gray, cmyk

<image/jpeg>

Yes

pathEmbed= , pscan= , qlt= , xmpEmbed=

The pscan= parameter applies only to pjpeg format.

png, png-alpha

rgb, gray

<image/png>

Yes

png8, png8-alpha

rgb

<image/png>

Yes

tif, tif-alpha

rgb, gray, cmyk

<image/tiff>

Yes

compression

( none|lzw|zip|jpeg )

'tiff' only; 'tiff-alpha' does not support jpeg compression.

qlt=

qlt= is ignored unless compression is set to jpeg .

, pathEmbed=, xmpEmbed=

swf,swf3, swf-alpha, swf-alpha3

rgb, gray

<application/x-shockwave-flash>

No

Note: The Adobe Flash Player ignores embedded ICC profiles.

qlt= , attribute::TrustedDomains

pdf

rgb, gray, cmyk

<application/pdf>

Yes

compression

( none|zip|jpeg ), qlt=

qlt= is ignored unless compression is set to jpeg .

eps

rgb, gray, cmyk

<image/eps>

Yes

pathEmbed=

gif, gif-alpha

rgb, gray

Data is converted to palette after conversion to gray or rgb.

<image/gif>

No

quantize=

web, webp-alpha

rgb

<image/webp>

No

compression ( lossy , lossless )

qlt= is ignored for lossless .

Because there is no concept of chrominance downsampling with the WebP format, if you use a second value with qlt (for example, qlt=80,1 ) the second value ( 1 ) is ignored.

jpeg2000, jpeg2000-alpha

rgb, gray

<image/jp2>

No

Same as above.

jpegxr, jpegxr-alpha

rgb

<image/vnd.ms-photo>

No

Same as above.

Properties

Request attribute. Applies regardless of current layer setting if req=img (default) or req=mask; ignored otherwise.

type is ignored if iccProfile= is specified.

Default

fmt=jpeg, *defaultType*,none, where the defaultType is handled as follows: If icc= is specified, defaultType corresponds to the pixel type of the specified ICC profile. If icc= is not specified, defaultType is gray if req=mask, otherwise it is rgb.

Examples

Request a small, low quality preview image in JPEG format (default):

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

Request the same image converted to gray-scale:

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

Request the same image in a loss-less format with alpha channel and at high-resolution:

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

Request the alpha channel for the same image as a gray-scale TIFF image:

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

Convert the same image to cmyk using the default ICC profiles:

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

Convert the same image to cmyk using a different ICC profile and embed the profile in the TIFF image:

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

Deliver this image as a TIF file with JPEG compression without pixel type conversion:

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

Convert image to a bi-tonal GIF with key-color transparency and force colors to black and white:

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

Lossy with a quality setting of 80:

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

Lossless with alpha:

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

Lossy with a quality setting of 80:

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

Lossless with alpha:

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

Lossy with a quality setting of 80:

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

Lossless with alpha:

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

See also

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

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now