ImageGear for C and C++ on Windows v19.6 - Updated
IG_REC_document_create
API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > Formatted Output Functions > IG_REC_document_create

Creates a new document.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_document_create(
   const LPSTR lpDataFileName,
   HIG_REC_DOCUMENT* lpDocument
);

Arguments:

Name Type Description
lpDataFileName const LPSTR Specifies the intermediate data file. If this parameter is NULL or an empty string, then the file name will be generated automatically.
lpDocument HIG_REC_DOCUMENT* Pointer to the document to be created.

Return Value:

Returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

This function does not process image pixels.

Example:

 
Copy Code
AT_ERRCOUNT ErrCount = 0;
HIGEAR higImage = 0;
HIG_REC_IMAGE higRecImage = 0;
HIG_REC_DOCUMENT hRecDocument = 0;

ErrCount += IG_load_file("Image.tif", &higImage);
ErrCount += IG_REC_image_import(higImage, &higRecImage);
ErrCount += IG_REC_image_recognize(higRecImage);
ErrCount += IG_REC_document_create(NULL, &hRecDocument);
ErrCount += IG_REC_document_page_insert(hRecDocument, higRecImage, -1);
ErrCount += IG_REC_document_save(hRecDocument, "recognition_data.bin");

//...

ErrCount += IG_REC_document_close(hRecDocument);
ErrCount += IG_image_delete(higImage);

See Also

HIG_REC_DOCUMENT