QR codes distorcidos: o que um leitor corrige, o que ele não consegue e como consertar o seu

O que é um QR code distorcido, e os cinco jeitos de um ficar assim

Um QR code distorcido é um QR code cuja grade de módulos não é mais quadrada nem tem espaçamento uniforme, por causa de como ele foi redimensionado, colocado, impresso ou fotografado. Cinco coisas fazem isso na prática, e nomear qual delas você tem decide a correção, porque três das cinco são corrigidas pelo leitor e duas não.

Um módulo é uma das células quadradas de um QR code, e a menor unidade que um leitor precisa resolver. Toda distorção é uma mudança na grade em que esses módulos ficam, e a pergunta útil sobre cada uma é se a grade ainda é um mapa plano, de linhas retas, do original:

• Esticamento. O código fica mais largo que alto, ou o contrário, porque alguém arrastou uma alça lateral no Canva, no Word, no PowerPoint ou num editor de slides. Cada módulo vira um retângulo, mas cada linha e cada coluna continuam retas e paralelas.
• Inclinação, ou skew. O código pende, como um tipo em itálico: uma borda escorregou para o lado em relação à borda oposta. Um rótulo aplicado torto numa caixa plana, ou uma arte passada por uma transformação de inclinação, faz isso. As linhas continuam retas; os quadrados viram paralelogramos.
• Perspectiva, ou efeito trapézio. A câmera não está de frente, então a borda distante do código parece mais curta que a próxima e o passo dos módulos encolhe naquela direção. Um cartaz lido de baixo, um display de mesa lido de pé, um código montado acima da linha dos olhos.
• Curvatura. O código está enrolado em uma garrafa, lata, caneca ou cano, ou passa por uma dobra, um vinco ou uma saliência. A superfície não é mais um plano, então nenhum mapa de linhas retas descreve a grade inteira.
• Desfoque de reamostragem e pixelização. Um PNG pequeno ampliado, uma captura de tela, um JPEG, ou um código impresso num tamanho em que cada módulo cai sobre uma fração de ponto da impressora. A grade está geometricamente intacta, mas as bordas dos módulos ficam moles ou em degraus, e as pessoas descrevem isso como distorção porque o código não parece mais nítido.

Os três primeiros são planos: o código inteiro ainda está num só plano e toda linha reta do original continua reta na imagem. É essa a propriedade que um decodificador explora, e é por isso que a seção seguinte diz o que diz.

O que um decodificador corrige sozinho, e o que ele não consegue

Um decodificador corrige qualquer distorção plana - esticamento, inclinação, rotação e perspectiva - ajustando um mapa projetivo pelos três padrões de localização e pelos padrões de alinhamento, e não consegue corrigir uma superfície que não é um plano nem um desfoque que funde módulos. Esses dois limites são onde os códigos reais falham, e os dois são defeitos de colocação, não de arte.

Os três quadrados dos cantos são o que torna os casos planos gratuitos. Três pontos num plano bastam para recuperar qualquer mapa afim - escala em cada eixo, inclinação e rotação juntas - e é por isso que um código esticado ou torto lê sem que o decodificador sequer saiba que ele estava distorcido. Com um quarto ponto de referência, um decodificador consegue ajustar um mapa de perspectiva completo, e esse quarto ponto é o que os padrões de alinhamento fornecem. Os padrões de localização de um QR code explica os quadrados dos cantos e a proporção 1:1:3:1:1 que deixa um leitor achá-los em qualquer tamanho e ângulo.

Um padrão de alinhamento é um quadrado de cinco módulos que permite ao decodificador corrigir a distorção de perspectiva quando um QR code é fotografado de lado ou impresso numa superfície curva. A ISO/IEC 18004 coloca pelo menos um em todo símbolo da versão 2 para cima - o código de 25 módulos e maiores - e seis ou mais a partir da versão 7, para que o decodificador tenha pontos de referência internos entre os quais reajustar a grade em vez de confiar numa única estimativa de canto a canto. A distorção de perspectiva é a mudança na forma aparente de um QR code quando a câmera o vê de lado, de modo que a borda distante parece mais curta que a próxima, e os padrões de alinhamento existem porque essa é a distorção que toda leitura na mão tem um pouco.

