Codici QR distorti: cosa corregge uno scanner, cosa non può correggere, e come sistemare il tuo

Che cos'è un codice QR distorto, e i cinque modi in cui uno si distorce

Un codice QR distorto è un codice QR la cui griglia di moduli non è più quadrata e a passo uniforme, per come è stato ridimensionato, posizionato, stampato o fotografato. Nella pratica lo fanno cinque cose, e dare un nome a quella che hai decide la correzione, perché tre delle cinque vengono corrette dallo scanner e due no.

Un modulo è una delle celle quadrate di un codice QR, e l'unità più piccola che un lettore deve risolvere. Ogni distorsione è un cambiamento della griglia su cui stanno quei moduli, e la domanda utile su ciascuna è se la griglia sia ancora una mappa piana a linee rette dell'originale:

• Stiramento. Il codice è più largo che alto, o il contrario, perché in Canva, Word, PowerPoint o in uno strumento per slide è stata trascinata una maniglia laterale. Ogni modulo diventa un rettangolo, ma ogni riga e ogni colonna resta dritta e parallela.
• Inclinazione, o skew. Il codice pende, come un carattere corsivo: un bordo è scivolato di lato rispetto a quello opposto. Lo fanno un'etichetta applicata storta su una scatola piana, o una grafica passata per una trasformazione di inclinazione. Le linee restano dritte; i quadrati diventano parallelogrammi.
• Prospettiva, o effetto trapezio. La fotocamera non è frontale, quindi il bordo lontano del codice sembra più corto di quello vicino e il passo dei moduli si restringe verso di esso. Un manifesto letto dal basso, un cavaliere da tavolo letto in piedi, un codice montato sopra il livello degli occhi.
• Curvatura. Il codice è avvolto attorno a una bottiglia, una lattina, una tazza o un tubo, oppure sta su una piega, una grinza o un rigonfiamento. La superficie non è più un piano, quindi nessuna singola mappa a linee rette descrive l'intera griglia.
• Sfocatura da ricampionamento e pixelizzazione. Un PNG piccolo ingrandito, uno screenshot, un JPEG, o un codice stampato a una dimensione in cui ogni modulo cade su una frazione di punto di stampa. La griglia è geometricamente intatta ma i bordi dei moduli sono morbidi o a gradini, e la gente lo descrive come distorto perché il codice non sembra più nitido.

Le prime tre sono piane: l'intero codice sta ancora su un unico piano e ogni linea retta dell'originale è ancora una linea retta nell'immagine. È la proprietà che un decodificatore sfrutta, ed è il motivo per cui la sezione successiva dice quello che dice.

Cosa corregge da solo un decodificatore, e cosa non può correggere

Un decodificatore corregge qualsiasi distorsione piana - stiramento, inclinazione, rotazione e prospettiva - adattando una mappa proiettiva attraverso i tre pattern di rilevamento e i pattern di allineamento, e non può correggere una superficie che non è un piano né una sfocatura che fonde i moduli. Quei due limiti sono dove i codici reali falliscono, ed entrambi sono difetti di posizionamento e non di grafica.

I tre quadrati agli angoli sono ciò che rende gratuiti i casi piani. Tre punti su un piano bastano a ricostruire qualsiasi mappa affine - scala su ciascun asse, inclinazione e rotazione insieme - ed è per questo che un codice stirato o inclinato si decodifica senza che il decodificatore sappia nemmeno che era distorto. Con un quarto punto di riferimento, un decodificatore può adattare una mappa prospettica completa, e quel quarto punto è quello che forniscono i pattern di allineamento. I pattern di rilevamento di un codice QR spiega i quadrati agli angoli e il rapporto 1:1:3:1:1 che permette a uno scanner di trovarli a qualsiasi dimensione e angolo.

Un pattern di allineamento è un quadrato di cinque moduli che permette al decodificatore di correggere la distorsione prospettica quando un codice QR viene fotografato di sbieco o stampato su una superficie curva. ISO/IEC 18004 ne colloca almeno uno in ogni simbolo dalla versione 2 in su - il codice da 25 moduli e più grandi - e sei o più dalla versione 7, così un decodificatore ha punti di riferimento interni tra cui riadattare la griglia invece di fidarsi di un'unica stima da angolo ad angolo. La distorsione prospettica è il cambiamento della forma apparente di un codice QR quando la fotocamera lo guarda di sbieco, per cui il bordo lontano sembra più corto di quello vicino, e i pattern di allineamento esistono perché quella è la distorsione che ogni scansione a mano libera ha, almeno un po'.

