Come aggiungere un bordo a un’immagine con Image Border

Preparare l’immagine e le impostazioni

Image Border serve ad aggiungere una cornice colorata ai dati di un’immagine quando vuoi evidenziare il contenuto o separarlo visivamente dallo sfondo. L’immagine non viene inserita come file descritto in modo generico: l’input richiesto per l’elaborazione è una stringa base64 che rappresenta i dati dell’immagine. Puoi inoltre scegliere il colore e la larghezza della cornice, così da adattare il risultato al contesto in cui lo userai.

Prima di iniziare, prepara una stringa base64 collegata a un’immagine che possa essere decodificata. Il campo è facoltativo nella descrizione del servizio, ma un valore vuoto fa fallire l’elaborazione; per questo conviene trattare l’immagine come un dato necessario. Tieni a disposizione anche il colore desiderato e la larghezza da applicare. Se non fornisci una larghezza, il valore predefinito è 10, mentre il colore predefinito è #000000.

Il servizio dichiara di non usare l’accesso alla rete durante l’elaborazione. Questa informazione descrive l’accesso di rete dichiarato e non stabilisce come vengano gestiti, conservati o cancellati i dati dell’immagine.

Inviare i dati e applicare la cornice

1. Recupera i dati dell’immagine nella forma di una stringa base64. Verifica prima dell’invio che la stringa non sia vuota e che provenga da un’immagine leggibile, perché la semplice presenza del campo non rende valido il contenuto.
2. Inserisci la stringa nel campo dedicato all’immagine. Non sostituirla con il percorso di un file o con una descrizione testuale: il servizio accetta dati immagine codificati in base64.
3. Scegli la larghezza della cornice. Puoi lasciare il valore non specificato per usare 10 oppure indicare un altro valore, che verrà passato all’operazione di aggiunta del bordo così come fornito.
4. Imposta il colore nel formato esadecimale desiderato. Un valore come #3366CC contiene il carattere iniziale # e sei caratteri esadecimali; durante l’interpretazione, i caratteri # iniziali vengono rimossi e le sei cifre vengono lette come componenti rosso, verde e blu.
5. Avvia l’elaborazione dopo aver controllato input, colore e larghezza. Quando l’operazione riesce, il risultato comprende il testo base64 dell’immagine con la cornice e le dimensioni iniziali e finali.
6. Conserva il testo base64 restituito come dati dell’immagine elaborata e usa le dimensioni fornite per controllare l’effetto del bordo. Se il formato originale è disponibile, il risultato viene salvato in quel formato; quando tale informazione manca, viene usato PNG.

Controllare l’esito e i suoi confini

Il testo restituito in base64 rappresenta l’immagine elaborata in forma codificata, quindi per usarlo come immagine devi conservarlo o decodificarlo secondo il flusso del tuo progetto. Le due coppie di dimensioni permettono di mettere a confronto lo stato prima dell’operazione con quello dopo l’aggiunta della cornice, senza basarsi soltanto sul testo base64.

Se le dimensioni risultanti non corrispondono al risultato atteso, esamina il valore della larghezza inviato e confrontalo con quello iniziale. Se invece non ottieni un risultato riuscito, controlla dapprima che l’input non sia vuoto e che i dati base64 descrivano un’immagine decodificabile. Una causa distinta può essere un colore che non fornisce sei caratteri esadecimali validi dopo la rimozione dei caratteri #; anche dati non validi o altre eccezioni di elaborazione possono impedire il completamento.

La disponibilità del formato originale influenza il formato del file prodotto: la conservazione vale quando quel formato è disponibile, mentre PNG costituisce l’alternativa indicata quando l’informazione non è presente. Un input compilato, un colore scelto e una larghezza numerica non bastano quindi a garantire un’elaborazione riuscita per ogni dato immagine.

Esempio pratico

Devi preparare una scheda prodotto con una cornice blu di larghezza 12 attorno a un’immagine quadrata.

Per una scheda prodotto, inserisci i dati base64 di un’immagine quadrata, imposta il colore #3366CC e scegli una larghezza di 12. Dopo l’elaborazione, controlla che siano presenti il testo base64 restituito e le due coppie di dimensioni.

L’esito riuscito contiene il testo base64 dell’immagine bordata, le dimensioni originali e quelle risultanti; il formato resta quello originale quando disponibile, altrimenti è PNG.

Limiti

• L’esito non è garantito quando mancano i dati immagine, il base64 non è decodificabile, il colore non è valido oppure si verifica un’altra eccezione durante l’elaborazione.

Errori comuni

• Se l’elaborazione fallisce perché l’immagine è vuota, non decodificabile o il colore è incompleto, sostituisci l’input con una stringa base64 che rappresenti un’immagine leggibile e correggi il colore in una forma come #000000, con sei caratteri esadecimali dopo il simbolo iniziale.

Domande frequenti

Qual è la larghezza predefinita del bordo?

Se non indichi una larghezza, viene applicato il valore predefinito 10; in alternativa puoi fornire un altro valore da passare all’operazione di aggiunta della cornice.

Quale colore viene usato se non ne indico uno?

Se non scegli un colore, viene usato #000000. Per un colore diverso, indica sei caratteri esadecimali che rappresentano le componenti rosso, verde e blu, con o senza i caratteri # iniziali.

Che cosa restituisce l’elaborazione?

Quando l’elaborazione riesce, ricevi il testo base64 dell’immagine con il bordo e le dimensioni originali e risultanti. Il formato originale viene mantenuto se disponibile, mentre PNG viene usato quando quell’informazione non è disponibile.