Che cos’è ZPL? Guida al linguaggio Zebra per principianti
Scarichi un’etichetta di spedizione e vedi ^XA e ^FO invece di un’immagine. È ZPL: istruzioni che una stampante compatibile trasforma in testo, codici a barre e grafica. Puoi leggerle e visualizzarle prima di inviare qualcosa alla stampante.
Che cos’è ZPL?
ZPL significa Zebra Programming Language, un linguaggio di comandi sviluppato da Zebra per stampanti di etichette. Oggi ZPL indica generalmente ZPL II, la versione successiva documentata nei manuali attuali. Descrive dove posizionare testo, quale codice a barre disegnare e come aggiungere immagini, per etichette di spedizione, prodotti e inventario.
Con i prefissi predefiniti, i comandi di formato iniziano con ^ e quelli di controllo con ~. Un formato di etichetta inizia con ^XA e termina con ^XZ. Sono istruzioni, non un PDF o una fotografia: un motore di rendering o una stampante compatibile le interpreta per creare l’etichetta.
Come si presenta il codice ZPL?
Questo esempio minimo posiziona la parola Hello su un’etichetta. Copia solo il blocco di codice nel visualizzatore; le spiegazioni sono separate per mantenere il codice pronto all’uso.
^XA
^FO50,50
^A0N,40,40
^FDHello^FS
^XZ| Comando | Funzione |
|---|---|
^XA | Inizia un nuovo formato di etichetta. |
^FO50,50 | Imposta l’origine del campo a x = 50, y = 50 punti di stampa rispetto all’origine dell’etichetta. |
^A0N,40,40 | Seleziona il font 0, orientamento normale (N), con altezza e larghezza richieste di 40 punti di stampa, non 40 punti tipografici. |
^FDHello^FS | ^FD fornisce il testo Hello; ^FS termina il campo. |
^XZ | Termina il formato. In questo lavoro semplice la stampante può quindi produrre l’etichetta. |
Posizioni e dimensioni del font sono in punti di stampa, non millimetri. A 203 DPI, 50 punti sono circa 6,3 mm; a 300 DPI, circa 4,2 mm. L’esempio presuppone origine e orientamento abituali e non imposta dimensioni, rilevamento del supporto o calibrazione. Seleziona dimensioni e DPI reali nel visualizzatore e configura la stampante separatamente.
Che cos’è un file .zpl?
Un normale file .zpl è testo semplice contenente questi comandi, talvolta con più formati di etichetta. L’estensione indica l’uso previsto, ma non trasforma il file in un’immagine. Puoi aprirlo con Blocco note, VS Code o un altro editor di testo per leggere le istruzioni.
Per vedere l’etichetta invece del codice, apri il file in un visualizzatore ZPL. Salva le modifiche come testo semplice, non come documento Word. Rinominare un PDF in .zpl non lo converte. Alcuni flussi ZPL contengono dati binari di immagini o font, quindi non tutti i lavori sono interamente leggibili come testo.
Che cosa puoi fare con ZPL?
Inizia dall’esempio e scegli lo strumento per il passo successivo. L’anteprima permette di controllare il layout; la stampa fisica richiede anche una stampante compatibile, il supporto corretto e una connessione funzionante.
Visualizzare un’etichetta
Apri un file .zpl o incolla il codice per vedere il layout senza stampante.
Apri il visualizzatore ZPLModificare il modello
Modifica testo, posizioni e dimensioni nell’editor e controlla il risultato.
Apri l’editor ZPLEsportare in PDF
Crea un PDF da condividere o stampare con un flusso basato su documenti.
Converti ZPL in PDFAggiungere un logo
Trasforma un’immagine in dati grafici ZPL e inseriscila nell’etichetta.
Converti immagine in ZPLPer i loghi, ^GFA è il comando di campo grafico ^GF con A per selezionare i dati ASCII esadecimali. Seguono conteggi di byte, byte per riga e dati immagine codificati, non il nome di un PNG. Il convertitore prepara una grafica monocromatica. ^BC produce codici a barre Code 128; ^BQ produce codici QR.
Stampare l’etichetta
Invia ZPL come istruzioni dirette tramite software o utilità compatibili, come Zebra Setup Utilities per i modelli supportati. Stampare da un editor di testo può stampare il codice stesso. Controlla linguaggio, dimensioni e DPI, poi prova una sola etichetta prima di un lotto. L’anteprima del browser non stabilisce una connessione con la stampante.
ZPL e gli altri linguaggi di stampa
EPL e TSPL sono altri linguaggi per etichette con sintassi diverse. Un dispositivo può supportarne più di uno tramite firmware o emulazione, ma rinominare il file non traduce i comandi. Confronta ZPL ed EPL prima di riutilizzare un modello su un’altra stampante.
Domande frequenti
ZPL è gratuito o open source?
Puoi scrivere ZPL con un editor di testo e consultare la documentazione pubblica di Zebra. Questo non rende ZPL un progetto software open source. Editor, convertitori, font e software hanno licenze proprie e possono essere gratuiti o a pagamento.
Serve una stampante Zebra?
Non serve una stampante per leggere, modificare o visualizzare ZPL. Per stampare direttamente, usa una Zebra o un dispositivo che supporti esplicitamente i comandi richiesti. L’emulazione dipende da modello e firmware. Puoi anche esportare in PDF e stampare tramite un flusso PDF.
Come apro un file .zpl?
Usa un editor di testo per leggere i comandi o apri il file nel visualizzatore ZPL per vedere l’etichetta. Seleziona dimensioni e DPI previsti per un’anteprima utile.
Qual è la differenza fra ZPL e ZPL II?
ZPL II è la versione successiva del linguaggio ZPL originale di Zebra. Spesso viene abbreviato in ZPL. Per nuovi modelli segui la documentazione ZPL II supportata dal dispositivo; non presumere che tutti i vecchi comandi o modi della stampante si comportino allo stesso modo.
Fonti ufficiali
Informazioni sull'autore
Eduard Diaz
Eduard Diaz è tecnico IT (sviluppo) presso S-IE, partner ufficiale Zebra con oltre 20 anni nei servizi di identificazione ed etichettatura. Sviluppa e mantiene EditorZPL per rendere più facile il lavoro con ZPL e le stampanti di etichette Zebra.
s-ie.cat