Select your printer model

Parameters are refined by the selected printer.

addText


Adds string display setting to the command buffer.

Syntax

 
public void addText(String data) throws Epos2Exception
 
public void addText(String data, int lang) throws Epos2Exception
 
public void addText(String data, int x, int y) throws Epos2Exception
 
public void addText(String data, int x, int y, int lang) throws Epos2Exception
 
public void addText(String data, int x, int y, int lang, int r, int g, int b) throws Epos2Exception

Parameter

data

Specifies the string to display.

lang

Specifies the language to display the string.

Value

Description

LineDisplay.LANG_EN (default)

English

LineDisplay.LANG_JA

Japanese

LineDisplay.LANG_MULTI

Multiple languages (UTF-8)

LineDisplay.PARAM_DEFAULT

Specifies the default value (English).

LineDisplay.PARAM_UNUSE

Not used.

x

Specifies the x coordinate of the display position.

Value

Description

Integer from 1 to 44

X coordinate of the display position

LineDisplay.PARAM_UNUSE

Not used.

y

Specifies the y coordinate of the display position.

Value

Description

Integer from 1 to 19

Y coordinate of the display position

LineDisplay.PARAM_UNUSE

Not used.

r

Specifies the red color value of the string to be displayed.

Value

Description

Integer from 0 to 255

Red color value

LineDisplay.PARAM_UNUSE

Not used.

g

Specifies the green color value of the string to be displayed.

Value

Description

Integer from 0 to 255

Green color value

LineDisplay.PARAM_UNUSE

Not used.

b

Specifies the blue color value of the string to be displayed.

Value

Description

Integer from 0 to 255

Blue color value

LineDisplay.PARAM_UNUSE

Not used.

Exception

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

Error status

Description

ERR_PARAM

An invalid parameter was passed.

ERR_MEMORY

Necessary memory could not be allocated.

ERR_FAILURE

An unknown error occurred.

Supplementary explanation

  • Parameters x and y specify coordinates with the origin at the top left of the customer display.
  • If the coordinates of the display position are omitted, the coordinates of the cursor position upon execution of addText are used.
  • The value that can be specified in the x, y parameters varies depending on the customer display used and its display modes, as well as the installation method.
  • x

    y

    DM-D30

    1 to 20

    1 to 2

    DM-D110

    DM-D210

    DM-D70 (Column/row fixed mode)

    DM-D70 (Standard mode: Landscape orientation)

    1 to 44

    1 to 13

    DM-D70 (Standard mode: Portrait orientation)

    1 to 22

    1 to 19

  • Specify the setting value in both x and y parameters.
    If only a single parameter is specified, the Epos2Exception including the error status does not occur, but nothing is displayed.
  • Specify the r, g, b parameters in the RGB565 format.
  • When changing the color of the string to be displayed, specify the setting value in all of the r, g, and b parameters.
  • If the setting value is specified in all of the r, g, and b parameters, the font color changes from the position coordinates specified in the x, y parameters.
  • If LineDisplay.LANG_MULTI is specified in the lang parameter, the font color returns to the default setting of the customer display.
    If the r, g, b parameters are specified after specifying LineDisplay.LANG_MULTI in the lang parameter, then r, g, and b are processed after lang, and therefore, the font color specified in r, g, b is applied.
 

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