fmt

Formato de imagem de resposta.

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

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

format Descrição
jpeg JPEG com perdas
jpg JPG com perdas
pjpeg JPEG progressivo
png PNG sem perdas de 24 bits
png8 PNG sem perdas de 8 bits
png-alpha PNG sem perdas de 24 bits com canal alfa
png8-alpha PNG sem perdas de 8 bits com canal alfa
tif TIFF
tif-alpha TIFF com canal alfa
pdf Imagem incorporada no PDF
eps PostScript Encapsulado binário descompactado
gif GIF com 2 a 256 cores
gif-alpha GIF com 2 a 255 cores mais transparência de cores-chave
swf JPEG com perdas incorporado em um arquivo swf Adobe AS2
swf-alpha JPEG com perdas e uma máscara compactada deflacionada incorporada em um arquivo swf Adobe AS2
swf3 JPEG com perdas incorporado em um arquivo swf do Adobe AS3
swf3-alpha JPEG com perdas e uma máscara compactada em deflate incorporada a um arquivo swf Adobe AS3. Observação: os formatos swf e swf-alfa são mais usados para aplicativos do ActionScript 2 (Flash Player 8 e anterior). swf3 e swf3-alpha são recomendados para uso em aplicativos ActionScript3 (Flash Player 9 e posterior)
m3u8 Formato de manifesto do servidor de transmissão da Apple
f4m Formato de manifesto do servidor de transmissão do Flash
webp WebP sem perdas e com perdas
webp-alpha WebP sem perdas e com perdas com canal alfa
jpeg2000 JPEG 2000 sem perdas
jpeg2000-alpha JPEG 2000 com canal alfa sem perdas
jpegxr JPEG XR sem perdas e com perdas
jpegxr-alpha JPEG XR sem perdas e com perdas com canal alfa

| pixelType — rgb | cinza | cmyk |

pixelType Descrição
rgb Retornar dados de imagem RGB.
gray Retorna dados de imagem em escala de cinza.
cmyk Retornar dados de imagem CMYK.

| compression — nenhum | lzw | zip | jpeg | perda | sem perdas |

compression Descrição
none Descompactado
lzw Compactação LZW (Lempel-Ziv-Welch) (sem perdas)
zip Compactação "Padrão" (sem perdas)
jpeg Compactação JPEG (com perdas)
lossy Compactação WebP, JPEG 2000 e JPEG XR (com perdas)
lossless Compactação WebP, JPEG 2000 e JPEG XR (sem perdas)

  • format especifica o formato de codificação de imagem para os dados de imagem enviados ao cliente e o tipo MIME de resposta correspondente para o cabeçalho de resposta HTTP.

  • pixelType pode ser usada para efetivar a conversão do espaço de cores de saída quando não icc= for especificada.

    O perfil de cor padrão correspondente a pixelType é aplicado. Se o gerenciamento de cores estiver desativado, a conversão ingênua será aplicada. pixelType é ignorada quando icc= é especificada, o que determina o tipo de pixel de saída.

  • compression é permitido somente se tif, tif-alpha, pdf, webp, webp-alpha, jpeg2000, jpeg2000-alpha, jpegxr ou jpegxr-alpha for especificado como format. Consulte a tabela abaixo para obter as opções de compactação compatíveis com esses formatos de imagem.

Você pode usar qlt= para definir as opções de codificação JPEG para esses formatos: JPEG, TIFF com compactação JPEG, PDF com compactação JPEG e SWF. WebP, JPEG 2000 e JPEG XR também usam qlt=, mas os valores resultam em qualidades diferentes para os diferentes formatos. Use quantize= se fmt=gif ou fmt=gif-alpha. Consulte as descrições dos comandos para obter detalhes. Os outros formatos não têm opções configuráveis.

8 bits por componente de pixel são retornados para todos os formats e pixelTypes (8 bits por pixel para GIF).

A tabela a seguir lista as combinações válidas de format e pixelType, os tipos MIME de resposta HTTP correspondentes, se os perfis ICC podem ser incorporados (consulte iccEmbed=) e quais opções específicas de formato você pode aplicar.

format pixelType Tipo MIME de resposta Incorporar perfil ICC Opções

jpeg, jpg, pjpeg

rgb, cinza, cmyk

<image>

Sim

pathEmbed= , pscan= , qlt= , xmpEmbed=

O parâmetro pscan= se aplica somente ao formato pjpeg.

png, png-alfa

rgb, cinza

<image>

Sim

png8, png8-alfa

rgb

<image>

Sim

tif, tif-alfa

rgb, cinza, cmyk

<image>

Sim

compressão

( none|lzw|zip|jpeg )

Unicamente "tiff"; 'tiff-alpha' não suporta compactação jpeg.

qlt=

qlt= é ignorado a menos que a compactação esteja definida como jpeg .

, pathEmbed=, xmpEmbed=

swf,swf3, swf-alpha, swf-alpha3

rgb, cinza

<application>

Não

Observação: O Flash Player Adobe ignora perfis ICC incorporados.

qlt= , atributo::TrustedDomains

pdf

rgb, cinza, cmyk

<application>

Sim

compressão

( none|zip|jpeg ), qlt=

qlt= é ignorado a menos que a compactação esteja definida como jpeg .

eps

rgb, cinza, cmyk

<image>

Sim

pathEmbed=

gif, gif-alfa

rgb, cinza

Os dados são convertidos em paleta após a conversão em cinza ou rgb.

<image>

Não

quantize=

web, webp-alfa

rgb

<image>

Não

Compactação ( com perdas , sem perdas )

qlt= é ignorado para sem perdas .

Como não há conceito de redução de crominância com o formato WebP, se você usar um segundo valor com qlt (por exemplo, qlt=80,1 ), o segundo valor ( 1 ) será ignorado.

jpeg2000, jpeg2000-alfa

rgb, cinza

<image>

Não

O mesmo que acima.

jpegxr, jpegxr-alfa

rgb

<image>

Não

O mesmo que acima.

Propriedades

Atributo da solicitação. Aplica-se independentemente da configuração de camada atual se req=img (padrão) ou req=mask; caso contrário, será ignorado.

type é ignorada se iccProfile= for especificada.

Padrão

fmt=jpeg, *defaultType*,none, onde o defaultType é tratado da seguinte maneira: Se icc= for especificado, defaultType corresponde ao tipo de pixel do perfil ICC especificado. Se icc= não for especificado, defaultType será gray se req=mask, caso contrário será rgb.

Exemplos

Solicite uma imagem de visualização pequena e de baixa qualidade no formato JPEG (padrão):

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

Solicite a mesma imagem convertida em escala de cinza:

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

Solicite a mesma imagem em um formato sem perdas com o canal alfa e em alta resolução:

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

Solicite o canal alfa para a mesma imagem que uma imagem TIFF em escala cinza:

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

Converta a mesma imagem em cmyk usando os perfis ICC padrão:

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

Converta a mesma imagem em cmyk usando um perfil ICC diferente e incorpore o perfil na imagem TIFF:

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

Forneça esta imagem como um arquivo TIF com compactação JPEG sem conversão de tipo pixel:

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

Converta a imagem em um GIF bi-tonal com transparência de cores chave e force as cores para preto e branco:

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

Perda com um ajuste de qualidade de 80:

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

Sem perdas com alfa:

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

Perda com um ajuste de qualidade de 80:

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

Sem perdas com alfa:

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

Perda com um ajuste de qualidade de 80:

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

Sem perdas com alfa:

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

Consulte também

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

Nesta página