Specifications

EPSON

TITLE

EPSON Advanced Printer Driver for TM series

StatusAPI

Reference Manual

Revision

SHEET

3.62.BiESCNDefineCropArea

[Function]

[Format]

int BiESCNDefineCropArea(int nHandle, BYTE bCropAreaID, WORD wStartX,

WORD wStartY, WORD wEndX, WORD wEndY);

[Argument]

int nHandle

Select a printer handle value. Specify a return value of BiOpenMonPrinter() to the handle value.

BYTE bCropAreaID

Select CropAreaID to be registered. Selectable values are 1 to 255.

CROP_AREA_RESET_ALL(0): All the CropAreas registered are deleted.

CROP_AREA_ENTIRE_IMAGE(1): “0” is set to starting points (X,Y) of CropArea. The values of

documentWidth and documentHeight are set to ending points (X,Y) respectively.

The argument other than the above: the coordinate selected is set.

WORD wStartX

Select a starting point (X) of CropArea. Selectable values are 0 to documentWidth-1 (unit: 0.1 mm)

WORD wStartY

Select a starting point (Y) of CropArea. Selectable values are 0 to documentHeight-1 (unit: 0.1 mm)

WORD wEndX

Select an ending point (X) of CropArea. Selectable values are 1 to documentWidth (unit: 0.1 mm)

CROP_AREA_RIGHT(65535): The value of documentWidth is set to the ending X coordinate.

WORD wEndY

Select an ending point (Y) of CropArea. Selectable values are 1 to documentHeight (unit: 0.1 mm)

CROP_AREA_BOTTOM(65535): The value of documentHeight is set to the ending Y coordinate.

[Return value]

SUCCESS(0) is returned if the execution is successful. If an error occurs, one of the following error codes (negative value)

is returned:

ERR_HANDLE(-60) The handle value that selects the printer is incorrect.

ERR_PARAM(-90) Parameter error.

ERR_NOT_SUPPORT(-100) Not supported.

[Explanation]

Select each coordinate for CropArea and register it to the CropArea definition table of status API by using CropArea ID

selected.

If the data of CropAreaID selected has already been defined, the registration is executed by overwriting.

If CROP_AREA_RESET_ALL is selected for CropAreaID, all the data defined in the CropArea definition table are

deleted.