DocumentazioneAPI di server e rendering immagini Dynamic Media

fmt fmt

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

Creato per:

  • Sviluppatore
  • Utente

Formato immagine di risposta.

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

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

format
Descrizione
avif-alpha
AVIF con perdita di dati e senza perdita di dati con canale alfa.
avif
Perdita e senza perdita di avf.
eps
PostScript incapsulato binario non compresso.
f4m
Formato del manifesto di Flash Streaming Server.
gif-alpha
GIF con 2-255 colori più trasparenza chiave-colore.
gif
GIF con 2-256 colori.
heic
EIC senza perdita di dati. Se non è supportato, questo formato viene scaricato per impostazione predefinita dal browser.
jpeg
Perdita di JPEG.
jpeg2000-alpha
JPEG 2000 con canale alfa senza perdite.
jpeg2000
JPEG 2000 senza perdite.
jpegxr-alpha
JPEG XR senza perdita di dati con canale alfa.
jpegxr
JPEG XR senza perdite
jpg
Perdita di JPG.
m3u8
Formato del manifesto di Apple Streaming Server.
pdf
Immagine incorporata in PDF.
pjpeg
JPEG progressivo.
png-alpha
PNG senza perdite a 24 bit con canale alfa.
png
PNG senza perdite a 24 bit.
png8-alpha
PNG senza perdita di 8 bit con canale alfa.
png8
PNG senza perdita di 8 bit.
swf-alpha
JPEG con perdita di dati e maschera compressa deflata incorporata in un file SWF Adobe AS2.
swf
JPEG con perdita di dati incorporato in un file SWF Adobe AS2.
swf3-alpha
JPEG con perdita di dati e maschera compressa deflata incorporata in un file SWF Adobe AS3. Nota: i formati swf e swf-alpha sono più adatti per le applicazioni ActionScript 2 (Flash Player 8 e versioni precedenti). I formati swf3 e swf3-alpha sono consigliati per le applicazioni ActionScript3 (Flash Player 9 e versioni successive).
swf3
Lossy JPEG incorporato in un file SWF Adobe AS3.
tif-alpha
TIFF con canale alfa.
tif
TIFF.
webp-alpha
WebP senza perdita di dati con canale alfa.
webp
WebP senza perdita di dati.

pixelType - rgb | grigio | cmyk

pixelType
Descrizione
cmyk
Restituisci dati immagine CMYK.
gray
Restituisci dati immagine in scala di grigio.
rgb
Restituire i dati immagine RGB.

compression - jpeg | lossy | senza perdita | lzw | nessuno | zip

compression
Descrizione
jpeg
Compressione JPEG (con perdita di dati).
lossy
JPEG 2000, compressione JPEG XR (con perdita di dati) e WebP.
lossless
Compressione HEIC, JPEG 2000 e JPEG XR (senza perdita di dati) e WebP.
lzw
Compressione LZW (Lempel-Ziv-Welch) (senza perdita di dati).
none
Non compresso.
zip
Compressione Deflate (senza perdita di dati).

  • format specifica il formato di codifica immagine per i dati immagine inviati al client e il tipo MIME di risposta corrispondente per l'intestazione di risposta HTTP.

  • È possibile utilizzare pixelType per eseguire la conversione dello spazio colore di output quando icc= non è specificato.

    Viene applicato il profilo colore predefinito corrispondente a pixelType. Se la gestione del colore è disattivata, viene applicata la conversione naïve. pixelType viene ignorato quando si specifica icc=, che determina il tipo di pixel di output.

  • compression è consentito solo se tif, tif-alpha, pdf, webp, webp-alpha, jpeg2000, jpeg2000-alpha, jpegxr o jpegxr-alpha è specificato come format. Per informazioni sulle opzioni di compressione supportate per questi formati di immagine, consulta la tabella seguente.

È possibile utilizzare qlt= per impostare le opzioni di codifica JPEG per i seguenti formati: JPEG, TIFF con compressione JPEG, PDF con compressione JPEG e SWF. Anche WebP, JPEG 2000 e JPEG XR utilizzano qlt=, ma i valori determinano qualità diverse per i diversi formati. Usa quantize= se fmt=gif o fmt=gif-alpha. Per ulteriori informazioni, consultare le descrizioni dei comandi. Gli altri formati non dispongono di opzioni impostabili.

Vengono restituiti 8 bit per componente pixel per tutti formats e pixelTypes (8 bit per pixel per GIF).

Nella tabella seguente sono elencate le combinazioni valide di *format*e pixelType, i tipi MIME di risposta HTTP corrispondenti, se i profili ICC possono essere incorporati (vedere iccEmbed=) e quali opzioni specifiche del formato è possibile applicare.

