Inhaltsübersicht

Nachfolgend werden die einzelnen Zebra4i Funktionen beschrieben.

Die Parameter können in beliebiger Reihenfolge eingegeben werden. Die Groß-/Kleinschreibung ist beliebig. Die Muss-Parameter sind fett/kursiv hinterlegt.

Funktion ZPL_CreateLabel

Mit dieser Funktion wird ein neues ZPL-Etikett erzeugt.

Count Integer 10i 0 Darin wird die Satznummer zurückgegeben. Bei dieser Funktion immer die 1.

*Labelname -    IFS-Pfad und Name des Etiketts. Empfohlen xxxxx.txt.

*Zplcmd - Steuerung der Codepage mit ^CIxx, wobei xx=31 die Codepage 1250 setzt (getestet mit Drucker Zebra GX430t). Default ist der Standardwert der Firmware im Drucker (z.B. 850).

*HomePosX -   Horizontale Startposition.

*HomePosY - Vertikale Startposition.

Beispiel eines Etiketts mit Namen  /home/gsc/ZPLTest.txt, die Codepage wird mit *zplcmd = ^CI31 auf 1250 für deutsche Umlaute gesetzt:

ZPL_CreateLabel(count:'(*Labelname=/home/gsc/'filename') +
                       (*zplcmd =^CI31) +
                       (*homePosx=100) +
                       (*homeposy=10)');

Funktion ZPL_CloseLabel

Mit dieser Funktion muss das Etikett geschlossen werden.

Count  Integer in dem die nächste Satznummer steht. Wird automatisch fortgezählt.

*STOREGRF - Name unter welchem das Etikett im Drucker-Memory gespeichert werden soll. Mit ZPL_Image kann es wieder geladen und dann weiter aufbereitet werden.

Memory - Memory des Druckers:

R=DRAM (default)
A=Compact flash memory
B=Flash card (PCMCIA)
E=Internal flash memory

*PRINT - YES wenn die Datei nach dem Speichern auch gedruckt werden soll.

Beispiel eines Abschlusses mit Speicherung als Sample.GRF.

ZPL_CloseLabel(count:'(*storegrf=Sample.grf) ');

Funktion ZPL_TextLine

Mit dieser Funktion wird eine Zeichenkette (ein oder mehrere Zeichen oder Wörter) als Textzeile erzeugt.

Count  Integer in dem die nächste Satznummer steht. Wird automatisch fortgezählt.

*Text - Text als Konstante oder Feld. Wenn das Feld in ZPL_TextLine leer ist, wird ZPL_TextLine nicht ausgeführt. Es empfielt sich, ein Datenfeld mit 3 Hochkommata (vorn und hinten) zu übergeben, damit Steuerzeichen wie "()*=" auch als Text gedruckt werden.

Beispiel für Feldname TEXT1: ZPL_TextLine(count:'(*text='''%trim(TEXT1)''') +

*PosX -  Horizontale Position des Textes entsprechend der gewählten Einheiten. (Siehe Dimension).

*PosY - Vertikale Position des Textes entsprechend der gewählten Einheiten und Richtung. (Siehe Dimension und Direction).

*Font - Schriftart. Zur Verfügung stehende Fonts werden mit ZPL_Info angelistet. Default = A

*Height - Größe der Schrift. 10-32000. Default = 9

*Width - Breite der Schrift. 10-32000. Default = 5

*Orientation - Orientierung. N = Normal, R = 90°, I = 180°, B = 270°, Hinweis: Bei B (270°) ist das interne Koordinatensystem gedreht und es können unerwünschte Effekte auftreten (z.B. rechtsbündig statt linksbündig).

Beispiel eines Textes, der 50 Dots vom linken Rand und 100 Dots vom oberen Rand steht.

ZPL_TextLine(count:'(*text=2OF5INT) +
                    (*posx=50) +
                    (*posy=100) +
                    (*font=D) +
                    (*orientation=N) +
                    (*height=36) +
                    (*width=20)');

Funktion ZPL_TextLineReverse

Die Parameter dieser Funktion sind identisch mit denen der zuvor beschriebenen Funktion ZPL_TextLine. Der Text wird nur "umgekehrt" (reverse) - also im Regelfall weiß - gedruckt.

Beispiel

In diesem Beispiel wird der Inhalt der Variablen ETITEXT1 ("665") umgekehrt gedruckt:

// -------------------------------------------------------------------------
// zuerst an der Stelle, an der der Text gedruckt werden soll einen
// schwarzen Balken platzieren
// -------------------------------------------------------------------------
ZPL_DrawBox(ycount : '(*width     =90)   +
                      (*height    =180)  +
                      (*posx      =350)  +
                      (*posy      =2970) +
                      (*thickness =90)' ');

// -------------------------------------------------------------------------
// dann an genau der Stelle den Text aus der Variablen ETITEXT1 
// hinzufügen
// -------------------------------------------------------------------------
ZPL_TextLineReverse(ycount : '(*text        ='+ETITEXT1+') +
                              (*posx        =350)          +
                              (*posy        =3000)         +
                              (*font        =D)            +
                              (*orientation =R)            +
                              (*height      =80)           +
                              (*width       =40)');

Funktion ZPL_DrawBox

Mit dieser Funktion wird ein Rechteck oder eine Linie erzeugt.

Count  Integer in dem die nächste Satznummer steht. Wird automatisch fortgezählt.

*PosX - Horizontale Position des Rechtecks in Dots.

*PosY - Vertikale Position des Rechtecks in Dots.

*Width - Breite des Rechtecks in Dots. Default=1.

*Height - Höhe des Rechtecks in Dots. Default=1.

*Color - Farbe des Rahmens B=Schwarz, W=Weiß. Default=B.

*Thickness - Stärke des Rahmens. Default ist 1.

*Rounding - Abrundung der Ecken. Wert von 0 bis 8. Default ist 0, keine Abrundung.

Beispiel einer Box:

ZPL_DrawBox(count:'(*width =700) +
                   (*height =200) +
                   (*thickness=10) +
                   (*posx =30) +
                   (*posy =40)');

Beispiel einer Linie:

ZPL_DrawBox(count:'(*width =700) +
                   (*height =0) +
                   (*thickness=5) +
                   (*posx =30) +
                   (*posy =300)');

Funktion ZPL_Diagonal

Mit dieser Funktion wird eine diagonale Linie gezogen.

Count Integer in dem die nächste Satznummer steht. Wird automatisch fortgezählt.

*PosX - Horizontale Position der Diagonale in Dots.

*PosY - Vertikale Position der Diagonale in Dots.

*Width - Breite des gedachten Rechtecks in Dots. Default = 1.

*Height - Höhe des gedachten Rechtecks in Dots. Default = 1.

*Color - Farbe des Rahmens B=Schwarz, W=Weiß. Default = B.

*Thickness - Stärke des Rahmens. Default ist 1.

*Orientation - Orientierung. R=Nach rechts oben, L=Von links oben nach unten. Default = R.

Beispiel einer Diagonale nach rechts oben:

ZPL_Diagonal(count:'(*width =700) +
                    (*height =200) +
                    (*thickness =5) +
                    (*orientation=R) +
                    (*posx =30) +
                    (*posy =500)');

Funktion ZPL_Image

Mit dieser Funktion wird ein Bild eingefügt. Das Bild wird vorher im Druckerspeicher mit Hilfe des Parameters STOREGRF abgelegt.

Count Integer in dem die nächste Satznummer steht. Wird automatisch fortgezählt.

*Name - Name des Bildes. 1-8 Stellen.

*Memory - Memory of the Printer.

R= DRAM (default)
A= Compact flash memory
B= Flash card (PCMCIA)
E= Internal flash memory

Funktion ZPL_Circle

Mit dieser Funktion wird ein Kreis erzeugt.

Count Integer in dem die nächste Satznummer steht. Wird automatisch fortgezählt.

*PosX - Horizontale Position des Kreises in Dots.

*PosY - Vertikale Position des Kreises in Dots.

*Diameter - Durchmesser des Kreises in Dots. Default=1.

*Color - Farbe des Rahmens B=Schwarz, W=Weiß. Default=B.

*Thickness - Stärke des Rahmens. Default ist 1.

Beispiel eines Kreises:

ZPL_Circle(count:'(*diameter = 24) +
(*thickness=12) +
(*color =W) +
(*posx =57) +
(*posy =44)');

Funktion ZPL_Ellipse

Mit dieser Funktion wird eine Ellipse erzeugt.

Count Integer in dem die nächste Satznummer steht. Wird automatisch fortgezählt.

*PosX - Horizontale Position der Ellipse in Dots.

*PosY - Vertikale Position der Ellipse in Dots.

*Width - Breite der Ellipse in Dots. Default = Wert von Thickness oder 1.

*Height - Höhe der Ellipse in Dots. Default = Wert von Thickness oder 1.

*Color - Farbe des Rahmens B=Schwarz, W=Weiß. Default = B.

*Thickness - Stärke des Rahmens. Default ist 1.

Beispiel einer Ellipse:

ZPL_Ellipse(count:'(*width =500) +
(*height =200) +
(*thickness=5) +
(*posx =190) +
(*posy =400)');

Funktion ZPL_Graphic

Mit dieser Funktion wird eine Grafik eingefügt. Diese wird vorher im Druckerspeicher mit Hilfe der Zebra Setup Utility im Speicher des Druckers abgelegt. Eine detaillierte Anleitung dazu unter:

{*}https://km.zebra.com/kb/index?page=content&id=SO7892*

Count Integer in dem die nächste Satznummer steht. Wird automatisch fortgezählt.

*Name - Name des Bildes. 1-8 Stellen

*PosX - X-Position in Dots

*PosY - Y-Position in Dots

*Memory - Memory of the Printer.

R=DRAM (default)
A=Compact flash memory
B=Flash card (PCMCIA)
E=Internal flash memory

Ein Beispiel eines Firmenlogos finden Sie in den Musterprogrammen.

Funktion ZPL_Barcode

Mit dieser Funktion wird ein Barcode eingefügt.

Count Integer in dem die nächste Satznummer steht. Wird automatisch fortgezählt.

*bcdtype - Type des Barcodes. (z. B. EAN13 etc. siehe Tabelle)

*bcdvalue - Enthält den Wert in alpha, der als Barcode dargestellt werden soll.

*posX - X-Position des Barcodes links/oben im Etikett. Achtung! Auch wenn topdown angegeben ist wird links/unten und nicht links/oben angenommen.

*posY - Y-Position des Bildes links/oben im Etikett.

Die folgenden Parameter werden in den meisten Barcodes verwendet.

Wenn in der folgenden Tabelle keine weiteren Parameter für einen Barcode-Typ angegeben sind, dann gibt es nur diese vier Parameter für ihn:

*orientation= Ausrichtung. N=Normal, R=90°, I=180°, B=270°. Default = N.

*height - Barcodehöhe in Dots. Wert 1-32000.

*width -  Barcodebreite

*print - Interpretation Y oder N. Default = Y.

*printabove - Interpretation oberhalb Y oder N. Default = N.

Tabelle Barcode Typ Parameter bcdtype

Beispiele für Barcode-Anweisungen:

ZPL_BarCode(count:'(*bcdtype=CODE39) +
                   (*bcdvalue  =12345678) +
                   (*posx      =50) +
                   (*height    =100) +
                   (*width     =3) +
                   (*print     =Y) +
                   (*posy      =200)');

dcl-s YBCD1    char(9);
YBCD1 = '044774215';
ZPL_BarCode(count:'(*bcdtype=2OF5INT) +
                   (*bcdvalue    ='+YBCD1+') +
                   (*posx        =400) +
                   (*posy        =65) +
                   (*width       =5) +
                   (*height      =100) +
                   (*print       =N) +
                   (*mod10       =Y) +
                   (*orientation =R) ');

Funktion ZPL_Info

Druckt ein Verzeichnis der Objekte (z.B. Schriftarten), die in einem Drucker gespeichert sind.

Count Integer 10i 0  - Anzahl der gefundenen Objekte

String Char 32.767  - Auszugebende Informationen

Beispiel:

ZPL_Info(count : '(*Name=*) (*Memory=*) (*Ext=*)');

Das ZPL II - Handbuch

Weitere Informationen zur unterliegenden Sprache ZPL II finden Sie im Handbuch der FIrma ZIH Corooration: