Programming with the LEADTOOLS .NET OCR

The LEADTOOLS OCR Class Library provides methods for incorporating optical character recognition (OCR) technology into an application. OCR is used to process bitmap document images into text.

Once the LEADTOOLS .NET OCR toolkit is installed to the system, the user is ready to begin programming with LEADTOOLS OCR. Please note that the OCR features must be unlocked before the OCR properties, methods, and events can be used. For more information about unlocking LEAD features, refer to Unlocking Special LEAD Features.

You can start using LEADTOOLS for .NET OCR in your application by adding a references to the Leadtools.Forms.Ocr.dll and Leadtools.Forms.DocumentWriter.dll assemblies in your .NET application. These assemblies contain the various interfaces, classes, structures and delegates used to program with LEADTOOLS OCR.

Since the toolkit supports multiple engines, the actual code that interfaces with the engine is stored in a separate assembly that will be loaded dynamically once an instance of the IOcrEngine interface is created. Hence, be sure the engine assembly you are planning to use resides next to the Leadtools.Forms.Ocr.dll assembly. You can add the engine assembly as a reference to your project—if desired—to automatically detect dependencies, even though this is not required by LEADTOOLS.

LEADTOOLS provides methods to:

Recognize and export text, choosing from a variety of text, word processing, database, or spreadsheet file formats.
Perform OCR processes in a single or multi-threaded environment with optimization for server-based operations.

Switch between the various OCR engines. Because a common .NET class library is used, switching engines (for example, from Professional to Advantage) requires virtually no changes in the application code.
Specify which language to use during recognition. The LEADTOOLS toolkits support many languages, including English, Danish, Dutch, Finnish, French, German, Italian, Norwegian, Portuguese, Russian, Spanish, and Swedish. There is also an Arabic OCR engine. For more information and a complete list, refer to OCR Languages and Spell-Checking.
Segment complex pages manually or automatically into text zones, image zones, table zones, lines, headers, and footers.
Set accuracy thresholds prior to recognition to control the accuracy of recognition.
Recognize text from 5 to 72 points in virtually any typeface.
Increase recognition accuracy using built-in and user dictionaries.
Automatically detect fax, dot matrix, and other degraded documents and compensate accordingly.
Process both text and graphics. The recognition software's ability to distinguish halftone graphics from text can provide the basis of a compound document processing system.
Save the document in any of 40 formats, including Adobe PDF and PDF/A, MS Word, MS Excel, as well as various flavors of ASCII and UNICODE text.

Using the OCR Engine

LEADTOOLS uses an OCR handle to interact with the OCR engine and the OCR document containing the list of pages. The OCR handle is a communication session between LEADTOOLS OCR and an OCR engine installed on the system. This OCR handle is an internal structure that contains all the necessary information for recognition, getting and setting information, and text verification.

The following outline shows the general steps involved in recognizing one or more pages.

Select the engine type you wish to use and create an instance of the IOcrEngine interface. For more information, refer to Creating an OCR Engine Instance.
Start up the OCR Engine with the IOcrEngine.Startup method. For more information, refer to Starting and Shutting down the Engine.
Optional. If saving is required, establish an OCR document with one or more pages. For more information, refer to Working with OCR Pages.
Optional. Establish zones on the page(s), either manually or automatically. (This is optional. A page can be recognized with or without zones.) For more information, refer to Working with OCR Zones.
Optional. Set the active languages to be used by the OCR engine. (The default language is English). For more information, refer to Working with OCR Languages.
Optional. Set the properties for spell-checking. For more information, refer to OCR Spell Language Dictionaries.
Optional. Set any special recognition module options. This is required only if the page contains zones, which can be created either automatically or manually. For more information, refer to Recognizing OCR Pages and Using OMR in LEADTOOLS .NET OCR.
Recognize. For more information, refer to Recognizing OCR Pages.
Optional. Save the recognition results, if desired. Results can be saved to either a file or to memory. For more information, refer to Recognizing OCR Pages.
Shut down the OCR engine when finished. For more information, refer to Starting and Shutting down the Engine.