Quello che nessun punto di riferimento può correggere è una griglia che ha smesso di essere un'unica mappa. Avvolgi un codice attorno a un cilindro e il passo dei moduli si restringe con continuità verso i bordi man mano che la superficie si allontana dalla fotocamera; il decodificatore può riadattare localmente tra i pattern di allineamento, ma un codice dalla versione 2 alla 6 ne ha uno solo, vicino all'angolo in basso a destra, e le colonne esterne restano senza aiuto. Una piega attraverso un codice è peggio: due piani che si incontrano lungo una linea, con un'ombra lungo di essa. La sfocatura è ancora un altro fallimento - la geometria è perfetta e i moduli scuri e chiari si sono semplicemente fusi in un unico grigio. La correzione degli errori ripara i moduli letti male; non fa nulla per i moduli che il decodificatore non ha mai separato, come spiega i livelli di correzione degli errori.

Quanta distorsione regge un codice QR: cosa abbiamo misurato

Nella nostra misurazione, ogni distorsione piana a linee rette che abbiamo provato si è decodificata perfettamente - uno stiramento 3:1, un'inclinazione di 25° e una rotazione di 45°, ciascuna in 16 posizioni su 16 - mentre un effetto trapezio da fotocamera è crollato tra il 70% e il 60% e un avvolgimento su cilindro ha fallito quando il codice copriva il 25% della circonferenza. I numeri vengono dal banco di misura del sito, scripts/distortion-decode-rig.mjs, eseguito il 22 settembre 2026 con jsQR come decodificatore, e la tabella completa è in reports/distortion-decode/results-2026-09-22.txt.

Il metodo, in breve: un codice da 41 moduli a livello H con una zona di silenzio di quattro moduli, deformato per mappatura inversa così che nulla venga ricampionato due volte, sfocato come lo sarebbe un fotogramma nitido di telefono, campionato a 6 e a 4 pixel catturati per modulo, e passato al decodificatore in 16 posizioni sub-pixel per condizione. Una cella con 16 significa che ogni posizione ha letto il contenuto esatto; una cella con 0 significa che nessuna l'ha letto.

Da quella tabella seguono due cose, e sono il contenuto pratico della pagina. Primo, le due righe che degradano sono le due che la grafica non può causare: un effetto trapezio è la posizione della fotocamera e un avvolgimento è la forma dell'oggetto, quindi entrambi si correggono con il posizionamento e non riesportando. Secondo, il decodificatore con cui abbiamo misurato è l'estremo severo della gamma. I decodificatori delle fotocamere di Apple e Google sono chiusi, non pubblicano cifre di tolleranza e sono in genere più indulgenti di jsQR, quindi tratta ogni soglia qui come il punto in cui la curva gira, non come il punto in cui un telefono si arrende.

Codici QR stirati: perché una maniglia trascinata rompe raramente un codice, e perché correggerlo comunque

Un codice QR stirato a tre volte la sua larghezza si è decodificato ancora in ogni posizione del nostro test, quindi un codice stirato che non si legge ha quasi sempre un secondo difetto - troppo pochi pixel per modulo, un bordo JPEG morbido, o una zona di silenzio persa - che viaggia sopra lo stiramento. Correggi comunque lo stiramento per primo, perché è il difetto che vedi e sta consumando margine che serve agli altri.

Il meccanismo è semplice: uno stiramento è una scala uniforme su un asse, e i tre pattern di rilevamento si stirano con esso, quindi la griglia adattata dal decodificatore è rettangolare fin dall'inizio. Quello che lo stiramento costa è risoluzione. Schiaccia un codice a metà della sua altezza e ogni modulo è alto la metà, che è lo stesso che stampare l'intero codice a metà dimensione lungo quell'asse. Un codice dimensionato per moduli da 0,5 mm ora è a 0,25 mm in una direzione, sotto la soglia di stampa fissata da dimensione minima per la stampa, e nessuna tolleranza del decodificatore restituisce i millimetri mancanti.

I casi che arrivano in stampa, e cosa ha causato ciascuno:

