AutoFormsEngine Class

Provides high level form recognition and processing functionalities to recognize, process, and create forms. It uses the provided Master Form IMasterFormsRepository to recognize form type and process its fields.

Object Model

Syntax

C#
Visual Basic
Objective-C
Java
C++

public class AutoFormsEngine : System.IDisposable

'Declaration
 
Public Class AutoFormsEngine 
   Implements System.IDisposable

'Usage
 
Dim instance As AutoFormsEngine

public ref class AutoFormsEngine : public System.IDisposable

Remarks

Each AutoFormsEngine works on one IMasterFormsRepository which is provided through its constructor.

Important: Different OCR engines might have slight differences in form alignment and recognition. Therefore, it is best to use the same Leadtools.Forms.Ocr.OcrEngineType when generating the master forms and when recognizing and processing forms.

The following code shows how to AutoFormsEngine can be used in a multi-threaded server to process forms on demand:


             // The server class, can be a Windows or WCF service
             public class MyServer
             {
                // This is the request to process
                public void ProcessRequest(string fileName)
                {
                   // Unlock the LEADTOOLS support
                   // Get the license file path and developer key
                   // This can be fixed or read from a configuration file
                   string licenseFilePath = @"C:\LicenseFile.lic";
                   string developerKey = @"MyDeveloperKey";
                   RasterSupport.SetLicense(licenseFilePath, developerKey);
            
                   // Get the repository instance. This example assumes a disk repository
                   // The path can be fixed or read from configuration file
                   IMasterFormsRepository repository = new DiskMasterFormsRepository(new RasterCodecs(), @"C:\MyRepository");
            
                   // Get the OCR engine type
                   // Again, this can be fixed or read from a configuration file
                   OcrEngineType ocrEngineType = OcrEngineType.Advantage;
            
                   // int threadCount = Environment.ProcessorCount;
                   // Create the OCR engines needed for this operation
                   IOcrEngine ocrEngine = OcrEngineManager.CreateEngine(ocrEngineType, true);
                   // Start the OCR engine
                   ocrEngine.Startup(null, null, null, null);
            
                   // Optional. Setup the barcode engine
                   BarcodeEngine barcodeEngine = new BarcodeEngine();
            
                   // Create the auto-forms engine
                   AutoFormsEngine engine = new AutoFormsEngine(repository, ocrEngine, barcodeEngine, AutoFormsRecognitionManager.Default);
            
                   bool runInThread = true; // Set this value depending on your server setup
            
                   if (runInThread)
                   {
                      using (AutoResetEvent finishedEvent = new AutoResetEvent(false))
                      {
                         // If this is a Windows Service, then the call to Run must be done in a separate thread to not block subsequent calls
                         ThreadPool.QueueUserWorkItem((state) =>
                         {
                            try
                            {
                               // Process the request, assuming all categories
                               AutoFormsRunResult result = engine.Run(fileName, null);
            
                               // Call your function to process the result
                               MyProcessResult(result);
                            }
                            catch (Exception ex)
                            {
                               Console.WriteLine("Error {0}", ex.Message);
                            }
                            finally
                            {
                               // We are done, inform the main thread
                               finishedEvent.Set();
                            }
                         });
                      }
                   }
                   else
                   {
                      // Another type of server, such as a WCF HTTP server, no need to run
                      // in a separate thread since every request is done in its separate process (IIS process)
                      // Process the request, assuming all categories
                      AutoFormsRunResult result = engine.Run(fileName, null);
            
                      // Call your function to process the result
                      MyProcessResult(result);
                   }
                }
             }

Requirements

Target Platforms

Reference

AutoFormsEngine Members
Leadtools.Forms.Auto Namespace