printer protocol interpreter egl™ -...

Printer Protocol Interpreter EGL™Programmer’s Reference Manual for EGL, an Eltron® EPL® Printer Protocol Interpreter

Thermal Series Printers

Printer Protocol Interpreter EGL

Programmer’s Reference Manual for EGL, an Eltron EPL Printer Protocol Interpreter

Thermal Series Printers

Trademark AcknowledgmentsEltron, EPL, and Zebra are registered trademarks of Zebra Technologies Corporation.

T2N is a trademark of Printronix, Inc.

Printronix and PSA are registered trademarks of Printronix, Inc.

COPYRIGHT © 2013 PRINTRONIX, INC. All rights reserved.

Table of Contents

1 Introduction ........................................................... 7About this Manual .................................................................................. 7

EGL Overview........................................................................................ 7

2 Command Overview ............................................. 9Command List........................................................................................ 9

Ignored Configuration and Info Request Commands .......................... 12

Barcode Command Parameters/Types ............................................... 12

3 Command Descriptions....................................... 15Print Area............................................................................................. 15

Print Direction ...................................................................................... 16

Object Origins and Placement ............................................................. 16

Unit Selection....................................................................................... 17

Resident Fonts..................................................................................... 17

Downloaded Fonts............................................................................... 18

Character Sets..................................................................................... 18

Configuration Utility.............................................................................. 19

Print Direction ......................................................................... 19

Density.................................................................................... 20

Reference ............................................................................... 20

Code Page.............................................................................. 20

A Character Sets (8-Bit) ......................................... 21

B Character Sets (7-Bit) ......................................... 27

C Contact Information............................................. 31Printronix Customer Support Center.................................................... 31

Printronix Supplies Department ........................................................... 31

Corporate Offices................................................................................. 32

Table of Contents

1 Introduction

About this ManualThis manual explains the differences between the Printer Protocol Interpreter Eltron Graphic Language (EGL) Utility and the Eltron® EPL® language. Chapter 2 contains a table with commands listed based on syntax. The table categorizes the compatibility of the command as fully compatible, partially compatible, or not implemented. Chapter 3 describes the functionality of the commands and any differences between the EGL language and original EPL2 language. Use this manual with your T2N User’s Manual.

EGL OverviewEGL programs on a line by line basis, allowing for easy job creation. EGL supports barcodes, text, bitmaps and graphics. Each EPL2 line starts with one or more letters (indicating a command), and can be followed by one or more arguments separated by commas.

NOTE: Commands and arguments are case-sensitive.

EGL does not support “Line Mode” nor straight text printing. Line Mode is a legacy mode from EPL1. Data that is not part of a valid command are discarded.

7

Chapter 1 EGL Overview

8

2 Command Overview

This chapter lists all EPL2 supported commands and indicates if and how each command is supported in the EGL emulation. The commands are listed in alphabetical order with a letter in the compatibility column: F = Fully Supported, P = Partially Supported, and I = Ignored (absorbed). For information on Ignored commands, see page 12.

Command ListTable 1 lists the entire command summary. Other sections provide more details on particular commands and their supported parameters.

Table 1. Command Summary

Command Description Compatibility

A Prints an ASCII string F

AUTOFR Automatic Form Printing F

B Prints 1D barcode F

b Prints 2D barcode F

C Counter F

C CUT immediate F

D Density F

dump Enable Dump Mode F

EI Print Soft Font Information F

EK Delete Soft Font F

eR User Defined Error/Status Character F

ES Store Soft Font F

f Cut position F

FE End Form Store F

FI Print Form Information F

FK Delete Form F

9

Chapter 2 Command List

FR Retrieve Form F

FS Store Form F

GG Print Graphics F

GI Print Graphics Information F

GK Delete Graphics F

GM Store Graphics F

GW Direct Graphic Write F

I Character Set Selection P

JB Disable Top Of Form Backup F

JC Disable Top Of Form Backup - All Cases F

JF Enable Top Of Form Backup F

LE Line Draw Exclusive OR F

LO Line Draw Black F

LS Line Draw Diagonal F

LW Line Draw White F

M Memory Allocation I

N Clear Image Buffer F

o Cancel Software Options F

