SimpleOCR:SDK Functions
IMG
All the images manipulated by SimpleOCR have the IMG type. SimpleOCR provides functions that allows you to handle an IMG object as a Device Independent Bitmap (DIB). See your Windows SDK documentation in order to become familiar with DIB concepts.
The IMG objects are always manipulated through SimpleOCR functions. So even if IMG objects are implemented as structures, you don’t have to bother with its definition. When programming in languages besides C++, substitute IMG * with Long Integer data types.
Please remember, SimpleOCR can only work with bi-level (i.e. black & white) images or grayscale images with 256 shades of grays.
SETOFIMG
Several images that belong to the same document can be grouped in a SETOFIMG object. The SETOFIMG objects are always manipulated through SimpleOCR functions. So even if IMG objects are implemented as structures, you don’t have to bother with its definition.
When programming in languages besides C++, substitute SETOFIMG * with Long Integer data types.
AddDIB
int AddDIB(SETOFIMG * set, HGLOBAL hDib)
This function is similar to AddImage, except that, instead of an IMG object, this function expects an image in the DIB format.
Return Value
If the function fails, a nonzero value is returned.
Parameters
set
A pointer to a set of images of type SETOFIMG.
hDib
A HGLOBAL handler referencing a Global Memory object containing a BITMAPINFO structure followed by the bitmap bits.
Example
SETOFIMG *doc;
HGLOBAL hDib;
int nb;
// Creates a set
doc=CreateMultipleImg();
if (doc==NULL)
{
// error processing
...
}
// Retrieve a DIB from the clipboard
if (IsClipboardFormatAvailable(CF_DIB) && OpenClipboard(hWnd))
{
hDib=GetClipboardData(CF_DIB);
CloseClipboard();
// Add DIB to the set
if( AddDIB(set,hDib) )
{
// error processing
...
}
}