Select your printer model
<symbol>
This element allows you to specify a 2D symbol using a text string.
2D symbol type
|
Type |
Description |
|---|---|
|
PDF417 |
Converts the string into UTF-8, processes the escape sequence(s), and encodes the data. The maximum number of code words in the data area is 928, the maximum number of code words in a single stage is 30, and the maximum number of stages is 90. |
|
QR Code |
Converts the string into JIS, processes the escape sequence(s), and encodes the data by choosing the data type from the following:
|
|
Micro QR Code |
|
|
MaxiCode |
Converts the string into UTF-8, processes the escape sequence(s), and encodes the data. In Mode 2 or 3, if the first data is [)>\x1e01\x1dyy ("yy" is a 2-digit figure), this is processed as the message header and the second and succeeding data sequence is processed as the primary message. Otherwise, the primary message starts with the first data. Specify the primary message in the following format.
Postal code: (1- to 9-digit number) GS: (\x1d) ISO country code: (1- to 3-digit number) GS: (\x1d) Service class code (1- to 3-digit number)
Postal code: (data which can be converted with 1 to 6 code sets A) GS: (\x1d) ISO country code: (1- to 3-digit number) GS: (\x1d) Service class code (1- to 3-digit number) |
|
GS1 DataBar Stacked |
Converts the string into UTF-8, processes the escape sequence(s), and encodes the data. Specify a 13-digit product ID (GTIN) excluding the application ID (AI) and check digit. |
|
GS1 DataBar Stacked Omnidirectional |
|
|
GS1 DataBar Expanded Stacked |
Converts the string into UTF-8, processes the escape sequence(s), and encodes the data. The application ID (AI) can be put in parentheses. The parentheses are used as print characters for HRI and not encoded as data. To encode the following characters, specify the corresponding 2-digit code starting with { :
|
|
Aztec Code |
Converts the string into UTF-8, processes the escape sequence(s), and encodes the data. |
|
DataMatrix |
Converts the string into UTF-8, processes the escape sequence(s), and encodes the data. |
When specifying binary data which cannot be represented as a text string, use the following escape sequences.
|
Text string |
Description |
|---|---|
|
\xnn |
Control code (set nn in hexadecimal) |
|
\\ |
Back slash |
Attribute
"type" must be specified.
type
|
Attribute value |
Type |
|---|---|
|
"pdf417_standard" |
Standard PDF417 |
|
"pdf417_truncated" |
Truncated PDF417 |
|
"qrcode_model_1" |
QR Code Model 1 |
|
"qrcode_model_2" |
QR Code Model 2 |
|
"qrcode_micro" |
Micro QR Code |
|
"maxicode_mode_2" |
MaxiCode Mode 2 |
|
"maxicode_mode_3" |
MaxiCode Mode 3 |
|
"maxicode_mode_4" |
MaxiCode Mode 4 |
|
"maxicode_mode_5" |
MaxiCode Mode 5 |
|
"maxicode_mode_6" |
MaxiCode Mode 6 |
|
"gs1_databar_stacked" |
GS1 DataBar Stacked |
|
"gs1_databar_stacked_omnidirectional" |
GS1 DataBar Stacked Omnidirectional |
|
"gs1_databar_expanded_stacked" |
GS1 DataBar Expanded Stacked |
|
"azteccode_fullrange" |
Aztec Code Full-Range mode |
|
"azteccode_compact" |
Aztec Code Compact mode |
|
"datamatrix_square" |
DataMatrix ECC200 Square |
|
"datamatrix_rectangle_8" |
DataMatrix ECC200 Rectangle, 8 lines |
|
"datamatrix_rectangle_12" |
DataMatrix ECC200 Rectangle, 12 lines |
|
"datamatrix_rectangle_16" |
DataMatrix ECC200 Rectangle, 16 lines |
level
- PDF417
|
Attribute value |
Description |
|---|---|
|
"level_0" |
Error correction level 0 |
|
"level_1" (default value) |
Error correction level 1 |
|
"level_2" |
Error correction level 2 |
|
"level_3" |
Error correction level 3 |
|
"level_4" |
Error correction level 4 |
|
"level_5" |
Error correction level 5 |
|
"level_6" |
Error correction level 6 |
|
"level_7" |
Error correction level 7 |
|
"level_8" |
Error correction level 8 |
|
"default" |
Default value (error correction level 1) |
- QR Code
|
Attribute value |
Description |
|---|---|
|
"level_l" |
Error correction level L |
|
"level_m" |
Error correction level M |
|
"level_q" |
Error correction level Q |
|
"level_h" |
Error correction level H |
|
"default" |
Default value (error correction level M) |
- Aztec Code
|
Attribute value |
Description |
|---|---|
|
Integer (5 to 95) |
Error correction level |
|
"default" |
Default value (error correction level 23) |
width
|
2D symbol type |
Valid value |
Default value |
|---|---|---|
|
PDF417 |
"2" to "8" |
"3" |
|
QR Code |
"3" to "16" |
"3" |
|
MaxiCode |
Ignored |
|
|
2D GS1 DataBar |
"2" to "8" |
"2" |
|
Aztec Code |
"2" to "16" |
"3" |
|
DataMatrix |
"2" to "16" |
"3" |
height
|
2D symbol type |
Valid value |
Default value |
|---|---|---|
|
PDF417 |
"2" to "8" (Scaling factor for width) |
"3" |
|
QR Code |
Ignored |
|
|
MaxiCode |
||
|
2D GS1 DataBar |
||
|
Aztec Code |
||
|
DataMatrix |
||
size
|
2D symbol type |
Default value |
Description |
|
|---|---|---|---|
|
PDF417 |
"0" (auto) |
Specifies the number of code words per stage. |
|
|
QR Code |
Ignored |
||
|
MaxiCode |
|||
|
2D GS1 DataBar |
Expanded Stacked |
"0" (auto) |
Specifies the maximum width of the 2D symbol (106 or more). |
|
Other |
Ignored |
||
|
Aztec Code |
Ignored |
||
|
DataMatrix |
Ignored |
||
align
|
Attribute value |
Description |
|---|---|
|
"left" |
Left alignment |
|
"center" |
Center alignment |
|
"right" |
Right alignment |
rotate
|
Attribute value |
Description |
|---|---|
|
"true" / "1" |
Enables text rotation. |
|
"false" / "0" |
Disables text rotation. |
Sample program
Prints multiple types of 2D symbols
<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print"> <symbol type="pdf417_standard">ABCDE</symbol> <symbol type="qrcode_model_2" level="level_q">ABCDE</symbol> <symbol type="maxicode_mode_2">908063840\x1d850\x1d001\x1d\x04</symbol> <symbol type="gs1_databar_stacked">0201234567890</symbol> <symbol type="gs1_databar_stacked_omnidirectional">0201234567890</symbol> <symbol type="gs1_databar_expanded_stacked">(01)02012345678903</symbol> <symbol type="azteccode_fullrange" level="23">ABCDE</symbol> <symbol type="datamatrix_square">ABCDE</symbol> </epos-print> |
Supplementary explanation
- If your 2D symbol settings are not compliant with the 2D symbol standards, or if the size is larger than the print area, the symbol is not printed with no error returned.
- In the standard mode, a 2D symbol whose height exceeds 831 dots cannot be printed.
- In the page mode, the bottom left corner of the 2D symbol is aligned with the start position for printing the symbol.
- Micro QR Code does not support "level_h".
- Specify the "level" that matches the type of the 2D symbol you specified.
- Set "default" to "level" if the 2D symbol type is MaxiCode or 2D GS1 DataBar.
- When setting "align" or "rotate" in the standard mode, set it at the beginning of a line.
- The "align" and "rotate" settings are ignored in the page mode.
- To rotate text string in the page mode, use <direction>.
- The "align" setting specified in this element is also applied to <text>, <image>, <logo>, and <barcode>.
- The "rotate" setting specified in this element is also applied to <text> and <barcode>.
Quick Access
- [Name]
- [Format]
- [Range]
- [Description]
- [Notes]
- Introduction
- help
- XML for Controlling Printer
- XML for Controlling Customer Display
- Appendix
- XML Supported Printers
- Supported Elements List
- Printer-specific Support Information
- 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-P60II (Receipt)
- TM-P60II (Peeler)
- TM-P80
- TM-P80II
- TM-T20III
- TM-T82III
- TM-T88VI
- TM-T88VII
- TM-L100
- TM-U220II
- TM-H6000V
- TM-H6000VI
- TM-L90
- TM-L90 4xx
- TM-T20
- TM-T20II
- TM-T70
- TM-T70II
- TM-T82II
- TM-T83II
- TM-T88IV
- TM-T88V
- TM-T90
- TM-U220
- TM-U330
- TM-H6000IV
- TM-L90-i
- TM-T20II-i
- TM-T70-i
- TM-T82II-i
- TM-T83II-i
- TM-T88V-i
- TM-T88VI-iHUB
- TM-U220-i
- TM-U220IIB-i
- TM-T70II-DT
- TM-T70II-DT2
- TM-T88V-DT
- TM-T88VI-DT2
- TM-H6000IV-DT
- Usage Restrictions by Firmware Version
- ePOS-Print Settings