• Una maniglia laterale in Canva, Word, PowerPoint o Keynote. Le maniglie d'angolo di norma mantengono le proporzioni; quelle laterali di norma stirano una grafica, o ritagliano una foto. Un codice inserito come grafica e tirato da un bordo laterale è il modo abituale in cui un codice stirato arriva in stampa.
• Larghezza e altezza digitate separatamente. Qualsiasi finestra con due caselle e un collegamento sbloccato tra loro. La pagina di aiuto di Microsoft per Office chiama l'impostazione Lock aspect ratio; il pannello Trasforma di Illustrator ha un lucchetto di norma etichettato Constrain Width and Height Proportions.
• Uno spazio di modello con forma fissa. Un riquadro largo da banner riempito con un codice quadrato, o un segnaposto immagine che scala per riempire lo spazio. Il codice è stirato dall'impaginato invece che da una mano.
• Un driver di stampa impostato per adattare alla pagina. Adatta alla pagina scala i due assi insieme sulla maggior parte dei driver, ma un'opzione di riempimento o di stiramento su certe stampanti per etichette no.

Non riparare un raster stirato trascinandolo indietro. Un codice schiacciato e poi ri-stirato è stato ricampionato due volte, e ogni passaggio ammorbidisce i bordi dei moduli. Rigeneralo, esportalo come SVG o come PNG alla dimensione finale in pixel, e posizionalo con le proporzioni bloccate - la guida SVG vs PNG spiega quale file vuole ciascuno strumento. KoloQR, un generatore di codici QR gratuito con codici QR circolari e di forme personalizzate, esporta SVG, PNG, PDF ed EPS con la zona di silenzio inclusa, così un export nuovo si inserisce a qualsiasi dimensione senza un secondo ricampionamento.

Codici QR inclinati e ruotati

La rotazione non influisce affatto su un codice QR - 15°, 30° e 45° si sono decodificati tutti in 16 posizioni su 16 - e un'inclinazione si è decodificata per intero fino a 25° prima di cadere a zero a 30°. Un codice incollato di traverso è quindi sicuro; un codice che pende come un corsivo è sicuro fino a una pendenza che la maggior parte delle persone chiamerebbe già sbagliata.

La differenza tra i due risultati è istruttiva, e questa è la nostra lettura più che una misurazione: la rotazione lascia ogni pattern di rilevamento un quadrato, quindi una linea passante per il suo centro attraversa ancora i tratti 1:1:3:1:1 che il localizzatore cerca su entrambi gli assi. Un'inclinazione trasforma il pattern in un parallelogramma, e a 30° il controllo incrociato verticale attraverso un quadrato che pende non rispetta più il rapporto, quindi il decodificatore non conclude mai che nell'inquadratura c'è un codice. È un fallimento di rilevamento, e si comporta come tale - silenzio totale, non una lettura al limite - che è il primo sintomo in perché un codice QR non si legge.

Nella pratica l'inclinazione raggiunge un codice da due direzioni. L'inclinazione nella grafica è una scelta di design - un codice inserito in un mockup prospettico, o trascinato con una maniglia di inclinazione o distorsione in Illustrator o Photoshop - e la correzione è annullarla e ruotare invece, che non costa nulla. L'inclinazione applicata è un'etichetta messa storta su una scatola, ed è inclinazione solo se la faccia della scatola è piana; un'etichetta storta su un cilindro è un problema di curvatura, trattato più sotto.

Se un progetto ha bisogno che un codice stia in una composizione che pende, ruotalo. Un codice QR non ha un alto: i tre pattern di rilevamento in tre angoli e il quarto angolo vuoto dicono al decodificatore da che parte sta il verso a qualsiasi angolo, quindi un codice a 45° si legge come uno dritto. È l'unico effetto gratuito di questa lista.

Codici QR fotografati di sbieco: prospettiva ed effetto trapezio

Un codice guardato di sbieco si decodifica senza problemi finché il bordo lontano è almeno l'80% della lunghezza di quello vicino, degrada tra il 70% e il 60%, e fallisce al 50%, nella nostra misurazione con un decodificatore aperto. Ogni scansione a mano libera ha un po' di prospettiva; il fallimento è un codice montato dove ogni lettore deve guardarlo molto di sbieco.

La distorsione prospettica è il cambiamento della forma apparente di un codice QR quando la fotocamera lo guarda di sbieco, per cui il bordo lontano sembra più corto di quello vicino. Il numero dell'effetto trapezio è una forma e non un angolo, di proposito. Lo stesso trapezio al 70% nasce da una leggera inclinazione da vicino o da una forte inclinazione da lontano, perché la distanza e la lunghezza focale della fotocamera cambiano quanto la prospettiva comprime il bordo lontano. Quello che il lettore controlla è la forma che vede sullo schermo: se il codice sul display del telefono sembra un trapezio il cui lato corto è sotto circa i tre quarti di quello lungo, ha superato il punto in cui il decodificatore aperto che abbiamo provato ha retto.