formato
pixelType
tipo MIME risposta
Incorpora profilo ICC
Opzioni
avif, avif-alfa
rgb
<image/avif>
No

Compressione ( con perdita , senza perdita )

qlt= ignorato per senza perdita di dati .

Poiché non esiste alcun concetto di downsampling della crominanza con il formato WebP, se si utilizza un secondo valore con qlt (ad esempio, qlt=80,1 ) il secondo valore ( 1 ) viene ignorato.

eps
rgb, grigio, cmyk
<image/eps>
Sì
pathEmbed=
gif, gif-alfa

rgb, grigio

I dati vengono convertiti in palette dopo la conversione in grigio o rgb.

<image/gif>
No
Quantize =
heic
rgb
<image/heic>
No
jpeg2000, jpeg2000-alpha
rgb, grigio
<image/jp2>
No

Compressione ( con perdita , senza perdita )

qlt= ignorato per senza perdita di dati .

Poiché non esiste alcun concetto di downsampling della crominanza con il formato WebP, se si utilizza un secondo valore con qlt (ad esempio, qlt=80,1 ) il secondo valore ( 1 ) viene ignorato.

jpeg, jpg, pjpeg
rgb, grigio, cmyk
<image/jpeg>
Sì

pathEmbed= , pscan= , qlt= , xmpEmbed=

Il parametro pscan= si applica solo al formato pjpeg.

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

Compressione ( con perdita , senza perdita )

qlt= ignorato per senza perdita di dati .

Poiché non esiste alcun concetto di downsampling della crominanza con il formato WebP, se si utilizza un secondo valore con qlt (ad esempio, qlt=80,1 ) il secondo valore ( 1 ) viene ignorato.

pdf
rgb, grigio, cmyk
<applicazione/pdf>
Sì

Compressione

( none|zip|jpeg ), qlt=

qlt= viene ignorato a meno che la compressione non sia impostata su jpeg .

png8, png8-alfa
rgb
<image/png>
Sì
png, png-alfa
rgb, grigio
<image/png>
Sì
swf,swf3, swf-alfa, swf-alfa3
rgb, grigio
<application/x-shockwave-flash>

No

Nota: Adobe Flash Player ignora i profili ICC incorporati.

qlt= , attributo ::DominiAttendibili
tif, tif-alfa
rgb, grigio, cmyk
<image/tiff>
Sì

Compressione

( none|lzw|zip|jpeg )

solo 'tiff'; 'tiff-alpha' non supporta la compressione jpeg.

qlt=

qlt= viene ignorato a meno che la compressione di non sia impostata su jpeg .

, pathEmbed=, xmpEmbed=

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

Compressione ( con perdita , senza perdita )

qlt= ignorato per senza perdita di dati .

Poiché non esiste alcun concetto di downsampling della crominanza con il formato WebP, se si utilizza un secondo valore con qlt (ad esempio, qlt=80,1 ) il secondo valore ( 1 ) viene ignorato.

Proprietà section-5f96b0ce7c5a4df1bf52e24ea78c3dae

Attributo della richiesta. Si applica indipendentemente dall'impostazione del livello corrente se req=img (impostazione predefinita) o req=mask; altrimenti ignorato.

type viene ignorato se iccProfile= è specificato.

Predefinito section-f885a785b32c44fea347db15fdb2ab1f

fmt=jpeg, *defaultType*,none, in cui defaultType viene gestito come segue: se è specificato icc=, defaultType corrisponde al tipo di pixel del profilo ICC specificato. Se icc= non è specificato, defaultType è gray se req=mask, altrimenti è rgb.

Esempi section-b93222e652df404a84c69025247f07df

Richiedi un'immagine di anteprima piccola e di bassa qualità in formato JPEG (predefinito):

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

Richiedi la stessa immagine convertita in scala di grigio:

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

Richiedi la stessa immagine in un formato senza perdita di dati con canale alfa e ad alta risoluzione:

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

Richiedi il canale alfa per la stessa immagine di un'immagine TIFF in scala di grigio:

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

Convertire la stessa immagine in CMYK utilizzando i profili ICC predefiniti:

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

Convertire la stessa immagine in CMYK utilizzando un profilo ICC diverso e incorporare il profilo nell'immagine TIFF:

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

Distribuisci questa immagine come file TIF con compressione JPEG senza conversione del tipo di pixel:

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

Converti l'immagine in un GIF a due tonalità con trasparenza dei colori chiave e forza i colori in bianco e nero:

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

Perdita con un'impostazione di qualità di 80:

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

Senza perdita con alfa:

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

Perdita con un'impostazione di qualità di 80:

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

Senza perdita con alfa:

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

Perdita con un'impostazione di qualità di 80:

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

Senza perdita con alfa:

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

Consultate anche section-fce8d69c74234bf48cf814d799409541

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

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