ZPLToolkit

^BX

Código de Barras Data MatrixPreview: parcial

O 2D quadrado e compacto: muito dado em poucos milímetros, legível mesmo com parte do símbolo danificada.

Sintaxe

^BXo,h,s,c,r,f,g,a

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
hTamanho de um único módulo, em dots. O tamanho do símbolo decorre disso e do dado.1 to the label width — the size of one square module^BY bar height, split across the rows
sNível de qualidade. Use 200 (ECC200); os valores menores são os formatos legados.0, 50, 80, 100, 140 or 200 — quality level0
cNúmero de colunas, para fixar o tamanho do símbolo.9 to 49 — columnsChosen by the printer
rNúmero de linhas, para fixar o tamanho do símbolo.9 to 49 — rowsChosen by the printer
fIdentificador de formato, relevante só nos níveis de qualidade legados.1 to 6 — format id, quality 0 to 140 only6
gCaractere que inicia uma sequência de escape dentro do dado do campo.Any character — the escape sequence character~
aSímbolo quadrado ou retangular.1 square, 2 rectangular1

Como funciona

^BX imprime Data Matrix, a simbologia preferida quando há pouquíssimo espaço. Um símbolo de poucos milímetros guarda um número de série, uma URL ou uma cadeia de elementos GS1, e continua legível com um canto arranhado.

A qualidade 200 seleciona o ECC200, a correção de erro Reed–Solomon moderna. É o único valor que vale usar: os níveis de qualidade menores são os formatos anteriores a 1994, mantidos para equipamentos que antecedem o ECC200 e entendidos por quase nada fabricado depois disso.

O parâmetro `h` é o tamanho de um módulo, não o tamanho do símbolo. O símbolo cresce com o dado, então um valor mais longo com o mesmo `h` produz um quadrado maior — que é a surpresa habitual quando um número de série ganha um dígito e o código deixa de caber no espaço reservado.

Exemplo

ZPL
^XA
^FO60,40^BXN,6,200^FDZPL Toolkit^FS
^XZ

Renderizando…

Um Data Matrix ECC200 com módulos de 6 dots.
Abrir no visualizador

O que o preview deste site faz com ele

Desenhado com um codificador ECC200 de verdade, no tamanho de módulo que o `h` pede ou — quando o `h` é omitido — na altura de barra do ^BY distribuída entre as linhas, como a impressora dimensiona. A rotação é aplicada. Nível de qualidade, identificador de formato, caractere de escape e proporção não são lidos aqui — o preview desenha sempre um símbolo ECC200 quadrado. Colunas e linhas são respeitadas quando as duas são informadas.

Erros comuns

  • Ler o `h` como altura do símbolo. Ele é o tamanho do módulo; o símbolo fica do tamanho que o dado exigir.
  • Usar nível de qualidade abaixo de 200. Leitores modernos não são obrigados a ler esses formatos, e a maioria não lê.
  • Não deixar zona de silêncio. O Data Matrix precisa de pelo menos um módulo livre em toda a volta, e imprimi-lo colado a uma linha ou à borda de uma caixa é causa comum de não-leitura.

Veja também