Select your printer model

Parameters are refined by the selected printer.

addBarcode


Adds a barcode print command to the command buffer.

Syntax

 
public void addBarcode(String data, int type, int hri, int font, int width, int height) throws Epos2Exception

Parameter

data

Specifies barcode data as a text string.

Specify a string in accordance with the standard of the barcode specified in type.

Type

Description

UPC-A

If an 11-digit figure is specified, the check digit is automatically appended.

If a 12-digit figure is specified, the 12th digit is used as the check digit but verification is not performed.

UPC-E

Specify 0 in the first digit.

Specify the manufacturer code in the 2nd to 6th digits.

Specify the item code in right justification in the 7th to 11th digits.

The number of digits of the item code depends on the manufacturer code.

Specify 0 in each unused data.

If an 11-digit figure is specified, the check digit is automatically appended.

If a 12-digit figure is specified, the 12th digit is used as the check digit but verification is not performed.

EAN13

If an 12-digit figure is specified, the check digit is automatically appended.

If a 13-digit figure is specified, the 13th digit is used as the check digit but verification is not performed.

JAN13

EAN8

If an 7-digit figure is specified, the check digit is automatically appended.

If an 8-digit figure is specified, the 8th digit is used as the check digit but verification is not performed.

JAN8

CODE39

If the first character is * , this character is processed as the start character.

If it is not , the start character is automatically added.

ITF

The start and stop codes are automatically added.

Addition and verification of the check digit are not performed.

CODABAR

Specify the start character ((A to D, a to d).

Specify the stop character ((A to D, a to d).

Addition and verification of the check digit are not performed.

CODE93

The start and stop characters are automatically added.

The check digit is automatically calculated and added.

CODE128

Specify the start character (CODE A, CODE B, CODE C).

The stop character is automatically added.

The check digit is automatically calculated and added.

To encode the following characters, specify the corresponding 2-digit code starting with { :

  • FNC1: {1
  • FNC2: {2
  • FNC3: {3
  • FNC4: {4
  • CODE A: {A
  • CODE B: {B
  • CODE C: {C
  • SHIFT: {S
  • {: {{

When specifying CODE C, specify the barcode data as the control code of the escape sequence.

CODE128 auto

The start character, check digit, and stop character are automatically added.

The character string added to make the overall width of the CODE128 symbol as mini-mum is automatically converted. In this function, there is no need to specify the code set, and the barcode is printed simply by entering the data to be converted to symbols.

Example) When entering numbers: "123", etc.

When entering alphabets: "ABCabc", etc.

Data from 0 to 255 (control codes and character codes) can be specified.

Since the overall width changes automatically, use this function after confirming that the barcode fits into the print area and is printed without any problem.

When using FNC1, etc., use CODE128 rather than CODE128 auto.

GS1-128

The start character, FNC1, check digit, and stop characters are automatically added. However, FNC1 used as a data separator is not added.

To automatically calculate and add the application ID (AI) and the following check digit, specify "*" at the check digit position.

The application ID (AI) can be put in parentheses.

The parentheses are used as print characters for HRI and not encoded as data.

A blank space can be inserted between the application ID (AI) and data.

The blank space is 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
  • FNC3: {3
  • (: {(
  • ): {}
  • FNC1: {1
  • {: {{

GS1 DataBar Omnidirectional

Specify a 13-digit product ID (GTIN) excluding the application ID (AI) and check digit.

GS1 DataBar Truncated

GS1 DataBar Limited

GS1 DataBar Expanded

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
  • (: {(
  • ): {}

When specifying binary data which cannot be represented as a string, use the following escape sequences.

String

Description

\xnn

Control code (set nn in hexadecimal)

\\

Back slash

type

Specifies the barcode type.

Value

Description

Printer.BARCODE_UPC_A

UPC-A

Printer.BARCODE_UPC_E

UPC-E

Printer.BARCODE_EAN13

EAN13

Printer.BARCODE_JAN13

JAN13

Printer.BARCODE_EAN8

EAN8

Printer.BARCODE_JAN8

JAN8

Printer.BARCODE_CODE39

CODE39

Printer.BARCODE_ITF

ITF

Printer.BARCODE_CODABAR

CODABAR

Printer.BARCODE_CODE93

CODE93

Printer.BARCODE_CODE128

CODE128

Printer.BARCODE_CODE128_AUTO

CODE128_AUTO

Printer.BARCODE_GS1_128

GS1-128

Printer.BARCODE_GS1_DATABAR_OMNIDIRECTIONAL

GS1 DataBar Omnidirectional

Printer.BARCODE_GS1_DATABAR_TRUNCATED

GS1 DataBar Truncated

Printer.BARCODE_GS1_DATABAR_LIMITED

GS1 DataBar Limited

Printer.BARCODE_GS1_DATABAR_EXPANDED

GS1 DataBar Expanded

hri

Specifies the HRI position.

Value

Description

Printer.HRI_NONE (default)

No printing.

Printer.HRI_ABOVE

Above the barcode

Printer.HRI_BELOW

Below the barcode

Printer.HRI_BOTH

Both above and below the barcode

Printer.PARAM_DEFAULT

Specifies the default value (no printing).

Printer.PARAM_UNSPECIFIED

<Obsolete> Not specify.

font

Specifies the HRI font.

Value

Description

Printer.FONT_A (default)

Font A

Printer.FONT_B

Font B

Printer.FONT_C

Font C

Printer.FONT_D

Font D

Printer.FONT_E

Font E

Printer.PARAM_DEFAULT

Specifies the default value (font A).

Printer.PARAM_UNSPECIFIED

<Obsolete> Not specify.

width

Specifies the width of a single module in dots.

Value

Description

Integer from 2 to 6

Width of a single module (in dots)

Printer.PARAM_UNSPECIFIED

<Obsolete> Not specify.

height

Specifies the height of the barcode in dots.

Value

Description

Integer from 1 to 255

Height of the barcode (in dots)

Printer.PARAM_UNSPECIFIED

<Obsolete> Not specify.

Exception

When the process fails, Epos2Exception with one of the following error status occurs.

Error status

Description

ERR_PARAM

An invalid parameter was passed.

ERR_MEMORY

Memory necessary for processing could not be allocated.

ERR_FAILURE

An unknown error occurred.

Supplementary explanation

  • Use this API at the "beginning of a line."
  • When the barcode data specified in data does not conform to the barcode type specified in type, an error will not be returned as an exception and the barcode will not be printed.
  • The "CODE 128 auto" type of barcode can be specified when the printer is TM-m30II, TM-m30II-H, TM-m30II-NT, TMm30II-S, TM-m30II-SL, TM-m30III, TM-m30III-H, TM-m50, TM-m50II, TM-m50II-H, TM-T88VII, TM-L100, TM-P20II or TM-P80II.
 

Quick Access

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

Epson ePOS SDK includes patented or patent pending functions. The contents must not be disclosed to third parties.


Epson ePOS SDK for Android

Jump to the top