Steps 4, 5, 6 and 7 can be done pretty much in any order, as long as the steps are carried out after starting up the OCR engine and before recognizing a page.

For more information on the engine assemblies, refer to OcrEngineType and Files To Be Included With Your Application .

As can be seen by the general steps above, the LEADTOOLS OCR engine can be used in multiple ways:

OCR an image file (or a LEADTOOLS RasterImage object) and obtain the text with optional formatting and position information. In this mode, an IOcrDocument object is not needed since the result is not going to be saved. The IOcrEngine.CreatePage method can be used to quickly create an IOcrPage from the RasterImage directly, call the necessary method (such as IOcrPage.Recognize) and then obtain the text directly using IOcrPage.GetText or IOcrPage.GetRecognizedCharacters. For an example, refer to IOcrEngine.CreatePage.
Perform low-level Optical Character Recognition of one or more pages followed by creating a document in the final document format, such as PDF or DOCX. In this mode, the user generally creates an IOcrDocument object (in memory or file-based) and then adds IOcrPage objects to it. The pages can be recognized either beforehand or at some point afterwards. When all the pages are added and recognized, IOcrDocument.Save is called to convert the recognition data to the final document. For an example, refer to IOcrDocument.
Perform high-level Optical Character Recognition on an input image file and output directly to a final document format such as PDF or DOCX. In this mode, you can use IOcrAutoRecognizeManager to convert the document in one shot. Various events and logging mechanisms can be used to modify and track the recognition operation. For an example, refer to IOcrAutoRecognizeManager.

The following example shows how to perform the above steps in code:

// Assuming you added "using Leadtools.Codecs;", "using Leadtools.Forms.Ocr;" and "using Leadtools.Forms.DocumentWriters;" at the beginning of this class 
// *** Step 1: Specify the engine type and create an instance of the IOcrEngine interface. 
             
// This example will use the LEADTOOLS OCR Advantage engine and use it in the same process 
IOcrEngine ocrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Advantage, false); 
             
// *** Step 2: Start up the engine. 
             
// Use the default parameters 
ocrEngine.Startup(null, null, null, @"C:\LEADTOOLS 19\Bin\Common\OcrAdvantageRuntime"); 
             
// *** Step 3: Create an OCR document with one or more pages. 
             
IOcrDocument ocrDocument = ocrEngine.DocumentManager.CreateDocument(); 
              
// Add all the pages of a multi-page TIF image to the document 
ocrDocument.Pages.AddPages(@"C:\Users\Public\Documents\LEADTOOLS Images\Ocr.tif", 1, -1, null); 
             
// *** Step 4: (Optional) Establish zones on the page(s), either manually or automatically 
             
// Automatic zoning 
ocrDocument.Pages.AutoZone(null); 
             
// *** Step 5: (Optional) Set the active languages to be used by the OCR engine 
             
// Enable both the English and German languages 
ocrEngine.LanguageManager.EnableLanguages(new string[] { "en", "de" }); 
             
// *** Step 6: (Optional) Set the spell checking engine 
             
// Enable the spell-checking system 
ocrEngine.SpellCheckManager.SpellCheckEngine = OcrSpellCheckEngine.Native; 
             
// *** Step 7: (Optional) Set any special recognition module options 
             
// Set the zoning method for the first zone in the first page to be Graphics so it will not be recognized 
OcrZone ocrZone = ocrDocument.Pages[0].Zones[0]; 
ocrZone.ZoneType = OcrZoneFillMethod.Graphics; 
ocrDocument.Pages[0].Zones[0] = ocrZone; 
             
// *** Step 8: Recognize 
             
ocrDocument.Pages.Recognize(null); 
             
// *** Step 9: Save recognition results 
             