O que nenhum ponto de referência conserta é uma grade que deixou de ser um mapa único. Enrole um código num cilindro e o passo dos módulos encolhe continuamente na direção das bordas conforme a superfície se afasta da câmera; o decodificador consegue reajustar localmente entre os padrões de alinhamento, mas um código da versão 2 à 6 tem só um, perto do canto inferior direito, e as colunas externas ficam por conta própria. Um vinco atravessando um código é pior: dois planos se encontrando numa linha, com uma sombra ao longo dela. O desfoque é ainda outro tipo de falha - a geometria está perfeita e os módulos escuros e claros simplesmente se misturaram num cinza só. A correção de erros repara módulos lidos errado; ela não faz nada por módulos que o decodificador nunca separou, como os níveis de correção de erros explica.

Quanta distorção um QR code aguenta: o que medimos

Na nossa medição, toda distorção plana de linhas retas que tentamos leu perfeitamente - um esticamento 3:1, uma inclinação de 25° e uma rotação de 45°, cada uma em 16 de 16 posições - enquanto um efeito trapézio de câmera desabou entre 70% e 60% e uma volta em cilindro falhou assim que o código ocupou 25% da circunferência. Os números vêm da bancada de medição do próprio site, scripts/distortion-decode-rig.mjs, rodada em 22 de setembro de 2026 com o jsQR como decodificador, e a tabela completa está em reports/distortion-decode/results-2026-09-22.txt.

O método, em resumo: um código de 41 módulos no nível H com uma zona de silêncio de quatro módulos, deformado por mapeamento inverso para que nada seja reamostrado duas vezes, desfocado como um quadro nítido de celular ficaria, amostrado a 6 e a 4 pixels capturados por módulo, e entregue ao decodificador em 16 posições subpixel por condição. Uma célula com 16 quer dizer que toda posição leu o conteúdo exato; uma célula com 0 quer dizer que nenhuma leu.

Duas coisas decorrem dessa tabela, e são o conteúdo prático da página. Primeiro, as duas linhas que se degradam são as duas que a arte não pode causar: um efeito trapézio é a posição da câmera e uma volta é o formato do objeto, então os dois se corrigem pela colocação e não reexportando. Segundo, o decodificador com que medimos é a ponta rígida da faixa. Os decodificadores de câmera da Apple e do Google são fechados, não publicam números de tolerância e costumam ser mais tolerantes que o jsQR, então trate cada limiar daqui como o ponto em que a curva vira, não como o ponto em que um celular desiste.

QR codes esticados: por que uma alça arrastada raramente quebra um código, e por que corrigir mesmo assim

Um QR code esticado para três vezes a largura ainda leu em toda posição do nosso teste, então um código esticado que não lê quase sempre tem um segundo defeito - pixels por módulo de menos, uma borda mole de JPEG, ou uma zona de silêncio perdida - pegando carona no esticamento. Corrija o esticamento primeiro assim mesmo, porque é o defeito que você enxerga e é ele que está gastando a folga de que os outros precisam.

O mecanismo é simples: um esticamento é uma escala uniforme num eixo, e os três padrões de localização esticam junto, então a grade ajustada pelo decodificador já nasce retangular. O que o esticamento custa é resolução. Achate um código para metade da altura e cada módulo fica com metade da altura, o que é o mesmo que imprimir o código inteiro em metade do tamanho naquele eixo. Um código dimensionado para módulos de 0,5 mm está agora em 0,25 mm numa direção, abaixo do piso de impressão que o tamanho mínimo para impressão define, e nenhuma tolerância de decodificador devolve os milímetros que faltam.

Os casos que chegam à gráfica, e o que causou cada um:

