fmt

Última atualização em 2023-08-22
  • Criado para:
  • Developer
    User

Formato de imagem de resposta.

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

format - avif-alpha | avif | eps | f4m | gif-alpha | gif | 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 | alfa-da-web | webp

format Descrição
avif-alpha AVIF com e sem perdas com canal alfa.
avif AVIF com e sem perdas.
eps PostScript binário encapsulado descompactado.
f4m Formato de manifesto do Servidor de Streaming do Flash.
gif-alpha GIF com 2 a 255 cores, além de transparência de cores-chave.
gif GIF com 2 a 256 cores.
jpeg JPEG com perda.
jpeg2000-alpha JPEG 2000 com canal alfa sem perdas e sem perdas.
jpeg2000 JPEG 2000 com perdas e sem perdas.
jpegxr-alpha JPEG XR com canal alfa com perda e sem perda.
jpegxr JPEG XR com perda e sem perda.
jpg JPG com perda.
m3u8 Formato de manifesto do Apple Streaming Server.
pdf Imagem incorporada no PDF.
pjpeg JPEG progressivo.
png-alpha PNG sem perda de 24 bits com canal alfa.
png PNG sem perda de 24 bits.
png8-alpha PNG sem perda de 8 bits com canal alfa.
png8 PNG sem perda de 8 bits.
swf-alpha JPEG com perda e uma máscara compactada por deflação incorporada em um arquivo swf Adobe AS2.
swf JPEG com perda incorporado em um arquivo swf Adobe AS2.
swf3-alpha JPEG com perda e uma máscara compactada por deflação incorporada em um arquivo swf Adobe AS3. Nota: os formatos swf e swf-alpha são mais adequados para os aplicativos do ActionScript 2 (Flash Player 8 e anterior). Recomenda-se o uso dos formatos swf3 e swf3-alpha para os aplicativos ActionScript3 (Flash Player 9 e posterior).
swf3 JPEG com perda incorporado em um arquivo swf Adobe AS3.
tif-alpha TIFF com canal alfa.
tif TIFF.
webp-alpha WebP com e sem perdas com canal alfa.
webp WebP com e sem perdas.

| pixelType - rgb | cinza | cmyk |

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

| compression - nenhuma | lzw | zip | jpeg | com perdas | sem perda |

compression Descrição
jpeg compactação JPEG (com perda).
lossy Compactação de WebP, JPEG 2000 e JPEG XR (com perda).
lossless Compactação de WebP, JPEG 2000 e JPEG XR (sem perda).
lzw Compressão LZW (Lempel-Ziv-Welch) (sem perdas).
none Não compactado.
zip Compactação "Deflate" (sem perda).
  • format especifica o formato de codificação de imagem para dados de imagem enviados ao cliente e o tipo MIME de resposta correspondente para o cabeçalho de resposta HTTP.

  • pixelType pode ser usado para efetuar a conversão do espaço de cores de saída quando icc= não foi especificado.

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

  • compression só é permitido se tif, tif-alpha, pdf, webp, webp-alpha, jpeg2000, jpeg2000-alpha, jpegxrou jpegxr-alpha é especificado como o 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 de JPEG para estes formatos: JPEG, TIFF com compactação de JPEG, PDF com compactação de JPEG e SWF. WebP, JPEG 2000 e JPEG XR também usam qlt= mas os valores resultam em qualidades diferentes para os diferentes formatos. Uso quantize= se fmt=gif ou fmt=gif-alpha. Consulte as descrições do comando para obter detalhes. Os outros formatos não têm opções que podem ser definidas.

8 bits por componente de pixel são retornados para todos formats e pixelTypes (8 bits por pixel para o 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.

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

jpeg, jpg, pjpeg

rgb, cinza, cmyk

<image/jpeg>

Sim

pathEmbed= , pscan= , qlt= , xmpEmbed=

A variável pscan= se aplica somente ao formato pjpeg.

png, png-alpha

rgb, cinza

<image/png>

Sim

png8, png8-alpha

rgb

<image/png>

Sim

tif, tif-alpha

rgb, cinza, cmyk

<image/tiff>

Sim

compactação

( none|lzw|zip|jpeg )

somente 'tiff'; 'tiff-alpha' não é compatível com a compactação jpeg.

qlt=

qlt= é ignorado, a menos que compactação está definida como jpeg .

, pathEmbed=, xmpEmbed=

swf,swf3, swf-alpha, swf-alpha3

rgb, cinza

<application/x-shockwave-flash>

Não

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

qlt= , attribute::TrustedDomains

pdf

rgb, cinza, cmyk

<application/pdf>

Sim

compactação

( none|zip|jpeg ), qlt=

qlt= é ignorado, a menos que compactação está definida como jpeg .

eps

rgb, cinza, cmyk

<image/eps>

Sim

pathEmbed=

gif, gif-alpha

rgb, cinza

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

<image/gif>

Não

quantize=

webp, webp-alpha

rgb

<image/webp>

Não

compactação ( com perdas , sem perda )

qlt= é ignorado para sem perda .

Como não há conceito de redução de resoluçã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 ) é ignorado.

jpeg2000, jpeg2000-alpha

rgb, cinza

<image/jp2>

Não

O mesmo que acima.

jpegxr, jpegxr-alpha

rgb

<image/vnd.ms-photo>

Não

O mesmo que acima.

avif, avif-alpha

rgb

<image/avif>

Não

O mesmo que acima.

Propriedades

Solicitar atributo. Aplica-se independentemente da configuração da camada atual se req=img (padrão) ou req=mask; ignorado caso contrário.

type é ignorado se iccProfile= é especificado.

Padrão

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

Exemplos

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

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

Solicitar 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 canal alfa e em alta resolução:

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

Solicite o canal alfa para a mesma imagem como uma imagem TIFF em tons de 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

Entregar essa imagem como um arquivo TIF com compactação JPEG sem conversão do 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 cor-chave e force as cores para preto e branco:

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

Com perdas e 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

Com perdas e 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

Com perdas e 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