ZPLToolkit

Solução de problemas

A etiqueta sai cortada na borda

Conteúdo que sai da etiqueta é um campo posicionado além da largura de impressão, uma largura de impressão que não bate com o material, ou um deslocamento de origem que moveu tudo de uma vez.

Um campo que não cabe

A causa mais comum é a mais simples: um campo cuja origem somada à própria largura cai depois da borda. A impressora não quebra linha e não avisa — ela imprime o que cabe e o resto se perde.

^XA
^PW812
^LL1218
^FO700,50^A0N,50,50^FDReferencia do cliente 88213^FS
^XZ
O campo começa a 700 pontos numa etiqueta de 812. A maior parte dele nunca é impressa.

Normalmente é um problema de dado, não de layout. O modelo foi desenhado contra um valor curto e depois encontrou um longo — e é por isso que sobrevive aos testes e falha em produção, e por que validar cada etiqueta pega o que conferir o modelo não pega.

Uma largura de impressão que não bate com o material

O ^PW diz à impressora qual é a largura da área imprimível, em pontos. Defina maior que o material e a parte direita de toda etiqueta cai fora da borda; defina menor e a etiqueta imprime corretamente dentro de uma faixa menor que o papel.

O número é em pontos, não em milímetros, então muda com a resolução. Uma etiqueta de 4 polegadas tem 812 pontos a 203 dpi e 1218 a 300 — um ^PW herdado de uma impressora de 203 dpi numa de 300 produz uma etiqueta usando dois terços da largura, e um herdado no sentido inverso sai pela borda.

^XA
^PW812
^LL1218
^FO50,50^A0N,50,50^FDReferencia do cliente 88213^FS
^XZ
O mesmo campo numa origem que deixa espaço para ele, numa etiqueta 4×6" a 203 dpi.

Ou tudo se moveu junto

Se a etiqueta inteira está deslocada em vez de um campo só, olhe o ^LH. Ele move a origem a partir da qual todo ^FO e ^FT seguinte é medido, então um único ^LH50,50 empurra o desenho inteiro para baixo e para a direita nessa medida — e para fora da borda, se já estava perto.

O ^LH costuma ser definido uma vez no topo de um modelo e esquecido, o que o torna fácil de não ver quando um desenho que cabia para de caber. Vale descartá-lo antes de sair movendo campos: mover compensa o deslocamento em vez de removê-lo, e a próxima pessoa que mexer no ^LH herda a bagunça.

Conteúdo cortado embaixo, e não de lado, costuma ser o ^LL, ou um problema de rastreamento que faz a impressora parar cedo. Se for o segundo, a etiqueta desliza entre impressões — esse é o sinal.

Conferir o layout no validador

O campo transbordante acima, carregado e pronto. O validador mede cada campo com a mesma métrica de fonte com que o renderizador o desenha, e aponta os que saem da etiqueta.

Conferir o layout no validador

Perguntas frequentes

Quantos pontos de largura tem a minha etiqueta?
Multiplique a largura em polegadas pela resolução da impressora: uma etiqueta de 4 polegadas tem 812 pontos a 203 dpi, 1218 a 300 dpi e 2436 a 600. Esse número é o que vai no ^PW.
O mesmo ZPL imprime certo numa impressora e cortado em outra. Por quê?
Quase sempre resolução. Toda coordenada em ZPL é em pontos, então uma etiqueta desenhada para 203 dpi ocupa dois terços da largura numa de 300 dpi, e uma desenhada para 300 sai pela borda de uma de 203.
Dá para fazer um campo quebrar linha em vez de sair pela borda?
Dá — o ^FB transforma um campo num bloco com largura, número de linhas e alinhamento, e quebra o texto entre linhas. É a resposta certa para um endereço; não substitui conferir se o próprio bloco cabe.

Comandos deste guia

Guias relacionados