Documentação API de disponibilização e renderização de imagens do Dynamic Media

fmt

Última atualização: 31 de julho de 2024

Tópicos:

Criado para:

Desenvolvedor
Usuário

Formato de imagem de resposta.

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

`format`	Descrição
`avif-alpha`	AVIF com e sem perdas com canal alfa.
`avif`	AVIF com e sem perdas.
`eps`	PostScript Encapsulado binário 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.
`heic`	HEIC sem perdas. Esse formato é baixado por padrão do navegador se não for compatível.
`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. Observação: 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`	Descrição
`jpeg`	compactação JPEG (com perda).
`lossy`	compactação JPEG 2000 e JPEG XR (com perda) e WebP.
`lossless`	Compressão HEIC, JPEG 2000 e JPEG XR (sem perdas) e WebP.
`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 está especificado.

O perfil de cores padrão correspondente a pixelType é aplicado. 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 é 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 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. Use 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.

O componente de 8 bits por pixel é retornado para todos os 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 inseridos (consulte iccEmbed=) e quais opções específicas de formato você pode aplicar.

formato

pixelType

Tipo MIME de resposta

Inserir perfil ICC

Opções

avif, avif-alpha

rgb

Não

compactação ( com perdas , sem perdas )

qlt= foi ignorado por sem perdas.

Como não há nenhum 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 ) será ignorado.

eps

rgb, cinza, cmyk

Sim

pathEmbed=

gif, gif-alpha

rgb, cinza

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

Não

quantize=

heic

rgb

Não

jpeg2000, jpeg2000-alpha

rgb, cinza

Não

compactação ( com perdas , sem perdas )

qlt= foi ignorado por sem perdas.

Como não há nenhum 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 ) será ignorado.

jpeg, jpg, pjpeg

rgb, cinza, cmyk

Sim

pathEmbed= , pscan= , qlt= , xmpEmbed=

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

jpegxr, jpegxr-alpha

rgb

Não

compactação ( com perdas , sem perdas )

qlt= foi ignorado por sem perdas.

Como não há nenhum 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 ) será ignorado.

pdf

rgb, cinza, cmyk

Sim

compactação

( none|zip|jpeg ), qlt=

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

png8, png8-alpha

rgb

Sim

png, png-alpha

rgb, cinza

Sim

swf,swf3, swf-alpha, swf-alpha3

rgb, cinza

Não

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

qlt= , atributo::TrustedDomains

tif, tif-alpha

rgb, cinza, cmyk

Sim

compactação

( none|lzw|zip|jpeg )

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

qlt=

qlt= será ignorado, a menos que a compactação de esteja definida como jpeg .

, pathEmbed=, xmpEmbed=

webp, webp-alpha

rgb

Não

compactação ( com perdas , sem perdas )

qlt= foi ignorado por sem perdas.

Como não há nenhum 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 ) será ignorado.

Propriedades

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

type será ignorado se iccProfile= for especificado.

Padrão

fmt=jpeg, *defaultType*,none, onde defaultType é manipulado da seguinte maneira: se icc= for especificado, defaultType corresponderá 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

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

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

Solicitar a mesma imagem convertida em escala de cinza:

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

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

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

Solicitar o canal alfa para a mesma imagem como uma imagem TIFF em tons de cinza:

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

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

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

Converter a mesma imagem em cmyk usando um perfil ICC diferente e incorporar o perfil na imagem TIFF:

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

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

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

Converter imagem em um GIF bi-tonal com transparência de cor-chave e forçar cores para preto e branco:

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

Com perda com uma configuração de qualidade de 80:

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

Sem perda com alfa:

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

Com perda com uma configuração de qualidade de 80:

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

Sem perda com alfa:

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

Com perda com uma configuração de qualidade de 80:

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

Sem perda com alfa:

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

Consulte também

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

recommendation-more-help