ForHosting KIT · Immagini e foto

Aggiungere un bordo all’immagine

L’aggiunta di un bordo cambia le dimensioni della tela di un’immagine, mentre la figura originale al suo interno rimane intatta.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Questo calcolatore riceve larghezza e altezza originali in pixel, applica lo stesso spessore sopra, a destra, sotto e a sinistra e restituisce le dimensioni esterne esatte. Mantiene inoltre nel risultato il colore indicato, affinché il calcolo possa accompagnare una specifica grafica, un’attività di esportazione o un flusso automatizzato per le immagini.

Calcoli la tela prima dell’esportazione

Un bordo occupa spazio all’esterno di ogni lato dell’immagine originale. Di conseguenza, un bordo di 20 pixel non aggiunge soltanto 20 pixel alla larghezza o all’altezza: ne aggiunge 20 a sinistra e altri 20 a destra, oltre a 20 sopra e sotto. Inserisca larghezza e altezza originali in pixel, lo spessore di un lato e il colore desiderato. Il calcolatore restituisce le misure originali insieme alle nuove dimensioni esterne, rendendo semplice verificare la modifica. È utile prima di aprire un editor di immagini, preparare una regola di elaborazione in serie o riservare spazio in un layout. Il calcolo non ridimensiona, ritaglia, deforma né codifica alcuna immagine. Risponde esclusivamente alla domanda sulle dimensioni, quindi non vi è ambiguità su eventuali cambiamenti dell’area originale. È accettato anche uno spessore pari a zero: le dimensioni esterne restano uguali a quelle iniziali e il software può seguire un unico percorso di calcolo anche quando non serve un bordo visibile.

Comprenda la formula del bordo

La formula è volutamente semplice e prevedibile: la larghezza esterna equivale alla larghezza originale più due volte lo spessore del bordo, mentre l’altezza esterna equivale all’altezza originale più due volte lo stesso valore. La moltiplicazione per due considera i due lati opposti di ciascun asse. Per esempio, un’immagine larga 1200 pixel e alta 800 con un bordo di 24 pixel diventa 1248 per 848 pixel. Il colore non incide sulle dimensioni, ma viene restituito affinché il codice successivo conservi l’impostazione visiva insieme alle misure. Larghezza e altezza originali devono essere numeri interi positivi, poiché le dimensioni in pixel descrivono una vera tela raster. Lo spessore può essere zero oppure un numero finito positivo, così da supportare sia misure frazionarie di impaginazione sia comuni pixel interi. I valori negativi vengono respinti perché descrivono un ritaglio o una geometria interna, non l’aggiunta di un bordo esterno. Per rimuovere pixel dai lati utilizzi un calcolo di ritaglio separato.

Utilizzi il risultato nella grafica e nell’automazione

Le dimensioni esterne restituite possono essere impiegate direttamente per pianificare layout, creare tele, convalidare risorse o stimare lo spazio di archiviazione. Chi sviluppa può calcolare la tela necessaria prima di disegnare l’immagine originale con lo scostamento del bordo. Chi cura la grafica può controllare se una miniatura incorniciata rientra ancora in una scheda fissa o in uno spazio di marketplace. Un team di produzione può confrontare il risultato con la dimensione massima di caricamento prima di elaborare migliaia di file. Poiché l’operazione usa soltanto aritmetica deterministica, input identici producono sempre risultati identici, senza richieste di rete, caricamenti, valori casuali o trasformazioni nascoste. Il colore viene trattato come un’etichetta e non viene interpretato né convertito: un codice esadecimale, un nome CSS o un token interno resta quindi invariato dopo la rimozione degli spazi esterni. Il prezzo dell’API è $0.002 per richiesta. La risposta mostra misure originali ed esterne, rendendo i registri chiari ed evitando di confondere la sorgente con la tela finale.

Preparare una tela con bordo

Calcoli le dimensioni esatte della tela prima di collocare l’immagine originale inalterata dentro un nuovo bordo colorato.

Convalidare immagini per marketplace

Verifichi se l’immagine di un prodotto rispetterà ancora il limite di caricamento o layout dopo l’aggiunta di un bordo uniforme.

Pianificare lavorazioni in serie

Ottenga dimensioni di uscita prevedibili per flussi automatizzati prima di destinare risorse al rendering di ogni immagine.

Come vengono calcolate le nuove dimensioni?

A entrambe le dimensioni si aggiunge due volte lo spessore, poiché il bordo compare sui due lati di ciascun asse.

Questa funzione modifica o carica la mia immagine?

No. Riceve soltanto dimensioni e impostazioni del bordo, poi restituisce le misure calcolate senza leggere né modificare un file immagine.

Lo spessore del bordo può essere zero?

Sì. Uno spessore pari a zero è valido e restituisce dimensioni esterne uguali a quelle originali.

Che cosa accade con uno spessore negativo?

La richiesta non riesce e segnala un input non valido, perché un valore negativo descrive una rimozione di spazio anziché un bordo esterno.

Quali formati di colore posso indicare?

Può usare qualsiasi etichetta di colore non vuota, compresi un nome CSS, una notazione esadecimale o un token del Suo flusso. Il valore viene conservato senza interpretazione.

Quanto costa un calcolo tramite API?

Ogni richiesta API costa $0.002. Il calcolo è adatto anche all’esecutore nel browser, poiché non richiede accesso alla rete.

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/add-border

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/add-border \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"width":1200,"height":800,"border_width":24,"color":"#1d4ed8"}'
{
  "width": 1200,
  "height": 800,
  "border_width": 24,
  "color": "#1d4ed8"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.add_border",
  "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.

Leggi la documentazione completa del KIT →