DocumentaciónAPI de servicio y procesamiento de imágenes de Dynamic Media

fmt

Última actualización: 31 de julio de 2024
  • Temas:

Creado para:

  • Desarrollador
  • Usuario

Formato de imagen de respuesta.

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

format - avif-alpha | avif | eps | f4m | gif-alpha | gif | héico | 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 | web-alpha | webp

formatDescripción
avif-alphaAVIF con pérdida y sin pérdida con canal alfa.
avifAVIF con pérdidas y sin pérdidas.
epsPostScript encapsulado binario sin comprimir.
f4mFormato de manifiesto del servidor de flujo de Flash.
gif-alphaGIF con 2 a 255 colores más transparencia de color clave.
gifGIF con 2 a 256 colores.
heicHEIC sin pérdidas. Este formato se descarga de forma predeterminada desde el explorador si no es compatible.
jpegJPEG perdedor.
jpeg2000-alphaJPEG 2000 sin pérdidas y con canal alfa.
jpeg2000JPEG 2000 sin pérdidas y sin pérdidas.
jpegxr-alphaJPEG XR sin pérdidas y con canal alfa.
jpegxrJPEG XR con pérdidas y sin pérdidas.
jpgPerdió a su JPG.
m3u8Formato de manifiesto del servidor de flujo Apple.
pdfImagen incrustada en el PDF.
pjpegJPEG progresista.
png-alphaPNG sin pérdidas de 24 bits con canal alfa.
pngPNG sin pérdidas de 24 bits.
png8-alphaPNG sin pérdidas de 8 bits con canal alfa.
png8PNG sin pérdidas de 8 bits.
swf-alphaJPEG con pérdida y máscara comprimida con desinflado incrustada en un archivo swf AS2 de Adobe.
swfJPEG con pérdida incrustado en un archivo swf AS2 de Adobe.
swf3-alphaJPEG con pérdida y máscara comprimida con desinflado incrustada en un archivo swf AS3 de Adobe. Nota: los formatos swf y swf-alpha se usan mejor para las aplicaciones de ActionScript 2 (Flash Player 8 y anteriores). Los formatos swf3 y swf3-alpha se recomiendan para su uso en aplicaciones ActionScript 3 (Flash Player 9 y posteriores).
swf3JPEG con pérdida incrustado en un archivo swf AS3 de Adobe.
tif-alphaTIFF con canal alfa.
tifTIFF.
webp-alphaWebP sin pérdidas y con canal alfa.
webpWebP con pérdidas y sin pérdidas.

pixelType - rgb | gris | cmyk

pixelTypeDescripción
cmykDevuelve datos de imagen CMYK.
grayDevuelve datos de imagen en escala de grises.
rgbDevuelve datos de imagen del RGB.

compression - jpeg | con pérdidas | sin pérdidas | lzw | ninguno | zip

compressionDescripción
jpegCompresión JPEG (con pérdida).
lossyJPEG 2000, compresión XR del JPEG (con pérdida) y WebP.
losslesscompresión HEIC, JPEG 2000 y JPEG XR (sin pérdidas) y WebP.
lzwCompresión LZW (Lempel-Ziv-Welch) (sin pérdidas).
noneSin comprimir.
zipCompresión "Deflate" (sin pérdidas).
  • format especifica el formato de codificación de imagen para los datos de imagen enviados al cliente y el tipo MIME de respuesta correspondiente para el encabezado de respuesta HTTP.

  • pixelType se puede usar para efectuar la conversión del espacio de color de salida cuando icc= no se especifica.

    Se aplica el perfil de color predeterminado correspondiente a pixelType. Si la gestión de colores está desactivada, se aplica una conversión naïve. pixelType se omite cuando se especifica icc=, lo que determina el tipo de píxel de salida.

  • compression solo se permite si tif, tif-alpha, pdf, webp, webp-alpha, jpeg2000, jpeg2000-alpha, jpegxr o jpegxr-alpha se especifica como format. Consulte la tabla siguiente para ver las opciones de compresión admitidas para estos formatos de imagen.

Puede usar qlt= para establecer las opciones de codificación de JPEG para estos formatos: JPEG, TIFF con compresión de JPEG, PDF con compresión de JPEG y SWF. WebP, JPEG 2000 y JPEG XR también usan qlt=, pero los valores dan como resultado calidades diferentes para los distintos formatos. Use quantize= si fmt=gif o fmt=gif-alpha. Consulte las descripciones de los comandos para obtener más información. Los demás formatos no tienen opciones configurables.

Se devuelven 8 bits por componente de píxel para todos los formats y pixelTypes (8 bits por píxel para el GIF).

