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

Overwrites the specified page in the document with the page provided.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_document_page_update(
   HIG_REC_DOCUMENT hDocument,
   HIG_REC_IMAGE hPage,
   AT_INT nPageIndex
);

Arguments:

Name Type Description
hDocument HIG_REC_DOCUMENT Document handle.
hPage HIG_REC_IMAGE Page that will overwrite the document page specified by nPageIndex.
nPageIndex AT_INT Zero-based index of the page to be updated.

Return Value:

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

Supported Raster Image Formats:

See IG_REC_image_import.

Example:

 
Copy Code
AT_ERRCOUNT ErrCount = 0;
HIG_REC_IMAGE higRecImage = 0;
HIGEAR higImage = 0;
HIG_REC_DOCUMENT hRecDocument = 0;
AT_INT iPageCount = 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_open("recognition_data.bin", &hRecDocument);

//...

ErrCount += IG_REC_document_pagecount_get(hRecDocument, &iPageCount);
if(iPageCount > 0)
        ErrCount += IG_REC_document_page_update(hRecDocument, higRecImage, 0);
ErrCount += IG_REC_document_save(hRecDocument, "recognition_data.new");
ErrCount += IG_REC_document_close(hRecDocument);
ErrCount += IG_image_delete(higImage);

Remarks:

After inserting the page, it becomes invalid. It can neither be accessed nor deleted.

See Also

HIG_REC_IMAGE

HIG_REC_DOCUMENT