Come generare un codice a barre in PNG

A cosa serve il generatore

Questo generatore crea dati immagine PNG codificati in base64 a partire da un contenuto fornito. Può essere utile per trasformare un identificativo, un numero o una breve stringa in un codice a barre da utilizzare in un flusso di lavoro compatibile con immagini PNG. Il formato predefinito è Code 128; puoi anche indicare un altro formato, tenendo presente che la disponibilità dipende dalla libreria che esegue la generazione.

Il campo dei dati è facoltativo e, se lasciato vuoto, assume un valore vuoto. In questo caso il risultato è segnalato come riuscito ma contiene un’indicazione di errore e non include un’immagine. Per ottenere un PNG, inserisci quindi un contenuto non vuoto prima di avviare la generazione.

Come generare il codice a barre

1. Inserisci nel campo dei dati il testo o il numero da rappresentare. Evita di lasciare il campo vuoto: senza dati non viene restituita un’immagine.
2. Seleziona il formato desiderato. Per una prima prova puoi mantenere Code 128, che è il formato predefinito. Se scrivi il nome del formato in modo diverso, il sistema normalizza minuscole, trattini, spazi e alcune forme con underscore; questa normalizzazione non rende però disponibili formati che la libreria non supporta.
3. Imposta, se necessario, larghezza e altezza. I valori predefiniti sono rispettivamente 400 e 100. Con dati non vuoti, la larghezza viene ricondotta a un intero compreso tra 100 e 2000, mentre l’altezza viene ricondotta a un intero compreso tra 40 e 600. Un valore non convertibile torna al rispettivo valore predefinito.
4. Scegli se includere il testo leggibile nel rendering. L’opzione di scrittura del testo è attiva per impostazione predefinita, ma può essere disabilitata.
5. Avvia la generazione e controlla il risultato. Quando l’operazione riesce, il risultato contiene dati immagine PNG codificati in base64. Se compare un’indicazione di errore, verifica prima i dati e il formato scelto invece di trattare il risultato come un’immagine valida.

Come leggere il risultato e i suoi limiti

Un risultato riuscito con dati immagine indica che la generazione del PNG è andata a buon fine. I dati sono restituiti in base64, quindi il risultato non è necessariamente un’anteprima già visibile: va trattato come dato immagine PNG dal sistema che lo riceve.

Per i formati numerici riconosciuti, dopo i controlli necessari vengono rimossi i caratteri non numerici e l’input viene limitato al numero di cifre richiesto; dove previsto, la libreria fornisce la cifra di controllo. Se restano meno cifre di quelle necessarie, il risultato segnala un errore e non contiene un’immagine. Anche un formato non supportato produce un’indicazione di errore invece del PNG.

Le dimensioni impostate sono parametri normalizzati, non una garanzia sulle dimensioni in pixel del PNG risultante. Inoltre, se la libreria per i codici a barre non è disponibile o la generazione solleva un’eccezione, l’operazione può restituire un risultato non riuscito con un’indicazione di errore.

Esempio pratico

Devi rappresentare l’identificativo non vuoto «ORD-IT-2048» come codice a barre per un flusso che accetta immagini PNG.

Inserisci «ORD-IT-2048», lascia Code 128 selezionato e mantieni le impostazioni predefinite, quindi avvia la generazione e verifica che non sia presente un’indicazione di errore.

Un risultato riuscito contenente dati immagine PNG codificati in base64; le dimensioni effettive in pixel non sono garantite dai valori impostati.

Limiti

• Le impostazioni di larghezza e altezza vengono normalizzate, ma non garantiscono le dimensioni esatte in pixel del PNG.

Errori comuni

• Se il campo dei dati è vuoto, il risultato può indicare un errore senza restituire un’immagine. Inserisci un contenuto non vuoto e avvia di nuovo la generazione.

Domande frequenti

Posso generare un PNG senza inserire dati?

Sì, se il contenuto non è vuoto e la generazione riesce: il risultato contiene dati immagine PNG codificati in base64. Un campo vuoto produce invece un’indicazione di errore senza immagine.

Qual è il formato predefinito?

Code 128 è il formato predefinito. Un altro formato funziona solo se è riconosciuto e fornito dalla libreria dei codici a barre; in caso contrario il risultato segnala un errore e non genera l’immagine.

Le dimensioni impostate corrispondono esattamente ai pixel del PNG?

Non necessariamente. Con dati non vuoti, larghezza e altezza vengono normalizzate nei rispettivi intervalli, ma le dimensioni richieste non garantiscono le dimensioni esatte in pixel del PNG.