DocumentationAPI de diffusion et de rendu d’images Dynamic Media

fmt fmt

Last update: Wed Jul 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Développeur
  • Utilisateur ou utilisatrice

Format d’image de réponse.

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

format - avif-alpha | avif | eps | f4m | gif-alpha | gif | hic | jpeg | jpeg2000-alpha | jpeg2000 | jpegxx-alpha | jpegxx | jpg | m3u8 | pdf | pjpeg | png-alpha | png | png8-alpha | png8 | swf-alpha | swf | swf3-alpha | swf3 | tif-alpha | tif | web-alpha | webp

format
Description
avif-alpha
AVIF avec couche alpha sans perte.
avif
AVIF sans perte.
eps
PostScript encapsulé binaire non compressé.
f4m
Format de manifeste du serveur de diffusion en continu de Flash.
gif-alpha
GIF de 2 à 255 couleurs plus transparence couleur-clé.
gif
GIF de 2 à 256 couleurs.
heic
HEIC sans perte. Ce format est téléchargé par défaut à partir du navigateur s’il n’est pas pris en charge.
jpeg
JPEG perdant.
jpeg2000-alpha
JPEG 2000 sans perte avec canal alpha.
jpeg2000
JPEG sans perte 2000.
jpegxr-alpha
XR JPEG sans perte et avec couche alpha.
jpegxr
XR JPEG sans perte.
jpg
perdant.
m3u8
Format de manifeste du serveur de diffusion en continu Apple.
pdf
Image incorporée dans PDF.
pjpeg
JPEG progressif.
png-alpha
PNG 24 bits sans perte avec canal alpha.
png
PNG 24 bits sans perte.
png8-alpha
PNG 8 bits sans perte avec canal alpha.
png8
PNG 8 bits sans perte.
swf-alpha
JPEG de perte et masque compressé par déflation incorporés dans un fichier swf AS2 Adobe.
swf
JPEG de perte incorporé dans un fichier swf AS2 Adobe.
swf3-alpha
JPEG de perte et masque décompressé incorporé dans un fichier swf AS3 Adobe. Remarque : Les formats swf et swf-alpha sont mieux utilisés pour les applications ActionScript 2 (Flash Player 8 et versions antérieures). Les formats swf3 et swf3-alpha sont recommandés pour les applications ActionScript3 (Flash Player 9 et versions ultérieures).
swf3
JPEG de perte incorporé dans un fichier swf AS3 Adobe.
tif-alpha
TIFF avec canal alpha.
tif
TIFF.
webp-alpha
WebP sans perte et avec canal alpha.
webp
WebP sans perte et sans perte.

pixelType - rgb | gris | cmyk

pixelType
Description
cmyk
Renvoie les données image CMJN.
gray
Renvoie les données image en niveaux de gris.
rgb
Renvoie les données image du RGB.

compression - jpeg | perte | lossless | lzw | none | zip

compression
Description
jpeg
Compression des JPEG (perte).
lossy
JPEG 2000, la compression XR JPEG (perte) et WebP.
lossless
Compression HEIC, JPEG 2000 et JPEG XR (sans perte) et WebP.
lzw
Compression LZW (Lempel-Ziv-Welch) (sans perte).
none
Décompressé.
zip
Compression "Deflate" (sans perte).

  • format spécifie le format de codage de l’image pour les données d’image envoyées au client et le type MIME de réponse correspondant pour l’en-tête de réponse HTTP.

  • pixelType peut être utilisé pour effectuer une conversion de l’espace colorimétrique de sortie lorsque icc= n’est pas spécifié.

    Le profil colorimétrique par défaut correspondant à pixelType est appliqué. Si la gestion des couleurs est désactivée, une conversion naïve est appliquée. pixelType est ignoré lorsque icc= est spécifié, ce qui détermine le type de pixel de sortie.

  • compression est autorisé uniquement si tif, tif-alpha, pdf, webp, webp-alpha, jpeg2000, jpeg2000-alpha, jpegxr ou jpegxr-alpha est spécifié comme format. Reportez-vous au tableau ci-dessous pour connaître les options de compression prises en charge pour ces formats d’image.

Vous pouvez utiliser qlt= pour définir les options de codage du JPEG pour ces formats : JPEG, TIFF avec compression du JPEG, PDF avec compression du JPEG et SWF. WebP, JPEG 2000 et JPEG XR utilisent également qlt=, mais les valeurs génèrent des qualités différentes pour les différents formats. Utilisez quantize= si fmt=gif ou fmt=gif-alpha. Pour plus d’informations, reportez-vous aux descriptions de commande . Les autres formats ne comportent pas d’options définissables.

Un composant de 8 bits par pixel est renvoyé pour les formats et pixelTypes (8 bits par pixel pour le GIF).

Le tableau suivant répertorie les combinaisons valides de *format*et pixelType, les types MIME de réponse HTTP correspondants, si les profils ICC peuvent être incorporés (voir iccEmbed=) et les options spécifiques au format que vous pouvez appliquer.