// Save the results to a PDF file 
ocrDocument.Save(@"C:\Users\Public\Documents\LEADTOOLS Images\Document.pdf", DocumentFormat.Pdf, null); 
ocrDocument.Dispose(); 
             
// *** Step 10: Shut down the OCR engine when finished 
ocrEngine.Shutdown(); 
ocrEngine.Dispose();

' Assuming you added "Imports Leadtools.Forms.Ocr" and "Imports Leadtools.Forms.DocumentWriter" at the beginning of this class 
' *** Step 1: Specify the engine type and create an instance of the IOcrEngine interface. 
' This example will use the LEADTOOLS OCR Advantage engine and use it in the same process 
Dim ocrEngine As IOcrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Advantage, False) 
             
' *** Step 2: Start up the engine. 
             
' Use the default parameters 
ocrEngine.Startup(Nothing, Nothing, Nothing, "C:\LEADTOOLS 19\Bin\Common\OcrAdvantageRuntime") 
             
' *** Step 3: Create an OCR document with one or more pages. 
             
Dim ocrDocument As IOcrDocument = ocrEngine.DocumentManager.CreateDocument() 
             
' Add all the pages of a multi-page TIF image to the document 
ocrDocument.Pages.AddPages("C:\Users\Public\Documents\LEADTOOLS Images\Ocr.tif", 1, -1, Nothing) 
             
' *** Step 4: (Optional) Establish zones on the page(s), either manually or automatically 
             
' Automatic zoning 
ocrDocument.Pages.AutoZone(Nothing) 
             
' *** Step 5: (Optional) Set the active languages to be used by the OCR engine 
             
' Enable both the English and the German languages 
ocrEngine.LanguageManager.EnableLanguages(New String() {"en", "de"}) 
             
' *** Step 6: (Optional) Set the spell-checking engine 
' Enable the spell checking engine 
ocrEngine.SpellCheckManager.SpellCheckEngine = OcrSpellCheckEngine.Native 
             
' *** Step 7: (Optional) Set any special recognition module options 
             
' Change the zoning method for the first zone in the first page to be Graphics so it will not be recognized 
Dim ocrZone As OcrZone = ocrDocument.Pages(0).Zones(0) 
ocrZone.ZoneType = OcrZoneType.Graphics 
ocrDocument.Pages(0).Zones(0) = ocrZone 
             
' *** Step 8: Recognize the document 
             
ocrDocument.Pages.Recognize(Nothing) 
             
            ' *** Step 9: Save the recognition results 
             
            ' Save the results to a PDF file 
ocrDocument.Save("C:\Users\Public\Documents\LEADTOOLS Images\Document.pdf", DocumentFormat.Pdf, Nothing) 
ocrDocument.Dispose() 
             
' *** Step 10: Shut down the OCR engine when finished 
ocrEngine.Shutdown() 
ocrEngine.Dispose()

From the general steps above, the LEADTOOLS OCR engine can be used in multiple ways:

Using IOcrPage

OCR an image file (or LEADTOOLS RasterImage object) and obtain the text with optional formatting and position info. In this mode, an IOcrDocument object is not needed since the result is not going to be saved. The IOcrEngine.CreatePage method can be used to quickly create an IOcrPage from the RasterImage directly, call the necessary method (such as IOcrPage.Recognize) and then obtain the text directly using IOcrPage.GetText or IOcrPage.GetRecognizedCharacters.

Note: This mode is supported only by the LEADTOOLS OCR Advantage engine. Calling IOcrEngine.CreatePage using any other OCR engine will result in an exception being thrown.

The following example uses an OCR page without a document.

