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



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

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

stream
A System.IO.Stream containing the the recognized page image data.
pageNumber
1-based index of the in stream.
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 stream As Stream, _
   ByVal pageNumber As Integer, _
   ByVal formResult As AutoFormsRecognizeFormResult, _
   ByVal formPageNumber As Integer _
) As FormPage
Visual Basic (Usage)Copy Code
Dim instance As AutoFormsEngine
Dim stream As Stream
Dim pageNumber As Integer
Dim formResult As AutoFormsRecognizeFormResult
Dim formPageNumber As Integer
Dim value As FormPage
 
value = instance.ProcessPage(stream, pageNumber, formResult, formPageNumber)
C# 
public FormPage ProcessPage( 
   Stream stream,
   int pageNumber,
   AutoFormsRecognizeFormResult formResult,
   int formPageNumber
)
C++/CLI 
public:
FormPage^ ProcessPage( 
   Stream^ stream,
   int pageNumber,
   AutoFormsRecognizeFormResult^ formResult,
   int formPageNumber
) 

Parameters

stream
A System.IO.Stream containing the the recognized page image data.
pageNumber
1-based index of the in stream.
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 if they exist, otherwise it returns null.

Example

Visual BasicCopy Code
Public Sub AutoPageRecognitionAndProcessing3Stream()
      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()

         Dim fs As FileStream = File.OpenRead(Path.Combine(LEAD_VARS.ImagesDir, "Forms\Images\FCC-107_OCR_Filled.tif"))

         Dim result As AutoFormsRecognizeFormResult = autoEngine.RecognizeForm(fs, Nothing)
         If result Is Nothing Then
            Return
         End If
         ' process the first page only
         Dim pageFields As FormPage = autoEngine.ProcessPage(fs, 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 AutoPageRecognitionAndProcessing3Stream()
   {
      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();

         FileStream fs = File.OpenRead(Path.Combine(LEAD_VARS.ImagesDir, @"Forms\Images\FCC-107_OCR_Filled.tif"));

         AutoFormsRecognizeFormResult result = autoEngine.RecognizeForm(fs, null);
         if(result == null)
            return;
         // process the first page only
         FormPage pageFields = autoEngine.ProcessPage(fs, 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 stream 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