Operazioni supportate

Questa sezione elenca le operazioni supportate dall'ottimizzazione delle immagini di Cloud CDN. La tabella include parametri come operazione, sintassi, attributi, descrizione ed esempi, che ti aiutano a creare la query imop.

L'ottimizzazione delle immagini di Cloud CDN supporta un insieme di operazioni che ti consentono di trasformare le immagini, ad esempio ridimensionare, ritagliare e scalare. Ogni operazione ha una propria sintassi, attributi supportati e vincoli.

Questa pagina elenca le operazioni supportate dall'ottimizzazione delle immagini di Cloud CDN con esempi che ti aiutano a creare la query imop.

Operazione Sintassi ed esempio Attributi Descrizione

Resize

?imop=Resize,width=<resized_width>,height=<resized_height>

https://www.example.com/image.jpg?imop=Resize,width=250,height=125
  • width tipo: Integer (intervallo: 1-8192)
  • height tipo: Integer (intervallo: 1-8192)

la massima width * height non può superare i 67 mpx (67.108.864 pixel).

  • Tipo di scalabilità (facoltativo): enum, valori: proportional, stretch.
    		•

    Questa operazione non mantiene le proporzioni quando specifichi i parametri di larghezza e altezza. Se ometti una delle due dimensioni, l'ottimizzazione delle immagini di Cloud CDN calcola l'altra per mantenere le proporzioni.

    Per impostazione predefinita, l'ottimizzazione delle immagini applica una strategia rigorosa di riduzione delle dimensioni. Se specifichi il parametro scaling=stretch viene attivata la scalabilità, ma il sistema non lo consente se specifichi un solo parametro di dimensione.

    Scale

    ?imop=Scale,ratio=<scale_ratio>

    https://www.example.com/image.jpg?imop=Scale,ratio=0.5

    		 ratio
    • Tipo: Float (limitato a 2 cifre decimali)
    • Vincolo: 0 < value

    Questa operazione scala l'immagine in base a un fattore specifico e applica solo la riduzione delle dimensioni. Si esclude a vicenda con le operazioni Resize e Crop.

    Se includi l'operazione Scale con le operazioni Resize o Crop in una singola richiesta, il sistema restituisce un errore.

    Crop

    ?imop=Crop,shape=<shape>,left=<left>,right=<right>,top=<top&lgt;,bottom=<bottom>,snap_to_x=<snap_x>,snap_to_y=<snap_y>

    https://www.example.com/image.jpg?imop=Crop,shape=rectangle,left=0.5,snap_to_x=512

    		 shape
    • Tipo: String (rectangle, circle)
    • Valore predefinito: rectangle
    • Dipendenza: deve essere utilizzato con il parametro crop. Un valore non valido restituirà HTTP 400.
    left, right, top, bottom
    • Tipo: Float
    • Intervallo: da 0,0 a 1,0, massimo 3 posizioni decimali
    • Valore predefinito: 0,0, 1,0, 0,0, 1,0
    snap_to_x, snap_to_y
    • Tipo: Integer
    • Intervallo: 0 o superiore
    • Valore predefinito: 0
    • Vincolo: è obbligatorio includere almeno uno dei seguenti valori: left, right, top, bottom.

    Questa operazione ritaglia l'immagine in base ai marcatori regionali. Se specifichi un valore non valido per il parametro shape, il sistema restituisce un errore HTTP 400 Bad Request.

    Le coordinate di ritaglio vengono automaticamente allineate al multiplo più vicino del valore snap_to_x o snap_to_y specificato.

    Canvas

    ?imop=Canvas,width=<canvas_width>,height=<canva_height>,background_color=<color>,gravity=<gravity>

    https://www.example.com/image.jpg?imop=Canvas,width=250,height=125,background_color=FFF,gravity=center

    		 width, height
    • Tipo: Integer
    • Intervallo: 1-8192
    • La larghezza massima x l'altezza non può superare i 67.108.864 pixel.
    gravity
    • Tipo: String
    • Valori: center, left, right, top, bottom, top_left, top_right, bottom_left, bottom_right
    • Valore predefinito: center
    background_color
    • Tipo: String
    • Formato: codici esadecimali a 3, 4 o 6 cifre
    • Valore predefinito: 000000 (nero).

    Questa operazione migliora le immagini aggiungendo un layout di sfondo con dimensioni e colore specificati. Il parametro gravity determina il posizionamento dell'immagine interna su questa tela di sfondo.

    Rotate

    ?imop=Rotate,degrees=<rotate_degrees>

    https://www.example.com/image.jpg?imop=Rotate,degrees=90

    		 degrees
    • Tipo: Integer
    • Valori consentiti: 90, 180, 270.

    Questa operazione ruota l'immagine di destinazione in senso orario.

    Mirror

    ?imop=Mirror,flip=<flip>

    https://www.example.com/image.jpg?imop=Mirror,flip=h

    		 flip
    • Tipo: String
    • Valori consentiti: h (orizzontale), v (verticale), hv (orizzontale e verticale).

    Questa operazione riflette l'immagine in orizzontale, in verticale o in entrambi i modi.

    Compress

    ?imop=Compress,strength=<value>

    https://www.example.com/image.jpg?imop=Compress,strength=medium

    		 strength
    • Tipo: String
    • Valori consentiti: very_weak, weak, medium, strong, very_strong.
    • Vincolo: supportato solo per jpeg, avif e webp. I valori al di fuori di questo intervallo restituiscono HTTP 400.

    Questa operazione comprime l'immagine riducendone la qualità di destinazione. Il parametro strength ti consente di controllare il livello di compressione dell'immagine attiva.

    Convert

    ?imop=Convert,format=<format>

    https://www.example.com/image.jpg?imop=Convert,format=webp

    		 format
    • Tipo: String.
    • Valori consentiti: jpeg, png, webp, avif, gif
    • Vincolo: qualsiasi altro valore non elencato genererà un errore di elaborazione.

    Questa operazione modifica il formato di pubblicazione finale dell'immagine. Se si verifica un conflitto di elaborazione con la specifica dell'intestazione ACCEPT in entrata del browser, il sistema restituisce un errore HTTP 406 Not Acceptable.

    Metadata

    ?imop=Metadata,preserve=<preserve>

    https://www.example.com/image.jpg?imop=Metadata,preserve=none

    		 preserve
    • Tipo: String
    • Valori consentiti: none, copyright, max
    • Valore predefinito: copyright

    Questa operazione controlla la modalità di gestione delle proprietà dei metadati delle immagini durante l'esecuzione:

    none: rimuove tutte le proprietà dei metadati.

    max: conserva tutti i campi tranne l'orientamento EXIF e i profili colore che vengono applicati alla trasformazione

    .

    copyright: mantiene solo i campi Author, Copyright, e Caption.

    Tone

    ?imop=tone,brightness=<brightness>,contrast=<contrast_level>, saturation=<saturation>

    https://www.example.com/image.jpg?imop=tone,brightness=50,contrast=50,saturation=50
    • brightness
      • Tipo: Integer
      • Intervallo: da -100 a 100
    • contrast
      • Tipo: Integer
      • Intervallo: da -100 a 100
    • saturation
      • Tipo: Integer
      • Intervallo: da -100 a 100

    Questa operazione modifica dinamicamente i brightness, contrast, e saturation livelli di un'immagine. Se ometti un parametro specifico o lo imposti su 0, il sistema non modifica l'attributo. Se imposti la saturazione su -100, viene forzata la conversione in scala di grigi.

    Sharpen

    ?imop=Sharpen,strength=<sharpness>

    https://www.example.com/image.jpg?imop=Sharpen,strength=50

    		 strength
    • Tipo: Integer
    • Intervallo: da 0 a 100

    Questa operazione aumenta la nitidezza dell'immagine.

    Blur

    ?imop=Blur,strength=<blur_size>

    https://www.example.com/image.jpg?imop=Blur,strength=50

    		 strength
    • Tipo: Integer
    • Intervallo: da 0 a 100

    Questa operazione applica un filtro di sfocatura localizzato all'immagine.

    Freeze

    ?imop=freeze,frame=<frame>

    https://www.example.com/image.gif?imop=freeze,frame=0

    		 frame
    • Tipo: Integer
    • Intervallo: da 0 a 100.

    Questa operazione estrae un singolo frame statico da una sequenza di immagini animate , ad esempio una GIF animata. Il parametro frame specifica l'indice del frame esatto da estrarre.

    Passaggi successivi