Initializes the Recognition component.

Declaration:

AT_ERRCOUNT ACCUAPI IG_REC_initialize(
   AT_VOID 
);

Return Value:

Supported Raster Image Formats:

This function does not process image pixels.

Example:

AT_ERRCOUNT ErrCount = 0;
ErrCount += IG_REC_initialize();

//...

ErrCount += IG_REC_close();

Recognition component requires additional resource files to be available. By default the component looks for these files in Resource\Recognition directory relatively to the location of igcore19d.dll (this path can be obtained via the "COMM.PATH" global control parameter). If the resource files do not exist in the default directory, the component looks for them in the directory where igcore19d.dll is located. If the files are not found in the latter directory, the function sets an error and returns a non-zero value.

The user may want to keep resource files in another location. Use "REC.RESOURCE_PATH" global control parameter to set full path to the user-defined resource directory. The parameter must be set before the call to IG_REC_initialize().

Example:

AT_ERRCOUNT ErrCount = 0;
static char* path = "C:\\Program Files\\Accusoft\\ImageGear v19 DLL\\DLL\\Bin";

IG_gctrl_item_set("REC.RESOURCE_PATH", AM_TID_MAKELP(AM_TID_CHAR), path, strlen(path) + 1, NULL);
ErrCount += IG_REC_initialize();

//...

ErrCount += IG_REC_close();

If user-defined resource path is specified, but there is no resource files in that directory, IG_REC_initialize() sets an error and returns a non-zero value. Setting "REC.RESOURCE_PATH" control parameter to NULL will tell the component to look for the resource files in the default location, as described above.

Remarks:

Call this function after attaching the Recognition component to ImageGear, and before calling any other function of the Recognition component.