oB Cancel Auto Bar Code Optimization I

oE Line Mode Font Substitution I

oH Macro PDF Offset I

oM Disable Initial Esc Sequence Feed F

oR Character Substitution (Euro) F

oW Customize Bar Code Parameters I

O Hardware Option F

OC CUTTER MODE F

OEPL1 Set Line Mode I

OP PEEL MODE F

P Print F



10

PA Print Automatic F

q Set Label Width F

Q Set Form Width F

r Set Double Buffer Mode F

R Set Reference Point F

S Speed Select F

TD Date Recall & Formal Layout F

TS Set Real Time Clock F

TT Define Date Layout (& Print Date) F

U Print Configuration (General) F

UA Enable Clear Label Counter Mode F

UB Reset Label Counter Mode F

UE External Font Information Inquiry F

UF Form Information Inquiry F

UG Graphics Information Inquiry F

UI Host Prompts/Codepage Inquiry F

UM Codepage & Memory Inquiry F

UN Disable Error Reporting I

UP Codepage & Memory Inquiry/Print F

UQ Configuration Inquiry F

US Enable Error Reporting I

U% Host Prompts/Motor Temperature I

U$ Host Prompts/Battery Status I

V Define Variable F

W Windows Mode F

xa AutoSense media F

X Box Draw F

Y Serial Port Setup F

Z Print Direction F



11

Chapter 2 Ignored Configuration and Info Request Commands

Ignored Configuration and Info Request CommandsSome configuration commands are ignored because they are printer or architecture specific. For example, command U% deals with motor temperature which may be used for setup purposes with Eltron or Zebra printers, but are not generally found within job streams.

Barcode Command Parameters/TypesTable 2 lists the barcodes and types supported.

? Download Variables F

^@ Reset Printer F

^default Set Printer to Factory Defaults F

^ee Status Report - Immediate F

; Code Comment Line F



Table 2. Barcode Parameters and Types


B Prints 1D barcode F

3 Code 39 std. or extended F

3C Code 39 with check digit F

9 Code 93 F

0 Code 128 UCC Serial Shipping Container Code

F

1 Code 128 auto A, B, C modes F

1A Code 128 mode A F

1B Code 128 mode B F

1C Code 128 mode C F

1D Code 128 with Deutsche Post check digit I

K Codabar F

E80 EAN8 F

12

E82 EAN8 2 digit add-on F


E30 EAN13 F



2G German Post Code I

2 Interleaved 2 of 5 F

2C Interleaved 2 of 5 with mod 10 check digit F

2D Interleaved 2 of 5 with human readable check digit

F

P Postnet 5, 9, 11, and 13 digit F

PL Planet 11 and 13 digit I

J Japanese Postnet I

1E UCC/EAN 128 F

UA0 UPC A F

UA2 UPC A 2-digit add-on F

UA5 UPC A 5 digit add-on F

UE0 UPC A F



UE0 UPC E F

UE2 UPC E 2 digit add-on F

EU5 UPC E 5 digit add-on F

2U UPC Interleaved 2 of 5 I

L Plessy (MSI-1) with mod 10 check digit F

M MSI-3 mode 10 check digit F

b Prints 2D barcode F

D Data Matrix F

M Maxi Code F

P PDF-417 F

Table 2. Barcode Parameters and Types


13

Chapter 2 Barcode Command Parameters/Types

14

3 Command Descriptions

Print AreaWhen looking at the front of the printer, by default the origin of the label is positioned at the lower-right of the label, and extends up and to the left as shown in Figure 1. This is known as “Head First” since the beginning of the form comes out first.

Figure 1. Print Area and Origins

EGL has a "Reference" option that can be set to shift the origin of the label by a specific number of horizontal and vertical dots. Figure 1 illustrates this case with a Reference value of (30, 30).

NOTE: When the label elements get shifted, some graphic elements can get clipped as a result.

Physical page rotation is not available with EGL. When rotation is needed, each object should be rotated individually.

NOTE: The location of each graphic, barcode, or text element is based on its logical upper-left corner as described in “Object Origins and Placement” on page 16. When the object is rotated, the origin rotates with it.

Origin of Label (0,0)With Reference (0,0)