En la tabla siguiente se enumeran las combinaciones válidas de *format*y pixelType, los tipos MIME de respuesta HTTP correspondientes, si los perfiles ICC se pueden incrustar (consulte iccEmbed=) y qué opciones específicas de formato se pueden aplicar.

formato
pixelType
tipo MIME de respuesta
Incrustar perfil ICC
opciones
avif, avif-alfa
rgb
<image/avif>
No

compresión ( con pérdida , sin pérdida )

qlt= se omite para sin pérdidas .

Dado que no existe ningún concepto de disminución de resolución de crominancia con el formato WebP, si utiliza un segundo valor con qlt (por ejemplo, qlt=80,1 ), se omitirá el segundo valor ( 1 ).

eps
rgb, gris, cmyk
<image/eps>
Sí
pathEmbed=
gif, gif-alpha

rgb, gris

Los datos se convierten a la paleta después de la conversión a gris o rgb.

<image/gif>
No
cuantizar=
héico
rgb
<image/heic>
No
jpeg2000, jpeg2000-alpha
rgb, gris
<image/jp2>
No

compresión ( con pérdida , sin pérdida )

qlt= se omite para sin pérdidas .

Dado que no existe ningún concepto de disminución de resolución de crominancia con el formato WebP, si utiliza un segundo valor con qlt (por ejemplo, qlt=80,1 ), se omitirá el segundo valor ( 1 ).

JPEG, JPG, JPEG
rgb, gris, cmyk
<image/jpeg>
Sí

pathEmbed= , pscan= , qlt= , xmpEmbed=

El parámetro pscan= solo se aplica al formato pjpeg.

jpegxr, jpegxr-alpha
rgb
<image/vnd.ms-photo>
No

compresión ( con pérdida , sin pérdida )

qlt= se omite para sin pérdidas .

Dado que no existe ningún concepto de disminución de resolución de crominancia con el formato WebP, si utiliza un segundo valor con qlt (por ejemplo, qlt=80,1 ), se omitirá el segundo valor ( 1 ).

pdf
rgb, gris, cmyk
<application/pdf>
Sí

compresión

( none|zip|jpeg ), qlt=

qlt= se omite a menos que la compresión se establezca en jpeg .

png8, png8-alpha
rgb
<image/png>
Sí
png, png-alfa
rgb, gris
<image/png>
Sí
swf,swf3, swf-alfa, swf-alfa3
rgb, gris
<application/x-shockwave-flash>

No

Nota: El Flash Player de Adobe ignora los perfiles ICC incrustados.

qlt= , atributo::TrustedDomains
tif, tif-alpha
rgb, gris, cmyk
<image/tiff>
Sí

compresión

( none|lzw|zip|jpeg )

solo 'tiff'; 'tiff-alpha' no admite la compresión jpeg.

qlt=

qlt= se omite a menos que la compresión se establezca en jpeg .

, pathEmbed=, xmpEmbed=

webp, webp-alpha
rgb
<image/webp>
No

compresión ( con pérdida , sin pérdida )

qlt= se omite para sin pérdidas .

Dado que no existe ningún concepto de disminución de resolución de crominancia con el formato WebP, si utiliza un segundo valor con qlt (por ejemplo, qlt=80,1 ), se omitirá el segundo valor ( 1 ).

Propiedades

Atributo de solicitud. Se aplica independientemente de la configuración de capa actual si req=img (predeterminado) o req=mask; se omite en caso contrario.

type se omite si se especifica iccProfile=.

Predeterminado

fmt=jpeg, *defaultType*,none, donde defaultType se administra de la siguiente manera: Si se especifica icc=, defaultType corresponde al tipo de píxel del perfil ICC especificado. Si no se especifica icc=, defaultType es gray si req=mask; en caso contrario, es rgb.

Ejemplos

Solicitar una imagen de vista previa pequeña y de baja calidad en formato JPEG (predeterminado):

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

Solicitar la misma imagen convertida a escala de grises:

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

Solicite la misma imagen en un formato sin pérdidas con canal alfa y en alta resolución:

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

Solicite el canal alfa para la misma imagen que una imagen de TIFF en escala de grises:

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

Convertir la misma imagen a cmyk con los perfiles ICC predeterminados:

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

Convierta la misma imagen a cmyk usando un perfil ICC diferente e incruste el perfil en la imagen del TIFF:

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

Enviar esta imagen como archivo TIF con compresión JPEG sin conversión de tipo de píxel:

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

Convierta la imagen en un GIF bi-tonal con transparencia de clave de color y fuerza de los colores a blanco y negro:

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

Perdedor con una configuración de calidad de 80:

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

Sin pérdidas con alfa:

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

Perdedor con una configuración de calidad de 80:

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

Sin pérdidas con alfa:

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

Perdedor con una configuración de calidad de 80:

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

Sin pérdidas con alfa:

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

Véase también

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

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