// Create the engine instance 
using (IOcrEngine ocrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Advantage, false)) 
{ 
   // Start up the engine 
   ocrEngine.Startup(null, null, null, @"C:\LEADTOOLS 19\Bin\Common\OcrAdvantageRuntime"); 
              
   // Load the first page as a RasterImage 
   RasterImage rasterImage = ocrEngine.RasterCodecsInstance.Load(@"C:\Users\Public\Documents\LEADTOOLS Images\Ocr.tif", 1); 
              
   // Create an OCR page from this image, transferring ownership of the RasterImage object 
   using (IOcrPage ocrPage = ocrEngine.CreatePage(rasterImage, OcrImageSharingMode.AutoDispose)) 
   { 
      // Recognize the page 
      ocrPage.Recognize(null); 
              
      // Show the text of all zones 
      for (int zoneIndex = 0; zoneIndex < ocrPage.Zones.Count; zoneIndex++) 
      { 
         string text = ocrPage.GetText(zoneIndex); 
         Console.WriteLine(text); 
      } 
   } 
              
   // The engine will automatically shut down when Dispose is called 
}

' Create the engine instance 
Using ocrEngine As IOcrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Advantage, False) 
   ' Start up the engine 
   ocrEngine.Startup(Nothing, Nothing, Nothing, "C:\LEADTOOLS 19\Bin\Common\OcrAdvantageRuntime") 
              
   ' Load the first page as a RasterImage 
   Dim rasterImage As RasterImage = ocrEngine.RasterCodecsInstance.Load("C:\Users\Public\Documents\LEADTOOLS Images\Ocr.tif", 1) 
              
   ' Create an OCR page from this image, transferring ownership of the RasterImage object 
   Using ocrPage As IOcrPage = ocrEngine.CreatePage(RasterImage, OcrImageSharingMode.AutoDispose) 
      ' Recognize the page 
      ocrPage.Recognize(Nothing) 
              
      ' Show the text in all zones 
      For zoneIndex As Integer = 0 To ocrPage.Zones.Count - 1 
         Dim text As String = ocrPage.GetText(zoneIndex) 
         Console.WriteLine(text) 
      Next 
   End Using 
              
   ' The engine will automatically shut down when Dispose is called 
End Using

Using IOcrDocument

An instance of IOcrDocument is needed to save the OCR results to a final document such as PDF or DOCX. One or more OCR page can be added to the document and then the various Save methods can be called to create the final document.

IOcrDocument can be used in two ways:

Memory-Based Documents

In this mode, the OCR pages are required to be in memory before saving. This is not recommended when the document has a large number of pages and either a file-based document or the LEADTOOLS Temporary file format (DocumentFormat.Ltd is required.

In memory-based IOcrDocument, the IOcrPageCollection holds the pages. Any or all of the pages can be recognized at any time and pages can be added or removed at will.

The following example uses a memory-based document to create a multi-page PDF file. Note how all the pages are kept in memory during the save operation:

// Create the engine instance 
using (IOcrEngine ocrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Advantage, false)) 
{ 
   // Start up the engine 
   ocrEngine.Startup(null, null, null, @"C:\LEADTOOLS 19\Bin\Common\OcrAdvantageRuntime"); 
              
   // Create the OCR document in memory 
   using (IOcrDocument ocrDocument = ocrEngine.DocumentManager.CreateDocument(null, OcrCreateDocumentOptions.InMemory)) 
   { 
      string imageFile = @"C:\Users\Public\Documents\LEADTOOLS Images\Ocr.tif"; 
             
      // Add all the pages to the document 
      ocrDocument.Pages.AddPages(imageFile, 1, -1, null); 
              
      // Recognize all the pages 
      ocrDocument.Pages.Recognize(null); 
              
      // Save the recognition results in PDF format 
      ocrDocument.Save(@"C:\Users\Public\Documents\LEADTOOLS Images\Document.pdf", DocumentFormat.Pdf, null); 
   } 
}