Origin of Label (0,0)With Reference (30,30)

Clipped areas

15

Chapter 3 Print Direction

Print DirectionWith EGL, print direction (head first or foot first) is configurable with the Z command. Changing this option affects how the labels feed out of the printer as shown in Figure 2.

Figure 2. Print Direction

Label feed print direction can also be controlled from the Configuration Utility, EGL tab, Print Direction option (refer to the User’s Manual).

Object Origins and Placement

As shown in Figure 3, the origin of text, graphics, and barcodes is the upper-left corner of the object. When the objects are rotated, the origin rotates with the object.

Figure 3. Origin of Objects within a Form

Print Direction = 0Origin of Form (0,0)

Print Direction = 1Origin of Form (0,0)

16

Unit SelectionPositioning of the page elements (text, barcodes etc.) is in dots. This cannot be changed.

Resident FontsThe standard EPL2 printer has five resident monospaced dot fonts, numbered 1-5. Each font is a different size and can be expanded horizontally and vertically. Fonts A-Z and a-z (upper and lowercase alpha characters) are reserved for downloading Soft Fonts.

The following image illustrates the five different font selections.

Font Parameter

203 DPI 300 DPI

1 20.3 cpi, 6 pts, (8 x 12 dots)

25 cpi, 4 pts,(12 x 20 dots)

2 16.9 cpi, 7 pts,(10 x 16 dots)

18.75 cpi, 6 pts,(16 x 28 dots)

3 14.5 cpi, 10 pts,(12 x 20 dots)

15 cpi, 8 pts,(20 x 36 dots)

4 12.7 cpi, 12 pts,(14 x 24 dots)

12.5 cpi, 10 pts,(24 x 44 dots)

5 5.6 cpi, 24 pts,(32 x 48 dots)

6.25 cpi, 21 pts,(48 x 80 dots)

A-Z, a-z Reserved for Soft Fonts Reserved for Soft Fonts

17

Chapter 3 Downloaded Fonts

Downloaded FontsThe EGL emulation supports downloading Soft Fonts to font parameter locations A-Z and a-z. The fonts are stored into FLASH. Commands used for download fonts are ES command for download, EI command to print out the Soft Fonts currently in the printer, and EK to delete downloaded fonts. The Soft Font data is in a proprietary format and defined with the EPL Programming Guide.

Character SetsThe EGL character is selected with the I command. The command syntax is IP1,P2,P3 with three parameters. Parameter P1 specifies whether to use 7 or 8 bit data, parameter P2 selects the code page, and parameter P3 selects a KDU country code which is not supported in this product; this command is marked as “P” for partially compatible.

P1 = 8 (8 bit data) P1 = 7 (7 bit data)

P2 Value Codepage Description P2 Value Description

0 DOS 437 English - US 0 USA

1 DOS 850 Latin 1 1 British

2 DOS 852 Latin 2 (Cyrillic II/Slavic) 2 German

3 DOS 860 Portuguese 3 French

4 DOS 863 French Canadian 4 Danish

5 DOS 865 Nordic 5 Italian

6 DOS 857 Turkish 6 Spanish

7 DOS 861 Icelandic 7 Swedish

8 DOS 862 Hebrew 8 Swiss

9 DOS 855 Cyrillic

10 DOS 866 Cyrillic CIS 1

11 DOS 737 Greek

12 DOS 851 Greek 1

13 DOS 869 Greek 2

A Windows 1252 Latin 1

B Windows 1250 Latin 2

C Windows 1251 Cyrillic

18

A default character set can be chosen using the Configuration Utility, Code Page option as described in “Configuration Utility” on page 19. See Appendix A on page 21 for an overview of characters in each of the sets.

Configuration UtilitySetup options are controlled within the Configuration Utility program. The EGL tab of the Configuration Utility is shown in Figure 4 with factory default settings. Descriptions of each option follows.

Figure 4. EGL Setup

Print DirectionPrint Direction defines the feed:

• 0 (factory default). Feeds label head first.

• 1. Feeds label foot first.

D Windows 1253 Greek

E Windows 1254 Turkish

F Windows 1255 Hebrew

P1 = 8 (8 bit data) P1 = 7 (7 bit data)

P2 Value Codepage Description P2 Value Description

