ForHosting KIT · Immagini e foto

Adattare un’immagine con bande

Inserisca un'immagine in una tela fissa senza ritagliarla né stirarla: una foto di 1920 per 1080 in un quadrato di 1000 per 1000 diventa 1000 per 562, con bande di 219 pixel sopra e sotto. Gratis nel suo browser.

  • Gratis
  • Funziona nel suo browser
  • Senza registrazione
  • I suoi dati restano sul dispositivo
Usalo da WebAPIEmailTelegramApp presto
Se inserisce
Larghezza di origine
1920
Altezza di origine
1080
Larghezza della tela
1000
Altezza della tela
1000
Ottiene
Scala
0,5208333333
Fit
letterbox

Inserisca un’immagine in una tela fissa senza stime, deformazioni o tagli. Indichi larghezza e altezza della sorgente e le dimensioni della tela per ottenere la scala uniforme, la misura finale in pixel e le bande precise in alto, a destra, in basso e a sinistra. Il risultato distingue bande orizzontali, bande verticali e corrispondenza esatta delle proporzioni, risultando utile per video, presentazioni, pipeline grafiche e anteprime responsive.

Conservi l’immagine intera e le sue proporzioni

Un adattamento di tipo contenimento garantisce che ogni pixel sorgente resti visibile nella tela di destinazione. La calcolatrice confronta i rapporti d’aspetto, sceglie il fattore minore tra quello orizzontale e quello verticale e applica lo stesso fattore a entrambe le dimensioni. I cerchi restano circolari, i volti non vengono schiacciati e la composizione non subisce ritagli.

Larghezza e altezza restituite sono valori interi in pixel che non superano la tela. Quando la misura proporzionale esatta cade tra due pixel, l’asse vincolante riempie il bordo e l’altro viene arrotondato per difetto, perché l’arrotondamento superiore potrebbe portare una riga o colonna oltre la tela. La risposta include anche la scala matematica prima dell’arrotondamento, utile per configurare programmi grafici o confrontare tele alternative.

Tutte e quattro le dimensioni devono essere interi positivi: lo zero non definisce un rapporto valido e viene rifiutato come input non valido.

Legga le bande orizzontali e verticali

L’oggetto delle bande indica in pixel lo spazio superiore, destro, inferiore e sinistro. Un’immagine larga in una tela relativamente alta lascia spazio verticale e crea bande sopra e sotto. Un’immagine alta o stretta in una tela relativamente larga lascia spazio orizzontale, creando bande a sinistra e a destra.

Se sorgente e tela hanno lo stesso rapporto, l’adattamento è esatto e tutte le bande valgono zero. L’immagine è sempre centrata. Se lo spazio inutilizzato è pari, le bande opposte hanno uguale misura.

Se è dispari, la banda superiore o sinistra riceve la parte minore, mentre quella inferiore o destra riceve il pixel restante. Questa convenzione deterministica permette alle bande di ricomporre esattamente le dimensioni della tela ed evita posizioni ambigue di mezzo pixel. Lei può usare i valori direttamente come spaziatura, offset o coordinate di disegno: l’origine dell’immagine coincide con sinistra e alto del rettangolo adattato.

Applichi il risultato nei flussi multimediali

Usi questi dati prima del ridimensionamento, non dopo l’esportazione. Crei la tela di destinazione, ridimensioni la sorgente alla larghezza e altezza restituite con il metodo di ricampionamento preferito, quindi la collochi agli offset sinistro e superiore indicati. Riempia lo spazio restante con un colore uniforme, trasparenza, un’estensione sfocata o un altro sfondo.

Il calcolo non analizza byte, non sceglie colori e non esegue ricampionamenti: è un passaggio geometrico indipendente dal formato e dalla libreria. Nei processi in serie, convalidi subito le dimensioni e salvi il risultato con la richiesta affinché ogni fase usi la stessa geometria. Ripetendo l’input si ottengono sempre misure e posizioni identiche.

Preparare fotogrammi video

Adatti filmati o immagini a una risoluzione fissa e ottenga le bande esatte prima della codifica.

Creare anteprime senza ritaglio

Centri prodotti, portfolio o documenti in riquadri uniformi senza eliminare alcun contenuto.

Progettare presentazioni

Calcoli il rettangolo e la spaziatura bilanciata per diapositive, segnaletica digitale e schermi.

Quanto costa il calcolo?

Il calcolo è disponibile gratuitamente anche nel browser.

L’immagine viene ritagliata o deformata?

No. Una scala uniforme conserva l’intera immagine e le bande occupano lo spazio inutilizzato.

Perché le bande opposte possono differire di un pixel?

Uno spazio dispari non è divisibile equamente in pixel interi. Il pixel aggiuntivo va a destra o in basso.

Cosa accade se le proporzioni coincidono già?

L’adattamento risulta esatto, l’immagine riempie la tela e tutte le bande valgono zero.

Posso usare zero per una dimensione ignota?

No. Ogni dimensione deve essere un intero positivo, perché zero non definisce un rapporto valido.

La capacità ridimensiona un file immagine?

No. Calcola soltanto la geometria. Usi dimensioni e offset con il renderizzatore che preferisce.

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

POSThttps://api.kit.forhosting.com/image/letterbox-fit

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/image/letterbox-fit \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source_width":1920,"source_height":1080,"canvas_width":1000,"canvas_height":1000}'
{
  "source_width": 1920,
  "source_height": 1080,
  "canvas_width": 1000,
  "canvas_height": 1000
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.letterbox_fit",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

max_mb15
max_megapixels12
HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Applichi il risultato nei flussi multimediali

Può quindi essere usato con CSS, Canvas, SVG, FFmpeg, ImageMagick, API mobili, presentazioni o miniature. La richiesta API costa $0.002, mentre lo stesso calcolo deterministico può essere eseguito nel browser.

Leggi la documentazione completa del KIT →