' Create the engine instance 
Using ocrEngine As IOcrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Advantage, False) 
   ' Start up the engine 
   ocrEngine.Startup(Nothing, Nothing, Nothing, "C:\LEADTOOLS 19\Bin\Common\OcrAdvantageRuntime") 
              
   ' Create the OCR document in memory 
   Using ocrDocument As IOcrDocument = ocrEngine.DocumentManager.CreateDocument(Nothing, OcrCreateDocumentOptions.InMemory) 
      Dim imageFile As String = "C:\Users\Public\Documents\LEADTOOLS Images\Ocr.tif" 
              
      ' Add all the pages to the document 
      ocrDocument.Pages.AddPages(imageFile, 1, -1, Nothing) 
              
      ' Recognize all the pages 
      ocrDocument.Pages.Recognize(Nothing) 
              
      ' Save the recognition results in PDF format 
      ocrDocument.Save("C:\Users\Public\Documents\LEADTOOLS Images\Document.pdf", DocumentFormat.Pdf, Nothing) 
   End Using 
End Using

File-Based Documents

In this mode, OCR pages are not required to be in memory before saving. This mode is best when the document has a large number of pages.

In file-based IOcrDocument, the IOcrPageCollection stores only views of the pages. When a page is added, a snapshot of the current recognition data is saved into the document. This data cannot be modified any more and the page is no longer needed. Pages must be recognized before they are added to the document and pages can only be added. They cannot be removed.

The following example uses a file-based document to create a multi-page PDF file. Notice how the pages are disposed after they are recognized and are not required during the save operation.

{                                  }

codeContainer Generic">// Create the engine instance  style="color:Blue;">using (IOcrEngine ocrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Advantage, false))   // Start up the engine  ocrEngine.Startup(null, null, null, @"C:\LEADTOOLS 19\Bin\Common\OcrAdvantageRuntime");   // Create a file-based OCR document  using (IOcrDocument ocrDocument = ocrEngine.DocumentManager.CreateDocument(null, OcrCreateDocumentOptions.AutoDeleteFile))  {  string imageFile = @"C:\Users\Public\Documents\LEADTOOLS Images\Ocr.tif";   // Get the number of pages in the document  int pageCount = ocrEngine.RasterCodecsInstance.GetTotalPages(imageFile);   // Create a page  for (int page = 1; page <= pageCount; page++)  {  // Load a RasterImage  RasterImage rasterImage = ocrEngine.RasterCodecsInstance.Load(imageFile, page);   // Create an OCR page from this image, transferring ownership of the RasterImage object  using (IOcrPage ocrPage = ocrEngine.CreatePage(rasterImage, OcrImageSharingMode.AutoDispose))  {  // Recognize the page  ocrPage.Recognize(null);   // Add it to the document  ocrDocument.Pages.Add(ocrPage);   // Page will be disposed here and its memory freed  }  }   // Save the recognition results in PDF format  ocrDocument.Save(@"C:\Users\Public\Documents\LEADTOOLS Images\Document.pdf", DocumentFormat.Pdf, null);  }

' Create the engine instance 
Using ocrEngine As IOcrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Advantage, False) 
   ' Start up the engine 
   ocrEngine.Startup(Nothing, Nothing, Nothing, "C:\LEADTOOLS 19\Bin\Common\OcrAdvantageRuntime") 
              
   ' Create a file-based OCR document 
   Using ocrDocument As IOcrDocument = ocrEngine.DocumentManager.CreateDocument(Nothing, OcrCreateDocumentOptions.AutoDeleteFile) 
      Dim imageFile As String = "C:\Users\Public\Documents\LEADTOOLS Images\Ocr.tif" 
             
      ' Get the number of pages in the document 
      Dim pageCount As Integer = ocrEngine.RasterCodecsInstance.GetTotalPages(imageFile) 
             
      ' Create a page 
      For page As Integer = 1 To pageCount 
         ' Load a RasterImage 
         Dim rasterImage As RasterImage = ocrEngine.RasterCodecsInstance.Load(imageFile, page) 
              
         ' Create an OCR page from this image, transferring ownership of the RasterImage object 
         Using ocrPage As IOcrPage = ocrEngine.CreatePage(rasterImage, OcrImageSharingMode.AutoDispose) 
            ' Recognize the page 
            ocrPage.Recognize(Nothing) 
              
            ' Add it to the document 
            ocrDocument.Pages.Add(ocrPage) 
              
            ' Page will be disposed here and its memory freed 
         End Using 
      Next 
              
      ' Save the recognition results in PDF format 
         ocrDocument.Save(@"C:\Users\Public\Documents\LEADTOOLS Images\Document.pdf", DocumentFormat.Pdf, Nothing) 
   End Using 
