L_Doc2SaveResultsToFile2

#include "l_bitmap.h"

L_LTDOC2_API L_INT EXT_FUNCTION L_Doc2SaveResultsToFile2(hDoc, pszFileName, uFlags)

Saves the recognition results to a file.

Parameters

L_HDOC2 hDoc

Handle to the OCR document.

L_TCHAR * pszFileName

Character string containing the name of the output file to be saved.

L_UINT uFlags

Flags that determine function behavior. Possible values are:

Value Meaning
0 The default behavior. It works the same way L_Doc2SaveResultsToFile works.
DOC2_SAVE_PAGE_RESULTS [0x001] Saves all page(s) results before saving it to final results.

Returns

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

Comments

To recognize one or more pages, call the L_Doc2Recognize function.

To set save recognition results options, call the L_Doc2SetRecognitionResultOptions function.

Get the current save recognition results options by calling L_Doc2GetRecognitionResultOptions.

To get all supported output formats, call the L_Doc2EnumOutputFileFormats function.

To get the format options, call the L_Doc2GetOutputFormatSettings function, and to update the format options, call L_Doc2SetOutputFormatSettings.

Use L_Doc2SaveResultsToFile2 to save the recognition results to different formats using the same recognition results and at the same time maintain quality. However, it consumes more memory than L_Doc2SaveResultsToFile / L_Doc2SaveResultsToFileExt.

If memory is a constraint, use L_Doc2SaveResultsToFile / L_Doc2SaveResultsToFileExt instead. However, note that L_Doc2SaveResultsToFile / L_Doc2SaveResultsToFileExt requires OCR to be performed separately for each file format in order to maintain quality.

The difference between L_Doc2SaveResultsToFile and L_Doc2SaveResultsToFileExt is that L_Doc2SaveResultsToFileExt includes the document ID parameter (nDocId).

Required DLLs and Libraries

See Also

Functions

Topics

Example

L_INT Doc2SaveResultsToFile2Example(L_HDOC2 hDoc, L_INT nPageIndex) 
{ 
   L_INT nRet; 
   RECOGNIZEOPTS2 RecogOpts; 
   RecogOpts.uStructSize = sizeof(RECOGNIZEOPTS2); 
   RecogOpts.nPageIndexStart = nPageIndex; 
   RecogOpts.nPagesCount = 1; 
   RecogOpts.SpellLangId = DOC2_LANG_ID_ENGLISH; 
 
   nRet = L_Doc2Recognize (hDoc, &RecogOpts, NULL, NULL); 
   if (nRet == SUCCESS) 
   { 
      RESULTOPTIONS2 ResOpts; 
      ZeroMemory(&ResOpts, sizeof(RESULTOPTIONS2)); 
      nRet = L_Doc2GetRecognitionResultOptions(hDoc, &ResOpts, sizeof(RESULTOPTIONS2)); 
      if(nRet != SUCCESS) 
         return nRet; 
 
      ResOpts.DocFormat = DOCUMENTFORMAT_PDF; 
 
      nRet = L_Doc2SetRecognitionResultOptions(hDoc, &ResOpts); 
      if(nRet != SUCCESS) 
         return nRet; 
 
      DOCWRTPDFOPTIONS PdfOptions; 
      memset(&PdfOptions, 0, sizeof(DOCWRTPDFOPTIONS)); 
      PdfOptions.bImageOverText = TRUE; 
      PdfOptions.PdfProfile = DOCWRTPDFPROFILE_PDF; 
      L_Doc2SetDocumentWriterOptions(hDoc, &PdfOptions, sizeof(DOCWRTPDFOPTIONS)); 
 
      nRet = L_Doc2SaveResultsToFile2(hDoc, MAKE_IMAGE_PATH(TEXT("Test_PDF.pdf")), DOC2_SAVE_PAGE_RESULTS); 
      if (nRet == SUCCESS) 
         MessageBox(NULL, TEXT("The recognition results were saved to a file."), TEXT("Notice!"), MB_OK); 
      else 
         return nRet; 
 
      L_Doc2GetDocumentWriterOptions(hDoc, &PdfOptions, sizeof(DOCWRTPDFOPTIONS)); 
      PdfOptions.PdfProfile = DOCWRTPDFPROFILE_PDFA; 
      L_Doc2SetDocumentWriterOptions(hDoc, &PdfOptions, sizeof(DOCWRTPDFOPTIONS)); 
 
      nRet = L_Doc2SaveResultsToFile2(hDoc, MAKE_IMAGE_PATH(TEXT("Test_PDFA.pdf")), DOC2_SAVE_PAGE_RESULTS); 
      if (nRet == SUCCESS) 
         MessageBox(NULL, TEXT("The recognition results were saved to a file."), TEXT("Notice!"), MB_OK); 
      else 
         return nRet; 
   } 
   else 
      return nRet; 
 
   return SUCCESS; 
} 
Help Version 21.0.2021.4.7
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS OCR Module - OmniPage Engine C API Help