Leadtools.Forms.Ocr Namespace > IOcrPage Interface > AutoZone Method : AutoZone(OcrZoneParser,OcrZoneFillMethod,LogicalUnit,OcrProgressCallback) Method |
Note: This parameter will always contain OcrZoneParser.Default when using the LEADTOOLS OCR Advantage Engine.
void AutoZone( OcrZoneParser zoneParser, OcrZoneFillMethod fillMethod, LogicalUnit zonesUnit, OcrProgressCallback callback )
'Declaration Overloads Sub AutoZone( _ ByVal zoneParser As OcrZoneParser, _ ByVal fillMethod As OcrZoneFillMethod, _ ByVal zonesUnit As LogicalUnit, _ ByVal callback As OcrProgressCallback _ )
'Usage Dim instance As IOcrPage Dim zoneParser As OcrZoneParser Dim fillMethod As OcrZoneFillMethod Dim zonesUnit As LogicalUnit Dim callback As OcrProgressCallback instance.AutoZone(zoneParser, fillMethod, zonesUnit, callback)
void AutoZone( OcrZoneParser zoneParser, OcrZoneFillMethod fillMethod, LogicalUnit zonesUnit, OcrProgressCallback callback )
- (BOOL)autoZone:(LTOcrZoneFillMethod)fillMethod target:(id)target selector:(SEL)selector error:(NSError**)outError;
public void autoZone(OcrZoneFillMethod fillMethod, OcrProgressListener callback)
function Leadtools.Forms.Ocr.IOcrPage.AutoZone(OcrZoneParser,OcrZoneFillMethod,LogicalUnit,OcrProgressCallback)( zoneParser , fillMethod , zonesUnit , callback )
void AutoZone( OcrZoneParser zoneParser, OcrZoneFillMethod fillMethod, LogicalUnit zonesUnit, OcrProgressCallback^ callback )
Note: This parameter will always contain OcrZoneParser.Default when using the LEADTOOLS OCR Advantage Engine.
This method differs from AutoZone as follows:
You can use the OcrProgressCallback to show the operation progress or to abort it. For more information and an example, refer to OcrProgressCallback.
The zones found by this method are added to the Zones collection of this page. Any previously added zones will be removed from Zones first.
This method finds the zone coordinates (OcrZone.Bounds) and type (OcrZone.ZoneType). The type of the zone determines the role of the zone in the page layout and can be classified into three different groups:
Note: Only OcrZoneType.Text is currently supported for the LEADTOOLS OCR Advantage Engine.
The new zones found by this method will always have the OcrZone.FillMethod and OcrZone.RecognitionModule set to fillMethod and OcrZoneRecognitionModule.Auto respectively. In order to override this automatic fill method and recognition module, you must update each zone in Zones by getting the zone with the IOcrZoneCollection getter, update and set it back with the setter. You can get the number of zones found by this method with the Zones.Count property.
To update the zones of a page with fill method set to OcrZoneFillMethod.Default, use UpdateFillMethod.
To detect the global fill method of a page, use DetectFillMethod.
Note: If this IOcrPage is an empty page, in other words, when the OCR engine performs automatic page decomposing with the AutoZone method and could not find any zones in it, the Recognize or or RecognizeText methods will fail with an exception. It is recommended you call AutoZone and then check if there is at least one zone found by the engine (using Zones.Count). If the count is zero, do not call Recognize or or RecognizeText.
If a recognition module is not able to recognize an object (i.e. character, or checkmark etc.), this object will be marked as a rejected one. It will become marked by a rejection symbol during conversion to the final output document. Note that IOcrDocumentManager.RejectionSymbol can be set to specify the rejection symbol used in the final document.
Note on AutoZone/Recognize and the page image: In certain cases, AutoZone and Recognize will perform image processing on the page that might result in the page being manipulated. For example, if you add a zone of type table, the engine might automatically deskew the page if required. This result in the image representation of the image to be different after AutoZone or Recognize is called. If your application has a requirement to view the image of the page, then call GetRasterImage after AutoZone or Recognize to get the latest version of the image representation of the page in case it has changed. The LEADTOOLS Main OCR C# and VB demos do exactly that.