Toolmaker Produkt-Dokumentation
Zebra4i Funktionen
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) +
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) +
dcl-s YBCD1 char(9);
YBCD1 = '044774215';ZPL_BarCode(count:'(*bcdtype=2OF5INT) + +YBCD1+') +
(*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: