Sobre esta ferramenta
O que contém um código QR
Um código QR guarda uma pequena sequência de bytes, normalmente texto. O que acontece depois da leitura depende do leitor e da forma como esse texto começa: a maioria das câmaras dos telemóveis sugere abrir um link https:// no navegador, entrar na rede descrita por uma string WIFI:, começar uma mensagem para um link mailto: e ligar para um número tel:.
Os códigos criados aqui são estáticos: o conteúdo fica escrito no próprio padrão. Não há nenhum redirecionamento nem nenhuma conta por trás deles, por isso continuam a funcionar enquanto existir o link ou a rede para onde apontam.
Versões, módulos e correção de erros
Os pequenos quadrados chamam-se módulos. Um código QR existe em 40 tamanhos, chamados versões: a versão 1 tem 21 × 21 módulos, e cada versão acrescenta 4 módulos por lado, até 177 × 177 na versão 40. A ferramenta escolhe a versão mais pequena em que o seu conteúdo cabe.
Parte de cada código é redundância, que permite a um leitor reconstruí-lo quando está riscado ou parcialmente tapado. O nível L consegue recuperar cerca de 7% do código, o M 15%, o Q 25% e o H 30%. Mais redundância deixa menos espaço: o maior código contém 2953 bytes no nível L e 1273 bytes no nível H.
Criar um código que se consiga ler
Os leitores esperam módulos escuros sobre um fundo claro, com uma margem vazia, a zona de silêncio, de 4 módulos em todos os lados. Pouco contraste, cores invertidas e a falta de margem são as razões habituais para um código falhar.
Use SVG para impressão: fica nítido em qualquer tamanho. O PNG dá a cada módulo o mesmo número inteiro de píxeis, para que as arestas fiquem nítidas; os píxeis que não se dividem por igual passam a ser margem extra.
Como funciona
O padrão é calculado pela biblioteca open source de Go go-qrcode, compilada para WebAssembly e executada numa thread em segundo plano do seu navegador. O SVG e o PNG são depois desenhados pela página a partir desse padrão. O conteúdo, incluindo uma palavra-passe de Wi-Fi, não é enviado para lado nenhum.