^GF
Campo GráficoPreview: parcialEmbute um bitmap direto na etiqueta — o comando que toda conversão de PDF ou imagem para ZPL produz.
Sintaxe
^GFa,b,c,d,dataParâmetros
| Parâmetro | Descrição e valores aceitos | Se omitido |
|---|---|---|
| a | Formato dos dados. A é hexadecimal ASCII; B e C são binário e binário comprimido.A ASCII hex, B binary, C compressed binary | A |
| b | Número de bytes nos dados que seguem.1 to 99999 — bytes in the data field | Value of c |
| c | Total de bytes do gráfico.1 to 99999 — total bytes in the graphic | Value of b |
| d | Bytes por linha — oito pontos de largura da imagem por byte.1 to 99999 — bytes per row | Value of c |
| data | O payload do bitmap, no formato escolhido no primeiro parâmetro.The bitmap itself, one bit per dot | None |
Como funciona
^GF carrega um bitmap monocromático dentro do próprio formato, um bit por ponto. É o que um conversor gera ao transformar um logo ou uma página renderizada em ZPL, e é o motivo de etiquetas convertidas serem grandes: uma etiqueta de 4 × 6 polegadas a 300 dpi dá cerca de 700 KB em hexadecimal ASCII sem compressão.
O parâmetro de bytes por linha define a largura da imagem — oito pontos por byte, então uma imagem de 16 pontos de largura tem 2 bytes por linha. O total de bytes dividido por bytes por linha dá a altura. Errar qualquer um dos dois inclina a imagem na diagonal, que é o sintoma clássico de um ^GF mal formado.
O formato A é hexadecimal ASCII e é o mais portátil. Os formatos B e C enviam binário e binário comprimido, e a Zebra também aceita Z64, um payload comprimido com deflate e codificado em base64 que reduz muito o tamanho — é o que você quer para qualquer coisa grande passando por um link lento.
Exemplo
^XA
^FO40,40^GFA,32,32,2,FFFFC003A0059009881184218241818181818241842188119009A005C003FFFF^FS
^XZRenderizando…
O que o preview deste site faz com ele
Hexadecimal ASCII é desenhado corretamente. O parâmetro de formato ainda não é lido, então payloads binários, binários comprimidos e Z64 não aparecem no preview — o campo é desenhado como se os dados fossem hexadecimal puro.
Erros comuns
- Um valor de bytes por linha que não corresponde à largura da imagem. A figura sai inclinada.
- Larguras que não são múltiplas de 8. A linha é completada até o byte inteiro, então planeje a imagem em torno disso.
- Enviar muito hexadecimal sem compressão por link serial. Use Z64, ou guarde a imagem uma vez com ~DG e chame com ^XG.