Como gerar códigos de barras em PNG

Para que serve o gerador de códigos de barras

O Barcode Generator cria dados de imagem PNG de códigos de barras em formato base64 quando a geração é bem-sucedida. Pode fornecer um valor para codificar, escolher um formato compatível e ajustar as dimensões e a apresentação do texto. O formato predefinido é Code 128 e a introdução de dados é opcional, embora a ausência de dados produza um resultado sem imagem.

Como gerar o código de barras

Introduza no campo de dados o conteúdo que pretende representar, por exemplo um identificador de produto ou de encomenda. Para formatos numéricos, confirme que o valor contém dígitos suficientes para o formato escolhido; depois de reconhecido o formato, os caracteres que não sejam dígitos são retirados e o conteúdo é limitado ao número de dígitos exigido. Quando aplicável, a biblioteca acrescenta o dígito de controlo.
Selecione o formato do código de barras. Os nomes são normalizados para minúsculas, sem espaços nem hífen, e algumas formas com sublinhado são convertidas para o nome correspondente. Se não escolher outro formato, é usado Code 128.
Ajuste a largura e a altura se precisar de uma imagem maior ou mais pequena. Para dados não vazios, a largura é convertida para um número inteiro entre 100 e 2000, e a altura para um número inteiro entre 40 e 600. Se a conversão da largura falhar, é usado 400; se a conversão da altura falhar, é usado 100.
Decida se pretende mostrar o texto associado ao código. Esta opção vem ativada por predefinição e pode ser ligada ou desligada.
Execute a geração e verifique o resultado. Quando tudo corre bem, o resultado inclui dados de imagem PNG codificados em base64. Guarde ou utilize esses dados conforme o fluxo de trabalho em que está a inserir o código de barras.

Como interpretar o resultado

Um resultado bem-sucedido deve disponibilizar dados de imagem PNG em base64. As definições de largura e altura são normalizadas antes da geração, mas não há garantia de que correspondam exatamente às dimensões em píxeis do PNG final.

Se não fornecer dados, o processo pode devolver um resultado bem-sucedido com uma indicação de erro, mas sem imagem. O mesmo pode acontecer quando um formato numérico reconhecido recebe menos dígitos do que o necessário ou quando o formato escolhido não é suportado pela biblioteca de códigos de barras. Se a dependência necessária estiver indisponível ou a geração provocar uma exceção, o resultado pode ser malsucedido e incluir uma indicação de erro.

Exemplo prático

Uma pessoa precisa de representar o identificador ENCOMENDA-742 num código de barras para o associar a uma encomenda.

Introduza o valor ENCOMENDA-742, mantenha Code 128, deixe o texto ativado e execute a geração.

Um resultado bem-sucedido com dados de imagem PNG codificados em base64; as dimensões exatas em píxeis não são garantidas.

Limitações

A ferramenta não gera uma imagem quando faltam dados, quando um formato numérico reconhecido tem dígitos insuficientes ou quando o formato não é suportado; também pode devolver um resultado malsucedido se a geração falhar. As dimensões solicitadas não garantem o tamanho exato em píxeis do PNG.

Erros comuns

Deixar o campo de dados vazio é uma causa frequente de um resultado sem imagem. Introduza um valor antes de executar a geração e confirme novamente o resultado.

Perguntas frequentes

Posso gerar um código de barras sem introduzir dados?

Sim, mas a imagem só é devolvida quando a geração é bem-sucedida. Sem dados, o resultado indica um erro e não inclui imagem.

As dimensões indicadas correspondem exatamente ao tamanho da imagem?

Pode ajustar ambos, mas, para dados não vazios, a largura fica limitada a 100-2000 e a altura a 40-600. Estes valores são normalizados e não garantem as dimensões exatas em píxeis do PNG final.

O que acontece se eu introduzir um número incompleto?

Depende do formato e da validação. Num formato numérico reconhecido, são retirados os caracteres não numéricos e o conteúdo tem de conter dígitos suficientes; com menos dígitos, não é gerada uma imagem.