• Uma alça lateral no Canva, Word, PowerPoint ou Keynote. As alças de canto costumam manter as proporções; as laterais costumam esticar um gráfico, ou cortar uma foto. Um código colocado como imagem e puxado por uma borda lateral é o jeito habitual de um código esticado chegar à gráfica.
• Largura e altura digitadas separadamente. Qualquer caixa de diálogo com dois campos e o vínculo entre eles destravado. A página de ajuda da Microsoft para o Office chama a opção de Lock aspect ratio; o painel Transform do Illustrator tem uma trava normalmente rotulada Constrain Width and Height Proportions.
• Um espaço de template com formato fixo. Um espaço largo de banner preenchido com um código quadrado, ou um marcador de imagem que escala para caber. O código é esticado pelo layout e não por uma mão.
• Um driver de impressão ajustado para caber na página. Ajustar à página escala os dois eixos juntos na maioria dos drivers, mas uma opção de preencher ou esticar em certas impressoras de etiqueta não.

Não conserte um raster esticado arrastando ele de volta. Um código achatado e depois reesticado foi reamostrado duas vezes, e cada passagem amolece as bordas dos módulos. Gere ele de novo, exporte como SVG ou como PNG no tamanho final em pixels, e coloque com as proporções travadas - o guia de SVG e PNG cobre qual arquivo cada ferramenta quer. O KoloQR, um gerador de QR codes gratuito com QR codes circulares e de formas personalizadas, exporta SVG, PNG, PDF e EPS já com a zona de silêncio, então uma exportação nova entra em qualquer tamanho sem uma segunda reamostragem.

QR codes tortos e girados

A rotação não afeta em nada um QR code - 15°, 30° e 45° leram todos em 16 de 16 - e uma inclinação leu por inteiro até 25° antes de cair para nada a 30°. Um código colado de viés é portanto seguro; um código que pende como itálico é seguro até uma inclinação que a maioria das pessoas já chamaria de errada.

A diferença entre os dois resultados é instrutiva, e esta é a nossa leitura dela, não uma medição: a rotação deixa cada padrão de localização quadrado, então uma linha pelo centro dele ainda cruza os trechos 1:1:3:1:1 que o localizador procura nos dois eixos. Uma inclinação transforma o padrão num paralelogramo, e a 30° a checagem cruzada vertical por um quadrado pendendo já não bate com a proporção, então o decodificador nunca conclui que há um código no quadro. Isso é uma falha de detecção, e se comporta como tal - silêncio total, não uma leitura no limite - que é o primeiro sintoma em por que um QR code não escaneia.

Na prática a inclinação chega a um código por dois caminhos. A inclinação na arte é uma escolha de design - um código encaixado num mockup em perspectiva, ou arrastado por uma alça de inclinação ou distorção no Illustrator ou no Photoshop - e a correção é desfazer e girar, o que não custa nada. A inclinação aplicada é um rótulo colado torto numa caixa, e só é inclinação se a face da caixa for plana; um rótulo torto num cilindro é um problema de curvatura, tratado adiante.

Se um design precisa de um código numa composição inclinada, gire o código. Um QR code não tem lado de cima: os três padrões de localização em três cantos e o quarto canto vazio dizem ao decodificador em que posição o símbolo está, em qualquer ângulo, então um código a 45° lê tão bem quanto um reto. É o único efeito gratuito desta lista.

QR codes fotografados de lado: perspectiva e efeito trapézio

Um código visto de lado lê limpo enquanto a borda distante tem pelo menos 80% do comprimento da borda próxima, se degrada entre 70% e 60%, e falha em 50%, na nossa medição com um decodificador aberto. Toda leitura na mão tem alguma perspectiva; a falha é um código montado onde todo leitor precisa olhar para ele de um ângulo íngreme.

A distorção de perspectiva é a mudança na forma aparente de um QR code quando a câmera o vê de lado, de modo que a borda distante parece mais curta que a próxima. O número do trapézio é uma forma, e não um ângulo, de propósito. O mesmo trapézio de 70% vem de uma inclinação leve de perto ou de uma íngreme de longe, porque a distância e a distância focal da câmera mudam o quanto a perspectiva comprime a borda distante. O que o leitor controla é o formato que ele vê na tela: se o código no visor do celular parece um trapézio cujo lado curto está abaixo de uns três quartos do lado longo, ele passou do ponto em que o decodificador aberto que testamos aguentou.

