Gerador de código de barras PDF417

O PDF417 não é um código matricial. É um código de barras linear curto empilhado sobre si mesmo: cada linha é uma corrida de barras e espaços que um feixe pode varrer como varre o código de uma loja, e as linhas são numeradas para o decodificador recompor as peças lidas fora de ordem. O nome descreve o bloco de construção — cada palavra de código são quatro barras e quatro espaços em dezessete módulos: quatro e dezessete. Essa estrutura é a razão de o PDF417 ter acabado em documentos e não em cartazes: ele pode ser lido por equipamento de varredura a laser que não tem câmera nenhuma.

Aparência
Tamanho
Cores

321 × 182 px no PNG

Unidades

Especificação

Conjunto de caracteres
qualquer dado
Comprimento
de 1 a 1850 caracteres
Dígito verificador
esta simbologia não usa

Onde é usado

  • Documentos de identidade, onde o bloco legível por máquina no verso do cartão guarda os mesmos campos da face impressa para quem tiver um leitor
  • Cartões de embarque impressos e documentos de viagem, onde o registro inteiro do itinerário viaja no papel, e não numa consulta a um servidor
  • Papelada de transporte e expedição — conhecimentos, notas de entrega, manifestos — onde o formulário é escaneado como documento, não pego de uma prateleira
  • Formulários que precisam sobreviver a serem impressos, preenchidos e postados, e depois lidos num scanner de lote sem ninguém redigitar os campos

Como se compara

Data Matrix e QR são simbologias matriciais: os dados vivem numa grade bidimensional, e ler uma exige um capturador que abranja toda a área de uma vez. O PDF417 é linear empilhado, e a diferença não é acadêmica — um scanner a laser de varredura, que vê só uma linha por vez, consegue ler PDF417 e não consegue ler código matricial de jeito nenhum. Essa única propriedade decidiu onde cada formato acabou. As normas que especificam o PDF417 para carteiras, bilhetes e documentos de transporte foram escritas para parques de leitura montados sobre lasers, e esses parques sobrevivem a qualquer scanner individual. O custo do empilhamento é a largura. Cada linha gasta quatro palavras de código em estrutura antes de carregar qualquer coisa: padrão de início, indicador de linha de cada lado e padrão de parada — uma linha são dezessete módulos vezes o número de colunas de dados mais quatro, e um módulo a mais para a barra de fechamento. Com duas colunas de dados são 103 módulos de largura, dos quais 34 carregam seus dados. O Data Matrix não tem esse imposto por linha, por isso vence com folga em peças pequenas, e o QR vence com folga quando o leitor é um telefone. Busque o PDF417 quando a ponta recebedora escaneia documentos, ou quando o formato da carga é ditado por uma norma que já nomeia o PDF417.

Erros comuns

  • Deixar a carga crescer até as linhas desabarem. O símbolo desenhado aqui mantém a mesma altura total seja lá o que você digite, então mais dados são mais linhas espremidas dentro — e os indicadores de linha param de se distinguir muito antes dos dados. O valor de exemplo sai com nove linhas de uns seis módulos de altura. Com 200 caracteres são vinte linhas e as linhas caem a 2,8 módulos — já abaixo do piso de três módulos para o qual o formato é desenhado. No teto de 1850 caracteres o símbolo tem 52 linhas e 18 colunas de dados, e cada linha tem cerca de um módulo de altura: uma imagem de código de barras, não um código. Ou corte a carga, ou dê mais altura ao arquivo colocado no leiaute — o vetor estica, e o que importa é a proporção.
  • Escolher o PDF417 para algo curto. A sobrecarga por linha é fixa, então uma carga pequena paga estrutura de que não precisa: com duas colunas de dados, dois terços de cada linha são padrão de início, indicadores e parada. Uma URL ou um número de série é o trabalho errado para esta simbologia; ela começa a se pagar quando a carga é um registro com muitos campos.
  • Aparar a arte até a tinta. O PDF417 pede dois módulos de zona de silêncio nos quatro lados — metade dos quatro do QR, e por isso fácil de confundir com folga de leiaute. Os padrões de início e parada se apoiam bem nessa fronteira, e são eles que dizem ao feixe que ele cruzou uma linha inteira e não parte de uma: apare-os e uma leitura aparentemente bem-sucedida pode devolver uma linha truncada.
  • Reconstruir uma carga lida do documento de outra pessoa. Os bytes dentro de uma carteira ou de um cartão de embarque seguem um formato de dados definido pelo órgão que emite o documento, não pela simbologia, e esta página codificará de bom grado uma versão editada dessa cadeia num símbolo tecnicamente perfeito. O código ser válido nada diz sobre o documento ser genuíno, e as duas coisas não devem ser confundidas.

Perguntas frequentes

Quantos dados o PDF417 guarda?
No topo do formato, 1850 caracteres de texto, 2710 dígitos ou 1108 bytes — este campo para em 1850. Os três números diferem porque há três jeitos de empacotar dados em palavras de código: a compactação de texto cabe dois caracteres por palavra, a numérica pouco menos de três dígitos, e a de bytes só 1,2 byte. Isso é mensurável aqui. Duzentas letras latinas saem com seis colunas de dados e vinte linhas; os mesmos duzentos caracteres em cirílico caem da compactação de texto para o modo byte e saem com doze colunas e trinta e quatro linhas — cerca de três vezes e meia as palavras de código para o mesmo número de caracteres.
O PDF417 precisa de dígito verificador?
Não, e não há nada a anexar aos seus dados. A correção de erros é embutida na codificação como palavras Reed-Solomon espalhadas pelo símbolo, num de nove níveis: o nível 0 gasta duas palavras em correção e cada degrau dobra isso, então o nível 8 gasta 512. Níveis mais altos sobrevivem a mais dano e aumentam o símbolo — num formato empilhado isso significa mais linhas, e mais linhas numa altura fixa significam linhas mais achatadas.
A câmera do telefone vai ler?
As bibliotecas de decodificação em que os aplicativos se apoiam incluem o PDF417, mas um aplicativo só procura os formatos que mandaram procurar, e um escrito para QR não achará nada na página. Onde o PDF417 vive, o leitor é especificado junto com o documento, então a pergunta não surge. Ela surge quando você põe PDF417 onde o público deve escanear — e essa é uma razão para usar outra simbologia.
O que é o MicroPDF417?
Um membro à parte e compacto da mesma família, com um conjunto fixo de formatos pequenos e sem indicadores de linha do tipo comum. Ele existe exatamente para o caso descrito acima — uma carga curta que de outro modo pagaria a sobrecarga inteira por linha — e é outra simbologia, não um ajuste desta. Esta página produz PDF417 padrão.
Por que ele sai como uma tira longa e achatada?
Porque é feito de linhas, e uma linha precisa ser larga o bastante para conter toda a estrutura de um código linear. A forma é o propósito, não um efeito colateral: uma tira longa e achatada cabe ao pé de um formulário ou na borda de trás de um cartão, onde um quadrado da mesma capacidade teria de comer o leiaute. Se uma tira larga não serve à sua superfície, a resposta honesta é que o PDF417 é o formato errado para ela.