Recognize(ITemplateForm) Method

Summary

Performs processing on IRecognitionForm for all pages of the filled-in form and fields existing in the provided ITemplateForm.

Syntax

C++

Java

public void Recognize( 
   ITemplateForm templateForm 
)

public abstract void recognize( 
   ITemplateForm templateForm 
);

Public Sub Recognize( 
   ByVal templateForm As ITemplateForm 
)

public:  
   void Recognize( 
      ITemplateForm^ templateForm 
   )

Parameters

templateForm

The template form object.

Remarks

The results of recognizing the fields on this filled-in form can be accessed from the Field.Result property.

When Recognize method is invoked, all fields in the ITemplateForm are aligned and processed in the filled-in form.

Example

The following example is a snippet of a larger example project. To run the larger example project, follow the work flow laid out in the OMREngine example. You can also download the complete example in Visual Studio 2017.

using Leadtools; 
using Leadtools.Barcode; 
using Leadtools.Codecs; 
using Leadtools.Forms.Processing.Omr; 
using Leadtools.Forms.Processing.Omr.Fields; 
using Leadtools.Ocr; 
 
public static IRecognitionForm RecognizeForm(ITemplateForm template, OmrEngine engine) 
{ 
   string answerKey = Path.Combine(LEAD_VARS.ImagesDir, @"Forms\OMR Processing\Exam\answer-key.tif"); 
 
   // create an IRecognitionForm which will contain the results of the recognition operation 
   IRecognitionForm answers = engine.CreateRecognitionForm(); 
   answers.Name = "Answers"; 
 
   using (RasterImage answerKeyImage = engine.EnginesObject.RasterCodecs.Load(answerKey)) 
   { 
      // add each page in the image to the IRecognitionForm 
      for (int i = 0; i < answerKeyImage.PageCount; i++) 
      { 
         answerKeyImage.Page = i + 1; 
         answers.Pages.AddPage(answerKeyImage); 
      } 
 
      // this recognizes the IRecognitionForm against the specified template 
      answers.Recognize(template); 
 
      // finally, print out the results of the recognition operation 
      Console.Write("Answers:"); 
      for (int i = 0; i < answers.Pages[0].Fields.Count; i++) 
      { 
         OmrField field = answers.Pages[0].Fields[i] as OmrField; 
 
         if (field != null) 
         { 
            OmrFieldResult omrFieldResult = (OmrFieldResult)field.Result; 
 
            Console.Write(omrFieldResult.Text + "\t"); 
         } 
      } 
      Console.WriteLine(); 
   } 
 
   return answers; 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS21\Resources\Images"; 
}

Requirements

Target Platforms

Reference

IRecognitionForm Class

IRecognitionForm Members

Leadtools.Forms.Processing.Omr Namespace

Download our FREE evaluation

Help Version 21.0.2021.6.30

Leadtools.Forms.Processing.Omr Assembly

Introduction

Getting Started

Namespaces

Leadtools.Forms.Processing.Omr Namespace

Leadtools.Forms.Processing.Omr.Fields Namespace

Assemblies