Come generare un codice QR da testo o indirizzo web

Quando usare la generazione di codici QR

Questo strumento converte un testo non vuoto o un indirizzo web in un’immagine di codice QR. Può essere utile per preparare un contenuto da condividere tramite scansione, ad esempio un messaggio breve, un riferimento online o un’informazione destinata a un supporto stampato. Il risultato di una generazione riuscita è una stringa Base64 non vuota che rappresenta un’immagine PNG. L’assenza di contenuto segue invece un percorso diverso: non viene prodotta alcuna immagine. Prima di avviare l’operazione, quindi, stabilisci quale testo vuoi codificare e controlla che sia stato inserito nel punto previsto. Il campo principale è facoltativo, ma lasciarlo vuoto equivale a non fornire dati. Quando sono disponibili nomi alternativi per l’inserimento, il contenuto può essere passato anche tramite testo, URL o contenuto.

Procedura per creare il codice QR

1. Prepara il valore da codificare. Può essere una frase, un riferimento testuale o un indirizzo web non vuoto. Inseriscilo nel campo principale del contenuto; se l’interfaccia presenta campi alternativi, usa quello indicato come testo, URL o contenuto. Verifica che il valore scelto non sia formato soltanto dall’assenza di dati.

2. Imposta la dimensione soltanto se ti serve un valore diverso da quello iniziale. La dimensione predefinita è 256. Il valore fornito viene convertito in un numero intero; se la conversione non è possibile, viene usato 256. Dopo la conversione, il valore viene mantenuto nell’intervallo da 64 a 1024. Questa normalizzazione riguarda il calcolo dell’immagine, perciò le dimensioni finali in pixel del PNG possono non corrispondere alla cifra inserita.

3. Seleziona il livello di correzione degli errori, quando l’opzione è esposta. I valori testuali disponibili sono L, M, Q e H. Una stringa viene portata in maiuscolo prima della valutazione; un valore non riconosciuto viene sostituito con M. Se non modifichi l’impostazione, il livello iniziale è M.

4. Regola i colori se desideri un aspetto diverso da quello iniziale. Il primo piano predefinito è nero e lo sfondo predefinito è bianco. Mantieni un contrasto visivo adeguato alla situazione d’uso, senza interpretare questa scelta come una garanzia sulla lettura del codice.

5. Avvia la generazione dopo aver controllato il contenuto e le opzioni. In caso di successo, esamina il valore restituito e cerca una stringa Base64 non vuota associata a un’immagine PNG. Se il contenuto manca oppure si verifica un problema durante la generazione, il risultato può non contenere un’immagine.

Come valutare il risultato restituito

Il formato restituito descrive un’immagine, ma non implica necessariamente che l’immagine sia già mostrata come anteprima. Per un esito riuscito, la rappresentazione è una stringa Base64 non vuota che può essere decodificata come PNG valido. Un risultato privo di immagine richiede una prima verifica del testo inserito e del campo utilizzato, perché il contenuto principale può partire da un valore vuoto. Se il contenuto è presente, resta possibile che un errore di generazione o una dipendenza non disponibile impedisca la restituzione del PNG.

La cifra scelta per la dimensione non va letta come una promessa sul numero conclusivo di pixel: il valore viene normalizzato e poi impiegato per calcolare la scala dei moduli QR. Anche il livello L, M, Q o H e la combinazione cromatica descrivono parametri di generazione, non assicurano la decodifica in ogni situazione. Per valutare il risultato, considera quindi sia la presenza della stringa Base64 sia il fatto che il formato previsto sia PNG, senza estendere queste indicazioni a proprietà non verificate.

Esempio pratico

Devi preparare un codice QR per condividere la pagina di un programma durante un incontro.

Inserisci l’indirizzo web della pagina che vuoi condividere nel campo del contenuto, lascia le impostazioni iniziali e avvia la generazione. Controlla poi che il valore ottenuto sia una stringa Base64 non vuota associata a un PNG.

Una stringa Base64 non vuota che, dopo la decodifica, rappresenta un’immagine PNG del codice QR.

Limiti

• Un errore di generazione o una dipendenza non disponibile può impedire la restituzione dell’immagine; inoltre, i pixel finali possono differire dalla dimensione richiesta e non è garantita la decodifica per ogni contenuto.

Errori comuni

• Se il campo principale e gli eventuali alias non contengono alcun valore, la generazione termina senza immagine. Inserisci un testo o un indirizzo web non vuoto in uno dei campi riconosciuti e riprova.

Domande frequenti

Posso creare un codice QR da un indirizzo web?

Sì, un indirizzo web non vuoto è un contenuto accettato, che può essere fornito nel campo principale oppure nell’alias dedicato al testo, all’URL o al contenuto.

Qual è la dimensione predefinita dell’immagine?

Se non indichi una dimensione diversa, il valore iniziale è 256; la normalizzazione può comunque produrre pixel finali differenti dalla misura richiesta.

Cosa succede se lascio vuoto il contenuto?

Se il contenuto non viene fornito, il valore principale resta vuoto e l’operazione termina senza generare un’immagine. Inserisci prima un testo o un indirizzo web non vuoto.