Select your printer model
Parameters are refined by the selected printer.
- EU-m30
- TM-J2000
- TM-J2100
- TM-L90
- TM-L90 LFC
- TM-L100
- TM-m10
- TM-m30
- TM-m30II
- TM-m30II-H
- TM-m30III
- TM-m30III-H
- TM-m30II-NT
- TM-m30II-S
- TM-m30II-SL
- TM-m50
- TM-m50II
- TM-m50II-H
- TM-P20
- TM-P20II
- TM-P60
- TM-P60II
- TM-P80
- TM-P80II
- TM-T20
- TM-T20II
- TM-T20III
- TM-T20IIIL
- TM-T20IV-L
- TM-T20X
- TM-T20X-II
- TM-T70
- TM-T70II
- TM-T81III
- TM-T82II
- TM-T82III
- TM-T82IIIL
- TM-T82IV-L
- TM-T82X
- TM-T82X-II
- TM-T83III
- TM-T83IV
- TM-T88IV
- TM-T88V
- TM-T88VI
- TM-T88VII
- TM-T90
- TM-T100
- TM-U220
- TM-U220II
- TM-U230
GS ( L / GS 8 L
[Name]
Set graphics data
[Format]
ASCII
|
|
GS
|
|
(
|
|
L
|
|
pL
|
|
pH
|
|
m
|
|
fn
|
|
[parameters]
|
Hex
|
1D
|
28
|
4C
|
pL
|
pH
|
m
|
fn
|
[parameters]
|
||||||||
Decimal
|
29
|
40
|
76
|
pL
|
pH
|
m
|
fn
|
[parameters]
|
ASCII
|
|
GS
|
|
8
|
|
L
|
|
p1
|
|
p2
|
|
p3
|
|
p4
|
|
m
|
|
fn
|
|
[parameters]
|
Hex
|
1D
|
38
|
4C
|
p1
|
p2
|
p3
|
p4
|
m
|
fn
|
[parameters]
|
||||||||||
Decimal
|
29
|
56
|
76
|
p1
|
p2
|
p3
|
p4
|
m
|
fn
|
[parameters]
|
[Description]
Processes graphics data.
-
Function code fn specifies the function.
-
fnFunction No.Function name0, 48Transmit the NV graphics memory capacity.1, 49Set the reference standard dot density for graphics.2, 50Print the graphics data in the print buffer.3, 51Transmit the remaining capacity of the NV graphics memory.4, 52Transmit the remaining capacity of the download graphics memory.64Transmit the key code list for defined NV graphics.65Delete all NV graphics data.66Delete the specified NV graphics data.67Define the NV graphics data (raster format).68Define the NV graphics data (column format).69Print the specified NV graphics data.80Transmit the key code list for defined download graphics.81Delete all download graphics data.82Delete the specified download graphics data.83Define the download graphics data (raster format).84Define the download graphics data (column format).85Print the specified download graphics data.112Store the graphics data in the print buffer (raster format).113Store the graphics data in the print buffer (column format).
-
pL and pH specify the number of bytes following m as (pL + pH × 256).
-
p1, p2, p3, and p4 specify the number of bytes following m as (p1 + p2 × 256 + p3 × 65536 + p4 × 16777216).
-
The [parameters] are described in each function.
[Differences between GS ( L and GS 8 L]
-
All commands possess the same functions for "Graphics data processing".
-
Specifications (conventions) concerning function code (fn) are identical, while only the parameters (pL, pH, p1, p2, p3, and p4) used to specify the parameter values from m differ.
-
CommandFeatureParametersStructureMaximum valueParameter value is 2 bytes less than that for GS ( L / GS 8 L.Used when sending data divided into blocks.pL, pH2 bytes65,535Possesses powerful range of expression.Used for batch transfer of large volumes of data.p1, p2, p3, p44 bytes4,294,967,295
-
Be sure to use GS ( L / GS 8 L when the parameter value exceeds 65535 bytes for GS ( L / GS 8 L <Function 67> , GS ( L / GS 8 L <Function 68> , GS ( L / GS 8 L <Function 83> , GS ( L / GS 8 L <Function 84> , GS ( L / GS 8 L <Function 112> , and GS ( L / GS 8 L <Function 113> .
[Recommended Functions]
-
This command is recommended for use when printing image data.
-
The image processing controlled using this command is referred to as the "Graphics function". The name is important as it distinguishes it from conventional bit image functions.
-
The graphics functions provided here maintain upward compatibility with conventional bit image processing.
-
Graphics typeCorresponding bit image command (∗1)NV graphicsDownload graphicsGraphics
-
(∗1) These commands are supported by some of the printer models but will not be supported by future models.
-
The various graphics functions (of this command), more user-friendly than conventional bit image functions, offer the following advantages.
-
-
Definition of multiple items of logo mark and insignia data (with most functions).
-
Management of data using key codes.
-
Deletion of and redefinition of data per key code.
-
Color coding of image-data.
-
Definition of image-data in both raster and column formats.
-
Confirmation of available capacity in domain.
-
Continuous processing possible (without a software reset when a command has been processed).
-
-
The following three types of graphics functions are included.
-
-
Stores data in non-volatile memory.
-
Defined data is retained when power is turned off.
-
There is a limit on the number of times that non-volatile memory can be written to.
-
Download graphics [GS ( L <Function 52> , GS ( L <Function 80> , GS ( L <Function 81> , GS ( L <Function 82> , GS ( L / GS 8 L <Function 83> , GS ( L / GS 8 L <Function 84> , and GS ( L <Function 85> ]
-
Stores data in volatile memory (RAM).
-
Defined data is deleted when the printer is reset, or power is turned off.
-
Some models delete the defined data when ESC @ command is executed.
-
Graphics [GS ( L <Function 50> , GS ( L / GS 8 L <Function 112> , and GS ( L / GS 8 L <Function 113> ]
-
Stores data in the print buffer.
-
When Standard mode is selected, prints data using GS ( L <Function 50> and clears the print buffer.
-
when Page mode is selected, prints data using FF (in Page mode) and ESC FF and clears the print buffer after FF (in Page mode) is executed.
[Notes]
-
The functions of this command are determined by the (fn) setting. Actual command operation varies according to function.
-
The NV graphics and download graphics data is managed using key codes.
-
-
Expressed as kc1 and kc2, the key codes are used to identify data groups.
-
The key codes have a 2-byte configuration and can be specified using the full range of character codes in Hexadecimal: 20h – 7Eh / in Decimal: 32 – 126.
-
The data referred to here is image data specified using d1 through dk of GS ( L / GS 8 L <Function 67> , GS ( L / GS 8 L <Function 68> , GS ( L / GS 8 L <Function 83> , and GS ( L / GS 8 L <Function 84> .
-
The printer automatically adds control information when it stores the data. The image data domain is used as the control information. Control information formats and data values vary according to function.
-
-
Note that it is not possible to create definitions for both NV graphics data (this command) and NV bit image data (FS q [obsolete command] ). NV bit image data definitions are deleted when this command is used.
-
Note that it is not possible to create definitions for both download graphics data (this command) and download bit image data (GS * [obsolete command] ). Download bit image data definitions are deleted when this command is used.
-
With certain printers, it is not possible to create definitions for both download graphics data (this command) and download character data (ESC &).
-
-
Defined download character data is deleted when this command is used.
-
Executing ESC & deletes download graphics data.
-
-
Always execute GS ( L <Function 50> after executing GS ( L / GS 8 L <Function 112> or GS ( L / GS 8 L <Function 113> when the Standard mode is selected.
-
When printing the various types of graphics data, using the ESC U command will ensure that the printed results are properly aligned vertically by printing in a single direction.
-
GS ( L <Function 65> , GS ( L <Function 66> , GS ( L / GS 8 L <Function 67> , or GS ( L / GS 8 L <Function 68> write data to a non-volatile memory. Note the following items when using the function.
-
-
Do not turn off the power or reset the printer from the interface when the relevant functions are being executed.
-
The printer may be BUSY when storing data and will not receive any data. In this case, be sure not to transmit data from the host.
-
Excessive use of this function may destroy the non-volatile memory. As a guideline, do not use any combination of the following commands more than 10 times per day for writing data to the non-volatile memory: GS ( A (part of functions), GS ( C (part of functions), GS ( E (part of functions), GS ( L / GS 8 L (part of functions), GS ( M (part of functions), GS g 0, FS g 1 [obsolete command] , FS q [obsolete command] .
-
-
The following restrictions apply when performing non-volatile memory operations (including data store and delete).
-
-
The paper cannot be fed by paper feed switch.
-
The real time command is not processed.
-
The ASB status will not be sent, even when the ASB function is set to enable.
-
[Notes for transmission process]
-
Data send operations are performed using GS ( L <Function 48> , GS ( L <Function 51> , GS ( L <Function 52> , GS ( L <Function 64> , and GS ( L <Function 80> . When you use these functions, obey the following rules.
-
-
When the host PC transmits the function data, transmit the next data after receiving the corresponding data (Header – NUL) from the printer.
-
When operating with a serial interface, be sure to configure operation so that the host computer uses the printer only when it is READY.
-
When operating with a parallel interface, the data sent by this function (starting with Header and ending with NUL), as with other data, is first stored in the send buffer, then output in sequential order when the host computer changes to the reverse mode. Note that the send buffer capacity is 99 bytes, and any data exceeding this volume limit will be lost; therefore, when using this command, it is important to configure the operation so that the host computer's change to the reverse mode and the subsequent status send/receive process is performed quickly.
-
-
During the interval between the sending of the data header and NUL, ASB status and the real time commands are rendered invalid.
-
When communication with the printer uses XON/XOFF control with serial interface, the XOFF code may interrupt the "Header to NUL" data string.
-
The information for each function can be identified to other transmission data according to specific data of the transmission data block. When the header transmitted by the printer is [hex = 37h/decimal = 55], treat NUL [hex = 00h/decimal = 0] as a data group and identify it according to the combination of the header and the identifier.
[Notes for ESC/POS Handshaking Protocol]
-
It will be necessary to perform the ESC/POS Handshaking Protocol procedures listed below when using GS ( L <Function 64> and GS ( L <Function 80> .
-
ProcedureHost operationPrinter operation1This command sends GS ( L <Function 64> .GS ( L <Function 64> is initiated.2Data is received from printer.Key code list is sent.3Response code (∗1) is sent.Procedures (∗2 and ∗3) are performed according to response code.
-
-
(∗1) Response Code
-
ASCIIHexDecimalRequest definitionACK066Send next data group.NAK1521Resend just-received data group.CAN1824Cancel send operation.
-
-
(∗2) Processing According to Response Code (When Send Data Remains (indicated by identification status of send data group))
-
Response codeProcessingACKInitiates operation to send next data.NAKResends the just-received data.CANCancels processing initiated by this command.
-
-
(∗3) Processing According to Response Code (When No More Send Data Remains (indicated by identification status of send data group))
-
Response codeProcessingACK, CANCancels procedure initiated by this command.NAKResends the just-received data.
-
When codes other than the ACK, NAK, or CAN codes are received, the CAN procedure is executed.
Quick Access
- [Name]
- [Format]
- [Range]
- [Description]
- [Notes]
ESC/POS® includes patented or patent pending commands. The contents must not be disclosed
to third parties.
- Introduction
- Command Lists
- Commands in Code Order
- Applicable printers
- Command List by Model
- EU-m30
- TM-J2000, TM-J2100
- TM-L90
- TM-L90 LFC
- TM-L100
- TM-m10
- TM-m30
- TM-m30II
- TM-m30II-H
- TM-m30II-NT
- TM-m30II-S
- TM-m30II-SL
- TM-m30III
- TM-m30III-H
- TM-m50
- TM-m50II
- TM-m50II-H
- TM-P20
- TM-P20II
- TM-P60
- TM-P60II
- TM-P80
- TM-P80II
- TM-T100
- TM-T20
- TM-T20II
- TM-T20III
- TM-T20IIIL
- TM-T20IV-L
- TM-T20X
- TM-T20X-II
- TM-T70
- TM-T70II
- TM-T81III
- TM-T82II
- TM-T82III
- TM-T82IIIL
- TM-T82IV-L
- TM-T82X
- TM-T82X-II
- TM-T83III
- TM-T83IV
- TM-T88IV
- TM-T88V
- TM-T88VI
- TM-T88VII
- TM-T90
- TM-U220
- TM-U220II
- TM-U230
- Obsolete Commands
- Commands Arranged by Function
- Print Commands
- Line Spacing Commands
- Character Commands
- Printing Paper Commands
- Label and black mark control
- Print Position Commands
- Paper Sensor Commands
- Mechanism Control Commands
- Bit Image Commands
- Bit Image
- GS ( L / GS 8 L
- GS D
- Graphics
- NV Graphics
- Download Graphics
- Panel Button Commands
- Status Commands
- Barcode Commands
- Two-dimensional Code Commands
- GS ( k
- PDF417
- QR Code
- MaxiCode
- 2-dimensional GS1 DataBar
- Composite Symbology
- Aztec Code
- DataMatrix
- Macro Function Commands
- Kanji Commands
- Miscellaneous Commands
- DLE ENQ
- DLE DC4 <fn=1>
- DLE DC4 <fn=2>
- DLE DC4 <fn=3>
- DLE DC4 <fn=7>
- DLE DC4 <fn=8>
- ESC ( Y
- ESC =
- ESC @
- ESC L
- ESC S
- ESC p
- GS ( A
- GS ( D
- GS I
- GS P
- GS g 0
- GS g 2
- GS z 0
- Response or status transmission
- Print control methods
- Beeper tone control
- Graphics drawing
- Receipt enhancement control
- Page mode control
- Customize Commands
- User setup
- GS ( E
- GS ( E <fn=1>
- GS ( E <fn=2>
- GS ( E <fn=3>
- GS ( E <fn=4>
- GS ( E <fn=5>
- GS ( E <fn=6>
- GS ( E <fn=7>
- GS ( E <fn=8>
- GS ( E <fn=9>
- GS ( E <fn=10>
- GS ( E <fn=11>
- GS ( E <fn=12>
- GS ( E <fn=13>
- GS ( E <fn=14>
- GS ( E <fn=15>
- GS ( E <fn=16>
- GS ( E <fn=48>
- GS ( E <fn=49>
- GS ( E <fn=50>
- GS ( E <fn=51>
- GS ( E <fn=52>
- GS ( E <fn=99>
- GS ( E <fn=100>
- Printer customization
- NV user memory
- User setup
- Counter Printing Commands
- Programming Examples
- Appendixes