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

fmt fmt

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

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 Flash Streaming Server.

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 e sem perdas.

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 com deflate incorporada em um arquivo swf do Adobe AS2.

swf

JPEG com perda incorporado em um arquivo swf do Adobe AS2.

swf3-alpha

JPEG com perda e uma máscara compactada com deflate incorporada em um arquivo swf do Adobe AS3. Observação: os formatos swf e swf-alpha são mais adequados para aplicativos ActionScript 2 (Flash Player 8 e anterior). Os formatos swf3 e swf3-alpha são recomendados para uso nos aplicativos do ActionScript3 (Flash Player 9 e posterior).

swf3

JPEG com perda incorporado em um arquivo swf do 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

Retornar dados de imagem do RGB.

compression

Descrição

jpeg

Compactação de JPEG (com perda).

lossy

Compactação JPEG 2000 e JPEG XR (com perdas) e WebP.

lossless

Compactação HEIC, JPEG 2000, 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 o qlt= para definir as opções de codificação do JPEG para estes 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 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 Adobe Flash Player 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 section-5f96b0ce7c5a4df1bf52e24ea78c3dae

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 section-f885a785b32c44fea347db15fdb2ab1f

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 section-b93222e652df404a84c69025247f07df

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

Converta a mesma imagem em cmyk usando um perfil ICC diferente e incorpore o perfil na imagem do 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 section-fce8d69c74234bf48cf814d799409541

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

recommendation-more-help

a26166cd-f2f4-45ce-996d-96a0f0d6cf49