Come funziona il Real Time Image Editor su AMBRA AI MEDIABOOST? – THRON Guide

Tramite la funzionalità di Real Time Image Editor di AMBRA AI MEDIABOOST ottimizzi ogni immagine direttamente nell'URL di delivery — ritaglia, ridimensiona, regola luminosità e formato senza dover creare e archiviare varianti in anticipo. Il motore genera la versione richiesta al volo e la mette in cache automaticamente per le richieste successive.

L'ordine delle operazioni è sempre fisso, indipendentemente da come scrivi i parametri nell'URL:

Crop — ritaglio dell'immagine originale
Resize — ridimensionamento dell'immagine risultante
Modify — modifiche visive senza alterare le dimensioni in pixel

Ridimensiona l'immagine

Usa i parametri di resize per definire le dimensioni dell'immagine in output. L'aspect ratio originale è sempre rispettato: se specifichi sia larghezza che altezza con proporzioni diverse dall'originale, viene applicata la misura più restrittiva e l'altra viene ignorata.

Parametro	Tipo	Default	Descrizione
`w`	int	larghezza originale	Larghezza desiderata in pixel.
`h`	int	altezza originale	Altezza desiderata in pixel.
`zoom`	boolean	—	Consente l'ingrandimento oltre le dimensioni originali. Richiede sia `w` che `h`.
`dpr`	int	—	Device Pixel Ratio. Valori: `1`, `2`, `3`, `4`. Moltiplica le dimensioni richieste per schermi ad alta densità.

Esempi:

w=320 — larghezza 320px, altezza proporzionale
w=300&h=300 — su un'immagine 16:9 il risultato è 300×169px (vince la misura più restrittiva)
dpr=2&h=216 — altezza 216px a densità doppia per schermi Retina
zoom=true&w=2500&h=2000 — ingrandimento oltre le dimensioni originali (entrambe le dimensioni obbligatorie)

Configurazione consigliata per schermi Retina
Usa dpr=2 insieme a w o h. Esempio: dpr=2&h=216 restituisce un'immagine ad alta densità senza dover raddoppiare le dimensioni a mano.

Ritaglia l'immagine

Il crop manuale ti permette di selezionare con precisione l'area dell'immagine da conservare. Il sistema di riferimento ha l'origine (0,0) nell'angolo in alto a sinistra, con l'asse x verso destra e l'asse y verso il basso. L'aspect ratio dell'immagine risultante può essere diverso dall'originale a seconda dei valori scelti.

Parametro	Tipo	Default	Descrizione
`cx`	int	0	Posizione del bordo sinistro dell'area di crop (distanza dall'origine sull'asse x).
`cy`	int	0	Posizione del bordo superiore dell'area di crop (distanza dall'origine sull'asse y).
`cw`	int	larghezza − cx	Larghezza dell'area di crop a partire da (cx, cy).
`ch`	int	altezza − cy	Altezza dell'area di crop a partire da (cx, cy).

Esempio: cx=384&cw=1056&cy=54&ch=940 — crop dall'angolo (384, 54) con area 1056×940px.

Solo valori assoluti in pixel. I parametri di crop non accettano valori percentuali.

Crop automatico

Il parametro crop combina ritaglio e resize in modalità automatica, eliminando la necessità di calcolare coordinate a mano. Ignora tutti i parametri di crop manuali (cx, cy, cw, ch): non combinarli nello stesso URL.

Modalità	Come funziona	Ideale per
`crop=centered`	Ritaglia al centro per ottenere esattamente le dimensioni richieste con `w` e `h`. Le porzioni esterne vengono eliminate.	Thumbnail uniformi, griglie editoriali.
`crop=auto`	Analizza l'immagine e individua il centro di gravità del soggetto. Se specifichi sia `w` che `h`: adatta il crop all'aspect ratio richiesto. Se specifichi solo una dimensione: ritaglia sull'area soggetto e ridimensiona. Se non specifichi nessuna dimensione: il crop coincide con l'area soggetto senza resize.	Immagini editoriali, banner, ritratti.
`crop=product`	Rileva e rimuove i bordi con colore uniforme (es. sfondo bianco). Se specifichi `w` e `h`: aggiunge bande del colore di sfondo rilevato per rispettare l'aspect ratio (o il colore definito con `fillColor`).	Foto prodotto su sfondo uniforme, e-commerce.

Configurazione consigliata — immagini prodotto (e-commerce)
crop=product&w=600&h=600 — rimuove automaticamente il bordo bianco e restituisce un'immagine quadrata pronta all'uso. Aggiungi fillColor=#FFFFFF per forzare il bianco come colore di riempimento (solo su immagini già senza sfondo).

Configurazione consigliata — banner editoriali
crop=auto&w=1200&h=630 — centra automaticamente il soggetto nelle dimensioni standard per social e banner, senza crop manuale.

Modifica l'aspetto dell'immagine

Le operazioni Modify cambiano l'aspetto visivo senza alterare le dimensioni in pixel. Si applicano sempre dopo crop e resize.

Qualità e formato

Parametro	Tipo	Default	Descrizione
`q`	int	—	Qualità di compressione per JPEG e WebP (range: 5–95). Ignorato per PNG.
`q_auto`	string	—	Qualità ottimizzata automaticamente. Valori: `highest`, `high`, `medium`, `low`. Da preferire a `q` per la delivery web.
`format`	string	avif	Formato di output. THRON seleziona automaticamente il formato migliore per il browser; usa questo parametro solo se hai esigenze specifiche e quindi vuoi scegliere tu un formato specifico. Usalo insieme al parametro`download=true`se vuoi scaricare l’immagine in un formato specifico.

Configurazione consigliata per delivery web
Usa q_auto=medium: riduce il peso dell'immagine mantenendo buona qualità visiva. Il formato è già gestito automaticamente da THRON (default: AVIF).

Regolazioni visive

Tutti i parametri hanno range −100 / +100, default 0 (nessun effetto). Eccezione: blur, range 0–100.

Parametro	Descrizione
`brightness`	Luminosità dell'immagine (-100,100)
`contrast`	Contrasto dell'immagine (-100,100)
`sharpness`	Nitidezza dell'immagine (-100,100)
`saturation`	Saturazione dei colori (-100,100)
`blur`	Sfocatura (0-100)

Esempio: brightness=-20&contrast=20&sharpness=30 — luminosità ridotta, contrasto e nitidezza aumentati.

Riempimento trasparenza

Parametro	Tipo	Descrizione
`fillColor`	string (HEX)	Colore in formato HEX (es. `#FFFFFF`). Rimpiazza la trasparenza o riempie le bande aggiunte da `crop=product` o `zoom=true`. Funziona solo su immagini che hanno già il canale di trasparenza (sfondo già rimosso): su immagini con sfondo opaco non produce effetti.

## Articoli di approfondimento
- Guida alla Creazione e Configurazione di una Custom Application
- La pKey: cos'è e come gestirla

Serve aiuto?

Per problemi tecnici, scrivi a support@thron.com

Channel Activation