EngineType Property

Summary

Gets the type of this IOcrEngine.

Syntax

Objective-C

C++/CLI

Java

Python

public OcrEngineType EngineType { get; }

@property (nonatomic, assign, readonly) LTOcrEngineType engineType

public OcrEngineType getEngineType()

property OcrEngineType EngineType { 
   OcrEngineType get(); 
}

EngineType # get  (IOcrEngine)

Property Value

An OcrEngineType enumeration member indicating the IOcrEngine type.

Remarks

The value returned from the EngineType property is the same value you pass to the engineType parameter of the OcrEngineManager.CreateEngine method. If your application requires keeping track of the engine type (for example, to enable/disable user interface elements based on which OCR engine is being used), then you can use the EngineType property of the IOcrEngine object instead of storing a variable in your program.

Example

Java

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Ocr; 
using Leadtools.Document.Writer; 
 
public void StartupEngineExample() 
{ 
   // Use RasterCodecs to load an image file 
   // Note: You can let the engine load the image file directly as shown in the other examples 
   RasterCodecs codecs = new RasterCodecs(); 
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Ocr1.tif")); 
 
   // Assume you copied the engine runtime files to C:\MyApp\Ocr 
   string engineDir = @"C:\MyApp\Ocr"; 
 
   // Store the engine work directory into a path inside our application 
   string workDir = @"C:\MyApp\OcrTemp"; 
 
   // Delete all files in the work directory in case the previous version of our application exited abnormally and 
   // the engine did not get the chance to clean all of its temporary files (if any) 
   Directory.Delete(workDir, true); 
 
   // Re-create the work directory 
   Directory.CreateDirectory(workDir); 
 
   // Create an instance of the engine 
   using (IOcrEngine ocrEngine = OcrEngineManager.CreateEngine(OcrEngineType.LEAD)) 
   { 
      // Show that the engine has not been started yet 
      Console.WriteLine("Before calling Startup, IsStarted = " + ocrEngine.IsStarted); 
 
      // Start the engine using our parameters 
      // Since we already have a RasterCodecs object, we can re-use it to save memory and resources 
      ocrEngine.Startup(codecs, null, workDir, engineDir); 
 
      // Make sure the engine is using our working directory 
      Console.WriteLine("workDir passed is {0}, the value of WorkDirectory after Startup is {1}", workDir, ocrEngine.WorkDirectory); 
 
      // Show that the engine has started fine 
      Console.WriteLine("After calling Startup, EngineType is {0}, IsStarted = {1}", ocrEngine.EngineType, ocrEngine.IsStarted); 
 
      // Maks sure the engine is using our own version of RasterCodecs 
      Debug.Assert(codecs == ocrEngine.RasterCodecsInstance); 
 
      // Create a page from the raster image as page to the document 
      IOcrPage ocrPage = ocrEngine.CreatePage(image, OcrImageSharingMode.AutoDispose); 
      // image belongs to the page and will be dispose when the page is disposed 
 
      // Recognize the page 
      // Note, Recognize can be called without calling AutoZone or manually adding zones. The engine will 
      // check and automatically auto-zones the page 
      ocrPage.Recognize(null); 
 
      // Create a file based document 
      using (IOcrDocument ocrDocument = ocrEngine.DocumentManager.CreateDocument(null, OcrCreateDocumentOptions.AutoDeleteFile)) 
      { 
         // Add the page 
         ocrDocument.Pages.Add(ocrPage); 
         // No need for the page anymore 
         ocrPage.Dispose(); 
 
         // Save the document we have as PDF 
         string pdfFileName = Path.Combine(LEAD_VARS.ImagesDir, "Ocr1.pdf"); 
         ocrDocument.Save(pdfFileName, DocumentFormat.Pdf, null); 
      } 
 
      // Shutdown the engine 
      // Note: calling Dispose will also automatically shutdown the engine if it has been started 
      ocrEngine.Shutdown(); 
   } 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
}

 
import java.io.File; 
import java.io.IOException; 
import java.nio.file.Files; 
import java.nio.file.Path; 
import java.nio.file.Paths; 
 
