1. TOP»
  2. Epson ePOS SDK for Android »
  3. Printer class »
  4. setPrinterSetting

Select your printer model

Parameters are refined by the selected printer.

setPrinterSetting

Changes the set value of the printer setting.

The value acquired by this API is notified to the listener method specified in the listener parameter.

Syntax

 
 
public void setPrinterSetting(int timeout, java.util.Map<java.lang.Integer,​java.lang.Integer> list, PrinterSettingListener listener) throws Epos2Exception

Parameter

timeout

Specifies the timeout period before completion of printing in milliseconds.

Value

Description

Integer from 5000 to 600000

Timeout period (in milliseconds)

Printer.PARAM_DEFAULT

Specifies the default value (10000).

list

Specifies the list combining the changed printer setting item (type) and the set value (value).

type

Specifies the printer setting item to be changed.

Value

Description

Printer.Setting.PaperWidth

Paper width

Printer.Setting.PrintDensity

Print density

Printer.Setting.PrintSpeed

Print speed

value

Specifies the set value of the printer setting to be changed.

Value

Description

Printer.Setting.PaperWidth58_0

Paper width 58 mm

Printer.Setting.PaperWidth60_0

Paper width 60 mm

Printer.Setting.PaperWidth70_0

Paper width 70 mm

Printer.Setting.PaperWidth76_0

Paper width 76 mm

Printer.Setting.PaperWidth80_0

Paper width 80 mm

Printer.Setting.PrintDensityDIP

Print density DIP switch setting

Printer.Setting.PrintDensity70

Print density 70%

Printer.Setting.PrintDensity75

Print density 75%

Printer.Setting.PrintDensity80

Print density 80%

Printer.Setting.PrintDensity85

Print density 85%

Printer.Setting.PrintDensity90

Print density 90%

Printer.Setting.PrintDensity95

Print density 95%

Printer.Setting.PrintDensity100

Print density 100%

Printer.Setting.PrintDensity105

Print density 105%

Printer.Setting.PrintDensity110

Print density 110%

Printer.Setting.PrintDensity115

Print density 115%

Printer.Setting.PrintDensity120

Print density 120%

Printer.Setting.PrintDensity125

Print density 125%

Printer.Setting.PrintDensity130

Print density 130%

Printer.Setting.PrintSpeed1

Print speed level 1

Printer.Setting.PrintSpeed2

Print speed level 2

Printer.Setting.PrintSpeed3

Print speed level 3

Printer.Setting.PrintSpeed4

Print speed level 4

Printer.Setting.PrintSpeed5

Print speed level 5

Printer.Setting.PrintSpeed6

Print speed level 6

Printer.Setting.PrintSpeed7

Print speed level 7

Printer.Setting.PrintSpeed8

Print speed level 8

Printer.Setting.PrintSpeed9

Print speed level 9

Printer.Setting.PrintSpeed10

Print speed level 10

Printer.Setting.PrintSpeed11

Print speed level 11

Printer.Setting.PrintSpeed12

Print speed level 12

Printer.Setting.PrintSpeed13

Print speed level 13

Printer.Setting.PrintSpeed14

Print speed level 14

Printer.Setting.PrintSpeed15

Print speed level 15

Printer.Setting.PrintSpeed16

Print speed level 16

Printer.Setting.PrintSpeed17

Print speed level 17

listener

Registers the listener method that returns the processing result of this API.

 
 
- (void) onSetPrinterSetting(int code);
  • code
    The processing result is stored.

  • Error status

    Description

    CODE_SUCCESS

    Processed successfully.

    CODE_ERR_AUTORECOVER

    Automatic recovery error occurred.

    CODE_ERR_COVER_OPEN

    Cover open error occurred.

    CODE_ERR_CUTTER

    Auto cutter error occurred.

    CODE_ERR_MECHANICAL

    Mechanical error occurred.

    CODE_ERR_EMPTY

    No paper is left in the roll paper end detector.

    CODE_ERR_PARAM

    An invalid parameter was passed.

    CODE_ERR_MEMORY

    Memory necessary for processing could not be allocated.

    CODE_ERR_TIMEOUT

    Failed to communicate with the devices within the specified time.

    CODE_ERR_PROCESSING

    Could not run the process.

    CODE_ERR_ILLEGAL

    This API was called while no communication had been started.

    CODE_ERR_FAILURE

    An unknown error occurred.

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_FAILURE

An unknown error occurred.

Supplementary explanation

  • This API cannot be used simultaneously with other APIs.
    After executing this API, do not execute any other API until the callback is returned.
  • Use this API at the "beginning of a line." If this API is used elsewhere, it will be ignored.
  • Do not turn off the power supply to the printer while executing this API.
  • If communication with the printer is disconnected during execution of this API, the printer may become unable to operate. In such a case, turn the power supply to the printer off and then on again.
  • Communication with the printer disconnects as the printer automatically restarts during execution of this API. Reconnect as necessary.
    In a network environment that uses DHCP, the IP address may change due to restart of the printer.
    In such a case, search for the printer using Discovery class and reconnect.
    When connected via USB, the USB device node may change due to restart of the printer.
    If the identifier is omitted in the target parameter of connect ("USB:"), the connection status can be retained even if the device node changes.
  • This API can be used in the system configuration of the TM printer model and customer display model.
    With the system configuration of the TM Printer + DM-D + barcode scanner model, this API can be used when connecting via Bluetooth or USB.
  • This API cannot be used with SSL/TLS communication.
 

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

  1. TOP»
  2. Epson ePOS SDK for Android »
  3. Printer class »
  4. setPrinterSetting

Jump to the top