Select your printer model

Parameters are refined by the selected printer.

<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:

  • Numeric data: 0 to 9
  • Alphanumeric data: 0 to 9, A to Z, space, $, %, *, +, -, ., /, :
  • Kanji character: Shift JIS code
  • 8-bit byte data: 0X00 to 0xff

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.

  • For Mode 2

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)

  • For Mode 3

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 { :

  • FNC1: {1
  • (: {(
  • ): {)

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

Note:

"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]

ePOS-Print XML includes patented or patent pending functions. The contents must not be disclosed to third parties.


Jump to the top