Grafiche in ZPL – immagini GRF (^GF)

Foto, loghi e testo renderizzato diventano in ZPL bitmap monocromatici tramite il comando ^GF. zplCloud lo fa automaticamente (immagine → GRF, SVG → GRF, HTML/PDF → GRF).

Struttura di ^GF

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

Parametro	Significato
a	compressione: A = hex ASCII, B = binario, C = compresso (RLE)
b	byte totali della grafica (non compressa)
c	byte per riga (non compresso)
d	byte per riga dei dati reali (con compressione)
data	i dati dei pixel

Esempio (un quadrato nero 4×4, hex ASCII):

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

Convertire un'immagine in GRF

1. Scala l'immagine alla risoluzione dell'etichetta: widthPx = mm × DPI / 25,4.

2. Converti in monocromatico (soglia o dithering: zplCloud usa Floyd–Steinberg per le foto).

3. Compatta le righe: 1 bit per pixel, MSB prima, ogni riga riempita fino al limite di byte.

4. Codifica con la variante C (compressa) perché lo ZPL resti piccolo: tipicamente 1:4 sui codici, 1:2 sulle foto.

Suggerimenti

• Mantieni la GRF piccola: ogni dot costa byte. Una foto a colori a 600 dpi può saturare la memoria della stampante: usa 203 dpi o ritaglia.
• Le stampanti Zebra salvano le immagini GRF nella flash (~DYE:LOGO.GRF): caricala una volta e richiamala per nome invece di reinviare ^GF a ogni etichetta.
• La scheda Immagini Zebra di zplCloud gestisce le immagini GRF salvate sulla stampante.