format
pixelType
Type MIME de réponse
Incorporer le profil ICC
Options
avif, avif-alpha
rvb
<image/avif>
Non

compression ( perte , perte sans perte )

qlt= est ignoré pour sans perte .

Puisqu’il n’existe aucun concept de sous-échantillonnage de chrominance avec le format WebP, si vous utilisez une seconde valeur avec qlt (par exemple, qlt=80,1 ), la seconde valeur ( 1 ) est ignorée.

eps
rgb, gray, cmyk
<image/eps>
Oui
pathEmbed=
gif, gif-alpha

rgb, gris

Les données sont converties en palette après la conversion en gris ou en rgb.

<image/gif>
Non
quantize=
hic
rvb
<image/heic>
Non
jpeg2000, jpeg2000-alpha
rgb, gris
<image/jp2>
Non

compression ( perte , perte sans perte )

qlt= est ignoré pour sans perte .

Puisqu’il n’existe aucun concept de sous-échantillonnage de chrominance avec le format WebP, si vous utilisez une seconde valeur avec qlt (par exemple, qlt=80,1 ), la seconde valeur ( 1 ) est ignorée.

jpeg, jpg, pjpeg
rgb, gray, cmyk
<image/jpeg>
Oui

pathEmbed= , pscan= , qlt= , xmpEmbed=

Le paramètre pscan= s’applique uniquement au format pjpeg.

jpegxx, jpegxx-alpha
rvb
<image/vnd.ms-photo>
Non

compression ( perte , perte sans perte )

qlt= est ignoré pour sans perte .

Puisqu’il n’existe aucun concept de sous-échantillonnage de chrominance avec le format WebP, si vous utilisez une seconde valeur avec qlt (par exemple, qlt=80,1 ), la seconde valeur ( 1 ) est ignorée.

pdf
rgb, gray, cmyk
<application/pdf>
Oui

compression

( none|zip|jpeg ), qlt=

qlt= est ignoré sauf si la compression est définie sur jpeg .

png8, png8-alpha
rvb
<image/png>
Oui
png, png-alpha
rgb, gris
<image/png>
Oui
swf,swf3, swf-alpha, swf-alpha3
rgb, gris
<application/x-chokwave-flash>

Non

Remarque : Le Flash Player Adobe ignore les profils ICC incorporés.

qlt= , attribut::TrustedDomains
tif, tif-alpha
rgb, gray, cmyk
<image/tiff>
Oui

compression

( none|lzw|zip|jpeg )

'tiff' uniquement ; 'tiff-alpha' ne prend pas en charge la compression jpeg.

qlt=

qlt= est ignoré sauf si la compression est définie sur jpeg .

, pathEmbed=, xmpEmbed=

webp, webp-alpha
rvb
<image/webp>
Non

compression ( perte , perte sans perte )

qlt= est ignoré pour sans perte .

Puisqu’il n’existe aucun concept de sous-échantillonnage de chrominance avec le format WebP, si vous utilisez une seconde valeur avec qlt (par exemple, qlt=80,1 ), la seconde valeur ( 1 ) est ignorée.

Propriétés section-5f96b0ce7c5a4df1bf52e24ea78c3dae

Attribut de requête. S’applique quel que soit le paramètre de calque actuel si req=img (par défaut) ou req=mask, ignoré dans le cas contraire.

type est ignoré si iccProfile= est spécifié.

Par défaut section-f885a785b32c44fea347db15fdb2ab1f

fmt=jpeg, *defaultType*,none, où defaultType est géré comme suit : si icc= est spécifié, defaultType correspond au type de pixel du profil ICC spécifié. Si icc= n'est pas spécifié, defaultType est gray si req=mask, sinon il est rgb.

Exemples section-b93222e652df404a84c69025247f07df

Demander une petite image d'aperçu de faible qualité au format JPEG (par défaut) :

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

Demander la même image convertie en niveaux de gris :

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

Demandez la même image dans un format sans perte avec canal alpha et à haute résolution :

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

Demandez le canal alpha pour la même image qu'une image de TIFF en niveaux de gris :

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

Convertir la même image en cmyk à l’aide des profils ICC par défaut :

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

Convertissez la même image en cmyk à l’aide d’un autre profil ICC et incorporez le profil dans l’image de TIFF :

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

Diffusez cette image en tant que fichier TIF avec compression de JPEG sans conversion de type pixel :

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

Convertir l’image en GIF bimensuel avec transparence couleur clé et forcer les couleurs en noir et blanc :

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

Perte avec un paramètre de qualité de 80 :

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

Sans perte avec couche alpha :

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

Perte avec un paramètre de qualité de 80 :

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

Sans perte avec couche alpha :

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

Perte avec un paramètre de qualité de 80 :

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

Sans perte avec couche alpha :

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

Voir aussi section-fce8d69c74234bf48cf814d799409541

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

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