import org.junit.*; 
import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 
import static org.junit.Assert.assertTrue; 
 
import leadtools.*; 
import leadtools.codecs.*; 
import leadtools.document.writer.*; 
import leadtools.ocr.*; 
 
 
public void IOcrStartupEngineExample() throws IOException { 
   final String LEAD_VARS_IMAGES_DIR = "C:\\LEADTOOLS23\\Resources\\Images"; 
   final String OCR_LEAD_RUNTIME_DIR = "C:\\LEADTOOLS23\\Bin\\Common\\OcrLEADRuntime"; 
 
   // Use RasterCodecs to load an image file 
   // Note: You can let the engine load the image file directly as shown in the 
   // other examples 
   RasterCodecs codecs = new RasterCodecs(); 
   RasterImage image = codecs.load(combine(LEAD_VARS_IMAGES_DIR, "Ocr1.tif")); 
 
   // Store the engine work directory into a path inside our application 
   String workDir = "C:\\LEADTOOLS23\\Bin\\Common"; 
 
   // Delete all files in the work directory in case the previous version of our 
   // application exited abnormally and 
   // the engine did not get the chance to clean all of its temporary files (if 
   // any) 
   File directory = new File(workDir); 
   directory.delete(); 
 
   // Re-create the work directory 
   directory.createNewFile(); 
 
   // Create an instance of the engine 
   OcrEngine ocrEngine = OcrEngineManager.createEngine(OcrEngineType.LEAD); 
 
   // Show that the engine has not been started yet 
   System.out.println("Before calling Startup, IsStarted = " + ocrEngine.isStarted()); 
 
   // Start the engine using our parameters 
   // Since we already have a RasterCodecs object, we can re-use it to save memory 
   // and resources 
   ocrEngine.startup(codecs, null, workDir, OCR_LEAD_RUNTIME_DIR); 
   assertTrue(ocrEngine.isStarted()); 
 
   // Make sure the engine is using our working directory 
   System.out.printf("workDir passed is %s, the value of WorkDirectory after Startup is %s%n", workDir, 
         ocrEngine.getWorkDirectory()); 
   assertTrue("Work directory was not changed", workDir.equals(ocrEngine.getWorkDirectory())); 
 
   // Show that the engine has started fine 
   System.out.printf("After calling Startup, EngineType is %s, IsStarted = %s%n", ocrEngine.getEngineType(), 
         ocrEngine.isStarted()); 
 
   // Maks sure the engine is using our own version of RasterCodecs 
   assertTrue("Engine is using incorrect RasterCodecs", codecs == ocrEngine.getRasterCodecsInstance()); 
 
   // Create a page from the raster image as page to the document 
   OcrPage ocrPage = ocrEngine.createPage(image, OcrImageSharingMode.AUTO_DISPOSE); 
   // image belongs to the page and will be dispose when the page is disposed 
 
   // Recognize the page 
   // Note, Recognize can be called without calling AutoZone or manually adding 
   // zones. The engine will 
   // check and automatically auto-zones the page 
   ocrPage.recognize(null); 
 
   // Create a file based document 
   OcrDocument ocrDocument = ocrEngine.getDocumentManager().createDocument(null, 
         OcrCreateDocumentOptions.AUTO_DELETE_FILE.getValue()); 
 
   // Add the page 
   ocrDocument.getPages().add(ocrPage); 
   // No need for the page anymore 
   ocrPage.dispose(); 
 
   // Save the document we have as PDF 
   String pdfFileName = combine(LEAD_VARS_IMAGES_DIR, "Ocr1.pdf"); 
   ocrDocument.save(pdfFileName, DocumentFormat.PDF, null); 
 
   // Shutdown the engine 
   // Note: calling Dispose will also automatically shutdown the engine if it has 
   // been started 
   ocrEngine.shutdown(); 
}