Select your printer model

Parameters are refined by the selected printer.

addText method


Adds display setting of a character in the customer display to the command buffer.

Syntax

 
addText(data);
 
addText(data, lang);
 
addText(data, x, y);
 
addText(data, x, y, lang);
 
addText(data, x, y, lang, r, g, b);

Parameter

data

Value

Description

data

Specifies the character to display as a string.

lang

Value

Description

"en" (default)

English

"ja"

Japanese (Kana)

"mul"

Multiple languages (UTF-8)

"undefined"

Not used.

x

Value

Description

1 to 44

Specifies the X coordinate of the display position.

"undefined"

Not used.

y

Value

Description

1 to 19

Specifies the Y coordinate of the display position.

"undefined"

Not used.

r

Value

Description

Integer value from 0 to 255

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

"undefined"

Not used.

g

Value

Description

Integer value from 0 to 255

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

"undefined"

Not used.

b

Value

Description

Integer value from 0 to 255

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

"undefined"

Not used.

Return value

Return value

Object type

Display object

Display

Exception

Return value

Object type

Parameter " ... " is invalid

Error

Supplementary explanation

  • If the coordinates of the display position are omitted, the coordinates of the cursor position upon execution of addText method 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, an exception 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 "mul" 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 "mul" 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 JavaScript

Jump to the top