Onde isso acontece em instalações reais:

• Um código acima da linha dos olhos. Um cartaz a 2 m lido por alguém de 1,7 m, um código na fachada de uma loja, um painel de menu em cima de um balcão. Todo mundo lê de baixo, e quanto mais baixo o leitor, mais íngreme o trapézio.
• Um código deitado numa mesa ou balcão. Displays de mesa e adesivos de balcão são lidos de pé, num ângulo bem inclinado para baixo. Inclinar o display ou levantar o código num suporte tira a maior parte disso.
• Um código numa vitrine ou atrás de vidro. Os leitores ficam de lado para fugir do próprio reflexo, e levam o trapézio junto.
• Um código no chão. Adesivos de sinalização no piso só são lidos de cima na vertical por quem está pisando neles.

Duas correções, as duas de colocação. Monte o código na altura do celular de quem lê, mais ou menos entre o peito e os olhos de um adulto em pé, e incline uma peça plana na direção do leitor onde a peça permitir. Depois compre margem com tamanho: o 1 cm de largura a cada 10 cm de distância de leitura do guia principal foi escrito para uma leitura de frente, e uma leitura de lado pede mais. Um código que precisa ser lido de um ângulo íngreme a partir de um ponto fixo deve ser conferido desse ponto em dois celulares antes de a tiragem ser impressa, o que a checklist de impressão coloca na etapa de prova.

QR codes em superfícies curvas: garrafas, canecas e latas

Mantenha a largura de um QR code em uns 15% da circunferência do cilindro em que ele se enrola, ou menos. É aí que a nossa medição aguentou em 16 de 16; a 20% caiu para 10 e 13, a 25% para 0 e 2, e a partir de 30% nada leu. Os celulares toleram mais do que o decodificador aberto com que medimos, mas um código projetado no limite da faixa de um decodificador mais rígido é um código com folga num celular.

A conta, feita uma vez. A circunferência é π vezes o diâmetro. Uma garrafa de 7 cm de diâmetro tem π × 7 ≈ 22 cm de volta, e 15% de 22 cm é cerca de 3,3 cm - então um código nessa garrafa deve ter no máximo uns 3,3 cm de largura. Uma lata de bebida de 6,6 cm (uns 21 cm de volta) dá uns 3,1 cm; uma caneca de 9 cm (uns 28 cm) uns 4,2 cm; um frasco de 3 cm (uns 9,4 cm) uns 1,4 cm, que fica abaixo do piso de 2 cm de que um código impresso precisa e quer dizer que o código não tem lugar nenhum na curva do frasco.

Duas coisas fazem a regra pegar mais forte do que parece:

• É a largura que se enrola; a altura é de graça. Um cilindro é plano ao longo do eixo dele, então só a largura do código gasta os 15%. O código não pode ficar mais alto para compensar - ele é quadrado - mas o rótulo em volta pode levar o texto na direção que não custa nada.
• Um código pequeno pede um conteúdo curto. 3,3 cm com um código de 41 módulos dão módulos de 0,8 mm, confortáveis em qualquer papel. Os mesmos 3,3 cm com um código de 77 módulos vindo de uma URL longa de rastreamento dão 0,43 mm, abaixo do piso de 0,5 mm para papel não revestido. A capacidade de um QR code tem a contagem de módulos por versão; encurte a URL antes de encolher o código.

Onde a regra não dá para cumprir, tire o código da curva. Uma tampa, uma etiqueta pendurada, a base plana de uma caixa, um rótulo de gargalo que se afasta da garrafa, ou a face mais plana de um recipiente cônico leem todos como códigos planos. A embalagem flexível é o caso difícil: um sachê ou um doce embrulhado não tem curva fixa e vai vincar em cima do código, e um vinco são dois planos e uma sombra, coisa que nada corrige. Ponha o código onde a embalagem fica esticada, ou na caixa externa.

QR codes desfocados ou pixelizados: a distorção que não é geometria

