Specifications

No
EPSON
TITLE
EPSON Advanced Printer Driver for TM series
StatusAPI
Reference Manual
Revision
L
NEXT
51
SHEET
50
3.33.BiSCNSetImageQuality
[Function]
Sets the image scanning quality. Furthermore, the value set with this function is valid until the printer’s power is turned OFF
or until the printer is reset.
[Format]
int BiSCNSetImageQuality( int nHandle, BYTE bColorDepth, char bThreshold, BYTE bColor, BYTE bExOption)
[Argument]
int nHandle
Specifies the handle value of the printer executing the function. The return value in BiOpenMonPrinter() is specified.
BYTE bColorDepth
Specifies the tonal gradation (the number of bits used for 1 pixel). The valid specification values are 1 or 8. The default
value after the printer’s power is turned off, or after the printer is reset, is 1.
EPS_BI_SCN_1BIT(1): 1bit
EPS_BI_SCN_8BIT(8): 8bit
char bThreshold
Specifies the density threshold value. The valid specification range is –128 ~ 127. The default value after the printer’s
power is turned off, or after the printer is reset, is 0. If 0 is specified, the printer is set to use the basic density.
BYTE bColor
Specifies the color. Valid specification values are as shown below.
EPS_BI_SCN_MONOCHROME (48) : Black and White
EPS_BI_SCN_COLOR (49) : Color
However, in the current version, this value is fixed at EPS_BI_SCN_MONOCHROME, and any other value that is
specified is regarded as invalid.
BYTE bExOption
Specifies the type of density adjustment. The valid specification values are as shown below.
EPS_BI_SCN_AUTO (48) : Density is adjusted automatically.
EPS_BI_SCN_MANUAL (49) : Density is adjusted manually.
However, in the current version, this value is fixed at EPS_BI_SCN_MANUAL, and any other value that is specified is
regarded as invalid.
[Return Values]
If execution is successful, 0 is returned. If an error occurs, the following error codes (negative values) are returned.
ERR_HANDLE The handle value specified for the printer is incorrect.
ERR_NOT_SUPPORT Not supported
ERR_ACCESS Reading/writing with the printer is not possible (printing in progress).
ERR_OFFLINE It was opened in the offline state, so it cannot be used until the online state is recovered.
ERR_PARAM Parameter error
[Caution]
If this function is executed for a TM-H6000II that is not equipped with a scanner, it ends normally, but the image quality is
not set.
Since this function does not check whether the scanner of the printer is capable of gray scale reading, be sure to confirm this
before using a printer with the information acquired by using the function BiGetPrnCapability.
Only when pColorDepth is EPS_BI_SCN_1BIT(1), the value of *pThreshold is ignored.
[Supported Printers]
TM-H6000II with scanner