Select your printer model

Parameters are refined by the selected printer.

addText


Adds string display setting to the command buffer.

Syntax

 
(int) addText:(NSString *)data;
 
(int) addText:(NSString *)data lang:(int)lang;
 
(int) addText:(NSString *)data x:(long)x y:(long)y;
 
(int) addText:(NSString *)data x:(long)x y:(long)y lang:(int)lang;
 
(int) addText:(NSString *)data x:(long)x y:(long)y lang:(int)lang r:(long)r g:(long)g b:(long)b;

Parameter

data

Specifies the string to display.

lang

Specifies the language to display the string.

Value

Description

EPOS2_LANG_EN (default)

English

EPOS2_LANG_JA

Japanese

EPOS2_LANG_MULTI

Multiple languages (UTF-8)

EPOS2_PARAM_DEFAULT

Specifies the default value (English).

EPOS2_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

EPOS2_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

EPOS2_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

EPOS2_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

EPOS2_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

EPOS2_PARAM_UNUSE

Not used.

Return value

Error status

Description

EPOS2_SUCCESS

The function was executed successfully.

EPOS2_ERR_PARAM

An invalid parameter was passed.

EPOS2_ERR_MEMORY

Necessary memory could not be allocated.

EPOS2_ERR_FAILURE

An unknown error occurred.

Supplementary explanation

  • If the coordinates of the display position are omitted, the coordinates of the cursor position upon execution of addText are used.
  • Parameters x and y specify coordinates with the origin at the top left of the line display.
  • 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

    Integer from 1 to 20

    Integer from 1 to 2

    DM-D110

    DM-D210

    DM-D70 (Column/row fixed mode)

    DM-D70 (Standard mode: Landscape orientation)

    Integer from 1 to 44

    Integer from 1 to 13

    DM-D70 (Standard mode: Portrait orientation)

    Integer from 1 to 22

    Integer from 1 to 19

  • Specify the setting value in both x and y parameters.
    If only a single parameter is specified, EPOS2_SUCCESS is returned, 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 EPOS2_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 EPOS2_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 iOS

Jump to the top