End Using

File-based documents can also be saved and re-loaded to continue adding pages or to convert it to the final document format at a later time. The following example shows how to do that:

private static void Test4() 
{ 
   // Create the engine instance 
   IOcrEngine ocrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Advantage, false); 
   // Start up the engine 
   ocrEngine.Startup(null, null, null, @"C:\LEADTOOLS 19\Bin\Common\OcrAdvantageRuntime"); 
             
   string imageFile1 = @"C:\Users\Public\Documents\LEADTOOLS Images\Ocr1.tif"; 
   string imageFile2 = @"C:\Users\Public\Documents\LEADTOOLS Images\Ocr2.tif"; 
             
   // Create a file-based OCR document 
   // Pass a file name (the name will be re-used) and tell the document to not delete it 
   string documentFile = @"C:\Users\Public\Documents\LEADTOOLS Images\document.bin"; 
   using (IOcrDocument ocrDocument = ocrEngine.DocumentManager.CreateDocument(documentFile, OcrCreateDocumentOptions.None)) 
   { 
      // Verify the document does not have any pages 
      System.Diagnostics.Debug.Assert(ocrDocument.Pages.Count == 0); 
             
      // Add a page 
      RasterImage rasterImage = ocrEngine.RasterCodecsInstance.Load(imageFile1, 1); 
      using (IOcrPage ocrPage = ocrEngine.CreatePage(rasterImage, OcrImageSharingMode.AutoDispose)) 
      { 
         ocrPage.Recognize(null); 
         ocrDocument.Pages.Add(ocrPage); 
      } 
             
      // Here the document is disposed but the file will not be deleted 
   } 
             
   // Re-load the document 
   using (IOcrDocument ocrDocument = ocrEngine.DocumentManager.CreateDocument(documentFile, OcrCreateDocumentOptions.LoadExisting)) 
   { 
      // Verify the document has one page 
      System.Diagnostics.Debug.Assert(ocrDocument.Pages.Count == 1); 
             
      // Add another page 
      RasterImage rasterImage = ocrEngine.RasterCodecsInstance.Load(imageFile2, 1); 
      using (IOcrPage ocrPage = ocrEngine.CreatePage(rasterImage, OcrImageSharingMode.AutoDispose)) 
      { 
         ocrPage.Recognize(null); 
         ocrDocument.Pages.Add(ocrPage); 
      } 
             
      // Verify that the document has 2 pages 
      System.Diagnostics.Debug.Assert(ocrDocument.Pages.Count == 2); 
             
      // Save the document 
      ocrDocument.Save(@"C:\Users\Public\Documents\LEADTOOLS Images\Document.pdf", DocumentFormat.Pdf, null); 
             
      // The result will be a PDF file with two pages 
   } 
             
   // Finally, delete the document file 
   System.IO.File.Delete(documentFile); 
   ocrEngine.Dispose(); 
}

' Create the engine instance 
Dim ocrEngine As IOcrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Advantage, False) 
' Start up the engine 
ocrEngine.Startup(Nothing, Nothing, Nothing, "C:\LEADTOOLS 19\Bin\Common\OcrAdvantageRuntime") 
             
Dim imageFile1 As String = "C:\Users\Public\Documents\LEADTOOLS Images\Ocr1.tif" 
Dim imageFile2 As String = "C:\Users\Public\Documents\LEADTOOLS Images\Ocr2.tif" 
             
