^BY
Padrão do Código de BarrasPreview: parcialDefine largura de módulo, proporção e altura herdadas pelos códigos de barras seguintes. A largura de módulo é o que mais afeta a leitura.
Sintaxe
^BYw,r,hParâmetros
| Parâmetro | Descrição e valores aceitos | Se omitido |
|---|---|---|
| w | Largura de módulo — a largura da barra mais estreita, em pontos.1 to 10 dots | 2 dots |
| r | Proporção entre barra larga e estreita, para as simbologias que usam uma.2.0 to 3.0 in 0.1 steps | 3.0 |
| h | Altura padrão do código de barras em pontos.1 to 32000 dots | 10 dots |
Como funciona
^BY define os padrões que todo código de barras seguinte usa, a menos que os sobrescreva. O primeiro parâmetro, a largura de módulo, é a largura da barra mais estreita em pontos e é o valor mais importante para a leitura: pequeno demais, o leitor não consegue distinguir as barras; grande demais, o símbolo sai da etiqueta.
A 203 dpi, uma largura de módulo de 2 ou 3 é a escolha usual. A 300 dpi, a mesma barra física precisa de um valor maior em pontos, então um template movido entre resoluções sem ajustar o ^BY gera um código de barras com metade do tamanho físico que deveria ter.
A proporção largo/estreito vale apenas para os códigos que têm barras largas e estreitas, como Code 39 e Intercalado 2 de 5. Code 128 e QR ignoram. O parâmetro de altura define um padrão que o ^BC e afins podem sobrescrever por campo.
Exemplo
^XA
^BY3,3,80
^FO60,60^BCN,80,Y,N,N^FD12345678^FS
^XZRenderizando…
O que o preview deste site faz com ele
Largura de módulo e altura são aplicadas. A proporção largo/estreito é lida mas não usada, o que é inofensivo para Code 128 e QR — as duas simbologias que o preview desenha hoje.
Erros comuns
- Levar o ^BY de uma resolução para outra. Uma largura de módulo 2 a 203 dpi precisa ser 3 a 300 dpi para o mesmo tamanho físico.
- Largura de módulo abaixo de 2 a 203 dpi. A maioria dos leitores não lê de forma confiável.
- Esquecer que o ^BY precisa vir antes do comando de código de barras, não depois.