Skip to main content

Interface: addSymbolParams

data​

data: string Specifies 2D symbol data as a text string. Specify a string in accordance with the standard of the 2D symbol specified in type.

TypeDescription
Standard PDF417, Truncated PDF417Converts 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 Model 1, QR Code Model 2, QR Code MicroConverts the string into JIS, processes the escape sequence(s), and encodes the data by choosing the data type from the following:
• Figure:0to9
• Alphanumeric:0to9,AtoZ,blankspace,$,%,*,+,-,.,/,:
• Kanji:CharacterswhichcanberepresentedwithShiftJIScodes
• 8-bitbytedata:0x00to0xff
MaxiCode Mode 2, MaxiCode Mode 3, MaxiCode Mode 4, MaxiCode Mode 5, MaxiCode Mode 6Converts 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 pro- cessed as the message header and the second and succeeding data sequence is pro- cessed as the primary message. Otherwise, the primary message starts with the fist data. For the mode 2, specify the primary message in the following format:
• Zipcode(1-to9-digitfigure)GS:(\x1d)
• ISOcountrycode(1-to3-digitfigure)GS:(\x1d)
• Serviceclasscode(1-to3-digitfigure)
For the mode 3, specify the primary message in the following format:
• Zipcode(datawhichcanbeconvertedwith1to6codesetsA)GS(\x1d)
• ISOcountrycode(1-to3-digitfigure)GS(\x1d)
• Serviceclasscode(1-to3-digitfigure)
GS1 DataBar Stacked, GS1 DataBar Stacked OmnidirectionalConverts 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 Expanded StackedConverts 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, DataMatrixConverts the string into UTF-8, processes the escape sequence(s), and encodes the data.

type​

type: number

Specifies the 2D symbol type.

ValueDescription
PrinterConstants.SYMBOL_PDF417_STANDARDStandard PDF417
PrinterConstants.SYMBOL_PDF417_TRUNCATEDTruncated PDF417
PrinterConstants.SYMBOL_QRCODE_MODEL_1QR Code Model 1
PrinterConstants.SYMBOL_QRCODE_MODEL_2QR Code Model 2
PrinterConstants.SYMBOL_QRCODE_MICROQR Code Micro
PrinterConstants.SYMBOL_MAXICODE_MODE_2MaxiCode Mode 2
PrinterConstants.SYMBOL_MAXICODE_MODE_3MaxiCode Mode 3
PrinterConstants.SYMBOL_MAXICODE_MODE_4MaxiCode Mode 4
PrinterConstants.SYMBOL_MAXICODE_MODE_5MaxiCode Mode 5
PrinterConstants.SYMBOL_MAXICODE_MODE_6MaxiCode Mode 6
PrinterConstants.SYMBOL_GS1_DATABAR_STACKEDGS1 DataBar Stacked
PrinterConstants.SYMBOL_GS1_DATABAR_STACKED_OMNIDIRECTIONALGS1 DataBar Stacked Omnidirectional
PrinterConstants.SYMBOL_GS1_DATABAR_EXPANDED_STACKEDGS1 DataBar Expanded Stacked
PrinterConstants.SYMBOL_AZTECCODE_FULLRANGEAztec Code Full-Range mode
PrinterConstants.SYMBOL_AZTECCODE_COMPACTAztec Code Compact mode
PrinterConstants.SYMBOL_DATAMATRIX_SQUAREDataMatrix Square
PrinterConstants.SYMBOL_DATAMATRIX_RECTANGLE_8DataMatrix Rectangle, 8 lines
PrinterConstants.SYMBOL_DATAMATRIX_RECTANGLE_12DataMatrix Rectangle, 12 lines
PrinterConstants.SYMBOL_DATAMATRIX_RECTANGLE_16DataMatrix Rectangle, 16 lines

level​

level: number

Specifies the error correction level. Specify a value in accordance with the 2D symbol type. Specify "PARAM_DEFAULT" for MaxiCode, 2D GS1 DataBar, and DataMatrix.

❏ PDF417

ValueDescription
PrinterConstants.LEVEL_0Error correction level 0
PrinterConstants.LEVEL_1Error correction level 1
PrinterConstants.LEVEL_2Error correction level 2
PrinterConstants.LEVEL_3Error correction level 3
PrinterConstants.LEVEL_4Error correction level 4
PrinterConstants.LEVEL_5Error correction level 5
PrinterConstants.LEVEL_6Error correction level 6
PrinterConstants.LEVEL_7Error correction level 7
PrinterConstants.LEVEL_8Error correction level 8
PrinterConstants.PARAM_DEFAULTSpecifies the default value (Error correction level 1).
PrinterConstants.PARAM_UNSPECIFIED<Obsolete> Not specify.

❏ QR Code

ValueDescription
PrinterConstants.LEVEL_LError correction level L
PrinterConstants.LEVEL_MError correction level M
PrinterConstants.LEVEL_QError correction level Q
PrinterConstants.LEVEL_HError correction level H
PrinterConstants.PARAM_DEFAULTSpecifies the default value (Error correction level M).
PrinterConstants.PARAM_UNSPECIFIED<Obsolete> Not specify.

❏ Aztec Code

ValueDescription
Integer from 5 to 95Error correction level (in percents)
PrinterConstants.PARAM_DEFAULTSpecifies the default value (Error correction level 23).
PrinterConstants.PARAM_UNSPECIFIED<Obsolete> Not specify.

width (optional)​

width?: number

Specifies the module width. An integer from 1 to 255 can be specified. When "PrinterConstants.PARAM_UNSPECIFIED" is specified, the current setting is retained. The range differs depending on the 2D symbol type.

2D symbol typeValid valueDefault value
PDF4172 to 83
QR Code3 to 163
MaxiCode1 to 255 (Ignored)
2D GS1 DataBar2 to 82
Aztec Code2 to 163
DataMatrix2 to 163

height (optional)​

height?: number

Specifies the module height. An integer from 1 to 255 can be specified. When "PrinterConstants.PARAM_UNSPECIFIED" is specified, the current setting is retained. The range differs depending on the 2D symbol type.

2D symbol typeValid valueDefault value
PDF4172 to 83
QR Code, MaxiCode, 2D GS1 DataBar, Aztec Code, DataMatrix1 to 255 (Ignored)

size​

size: number

Specifies the maximum size of the 2D symbol. An integer from 0 to 65535 can be specified.