Um QR code que parece distorcido mas tem bordas retas e cantos quadrados não está distorcido; está sub-resolvido, e a correção é um arquivo melhor, não uma colocação melhor. Desfoque e pixelização são o que acontece quando um código é exportado pequeno demais, salvo como JPEG, ampliado a partir de um raster, capturado em print de tela, ou impresso num tamanho em que um módulo é uma fração de ponto da impressora.

O sinal está nas bordas dos módulos. A reamostragem dá a elas uma franja cinza mole; a compressão com perda dá anéis e blocos; ampliar um PNG pequeno dá uma borda em degraus, nítida mas errada. Nos três casos a grade está onde deveria, então a tolerância à distorção plana lá de cima não compra nada, e a falha aparece como um código que lê na tela e não no papel, ou que só lê de perto.

A regra é um número inteiro de pixels por módulo no tamanho final, ou um arquivo vetorial que não tem pixel para errar. Resolução e DPI de um QR code tem a conta nos dois sentidos e a calculadora de DPI faz ela; SVG vs PNG resolve qual formato cada destino aceita. Um print de tela de um QR code nunca é o arquivo certo para nada impresso.

Como diagnosticar e corrigir um QR code distorcido

Descubra qual das cinco distorções você tem antes de mudar qualquer coisa, porque três delas se corrigem no arquivo e duas se corrigem na parede. O procedimento leva uns dez minutos e começa, como toda diagnose de leitura deveria, separando a arte da colocação.

1. Decodifique o arquivo que você colocou. Solte a exportação na ferramenta de leitura de QR codes. Se o arquivo lê e o código colocado não, o defeito entrou no layout, na exportação ou no objeto.
2. Confira se o código está quadrado no layout. Selecione o código colocado e veja a largura e a altura. Qualquer diferença é esticamento; um valor que não é múltiplo da contagem de módulos num pixel inteiro é reamostragem.
3. Olhe os padrões de localização. Os três quadrados dos cantos têm de ser quadrados. Retângulos querem dizer esticamento, paralelogramos querem dizer inclinação, e uma borda mole ou em degraus quer dizer que o arquivo foi reamostrado.
4. Fique onde o leitor fica. Olhe o código na tela do celular da posição real. Um trapézio cujo lado curto está abaixo de uns três quartos do lado longo é defeito de colocação, não de arte.
5. Meça o código contra a curva. Num cilindro, divida a largura do código pela circunferência. Acima de uns 15%, encolha o código, encurte o conteúdo, ou leve o código para uma parte plana.
6. Gere de novo em vez de consertar. Para esticamento, inclinação ou reamostragem, exporte um código novo como SVG ou PNG no tamanho final em pixels e coloque com as proporções travadas. Não arraste um raster de volta ao formato.
7. Valide a arte e depois tire uma prova. Passe a exportação pelo validador de QR codes para margem, contraste e tamanho de módulo, depois imprima uma peça no objeto real e leia da posição real em dois celulares.

As duas ferramentas fazem trabalhos diferentes. O scanner de QR codes lê um arquivo que você já tem - um PNG esticado, uma foto da garrafa - e diz se um decodificador consegue tirar o conteúdo dali. O validador de QR codes confere a arte que você está prestes a colocar, e reporta a margem, o contraste e o tamanho do módulo numa largura impressa declarada, que é o número que uma colocação curva ou de lado come primeiro.

A correção por ferramenta e situação

Quase toda distorção tem uma correção de uma linha assim que recebe um nome, e a tabela combina cada lugar em que um código fica distorcido com a ação que desfaz aquilo. Os rótulos de menu mudam entre versões, então os nomes são o que procurar e não a redação exata; para a linha do Figma, como copiar um QR code para o Figma tem o caminho de colagem que mantém o código em vetores.

Uma última coisa que vale descartar antes de tudo isso: um código que lê perfeitamente no celular e depois não faz nada de útil nunca esteve distorcido. O símbolo fez o trabalho dele e o destino por trás não, o que o guia de diagnóstico cobre em defeitos de destino. Estilizar nunca melhora o desempenho de leitura, e um código estilizado numa curva ou de lado tem menos tolerância para gastar que um simples, porque os módulos decorativos põem menos tinta em cada célula - formas de QR personalizadas escaneiam? tem as medições.