LEADTOOLS Forms (Leadtools.Forms.Auto assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.29
ProcessPage(RasterImage,Int32,AutoFormsRecognizeFormResult,Int32) Method
See Also 
Leadtools.Forms.Auto Namespace > AutoFormsEngine Class > ProcessPage Method : ProcessPage(RasterImage,Int32,AutoFormsRecognizeFormResult,Int32) Method



page
The recognized page image.
pageNumber
1-based index of the in page.
formResult
The recognition result of the form that is returned by AutoFormsEngine.RecognizeForm.
formPageNumber
The form page number to be processed.

The ProcessPage(RasterImage,Int32,AutoFormsRecognizeFormResult,Int32) Method is available as an add-on to the LEADTOOLS Document and Medical Imaging toolkits.

page
The recognized page image.
pageNumber
1-based index of the in page.
formResult
The recognition result of the form that is returned by AutoFormsEngine.RecognizeForm.
formPageNumber
The form page number to be processed.
Performs field processing on the recognized page image.

Syntax

Visual Basic (Declaration) 
Overloads Public Function ProcessPage( _
   ByVal page As RasterImage, _
   ByVal pageNumber As Integer, _
   ByVal formResult As AutoFormsRecognizeFormResult, _
   ByVal formPageNumber As Integer _
) As FormPage
Visual Basic (Usage)Copy Code
Dim instance As AutoFormsEngine
Dim page As RasterImage
Dim pageNumber As Integer
Dim formResult As AutoFormsRecognizeFormResult
Dim formPageNumber As Integer
Dim value As FormPage
 
value = instance.ProcessPage(page, pageNumber, formResult, formPageNumber)
C# 
public FormPage ProcessPage( 
   RasterImage page,
   int pageNumber,
   AutoFormsRecognizeFormResult formResult,
   int formPageNumber
)
C++/CLI 
public:
FormPage^ ProcessPage( 
   RasterImage^ page,
   int pageNumber,
   AutoFormsRecognizeFormResult^ formResult,
   int formPageNumber
) 

Parameters

page
The recognized page image.
pageNumber
1-based index of the in page.
formResult
The recognition result of the form that is returned by AutoFormsEngine.RecognizeForm.
formPageNumber
The form page number to be processed.

Return Value

The processed fields of the the page they exist, otherwise it returns null.

Example

Visual BasicCopy Code
Public Sub AutoPageRecognitionAndProcessing3()
      Dim root As String = Path.Combine(LEAD_VARS.ImagesDir, "Forms\FormsDemo\OCR_Test")

      Dim codecs_Renamed As RasterCodecs = New RasterCodecs()

      Dim repository As DiskMasterFormsRepository = New DiskMasterFormsRepository(codecs_Renamed, root)

      Using ocrEngine As IOcrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Plus, False)
         ocrEngine.Startup(Nothing, Nothing, Nothing, Nothing)

         Dim engineBarcode As BarcodeEngine = New BarcodeEngine()

         Dim autoEngine As AutoFormsEngine = New AutoFormsEngine(repository, ocrEngine, engineBarcode)
         autoEngine.MinimumConfidenceRecognized = autoEngine.GetMinimumRecognizedConfidencePage()

         'load all form pages
         Dim form As RasterImage = codecs_Renamed.Load(Path.Combine(LEAD_VARS.ImagesDir, "Forms\Images\FCC-107_OCR_Filled.tif"), 1, CodecsLoadByteOrder.Bgr, 1, -1)

         Dim result As AutoFormsRecognizeFormResult = autoEngine.RecognizeForm(form, Nothing)
         If result Is Nothing Then
            Return
         End If
         ' process the first page only
         Dim pageFields As FormPage = autoEngine.ProcessPage(form, 1, result, 1)
      End Using
   End Sub

Public NotInheritable Class LEAD_VARS
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class
C#Copy Code
public void AutoPageRecognitionAndProcessing3()
   {
      string root = Path.Combine(LEAD_VARS.ImagesDir, @"Forms\FormsDemo\OCR_Test");
      RasterCodecs codecs = new RasterCodecs();

      DiskMasterFormsRepository repository = new DiskMasterFormsRepository(codecs, root);

      using(IOcrEngine ocrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Plus, false))
      {
         ocrEngine.Startup(null, null, null, null);

         BarcodeEngine barcodeEngine = new BarcodeEngine();

         AutoFormsEngine autoEngine = new AutoFormsEngine(repository, ocrEngine, barcodeEngine);
         autoEngine.MinimumConfidenceRecognized = autoEngine.GetMinimumRecognizedConfidencePage();

         //load all form pages
         RasterImage form = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, @"Forms\Images\FCC-107_OCR_Filled.tif"), 1, CodecsLoadByteOrder.Bgr, 1, -1);

         AutoFormsRecognizeFormResult result = autoEngine.RecognizeForm(form, null);
         if(result == null)
            return;
         // process the first page only
         FormPage pageFields = autoEngine.ProcessPage(form, 1, result, 1);
      }
   }

static class LEAD_VARS
{
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
}

Remarks

If the specified page does not have processing fields, it returns null.

The alignment to the page is calculated internally from the formResult.

The page must have all form pages.

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 2000, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7

See Also

Leadtools.Forms requires a Forms Module license and unlock key. For more information, refer to: Imaging Pro/Document/Medical Features