19

Chapter 3 Configuration Utility

DensityThis option controls the print density (darkness) of the output. The range is 0 to 15 and the factory default is 8.

ReferenceThis option defines the origin of the image relative to the label. The first entry defines the horizontal (x) offset and the second entry defines the vertical (y) offset. The default is (0, 0).

Code PageThis option defines the current character set selection. The options are as follows:

USA, BRI, GER, FRE, DAN, ITA, SPA, SWE, SWI, CP 437, CP 437, 850 (factory default), 852, 860, 863, 865, 857, CP 861, 862, 855, 866, 737, 851, 869, CP 1252, 1250, 1251, 1253, 1254, 1255.

20

A Character Sets (8-Bit)

DOS 437 (P1=8, P2=0) DOS 850 (P1=8, P2=1)

DOS 852 (P1=8, P2=2) DOS 860 (P1=8, P2=3)

21

Appendix A

DOS 863 (P1=8, P2=4) DOS 865 (P1=8, P2=5)

22

DOS 862 (P1=8, P2=8) DOS 855 (P1=8, P2=9)

DOS 866 (P1=8, P2=10) DOS 737 (P1=8, P2=11)

23

Appendix A

DOS 851 (P1=8, P2=12) DOS 869 (P1=8, P2=13)

Windows 1252 (P1=8, P2=A) Windows 1250 (P1=8, P2=B)

24

Windows 1251 (P1=8, P2=C) Windows 1253 (P1=8, P2=D)

Windows 1254 (P1=8, P2=E) Windows 1255 (P1=8, P2=F)

25

Appendix A

26

B Character Sets (7-Bit)

USA(P1=7, P2=0) British (P1=7, P2=1)

German (P1=7, P2=2) French (P1=7, P2=3)

27

Appendix B

Danish (P1=7, P2=4) Italian (P1=7, P2=5)

Spanish (P1=7, P2=6) Swedish (P1=7, P2=7)

28

Swiss (P1=7, P2=8)

29

Appendix B

30

C Contact Information

Printronix Customer Support CenterIMPORTANT Please have the following information available prior to calling the

Printronix Customer Support Center:

• Model number

• Serial number (located on the back of the printer)

• Installed options (i.e., interface and host type if applicable to the problem)

• Configuration printout: Refer to the Quick Setup Guide or User’s Manual.

• Is the problem with a new install or an existing printer?

• Description of the problem (be specific)

• Good and bad samples that clearly show the problem (faxing or emailing these samples may be required)

Americas (714) 368-2686

Europe, Middle East, and Africa (31) 24 6489 311

Asia Pacific (65) 6548 4114

China (86) 800-999-6836

http://www.printronix.com/public/support.aspx

Printronix Supplies DepartmentContact the Printronix Supplies Department for genuine Printronix supplies.

Americas (800) 733-1900

Europe, Middle East, and Africa 33 (0) 1 46 25 19 07

Asia Pacific (65) 6548 4116 or (65) 6548 4182

China (86) 400-886-5598

India (800) 102-7869

http://www.printronix.com/supplies-parts.aspx

31

http://www.printronix.com/public/servicessupport/default.aspx

http://www.printronix.com/public/supplies/default.aspx

Appendix C Corporate Offices

Corporate OfficesPrintronix, Inc. 15345 Barranca Parkway Irvine, CA 92618 U.S.A. Phone: (714) 368-2300 Fax: (714) 368-2600

Printronix Inc. c/o Printronix Nederland BV Bijsterhuizen 11-38 6546 AS Nijmegen The Netherlands Phone: (31) 24 6489489 Fax: (31) 24 6489499

Printronix Schweiz GmbH 42 Changi South Street 1 Changi South Industrial Estate Singapore 486763 Phone: (65) 6542 0110 Fax: (65) 6546 1588

Printronix Commercial (Shanghai) Co. Ltd 22F, Eton Building East No.555, Pudong Av. Shanghai City, 200120, P R China Phone: (86) 400 886 5598 Fax: (86-21) 5138 0564

Visit the Printronix web site at www.printronix.com

32

http://www.printronix.com/

257373-001A

*257373-001*

printer protocol interpreter egl™ -...

Documents