Gráficos em ZPL – imagens GRF (^GF)

Fotos, logos e texto renderizado viram em ZPL bitmaps monocromáticos através do comando ^GF. O zplCloud faz isso automaticamente (imagem → GRF, SVG → GRF, HTML/PDF → GRF).

Estrutura do ^GF

^GFa,b,c,d,data^FS

Parâmetro	Significado
a	compactação: A = hex ASCII, B = binário, C = compactado (RLE)
b	total de bytes do gráfico (sem compactação)
c	bytes por linha (sem compactação)
d	bytes por linha dos dados reais (com compactação)
data	os dados dos pixels

Exemplo (um quadrado preto 4×4, hex ASCII):

^XA
^FO50,50^GFA,8,8,2,FFFFFFFF^FS
^XZ

Converter uma imagem em GRF

1. Dimensione a imagem para a resolução da etiqueta: widthPx = mm × DPI / 25,4.

2. Converta em monocromático (limiar ou pontilhado: o zplCloud usa Floyd–Steinberg para fotos).

3. Empacote as linhas: 1 bit por pixel, MSB primeiro, cada linha preenchida até o limite de byte.

4. Codifique com a variante C (compactada) para o ZPL ficar pequeno: tipicamente 1:4 em códigos, 1:2 em fotos.

Dicas

• Mantenha a GRF pequena: cada ponto custa bytes. Uma foto colorida a 600 dpi pode estourar a memória da impressora: use 203 dpi ou corte.
• Impressoras Zebra guardam imagens GRF na flash (~DYE:LOGO.GRF): carregue uma vez e referencie pelo nome em vez de reenviar ^GF a cada etiqueta.
• A guia Imagens Zebra do zplCloud gerencia imagens GRF salvas na impressora.