RecognitionEngine Property

Visual Basic
C#
C++/CLI

'Declaration
 
Public Property RecognitionEngine As RecognitionEngine

'Usage
 
Dim instance As OmrProcessor
Dim value As RecognitionEngine
 
instance.RecognitionEngine = value
 
value = instance.RecognitionEngine

public RecognitionEngine RecognitionEngine {get; set;}

public:
property RecognitionEngine RecognitionEngine {
   RecognitionEngine get();
   void set (    RecognitionEngine value);
}

This property specifies which recognition engine is used when processing an OMR image.

Currently use of only one recognition engine is advised, the Single Threshold recognition engine. This engine is specified with the RecognitionEngine.SingleThreshold value.

When using the Single Threshold recognition engine, the Threshold property is used. Then MarkedBubbleThreshold and UnmarkedBubbleThreshold are not used.

Use of an alternate recognition engine may be specified with the RecognitionEngine.DualThresholdLegacy value. However, this engine is deprecated and it should no longer be used.

The only time it is acceptable to use the DualThresholdLegacy recognition engine is when reading a stream (see ReadFromStream) that was written by an older version of FormFix. In that case, the stream contains configuration for the OmrProcessor for the Dual Threshold Legacy recognition engine. Reading the stream will result in this property having a value of RecognitionEngine.DualThresholdLegacy.

When using the DualThresholdLegacy recognition engine, the Threshold property is not used. Instead the MarkedBubbleThreshold and UnmarkedBubbleThreshold properties are used.

Notes on Changing this Property
If a stream written by an older version of FormFix has been read using the WriteToStream method, then this propery will be set to RecognitionEngine.DualThresholdLegacy. If the calling code changes this property to RecognitionEngine.SingleThreshold, then it is also the responsibility of the calling code to set the Threshold property so that the OmrProcessor behaves as expected; changing the value of this property will not affect the values of the Threshold, MarkedBubbleThreshold, or UnmarkedBubbleThreshold properties.

Default value: RecognitionEngine.SingleThreshold

Reference

OmrProcessor Class
OmrProcessor Members