ZPLToolkit

^B7

Código de Barras PDF417Preview: parcial

Simbologia 2D empilhada que guarda um parágrafo, não um número — é o código das carteiras de habilitação e dos manifestos de carga.

Sintaxe

^B7o,h,s,c,r,t

Parâmetros

ParâmetroDescrição e valores aceitosSe omitido
oRotação do código de barras na etiqueta.N normal, R 90°, I 180°, B 270°Last ^FW value, else N
hAltura da linha, como múltiplo da largura de módulo do ^BY. Três ou quatro é a faixa usual; um é ilegível.1 to the label height — multiplied by the ^BY module width^BY bar height, split across the rows
sNível de correção de erro. Quanto maior, mais dano ele suporta e mais espaço ocupa.1 to 8 — error detection and correction0 — error detection only
cNúmero de colunas de dado. É a forma usual de controlar a largura do símbolo.1 to 30 — data columnsChosen for a 1:2 shape
rNúmero de linhas.3 to 90 — rowsChosen for a 1:2 shape
tTrunca os indicadores de linha da direita para economizar largura, ao custo da tolerância a dano.Y or N — truncate the right row indicatorsN

Como funciona

^B7 imprime PDF417, que empilha linhas de uma simbologia linear formando um bloco. Ele carrega cerca de 1.800 caracteres de texto num símbolo só, e é por isso que é o formato de documentos de identificação, cartões de embarque e manifestos em que a etiqueta precisa ser lida sem um banco de dados por trás.

A correção de erro é o que torna isso prático. O nível de segurança `s` define quanto do símbolo pode ser danificado antes de parar de decodificar: o nível 0 é pouco mais que uma soma de verificação, e os níveis 4 e 5 sobrevivem a uma etiqueta rasgada ou raspada. Níveis altos custam espaço, então a escolha usual é 4 ou 5 para qualquer coisa manuseada com frequência.

O formato é controlado por colunas e linhas. Deixar os dois em branco faz a impressora buscar um bloco 1:2; definir o número de colunas é como se encaixa o símbolo numa área de largura fixa da etiqueta. Repare que a largura do módulo vem do ^BY e o `h` multiplica essa largura para chegar à altura da linha — um módulo de PDF417 não é quadrado.

Exemplo

ZPL
^XA
^BY2
^FO60,40^B7N,4,5^FDZPL Toolkit PDF417^FS
^XZ

Renderizando…

Um PDF417 no nível de segurança 5, com módulo de 2 dots vindo do ^BY e linhas de quatro módulos — oito dots — de altura.
Abrir no visualizador

O que o preview deste site faz com ele

Desenhado com um codificador PDF417 de verdade, com a largura do módulo vinda do ^BY e a altura da linha vinda do `h` multiplicado por essa largura. Omitir o `h` distribui a altura de barra do ^BY entre as linhas, como a impressora faz. O truncamento é ignorado; rotação, nível de segurança, colunas e linhas são respeitados. Dado que o codificador não consegue acomodar vira uma caixa vermelha hachurada.

Erros comuns

  • Deixar `h` em 1. Isso deixa cada linha com um módulo de altura: o símbolo é codificado corretamente e nenhum leitor consegue lê-lo. O próprio manual da Zebra diz que 1 não é um valor recomendado.
  • Nível de segurança 0 numa etiqueta que é manuseada. A vantagem do PDF417 é sobreviver a dano, e o nível 0 abre mão justamente disso.
  • Fixar linhas e colunas com dado variável. Assim que o conteúdo cresce, o símbolo não cabe mais e o campo falha.

Veja também