Dove succede nelle installazioni reali:

• Un codice sopra il livello degli occhi. Un manifesto a 2 m letto da una persona alta 1,7 m, un codice sull'insegna di un negozio, un menu a parete sopra un bancone. Tutti lo leggono dal basso, e più il lettore è basso, più il trapezio è accentuato.
• Un codice appoggiato su un tavolo o un bancone. Cavalieri da tavolo e adesivi su un bancone vengono letti in piedi, con un forte angolo verso il basso. Inclinare il cavaliere o sollevare il codice su un supporto ne elimina la maggior parte.
• Un codice in vetrina o dietro un vetro. I lettori si mettono di lato per evitare il proprio riflesso, e si portano dietro l'effetto trapezio.
• Un codice sul pavimento. Gli adesivi di segnaletica a pavimento vengono letti da sopra in verticale solo da chi ci sta sopra.

Due correzioni, entrambe di posizionamento. Monta il codice all'altezza del telefono di chi legge, più o meno tra il petto e gli occhi di un adulto in piedi, e inclina un pezzo piano verso il lettore dove il pezzo lo consente. Poi compra margine con la dimensione: il centimetro di larghezza ogni 10 cm di distanza di lettura del pilastro è scritto per una lettura frontale, e una lettura di sbieco ne vuole di più. Un codice che va letto molto di sbieco da un punto fisso andrebbe controllato da quel punto con due telefoni prima di stampare la tiratura, cosa che la checklist di stampa inserisce nel suo passaggio di prova.

Codici QR su superfici curve: bottiglie, tazze e lattine

Tieni la larghezza di un codice QR a circa il 15% della circonferenza del cilindro che avvolge, o meno. È lì che la nostra misurazione ha retto a 16 su 16; al 20% è scesa a 10 e 13, al 25% a 0 e 2, e dal 30% non si è letto nulla. I telefoni tollerano più del decodificatore aperto con cui abbiamo misurato, ma un codice progettato al limite della gamma di un decodificatore più severo è un codice con margine su un telefono.

L'aritmetica, fatta una volta. La circonferenza è π per il diametro. Una bottiglia di 7 cm di diametro misura π × 7 ≈ 22 cm di circonferenza, e il 15% di 22 cm è circa 3,3 cm - quindi un codice su quella bottiglia dovrebbe essere largo al massimo circa 3,3 cm. Una lattina da 6,6 cm (circa 21 cm di circonferenza) dà circa 3,1 cm; una tazza da 9 cm (circa 28 cm) circa 4,2 cm; una fiala da 3 cm (circa 9,4 cm) circa 1,4 cm, che è sotto la soglia di 2 cm di cui ha bisogno un codice stampato e significa che il codice non ha proprio posto sulla curva della fiala.

Due cose rendono la regola più stringente di quanto sembri:

• È la larghezza che si avvolge; l'altezza è libera. Un cilindro è piano lungo il suo asse, quindi solo la larghezza del codice spende il 15%. Il codice non può essere reso più alto per compensare - è quadrato - ma l'etichetta attorno può portare il testo nella direzione che non costa nulla.
• Un codice piccolo vuole un contenuto corto. 3,3 cm che contengono un codice da 41 moduli danno moduli da 0,8 mm, comodi su qualsiasi supporto. Gli stessi 3,3 cm che contengono un codice da 77 moduli generato da un lungo URL di tracciamento danno 0,43 mm, sotto la soglia di 0,5 mm per la carta naturale. La capacità di un codice QR ha il numero di moduli per versione; accorcia l'URL prima di rimpicciolire il codice.

Dove la regola non si può rispettare, sposta il codice fuori dalla curva. Un tappo o un coperchio, un cartellino, la base piana di una scatola, un'etichetta al collo che si stacca dalla bottiglia, o la faccia più piana di un contenitore conico si leggono tutti come codici piani. Il packaging flessibile è il caso difficile: una busta o una caramella incartata non ha una curva fissa e si piegherà attraverso il codice, e una piega è due piani e un'ombra, cosa che nulla corregge. Metti il codice dove la confezione è tenuta tesa, o sul cartone esterno.

Codici QR sfocati o pixelati: la distorsione che non è geometria

Un codice QR che sembra distorto ma ha bordi dritti e angoli squadrati non è distorto; è sotto-risolto, e la correzione è un file migliore anziché una posizione migliore. Sfocatura e pixelizzazione sono quello che succede quando un codice viene esportato troppo piccolo, salvato come JPEG, ingrandito da un raster, catturato con uno screenshot, o stampato a una dimensione in cui un modulo è una frazione di punto di stampa.

