DTWAIN_IsDIBBlankString

The DTWAIN_IsDIBBlankString function checks if a Device Independent Bitmap (DIB) represents a blank page.

LONG DTWAIN_IsDIBBlank (

HANDLE	hDib,
LPCTSTR	threshold );

Parameters

hDib

Handle to a Device Independent Bitmap.

threshold

Sets the percentage of white pixels to black pixels to determine if a page is blank.

Return Values

If the DIB is blank, the return value is 1. If the DIB is not blank, the return value is 0. If there is an error, the return value is DTWAIN_ERR_INVALIDBMP.

Comments

The DTWAIN_IsDIBBlankString function works exactly the same way as DTWAIN_IsDIBBlank, with the exception of the LPCTSTR parameters, which is a string that denotes the values to use.

For example:

DTWAIN_IsDIBBlankString( hDib, "99.5")

Prerequisite Function Call(s)

DTWAIN_SysInitialize