' Create a file-based OCR document 
' Pass a file name (the name will be re-used) and tell the document to not delete it 
Dim documentFile As String = "C:\Users\Public\Documents\LEADTOOLS Images\document.bin" 
Using ocrDocument As IOcrDocument = ocrEngine.DocumentManager.CreateDocument(documentFile, OcrCreateDocumentOptions.None) 
   ' Verify the document does not have any pages 
   System.Diagnostics.Debug.Assert(ocrDocument.Pages.Count = 0) 
             
   ' Add a page 
   Dim rasterImage As RasterImage = ocrEngine.RasterCodecsInstance.Load(imageFile1, 1) 
   Using ocrPage As IOcrPage = ocrEngine.CreatePage(rasterImage, OcrImageSharingMode.AutoDispose) 
      ocrPage.Recognize(Nothing) 
      ocrDocument.Pages.Add(ocrPage) 
   End Using 
             
   ' Here the document is disposed but the file will not be deleted 
End Using 
             
' Re-load the document 
Using ocrDocument As IOcrDocument = ocrEngine.DocumentManager.CreateDocument(documentFile, OcrCreateDocumentOptions.LoadExisting) 
   ' Verify the document has one page 
   System.Diagnostics.Debug.Assert(ocrDocument.Pages.Count = 1) 
             
   ' Add another page 
   Dim rasterImage As RasterImage = ocrEngine.RasterCodecsInstance.Load(imageFile2, 1) 
   Using ocrPage As IOcrPage = ocrEngine.CreatePage(rasterImage, OcrImageSharingMode.AutoDispose) 
      ocrPage.Recognize(Nothing) 
      ocrDocument.Pages.Add(ocrPage) 
   End Using 
             
   ' Verify that the document has 2 pages 
   System.Diagnostics.Debug.Assert(ocrDocument.Pages.Count = 2) 
             
   ' Save the document 
   ocrDocument.Save("C:\Users\Public\Documents\LEADTOOLS Images\Document.pdf", DocumentFormat.Pdf, Nothing) 
             
   ' The result will be a PDF file with two pages 
End Using 
             
' Finally, delete the document file 
System.IO.File.Delete(documentFile) 
             
ocrEngine.Dispose()

Using IOcrAutoRecognizeManager

All of the previous techniques required low-level code to load a page, recognize it and add it to a document. The LEADTOOLS OCR engines also support performing the same task above using the one shot "fire and forget" IOcrAutoRecognizeManager interface. In this high-level OCR, the input image is converted directly to the output format using the best options using just one method.

// Create the engine instance 
using(IOcrEngine ocrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Advantage, false)) 
{ 
   // Start up the engine 
   ocrEngine.Startup(null, null, null, @"C:\LEADTOOLS 19\Bin\Common\OcrAdvantageRuntime"); 
             
   // Convert the multi-page TIF image to a PDF document 
   ocrEngine.AutoRecognizeManager.Run( 
      @"C:\Users\Public\Documents\LEADTOOLS Images\Ocr.tif", 
      @"C:\Users\Public\Documents\LEADTOOLS Images\Document.pdf", 
      DocumentFormat.Pdf, 
      null, 
      null); 
}

' Create the engine instance 
Using ocrEngine As IOcrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Advantage, False) 
   ' Start up the engine 
   ocrEngine.Startup(Nothing, Nothing, Nothing, "C:\LEADTOOLS 19\Bin\Common\OcrAdvantageRuntime") 
             
   ' Convert the multi-page TIF image to a PDF document 
   ocrEngine.AutoRecognizeManager.Run( _ 
      "C:\Users\Public\Documents\LEADTOOLS Images\Ocr.tif", _ 
      "C:\Users\Public\Documents\LEADTOOLS Images\Document.pdf", _ 
      DocumentFormat.Pdf, _ 
      Nothing, _ 
      Nothing) 
End Using