Como gerar um código QR a partir de texto ou URL

Quando utilizar este gerador

Este gerador transforma texto ou um URL fornecido numa imagem de código QR quando a geração é bem-sucedida. Pode ser útil para preparar um endereço de página, uma mensagem curta ou outra informação textual para utilização noutra aplicação. A saída bem-sucedida é uma imagem PNG apresentada como uma cadeia de texto em base64, por isso a etapa seguinte deve saber tratar esse formato.

O conteúdo é o elemento essencial: sem texto ou URL não há imagem para interpretar. Além do campo principal, podem ser usados os campos alternativos destinados a texto, URL ou conteúdo. As opções de tamanho, correção de erros e cores servem para adaptar a imagem ao uso previsto, sem alterar o facto de que é necessário enviar um conteúdo não vazio.

Passos para preparar a imagem

Prepare o texto que pretende converter. Se estiver a trabalhar com uma página, introduza o respetivo URL; para outros casos, use uma mensagem ou outro conteúdo textual não vazio.
Envie esse valor pelo campo principal ou por um dos campos alternativos aceites, identificados como texto, URL ou conteúdo. Se o campo principal for omitido, o seu valor predefinido é vazio, pelo que deve confirmar que um dos campos alternativos recebeu informação.
Defina o tamanho, se essa opção estiver disponível. O valor predefinido é 256. O valor indicado é convertido para um número inteiro; se essa conversão provocar um erro de tipo ou de valor, é usado 256. Depois, o tamanho normalizado fica limitado ao intervalo entre 64 e 1024.
Tenha em conta que o tamanho final da imagem em píxeis pode não coincidir com o número indicado. O cálculo utiliza uma escala inteira para os módulos do código QR, e essa escala determina as dimensões efetivas do PNG.
Escolha o nível de correção de erros quando precisar de o configurar. Para valores de texto, são aceites L, M, Q e H, sem distinção entre maiúsculas e minúsculas; se não indicar um nível, ou se o valor normalizado não for suportado, é utilizado M.
Ajuste as cores, caso necessário. A configuração inicial usa preto no primeiro plano e branco no fundo, mas o primeiro plano e o fundo podem ser configurados.
Inicie a geração depois de rever o conteúdo e as opções. Numa execução bem-sucedida, receberá uma cadeia base64 não vazia que representa uma imagem PNG.

Leitura e verificação do resultado

Para reconhecer uma saída bem-sucedida, procure uma cadeia base64 com conteúdo e confirme que a descodificação corresponde a um PNG válido. O resultado é uma representação de imagem, não uma mensagem textual pronta a ler, pelo que a aplicação que o recebe deve encaminhá-lo para o tratamento adequado.

A dimensão efetiva deve ser avaliada depois da geração, sobretudo quando foi pedido um valor que não corresponde diretamente à escala inteira dos módulos. Um pedido de 300, por exemplo, pode originar dimensões diferentes, apesar de o valor ter sido normalizado dentro do intervalo permitido.

A ausência de imagem exige uma verificação do conteúdo enviado e do estado da geração. Conteúdo vazio termina sem imagem, enquanto uma falha de geração ou a falta de uma dependência necessária também pode impedir a produção do resultado. Assim, não interprete a ausência como uma imagem vazia nem como prova de que o texto foi convertido.

Exemplo prático

Uma associação pretende transformar o endereço da página de inscrições num código QR para colocar num cartaz.

Introduza o endereço da página de inscrições de uma associação, selecione o tamanho 300 e inicie a geração.

Com o tamanho definido em 300 e os restantes parâmetros nos valores predefinidos (nível de correção M, primeiro plano preto e fundo branco), se a geração for bem-sucedida o resultado esperado é uma cadeia base64 não vazia que descodifica para um PNG válido; as dimensões podem diferir de 300 píxeis.

Limitações

Conteúdo vazio não produz imagem, e falhas de geração ou dependências indisponíveis podem impedir o resultado; quando há saída bem-sucedida, o formato é PNG.

Erros comuns

Causa: nenhum conteúdo não vazio foi enviado pelo campo principal ou por um dos aliases aceites. Ação: introduza texto ou um URL no campo principal, ou envie o valor através de texto, URL ou conteúdo, e volte a iniciar a geração.

Perguntas frequentes

Posso gerar um código QR a partir de um URL?

É possível, desde que o URL enviado não esteja vazio. O valor pode seguir pelo campo principal ou por um campo alternativo de texto, URL ou conteúdo.

A imagem terá exatamente o tamanho indicado?

Não necessariamente. O número é convertido para um inteiro e limitado entre 64 e 1024, enquanto as dimensões finais dependem da escala inteira dos módulos.

O que acontece se não introduzir conteúdo?

Sem conteúdo, a geração termina sem imagem. Uma falha de geração ou uma dependência necessária indisponível também pode deixar de produzir uma imagem.