L_DocSaveResultsToMemory

#include "ltdoc.h"

L_LTDOC_API L_INT L_DocSaveResultsToMemory(hDoc, ppBuffer, plSize)

L_HDOC hDoc;	/* handle to the OCR document */
L_UCHAR ** ppBuffer;	/* address to buffer to be updated */
L_INT32 * plSize;	/* pointer to be updated */

Saves the last recognition process result to memory.

Parameter	Description
hDoc	Handle to the OCR document.
ppBuffer	Address of a pointer to be filled with the address of the final output document in memory.
plSize	Address of a variable to be updated with the length of the final output document.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

Saves the results of the last recognition process to memory.

To free the memory associated with the recognition results, call L_DocFreeMemoryResults.

Call L_DocSaveResultsToMemory after the recognition process is complete to save the results to memory.

To recognize one or more pages, call L_DocRecognize.

To save the recognition results to a file, call L_DocSaveResultsToFile.

Required DLLs and Libraries

LTDOC

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:	L_DocGetStatus, L_DocRecognize, L_DocFreeMemoryResults, L_DocSetRecognitionResultOptions, L_DocGetRecognitionResultOptions, L_DocEnumOutputFileFormats, L_DocGetTextFormatInfo, L_DocSaveResultsToFile, L_DocSetSpecialChar, L_DocGetSpecialChar, L_DocGetRecognizedCharacters, L_DocSetRecognizedCharacters, L_DocFreeRecognizedCharacters, L_DocGetRecognizedWords, L_DocFreeRecognizedWords
Topics:	OCR Functions: Recognition
	Recognizing Document Pages

Example

 L_INT DocSaveResultsToMemoryExample(L_HDOC hDoc, L_INT nPageIndex)
{
   L_INT nRet;
   RECOGNIZEOPTS RecogOpts;
   RecogOpts.uStructSize = sizeof(RECOGNIZEOPTS);
   RecogOpts.nPageIndexStart = nPageIndex;
   RecogOpts.nPagesCount = 1;
   RecogOpts.SpellLangId = LANG_ID_ENGLISH;
   RecogOpts.pszFileName = TEXT("%UserProfile%\\My Documents\\LEADTOOLS Images\\testrdf.rdf");

   nRet = L_DocRecognize (hDoc, &RecogOpts, NULL, NULL);
   if (nRet == SUCCESS)
   {
      L_UCHAR * pResult = NULL;
      L_INT32 lResultSize = 0;
      nRet = L_DocSaveResultsToMemory(hDoc, &pResult, &lResultSize);
      if (nRet == SUCCESS)
      {
         //...
         //... process the results that available in pResult
         //...

         nRet = L_DocFreeMemoryResults(hDoc, &pResult);
         if(nRet != SUCCESS)
            return nRet;
      }
      else
         return nRet;
   }
   else
      return nRet;
   return SUCCESS;
}