RecAPI
Scanner Enhancement Technology Tools (SET Tools)

Scanner Enhancement Technology Tools (SET Tools). This module is supported on: Windows. More...

Functions

RECERR RECAPIPLS RecSETDialog (HANDLE hWnd, int sid, HDOC hDoc, int *pnIndices, int nCount, LPCTSTR settemplate, LPTSTR outtemplate, int nBuffLength)
 It displays the SET Tools Dialog.
RECERR RECAPIPLS RecExecuteSET (int sid, HDOC hDoc, int *pnIndices, int nCount, LPCTSTR settemplate)
 It excutes SET steps without any UI.

Detailed Description

Scanner Enhancement Technology Tools (SET Tools). This module is supported on: Windows.

These functions make possible to use image preprocessing algorithms of Scanner Enhancement Technology tools. SET has a bunch of image preprocessing algorithms to improve the image for OCR.


Function Documentation

RECERR RECAPIPLS RecExecuteSET ( int  sid,
HDOC  hDoc,
int *  pnIndices,
int  nCount,
LPCTSTR  settemplate 
)

It excutes SET steps without any UI.

This function executes the image enhancing steps being in the SET template file on the pages of the given document.

Parameters:
[in]sidSettings Collection ID.
[in]hDocHandle of the document. The SET steps will be appled on this document pages.
[in]pnIndicesPointer to an integer array or NULL. If it is specified, it contains the indices of the pages that SET steps will be applied on.
[in]nCountLenght of the array.
[in]settemplatePoints to a SET template filename.
Return values:
RECERR
Note:
This function is supported on: Windows.
See Sample #65 for more details.
RECERR RECAPIPLS RecSETDialog ( HANDLE  hWnd,
int  sid,
HDOC  hDoc,
int *  pnIndices,
int  nCount,
LPCTSTR  settemplate,
LPTSTR  outtemplate,
int  nBuffLength 
)

It displays the SET Tools Dialog.

This function utilises the Scanner Enhancement Technology Tools. When the application calls this function, SET dialog shows up. The user can put together one or more image enhancing steps and save them into a file which will be used in RecExecuteSET function.

Parameters:
[in]hWndParent window
[in]sidSettings Collection ID.
[in]hDocHandle of the document. The SET steps will be appled on the pages of this document.
[in]pnIndicesPointer to an integer array or NULL. If it is specified, it contains the indices of the pages that SET steps will be applied on.
[in]nCountLenght of the array.
[in]settemplateInitial SET template or NULL. If it is a full path of a SET template file, RecSETDialog executes this template on the selected pages in the given document, before shows the images in the dialog.
[out]outtemplateOutput buffer for a filename path. If the user creates new image enchancing steps, these can be saved into an other SET template file within the dialog. This out parameter will contain the lastly saved template filename.
[in]nBuffLengthLength of the buffer
Return values:
RECERR
Note:
This function is supported on: Windows.
The following image enhancing algorithms can be used:
  • Brightness / Contrast
  • Hue/Saturation / Lightness
  • Crop
  • Rotate / Flip
  • Despeckle
  • OCR Brightness
  • Crop-out Color
  • Resolution
  • Deskew / 3D deskew
  • Fill
  • Auto Crop
  • Clean Borders
  • Punch Hole Removal
  • Enhance Whiteboard Photo
See Sample #65 for more details.