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

fmt

Última atualização: 20 de julho de 2024
  • Tópicos:

Criado para:

  • Desenvolvedor
  • Usuário

Formato de imagem de resposta. 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.

fmt= *formato*[,[ *pixelType*][, *tiffCompression*]]

formatojpegJPEG com perda.
jpgJPG com perda.
pngPNG sem perda.
png-alphaPNG sem perda com canal alfa.
tifTIFF.
tif-alphaTIFF com canal alfa.
swfJPEG com perda incorporado em um arquivo swf do Macromedia.
swf-alphaJPEG com perdas e uma Máscara compactada por deflação incorporada a um arquivo swf do Macromedia.
pdfImagem incorporada no PDF.
epsPostScript Encapsulado binário descompactado.
gifGIF com 256 cores.
gif-alphaGIF com 255 cores mais transparência de cores-chave.
pixelTypergbRetorna dados da imagem de RGB.
cinzaRetorna dados de imagem em tons de cinza.
cmykRetorna dados de imagem CMYK.
tiffCompressionnenhumNão compactado.
lzwCompressão LZW (Lempel-Ziv-Welch) (sem perdas).
zipCompactação "Deflate" (sem perda).
jpegcompactação JPEG (com perda).

pixelType Afeta a conversão do espaço de cores de saída quando icc= não é especificado; 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 É ignorado quando icc= é especificado, o que determina o tipo de pixel de saída.

compression Permitido somente se tif, tif-alpha ou PDF for especificado como format. Consulte a tabela abaixo para obter as opções de compactação compatíveis com esses formatos de imagem.

qlt- Define 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 arquivo SWF. 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.

Oito bits por componente de pixel são retornados para todos os formatos e tipos de pixel.

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 comandos de opção específicos de formato podem ser aplicados.

formatopixelTypeTipo de MIME de respostaIncorporar perfil ICCOpções
jpeg, jpgrgb, cinza, cmyk<imagem/jpeg>Simqlt=
png, png-alphargb, cinza<image/png>Sim
png8, png8-alphargb<image/png>sim
tif, tif-alphargb, cinza, cmyk<imagem/tiff>Sim

tiffCompression

(none|lzw|zip|jpeg), pathEmbed=, qlt

( qlt= é ignorado a menos que tiffCompression esteja definida como 'jpeg'.)

swf, swf-alphargb, cinza<application/x-shockwave-flash>

Não

(O Flash Player ignora perfis ICC incorporados.)

qlt= , atributo::TrustedDomains
pdfrgb, cinza, cmyk<aplicativo/pdf>Sim

tiffCompression

(none|zip|jpeg),qlt=

( qlt= é ignorado a menos que tiffCompression esteja definida como 'jpeg'.)

epsrgb, cinza, cmyk<imagem/eps>SimpathEmbed=
gif, gif-alpha

rgb, cinza

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

<imagem/gif>Não

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

png-alpha Retorna alfa não associado (isto é, alfa não pré-multiplica os valores de pixel), enquanto tif-alpha e swf-alpha retornam alfa associado (isto é, os valores alfa são pré-multiplicados com os valores alfa). O canal alfa corresponde ao inverso da máscara de plano de fundo da vinheta para req=img, e à máscara de grupo ou objeto se houver req=object. Para aplicar alfa ao usar uma solicitação de IR aninhada, adicione fmt= com o formato de arquivo alfa apropriado à solicitação de IR incorporada e à solicitação principal. Nenhum dado alfa é retornado se um perfil CMYK ou ICC em tons de cinza for especificado com icc=.

Propriedades

Pode ocorrer em qualquer lugar na solicitação.

Padrão

format O padrão é attribute::Format e tiffCompression o padrão é attribute::TiffEncoding. O padrão de pixelType é rgb se icc= não for especificado, caso contrário, ele corresponde ao tipo de pixel do perfil ICC especificado.

Consulte também

attribute::Format , attribute::JpegQuality, attribute::TiffEncoding, qlt=, iccEmbed=, pathEmbed=, req=, quantize=

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49