Lançamento

30% no primeiro mês do Pro30% no 1º mêsR$ 29,98 → R$ 20,99

Ver planos
ZPL em PDF

Comando · ^GB

^GB: retângulos, linhas e molduras

^GB (Graphic Box) é o comando de desenho mais usado numa etiqueta de envio. Toda divisória entre o remetente e o destinatário, toda moldura em volta de um bloco e toda tarja preta com o nome da transportadora saem dele — inclusive as linhas, que são só retângulos com um lado zerado.

Conferido em 1 de setembro de 2026

Os parâmetros, e o truque da linha

A forma é ^GBl,a,e,c,r: largura, altura, espessura do traço, cor e arredondamento. O ^FO antes dele decide onde o canto superior esquerdo fica, como em qualquer campo.

A linha é o mesmo comando com um lado zerado: ^GB420,0,3 desenha uma linha horizontal de 420 pontos com 3 de espessura, e ^GB0,300,3 desenha uma vertical. Não existe comando separado de linha — essa é a forma idiomática.

  • l — largura em pontos.
  • a — altura em pontos. Zero em um dos dois faz uma linha.
  • e — espessura do traço, em pontos. O padrão é 1.
  • c — cor: B preto ou W branco.
  • r — arredondamento dos cantos, de 0 a 8.

Por que a caixa saiu toda preta

Quando a espessura do traço chega ao tamanho da caixa, o retângulo é preenchido. ^GB300,80,80 é uma caixa de 300 por 80 com traço de 80 pontos — ou seja, uma tarja sólida. Isso não é bug, é como se faz um bloco preenchido em ZPL.

Se você queria só a moldura e saiu tudo preto, o terceiro parâmetro está grande demais. Uma espessura de 3 a 5 pontos é o normal para uma moldura visível numa etiqueta a 203 dpi.

A tarja com texto branco

O padrão é sempre o mesmo: desenhe a caixa preenchida com ^GB, depois posicione o texto por cima e marque o campo com ^FR. O ^FR inverte só aquele campo, então o texto sai branco sobre o preto que já estava lá.

Se em vez do ^FR você usar ^LR, a inversão passa a valer para todos os campos seguintes e não só para um — é a causa de uma etiqueta que fica invertida da metade para baixo.

Mude a espessura de um ^GB e veja a caixa preencher

Arraste o arquivo, cole o código ou escolha do dispositivo

.txt · .zpl · .prn · .zip · .pdf · .png · .jpg — 30 etiquetas por dia

A conversão acontece no seu navegador: seu arquivo nunca sai do seu aparelho.Como isso funciona
Grátis, sem cadastroSem uploadSem marca d'águaLote de vários arquivosPDF · PNG · ZIP

Dúvidas

Perguntas frequentes

O que significa ^GB no ZPL?

^GB quer dizer Graphic Box e desenha um retângulo na posição definida pelo ^FO anterior. Com a largura ou a altura em zero, o mesmo comando desenha uma linha.

Como desenhar uma linha em ZPL?

Com o próprio ^GB, zerando um dos lados: ^GB420,0,3 é uma linha horizontal de 420 pontos com 3 de espessura, e ^GB0,300,3 é uma vertical. Não existe um comando de linha separado.

Por que meu retângulo saiu preenchido de preto?

A espessura do traço chegou ao tamanho da caixa. Em ^GB300,80,80 o traço tem 80 pontos numa caixa de 80 de altura, o que preenche tudo. Para uma moldura, use uma espessura de 3 a 5 pontos.

Como fazer texto branco sobre fundo preto?

Desenhe a caixa preenchida com ^GB, posicione o texto por cima com ^FO e marque o campo com ^FR antes da fonte. O ^FR inverte apenas aquele campo; o ^LR inverteria todos os seguintes.

Outros guias