L_BlankPageDetectorBitmapExt

#include "l_bitmap.h"

L_LTIMGCOR_API L_INT EXT_FUNCTION L_BlankPageDetectorBitmapExt(pBitmap, bIsBlank, pAccuracy, pMargins, uSensitivity, uFlags)

pBITMAPHANDLE pBitmap; pointer to the bitmap handle
L_BOOL * bIsBlank; address of the variable to be updated
L_UINT * pAccuracy; address of the variable to be updated
pPAGEMARGINS pMargins; page margin
L_UINT uSensitivity; sensitivity of the blank page detection engine
L_UINT uFlags; flags

Determines whether the scanned image is a blank page.

Parameter Description
pBitmap Pointer to the bitmap handle that references the image to be tested.
bIsBlank Pointer to a flag to be updated with a value indicating whether the image is a blank page. Possible values are:
Value Meaning
true Blank page.
false Non-blank page.
pAccuracy Pointer to a variable to be updated with the accuracy of the result, in hundredths of percent. Possible values range from 0 to 10000. This value is divided internally by the value 100.
pMargins Pointer to the PAGEMARGINS structure that contains information about excluded margins. Pass NULL if there are no margins to exclude.
uSensitivity Determines the sensitivity of the blank page detection. Possible values range from 0 to 100.
uFlags Flags that indicate how to consider blank pages and determine the function's behavior. Values can be combined when appropriate by using a bitwise OR (|). Possible values are:
Consider a noisy page as a blank page:
Value Meaning
BLANK_DETECT_EMPTY [0x00000000] A page must be totally blank.
BLANK_DETECT_NOISY [0x00000001] A page can have some noise. This is the default value.
Consider a page which bleeds through its other side as a blank page:
Value Meaning
BLANK_NOT_BLEED_THROUGH [0x00000000] Consider the bleed-through from the page.
BLANK_BLEED_THROUGH [0x00000010] Ignore the bleed-through from the page. This is the default value.
Consider a lined page as a blank page:
Value Meaning
BLANK_DONT_DETECT_LINES [0x00000000] Ignore the lined page as a blank page. This is the default value.
BLANK_DETECT_LINES [0x00000100] Consider the lined page as a blank page.
Indicates whether to ignore blank spaces around the page's edges. Possible values are:
Value Meaning
BLANK_DONT_USE_ACTIVE_AREA [0x00000000] Consider blank spaces around the page's edges. This is the default value.
BLANK_USE_ACTIVE_AREA [0x00001000] Ignore blank spaces around the page's edges.
Indicates whether to use the default margins or user-specified margins. Possible values are:
Value Meaning
BLANK_DEFAULT_MARGIN [0x00000000] Use the default margins, which are computed automatically by the engine based on the page's dimensions. This is the default value.
BLANK_USER_MARGIN [0x00010000] Use the user-specified margins, which are specified in pMargins.

Returns

SUCCESS The function was successful.
< 1 An error occurred. Refer to Return Codes.

Comments

Scanned images can contain blank (empty) pages. This function determines whether the scanned image is a blank page. It can detect noisy, bleed-through, and lined blank pages with high precision and speed, and provides an accuracy percentage for the result. This function helps reduce the disk storage space required for scanned images.

This function does not support signed data images. It returns the error code ERROR_SIGNED_DATA_NOT_SUPPORTED if a signed data image is passed to this function.

This function does not support 32-bit grayscale images. It returns the error code ERROR_GRAY32_UNSUPPORTED if a 32-bit grayscale image is passed to this function.

Required DLLs and Libraries

LTIMGCOR
For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64, Linux.

Help Version 20.0.2018.1.19
Products | Support | Contact Us | Copyright Notices
© 1991-2018 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Raster Imaging C API Help