L'indizio sono i bordi dei moduli. Il ricampionamento dà loro una frangia grigia morbida; la compressione con perdita dà loro aloni e blocchi; l'ingrandimento di un PNG piccolo dà loro un bordo a gradini, nitido ma sbagliato. In tutti e tre i casi la griglia è dove dovrebbe essere, quindi la tolleranza alle distorsioni piane vista sopra non compra nulla, e il fallimento si manifesta come un codice che si legge a schermo e non su carta, o che si legge solo da vicino.

La regola è un numero intero di pixel per modulo alla dimensione finale, oppure un file vettoriale che non ha pixel da sbagliare. Risoluzione e DPI di un codice QR ha l'aritmetica nei due sensi e il calcolatore di DPI la esegue; SVG vs PNG stabilisce quale formato accetta ciascuna destinazione. Uno screenshot di un codice QR non è mai il file giusto per niente di stampato.

Come diagnosticare e correggere un codice QR distorto

Stabilisci quale delle cinque distorsioni hai prima di cambiare qualsiasi cosa, perché tre si correggono nel file e due si correggono sul muro. La procedura richiede una decina di minuti e comincia, come dovrebbe ogni diagnosi di scansione, separando la grafica dal posizionamento.

1. Decodifica il file che hai posizionato. Trascina l'export nello strumento scanner di codici QR. Se il file si legge e il codice posizionato no, il difetto è entrato nell'impaginato, nell'export o sull'oggetto.
2. Controlla che il codice sia quadrato nell'impaginato. Seleziona il codice posizionato e leggi larghezza e altezza. Qualsiasi differenza è uno stiramento; un valore che non è un multiplo del numero di moduli a un pixel intero è un ricampionamento.
3. Guarda i pattern di rilevamento. I tre quadrati agli angoli devono essere quadrati. Rettangoli significano stiramento, parallelogrammi significano inclinazione, e un bordo morbido o a gradini significa che il file è stato ricampionato.
4. Mettiti dove sta chi legge. Guarda il codice sullo schermo del telefono dalla posizione reale. Un trapezio il cui bordo corto è sotto circa i tre quarti di quello lungo è un difetto di posizionamento, non di grafica.
5. Misura il codice rispetto alla curva. Su un cilindro, dividi la larghezza del codice per la circonferenza. Oltre circa il 15%, rimpicciolisci il codice, accorcia il contenuto, o sposta il codice su una parte piana.
6. Rigenera invece di riparare. Per uno stiramento, un'inclinazione o un ricampionamento, esporta un codice nuovo come SVG o come PNG alla dimensione finale in pixel e posizionalo con le proporzioni bloccate. Non trascinare un raster per rimetterlo in forma.
7. Valida la grafica, poi tira una prova. Passa l'export nel validatore di codici QR per margine, contrasto e dimensione del modulo, poi stampa un pezzo sull'oggetto reale e scansionalo dalla posizione reale con due telefoni.

I due strumenti fanno lavori diversi. Lo scanner di codici QR legge un file che hai già - un PNG stirato, una foto della bottiglia - e ti dice se un decodificatore riesce a tirarne fuori il contenuto. Il validatore di codici QR controlla la grafica che stai per posizionare, e riporta il margine, il contrasto e la dimensione del modulo a una larghezza stampata dichiarata, che è il numero che un posizionamento curvo o di sbieco consuma per primo.

La correzione per strumento e situazione

Quasi ogni distorsione ha una correzione di una riga una volta che ha un nome, e la tabella abbina ogni punto in cui un codice si distorce all'azione che la annulla. Le voci di menu cambiano tra le versioni, quindi i nomi sono quello da cercare e non la dicitura esatta; per la riga di Figma, come copiare un codice QR in Figma ha il percorso di incolla che mantiene il codice come vettori.

Un'ultima cosa che vale la pena escludere prima di tutto questo: un codice che si legge perfettamente sul telefono e poi non fa niente di utile non è mai stato distorto. Il simbolo ha fatto il suo lavoro e la destinazione dietro di esso no, cosa che il pilastro sulla diagnosi tratta tra i difetti di destinazione. Lo stile non migliora mai le prestazioni di scansione, e un codice stilizzato su una curva o di sbieco ha meno tolleranza da spendere di uno semplice, perché i moduli decorativi mettono meno inchiostro in ogni cella - le forme QR personalizzate si scansionano? ha le misurazioni.