Select your printer model

Parameters are refined by the selected printer.

<symbol>


Specifies a 2D symbol as 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 data: Shift JIS string
  • 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 first data is processed as the primary message.

Specify the primary message in the following format:

  • Mode 2

Zip code: (1- to 9-digit figure)

GS: (\x1d)

ISO country code: (1- to 3-digit figure)

GS: (\x1d)

Service class code (1- to 3-digit figure)

  • Mode 3

Zip code: (Data which can be converted with 1 to 6 code sets A)

GS: (\x1d)

ISO country code: (1- to 3-digit figure)

GS: (\x1d)

Service class code (1- to 3-digit figure)

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.

Attribute

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

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”

“3”

QR Code

Ignored

MaxiCode

2D GS1 DataBar

Aztec Code

DataMatrix

size

2D symbol type

Default value

Description

PDF417

"0" (automatic)

Specifies the number of code words per stage.

QR Code

Ignored

MaxiCode

2D GS1 DataBar

Expanded Stacked

"0" (automatic)

Specifies the maximum width of the barcode (106 or more).

Other

Ignored

Aztec Code

Ignored

DataMatrix

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

  • Specifies various 2D symbols.
  •  
    <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>
    

Supplementary explanation

  • If the setting does not conform to the 2D symbol standard or the defined 2D symbol is larger than the print area of the printer, the 2D symbol will not be printed and no error will be returned.
  • In the standard mode, a 2D symbol which vertically exceeds 831 dots in size cannot be printed.
  • In the page mode, the 2D symbol is printed at the current position with the lower-left dot of the 2D symbol as the standard point.
  • Use the following escape sequences to specify binary data which cannot be represented as a string:
    • Control code: \xnn (set nn in hexadecimal)
    • Back slash: \\
  • The type attribute is mandatory.
  • Micro QR Code does not support the level_h of the level attribute.
  • Specify the level attribute value in accordance with the 2D symbol type specified in the type attribute.
  • When MaxiCode or 2D GS1 DataBar are specified in the type attribute, specify the default as the level attribute.
  • The “align” and “rotate” attributes do not work in the page mode.
  • Specify the “align” and “rotate” attributes at the "beginning of the line.”
  • The align attribute setting in the <symbol> element also applies to the align attribute in the <text>, <image>, <logo>, and <barcode> elements.
  • The rotate attribute setting in the <symbol> element also applies to the rotate attribute in the <text> and <barcode> elements.
  • Use <direction> to enable text rotation in the page mode.
 

Quick Access

  • [Name]
  • [Format]
  • [Range]
  • [Description]
  • [Notes]

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


ePOS-Device XML

Jump to the top